GMaN1911/claude-cognitive

解决的问题

Claude Code 功能强大但无状态——每个新实例都从零开始，重新读取未更改的文件，浪费令牌，并可能产生缺失集成的幻觉。该项目为 Claude Code 提供持久化工作记忆，使会话能够高效恢复，避免重复工作，并在长时间运行或并行使用中保持一致性。

工作原理

两个互补系统：

• 上下文路由器 — 根据文档被提及的频率对文档文件进行评分。HOT 文件（分数 > 0.8）注入完整内容，WARM 文件（0.25–0.8）仅注入前 25 行，COLD 文件（< 0.25）被驱逐。分数随轮次衰减，关键词匹配时上升，并通过共激活提升相关文件。
• 池协调器 — 在多个 Claude 实例间共享状态。自动模式下，每 5 分钟检测对话中的任务完成或阻塞；手动模式下，您编写显式的 pool 块。这使并行或长期会话保持同步。

历史跟踪（v1.1+）将每轮的注意力状态（HOT/WARM/COLD 转换）记录到 JSONL 文件中，并提供 CLI 进行查询、过滤和统计。设置涉及复制脚本、设置实例 ID 以及配置项目特定的 keywords.json。

适用人群

在大型代码库（5 万行以上）上使用 Claude Code 的开发者，需要跨会话持久上下文；同时运行多个 Claude 实例的团队；以及管理多天或长期编码工作流的任何人。

亮点

• 令牌节省：冷启动降低 79%（120K → 25K 字符），热上下文降低 70%，专注工作降低 75%。
• 新实例在第一条消息时即可高效工作；无幻觉导入或集成。
• 支持 8 个以上并发 Claude 实例和多天会话。
• 在 100 万行以上生产代码库（3,200+ Python 模块）上验证。
• 自动和手动池协调模式。
• 注意力历史查看器，支持过滤和统计。
• MIT 许可，标记为生产就绪。