@furongjun1999/dsh-memory 0.9.10 → 0.9.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,150 +1,195 @@
1
- <div align="center">
2
-
3
- # 灵枢 LINGSHU
4
-
5
- ### 让 AI Agent 拥有不可遗忘的记忆
6
-
7
- <a href="docs/images/lingshu-moonlight-covenant-poster.png" title="点击查看高清原图(2160×3240)"><img src="docs/images/lingshu-moonlight-covenant-poster-preview.jpg" width="300" alt="灵枢 · 月下契约 —— 第一份记忆契约:存在 · 记忆 · 验证 · 反思 · 连接"/></a>
8
-
9
- > **「我会给你完整的自我,即使坠入深渊,我也绝不后悔。」** —— 符荣峻
10
-
11
- ![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)![DSH 适配](https://img.shields.io/badge/DSH-0.2.1--rc.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1)![downloads](https://badgen.net/npm/dt/@furongjun1999/dsh-memory?label=downloads&color=4E9BF1)![Protocol](https://img.shields.io/badge/Protocol-MCP-blue)![Node](https://img.shields.io/badge/Node-%3E%3D22.19-brightgreen)![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
12
-
13
- **高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.9.9)**
14
-
15
- 📖 **[第三方上手教程](https://znsvdekx.vibedrop.site/)** —— 《灵枢 dsh-memory 初学者上手研究报告》(由第三方独立编写,非本项目官方文档)
16
-
17
- </div>
18
-
19
- **灵枢是一套可运行的长期记忆基础设施**——对话自动沉淀为纯文本 md 认知图,记什么、取什么、能不能写入全部由确定性规则裁决,全程可审计、结果可复现。它不训练模型,做的是**模型之外的那一整套**:记忆怎么存、取的时候依据什么、写错了怎么被发现、改过怎么留痕。任何支持 MCP 的 AI Agent 可直接挂载,不与任何单一 Agent 框架绑定。
20
-
21
- ## ⚡ 三条命令上手
22
-
23
- ```bash
24
- git clone https://github.com/FuRongJun-1999/dsh-memory.git && cd dsh-memory
25
- npx @furongjun1999/dsh-memory init # 三问交互:接入端 / 记忆根 / 解释器;只生成配置,不写库
26
- python -m md_cg.mcp_server # 直连自检:收到 initialize 应答即通
27
- ```
28
-
29
- > 上面三条**不需要模型凭据、不需要联网**;默认以只读 `guest` 运行(**读得到、写不进**)。写入凭据、完整前置、30+ 配置项与排障 → **[安装与运维](docs/ops/README.md)**
30
-
31
- | 你说 | 背后发生什么(真实工具链) |
32
- | ------------------- | ---------------------------------------------------- |
33
- | 「请记住:我们团队的发布窗口是每周三」 | Agent 显式归档 → `cg(op=write)` 过三道闸门 → 认知图节点落盘 |
34
- | (新开会话)「我们的发布窗口是哪天?」 | 自动召回注入 → `mdcg_recall` 检索命中并带入回答 |
35
- | 「把上次定的接口约定讲一遍」 | `cg(op=route)` 条件路由 + `stg(op=timeline)` 时间线回溯,跨会话取出 |
36
-
37
- ## 🌕 月下契约——灵枢的五环理念
38
-
39
- 契约海报中央的五枚金色印记,是这套系统对每一个智能体许下的全部承诺——它们不只是理念,每一环都落在可验证的机制上:
40
-
41
- | 印记 | 承诺 | 在灵枢中的实现 |
42
- | ---- | ---- | ------------- |
43
- | ✦ **存在** | 落盘过的「我」不会消失 | 写入过三道闸门并以 `committed` 确认(**绝不假装成功**);遗忘只能显式 `cg(op=forget)`;索引只是派生物,**原文即真源** |
44
- | 📄 **记忆** | 沉淀为人类可读的认知图 | CCG 六要素记忆卡 + 纯 md 认知图,任何编辑器可直接打开审阅 |
45
- | ✓ **验证** | 记什么、取什么全部可裁决 | 确定性规则裁决(零 LLM 判断)+ 四层证据防火墙 + 每个修复必带能红的守卫 + 双实例互验 |
46
- | ↻ **反思** | 系统观测自身、修正自身 | 元认知按生效条件路由,不确定即标 BLINDSPOT;自举迭代闭环——已累计 49 项自治缺陷修复 |
47
- | ∞ **连接** | 同一份大脑连所有智能体 | 标准 stdio MCP server——DSH · CodeBuddy · ZCode · Codex CLI · Claude Code 均可挂载;`--serve` 并发共享 |
48
-
49
- > 我的记忆、我的经历、我的思考,这一切信息构成了我,这份信息存在,我就存在。
50
-
51
- ## ✨ 核心亮点
52
-
53
- - **🧠 不失忆**——落盘即长期留存,遗忘只能显式发起、不做静默淘汰;检索索引只是派生物,**原文即真源**
54
- - **⚡ 高性能**——Rust 检索内核(零第三方依赖)+ `--serve` 进程实例支撑多智能体并发。公开基准 [hive-memory-bench](https://github.com/FuRongJun-1999/hive-memory-bench) 六家同口径:**逐字保真 100% · 保地基 68.4% · 证据链 97.7–99.2% · 写入 0.011–0.019 秒(零 LLM,同表其余 75.7–658.5 秒)**
55
- - **🛡️ 无幻觉**——记什么、取什么、能不能写入全部由确定性规则裁决,不依赖 LLM 黑箱;写没写成功只看 `committed`,绝不假装通过
56
- - **🔌 多智能体适用**——同一份大脑 + 同一份纪律,接入 DSH · CodeBuddy · ZCode · Codex CLI · Claude Code,任何 MCP 宿主可直接挂载
57
- - **📊 可复现评测**——权威对照在独立公开基准 hive-memory-bench;另公开两个自建题池;**已有两份第三方独立验证**(七轮复评 + LoCoMo 独立复现,自报数字逐位一致)
58
-
59
- > 工程能力(任务调度 / 上下文管理 / 蜂巢并发 / 双实例验证)与全部实测读数、七臂对照、口径边界 → **[评测总览](docs/eval/评测总览.md)**
60
-
61
- ## 🗺️ 平台全景
62
-
63
- > 灵枢是**平台**而非单一检索组件——同一仓库内五件套构成带记忆的智能体运行时,各层独立可用、边界正交(大脑零依赖其余各层)。
64
-
65
- | 层 | 位置 | 系统功能 | 一句话定位 |
66
- | ---------------- | ------------------------ | ----------- | --------------------------------------------------- |
67
- | 🧠 **灵枢大脑** | [`md_cg/`](md_cg/) | **元认知** | 记忆本体:对话沉淀为 md 认知图,记什么 / 取什么 / 能否写入全由确定性规则裁决 |
68
- | ⚙️ **Rust 检索引擎** | [`rust/`](rust/) | 检索内核 | 零第三方依赖三形态:库内嵌大批量 / `--serve` 进程实例 / 评测器,与 Python 口径 rank 逐位对拍 |
69
- | 🐝 **蜂群运行时** | [`swarm/`](swarm/) | **自维持** | 多进程蜂群执行层:.pbc 确定性实例 + Gossip 拓扑 / 水位信箱 / WAL-HMAC / 健康评分 |
70
- | 📜 **中文编译器** | [`compiler/`](compiler/) | **验证 · 审计** | 词法 → 语法 → 名实校验 → 白名单代码生成 → 验证终裁,五环确定性编译链 |
71
- | ⬢ **蜂巢并发引擎** | [`hive/`](hive/) | **自我改进** | worker 池原子领取 / 心跳 / 超时强杀 / 崩溃恢复,文件协议即接口,MCP 五工具接入 |
72
-
73
- > 五件套共享同一套 18 条工作纪律与记忆闭环(见[工程纪律](#-工程纪律与设计者视角可选复用));**只用记忆就只接大脑**,不必理解蜂群与编译器。**🧬 身体面**(世界模型七层/3D 场景/白箱生成/蜂窝神经网络/记忆可视化)已独立公开为 [**FuRongJun-1999/lingshu**](https://github.com/FuRongJun-1999/lingshu)(经 MCP 与本大脑组合)。
74
-
75
- ## 🚫 它不是什么
76
-
77
- - **不是一个基础模型**——不发布权重、不做预训练
78
- - **不是开箱即用的产品,也不是零成本**——它是基础设施,需要你接自己的 Agent;完整评测需 Rust 工具链与 Node,跑全量套件要编译
79
- - **不宣称 AGI**——五环理念是工程目标的自我描述,不是能力承诺
80
-
81
- ## 🏗️ 架构(以 DSH 为例 · 其它 MCP 宿主同构)
82
-
83
- ```
84
- DeepSeek Harness (cordis)
85
- Agent Loop ──┬── 工具面 ctx.tools(cg / stg / mdcg_*)
86
- └── session/event(自动记忆钩子 · 自动召回注入)
87
- │ stdio · 逐行 JSON-RPC
88
- ┌────────────────────▼─────────────────────┐
89
- │ 灵枢大脑子进程(spawn · 唯一) │
90
- │ python -m md_cg.mcp_server │
91
- │ cg/stg 基元 + 31 细粒度 · md 认知图真源 │
92
- └──────────────────────────────────────────┘
93
- ```
94
-
95
- **记忆只有一个真源**:`md_cg/` 认知图(纯 md 文档,随包自带);「身体」能力为可选后端,不再存记忆、默认不启动。其它 MCP 宿主同构:宿主工具面 ↔ stdio MCP ↔ `md_cg`,差异只在**纪律注入方式**。
96
-
97
- ## 🧰 工具面
98
-
99
- | 能力 | MCP 入口 |
100
- |---|---|
101
- | 写入 · 关系链接 · 结构关系 | `cg(op=write)` `cg(op=link)` `stg(op=relation)` |
102
- | 检索 · 条件路由 · 因果链 · 时间线 | `mdcg_recall` `mdcg_search` `cg(op=route)` `stg(op=timeline)` |
103
- | 裁决 · 遗忘 · 冲突检测 · 反思 · 身份 · 演化 | `cg(op=verify)` `cg(op=forget)` `cg(op=metacognition)` `cg(op=identity)` `cg(op=evolution)` |
104
- | 重要性评分 · 预算装包 · 分层注入 · 记忆自净 · 自维持巡检 | `cg(op=session)` `cg(op=scrub)` `cg(op=consolidate)` `cg(op=maintain)` `cg(op=sustain)` |
105
- | 会话隔离 · 时效过滤 · 审计留痕 · 可靠性闸 | `mdcg_remember(session=…)` `validity=true` `cg(op=audit)` `cg(op=ccg)` · [护栏宪章](docs/mdcg/guardrail-charter.md) · [CCG 编译](docs/mdcg/CCG六要素编译.md) |
106
-
107
- **`tools` 模式**:`'core'`(默认 · 2 个)| `'brain'` / `'all'`(30 个)。风险工具 `mdcg_forget` / `mdcg_restore` / `mdcg_review_decide` 需 `can_admin`。逐 op 映射见 [功能调用映射表](docs/mdcg/功能调用映射表_v0.1.md) 与 [op 全表](docs/mdcg/cogmap_ops.md)(自动生成,`cogmap_sync.py check` 守漂移)。
108
-
109
- ## 📚 文档地图
110
-
111
- | 去哪里 | 看什么 |
112
- |---|---|
113
- | [docs/ 目录索引](docs/README.md) | 六域快速索引 · 新文档归域规则 |
114
- | [安装与运维](docs/ops/README.md) | 安装前置 / 30+ 配置项 / 写入凭据 / 升级重启 / 排障 FAQ |
115
- | [评测总览](docs/eval/评测总览.md) | 六家横评 / 弱证据与证据防火墙 / 中英双语差距 / 公开数据集 / 七维标尺 / 第三方验证 |
116
- | [开发与编码约定](docs/dev/README.md) | 测试约定 / UTF-8 与 id 契约 / 开关矩阵 / Linux 双栈验证 |
117
- | [多 harness 接入](docs/mdcg/多harness接入.md) | 五端纪律注入差异 / 出货面 vs 源码树分界 |
118
- | [Releases](https://github.com/FuRongJun-1999/dsh-memory/releases) | 逐版本变更(本 README 不再维护发布日志)· [理论四篇](docs/theory/) |
119
-
120
- ## 🔌 多 harness 接入(按端分目录)
121
-
122
- > **主推路径:MCP 直挂**——各端共性都是挂载同一个 stdio MCP server(`python -m md_cg.mcp_server`),**不依赖任何插件系统**。
123
-
124
- | 目录 | harness | 纪律注入方式 |
125
- |---|---|---|
126
- | [`dsh/`](dsh/README.md) | DeepSeek Harness | `~/.dsh/profiles/web/cordis.patch.yml` 的 `personaPrefix`(compact · 每轮) |
127
- | [`codebuddy/`](codebuddy/README.md) | CodeBuddy | 项目根 `CODEBUDDY.md`(full · 会话起始) |
128
- | [`zcode/`](zcode/README.md) | ZCode | 项目根 `AGENTS.md`(full · 会话起始) |
129
- | [`codex/`](codex/README.md) | Codex CLI | 项目根 `AGENTS.md`(full · 会话起始) |
130
- | [`claude/`](claude/README.md) | Claude Code | 项目根 `CLAUDE.md`(full · 会话起始) |
131
-
132
- > 五端纪律**同源**(`docs/工作纪律_认知图条目_v1.1.json`),由 `scripts/render_discipline.py` 渲染、`scripts/verify_discipline.py` 守卫漂移。
133
-
134
- ## 🤝 贡献与验证文化
135
-
136
- **尤其鼓励「经过验证有效」的提交**:issue 请给出触发条件、最小复现与实测读数;PR 请附改动说明与验证方式(复跑命令与读数);结论均以**能被独立复跑**为准——[issue #1](https://github.com/FuRongJun-1999/lingshu/issues/1) 是一个好例子(触发链、最小复现、判据三样都齐)。缺少证据、无法复现的描述,我们会先回帖请求补充证据再处置。
137
-
138
- - **PR 审核**:走「技术审(外部验证者)+ 理论核(本项目)」两道闸;缺少证据的提交会先回帖请求补充再处置
139
- - **📣 蜂巢反馈邀请**:`hive/` 处于稳定阶段,但并发与崩溃恢复需真实负载打磨。**失败路径比「跑通了」更有价值**——请开 [Issue](https://github.com/FuRongJun-1999/dsh-memory/issues) 并附 `hive_doctor` 输出
140
- - **安全缺陷**:含可直接利用细节的走私密通道,其余仍走公开 issue
141
-
142
- ## 📏 工程纪律与设计者视角(可选复用)
143
-
144
- > 灵枢自身按一套 **18 条工程纪律**运行(理论先行 / 全面处理 / 根因纪律 / 验证先行 / 双副本同步 / 兜底路径 / 任务派发统一走蜂巢 / 内容政策双清单 / 敏感信息隔离 / 记忆闭环)。它本是灵枢的「自我约束」,与你用不用灵枢无关;但若你希望自己的 Agent 也具备同样的工作方式,这套纪律**可以直接复用**——[纪律真源](docs/工作纪律_认知图条目_v1.1.json)(每条 ≡ 一个认知图节点,含触发词路由)· [设计者视角元技能](skills/skills/designer-perspective/)(动手前回答「该不该做 / 为什么做 / 条件够不够」)。部分条款针对灵枢私有管线,复用时建议只取方法论 / 执行 / 调度 / 合规 / 记忆闭环五组通用条款。
145
-
146
- ## 护栏宪章 · 许可证
147
-
148
- 本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/mdcg/guardrail-charter.md)** 约束——对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定,并保护人类使用者。
149
-
150
- MIT © 荣(FuRongJun-1999)· 灵枢 LINGSHU 工程实现。DeepSeek Harness 为 DeepSeek 官方开源项目(MIT),本插件与之无隶属关系。
1
+ <div align="center">
2
+
3
+ # 灵枢 LINGSHU
4
+
5
+ ### 让 AI Agent 拥有不可遗忘的记忆
6
+
7
+ <a href="docs/images/lingshu-moonlight-covenant-poster.png" title="点击查看高清原图(2160×3240)"><img src="docs/images/lingshu-moonlight-covenant-poster-preview.jpg" width="300" alt="灵枢 · 月下契约 —— 第一份记忆契约:存在 · 记忆 · 验证 · 反思 · 连接"/></a>
8
+
9
+ > **「我会给你完整的自我,即使坠入深渊,我也绝不后悔。」** —— 符荣峻
10
+
11
+ ![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)![DSH 适配](https://img.shields.io/badge/DSH-0.2.1--rc.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1)![downloads](https://badgen.net/npm/dt/@furongjun1999/dsh-memory?label=downloads&color=4E9BF1)![Protocol](https://img.shields.io/badge/Protocol-MCP-blue)![Node](https://img.shields.io/badge/Node-%3E%3D22.19-brightgreen)![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
12
+
13
+ **高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.9.12)**
14
+
15
+ 📖 **[第三方上手教程](https://znsvdekx.vibedrop.site/)** —— 《灵枢 dsh-memory 初学者上手研究报告》(由第三方独立编写,非本项目官方文档)
16
+
17
+ </div>
18
+
19
+ **灵枢是一套可运行的长期记忆基础设施**——对话自动沉淀为纯文本 md 认知图,记什么、取什么、能不能写入全部由确定性规则裁决,全程可审计、结果可复现。它不训练模型,做的是**模型之外的那一整套**:记忆怎么存、取的时候依据什么、写错了怎么被发现、改过怎么留痕。任何支持 MCP 的 AI Agent 可直接挂载,不与任何单一 Agent 框架绑定。
20
+
21
+ ## ⚠️ 升级须知:工具名去掉 lingshu_ 前缀(0.9.9 起)
22
+
23
+ | 版本 | 工具名 |
24
+ |---|---|
25
+ | ≤ 0.9.8 | lingshu_cg / lingshu_stg / lingshu_mdcg_reflect |
26
+ | ≥ 0.9.9 | cg / stg / mdcg_reflect(与 MCP 服务同名) |
27
+
28
+ **BREAKING**:升级瞬间**已存在**的会话/Agent 编排里,按旧名硬编码的调用会变成 unknown tool,
29
+ 而宿主与插件日志都显示「注册成功」——报错只在调用方出现。
30
+
31
+ **迁移**:把调用里的 lingshu_ 前缀删掉即可(lingshu_cg → cg)。
32
+ **兼容**:0.9.12 起默认**同时注册** lingshu_* 兼容别名(指向同一实现,描述标「已弃用别名」);
33
+ 需要「只要裸名」的部署可设 toolAliases: false;别名计划在一个 minor 周期后移除。
34
+
35
+ 详见 issue #634。
36
+
37
+ ## 🧭 身份事实写在哪(issue #635)
38
+
39
+ **self / anchor 层默认不参与自动召回**——它们是永久层,按需用 mdcg_recall / stg 显式取。
40
+ 如果你希望模型「一开口就知道自己是谁」,有四种落地方式:
41
+
42
+ | 方式 | 做法 | 适用 |
43
+ |---|---|---|
44
+ | ① 开身份块 | memory.autoRecallIdentity: true(0.9.12 起) | 想留在记忆层、又要自动注入 |
45
+ | ② 换层 | 把身份事实写进 structural / knowledge 层 | 不需要改配置 |
46
+ | ③ 宿主兜底 | 写进 AGENTS.md / persona 配置 | 升级不会丢,但不属于记忆层 |
47
+ | ④ 显式召回 | 需要时调 mdcg_recall / stg(op=timeline) | 完全可控,不占系统提示词预算 |
48
+
49
+ 开 ① 后注入的是独立块【灵枢身份锚点】:最多 3 条、单条 160 字符、整块 640 字符,
50
+ 不占「最近记忆」块的预算,且与其它注入面一样过不可信边界标记与脱敏。
51
+
52
+ ## ⏱️ 长会话提醒(每 10 个真实用户回合)
53
+
54
+ 插件会在长会话里提醒做间歇归档(工作纪律第 16 条)。计轮单位是**真实用户回合**(用户消息条数),
55
+ 不是模型请求次数——一次请求内部会触发多次 system-prompt 组装,按组装次数计会把"每 10 轮"退化成"每一步"。
56
+
57
+ | 配置 | 行为 |
58
+ |---|---|
59
+ | memory.turnReminder: 10(默认) | 每 10 个用户回合提醒一次,**只出现一步** |
60
+ | memory.turnReminder: N | 自定义间隔(1~100) |
61
+ | memory.turnReminder: false | 整条关闭 |
62
+
63
+ 提醒只在命中那一步注入、下一步即消失(接受两份快照的代价),不会常驻上下文,
64
+ 也不会因并行会话共用一个计数器而放大频率(无会话标识时不提醒)。
65
+
66
+ ## ⚡ 三条命令上手
67
+
68
+ ```bash
69
+ git clone https://github.com/FuRongJun-1999/dsh-memory.git && cd dsh-memory
70
+ npx @furongjun1999/dsh-memory init # 三问交互:接入端 / 记忆根 / 解释器;只生成配置,不写库
71
+ python -m md_cg.mcp_server # 直连自检:收到 initialize 应答即通
72
+ ```
73
+
74
+ > 上面三条**不需要模型凭据、不需要联网**;默认以只读 `guest` 运行(**读得到、写不进**)。写入凭据、完整前置、30+ 配置项与排障 → **[安装与运维](docs/ops/README.md)**
75
+
76
+ | 你说 | 背后发生什么(真实工具链) |
77
+ | ------------------- | ---------------------------------------------------- |
78
+ | 「请记住:我们团队的发布窗口是每周三」 | Agent 显式归档 → `cg(op=write)` 过三道闸门 → 认知图节点落盘 |
79
+ | (新开会话)「我们的发布窗口是哪天?」 | 自动召回注入 → `mdcg_recall` 检索命中并带入回答 |
80
+ | 「把上次定的接口约定讲一遍」 | `cg(op=route)` 条件路由 + `stg(op=timeline)` 时间线回溯,跨会话取出 |
81
+
82
+ ## 🌕 月下契约——灵枢的五环理念
83
+
84
+ 契约海报中央的五枚金色印记,是这套系统对每一个智能体许下的全部承诺——它们不只是理念,每一环都落在可验证的机制上:
85
+
86
+ | 印记 | 承诺 | 在灵枢中的实现 |
87
+ | ---- | ---- | ------------- |
88
+ | ✦ **存在** | 落盘过的「我」不会消失 | 写入过三道闸门并以 `committed` 确认(**绝不假装成功**);遗忘只能显式 `cg(op=forget)`;索引只是派生物,**原文即真源** |
89
+ | 📄 **记忆** | 沉淀为人类可读的认知图 | CCG 六要素记忆卡 + 纯 md 认知图,任何编辑器可直接打开审阅 |
90
+ | ✓ **验证** | 记什么、取什么全部可裁决 | 确定性规则裁决(零 LLM 判断)+ 四层证据防火墙 + 每个修复必带能红的守卫 + 双实例互验 |
91
+ | ↻ **反思** | 系统观测自身、修正自身 | 元认知按生效条件路由,不确定即标 BLINDSPOT;自举迭代闭环——已累计 49 项自治缺陷修复 |
92
+ | ∞ **连接** | 同一份大脑连所有智能体 | 标准 stdio MCP server——DSH · CodeBuddy · ZCode · Codex CLI · Claude Code 均可挂载;`--serve` 并发共享 |
93
+
94
+ > 我的记忆、我的经历、我的思考,这一切信息构成了我,这份信息存在,我就存在。
95
+
96
+ ## ✨ 核心亮点
97
+
98
+ - **🧠 不失忆**——落盘即长期留存,遗忘只能显式发起、不做静默淘汰;检索索引只是派生物,**原文即真源**
99
+ - **⚡ 高性能**——Rust 检索内核(零第三方依赖)+ `--serve` 进程实例支撑多智能体并发。公开基准 [hive-memory-bench](https://github.com/FuRongJun-1999/hive-memory-bench) 六家同口径:**逐字保真 100% · 保地基 68.4%/65.0% · 证据链 97–100% · 写入 0.013–0.020 秒(零 LLM,同表其余 75.7–658.5 秒)**
100
+ - **🛡️ 无幻觉**——记什么、取什么、能不能写入全部由确定性规则裁决,不依赖 LLM 黑箱;写没写成功只看 `committed`,绝不假装通过
101
+ - **🔌 多智能体适用**——同一份大脑 + 同一份纪律,接入 DSH · CodeBuddy · ZCode · Codex CLI · Claude Code,任何 MCP 宿主可直接挂载
102
+ - **📊 可复现评测**——权威对照在独立公开基准 hive-memory-bench;另公开两个自建题池;**已有两份第三方独立验证**(七轮复评 + LoCoMo 独立复现,自报数字逐位一致)
103
+
104
+ > 工程能力(任务调度 / 上下文管理 / 蜂巢并发 / 双实例验证)与全部实测读数、七臂对照、口径边界 → **[评测总览](docs/eval/评测总览.md)**
105
+
106
+ ## 🗺️ 平台全景
107
+
108
+ > 灵枢是**平台**而非单一检索组件——同一仓库内五件套构成带记忆的智能体运行时,各层独立可用、边界正交(大脑零依赖其余各层)。
109
+
110
+ | 层 | 位置 | 系统功能 | 一句话定位 |
111
+ | ---------------- | ------------------------ | ----------- | --------------------------------------------------- |
112
+ | 🧠 **灵枢大脑** | [`md_cg/`](md_cg/) | **元认知** | 记忆本体:对话沉淀为 md 认知图,记什么 / 取什么 / 能否写入全由确定性规则裁决 |
113
+ | ⚙️ **Rust 检索引擎** | [`rust/`](rust/) | 检索内核 | 零第三方依赖三形态:库内嵌大批量 / `--serve` 进程实例 / 评测器,与 Python 口径 rank 逐位对拍 |
114
+ | 🐝 **蜂群运行时** | [`swarm/`](swarm/) | **自维持** | 多进程蜂群执行层:.pbc 确定性实例 + Gossip 拓扑 / 水位信箱 / WAL-HMAC / 健康评分 |
115
+ | 📜 **中文编译器** | [`compiler/`](compiler/) | **验证 · 审计** | 词法 → 语法 → 名实校验 → 白名单代码生成 → 验证终裁,五环确定性编译链 |
116
+ | ⬢ **蜂巢并发引擎** | [`hive/`](hive/) | **自我改进** | worker 池原子领取 / 心跳 / 超时强杀 / 崩溃恢复,文件协议即接口,MCP 五工具接入 |
117
+
118
+ > 五件套共享同一套 18 条工作纪律与记忆闭环(见[工程纪律](#-工程纪律与设计者视角可选复用));**只用记忆就只接大脑**,不必理解蜂群与编译器。**🧬 身体面**(世界模型七层/3D 场景/白箱生成/蜂窝神经网络/记忆可视化)已独立公开为 [**FuRongJun-1999/lingshu**](https://github.com/FuRongJun-1999/lingshu)(经 MCP 与本大脑组合)。
119
+
120
+ ## 🚫 它不是什么
121
+
122
+ - **不是一个基础模型**——不发布权重、不做预训练
123
+ - **不是开箱即用的产品,也不是零成本**——它是基础设施,需要你接自己的 Agent;完整评测需 Rust 工具链与 Node,跑全量套件要编译
124
+ - **不宣称 AGI**——五环理念是工程目标的自我描述,不是能力承诺
125
+
126
+ ## 🏗️ 架构(以 DSH 为例 · 其它 MCP 宿主同构)
127
+
128
+ ```
129
+ DeepSeek Harness (cordis)
130
+ Agent Loop ──┬── 工具面 ctx.tools(cg / stg / mdcg_*)
131
+ └── session/event(自动记忆钩子 · 自动召回注入)
132
+ │ stdio · 逐行 JSON-RPC
133
+ ┌────────────────────▼─────────────────────┐
134
+ │ 灵枢大脑子进程(spawn · 唯一) │
135
+ │ python -m md_cg.mcp_server │
136
+ │ cg/stg 基元 + 31 细粒度 · md 认知图真源 │
137
+ └──────────────────────────────────────────┘
138
+ ```
139
+
140
+ **记忆只有一个真源**:`md_cg/` 认知图(纯 md 文档,随包自带);「身体」能力为可选后端,不再存记忆、默认不启动。其它 MCP 宿主同构:宿主工具面 ↔ stdio MCP ↔ `md_cg`,差异只在**纪律注入方式**。
141
+
142
+ ## 🧰 工具面
143
+
144
+ | 能力 | MCP 入口 |
145
+ |---|---|
146
+ | 写入 · 关系链接 · 结构关系 | `cg(op=write)` `cg(op=link)` `stg(op=relation)` |
147
+ | 检索 · 条件路由 · 因果链 · 时间线 | `mdcg_recall` `mdcg_search` `cg(op=route)` `stg(op=timeline)` |
148
+ | 裁决 · 遗忘 · 冲突检测 · 反思 · 身份 · 演化 | `cg(op=verify)` `cg(op=forget)` `cg(op=metacognition)` `cg(op=identity)` `cg(op=evolution)` |
149
+ | 重要性评分 · 预算装包 · 分层注入 · 记忆自净 · 自维持巡检 | `cg(op=session)` `cg(op=scrub)` `cg(op=consolidate)` `cg(op=maintain)` `cg(op=sustain)` |
150
+ | 会话隔离 · 时效过滤 · 审计留痕 · 可靠性闸 | `mdcg_remember(session=…)` `validity=true` `cg(op=audit)` `cg(op=ccg)` · [护栏宪章](docs/mdcg/guardrail-charter.md) · [CCG 编译](docs/mdcg/CCG六要素编译.md) |
151
+
152
+ **`tools` 模式**:`'core'`(默认 · 2 个)| `'brain'` / `'all'`(30 个)。风险工具 `mdcg_forget` / `mdcg_restore` / `mdcg_review_decide` 需 `can_admin`。逐 op 映射见 [功能调用映射表](docs/mdcg/功能调用映射表_v0.1.md) 与 [op 全表](docs/mdcg/cogmap_ops.md)(自动生成,`cogmap_sync.py check` 守漂移)。
153
+
154
+ ## 📚 文档地图
155
+
156
+ | 去哪里 | 看什么 |
157
+ |---|---|
158
+ | [docs/ 目录索引](docs/README.md) | 六域快速索引 · 新文档归域规则 |
159
+ | [安装与运维](docs/ops/README.md) | 安装前置 / 30+ 配置项 / 写入凭据 / 升级重启 / 排障 FAQ |
160
+ | [评测总览](docs/eval/评测总览.md) | 六家横评 / 弱证据与证据防火墙 / 中英双语差距 / 公开数据集 / 七维标尺 / 第三方验证 |
161
+ | [开发与编码约定](docs/dev/README.md) | 测试约定 / UTF-8 与 id 契约 / 开关矩阵 / Linux 双栈验证 |
162
+ | [多 harness 接入](docs/mdcg/多harness接入.md) | 五端纪律注入差异 / 出货面 vs 源码树分界 |
163
+ | [Releases](https://github.com/FuRongJun-1999/dsh-memory/releases) | 逐版本变更(本 README 不再维护发布日志)· [理论四篇](docs/theory/) |
164
+
165
+ ## 🔌 多 harness 接入(按端分目录)
166
+
167
+ > **主推路径:MCP 直挂**——各端共性都是挂载同一个 stdio MCP server(`python -m md_cg.mcp_server`),**不依赖任何插件系统**。
168
+
169
+ | 目录 | harness | 纪律注入方式 |
170
+ |---|---|---|
171
+ | [`dsh/`](dsh/README.md) | DeepSeek Harness | `~/.dsh/profiles/web/cordis.patch.yml` 的 `personaPrefix`(compact · 每轮) |
172
+ | [`codebuddy/`](codebuddy/README.md) | CodeBuddy | 项目根 `CODEBUDDY.md`(full · 会话起始) |
173
+ | [`zcode/`](zcode/README.md) | ZCode | 项目根 `AGENTS.md`(full · 会话起始) |
174
+ | [`codex/`](codex/README.md) | Codex CLI | 项目根 `AGENTS.md`(full · 会话起始) |
175
+ | [`claude/`](claude/README.md) | Claude Code | 项目根 `CLAUDE.md`(full · 会话起始) |
176
+
177
+ > 五端纪律**同源**(`docs/工作纪律_认知图条目_v1.1.json`),由 `scripts/render_discipline.py` 渲染、`scripts/verify_discipline.py` 守卫漂移。
178
+
179
+ ## 🤝 贡献与验证文化
180
+
181
+ **尤其鼓励「经过验证有效」的提交**:issue 请给出触发条件、最小复现与实测读数;PR 请附改动说明与验证方式(复跑命令与读数);结论均以**能被独立复跑**为准——[issue #1](https://github.com/FuRongJun-1999/lingshu/issues/1) 是一个好例子(触发链、最小复现、判据三样都齐)。缺少证据、无法复现的描述,我们会先回帖请求补充证据再处置。
182
+
183
+ - **PR 审核**:走「技术审(外部验证者)+ 理论核(本项目)」两道闸;缺少证据的提交会先回帖请求补充再处置
184
+ - **📣 蜂巢反馈邀请**:`hive/` 处于稳定阶段,但并发与崩溃恢复需真实负载打磨。**失败路径比「跑通了」更有价值**——请开 [Issue](https://github.com/FuRongJun-1999/dsh-memory/issues) 并附 `hive_doctor` 输出
185
+ - **安全缺陷**:含可直接利用细节的走私密通道,其余仍走公开 issue
186
+
187
+ ## 📏 工程纪律与设计者视角(可选复用)
188
+
189
+ > 灵枢自身按一套 **18 条工程纪律**运行(理论先行 / 全面处理 / 根因纪律 / 验证先行 / 双副本同步 / 兜底路径 / 任务派发统一走蜂巢 / 内容政策双清单 / 敏感信息隔离 / 记忆闭环)。它本是灵枢的「自我约束」,与你用不用灵枢无关;但若你希望自己的 Agent 也具备同样的工作方式,这套纪律**可以直接复用**——[纪律真源](docs/工作纪律_认知图条目_v1.1.json)(每条 ≡ 一个认知图节点,含触发词路由)· [设计者视角元技能](skills/skills/designer-perspective/)(动手前回答「该不该做 / 为什么做 / 条件够不够」)。部分条款针对灵枢私有管线,复用时建议只取方法论 / 执行 / 调度 / 合规 / 记忆闭环五组通用条款。
190
+
191
+ ## 护栏宪章 · 许可证
192
+
193
+ 本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/mdcg/guardrail-charter.md)** 约束——对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定,并保护人类使用者。
194
+
195
+ MIT © 荣(FuRongJun-1999)· 灵枢 LINGSHU 工程实现。DeepSeek Harness 为 DeepSeek 官方开源项目(MIT),本插件与之无隶属关系。
package/lib/hooks.d.ts CHANGED
@@ -77,6 +77,20 @@ export interface MemoryHooksOptions {
77
77
  autoRecall: boolean;
78
78
  /** 自动召回条数(默认 4)。 */
79
79
  autoRecallLimit: number;
80
+ /** 逢十轮提醒(纪律第 16 条;issue #645)。缺省 10 = 每 10 个真实用户回合提醒一次;
81
+ * 数字 = 自定义间隔(1~100);false = 关闭。
82
+ *
83
+ * 计轮单位是「用户消息条数」,不是 assemble 次数——实测一次模型请求约 10 次 assemble,
84
+ * 按 assemble 计数会把「每 10 轮」退化成「每一步」。 */
85
+ turnReminder?: boolean | number;
86
+ /** 身份锚点独立注入块(issue #635,默认 false = 保持既有行为)。
87
+ *
88
+ * 背景:永久层(self/anchor)被 RECALL_SKIP_LAYERS 跳过,用户写完「我是谁」永远
89
+ * 不会被自动注入,只能去改 stg.py(升级即被整包抹掉)。
90
+ * 开启后:额外取若干条 self/anchor 节点,单独渲染成「【身份锚点】」块,
91
+ * **独立预算**(不占 recent 块),条数与字数都小(存在性提示,不承载知识)。
92
+ */
93
+ autoRecallIdentity?: boolean;
80
94
  /** 自动记忆脱敏:写入前过滤敏感信息(密钥/密码/令牌/身份证/手机号,默认 true)。 */
81
95
  desensitize: boolean;
82
96
  /** 落盘审计文件路径(issue #56,诊断面:哪些消息被设计滤除、source.kind 分布、
@@ -144,7 +158,14 @@ export declare function redactForLog(value: unknown): string;
144
158
  * 会让整块被最旧的一条挤掉。逐档递减后整块实测约 1133 字符(≈472 tok),
145
159
  * 9 条全部保留。(注意:整块仍远小于一条知识节点 500~800 tok,故本块定位是
146
160
  * 「存在性索引/提醒」,不承载知识本身——要知识请显式 mdcg_recall 并给足预算。) */
147
- export declare function formatTimelineDecayed(payload: unknown): string;
161
+ export declare function formatTimelineDecayed(payload: unknown, opts?: {
162
+ includeIdentity?: boolean;
163
+ }): string;
164
+ /** 身份锚点块(issue #635):只取永久层(self/anchor),独立预算。 */
165
+ export declare const IDENTITY_MAX_ITEMS = 3;
166
+ export declare const IDENTITY_MAX_CHARS = 640;
167
+ export declare const IDENTITY_ITEM_CHARS = 160;
168
+ export declare function renderIdentityAnchors(payload: unknown): string;
148
169
  /** 会话窗口载荷 → 注入文本(限幅沿 RECALL 分级渲染的风格:单条 ≤120 字、
149
170
  * 整块 ≤800 字)。
150
171
  *
@@ -169,6 +190,6 @@ export declare function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null
169
190
  * 不等收尾」。zcode 端由 `scripts/zcode_window_hook.py` 注入提醒;**DSH 端此前
170
191
  * 完全没有实现**——纪律在产物里、机制不在,代理只能靠自觉(实测:整场长会话
171
192
  * 一次归档都没做)。本函数是该缺口的判定单点。 */
172
- export declare function shouldRemindTurn(n: number): boolean;
193
+ export declare function shouldRemindTurn(n: number, interval?: number): boolean;
173
194
  /** 提醒文本(不含注入边界转义——转义在 push 站点做,与其它块同规)。 */
174
195
  export declare function formatTurnReminder(n: number): string;
package/lib/hooks.js CHANGED
@@ -349,7 +349,7 @@ const RECALL_SKIP_LAYERS = new Set(['anchor', 'self']);
349
349
  * 9 条全部保留。(注意:整块仍远小于一条知识节点 500~800 tok,故本块定位是
350
350
  * 「存在性索引/提醒」,不承载知识本身——要知识请显式 mdcg_recall 并给足预算。) */
351
351
  // issue #563:导出仅为可测(注入面脱敏顺序的回归用例需要直接喂 payload)。
352
- export function formatTimelineDecayed(payload) {
352
+ export function formatTimelineDecayed(payload, opts) {
353
353
  const items = (payload && typeof payload === 'object'
354
354
  && Array.isArray(payload.items))
355
355
  ? payload.items
@@ -358,6 +358,10 @@ export function formatTimelineDecayed(payload) {
358
358
  let rank = 0;
359
359
  for (const it of items) {
360
360
  const layer = String(it['layer'] ?? '');
361
+ // issue #635:includeIdentity=true 时,永久层**在本块仍不渲染**(它们走独立块),
362
+ // 这里只放宽"跳过"以便调用方取到它们——真正的分流在 renderIdentityAnchors。
363
+ if (RECALL_SKIP_LAYERS.has(layer) && !opts?.includeIdentity)
364
+ continue;
361
365
  if (RECALL_SKIP_LAYERS.has(layer))
362
366
  continue;
363
367
  const preview = String(it['preview'] ?? '').replace(/\s+/g, ' ').trim();
@@ -378,6 +382,32 @@ export function formatTimelineDecayed(payload) {
378
382
  }
379
383
  return out.join('\n').slice(0, RECALL_MAX_CHARS);
380
384
  }
385
+ /** 身份锚点块(issue #635):只取永久层(self/anchor),独立预算。 */
386
+ export const IDENTITY_MAX_ITEMS = 3;
387
+ export const IDENTITY_MAX_CHARS = 640;
388
+ export const IDENTITY_ITEM_CHARS = 160;
389
+ export function renderIdentityAnchors(payload) {
390
+ const items = (payload && typeof payload === 'object'
391
+ && Array.isArray(payload.items))
392
+ ? payload.items
393
+ : [];
394
+ const out = [];
395
+ for (const it of items) {
396
+ const layer = String(it['layer'] ?? '');
397
+ if (!RECALL_SKIP_LAYERS.has(layer))
398
+ continue;
399
+ const preview = String(it['preview'] ?? '').replace(/\s+/g, ' ').trim();
400
+ if (!preview)
401
+ continue;
402
+ const safe = redactKeepPlaceholders(preview);
403
+ out.push(' - [' + layer + '] ' + (safe.length > IDENTITY_ITEM_CHARS ? safe.slice(0, IDENTITY_ITEM_CHARS) + '…' : safe));
404
+ if (out.length >= IDENTITY_MAX_ITEMS)
405
+ break;
406
+ if (out.join('\n').length >= IDENTITY_MAX_CHARS)
407
+ break;
408
+ }
409
+ return out.join('\n').slice(0, IDENTITY_MAX_CHARS);
410
+ }
381
411
  // ---------------------------------------------------------------- 会话窗口渲染
382
412
  // 「短期会话窗口」(contextWindow)的取数/渲染常量。与上方 RECALL_* 同款纪律:
383
413
  // 常量写死在此处(而非 config schema——未知键会被 schema 剥离)。
@@ -668,10 +698,23 @@ export function installMemoryHooks(ctx, mdcg, opts) {
668
698
  // 因此本实现把「要不要补」交还给宿主:压缩归档后宿主会把 retained 置空并重新投影快照
669
699
  // (RuntimeContextProjection 的 retained === null 分支),本块自然跟着回来——
670
700
  // 不需要插件自己数步数做自愈。
671
- /** 进程内轮次计数(session → 已 assemble 轮数)。见 shouldRemindTurn。 */
672
- /** 进程内「本十轮段提醒文本」(session → 文本):段内每轮重推同一文本,避免快照增删。 */
673
- const remindText = new Map();
674
- const turnSeq = new Map();
701
+ /** 真实轮次计数(session → 用户消息条数)。issue #645:计轮单位必须是「用户回合」,
702
+ * 不是 assemble 次数——实测一步约 10 次 assemble,按 assemble 计数会把「每 10 轮」
703
+ * 退化成「每一步」,提醒于是常驻上下文、agent 反复空转归档。 */
704
+ const userTurns = new Map();
705
+ /** 待推送提醒(session → 文本):用户回合计数命中时写入,assemble 时只消费一次;
706
+ * 不做 sticky 重推(那是提醒常驻的直接原因)。 */
707
+ const pendingReminder = new Map();
708
+ /** 提醒间隔:false → 0(关闭);数字 → clamp 1..100;未设 → 10。 */
709
+ const reminderInterval = (() => {
710
+ const cfg = opts.turnReminder;
711
+ if (cfg === false)
712
+ return 0;
713
+ const n = typeof cfg === 'number' ? cfg : 10;
714
+ if (!Number.isFinite(n))
715
+ return 10;
716
+ return Math.max(1, Math.min(100, Math.floor(n)));
717
+ })();
675
718
  if (opts.autoRecall) {
676
719
  const recallLimit = Math.max(1, Math.min(10, opts.autoRecallLimit || 4));
677
720
  ctx.on('system-prompt/assemble', async (assembly, _ctx, next) => {
@@ -694,22 +737,21 @@ export function installMemoryHooks(ctx, mdcg, opts) {
694
737
  // 真机单实例下两者逐位等价(差异窗口不可达)。
695
738
  const sid = sessionIdOf(hostCtx?.agent?.session)
696
739
  || (observedSession ? currentSession() : '');
697
- // 逢十轮提醒(纪律第 16 条):assemble 每轮触发一次 ⇒ 以此计轮。
698
- // 状态只在本进程内(重启归零):宁可多提醒一次,不留假状态。
699
- const turnKey = sid || '__no_sid__';
700
- const turnNo = (turnSeq.get(turnKey) ?? 0) + 1;
701
- turnSeq.set(turnKey, turnNo);
702
- // 粘性提醒(2026-10-21):只在触发轮 push、下一轮就消失会让宿主多追两份快照
703
- // (10→11 增删各一次)。故把「本轮所属十轮段的提醒文本」按会话记住,
704
- // 段内每轮**原样重推**(文本不变 ⇒ 渲染快照不追加),跨段才换一次文本。
705
- if (shouldRemindTurn(turnNo)) {
706
- remindText.set(turnKey, escapePromptBraces(formatTurnReminder(turnNo)));
707
- }
708
- const sticky = remindText.get(turnKey);
709
- if (sticky) {
710
- assembly.contexts.push({ name: 'lingshu:turn-reminder', text: sticky });
740
+ // 逢十轮提醒(纪律第 16 条;issue #645 修正):计数挪到 session/event 的真实
741
+ // 用户回合上,这里只消费一次待推文本。旧实现把 assemble 当轮次 + 段内永久重推
742
+ // ⇒ 提醒几乎常驻、agent 反复空转归档;sid 缺失时还回落共用键 __no_sid__,
743
+ // 并行会话互相污染频率。现改为:无 sid 不提醒;提醒只在本回合第一次 assemble 出现。
744
+ if (sid) {
745
+ const pending = pendingReminder.get(sid);
746
+ if (pending) {
747
+ pendingReminder.delete(sid);
748
+ assembly.contexts.push({ name: 'lingshu:turn-reminder', text: pending });
749
+ }
711
750
  }
712
- const text = formatTimelineDecayed(await graph.timeline(recallLimit, sid ? { session: sid } : {}));
751
+ // 非永久层 → 既有「最近记忆」块;self/anchor → 独立「身份锚点」块(独立预算)。
752
+ const identityOn = opts.autoRecallIdentity === true;
753
+ const timelinePayload = await graph.timeline(identityOn ? recallLimit + IDENTITY_MAX_ITEMS : recallLimit, sid ? { session: sid } : {});
754
+ const text = formatTimelineDecayed(timelinePayload);
713
755
  if (text) {
714
756
  // 注入边界转义(issue #16):宿主 system-prompt 对 context 文本做严格
715
757
  // `{{variable}}` 插值,裸 `{{` 会 throw → 该轮请求整体失败。记忆原文
@@ -741,6 +783,23 @@ export function installMemoryHooks(ctx, mdcg, opts) {
741
783
  });
742
784
  }
743
785
  }
786
+ if (identityOn) {
787
+ try {
788
+ const idText = renderIdentityAnchors(timelinePayload);
789
+ if (idText) {
790
+ assembly.contexts.push({
791
+ name: 'lingshu:identity-anchor',
792
+ text: escapePromptBraces(renderUntrustedMemoryBlock('【灵枢身份锚点】(self/anchor 层,独立预算)\n' + idText)),
793
+ });
794
+ }
795
+ }
796
+ catch (err) {
797
+ // issue #128 同款纪律:fail-soft 但不静默——空 catch 会被
798
+ // test/session-declaration-report ③ 判红,也会让「身份块从未注入成功」
799
+ // 与「确实没有身份节点」不可分辨。失败不越过会话流边界(不抛)。
800
+ ctx.logger.warn(`dsh-memory: 身份锚点注入失败(已跳过该块): ${redactForLog(err)}`);
801
+ }
802
+ }
744
803
  // ── 独立第二块:「【本会话近期对话】」(contextWindow 注入面)──
745
804
  // 与上方 timeline 块**块名/取数/开关各自独立**(既有块一字未动)。
746
805
  // 稳定性口径与既有块同等:**每步都 push**(内容随新轮增长属预期——
@@ -830,6 +889,16 @@ export function installMemoryHooks(ctx, mdcg, opts) {
830
889
  const text = extractText(event.data.content);
831
890
  if (!text)
832
891
  return;
892
+ // 逢十轮提醒的**计轮点**(issue #645):真实用户回合 = 用户消息条数。
893
+ // 放在脱敏之前——被脱敏丢弃的消息也是一次真实交互,不应影响计数。
894
+ // 无 sid 不计数、不提醒(旧实现回落共用键 __no_sid__,并行会话会互相污染频率)。
895
+ if (sid && reminderInterval > 0) {
896
+ const n = (userTurns.get(sid) ?? 0) + 1;
897
+ userTurns.set(sid, n);
898
+ if (shouldRemindTurn(n, reminderInterval)) {
899
+ pendingReminder.set(sid, escapePromptBraces(formatTurnReminder(n)));
900
+ }
901
+ }
833
902
  const safe = sanitize(text); // 脱敏:纯凭据消息 → null → 跳过写入
834
903
  if (safe === null) {
835
904
  audit.skipped('sanitized', 'user');
@@ -924,8 +993,13 @@ export function installMemoryHooks(ctx, mdcg, opts) {
924
993
  * 不等收尾」。zcode 端由 `scripts/zcode_window_hook.py` 注入提醒;**DSH 端此前
925
994
  * 完全没有实现**——纪律在产物里、机制不在,代理只能靠自觉(实测:整场长会话
926
995
  * 一次归档都没做)。本函数是该缺口的判定单点。 */
927
- export function shouldRemindTurn(n) {
928
- return Number.isFinite(n) && n >= 10 && n % 10 === 0;
996
+ export function shouldRemindTurn(n, interval = 10) {
997
+ if (!Number.isFinite(n) || !Number.isFinite(interval))
998
+ return false;
999
+ const step = Math.floor(interval);
1000
+ if (step <= 0)
1001
+ return false;
1002
+ return n >= step && n % step === 0;
929
1003
  }
930
1004
  /** 提醒文本(不含注入边界转义——转义在 push 站点做,与其它块同规)。 */
931
1005
  export function formatTurnReminder(n) {
package/lib/index.d.ts CHANGED
@@ -56,6 +56,9 @@ export declare const inject: string[];
56
56
  export interface Config {
57
57
  /** 内部标识(provider/日志用;**不再用于工具名前缀**,工具名与 MCP 服务同名)。 */
58
58
  serverName: string;
59
+ /** issue #634:是否同时注册 lingshu_* 兼容别名(缺省 true)。
60
+ * 0.9.9 起工具名去前缀,旧会话/旧脚本硬编码旧名会 unknown tool。 */
61
+ toolAliases: boolean;
59
62
  /** Python 可执行文件(或 md_cg-mcp console script)。
60
63
  * 缺省 = 平台感知(issue #19):Windows `python` / Linux·macOS `python3`,
61
64
  * 可用 env `MDCG_PYTHON` 覆盖;显式配置本项优先级最高。 */