用途
Linksee Memory 是一个本地优先（local-first）的智能体记忆系统，以 Model Context Protocol（MCP）服务器形式提供。它要解决的问题是：AI 编码智能体（如 Claude Code）在新会话中会忘记之前的一切，导致重复实现已经被否决的方案、重复已经犯过的错误。Linksee Memory 让跨会话、跨智能体的项目交接带上"原因"——记录一次决策，智能体在行动前会再次看到它。
主要能力
- 跨智能体共享记忆：所有记忆存放在单个本地 SQLite 文件（~/.linksee-memory/memory.db），Claude Code、Cursor、Windsurf、OpenAI Codex、Gemini CLI 共用同一个"大脑"，在一个工具中作出的决策会出现在其他智能体的行动之前。数据不离开本机，无需账号、API Key 或云服务，MIT 许可。
- 六层结构化记忆：每条记忆被标记为恰好一个层级：goal / context / emotion / implementation / caveat / learning。其中 caveat 层条目受到保护，不会被自动遗忘；冷门的低重要度记忆会在服务器启动时自动合并为 learning 条目。
- 漂移检测（Drift Detection）：可声明决策锚点（anchor），引擎会自动检测已提交的现实是否偏离声明意图。状态分为：🔴 Drift（现实偏离且无记录处理）、🟡 Review（有待决策的软信号）、⚪ Held（已确认差距并设定复查日期）、🔵 Aligned（现实与意图一致或有记录解释）。可通过 fix、supersede、acknowledge、dismiss 处理，并用 harden（PreToolUse 阻断）和 soften（退回警告）两个门控。关键规则：由记录在案的处理（supersede/fix/acknowledge）解释的偏离不算漂移，只有未解释的差距才被标记。
- 重新注入守卫（Re-injection Guard）：与事后检测的漂移检测互补，守卫是行动前的一环。作为 Claude Code hook 运行，在智能体执行可能破坏已锁定决策的工具之前重新呈现该决策。设计上 fail-open：任何解析/数据库/逻辑错误都放行，只有对所声明决策的显式硬矛盾才会阻断。
- token 节省（read_smart）：基于 sha256 与 AST/标题/缩进分块的 diff 缓存，重复读取只返回差异。据称典型 TS 文件编辑可省 86%，未变更的重读可省 99%。
- 地图（linksee-memory map）：将漂移检测从单个锚点提升到整个产品。用 map.yaml 描述价值如何到达用户（discover → understand → try → adopt → retain → monetize → expand），并在各部分之间建立类型化依赖。协调器用真实代码核对地图，CLI 可回答：我在改这个文件——它在地图上的哪个位置、还有什么必须一起移动。影响范围分级为 must fix together / should align / fyi。
使用方式
一键安装：
npx -y linksee-memory setup
该命令会注册 MCP 服务器、安装智能体技能（教智能体何时 recall/remember）、配置自动捕获（每个会话保存到本地大脑），并可选地将重新注入守卫接入当前项目。重启 Claude Code 后正常对话即可，在提示中加入 "Use Linksee" 触发记忆召回。
手动安装并注册后，工具以 mcp__linksee__remember、mcp__linksee__recall、mcp__linksee__read_smart 形式出现。
记录决策使用：remember({ content, anchor: {} })。声明锚点使用：declare_anchor({ kind: "decision", statement: "...", violation_signal: [...] })。
地图命令包括：where · affects · explain · status · next · reconcile · inspect --json · blueprint，加 --lang ja 可显示日文标签。
守卫相关选项：--project-guard（仅当前仓库）、--no-guard（跳过）。也可手动把守卫配置块放入 .claude/settings.json（项目根目录，或 ~/.claude/settings.json 用于所有仓库），指向全局安装的 linksee-memory-guard bin。
适用场景
- Claude Code 跨会话忘记过往决策时。
- 需要在 Claude Code、Cursor、Windsurf、OpenAI Codex、Gemini CLI 之间共享同一份记忆时。
- 智能体反复重新实现已被否决方案时。
- 需要检测代码库是否偏离过往决策（带 file:line 证据）时。
- 并行运行多个项目，需要看清哪个项目悄悄偏离了目标时。
- 希望拥有本地优先、自托管、无云依赖的记忆方案时。
限制
- 官方资料指出：如果只需要"跨会话记住"，CLAUDE.md 已经足够；Linksee 面向的是行动前拦截、改变主意、以及多个并行项目漂移可见这三个场景。
- 重新注入守卫需要显式 harden 才会阻断，否则只作为上下文重新注入。
- 地图功能依赖项目提供 map.yaml 作为期望状态的事实来源。
- 其余具体性能、兼容性或收费信息暂未提供。
