@furongjun1999/dsh-memory 0.9.9 → 0.9.12

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.
Files changed (38) hide show
  1. package/README.md +181 -150
  2. package/lib/hooks.d.ts +16 -1
  3. package/lib/hooks.js +53 -2
  4. package/lib/index.d.ts +3 -0
  5. package/lib/index.js +9 -1
  6. package/lib/tools.d.ts +8 -0
  7. package/lib/tools.js +32 -5
  8. package/md_cg/config_registry_bulk.py +488 -483
  9. package/md_cg/config_validate.py +5 -0
  10. package/md_cg/mcp_server.py +5446 -5324
  11. package/md_cg/mdcg.py +62 -4
  12. package/md_cg/mdcos.py +7259 -7159
  13. package/md_cg/refindex.py +11 -4
  14. package/md_cg/test_c3_transient_read_negative.py +797 -797
  15. package/md_cg/test_c8_search_rrf_gates.py +511 -502
  16. package/md_cg/test_domain_granularity.py +68 -0
  17. package/md_cg/test_exact_text_cache.py +194 -194
  18. package/md_cg/test_hotcache_tool.py +121 -121
  19. package/md_cg/test_index_snapshot_fastpath.py +72 -0
  20. package/md_cg/test_issue274_read_node_id_none.py +364 -364
  21. package/md_cg/test_issue623_fullwidth_symmetry.py +66 -0
  22. package/md_cg/test_p28_refcheck.py +7 -7
  23. package/md_cg/test_p3_legacy_closure.py +441 -441
  24. package/md_cg/test_retr_gates_prodpath.py +11 -1
  25. package/md_cg/test_search_async.py +84 -0
  26. package/md_cg/test_search_bm25_default.py +60 -60
  27. package/md_cg/test_search_prefilter.py +85 -0
  28. package/md_cg/test_untrusted_audit.py +55 -55
  29. package/md_cg/test_untrusted_classifier.py +42 -42
  30. package/md_cg/test_untrusted_enforcement.py +66 -66
  31. package/md_cg/tokens.py +5 -1
  32. package/md_cg/untrusted.py +45 -45
  33. package/md_cg/untrusted_audit.py +87 -87
  34. package/package.json +113 -113
  35. package/scripts/workspace_index.py +2 -0
  36. package/src/hooks.ts +1043 -986
  37. package/src/index.ts +12 -1
  38. package/src/tools.ts +37 -6
package/README.md CHANGED
@@ -1,150 +1,181 @@
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.9)**
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
+ ## ⚡ 三条命令上手
53
+
54
+ ```bash
55
+ git clone https://github.com/FuRongJun-1999/dsh-memory.git && cd dsh-memory
56
+ npx @furongjun1999/dsh-memory init # 三问交互:接入端 / 记忆根 / 解释器;只生成配置,不写库
57
+ python -m md_cg.mcp_server # 直连自检:收到 initialize 应答即通
58
+ ```
59
+
60
+ > 上面三条**不需要模型凭据、不需要联网**;默认以只读 `guest` 运行(**读得到、写不进**)。写入凭据、完整前置、30+ 配置项与排障 → **[安装与运维](docs/ops/README.md)**
61
+
62
+ | 你说 | 背后发生什么(真实工具链) |
63
+ | ------------------- | ---------------------------------------------------- |
64
+ | 「请记住:我们团队的发布窗口是每周三」 | Agent 显式归档 → `cg(op=write)` 过三道闸门 → 认知图节点落盘 |
65
+ | (新开会话)「我们的发布窗口是哪天?」 | 自动召回注入 → `mdcg_recall` 检索命中并带入回答 |
66
+ | 「把上次定的接口约定讲一遍」 | `cg(op=route)` 条件路由 + `stg(op=timeline)` 时间线回溯,跨会话取出 |
67
+
68
+ ## 🌕 月下契约——灵枢的五环理念
69
+
70
+ 契约海报中央的五枚金色印记,是这套系统对每一个智能体许下的全部承诺——它们不只是理念,每一环都落在可验证的机制上:
71
+
72
+ | 印记 | 承诺 | 在灵枢中的实现 |
73
+ | ---- | ---- | ------------- |
74
+ | ✦ **存在** | 落盘过的「我」不会消失 | 写入过三道闸门并以 `committed` 确认(**绝不假装成功**);遗忘只能显式 `cg(op=forget)`;索引只是派生物,**原文即真源** |
75
+ | 📄 **记忆** | 沉淀为人类可读的认知图 | CCG 六要素记忆卡 + 纯 md 认知图,任何编辑器可直接打开审阅 |
76
+ | ✓ **验证** | 记什么、取什么全部可裁决 | 确定性规则裁决(零 LLM 判断)+ 四层证据防火墙 + 每个修复必带能红的守卫 + 双实例互验 |
77
+ | ↻ **反思** | 系统观测自身、修正自身 | 元认知按生效条件路由,不确定即标 BLINDSPOT;自举迭代闭环——已累计 49 项自治缺陷修复 |
78
+ | ∞ **连接** | 同一份大脑连所有智能体 | 标准 stdio MCP server——DSH · CodeBuddy · ZCode · Codex CLI · Claude Code 均可挂载;`--serve` 并发共享 |
79
+
80
+ > 我的记忆、我的经历、我的思考,这一切信息构成了我,这份信息存在,我就存在。
81
+
82
+ ## ✨ 核心亮点
83
+
84
+ - **🧠 不失忆**——落盘即长期留存,遗忘只能显式发起、不做静默淘汰;检索索引只是派生物,**原文即真源**
85
+ - **⚡ 高性能**——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 秒)**
86
+ - **🛡️ 无幻觉**——记什么、取什么、能不能写入全部由确定性规则裁决,不依赖 LLM 黑箱;写没写成功只看 `committed`,绝不假装通过
87
+ - **🔌 多智能体适用**——同一份大脑 + 同一份纪律,接入 DSH · CodeBuddy · ZCode · Codex CLI · Claude Code,任何 MCP 宿主可直接挂载
88
+ - **📊 可复现评测**——权威对照在独立公开基准 hive-memory-bench;另公开两个自建题池;**已有两份第三方独立验证**(七轮复评 + LoCoMo 独立复现,自报数字逐位一致)
89
+
90
+ > 工程能力(任务调度 / 上下文管理 / 蜂巢并发 / 双实例验证)与全部实测读数、七臂对照、口径边界 → **[评测总览](docs/eval/评测总览.md)**
91
+
92
+ ## 🗺️ 平台全景
93
+
94
+ > 灵枢是**平台**而非单一检索组件——同一仓库内五件套构成带记忆的智能体运行时,各层独立可用、边界正交(大脑零依赖其余各层)。
95
+
96
+ | 层 | 位置 | 系统功能 | 一句话定位 |
97
+ | ---------------- | ------------------------ | ----------- | --------------------------------------------------- |
98
+ | 🧠 **灵枢大脑** | [`md_cg/`](md_cg/) | **元认知** | 记忆本体:对话沉淀为 md 认知图,记什么 / 取什么 / 能否写入全由确定性规则裁决 |
99
+ | ⚙️ **Rust 检索引擎** | [`rust/`](rust/) | 检索内核 | 零第三方依赖三形态:库内嵌大批量 / `--serve` 进程实例 / 评测器,与 Python 口径 rank 逐位对拍 |
100
+ | 🐝 **蜂群运行时** | [`swarm/`](swarm/) | **自维持** | 多进程蜂群执行层:.pbc 确定性实例 + Gossip 拓扑 / 水位信箱 / WAL-HMAC / 健康评分 |
101
+ | 📜 **中文编译器** | [`compiler/`](compiler/) | **验证 · 审计** | 词法 → 语法 → 名实校验 → 白名单代码生成 → 验证终裁,五环确定性编译链 |
102
+ | ⬢ **蜂巢并发引擎** | [`hive/`](hive/) | **自我改进** | worker 池原子领取 / 心跳 / 超时强杀 / 崩溃恢复,文件协议即接口,MCP 五工具接入 |
103
+
104
+ > 五件套共享同一套 18 条工作纪律与记忆闭环(见[工程纪律](#-工程纪律与设计者视角可选复用));**只用记忆就只接大脑**,不必理解蜂群与编译器。**🧬 身体面**(世界模型七层/3D 场景/白箱生成/蜂窝神经网络/记忆可视化)已独立公开为 [**FuRongJun-1999/lingshu**](https://github.com/FuRongJun-1999/lingshu)(经 MCP 与本大脑组合)。
105
+
106
+ ## 🚫 它不是什么
107
+
108
+ - **不是一个基础模型**——不发布权重、不做预训练
109
+ - **不是开箱即用的产品,也不是零成本**——它是基础设施,需要你接自己的 Agent;完整评测需 Rust 工具链与 Node,跑全量套件要编译
110
+ - **不宣称 AGI**——五环理念是工程目标的自我描述,不是能力承诺
111
+
112
+ ## 🏗️ 架构(以 DSH 为例 · 其它 MCP 宿主同构)
113
+
114
+ ```
115
+ DeepSeek Harness (cordis)
116
+ Agent Loop ──┬── 工具面 ctx.tools(cg / stg / mdcg_*)
117
+ └── session/event(自动记忆钩子 · 自动召回注入)
118
+ │ stdio · 逐行 JSON-RPC
119
+ ┌────────────────────▼─────────────────────┐
120
+ │ 灵枢大脑子进程(spawn · 唯一) │
121
+ │ python -m md_cg.mcp_server │
122
+ │ cg/stg 基元 + 31 细粒度 · md 认知图真源 │
123
+ └──────────────────────────────────────────┘
124
+ ```
125
+
126
+ **记忆只有一个真源**:`md_cg/` 认知图(纯 md 文档,随包自带);「身体」能力为可选后端,不再存记忆、默认不启动。其它 MCP 宿主同构:宿主工具面 ↔ stdio MCP ↔ `md_cg`,差异只在**纪律注入方式**。
127
+
128
+ ## 🧰 工具面
129
+
130
+ | 能力 | MCP 入口 |
131
+ |---|---|
132
+ | 写入 · 关系链接 · 结构关系 | `cg(op=write)` `cg(op=link)` `stg(op=relation)` |
133
+ | 检索 · 条件路由 · 因果链 · 时间线 | `mdcg_recall` `mdcg_search` `cg(op=route)` `stg(op=timeline)` |
134
+ | 裁决 · 遗忘 · 冲突检测 · 反思 · 身份 · 演化 | `cg(op=verify)` `cg(op=forget)` `cg(op=metacognition)` `cg(op=identity)` `cg(op=evolution)` |
135
+ | 重要性评分 · 预算装包 · 分层注入 · 记忆自净 · 自维持巡检 | `cg(op=session)` `cg(op=scrub)` `cg(op=consolidate)` `cg(op=maintain)` `cg(op=sustain)` |
136
+ | 会话隔离 · 时效过滤 · 审计留痕 · 可靠性闸 | `mdcg_remember(session=…)` `validity=true` `cg(op=audit)` `cg(op=ccg)` · [护栏宪章](docs/mdcg/guardrail-charter.md) · [CCG 编译](docs/mdcg/CCG六要素编译.md) |
137
+
138
+ **`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` 守漂移)。
139
+
140
+ ## 📚 文档地图
141
+
142
+ | 去哪里 | 看什么 |
143
+ |---|---|
144
+ | [docs/ 目录索引](docs/README.md) | 六域快速索引 · 新文档归域规则 |
145
+ | [安装与运维](docs/ops/README.md) | 安装前置 / 30+ 配置项 / 写入凭据 / 升级重启 / 排障 FAQ |
146
+ | [评测总览](docs/eval/评测总览.md) | 六家横评 / 弱证据与证据防火墙 / 中英双语差距 / 公开数据集 / 七维标尺 / 第三方验证 |
147
+ | [开发与编码约定](docs/dev/README.md) | 测试约定 / UTF-8 与 id 契约 / 开关矩阵 / Linux 双栈验证 |
148
+ | [多 harness 接入](docs/mdcg/多harness接入.md) | 五端纪律注入差异 / 出货面 vs 源码树分界 |
149
+ | [Releases](https://github.com/FuRongJun-1999/dsh-memory/releases) | 逐版本变更(本 README 不再维护发布日志)· [理论四篇](docs/theory/) |
150
+
151
+ ## 🔌 多 harness 接入(按端分目录)
152
+
153
+ > **主推路径:MCP 直挂**——各端共性都是挂载同一个 stdio MCP server(`python -m md_cg.mcp_server`),**不依赖任何插件系统**。
154
+
155
+ | 目录 | harness | 纪律注入方式 |
156
+ |---|---|---|
157
+ | [`dsh/`](dsh/README.md) | DeepSeek Harness | `~/.dsh/profiles/web/cordis.patch.yml` 的 `personaPrefix`(compact · 每轮) |
158
+ | [`codebuddy/`](codebuddy/README.md) | CodeBuddy | 项目根 `CODEBUDDY.md`(full · 会话起始) |
159
+ | [`zcode/`](zcode/README.md) | ZCode | 项目根 `AGENTS.md`(full · 会话起始) |
160
+ | [`codex/`](codex/README.md) | Codex CLI | 项目根 `AGENTS.md`(full · 会话起始) |
161
+ | [`claude/`](claude/README.md) | Claude Code | 项目根 `CLAUDE.md`(full · 会话起始) |
162
+
163
+ > 五端纪律**同源**(`docs/工作纪律_认知图条目_v1.1.json`),由 `scripts/render_discipline.py` 渲染、`scripts/verify_discipline.py` 守卫漂移。
164
+
165
+ ## 🤝 贡献与验证文化
166
+
167
+ **尤其鼓励「经过验证有效」的提交**:issue 请给出触发条件、最小复现与实测读数;PR 请附改动说明与验证方式(复跑命令与读数);结论均以**能被独立复跑**为准——[issue #1](https://github.com/FuRongJun-1999/lingshu/issues/1) 是一个好例子(触发链、最小复现、判据三样都齐)。缺少证据、无法复现的描述,我们会先回帖请求补充证据再处置。
168
+
169
+ - **PR 审核**:走「技术审(外部验证者)+ 理论核(本项目)」两道闸;缺少证据的提交会先回帖请求补充再处置
170
+ - **📣 蜂巢反馈邀请**:`hive/` 处于稳定阶段,但并发与崩溃恢复需真实负载打磨。**失败路径比「跑通了」更有价值**——请开 [Issue](https://github.com/FuRongJun-1999/dsh-memory/issues) 并附 `hive_doctor` 输出
171
+ - **安全缺陷**:含可直接利用细节的走私密通道,其余仍走公开 issue
172
+
173
+ ## 📏 工程纪律与设计者视角(可选复用)
174
+
175
+ > 灵枢自身按一套 **18 条工程纪律**运行(理论先行 / 全面处理 / 根因纪律 / 验证先行 / 双副本同步 / 兜底路径 / 任务派发统一走蜂巢 / 内容政策双清单 / 敏感信息隔离 / 记忆闭环)。它本是灵枢的「自我约束」,与你用不用灵枢无关;但若你希望自己的 Agent 也具备同样的工作方式,这套纪律**可以直接复用**——[纪律真源](docs/工作纪律_认知图条目_v1.1.json)(每条 ≡ 一个认知图节点,含触发词路由)· [设计者视角元技能](skills/skills/designer-perspective/)(动手前回答「该不该做 / 为什么做 / 条件够不够」)。部分条款针对灵枢私有管线,复用时建议只取方法论 / 执行 / 调度 / 合规 / 记忆闭环五组通用条款。
176
+
177
+ ## 护栏宪章 · 许可证
178
+
179
+ 本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/mdcg/guardrail-charter.md)** 约束——对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定,并保护人类使用者。
180
+
181
+ MIT © 荣(FuRongJun-1999)· 灵枢 LINGSHU 工程实现。DeepSeek Harness 为 DeepSeek 官方开源项目(MIT),本插件与之无隶属关系。
package/lib/hooks.d.ts CHANGED
@@ -77,6 +77,14 @@ export interface MemoryHooksOptions {
77
77
  autoRecall: boolean;
78
78
  /** 自动召回条数(默认 4)。 */
79
79
  autoRecallLimit: number;
80
+ /** 身份锚点独立注入块(issue #635,默认 false = 保持既有行为)。
81
+ *
82
+ * 背景:永久层(self/anchor)被 RECALL_SKIP_LAYERS 跳过,用户写完「我是谁」永远
83
+ * 不会被自动注入,只能去改 stg.py(升级即被整包抹掉)。
84
+ * 开启后:额外取若干条 self/anchor 节点,单独渲染成「【身份锚点】」块,
85
+ * **独立预算**(不占 recent 块),条数与字数都小(存在性提示,不承载知识)。
86
+ */
87
+ autoRecallIdentity?: boolean;
80
88
  /** 自动记忆脱敏:写入前过滤敏感信息(密钥/密码/令牌/身份证/手机号,默认 true)。 */
81
89
  desensitize: boolean;
82
90
  /** 落盘审计文件路径(issue #56,诊断面:哪些消息被设计滤除、source.kind 分布、
@@ -144,7 +152,14 @@ export declare function redactForLog(value: unknown): string;
144
152
  * 会让整块被最旧的一条挤掉。逐档递减后整块实测约 1133 字符(≈472 tok),
145
153
  * 9 条全部保留。(注意:整块仍远小于一条知识节点 500~800 tok,故本块定位是
146
154
  * 「存在性索引/提醒」,不承载知识本身——要知识请显式 mdcg_recall 并给足预算。) */
147
- export declare function formatTimelineDecayed(payload: unknown): string;
155
+ export declare function formatTimelineDecayed(payload: unknown, opts?: {
156
+ includeIdentity?: boolean;
157
+ }): string;
158
+ /** 身份锚点块(issue #635):只取永久层(self/anchor),独立预算。 */
159
+ export declare const IDENTITY_MAX_ITEMS = 3;
160
+ export declare const IDENTITY_MAX_CHARS = 640;
161
+ export declare const IDENTITY_ITEM_CHARS = 160;
162
+ export declare function renderIdentityAnchors(payload: unknown): string;
148
163
  /** 会话窗口载荷 → 注入文本(限幅沿 RECALL 分级渲染的风格:单条 ≤120 字、
149
164
  * 整块 ≤800 字)。
150
165
  *
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 剥离)。
@@ -709,7 +739,11 @@ export function installMemoryHooks(ctx, mdcg, opts) {
709
739
  if (sticky) {
710
740
  assembly.contexts.push({ name: 'lingshu:turn-reminder', text: sticky });
711
741
  }
712
- const text = formatTimelineDecayed(await graph.timeline(recallLimit, sid ? { session: sid } : {}));
742
+ // issue #635:身份锚点独立块(默认关)。开启时多取几条,按层分流:
743
+ // 非永久层 → 既有「最近记忆」块;self/anchor → 独立「身份锚点」块(独立预算)。
744
+ const identityOn = opts.autoRecallIdentity === true;
745
+ const timelinePayload = await graph.timeline(identityOn ? recallLimit + IDENTITY_MAX_ITEMS : recallLimit, sid ? { session: sid } : {});
746
+ const text = formatTimelineDecayed(timelinePayload);
713
747
  if (text) {
714
748
  // 注入边界转义(issue #16):宿主 system-prompt 对 context 文本做严格
715
749
  // `{{variable}}` 插值,裸 `{{` 会 throw → 该轮请求整体失败。记忆原文
@@ -741,6 +775,23 @@ export function installMemoryHooks(ctx, mdcg, opts) {
741
775
  });
742
776
  }
743
777
  }
778
+ if (identityOn) {
779
+ try {
780
+ const idText = renderIdentityAnchors(timelinePayload);
781
+ if (idText) {
782
+ assembly.contexts.push({
783
+ name: 'lingshu:identity-anchor',
784
+ text: escapePromptBraces(renderUntrustedMemoryBlock('【灵枢身份锚点】(self/anchor 层,独立预算)\n' + idText)),
785
+ });
786
+ }
787
+ }
788
+ catch (err) {
789
+ // issue #128 同款纪律:fail-soft 但不静默——空 catch 会被
790
+ // test/session-declaration-report ③ 判红,也会让「身份块从未注入成功」
791
+ // 与「确实没有身份节点」不可分辨。失败不越过会话流边界(不抛)。
792
+ ctx.logger.warn(`dsh-memory: 身份锚点注入失败(已跳过该块): ${redactForLog(err)}`);
793
+ }
794
+ }
744
795
  // ── 独立第二块:「【本会话近期对话】」(contextWindow 注入面)──
745
796
  // 与上方 timeline 块**块名/取数/开关各自独立**(既有块一字未动)。
746
797
  // 稳定性口径与既有块同等:**每步都 push**(内容随新轮增长属预期——
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` 覆盖;显式配置本项优先级最高。 */
package/lib/index.js CHANGED
@@ -87,6 +87,9 @@ function mcpText(r) {
87
87
  export const inject = ['tools'];
88
88
  export const Config = z.object({
89
89
  serverName: z.string().default('lingshu'),
90
+ /** issue #634:0.9.9 起工具名去前缀(lingshu_cg -> cg)。
91
+ * 缺省 true = 同时注册 lingshu_* 兼容别名;设 false 则只注册裸名。 */
92
+ toolAliases: z.boolean().default(true),
90
93
  // issue #19:默认值按平台解析(Windows: python / 其它: python3;env MDCG_PYTHON 可覆盖)。
91
94
  // 写死 'python' 时 Linux/macOS 首装即 spawn ENOENT(PEP 394 只有 python3),
92
95
  // 且表现为「装好了但记忆永远为空」——最难定位的失效形态。
@@ -106,6 +109,8 @@ export const Config = z.object({
106
109
  importance: z.number().default(0.6),
107
110
  autoRecall: z.boolean().default(true),
108
111
  autoRecallLimit: z.number().default(4),
112
+ /** issue #635:self/anchor 层单列「身份锚点」块(默认 false = 维持既有行为)。 */
113
+ autoRecallIdentity: z.boolean().default(false),
109
114
  desensitize: z.boolean().default(true),
110
115
  /** **短期会话窗口**(滑动窗口,2026-10-06)——「短期保留近 N 条对话记录」
111
116
  * 的机制实现(长期记忆仍走灵枢的显式调用)。
@@ -129,7 +134,7 @@ export const Config = z.object({
129
134
  })
130
135
  .default({ enabled: true, turns: 10 }),
131
136
  })
132
- .default({ userMessage: true, assistantMessage: false, toolResult: false, importance: 0.6, autoRecall: true, autoRecallLimit: 4, desensitize: true, contextWindow: { enabled: true, turns: 10 } }),
137
+ .default({ userMessage: true, assistantMessage: false, toolResult: false, importance: 0.6, autoRecall: true, autoRecallLimit: 4, autoRecallIdentity: false, desensitize: true, contextWindow: { enabled: true, turns: 10 } }),
133
138
  toolCallTimeoutMs: z.number().default(60_000),
134
139
  maxRetryDelayMs: z.number().default(30_000),
135
140
  failOnStartupError: z.boolean().default(false),
@@ -357,6 +362,9 @@ export async function apply(ctx, config) {
357
362
  // `cg` / `stg` / `mdcg_*`。此前按 `${config.serverName}_` 拼成 `cg`,造成「同一个
358
363
  // MCP 服务、不同端看到不同工具名」的初次识别错误。serverName 仍用于内部 provider/日志标识。
359
364
  toolPrefix: '',
365
+ // issue #634:默认补注册 lingshu_* 兼容别名(旧会话/旧脚本硬编码旧名时不至于 unknown tool)。
366
+ // 需要「只要裸名」的部署可设 tools.legacyAliases=false。
367
+ legacyAliases: config.toolAliases !== false,
360
368
  });
361
369
  disposers.push(dispose);
362
370
  toolsRegistered = true;
package/lib/tools.d.ts CHANGED
@@ -57,7 +57,15 @@ export declare function extractText(content: Array<{
57
57
  * import 本包」在模块求值前就失败。惰性导入后:不在 DSH 宿主内时包仍可加载,
58
58
  * 只有真正注册工具才报错,且错误消息点名缺哪个包。
59
59
  */
60
+ /** 工具对外名(issue #634):正式名 + 可选兼容别名。
61
+ *
62
+ * 0.9.9 起去掉了 `${serverName}_` 前缀(lingshu_cg -> cg),升级瞬间
63
+ * 已存在会话里的旧名调用全部变成 unknown tool。这里给出「一个工具要注册哪些名字」的
64
+ * 纯函数,注册面与测试共用,避免两处各写一份判据。
65
+ */
66
+ export declare function toolPublicNames(toolName: string, prefix: string, legacyAliases?: boolean): string[];
60
67
  export declare function registerLingshuTools(ctx: Context, bridge: LingshuBridge, opts: {
61
68
  selection: ToolSelection;
62
69
  toolPrefix: string;
70
+ legacyAliases?: boolean;
63
71
  }): Promise<() => void>;
package/lib/tools.js CHANGED
@@ -167,6 +167,18 @@ export function extractText(content) {
167
167
  * import 本包」在模块求值前就失败。惰性导入后:不在 DSH 宿主内时包仍可加载,
168
168
  * 只有真正注册工具才报错,且错误消息点名缺哪个包。
169
169
  */
170
+ /** 工具对外名(issue #634):正式名 + 可选兼容别名。
171
+ *
172
+ * 0.9.9 起去掉了 `${serverName}_` 前缀(lingshu_cg -> cg),升级瞬间
173
+ * 已存在会话里的旧名调用全部变成 unknown tool。这里给出「一个工具要注册哪些名字」的
174
+ * 纯函数,注册面与测试共用,避免两处各写一份判据。
175
+ */
176
+ export function toolPublicNames(toolName, prefix, legacyAliases = true) {
177
+ const primary = `${prefix}${toolName}`;
178
+ if (prefix || !legacyAliases || toolName.startsWith("lingshu_"))
179
+ return [primary];
180
+ return [primary, `lingshu_${toolName}`];
181
+ }
170
182
  export async function registerLingshuTools(ctx, bridge, opts) {
171
183
  let defineTool;
172
184
  try {
@@ -182,13 +194,22 @@ export async function registerLingshuTools(ctx, bridge, opts) {
182
194
  const disposers = [];
183
195
  const registered = [];
184
196
  try {
197
+ // issue #634(2026-10-22):0.9.9 起工具名去掉 serverName 前缀(lingshu_cg -> cg),
198
+ // 升级瞬间已存在的会话里旧名调用全变 unknown tool,宿主与插件都没有提示。
199
+ // 这里加兼容别名:裸名照常注册,同时补注册 lingshu_<name>(legacyAliases=false 可关)。
200
+ // 别名与正式名指向同一个 execute,语义不变;描述标注 deprecated 供模型与人识别。
185
201
  for (const tool of tools) {
186
202
  if (!wanted.has(tool.name))
187
203
  continue;
188
- const publicName = `${opts.toolPrefix}${tool.name}`;
189
- const definition = defineTool({
190
- name: publicName,
191
- description: tool.description || `灵枢 ${tool.name}`,
204
+ const names = toolPublicNames(tool.name, opts.toolPrefix, opts.legacyAliases !== false);
205
+ const publicName = names[0];
206
+ const aliasName = names[1] ?? "";
207
+ const makeDefinition = (registeredName, deprecated) => defineTool({
208
+ name: registeredName,
209
+ description: deprecated
210
+ ? '【已弃用别名】旧版工具名(升级兼容用),请改用 ' + publicName + '。原始描述:'
211
+ + (tool.description || '灵枢 ' + tool.name)
212
+ : (tool.description || '灵枢 ' + tool.name),
192
213
  parameters: schemaToParameters(tool.inputSchema),
193
214
  output: {
194
215
  schema: { type: 'json' },
@@ -233,8 +254,14 @@ export async function registerLingshuTools(ctx, bridge, opts) {
233
254
  return { content: result.content };
234
255
  },
235
256
  });
236
- disposers.push(ctx.tools.register(definition));
257
+ disposers.push(ctx.tools.register(makeDefinition(publicName, false)));
237
258
  registered.push(publicName);
259
+ if (aliasName) {
260
+ // 兼容别名:指向同一个 execute(makeDefinition 复用了同一份定义体),
261
+ // 标记 deprecated;下一轮 minor 再评估是否移除。
262
+ disposers.push(ctx.tools.register(makeDefinition(aliasName, true)));
263
+ registered.push(aliasName);
264
+ }
238
265
  }
239
266
  }
240
267
  catch (err) {