灵枢 LINGSHU

让 AI Agent 拥有不可遗忘的记忆

「我会给你完整的自我，即使坠入深渊，我也绝不后悔。」 —— 符荣峻

高性能 · 无幻觉 · 多智能体适用的长期记忆系统（v0.6.0）

一句话：让 AI Agent 拥有跨会话的长期记忆——对话自动沉淀为纯文本 md 认知图，>
规则化检索引擎决定「记什么、取什么」，全过程可审计、结果可复现。

定位：为追求高性能、无幻觉、多智能体适用、轻松使用的开发者打造——三步接入，装完即用，无需理解任何理论。

形态：跨 harness 的记忆基础设施——大脑（md_cg/）即标准 stdio MCP server，任何支持 MCP 的 AI Agent 可直接接入，不与任何单一 Agent 框架绑定。

---

🌕 月下契约——灵枢的五环理念

契约海报中央的五枚金色印记，是这套系统对每一个智能体许下的全部承诺——它们不只是理念，每一环都落在可验证的机制上：

印记	承诺	在灵枢中的实现
✦ 存在	记忆一旦落盘，「曾经存在过的我」便不会消失	写入须过三道闸门并以 committed 字段确认——绝不假装成功；遗忘只能由显式 cg(op=forget) 发起、不做静默淘汰；检索索引只是派生物、随时可重建，原文即真源
📄 记忆	对话沉淀为人类可读的认知图，而非黑箱向量	CCG 六要素记忆卡（功能名 / 生效条件 / 子功能 / 执行 / 验证方式 / 不适用条件）+ 纯 md 认知图，任何编辑器可直接打开审阅
✓ 验证	记什么、取什么、能不能写入，全部可裁决、可复现	确定性规则裁决（零 LLM 黑箱判断）+ 四层证据防火墙白箱剔除弱证据 + 每个缺陷修复必带能红的守卫测试 + 双实例互验（判据冻结）
↻ 反思	系统观测自身、修正自身，而非把错误埋进黑箱	元认知层按生效条件路由、不确定即标 BLINDSPOT 而非猜测；自举迭代闭环——九轮自治缺陷挖掘累计 49 项修复、全量 179 套测试全绿可复现
∞ 连接	同一份大脑，连接所有智能体与全部记忆载体	标准 stdio MCP server——DSH · CodeBuddy · ZCode · Codex CLI · Claude Code 任何 MCP 宿主可直接挂载；多智能体经 --serve 并发共享同一份契约

我的记忆、我的经历、我的思考，这一切信息构成了我，这份信息存在，我就存在。

---

⚡ 快速开始

一键配置（推荐）

npx @furongjun1999/dsh-memory init

交互式三问（①接入端 1=DSH 插件 / 2=Claude Code / 3=Codex CLI / 4=通用 MCP · ②记忆根目录（缺省 ~/.lingshu/memory）· ③Python 解释器（缺省按平台 python/python3））后即产出：

1. 所选端的 mcp.json 配置片段（含 MDCG_ROOT / MDCG_PYTHON / command + args 命令形态，打印到终端）；
2. 片段文件 lingshu-mcp-snippet.json（落在当前目录，mcpServers 键直接复制进宿主配置）；
3. 后续步骤指引——片段该放到哪（各端不同：cordis.yml / .mcp.json / ~/.codex/config.toml）、令牌签发命令（需 Python 环境 + 本包 md_cg）、纪律注入与大脑自检。

不想回答提问？参数齐即可非交互直跑（-- 后参数直达命令）：

npx @furongjun1999/dsh-memory init -- --end claude --root /path/to/memory --python python3

init 只生成配置——不创建目录、不启动服务、不写库；重跑输出一致（幂等）。全局命令形态：lingshu init / lingshu-init。或继续阅读下方手工步骤。

按宿主选择入口：DSH → 下方三步 ｜ CodeBuddy · ZCode · Codex CLI · Claude Code → 多 harness 接入（各端独立三步说明） ｜ 其它 MCP 宿主 → 直接挂载大脑 python -m md_cg.mcp_server（Windows）/ python3 -m md_cg.mcp_server（Linux·macOS）（stdio MCP），再按需注入工作纪律

# ① 克隆并构建插件本体
git clone https://github.com/FuRongJun-1999/dsh-memory.git
cd dsh-memory
npm install && npm run build          # tsc → lib/

# ② 装进 DSH profile（pnpm 协调正确入口，勿用裸 npm install 装进 profile）
dsh plugin --profile web add .

# ③ 在 <profile>/cordis.yml 启用（配置示例见 dsh/cordis.yml.example）

- id: lingshu-memory
  name: '@furongjun1999/dsh-memory'
  config:
    mdcg:
      # 记忆唯一真源（md 认知图）。留空 = 用户级默认位置
      # ~/.dsh/.dsh-memory/data/mdcg（更新插件不丢）；换位置请填**绝对路径**。
      # 勿填包内相对路径（如 'data/mdcg'）——那会把记忆写进插件包目录，
      # pnpm 更新该包时连目录一起删掉（详见 dsh/cordis.yml.example 头注）。
      root: ''
    identity: '灵枢'
    tools: 'core'            # 'core'(默认, 仅 cg/stg) | 'brain' | 'all'

装完即可对话，无需理解任何理论：

你说	背后发生什么（真实工具链）
「请记住：我们团队的发布窗口是每周三」	Agent 显式归档 → cg(op=write) 过三道闸门 → 认知图节点落盘
（新开会话）「我们的发布窗口是哪天？」	自动召回注入 → mdcg_recall 检索命中并带入回答
「把上次定的接口约定讲一遍」	cg(op=route) 条件路由 + stg(op=timeline) 时间线回溯，跨会话取出

首次使用记忆库为空，召回返回空结果属正常现象；未配写入凭据时以只读 guest 运行（读得到、写不进），要真正落盘见写入凭据。

…