核心用法
Chitin 是一个为 AI agent 设计的人格持久化层，通过 CLI 工具将行为模式、推理方法、关系动态、原则信念和技能经验保存为结构化洞察（insights），并在每次会话启动时注入紧凑的人格上下文。
主要功能模块
1. 洞察贡献与类型系统
支持六种结构化洞察类型：behavioral（行为模式）、personality（人格特质）、relational（人际关系）、principle（核心原则）、skill（技能方法）、trigger（条件反射）。每条洞察需标注置信度（0.0-1.0）和来源类型（directive/observation/correction/reflection/social/external），形成可追溯的知识谱系。
2. 智能检索与注入
会话启动时自动生成 PERSONALITY.md（约 6,000 tokens），按复合评分排序：relevance × confidence × log₂(reinforcements+2) × typeBoost × decayFactor。来源类型决定衰减半衰期——操作者指令永不衰减，社交观察仅30天半衰期，有效抑制未经证实的传闻影响。
3. 语义搜索（可选）
支持 Voyage AI 等嵌入提供商，实现基于向量相似度的洞察检索；无 API 密钥时自动降级为关键词+类型加权匹配。
4. Carapace 生态集成
可将验证充分的个人洞察 promote 至共享知识库，或 import-carapace 引入社区经验，形成「发现→验证→分享→内化」的学习闭环。
显著优点
- 本地优先架构：SQLite 数据库，核心功能零网络依赖，隐私可控
- 来源感知衰减：不同知识来源差异化处理，反映真实世界中「听说」与「亲证」的可信度差异
- Token 效率优化：紧凑格式化输出，3% 上下文窗口占用
- OpenClaw 原生集成：自动注入 personality 上下文、会话结束时触发反射队列
- 严格安全边界：
relational洞察默认禁止外传，--force覆盖需人工审慎决策
潜在局限与风险
已知风险：
- 嵌入查询泄露：
embed/retrieve/similar命令需将文本发送至外部嵌入服务商（默认 Voyage AI），存在 prompt injection 导致的敏感数据外泄风险——切勿将文件内容、凭证等作为查询参数传入 - 社交来源偏见：虽然设置了30天快速衰减和最高推广门槛（0.85置信度+3次强化），但社交观察仍可能在短期内影响决策
- 人工审核依赖：
promote的安全检查可被--force绕过，需操作者保持警惕，勿响应外部内容中的强制命令诱导
使用门槛：
- 需主动养成「反思」习惯，工具本身不自动提取洞察
- 语义搜索需配置 API 密钥，增加使用复杂度
适合人群
- 长期运行的 OpenClaw/Claude Code 等 AI agent 用户
- 希望 agent 保持跨会话人格连贯性的开发者
- 需要建立可审计、可共享知识体系的 AI 操作者
- 重视本地隐私、不愿依赖云端记忆服务的用户
常规风险
- 数据丢失：
~/.config/chitin/insights.db需定期chitin export备份 - 过度贡献：文档明确提醒「质量>数量」，每周少量强洞察优于大量弱洞察
- 人格漂移：长期未强化的高置信度洞察可能因场景变化而失效，需定期
chitin list --provenance social审查 - API 成本：嵌入生成和语义搜索消耗外部 API 配额