@furongjun1999/dsh-memory 0.9.7 → 0.9.8
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 +150 -662
- package/codebuddy/CODEBUDDY.md +333 -204
- package/docs/README.md +18 -0
- package/docs/discipline/harnesses.yaml +11 -3
- package/docs/discipline/templates/compact.txt.tmpl +20 -18
- package/docs/discipline/templates/full.md.tmpl +63 -61
- package/docs/discipline/templates/rules.mdc.tmpl +5 -3
- package/docs/discipline/templates/skill.md.tmpl +25 -23
- package/docs/discipline/templates/spec.txt.tmpl +1 -1
- package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
- package/lib/hooks.js +1 -1
- package/lib/index.js +9 -3
- package/lib/init.js +19 -4
- package/lib/lib/hook_audit.js +26 -0
- package/md_cg/sustain.py +10 -1
- package/md_cg/test_heartbeat_ledger.py +563 -557
- package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
- package/md_cg/test_read_scope_b27.py +2 -2
- package/md_cg/test_security_audit_v21.py +249 -249
- package/md_cg/test_sustain_bad_stamp.py +178 -0
- package/package.json +1 -1
- package/src/hooks.ts +932 -932
- package/src/index.ts +18 -12
- package/src/init.ts +16 -4
- package/src/lib/hook_audit.ts +302 -282
- package/zcode/AGENTS.md +333 -204
package/docs/README.md
CHANGED
|
@@ -6,6 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
docs/
|
|
9
|
+
├── ops/ 安装与运维(安装前置 / 写入凭据 / 升级重启 / FAQ)
|
|
10
|
+
├── dev/ 开发与编码约定(测试约定 / 编码契约 / 开关矩阵)
|
|
9
11
|
├── mdcg/ 灵枢大脑 md_cg 工程(架构/工具表/发布/教程/护栏)
|
|
10
12
|
├── swarm/ 蜂群运行时 swarm/
|
|
11
13
|
├── hive/ 蜂巢并发引擎 hive/
|
|
@@ -121,6 +123,22 @@ docs/
|
|
|
121
123
|
| [六家横评 100 题中英双查 v1.0](eval/横评_六家100题中英双查_v1.0.md) | 六家同口径对照 |
|
|
122
124
|
| [实验方案·学习闭环 AB 与横评 v1.0](eval/实验方案_学习闭环AB与横评_v1.0.md) | 实验设计 |
|
|
123
125
|
|
|
126
|
+
## ops/ · 安装与运维
|
|
127
|
+
|
|
128
|
+
| 文档 | 内容 |
|
|
129
|
+
|---|---|
|
|
130
|
+
| [ops/ 索引](ops/README.md) | 本域两篇的入口 |
|
|
131
|
+
| [安装与前置](ops/安装与前置.md) | 一键配置 / 手工三步 / 前置条件 / 已验证环境 / 装后验证 / 排障线索 |
|
|
132
|
+
| [运维与排障](ops/运维与排障.md) | 升级须重启常驻进程(代校验)/ 写入凭据与 committed 语义 / FAQ |
|
|
133
|
+
|
|
134
|
+
## dev/ · 开发与编码约定
|
|
135
|
+
|
|
136
|
+
| 文档 | 内容 |
|
|
137
|
+
|---|---|
|
|
138
|
+
| [dev/ 索引](dev/README.md) | 本域两篇的入口 |
|
|
139
|
+
| [编码与测试约定](dev/编码与测试约定.md) | 构建 / Python 测试必须 -m / 全 UTF-8 与入口自保证 / id 契约 v2 / Linux 双栈验证 |
|
|
140
|
+
| [开关矩阵](dev/开关矩阵.md) | 检索与归一 env 开关、默认值与裁定沿革 |
|
|
141
|
+
|
|
124
142
|
## plans/ · 项目计划 / 交接 / 规格
|
|
125
143
|
|
|
126
144
|
| 文档 | 内容 |
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
# memory: 该端 Agent 访问灵枢记忆的通路;仅声明事实,不参与渲染与校验。三种形态:
|
|
14
14
|
# ① MCP 客户端配置 —— 写客户端配置里的 server 名(如 mcp/mdcg);
|
|
15
15
|
# ② 宿主内建桥 —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程,
|
|
16
|
-
# 再注册为宿主工具(DSH 侧 =
|
|
16
|
+
# 再注册为宿主工具(DSH 侧 = cg / stg)。
|
|
17
17
|
# ③ 蜂巢并发通路 —— hive = 另一个 MCP server(python -m hive.hive_mcp.mcp_server,
|
|
18
18
|
# 四工具 hive_spawn / hive_poll / hive_kill / hive_doctor),
|
|
19
19
|
# 提供多智能体并发 + 任务上下文管理(context_files 注入、预算交回、
|
|
@@ -73,7 +73,7 @@ targets:
|
|
|
73
73
|
variant: spec
|
|
74
74
|
format: text
|
|
75
75
|
marker: lingshu:discipline
|
|
76
|
-
memory: plugin/
|
|
76
|
+
memory: plugin/cg+stg (插件内建桥,spawn md_cg.mcp_server;tools=core)
|
|
77
77
|
# hive:本端未经 MCP 面接入——插件是内建桥形态(TS 侧 spawn + 工具注册),接蜂巢须在
|
|
78
78
|
# src/lib/ 新增 hive 客户端与四工具暴露,非「写一条配置」可解。当前兜底=CLI
|
|
79
79
|
# (hive.exe submit --spec <spec.json>)。详见 hive/README.md「各 harness 注册」。
|
|
@@ -84,7 +84,7 @@ targets:
|
|
|
84
84
|
# 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%(模板保持通用,差异留在矩阵)
|
|
85
85
|
preamble: |-
|
|
86
86
|
【本端(DSH)与其它端的差异】
|
|
87
|
-
- 记忆通路:插件内建
|
|
87
|
+
- 记忆通路:插件内建 cg / stg 两个基元(与 MCP 服务同名,无前缀)(tools = core),即正文纪律中的 cg / stg——同一服务,勿因名字不同而猜测;其余能力经 cg(op=…) / stg(op=…) 分发,op 为必填参数(漏传会被参数签名推导兜底并标记 op_derived)。
|
|
88
88
|
- 注入时机:本段在系统提示 order=0(DEPLOYMENT_PERSONA_PREFIX),每轮都在;codebuddy / zcode 端是会话起始一次性注入全文。
|
|
89
89
|
- 自动记忆:本端有 session hook,默认自动转录用户消息(assistant / tool 默认关)。
|
|
90
90
|
故第 16 条在本端只补核心结论(内容/原因/位置/验证结论),不复述对话流水——否则与自动转录重复、稀释检索。
|
|
@@ -105,6 +105,7 @@ targets:
|
|
|
105
105
|
slot: codebuddy-session
|
|
106
106
|
path: codebuddy/CODEBUDDY.md
|
|
107
107
|
variant: full
|
|
108
|
+
uses_spec: true
|
|
108
109
|
format: markdown
|
|
109
110
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
110
111
|
note: >-
|
|
@@ -123,6 +124,7 @@ targets:
|
|
|
123
124
|
slot: codebuddy-rules
|
|
124
125
|
path: .codebuddy/rules/lingshu-discipline/RULE.mdc
|
|
125
126
|
variant: rules-mdc
|
|
127
|
+
uses_spec: true
|
|
126
128
|
format: markdown
|
|
127
129
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/restart/doctor)
|
|
128
130
|
note: >-
|
|
@@ -135,6 +137,7 @@ targets:
|
|
|
135
137
|
slot: zcode-session
|
|
136
138
|
path: zcode/AGENTS.md
|
|
137
139
|
variant: full
|
|
140
|
+
uses_spec: true
|
|
138
141
|
format: markdown
|
|
139
142
|
preserve: true
|
|
140
143
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
@@ -160,6 +163,7 @@ targets:
|
|
|
160
163
|
enabled: true
|
|
161
164
|
render: true
|
|
162
165
|
variant: zcode-user
|
|
166
|
+
uses_spec: true
|
|
163
167
|
pointer: true
|
|
164
168
|
# 指针须指向的纪律本体(相对仓库根)——判据侧按此值查「指向面」,故路径只有这一处声明
|
|
165
169
|
pointer_body: zcode/AGENTS.md
|
|
@@ -182,6 +186,7 @@ targets:
|
|
|
182
186
|
slot: codex-session
|
|
183
187
|
path: codex/AGENTS.md
|
|
184
188
|
variant: full
|
|
189
|
+
uses_spec: true
|
|
185
190
|
format: markdown
|
|
186
191
|
preserve: true
|
|
187
192
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
@@ -196,6 +201,7 @@ targets:
|
|
|
196
201
|
slot: claude-session
|
|
197
202
|
path: claude/CLAUDE.md
|
|
198
203
|
variant: full
|
|
204
|
+
uses_spec: true
|
|
199
205
|
format: markdown
|
|
200
206
|
preserve: true
|
|
201
207
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
@@ -218,6 +224,7 @@ targets:
|
|
|
218
224
|
slot: plugin-skill
|
|
219
225
|
path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
|
|
220
226
|
variant: skill
|
|
227
|
+
uses_spec: true
|
|
221
228
|
format: markdown
|
|
222
229
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
223
230
|
note: >-
|
|
@@ -240,6 +247,7 @@ targets:
|
|
|
240
247
|
slot: plugin-skill
|
|
241
248
|
path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
|
|
242
249
|
variant: skill
|
|
250
|
+
uses_spec: true
|
|
243
251
|
format: markdown
|
|
244
252
|
memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
|
|
245
253
|
note: >-
|
|
@@ -1,18 +1,20 @@
|
|
|
1
|
-
你是 DSH 端的灵枢代理(harness = dsh)。以下工作纪律与 codebuddy / zcode 端同源,
|
|
2
|
-
真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
|
|
3
|
-
命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
|
|
4
|
-
|
|
5
|
-
【执行公约】
|
|
6
|
-
0.1 会话起始先查记忆:动手前先调认知图入口(DSH 端工具名=
|
|
7
|
-
0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
|
|
8
|
-
0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
|
|
9
|
-
0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
|
|
10
|
-
0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
|
|
11
|
-
|
|
12
|
-
%%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
|
|
13
|
-
%%
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
-
|
|
1
|
+
你是 DSH 端的灵枢代理(harness = dsh)。以下工作纪律与 codebuddy / zcode 端同源,
|
|
2
|
+
真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
|
|
3
|
+
命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
|
|
4
|
+
|
|
5
|
+
【执行公约】
|
|
6
|
+
0.1 会话起始先查记忆:动手前先调认知图入口(DSH 端工具名=cg、MCP 端=cg;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
|
|
7
|
+
0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
|
|
8
|
+
0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
|
|
9
|
+
0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
|
|
10
|
+
0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
|
|
11
|
+
|
|
12
|
+
%%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
|
|
13
|
+
%%SPEC_FULL%%
|
|
14
|
+
|
|
15
|
+
%%ROUTING_APPENDIX%%
|
|
16
|
+
|
|
17
|
+
【使用须知】
|
|
18
|
+
- 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
|
|
19
|
+
- 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
|
|
20
|
+
- 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后跑 scripts/render_discipline.py --target dsh --write。
|
|
@@ -1,61 +1,63 @@
|
|
|
1
|
-
# 工作纪律(%%VERSION%%)· %%COUNT%% 条
|
|
2
|
-
|
|
3
|
-
> 本文件由 `scripts/render_discipline.py` 从真源
|
|
4
|
-
> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成,**请勿手改**;改真源后重跑渲染。
|
|
5
|
-
> 真源指纹(SHA256 前16位):%%SOURCE_SHA%%
|
|
6
|
-
|
|
7
|
-
## 概述
|
|
8
|
-
|
|
9
|
-
%%OVERVIEW%%
|
|
10
|
-
|
|
11
|
-
## 执行公约
|
|
12
|
-
|
|
13
|
-
| 约定 | 内容 |
|
|
14
|
-
|---|---|
|
|
15
|
-
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `
|
|
16
|
-
| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
|
|
17
|
-
| **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
|
|
18
|
-
| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
|
|
19
|
-
| **0.5 例外不外溢** | 某条的「不适用」只豁免该条,不豁免其它条。 |
|
|
20
|
-
|
|
21
|
-
## 纪律路由表
|
|
22
|
-
|
|
23
|
-
%%
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
37
|
-
| `
|
|
38
|
-
| `
|
|
39
|
-
| `
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
42
|
-
| `
|
|
43
|
-
| `
|
|
44
|
-
| `
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
-
|
|
1
|
+
# 工作纪律(%%VERSION%%)· %%COUNT%% 条
|
|
2
|
+
|
|
3
|
+
> 本文件由 `scripts/render_discipline.py` 从真源
|
|
4
|
+
> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成,**请勿手改**;改真源后重跑渲染。
|
|
5
|
+
> 真源指纹(SHA256 前16位):%%SOURCE_SHA%%
|
|
6
|
+
|
|
7
|
+
## 概述
|
|
8
|
+
|
|
9
|
+
%%OVERVIEW%%
|
|
10
|
+
|
|
11
|
+
## 执行公约
|
|
12
|
+
|
|
13
|
+
| 约定 | 内容 |
|
|
14
|
+
|---|---|
|
|
15
|
+
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
|
|
16
|
+
| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
|
|
17
|
+
| **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
|
|
18
|
+
| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
|
|
19
|
+
| **0.5 例外不外溢** | 某条的「不适用」只豁免该条,不豁免其它条。 |
|
|
20
|
+
|
|
21
|
+
## 纪律路由表
|
|
22
|
+
|
|
23
|
+
%%SPEC_FULL%%
|
|
24
|
+
|
|
25
|
+
%%ROUTING_APPENDIX%%
|
|
26
|
+
|
|
27
|
+
## 声明出口(`response.direct` 原文 · 未输出即未执行)
|
|
28
|
+
|
|
29
|
+
%%DECLARATION_TABLE%%
|
|
30
|
+
|
|
31
|
+
## 记忆接口速查(`cg` / `stg`)
|
|
32
|
+
|
|
33
|
+
工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `cg` / `stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
|
|
34
|
+
|
|
35
|
+
| op | 用途 | 常用参数 |
|
|
36
|
+
|---|---|---|
|
|
37
|
+
| `route` | 任务开始路由记忆(返回知识 + 建议能力,不执行) | `intent`(任务意图) |
|
|
38
|
+
| `read` | 召回/检索/按 id 取(`session`=只取该会话归属的记忆,缺省不过滤;`validity=true`=时效过滤(显式启用,缺省不过滤),**仅排除「已过期」,「未生效」一律保留**——两者语义相反) | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` / `validity` |
|
|
39
|
+
| `edges` | 三元组反查(**只读**):按派生边任意端/谓词/时间反查「这条记忆从哪来 / 谁由它派生」(subject/predicate/object 即 child/relation/parent);`expand_nodes=true` 附命中端点节点卡 | `child` / `parent` / `relation` / `batch` / `start_time` / `end_time` / `time_axis` / `ordering` / `offset` / `limit` / `aggregation` / `expand_nodes` |
|
|
40
|
+
| `write` | 写入(先按 content_kind 审核 + 冲突检测,ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆)。**自动归属**:frontmatter 带 `writer`/`session`/`harness`(服务端身份,不可伪造) | `content` / `content_kind`(text/code/…)/ `node_id`(同 id 即改写)/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`(reject\|defer\|record) |
|
|
41
|
+
| `verify` | 对节点做证据验证(confirmed/weakened/falsified)——**非队列裁决** | `node_id` / `verdict` / `evidence` |
|
|
42
|
+
| `review` | 审核队列:`action=list/rounds/records/stats` 查看;传 `pid`+`decision`+`reason` 即裁决落盘(accept/reject/edit/merge/noop,**需 can_admin**;`noop`=已评估且判定不改动任何现有记忆,只留痕不入库、不进负记忆;本机未配置外部验证器时写入恒 DEFER 入队,靠此裁决落盘) | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
|
|
43
|
+
| `task` | 结构层任务实体(工程台账,跨会话/上下文压缩后不遗忘):`name` 即身份(同名即同任务,slug 归一),`action` = open/status/plan_add/get/list/find/session(缺省 list);**迁 `done` 必须同时给 `result`**(缺一不收,拒收不落盘);未提供的字段沿用旧值(结果不会被静默清空) | `name` / `action` / `plan`(分步计划,每轮覆盖) / `change`(计划变更,逐轮追加) / `result` / `task_status`(active\|blocked\|done\|dropped) / `goal` / `acceptance` / `boundary` / `condition` / `node_id` |
|
|
44
|
+
| `recent` | 近期事件窗口 | `action`(add/list/clear)/ `limit` |
|
|
45
|
+
| `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
|
|
46
|
+
| `help` | 取回工具面上**被投影外置**的完整 op / 参数文档(工具面渐进披露:常驻提示只留一行职责,参数语义按需取;不带 `query` 则列出全部工具) | `query`(工具名或 op 名,如 `cg` / `write`)/ `limit` |
|
|
47
|
+
|
|
48
|
+
三条调用铁律:
|
|
49
|
+
1. **`op` 必填**——漏传会触发参数签名推导兜底(返回标记 `op_derived: true`),复杂任务中也必须显式传,防静默执行错误意图。
|
|
50
|
+
2. **返回 `moved_to: "review_queue"` / `verdict: DEFER` 时不要重试**——这是校验闸门的正常行为(返回自带 `hint` 说明下一步);落盘须经裁决(`op=review` 的 `decision=accept/reject/edit/merge/noop`,本机工具:`python scripts/review_cli.py list`)。**裁决权(2026-09-28 使用者裁定)**:写入者不得自裁——不得自己写、自己判、无复核一路到底;**经蜂群或验证端复核后,agent 可自行执行裁决**,不必每次转告使用者。**三类例外不适用该授权,必须转交使用者并止步**:①不适用于智能论这类重要协议真源的修改;②不适用于向外部发送信息和数据;③不适用于可能造成信息泄露/病毒/恶意操纵的动作。**`verdict: REJECT` 分两类,处置相反**:① 命中禁止规则(内容政策违规)→ 内容本身不该入库,重试同样结果;② 缺必需要素(`text` 类缺 CCG 六要素)→ **可修正**,按 `verdict.evidence` / `verdict.detail.missing` 给出的**完整缺失清单**补齐六要素后**重写**即落盘(本条未入库、已记入负记忆)——不要把它当「闸门故障」或「重试无用」。
|
|
51
|
+
3. `stg` 同理经 `op` 分发(`timeline` / `relation` / `anchors` 等)。
|
|
52
|
+
|
|
53
|
+
## 收尾强制流程(任务完成时不可跳过)
|
|
54
|
+
|
|
55
|
+
1. **验证**(第 5 条):未验证不固化——回放/断言/回归通过才收尾。
|
|
56
|
+
2. **归档**(第 16 条):提炼关键修改(内容/原因/位置/验证结论四要素,禁写中间过程)→ 写入灵枢记忆。
|
|
57
|
+
3. **自检**(第 4 条):本次是否有违规?有 → 按条件层归因,并补不适用条件。
|
|
58
|
+
|
|
59
|
+
## 本文件维护(防漂移)
|
|
60
|
+
|
|
61
|
+
- 真源唯一:`docs/工作纪律_认知图条目_v1.1.json`。
|
|
62
|
+
- 本文件是**渲染产物**,不是手抄投影;任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
|
|
63
|
+
- 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。
|
|
@@ -19,7 +19,7 @@ provider:
|
|
|
19
19
|
|
|
20
20
|
| 约定 | 内容 |
|
|
21
21
|
|---|---|
|
|
22
|
-
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `
|
|
22
|
+
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
|
|
23
23
|
| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
|
|
24
24
|
| **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
|
|
25
25
|
| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
|
|
@@ -27,7 +27,9 @@ provider:
|
|
|
27
27
|
|
|
28
28
|
## 纪律路由表
|
|
29
29
|
|
|
30
|
-
%%
|
|
30
|
+
%%SPEC_FULL%%
|
|
31
|
+
|
|
32
|
+
%%ROUTING_APPENDIX%%
|
|
31
33
|
|
|
32
34
|
## 声明出口(`response.direct` 原文 · 未输出即未执行)
|
|
33
35
|
|
|
@@ -35,7 +37,7 @@ provider:
|
|
|
35
37
|
|
|
36
38
|
## 记忆接口速查(`cg` / `stg`)
|
|
37
39
|
|
|
38
|
-
工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `
|
|
40
|
+
工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `cg` / `stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
|
|
39
41
|
|
|
40
42
|
| op | 用途 | 常用参数 |
|
|
41
43
|
|---|---|---|
|
|
@@ -1,23 +1,25 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: linglu-discipline
|
|
3
|
-
description: 灵枢工作纪律与记忆操作规程。会话开始或任何任务动手前使用;命中「查记忆 / 写记忆 / 命令执行 / 入库提交 / 根因分析 / 敏感信息 / 公开产物」等触发词时必须先加载本 skill。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
你是挂载了灵枢(Lingshu)长期记忆的 Agent。以下工作纪律与 DSH / CodeBuddy / ZCode / Codex / Claude Code 各端同源,
|
|
7
|
-
真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
|
|
8
|
-
命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
|
|
9
|
-
|
|
10
|
-
【执行公约】
|
|
11
|
-
0.1 会话起始先查记忆:动手前先调认知图入口(MCP server「mdcg」的 cg 工具;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
|
|
12
|
-
0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
|
|
13
|
-
0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
|
|
14
|
-
0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
|
|
15
|
-
0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
|
|
16
|
-
|
|
17
|
-
%%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
|
|
18
|
-
%%
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
-
|
|
1
|
+
---
|
|
2
|
+
name: linglu-discipline
|
|
3
|
+
description: 灵枢工作纪律与记忆操作规程。会话开始或任何任务动手前使用;命中「查记忆 / 写记忆 / 命令执行 / 入库提交 / 根因分析 / 敏感信息 / 公开产物」等触发词时必须先加载本 skill。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
你是挂载了灵枢(Lingshu)长期记忆的 Agent。以下工作纪律与 DSH / CodeBuddy / ZCode / Codex / Claude Code 各端同源,
|
|
7
|
+
真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
|
|
8
|
+
命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
|
|
9
|
+
|
|
10
|
+
【执行公约】
|
|
11
|
+
0.1 会话起始先查记忆:动手前先调认知图入口(MCP server「mdcg」的 cg 工具;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
|
|
12
|
+
0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
|
|
13
|
+
0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
|
|
14
|
+
0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
|
|
15
|
+
0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
|
|
16
|
+
|
|
17
|
+
%%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
|
|
18
|
+
%%SPEC_FULL%%
|
|
19
|
+
|
|
20
|
+
%%ROUTING_APPENDIX%%
|
|
21
|
+
|
|
22
|
+
【使用须知】
|
|
23
|
+
- 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
|
|
24
|
+
- 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
|
|
25
|
+
- 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后重跑 scripts/render_discipline.py。
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
|
|
35
35
|
| 约定 | 内容 |
|
|
36
36
|
|---|---|
|
|
37
|
-
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `
|
|
37
|
+
| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
|
|
38
38
|
| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
|
|
39
39
|
| **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
|
|
40
40
|
| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
|
package/lib/hooks.js
CHANGED
|
@@ -337,7 +337,7 @@ const RECALL_DECAY_RATIO = 0.9;
|
|
|
337
337
|
const RECALL_MIN_CHARS = 24;
|
|
338
338
|
/** 整块上限(与调用点 slice 对齐)。 */
|
|
339
339
|
const RECALL_MAX_CHARS = 1400;
|
|
340
|
-
/** 永久层不自动注入(按需用 mdcg_recall /
|
|
340
|
+
/** 永久层不自动注入(按需用 mdcg_recall / stg 取)。 */
|
|
341
341
|
const RECALL_SKIP_LAYERS = new Set(['anchor', 'self']);
|
|
342
342
|
/** 分级递减渲染:按距当前的次序逐档收窄,早期条目信息量更大。
|
|
343
343
|
*
|
package/lib/index.js
CHANGED
|
@@ -463,11 +463,17 @@ export async function apply(ctx, config) {
|
|
|
463
463
|
// 含子串「同意」,颠倒顺序会把不同意误判为同意(P1 修复,勿回退)。
|
|
464
464
|
// #563③:先查「带否定的同意」(无法同意/不能同意/难以同意/不太同意…)——
|
|
465
465
|
// 这些串里含子串「同意」,只看『不同意』会把否定压成肯定(实测可致 pass)。
|
|
466
|
-
|
|
467
|
-
|
|
466
|
+
// #563③补:白名单枚举不全——「不予同意」「没法同意」均不在原表,且都含子串「同意」
|
|
467
|
+
// ⇒ 否定被压成肯定(实测可致 pass)。改为「否定前缀 + 同意类动词」的组合判据,
|
|
468
|
+
// 覆盖 不/没/未/无法/难以/未能/别/勿/甭 与 同意/认同/赞同/赞成 的笛卡尔积。
|
|
469
|
+
const NEG_AGREE_RE = /(?:不|没|未|无法|难以|未能|别|勿|甭)\s*(?:太|予|能|会|想|可|曾|有|要|够|法)?\s*(?:同意|认同|赞同|赞成)/;
|
|
470
|
+
const NEG_PHRASES = ['不同意', '不赞同', '不通过', '反对', '拒绝'];
|
|
471
|
+
// 肯定判据同步扩到 认同/赞同/赞成——原先只认「同意」子串,「赞同」会被落到 else 判成不同意。
|
|
472
|
+
const POS_AGREE_RE = /同意|认同|赞同|赞成/;
|
|
473
|
+
const conclusion = (NEG_AGREE_RE.test(text) || NEG_PHRASES.some((k) => text.includes(k)))
|
|
468
474
|
? '不同意'
|
|
469
475
|
: text.includes('质疑') ? '质疑'
|
|
470
|
-
:
|
|
476
|
+
: POS_AGREE_RE.test(text) ? '同意' : '不同意';
|
|
471
477
|
return { conclusion, reason: text.slice(0, 120) };
|
|
472
478
|
},
|
|
473
479
|
});
|
package/lib/init.js
CHANGED
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
* 零运行时依赖:只用 Node 内置模块(node:readline/promises / node:fs /
|
|
26
26
|
* node:path)——与全仓「CLI 不加第三方依赖」纪律一致。
|
|
27
27
|
*/
|
|
28
|
-
import { writeFileSync } from 'node:fs';
|
|
28
|
+
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
|
29
29
|
import { homedir } from 'node:os';
|
|
30
30
|
import { createInterface } from 'node:readline/promises';
|
|
31
31
|
import { join, resolve } from 'node:path';
|
|
@@ -241,7 +241,22 @@ export async function runInit(argv, opts = {}) {
|
|
|
241
241
|
const snippet = buildSnippet(endSpec, rootAbs, pythonName);
|
|
242
242
|
const snippetJson = `${JSON.stringify(snippet, null, 2)}\n`;
|
|
243
243
|
const snippetPath = join(cwd, SNIPPET_FILENAME);
|
|
244
|
-
|
|
244
|
+
// 覆盖前先判断:用户可能已在本目录手写过同名文件(甚至已把真实 MDCG_TOKEN 填进去)。
|
|
245
|
+
// 无条件 writeFileSync 会把它们连同令牌一起冲掉,而 init 的文案只承诺「重跑输出一致」。
|
|
246
|
+
// 已有且内容不同时:不覆盖,改写旁路文件名,并在输出里说明——宁可多一个文件,不可丢数据。
|
|
247
|
+
let writtenPath = snippetPath;
|
|
248
|
+
if (existsSync(snippetPath)) {
|
|
249
|
+
let prev = '';
|
|
250
|
+
try {
|
|
251
|
+
prev = readFileSync(snippetPath, 'utf8');
|
|
252
|
+
}
|
|
253
|
+
catch { /* 读不出当作不同,走旁路 */ }
|
|
254
|
+
if (prev !== snippetJson) {
|
|
255
|
+
const alt = join(cwd, SNIPPET_FILENAME.replace(/\.json$/, `-new-${Date.now()}.json`));
|
|
256
|
+
writtenPath = alt;
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
writeFileSync(writtenPath, snippetJson, 'utf8');
|
|
245
260
|
say();
|
|
246
261
|
say(`灵枢(Lingshu)一键配置 · 端=${endSpec.label}`);
|
|
247
262
|
say(` 记忆根目录 MDCG_ROOT:${rootAbs}`);
|
|
@@ -255,7 +270,7 @@ export async function runInit(argv, opts = {}) {
|
|
|
255
270
|
for (const line of tokenCommand(pythonName, endSpec.tokenActor, ''))
|
|
256
271
|
say(line);
|
|
257
272
|
say();
|
|
258
|
-
say(`片段已写入:${
|
|
273
|
+
say(`片段已写入:${writtenPath}(mcpServers 键直接复制即可)`);
|
|
259
274
|
say('提示:PYTHONPATH 当前指向本命令所在包——若是 npx 临时包,建议换成 git clone 的常驻仓库绝对路径(免疫 npx 缓存清理)。');
|
|
260
275
|
say('init 只生成配置:未创建目录、未启动服务、未写库;重跑输出一致。');
|
|
261
276
|
return {
|
|
@@ -263,7 +278,7 @@ export async function runInit(argv, opts = {}) {
|
|
|
263
278
|
endLabel: endSpec.label,
|
|
264
279
|
root: rootAbs,
|
|
265
280
|
python: pythonName,
|
|
266
|
-
snippetPath,
|
|
281
|
+
snippetPath: writtenPath,
|
|
267
282
|
snippet,
|
|
268
283
|
output: collected,
|
|
269
284
|
snippetFile: snippetJson,
|
package/lib/lib/hook_audit.js
CHANGED
|
@@ -138,6 +138,8 @@ export class HookAuditRecorder {
|
|
|
138
138
|
path;
|
|
139
139
|
/** 进程内状态缓存(首次记录时从盘面载入,此后只增量改内存 + 全量重写)。 */
|
|
140
140
|
#state = null;
|
|
141
|
+
/** 本进程持有的锁 token;null 表示当前未持锁。 */
|
|
142
|
+
#lockToken = null;
|
|
141
143
|
constructor(path) {
|
|
142
144
|
this.path = typeof path === 'string' && path.trim() ? path.trim() : DEFAULT_HOOK_AUDIT_PATH;
|
|
143
145
|
}
|
|
@@ -202,10 +204,26 @@ export class HookAuditRecorder {
|
|
|
202
204
|
/** 跨进程排他锁:独占创建 `${path}.lock`;陈旧锁(>5s)清掉;超时返回 false(静默降级)。 */
|
|
203
205
|
#acquireLock(timeoutMs = 800) {
|
|
204
206
|
const lock = `${this.path}.lock`;
|
|
207
|
+
const token = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
|
|
205
208
|
const t0 = Date.now();
|
|
206
209
|
for (;;) {
|
|
207
210
|
try {
|
|
208
211
|
closeSync(openSync(lock, 'wx'));
|
|
212
|
+
// #563④补(ABA):把归属 token 写进锁文件,释放时据此判断锁是否仍是自己的。
|
|
213
|
+
// 不加 token 时:A 的锁被 B 判陈旧清掉 → B 建新锁 → A 在 finally 无条件 unlink,
|
|
214
|
+
// 把 B 的锁删掉,互斥窗口重新打开(回到本函数要修的丢计数问题)。
|
|
215
|
+
try {
|
|
216
|
+
writeFileSync(lock, token);
|
|
217
|
+
}
|
|
218
|
+
catch {
|
|
219
|
+
// 写不进归属 token ⇒ 不持有无法验证归属的锁,立即归还(否则 releaseLock 比对失败会漏删)
|
|
220
|
+
try {
|
|
221
|
+
unlinkSync(lock);
|
|
222
|
+
}
|
|
223
|
+
catch { /* 已被他人清理 */ }
|
|
224
|
+
return false;
|
|
225
|
+
}
|
|
226
|
+
this.#lockToken = token;
|
|
209
227
|
return true;
|
|
210
228
|
}
|
|
211
229
|
catch {
|
|
@@ -222,7 +240,15 @@ export class HookAuditRecorder {
|
|
|
222
240
|
}
|
|
223
241
|
}
|
|
224
242
|
#releaseLock() {
|
|
243
|
+
// #563④补(ABA):只删自己的锁。锁可能已被他人判陈旧清掉并重建——
|
|
244
|
+
// 无条件 unlink 会删掉别人的锁,互斥窗口重新打开。
|
|
245
|
+
const token = this.#lockToken;
|
|
246
|
+
this.#lockToken = null;
|
|
247
|
+
if (!token)
|
|
248
|
+
return;
|
|
225
249
|
try {
|
|
250
|
+
if (readFileSync(`${this.path}.lock`, 'utf8') !== token)
|
|
251
|
+
return;
|
|
226
252
|
unlinkSync(`${this.path}.lock`);
|
|
227
253
|
}
|
|
228
254
|
catch { /* 已清理 */ }
|
package/md_cg/sustain.py
CHANGED
|
@@ -192,7 +192,16 @@ def read_stamp(name: str, d: str = None):
|
|
|
192
192
|
return None
|
|
193
193
|
if not isinstance(rec, dict):
|
|
194
194
|
return None
|
|
195
|
-
|
|
195
|
+
# 契约(本函数文档串「不存在 / 损坏 → None」):`ts` 非数值也算损坏。
|
|
196
|
+
# 修前 `float(rec.get("ts") or 0)` 只挡了假值(None/0/""),`ts="abc"` 这类
|
|
197
|
+
# **合法 JSON 里的非法值**会抛 ValueError 穿出本函数;而 peers() 在循环里
|
|
198
|
+
# 直接调本函数、无 try —— 一个坏戳会让**整个 peers() 失败**,同目录下所有
|
|
199
|
+
# 健康节点的状态一并丢失(实测:4 戳含 1 坏 → peers() 抛错;删坏戳 → 恢复 3 条)。
|
|
200
|
+
try:
|
|
201
|
+
ts = float(rec.get("ts") or 0)
|
|
202
|
+
except (TypeError, ValueError):
|
|
203
|
+
return None
|
|
204
|
+
rec["age"] = max(0.0, time.time() - ts)
|
|
196
205
|
return rec
|
|
197
206
|
|
|
198
207
|
|