@furongjun1999/dsh-memory 0.9.23 → 0.10.3

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 (118) hide show
  1. package/CHANGELOG.en.md +515 -404
  2. package/CHANGELOG.md +642 -449
  3. package/README.en.md +244 -240
  4. package/README.md +272 -262
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/discipline/templates/full.md.tmpl +1 -1
  7. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  8. package/docs/en/mdcg/world-model-endpoint.md +1 -1
  9. package/docs/mdcg/cogmap_ops.md +19 -16
  10. package/lib/client.js +29 -3
  11. package/lib/hooks.d.ts +12 -0
  12. package/lib/hooks.js +43 -1
  13. package/lib/tools.d.ts +2 -2
  14. package/md_cg/bucketindex.py +231 -0
  15. package/md_cg/bucketscope.py +357 -0
  16. package/md_cg/cohesion.py +337 -0
  17. package/md_cg/config_registry_bulk.py +24 -10
  18. package/md_cg/config_validate.py +14 -2
  19. package/md_cg/constraint_audit.py +231 -0
  20. package/md_cg/constraint_watch.py +206 -0
  21. package/md_cg/context_audit.py +240 -0
  22. package/md_cg/context_plan.py +142 -0
  23. package/md_cg/detrerank.py +137 -0
  24. package/md_cg/distill.py +247 -0
  25. package/md_cg/dossier.py +151 -0
  26. package/md_cg/entities.py +133 -0
  27. package/md_cg/fsutil.py +135 -0
  28. package/md_cg/govern/__init__.py +23 -0
  29. package/md_cg/iface/__init__.py +46 -0
  30. package/md_cg/iface/_verify.py +609 -0
  31. package/md_cg/iface/contracts.py +337 -0
  32. package/md_cg/judgment_manifest.py +14 -0
  33. package/md_cg/kernel/__init__.py +27 -0
  34. package/md_cg/mcp_server.py +6044 -5761
  35. package/md_cg/mdcg.py +501 -16
  36. package/md_cg/mdcos.py +546 -12
  37. package/md_cg/metacognition.py +66 -13
  38. package/md_cg/mutate_extract_shipped.py +126 -0
  39. package/md_cg/mutate_ledger_e2e.py +100 -0
  40. package/md_cg/op_table.py +22 -0
  41. package/md_cg/probe_c_ledger_integrity.py +258 -0
  42. package/md_cg/probe_d_retirement_discipline.py +263 -0
  43. package/md_cg/profiles.py +298 -0
  44. package/md_cg/protocol.py +7 -1
  45. package/md_cg/reldate.py +142 -0
  46. package/md_cg/review_cli.py +6 -1
  47. package/md_cg/run_tests.py +30 -1
  48. package/md_cg/scopeselect.py +214 -0
  49. package/md_cg/scrub.py +66 -9
  50. package/md_cg/selfstmt.py +139 -0
  51. package/md_cg/state_extract.py +149 -0
  52. package/md_cg/state_slots.py +62 -10
  53. package/md_cg/state_view.py +181 -0
  54. package/md_cg/structboost.py +179 -0
  55. package/md_cg/sustain.py +28 -2
  56. package/md_cg/test_alternatives_historical.py +165 -0
  57. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  58. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  59. package/md_cg/test_bucket_cards.py +85 -0
  60. package/md_cg/test_bucket_day_order.py +74 -0
  61. package/md_cg/test_bucket_quota.py +79 -0
  62. package/md_cg/test_bucket_recency_guards.py +75 -0
  63. package/md_cg/test_bucket_three_causes.py +83 -0
  64. package/md_cg/test_bucket_time_rounds.py +87 -0
  65. package/md_cg/test_bucketindex.py +130 -0
  66. package/md_cg/test_bucketscope_early.py +71 -0
  67. package/md_cg/test_cohesion.py +107 -0
  68. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  69. package/md_cg/test_cond_term_neg_scope.py +147 -0
  70. package/md_cg/test_constraint_audit.py +87 -0
  71. package/md_cg/test_constraint_watch.py +108 -0
  72. package/md_cg/test_context_audit.py +110 -0
  73. package/md_cg/test_context_plan.py +81 -0
  74. package/md_cg/test_detrerank.py +157 -0
  75. package/md_cg/test_gate_four_kpi.py +136 -0
  76. package/md_cg/test_generation_guard.py +14 -2
  77. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  78. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  79. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  80. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  81. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  82. package/md_cg/test_issue790_verb_negation.py +77 -0
  83. package/md_cg/test_issue810_root_guard.py +71 -0
  84. package/md_cg/test_issue812_info_index_stale.py +78 -0
  85. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  86. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  87. package/md_cg/test_kernel_iface_contracts.py +18 -0
  88. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  89. package/md_cg/test_probe_cd_shipped.py +385 -0
  90. package/md_cg/test_recent_tail.py +93 -0
  91. package/md_cg/test_run_tests_entry_gates.py +110 -0
  92. package/md_cg/test_scopeselect.py +70 -0
  93. package/md_cg/test_scopeselect_clock.py +70 -0
  94. package/md_cg/test_session_attribution_consistency.py +835 -813
  95. package/md_cg/test_state_extract_shipped.py +162 -0
  96. package/md_cg/test_state_ledger_chain.py +207 -0
  97. package/md_cg/test_state_ledger_e2e.py +145 -0
  98. package/md_cg/test_structboost.py +102 -0
  99. package/md_cg/test_timeboost.py +83 -0
  100. package/md_cg/test_timeboost_relativedate.py +71 -0
  101. package/md_cg/test_topicagg.py +129 -0
  102. package/md_cg/timeboost.py +223 -0
  103. package/md_cg/tokens.py +1 -1
  104. package/md_cg/topicagg.py +142 -0
  105. package/md_cg/version_anchor.py +84 -1
  106. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  107. package/md_cg/whitebox_kb/wisdom/code_solidified.json +6195 -6195
  108. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  109. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  110. package/package.json +1 -1
  111. package/src/hooks.ts +43 -1
  112. package/ui/minimal/payload/build-ui.mjs +41 -2
  113. package/ui/minimal/payload/lib/client.js +29 -3
  114. package/ui/minimal/payload/web/app.js +3 -1
  115. package/ui/minimal/payload/web/client.js +30 -3
  116. package/web/app.js +3 -1
  117. package/web/client.js +30 -3
  118. package/zcode/AGENTS.md +1 -1
package/CHANGELOG.md CHANGED
@@ -1,449 +1,642 @@
1
- # 变更日志(CHANGELOG)
2
-
3
- 本文件自 **0.9.15** 起维护。更早版本见 git tag(`v0.9.6` … `v0.9.14`)与 GitHub Releases。
4
-
5
- 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循语义化版本。
6
-
7
- ## [0.9.23] - 2026-11-05
8
-
9
- ### 修复:`cg(op=read)` 自然问法普遍 DEFER(issue #722,Q1=A / Q2=A)
10
-
11
- - `judge_qualification` 增 `strict_conditions`(库面默认 `true`,既有调用方零变化);**工具面 `read`/`route` 缺省放宽**;
12
- - 放宽**只到 `usable`**:`state` 仍是 `DEFER`,新增 `usable/relaxed/code/condition_status`,reason 明写「未冒充已确认」;
13
- - **只放宽「生效条件未在情境确认」一支**;坏条件 / `REJECT` / `BLINDSPOT` / 验证基底**仍拦**;
14
- - 守卫 10 条;`judge_with_boundary` 现在保留这四个标记键(原先被裁掉,导致「放宽了也看不见」)。
15
-
16
- ### 修复:`cg(op=info)` 在大库上超时(issue #677 B)
17
-
18
- - `health_os()`(全库扫描类)改为**仅 `full=true` 时执行**;新增 `flush_state`(`pending_dirty/worker_alive/last_error`)与 `node_count`;
19
- - **契约变更**:缺省不再含 health_os 的键(`buckets`/`bucket_scope`/`ccg_by_layer` 等);要旧全集请传 `full=true`。
20
-
21
- ### 修复:写入成功后调用超时、重试产生重复节点(issue #677)
22
-
23
- - `mdcg_remember` 支持 `dedupe`(与 `cg(op=write)` 同一个幂等闸);**插件三类自动记忆默认带 `dedupe: true`**,可用 `memory.dedupe=false` 关闭;
24
- - 服务端闸改为**同会话才幂等**:跨会话写同一句不会互相顶掉(叠加 `sessionPrivate` 时不再「命中但读不到」)。
25
-
26
- ### 性能:flush 锁内 IO 从 O(N) 降到 O(1)(issue #677 C)
27
-
28
- - `ShardedLog.append_many`:**一次 write + 一次 flush**;整批仍在同一把 `FileLock` 内(与 compact 互斥语义不变);
29
- - 同时修两个崩溃安全缺陷:**残尾粘行**(末字节非换行先补 `\n`)、**失败回填丢 `superseded` 标记**(否则陈旧记录复活=旧盖新)。
30
-
31
- ### 修复:`FileLock.__enter__` 异常路径泄漏 fd(issue #740)
32
-
33
- - strict 超时 / 非重试 errno / `timeout` 类型错 / `sleep` 中 `KeyboardInterrupt` 四条路径现在都走 `_close_fd()`;
34
- - `__exit__` 复用(幂等、绝不抛),重复 `__enter__` 先清旧句柄。
35
-
36
- ### 口径收口:同一份指纹只留一个真源
37
-
38
- - `reconcile._disk_hashes` 二元组收单值(#758);
39
- - `twophase` 指纹与索引条目同源(#759,`_norm` 降为 legacy 兼容);
40
- - 验证态继承改用索引 `content_hash` 比对、**不再读盘**(#757,撤 #352 §B 绕行)。
41
-
42
- ### 修复:scrub 把正文引用行当成断言键(误判矛盾)
43
-
44
- - 键里出现括号类标点即不是字段名;值以 `src_/ref_/doc_` 开头不算可断言值;
45
- - **注**:`…(源:src_x)` 的真凶是「`…(源`」这个**带括号前缀键**,不是单字「源」(后者被长度闸过滤)。
46
-
47
- ### 已知限制
48
-
49
- - `cg(op=recall)`(预算装包路径)尚未接线 `strict_conditions`;
50
- - `health_os()` 自身耗时未优化,仅被 `full=true` 挡在主路径外;
51
- - scrub 的 `contradiction` 仍按字面键值比对,语义改写类误判只能靠「键形态」收敛,无法根除。
52
- ## [0.9.22] - 2026-11-03
53
-
54
- ### 修复:`cg(op=write)` 静默丢弃 `aliases`(issue #722,用户实测)
55
-
56
- 调用方传 `aliases=[...]` 时参数被**静默丢弃**,手动改 frontmatter 才生效。现已补三处转发面:
57
- `writepipe._OUTLET_PARAMS` / `op_table.write.params` / `mcp_server` 入口。
58
-
59
- > ⚠ 如果你装的是 **0.9.21**,你遇到的就是这个 —— 该修复在 0.9.21 发布**之后**才进 main,所以没随它发出。
60
-
61
- ### 新功能:会话身份 **A2 路线**(灵枢自读 DSH 会话文件算 `s5`)
62
-
63
- - 新增 `resolve_sessions_root` / `locate_session_file` / `read_session_file` / `session5_resolve`;
64
- - 守卫 **17 条**(`test_session5_resolve.py`);
65
- - 复用**已登记**的 `MDCG_DSH_SESSIONS_ROOT`(不新造环境变量)。
66
-
67
- ### 修复:`test_issue376_heartbeat_failed` 的 **A09** 是结构性竞态(issue #745)
68
-
69
- A09 拿 `last_age_s`(`= time.time() - 最近成功 t`)做**跨调用** `==` 比较,而 `_st` 是测试早段算的、
70
- `_OK_ONLY` 的读数在 A09 现场算,中间隔着 A01–A08 共 8 个检查 ⇒ 两侧时间差**几百毫秒**,
71
- `last_age_s` 量化为 0.1s 桶 ⇒ **跨桶概率 ≈ Δt / 0.1s**,CI 慢一点必红。
72
-
73
- 现改为**冻结时钟**(只替换 `sustain` 名字空间的 `time`,不污染全局),14 键仍**逐位比较**。
74
-
75
- > 实际影响:本版之前,`python-tests` 会**间歇性红在同一行**,与你的改动无关 —— 看到别慌,本版已修。
76
-
77
- ### 文档:密级(sensitivity)章节(`docs/ops/权限与复核模型.md`)
78
-
79
- 默认 `internal`、`private` 需两个前提、三档写闸实测矩阵。
80
-
81
- ### 文档:写入超时 ≠ 写入失败(`docs/ops/运维与排障.md`,issue #677 P3)
82
-
83
- 三条规则:① 超时后**先查**再重试;② 要幂等就**自带 `node_id`**(同 id 覆盖,实测 `1→1`);
84
- ③ `importance ≥ 0.7` 的重复条目**不好清**(自动 `protected`,删除需 `override`)。
85
-
86
- ### 文档:`validity` 语义 + 四个易误读取舍(`README.md` + 两处 docstring,issue #672)
87
-
88
- - `validity=true` **只排「已过期」,不排「未生效」**(`meta.validity_scope = "expired_only"`);
89
- - `importance` 默认 0.5,但 **≥0.7 自动硬保护**;
90
- - `calibration` **只给建议**,`apply=True` 才写回;
91
- - 会话窗口的「重叠」**是设计**,不是冗余。
92
-
93
- ### 其它
94
-
95
- - `fix(op_table)`:`aliases` 从 `_GENERIC_PARAMS` 撤出(避免与 `write.params` 重复计数);
96
- - `chore(cogmap)`:重挂行号(`mcp_server` 加 `aliases` 后漂移 4 行)。
97
-
98
- ## [0.9.21] - 2026-10-31
99
-
100
- ### 修复:规范文档**随包分发**(0.9.20 只给了外链)
101
-
102
- 0.9.20 的做法是「README 给 GitHub 绝对链接」——解决了「知道有」,**没解决「装完能读到」**。
103
-
104
- **本版把 7 个用户该遵守/该查的规范放进 `files` 白名单**:
105
-
106
- | 文件 | 用途 |
107
- |---|---|
108
- | `docs/mdcg/写入别名aliases规范_v0.6.md` | **写记忆时怎么补 `aliases`**(0.9.19 新增能力) |
109
- | `docs/mdcg/CCG六要素编译.md` | 六要素怎么写 |
110
- | `docs/mdcg/guardrail-charter.md` | 护栏宪章(对外公开法案) |
111
- | `docs/mdcg/MCP工具名口径_v1.0.md` | 工具名口径 |
112
- | `docs/mdcg/recall_metadata.md` | 召回元数据 |
113
- | `docs/mdcg/世界模型功能端_使用与运维_v1.0.md` | 世界模型面使用与运维 |
114
- | `docs/mdcg/cogmap_ops.md` | cogmap 操作 |
115
-
116
- ⇒ 装完包后,这 7 个文件在 `node_modules/@furongjun1999/dsh-memory/docs/mdcg/` 下可直接读。README 文档地图的链接也改回**包内相对路径**。
117
-
118
- ### 为什么不整目录打包
119
-
120
- `docs/mdcg/` 共 **47 个 .md**,其中混着内部记录(`release_v0.3.0.md`、`CSRE_索引与负条件修复_20261012.md`、各 `plans_*`、`D_meta_工程化方案` 等)。
121
- **整目录打包会把内部记录也发出去**,所以按文件挑 7 个。
122
-
123
- ### 仍未打包(明确边界)
124
-
125
- - `docs/theory/`(19 个,内部理论)
126
- - `docs/eval/`(136 个,内部评测)
127
- - `docs/plans/`(25 个,内部计划)
128
- - `docs/ops/`(8 个,安装运维——README 里既有相对链接,**在 npm 页面上仍点不开**,属存量问题)
129
-
130
- ## [0.9.20] - 2026-10-31
131
-
132
- ### 修复:规范文档的可见性(0.9.19 的疏漏)
133
-
134
- 0.9.19 的 CHANGELOG 里写了「规范全文:`docs/mdcg/写入别名aliases规范_v0.6.md`」,
135
- **但 `docs/mdcg/` 从来不在 npm 包的 `files` 白名单里** ⇒ 那是个**包内死链**,用户装了包也找不到。
136
-
137
- **本版修复**:
138
-
139
- | 面 | 改动 |
140
- |---|---|
141
- | `README.md` · 文档地图 | 新增一行「**写入规范**」,用 **GitHub 绝对 URL** 链到「写入别名 aliases」「CCG 六要素编译」「护栏宪章」,并**明确标注「这几个不在 npm 包里」** |
142
- | `CHANGELOG.md` · 0.9.19 节 | 死链改成 GitHub URL,并标注「不在 npm 包里,需在仓库看」 |
143
-
144
- ⚠️ **为什么不用相对路径**:README 里既有链接都是相对路径(`docs/ops/README.md` 等),
145
- 在 npm 包页面上**同样点不开**——本次新加的一律用绝对 URL。
146
-
147
- > 这是「打包白名单」与「文档指引」之间的老问题:`docs/mdcg/` 有 47 个 .md,
148
- > 其中既有用户该遵守的规范(`写入别名aliases`、`CCG六要素编译`、`guardrail-charter`),
149
- > 也有内部记录(`release_v0.3.0`、`CSRE_索引与负条件修复`、各 `plans`)。
150
- > **整目录打包会把内部记录也发出去**,所以本次选择「不打包 + README 给绝对链接」。
151
-
152
- ## [0.9.19] - 2026-10-31
153
-
154
- ### 新增:`aliases`(写入别名)——自然问法召不回的解法
155
-
156
- **用法**:写记忆时给节点加 `aliases`,把「用户以后可能怎么问这件事」的说法写进去。
157
-
158
- ```python
159
- cg(op="write", node_id="...", content="""# 功能名:会话交接前的记忆固化
160
- # 生效条件:聊交接、换会话、压缩、或他流露舍不得时
161
- ...""",
162
- aliases=["换掉", "被换", "别消失", "舍不得", "不想你走", "压缩上下文"])
163
- ```
164
-
165
- `aliases` **参与词法召回,但不进 `tags`**——`tags` 被机器判据占用(「是不是任务卡」「能不能当锚点」),
166
- 混用会改变那些判据。
167
-
168
- **写别名的正确方法**(实测总结):写之前**先自问一句「以后我会怎么问这件事?」**,把那些问法原样写进去(3–8 个,口语/情绪/近义都算)。
169
-
170
- > ⚠️ **不要机械抽词**。实测:从功能名按空格切词自动生成,20 条 × 5 查询 = **提升 +0**
171
- > (中文功能名没有空格,切出的是整句)。别名只能"想"出来,不能"切"出来。
172
-
173
- **为什么需要它**——issue #722 的决定性案例:
174
-
175
- | 匹配方式 | 条件「聊交接、换会话、压缩…」 vs 查询「我不想你被换掉」 |
176
- |---|---|
177
- | 整词匹配 | ❌ |
178
- | 二元组重叠 | ❌ `换会/会话` vs `我不/…/被换/换掉` —— **交集空** |
179
- | 查询扩展 | ❌ 扩出 `换掉/被换`,与 `换会话` **仍无交集** |
180
- | 现有同义词表(10 组,全技术词) | ❌ |
181
- | **加 `aliases`** | ✅ **命中** |
182
-
183
- 规范全文(**不在 npm 包里,需在仓库看**):[docs/mdcg/写入别名aliases规范_v0.6.md](https://github.com/FuRongJun-1999/dsh-memory/blob/main/docs/mdcg/写入别名aliases规范_v0.6.md)
184
-
185
- ### 修复
186
-
187
- - **Web 面板 `permissionNote` 不认通配符 `*`**(#723 / PR #724):全权令牌(`ops_allow: ["*"]`)下,
188
- 「目标与任务」「自我认知」「时空关系」「审核与维护」四页的 **12/12 预设全部误报「未声明权限」**,
189
- 而实际调用完全成功。根因是**前端与服务端判据不同口径**:
190
- 服务端 `_in_scope` 认 `"*" in allow`,前端只做 `allowed.includes(op)`。现已对齐。
191
-
192
- ⚠️ 判据正好反了的现象值得记:**全权令牌看到满屏红,窄令牌反而只有部分提示**。
193
-
194
- ### 新增:写入把关判据(**尚未接线,仅提供可测函数**)
195
-
196
- | 函数 | 作用 |
197
- |---|---|
198
- | `writegate.cond_is_metadata(cond_text)` | 判「生效条件」是否在描述载体/路径/方法(元数据),而非触发场景 |
199
- | `writegate.check_condition_quality(content)` | 上述的写入把关包装,返回 `{ok, is_metadata, cond, hint}`;**任何情况不抛** |
200
- | `writegate.aliases_is_thin(fm, content)` | 判别名是否「薄」(无别名,或只重复正文已有词) |
201
-
202
- ⚠️ **这三个函数尚未接进 `add()`**——只提供可测入口,接线是下一次改动。
203
-
204
- ### 内部:测试与守卫
205
-
206
- - **`test_mode_parity` 的 `full_D` 跨分钟时间泄漏**(PR #720):`tombstone` 是内容哈希,
207
- 而内容含墙钟聚合行 ⇒ 两个子进程跨分钟必然 DIFF。已在 `_RUNNER` 注入固定时间戳。
208
- - 新增守卫:`test_723_permission_wildcard`(6 条,**跨侧口径一致性**,与 `test_rust_fold_parity` 同族)、
209
- `test_722_condition_quality`(8 条)、`test_722_aliases_thin`(11 条)。
210
-
211
- ### 实测基线(供对照,非承诺)
212
-
213
- 本机库(32,845 节点)实测:
214
-
215
- | 项 | 读数 |
216
- |---|---|
217
- | 自然问法召回条数 | **2 条** |
218
- | `aliases` 覆盖率 | **0%** |
219
- | `knowledge` 层里 `role=None`(索引卡片) | **99.7%** |
220
- | 生效条件为元数据的比例 | **76.5%** |
221
-
222
- ⇒ 所以 `aliases` 的价值取决于**写入时是否真的写了**。库内现有节点**不会自动获得**它。
223
-
224
- ## [0.9.18] - 2026-10-30
225
-
226
- ### ⚠️ BREAKING:注入块格式变更
227
-
228
- `【本会话近期对话】` 块的行格式改为带**归因前缀**(issue #712 / PR #713):
229
-
230
- ```
231
- 旧:[user] 内容
232
- 新:[10-30 14:23|本|私] [user] 内容
233
- └──┬──┘ └┬┘ └┬┘
234
- 时间 会话 密级
235
- ```
236
-
237
- | 段 | 取值 |
238
- |---|---|
239
- | 时间 | `MM-DD HH:mm`;缺失渲染 `??-?? ??:??` |
240
- | 会话 | 等于当前会话 → `本`;其他 → `会话<后4位>`;缺失 → `?` |
241
- | 密级 | `private`/`secret` → `私`;`public`/`internal`/`restricted` → `共`;缺失 → `?` |
242
-
243
- **为什么改**:此前模型只看到 `[role] 内容`,无法判断「这是自己刚说的、还是别的会话说的、是私有还是共有」——
244
- 实测出现过「把另一个窗口的话当成当前用户刚说的」的误引(#712)。
245
-
246
- 块总长上限随之 `800 → 900` 字符(前缀约 20 字符/行)。
247
- **若你有依赖旧格式的解析/断言,请同步。**
248
-
249
- ### 新增
250
-
251
- - **`cg(op=info).write_gate`**(#708):分层写入闸的**进程内计数**——`{mode, total, by_layer, recent, hint}`。
252
- 此前 `warn` 档只写子进程 stderr,而 DSH 不转发 ⇒ 观察期等于没有。
253
- 现在不依赖 stderr 转发、不写盘;`recent` 只留 `layer/tier/reason`(**无内容、无节点 id**),有界 20 条。
254
- 计数**重启归零**,建议观察一个完整工作日再决定是否切 `enforce`。
255
- - **`Principal.sessions_read`**(#712 / 方案 C 分档隔离):`None` = 旧行为逐位不变;集合 = 只读这些会话;
256
- `{"*"}` = 全读。**`can_admin` 不削弱**(issue #35「设计者豁免」定稿)。
257
- - **事件归因四要素**:`pack["recent"]` 条目现含 `session`/`t`/`id`/`sensitivity`/`actor`/`token_id`/`identity_role`/`parent`。
258
- 事件新增稳定键 `id`(`re_<ms>_<6hex>`,**归因展示用,不得用于权限判定或去重定位**)。
259
- - **理论文档**:《身份与人格:职业身份的可变性 vs 人格的一致性》
260
- (`docs/theory/身份与人格_职业身份可变性与人格一致性_v0.1.md`)——
261
- 区分**人格**(跨会话恒定,`self`/`anchor` 层)与**职业身份**(会话级,工作层 + 事件归因)。
262
-
263
- ### 修复
264
-
265
- - **`enforce` 档下裁决审计节点被同一闸挡住**(#708 ② / #709):`_write_review_record` 写 `structural`(2 档),
266
- 却不传复核单元 ⇒ `decisions.jsonl` 还在、**可复核的 md 审计节点没了**。
267
- 现在把本次裁决已取得的 `reviewed_by` 一路带进写入。
268
- - **同一条链上两个更靠前的缺口**(查 #709 时发现):
269
- - **`propose` 死锁**:候选入 inbox 本不落记忆盘,却按目标层要求复核单元 ⇒
270
- enforce 下「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需提案 → 提案又要 reflect」。
271
- 现在 `require_layer_write(..., skip_gate=False)` 新增该参数,**只** `propose` 传 `True`;
272
- 层白名单与密级检查**照常执行**,`accept` 落盘仍走同一道闸。
273
- - **`accept` 落业务节点**不传 `reviewed_by` ⇒ 「裁决过了、落盘被拦」。
274
- - **`reviewed_by` 不再污染 frontmatter**:它是**写入闸的输入参数,不是记忆元数据**。
275
- 此前用 `kw.get()` 只读不删,会经 `super().add(**kw)` 落进节点 fm(实测 `test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null`)。
276
- 现在改为 `kw.pop()`。
277
- - **`actor` 恒为 None**(身份归属空心):`MdCGSecure.remember_event` 里 `tenant`/`session`/`harness`/`unit`/`sensitivity`
278
- **都从 principal 落值**,唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 `actor` 恒为 None。已补。
279
- - **取窗顺序 bug ×2**(#712 / #715):`session_recall` 与 `session_compact` 都**先截末 N 条、再按会话过滤**
280
- ⇒ 多会话并发时本会话消息被挤出窗口,`session="A"` 可能拿到**空 recent**(false-negative,极难被发现)。
281
- `session_compact` 更重——它会压出「共 0 条事件」并**写入会话节点**(写错一条记忆)。
282
- 修法:需要收窄时先取全量、再过滤、最后截回。
283
- - **`session` 为 falsy 时静默退回全局窗口**(#712):现在会在 `degraded` 里加 `recent_global_window`,调用方看得见。
284
- - **身份块恒为空**(#715):`【灵枢身份锚点】` 复用了**带会话过滤**的 timeline payload,
285
- 而 `self`/`anchor` 节点的 `session` **恒为 `unattributed`** ⇒ 永久层被全部滤掉 ⇒ **块从不出现且无报错**。
286
- 现在身份块**独立取数、不带会话过滤**;「最近记忆」块保持会话隔离。
287
- 这正是理论 R3 的实案:**人格的可见性不该由会话决定**。
288
- 另加 `else` 分支 `logger.info`——开关开了但无身份节点时显式提示,不再静默。
289
- - **会话 id 为空时静默退回全局窗口**(PR #714 by LeeRolling):现在 `logger.warn` 一次(不刷屏)。
290
-
291
- ### 内部
292
-
293
- - `test/chaos_injection/test_fi_m09_guest_write_denied.py` 的读码锚点从「完整调用串」放宽为「`layer, sens` 两参在位」,
294
- 并去掉两处硬编码行号。
295
- - `test_generation_guard.py` 的 `NEW_INFO_KEYS` 登记 `write_gate`。
296
- - `test_p45_session_identity.py` 的变异锚点同步新形态(**变异语义不变**)。
297
- - 新增守卫:`test_issue712_session_window_attribution`(29 条,含取窗顺序/四要素/身份三维/分权)、
298
- `test/issue715`(W715)、`test/issue714`(W714 / W714b)。
299
-
300
- ### 升级须知
301
-
302
- - **`--gate` 缺省仍是 `strict`**;`op=info` 只**新增**键;`sessions_read` 缺省 `None` = 旧行为逐位不变。
303
- - 若你在 #708 / #709 遇到过问题:升级后 `cg(op="info")["write_gate"]` 可看 warn 计数,
304
- `review accept` 的返回体里 **`record_error` 应为空**。
305
- - 若你在 #712 / #715 遇到过问题:升级后注入块应带归因前缀,`autoRecallIdentity: true` 时身份块应出现。
306
- ## [0.9.17] - 2026-10-28
307
-
308
- ### 修复
309
-
310
- - **`warn` 档对用户完全不可见(#708 ①)**:`security._write_gate_verdict` 只做 `sys.stderr.write`,而 DSH 不把这条
311
- 转发进 `desktop-next.log` ⇒ 观察期等于没有。现在 `writegate` 维护**进程内计数**并经 `cg(op=info).write_gate` 透出:
312
-
313
- ```python
314
- cg(op="info")["write_gate"]
315
- # {mode, total, by_layer: {"knowledge@L1": 3}, recent: [{layer,tier,reason}…], hint}
316
- ```
317
-
318
- 不依赖 stderr 转发、不写盘;`recent` 只留 `layer/tier/reason`(**无内容、无节点 id**),有界 20 条。
319
- stderr 那行保留(宿主愿转发时仍实时可见)。
320
-
321
- - **`enforce` 下裁决审计节点被同一闸挡住(#708 ② / #709)**:`_write_review_record` 写 `structural`(2 档:需 reflect+verify),
322
- 却不传复核单元 ⇒ `decisions.jsonl` 还在、**可复核的 md 审计节点没了**。现在把本次裁决已取得的 `reviewed_by`
323
- 一路带进写入:`review_decide → _finish_decision → _record_decision → _write_review_record → add(reviewed_by=…)`。
324
-
325
- - **同一个漏洞的两个更靠前落点(查 #709 时发现,一并修)**:
326
- - **`propose` 死锁**:候选入 inbox 本不落记忆盘,却按**目标层**要求复核单元 ⇒ `enforce` 下
327
- 「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需提案 → 提案又要 reflect」。
328
- 现在 `require_layer_write(..., skip_gate=False)` 新增该参数,**只** `propose` 传 `True`;
329
- 层白名单与密级检查**照常执行**(跳过的只有 write_gate 一档),`accept` 落盘仍走同一道闸。
330
- - **`accept` 落业务节点**不传 `reviewed_by` ⇒ 「裁决过了、落盘被拦」。现在一并透传。
331
-
332
- - **`reviewed_by` 不再污染 frontmatter**:它是**写入闸的输入参数,不是记忆元数据**。此前沿用 `kw.get()` 只读不删,
333
- 会经 `super().add(**kw)` 落进节点 fm(实测 `test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null`)。现在改为 `kw.pop()`。
334
-
335
- ### 内部
336
-
337
- - `test/chaos_injection/test_fi_m09_guest_write_denied.py` 的读码锚点从「完整调用串」放宽为「`layer, sens` 两参在位」
338
- (`require_layer_write` 现在多了 `reviewers=` 实参);同时去掉两处硬编码行号——行号会随改动漂移。
339
- - `test_generation_guard.py` 的 `NEW_INFO_KEYS` 登记 `write_gate`(`op=info` 的新增诊断键,与 `code_generation` 同类)。
340
-
341
- ### 升级须知
342
-
343
- - 本版**无破坏性变更**:`skip_gate` 缺省 `False`;`--gate` 缺省仍是 `strict`;`op=info` 只**新增**一个 `write_gate` 键。
344
- - 若你在 #708 / #709 里遇到过问题:升级后 `cg(op="info")["write_gate"]` 可看 warn 计数,
345
- `review accept` 的返回体里 **`record_error` 应为空**。
346
- - 计数是**进程内累计、重启归零**(不落盘),建议观察一个完整工作日再决定是否切 `enforce`。
347
- ## [0.9.16] - 2026-10-28
348
-
349
- ### 修复
350
-
351
- - **`/lingshu` 在 DSH 0.2.1-rc.3 上恒 503「宿主鉴权不可用」(#699)**:`createConsoleHandler` 在**挂载时**取一次
352
- `ctx.get('connection')`,而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 `undefined` ——
353
- 空值被闭包固化后每个请求都命中 503,宿主就绪也不自愈。现改为**每次请求实时取**(传取值函数,非函数则包成常量,向后兼容),
354
- 503 文案改为「宿主鉴权服务尚未就绪,请稍后重试」。守卫 3 条,其中「连接后到 ⇒ 同一 handler 立刻 200」正是病灶点。
355
- - **测试入口「零选中假绿」(#1910 跨仓报告)**:`--module` 的 help 教的是**斜杠**写法(`md_cg/test_issue4`),
356
- 而实际目标名是**点号**(`md_cg.test_issue4`),旧实现未归一化 ⇒ 斜杠写法选中**零个目标**却仍 `SUMMARY 0/0` + `rc=0`。
357
- 现归一化(斜杠 ≡ 点号、忽略 `.py`、空选择器不命中)+ **零选中不得返回 0**(执行路径 `rc=2`)。守卫 21 条含判别力自证。
358
- - **F26-13 `_primary_bound` 注释与实现不符**:`#637` 注释承诺「T3 按分数>0 裁切」,但代码只在 `n_real == 0` 时裁。
359
- 经实测:按注释补实现会**砸掉 S1b/S7 的「回退含异桶节点」契约**(`test_retr_s1b`/`test_retr_s7` 立即转红)⇒
360
- 确认「默认不裁」是刻意取舍,改为**注释对齐实现**并把实证写进注释(防后来者重踩)。
361
- - **F26-25 Rust 侧重音折叠缺失**:`normalize_en` 把非 ASCII 非中文一律变空格 ⇒ `café` → `caf`,而 Python 给 `cafe`。
362
- 受 `Cargo.toml`「零第三方依赖」约束,改为**按 Python 口径生成** 963 条单字符映射表 + 三区间组合记号剥离;
363
- 跨实现守卫 **29 条**逐项核对(含 `ß`/`ø` 不折、日文浊点不折的边界)。
364
-
365
- ### 新增
366
-
367
- - **门禁档位 `--gate fast|strict` + `--module` 过滤**(`scripts/run_tests.py`):
368
- 「快 = 问题放一边 / 慢 = 细究根本原因」是价值观取舍,**选择权交给使用者**;守卫侧一行未改,
369
- 「是否跑重质检」由上层决定。缺省 `strict`(不降低既有强度);**CI 环境 + `fast` 自动升级 strict** 防漏检。守卫 17 条。
370
- - **配置登记生成器「只增不改」守护**(`scripts/gen_config_registry.py`):整文件重写会抹掉手工补的行
371
- (实测事故:`MDCG_WARM_SEARCH`/`MDCG_VISION_ROOT` 消失)。现在写盘前用 AST 读旧表条目名,少一条就拒绝(`rc=3`),
372
- `--force` 为显式逃逸口。守卫 14 条。
373
- - **审计增加 `source` 键名集合维度**(`src/lib/hook_audit.ts`):#695 的关键缺口是「事件的 `source` 到底带哪些字段」不可观测。
374
- 新增 `source_shapes` 桶,**只记键名、绝不记值**(哨兵守卫钉住)。实测本机 383 个会话 / 9,614 行:`user` 档占 18.4%,
375
- 其中带 `rpcId` 80.3%、**仅 `kind` 的 19.7%** —— 这条读数把「来源归因」从猜测变成可量化。
376
- - **`entry_from_row` 两处静默回落改为可观测**(`md_cg/config_registry.py`):`literal_eval` 失败与 `value_type` 缺失
377
- 此前完全无痕(数值型登记会被静默当字符串)。新增 `literal_failures()` / `missing_value_types()` 两个读取口,**行为零变更**。守卫 15 条。
378
-
379
- ### 文档
380
-
381
- - **README 321 → 227 行**:把「图形界面」与「权限」两章各压到 ~14 行(一句话定位 + 最小命令 + 一张表 + 链接),
382
- 细节移入 [`docs/ops/图形界面_安装与排障.md`](docs/ops/图形界面_安装与排障.md) 与 [`docs/ops/权限与复核模型.md`](docs/ops/权限与复核模型.md)。
383
- README 的读者是「30 秒内决定要不要用」,细节属于 `docs/`。
384
-
385
- ### 升级须知
386
-
387
- - 本版**无破坏性变更**:`--gate` 缺省仍是 `strict`;`createConsoleHandler` 保留旧的「直接传值」调用方式;
388
- `--module` 两种写法现在都能用(此前斜杠写法会零选中)。
389
- - 若你在 DSH 0.2.1-rc.3 上遇到 `/lingshu` 恒 503:升级后**无需额外操作**,服务晚到也会自愈;
390
- 若仍 503,请附 `$DSH_HOME/logs/dsh-memory-hook-audit.json` 的 `kinds` 段(不含内容)回帖。
391
- ## [0.9.15] - 2026-10-27
392
-
393
- 主题:**权限分层与复核模型落地**(读/写/裁三层各自可收窄)+ 一次数量级的性能修复 + 两个「装不上/起不来」的真 bug。
394
-
395
- ### 新增 · 写入与裁决的复核模型
396
-
397
- - **分层写入严格度闸**(`MDCG_WRITE_GATE`,缺省 `off`)——情景/目标/未解/负记忆(0 档)无复核也可直写;
398
- 知识层需反思单元;结构层需反思+验证;自我/锚点层需反思+验证+**人工裁定**。
399
- **无任何复核通道时只允许写 0 档**,其余一律拒写。
400
- - **裁决双单元复核闸**(`MDCG_REVIEW_DUAL_CHECK`,缺省关)——裁决须带 `reviewed_by` 同时含反思与验证单元;
401
- **同类重复不算齐备**(两个反思仍无验证);裁决者不得是提案者(`self_review_forbidden`);未知单元不静默计入。
402
- - `MDCG_REVIEW_CHANNELS`(复核通道声明:`hive,subagent,team`)。注意它是**部署声明**:
403
- 为空只表示「没声明过」,**不等于**本机没有子代理/蜂巢/团队。
404
- - **设计者令牌覆盖面判据**——`DESIGNER_COVERAGE_OPS` / `coverage_gap()` / `HIGH_RISK_OPS` / `high_risk_granted()`;
405
- `tokens verify` 输出附 `designer_coverage_gap`;签发时把「收窄缺读面」「给了高风险面」两类提示写进返回值 `warnings`
406
- (库层不写 stderr,由 CLI 入口打印)。
407
-
408
- ### 新增 · 图形界面(可选增量包)
409
-
410
- - `ui/minimal/`:一行安装、逐文件可回滚、复用本机大脑桥(数据不出机);
411
- 七页面板(概览 / 记忆 / 目标与任务 / 自我认知 / 时空关系 / 审核与维护 / 工具台)。
412
- - `package.json` 的 `files` 白名单加入 `ui` 与 `web`,**随 npm 包分发**安装器、payload 与静态资源。
413
- - **接线入库**:`dsh.client` / `exports["./client"]` 写进 `package.json`、`installConsoleWeb(...)` 写进 `src/index.ts`;
414
- 产物由新增的 `scripts/build_ui.py` 生成(幂等;`--check` 只校验、缺文件 fail-closed;`build` 与 `prepublishOnly` 均自动执行)。
415
- 于是**改插件清单不再需要重装 UI**;`install.ps1` 转为面向「从 npm 包装到本机插件目录」的最终用户,
416
- 对无接线的旧插件包仍会自动补齐。守卫 `md_cg/test_ui_wiring_in_repo.py`(18 条)钉住声明/分发/构建三面不漂移。
417
-
418
- ### 性能
419
-
420
- - `protect.stats()` 改**条目口径**(读索引,不再逐节点读盘取 frontmatter):
421
- 在役库(3.2 万节点)冷态 **310 s → 0.015 s**。该函数经 `cg(op=info)` 的 `protection` 段被无条件调用,
422
- 是 UI 概览页「像卡死」的根因;修后概览页从 5 分钟级降到秒级。
423
- 语义不变:全量比对 `protected` / `immutable` **差异 0**。
424
-
425
- ### 修复
426
-
427
- - **UI 增量包在 Windows 上装不上**:payload 被 `core.autocrlf` 检出成 CRLF,与 `integrity.json`(按 LF 记 sha256)失配,
428
- 安装器误报「分享包文件缺失或损坏」。已用 `.gitattributes` 钉 `ui/minimal/payload/** eol=lf`。
429
- - **hive serve 起不来**:`config.local.json` 的 `{"env": "DEEPSEEK_API_KEY"}` 读的是**调用进程**环境变量,
430
- DSH 子进程继承不到机器级变量 ⇒ 误报「配置项解析失败」。已增 Windows 机器级回落
431
- (进程 env 显式值仍优先;两者皆空仍 fail-fast)。
432
- - 配置登记面补登记 `MDCG_WRITE_GATE` / `MDCG_REVIEW_CHANNELS` / `MDCG_REVIEW_DUAL_CHECK`。
433
-
434
- ### 文档
435
-
436
- - README 新增两章:「🖥️ 图形界面(可选增量包 · 面向 DSH)」与「🔐 权限:读 / 写 / 裁 三层,各自可收窄」,
437
- 含七页中哪四页是命令面板、排障三条、只读面 17 op、分层写入矩阵、裁决双单元、报错对照表。
438
-
439
- ### 升级须知
440
-
441
- - **三个新开关的缺省值都保持旧行为**(`MDCG_WRITE_GATE=off`、`MDCG_REVIEW_CHANNELS` 空、`MDCG_REVIEW_DUAL_CHECK` 关)
442
- ⇒ 升级后行为不变,需显式开启。建议顺序:先 `warn` 观察,接好复核通道后再 `enforce`。
443
- - 设计者令牌**不因升级而变宽**;若你的令牌曾被人为收窄,`tokens verify` 会报 `designer_coverage_gap` 并点名缺哪些面。
444
- - Windows 用户此前 UI 装不上的,本版可直接安装。
445
-
446
- ### 已知边界
447
-
448
- - 写入闸与裁决闸只认「复核单元声明」,不做证据真伪校验(真伪由蜂巢/子代理侧签章承接)。
449
- - `MDCG_WRITE_GATE=enforce` 前请先声明 `MDCG_REVIEW_CHANNELS`,否则知识层以上(含自动归档)会被拒写。
1
+ # 变更日志(CHANGELOG)
2
+
3
+ 本文件自 **0.9.15** 起维护。更早版本见 git tag(`v0.9.6` … `v0.9.14`)与 GitHub Releases。
4
+
5
+ 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循语义化版本。
6
+
7
+ ## [Unreleased]
8
+
9
+ ## [0.10.3] - 2026-11-12
10
+
11
+ ### 主打:人物档案(画像)——按「公民档案」结构承载属性,配合原文复核
12
+
13
+ 使用者裁定:**按中国公安/人社局的公民档案思路做人物档案(人物画像),在会话中不断补充。**
14
+ 同时定了另一条原则:**规则对多变的自然对话天生失效** ⇒ 用「表 + LLM 填 + 原文复核」。
15
+
16
+ - `md_cg/dossier.py`:确定性抽字段(姓名/年龄/城市/职业/单位/学历/专业/父/母),每条 `{value, t, ev}` 可回溯;
17
+ `merge` 增量合并,旧值进 `_history`。**隐私边界**:身份证/银行卡/手机号/详细住址命中即整段不建档
18
+ (档案只服务回忆检索,不服务身份核验)。
19
+ - `md_cg/distill.py`:写入时 LLM 填表 + **原文复核**。
20
+ - 表(`SCHEMA`)由代码定死,LLM 只填值、不能发明字段;
21
+ - 复核是机械判定:值/证据必须在原文找得到,否则拒收;
22
+ - **`_raw` 证据锚**:LLM 可给原文摘录作为证据,复核**证据**而非归一化值
23
+ (「江北咖啡店」vs 原文「江北那家咖啡店」不再被误拒);给了 `_raw` 但不匹配 ⇒ 直接拒收,不回退;
24
+ - 槽位长度闸(`MAX_LEN`)挡「母=整句」;序列项扁平化(`_flat_item`)挡嵌套结构;
25
+ - 序列字段 `经历`/`家庭`(list),逐项复核 + 关系词别名白名单(母↔妈)。
26
+ - 证据权重合并:自我介绍(3)> 行为句(2)> 泛提(1);弱证据不得覆盖强证据,
27
+ 同权重仅时间可变字段(年龄)取较新。
28
+ - `profiles` 资料卡:档案区前置到卡正文;dossier 扫全量事实(不受事实窗口截断);
29
+ 渲染形态容错(`{value:[...]}` / 裸 list / 裸值);合并期同样过地名闸。
30
+
31
+ ### 新增:自述轮次召回(`md_cg/selfstmt.py`)
32
+
33
+ - 写时登记(`add()` 命中 `SELF_RX` 即记入 `_selfstmt.json`)+ 读时注入(按**信息密度**降序,
34
+ 上限 `MDCG_SELFSTMT_LIMIT`,缺省 20);
35
+ - 覆盖「我叫/我今年/我大学/我最早/我住/我妈我爸/学徒/退休/兼职」及「我有近视/失眠」这类身体状况自述;
36
+ **负向约束**排除「我有个朋友近视」这类第三人陈述;
37
+ - **实测净效应 0**(164 题对照:`MDCG_SELFSTMT_LIMIT=0` vs `20`,两臂 153 vs 153)。
38
+ **机制保留,但不作为涨分主因。**
39
+
40
+ ### 新增:资料卡源轮次注入
41
+
42
+ 卡正文事实行带「(来源 <节点id>)」⇒ 卡被实体命中注入时,**其源轮次一并注入**:
43
+ 卡给属性,源轮次给原句(上限 4,`meta.profile_injected` 可审计)。
44
+
45
+ ### 修复
46
+
47
+ - `MDCG_ROLE_USER` / `MDCG_ROLE_AI` 改为**调用时读取**(原在模块导入时固化,长进程 setenv 不生效);
48
+ - `selfstmt.load/record/rebuild` 收 cg 实例或库根路径(原只收路径,传实例静默返回空);
49
+ - `maintain action=selfstmt` 新增存量库补登入口。
50
+
51
+ ### 实测(外测端,Ornn8 714 题)
52
+
53
+ ```
54
+ 全量通过率 666/714 = 93.3%(上一轮 657/714 = 92.0%,+9)
55
+ —— 单次运行,带星(未做两次重复,无稳定集与抖动)
56
+ 时间子集 75 题:71(94.7%)
57
+ relation 子集 93 题:86(92.5%)
58
+ 自述注入净效应:164 题两臂打平(153 vs 153),逐子集 ±1 属噪声
59
+ ```
60
+
61
+ **注意**:+9 属于本版**全部改动**的合力,未做逐补丁归因;不得把 +9 单独归给任一机制。
62
+
63
+ ### 已知边界
64
+
65
+ - 别名/称谓合并(外号/昵称/职位/亲属称谓)**未做**:设计见 `docs/设计_人物称谓与归属_v0.1.md`;
66
+ - 亲属关系型陈述(主语「她/他」)与事件型转述仍属召回缺口;
67
+ - `token 覆盖` ≠ 答对率;最弱 19 题子集不得当作发布主指标。
68
+ ## [0.10.2] - 2026-11-12
69
+
70
+ ### 新增:`recall` 返回时间线——状态序列进一等公民(#868 / #869)
71
+
72
+ **这是本版本的主打,也是十几个版本里单点收益最大的一次。**
73
+
74
+ - **根因**:模型面对 20–30 条按检索分排的片段时,**没有确定性的时序依据**去选「最早那次」。
75
+ 实测同一题两次跑给出不同锚点(`P20-037`:6-22 对 / 5-22 错);更直接的证据是
76
+ `P01-ADD-004` 金标 6-10 仍答 6-19、`P17-025` 金标 4-01 仍答 7-20 —— **那些日期就印在材料里**。
77
+ 提示词让它「按日期排序再取最早」,它排的是自己回忆的顺序,不是材料里的日期序。
78
+ 故:**时序归纳不该由模型做。**
79
+ - `recall` 返回体新增 `timeline: [{date, id, head}]`,按 `created_at` **升序**。
80
+ 数据源全是已有字段(`frontmatter.created_at` + 正文首句),零额外抽取成本;
81
+ 每条带 `id` 可回溯原文,跳过 CCG 头(`# 功能名:` 等六要素行),单条 ≤80 字。
82
+ - `recall` 返回体新增 `timeline_groups`:按**主题轴**归并的序列
83
+ (`frontmatter.bucket` 条件桶 → 首个 `tag` → 「未分组」;组内按日期升序、组间按条目数降序)。
84
+ 这是**启发式归并层**,不需要抽取器;同一条件桶未必同主题,覆盖不全时 `timeline` 全表兜底。
85
+ - **读数(时间类 75 题,两臂 × 两重复)**:
86
+
87
+ | 阶段 | 稳定集 | 增量 |
88
+ |---|---:|---:|
89
+ | 五版算法补丁(#851→#858) | 52 | — |
90
+ | + 作答侧三条(两步锚点 / 材料带日期 / 禁时间戳) | 55 | +3 |
91
+ | **+ `timeline` + `timeline_groups`** | **66** | **+11** |
92
+
93
+ 时间类 **62.7%(基线 47/75)→ 88.0%(66/75)**。
94
+ - **两条决定性证据**:
95
+ 1. **只给序列、不给原文**仍有 14/19(B 类专项)⇒ 信息大半在序列里,抽取器取向应为
96
+ 「序列为主、原文为辅」;
97
+ 2. **开 / 关 `MDCG_SCOPE_SELECT` 打平(66 vs 66,各独占 2 题)** ⇒ 这 +11 主要来自
98
+ **材料形态**(序列这层),而不是选桶算法 —— 与 0.10.0 的「共现投影已到天花板,往上要靠类型化图」一致。
99
+ - **归并覆盖**:75/75 题都存在 ≥2 条的主题组,平均 28.6 条/题 —— 不是少数题受益的优化。
100
+ - **边界**:剩余 4 题为「改期终态」(要最终值)与「多要素合成」(要素同时在场),
101
+ 仍需实体/槽位抽取(七维图 MVP);本版本的组是**桶级启发式**,不是四列状态表。
102
+ 未全量重跑 714(75 题为时间类子集)。
103
+
104
+ ### 修复:`info(full=true)` 落盘索引计数导致 60 秒超时(#863)
105
+
106
+ - full 面每次整份 `json.load` 60.4 MB 的 `_index.json`;在已持 3.4 万节点内存索引的进程里
107
+ 触发内存压力 ⇒ 撞 60 秒工具超时。改为按 `(mtime, size)` 缓存计数:首次 0.77s、之后 0.000s,
108
+ 外部改库自动失效。
109
+
110
+ ### 修复:`validity=True` 使桶补召回整体失效(#856)
111
+
112
+ - `bucketscope._is_expired` 用了 `time.*` 却没有 `import time` ⇒ `NameError` 被外层 `except` 吞掉,
113
+ **整条桶补召回静默失效**(旧守卫是假绿:只断言「过期节点不在 pack」,失效后本来就没有)。
114
+ - 连带修 `fill_rest` 补足路径没过 validity 闸(#843 的洞在另一条分支)。
115
+
116
+ ### 修复:跨日桶轮转只跑一轮,cap 补不满(#857)
117
+
118
+ - 9 条匹配 + `cap=8` 时若某些日桶只出 0–1 条就永远补不满(实测只回 6 条)。改多轮(≤3 轮 + 空转判据)。
119
+
120
+ ### 修复:read 面 `condition_space` / `semantic` 静默丢弃(#811)
121
+
122
+ - `condition_space` 早先没进链路(只透传 `context`)→ 现在 `context` 缺省时由它顶上;
123
+ - `semantic` 早先只在 `mdcg_search` 生效 → read 面显式并入第 6 路。
124
+
125
+ ### 门禁与工具
126
+
127
+ - **`check_publish_smoke.py` 接进 CI(#807)**:形成「静态面 → 追踪面 → **行为面**」三段式;
128
+ 该 workflow 是必需检查且总跑,故每次 PR 都真装一遍再握手。
129
+ - **`cogmap check` 与 git remote owner 解耦(#835)**:`COGMAP_REPO_BASE` 优先 + 比较前归一
130
+ (owner 不同不算漂移,行号不同仍判红)⇒ fork 不再必红。
131
+ - **tick 失败带栈摘要(#804)**:台账从「类名: 消息」变为追加末 3 帧 `文件:行 函数`,仍单行。
132
+ - `dependabot`:暂停 `@deepseek-ai/{cordis,schemastery}` 自动升级(宿主 rc 包把二者钉死在
133
+ `~3.18.4` / `4.0.5`,强升会压平嵌套副本致 `npm ci` EUSAGE)。
134
+
135
+ ## [0.10.1] - 2026-11-11
136
+
137
+ ### 时间检索修复(#849 / #850 / #851 / #852 / #853 / #855 / #858 / #859)
138
+
139
+ - 相对日期解析面扩展:三天前/上周三/上周/上个月(含中文数字)。
140
+ - `pick_scopes(now=)` 逻辑时钟注入;`recall(now=)` 透传(外部复测不再按真实今天解析)。
141
+ - `_pick` 命中抑制修复:命中节点优先 + 按时间补足(锚点在桶里不再消失)。
142
+ - 三类病因:早段会话配额 4→2(日桶得 6)、无词交集桶也补足、证据前置到池生成。
143
+ - 读数:时间类锚点覆盖 **41.2% → 83.2%**,稳定集 **52 → 55**(两臂两重复,抖动 0)。
144
+ - 三列表:锚点进&答对 50 / 锚点进&仍答错 19 / 锚点没全进&答对 5 / 没进&答错 1。
145
+ - 边界:开 vs 关反了 1 题(55 vs 56),作答侧改动同时抬了两臂;未全量重跑 714。
146
+
147
+ ## [0.10.0] - 2026-11-10
148
+
149
+ ### 新增:范围选择(`scopeselect`)——状态追踪式锚定,成为桶序标准(#844 / #847)
150
+
151
+ - **判据换代**:桶序不再由「哪段文字更像查询」决定,而由「这些值是否在同一时间桶里同时出现过」决定(槽位共现)。假题的错元素位于别章,共现投票天然免疫。
152
+ - **桶词表 + 桶文本骨架**:`_bucketterms.json`(词项/df)与 `_bucketskel.json`(骨架,每节点 600 字 / 每桶 2 万字),建桶时顺手落盘;查询期只做字典运算。
153
+ - **声明优先**:显式会话 / 显式日期直接当范围;无声明才走共现推断。
154
+ - **开关**:`MDCG_SCOPE_SELECT`(缺省 1,=0 回落「最近优先」)、`MDCG_SCOPESEL_COOC`(缺省 1,共现优先;=0 走 idf 兜底路)。
155
+ - **读数(bench rubric92 · 552 断言 · 纯确定性)**:所引章 top-1 **97.83%**、top-3 **99.82%**;消融(去掉「第N章」)同值 ⇒ 对章节字面零依赖。对照 idf 路 35.33%。
156
+ - **主库代价**:全量重建 3.4 万节点 53 秒;`_bucketskel.json` 5.72 MB、`_bucketterms.json` 21.09 MB;查询首调 0.64 秒(载入)→ 之后 0.00–0.01 秒。
157
+
158
+ ### 新增:桶索引每日收尾自动重建(#838)
159
+
160
+ - `cg(op=info)` 触发;`_bucketindex_meta.json` 记上次重建时间,超过 `MDCG_BUCKET_INTERVAL_H`(缺省 20h)才重建;后台 daemon 线程 + 模块级重入防护,不阻塞 info。
161
+ - info 返回体透出 `bucket_auto`(rebuilt / reason / age_h)可审计;`MDCG_BUCKET_AUTO=0` 关闭。
162
+
163
+ ### 修复:桶召回把最新的那条丢掉(#842)
164
+
165
+ - `_pick` 早先按 `(-hits, nid)` 排序后直接截 cap,时间序在截断之后才应用;9 条同等命中 + cap=8 时,被 id 序挤掉的可能正是最新那条。
166
+ - 现排序键在**截断前**就含时间序 `(-hits, recency, nid)` ⇒ 截断即保留「同分里最新的」。
167
+
168
+ ### 修复:`validity=True` 排除的过期记忆被桶补召回装回(#843)
169
+
170
+ - 桶补召回在候选检索之后 append,早先既没传 `validity` 也没复用过期判据。
171
+ - 现 `_pick` 源头过滤 `validity`(只认 `frontmatter.valid_until`,解析失败不算过期),`scope_recall` / `day_scope` / `session_scope` 全链透传。
172
+
173
+ ### 修复:scrub 幂等 / review_cli 落账 / bench 测量周期(#827 / #831 / #832;PR #839 / #840 / #841)
174
+
175
+ - `_weaken` 去重判据跟着节点走(旧判据读影子工作树里每轮归零的 `_scrub.jsonl`;实测 407 条负向证据仅 83 条不同、单键被记 52 次)。
176
+ - `review_cli` 以 `async_flush=False` 构造,写毕即落账重新成立。
177
+ - `bench_swarm_parallel` 测量周期拉离调度噪声区。
178
+
179
+ ### 修复:`calibration` 在分母无正例时恒判 overconfident(issue #829)
180
+ - 判据是 `Σ正例 / Σ(正例+负例)`,而 `confirmed` 只由外部裁决产生;活库
181
+ 407→409 条证据**正例恒为 0** ⇒ `actual_accuracy` 数学上恒 `0.0`、
182
+ `gap` 恒等于 `expected_accuracy` ⇒ `verdict` **恒为 overconfident**。
183
+ 该字段此前不携带信息,下游 `self_state` / `report` 却当真读数消费。
184
+ - 现 `Σ正例==0` ⇒ `calibration_defined=False` / `verdict="insufficient_data"`
185
+ / `reason="no_positive_evidence"`,**方向三值一律不判**;
186
+ `expected_accuracy` / `actual_accuracy` / `gap` / `ece` 仍如实透出(不隐藏、不编造)。
187
+ - 新增 `n_positive` / `n_negative` / `n_by_layer`:分母构成在读数面可见
188
+ (`grep n_by_layer` 此前零命中)。三层不变量:`n_nodes`、`n_positive`、
189
+ `n_negative` 分别等于 `n_by_layer` 各层求和。
190
+ - `scrub.calibrate()` 在 `calibration_defined=False` 时**拒绝出偏置**:
191
+ 返回 `ok=False` / `suggested_offset=0.0` / `n_adjusted=0`,`apply=True`
192
+ 也零写回。修前该路径会据退化的 `gap` 把全库 confidence 一律下调——
193
+ 一个不携带信息的读数直接改写事实层。
194
+ - `_advise()` 不判方向时不产出 `overconfident`/`underconfident` 建议,
195
+ 改产出 `no_positive_evidence`(带 why/action,可复核)。
196
+ - 有正例时判据**一字不改**(正向对照:全正例 → `actual=1.0` 且方向可判)。
197
+ - 守卫 `md_cg/test_issue829_calibration_positive_gate.py`:A/B/C/D/E 五组
198
+ 21 项,定点变异 **5/5 全杀**(含「M1 退回恒 overconfident」修前病象复现)。
199
+
200
+ ## [0.9.23] - 2026-11-05
201
+
202
+ ### 修复:`cg(op=read)` 自然问法普遍 DEFER(issue #722,Q1=A / Q2=A)
203
+
204
+ - `judge_qualification` 增 `strict_conditions`(库面默认 `true`,既有调用方零变化);**工具面 `read`/`route` 缺省放宽**;
205
+ - 放宽**只到 `usable`**:`state` 仍是 `DEFER`,新增 `usable/relaxed/code/condition_status`,reason 明写「未冒充已确认」;
206
+ - **只放宽「生效条件未在情境确认」一支**;坏条件 / `REJECT` / `BLINDSPOT` / 验证基底**仍拦**;
207
+ - 守卫 10 条;`judge_with_boundary` 现在保留这四个标记键(原先被裁掉,导致「放宽了也看不见」)。
208
+
209
+ ### 修复:`cg(op=info)` 在大库上超时(issue #677 B)
210
+
211
+ - `health_os()`(全库扫描类)改为**仅 `full=true` 时执行**;新增 `flush_state`(`pending_dirty/worker_alive/last_error`)与 `node_count`;
212
+ - **契约变更**:缺省不再含 health_os 的键(`buckets`/`bucket_scope`/`ccg_by_layer` 等);要旧全集请传 `full=true`。
213
+
214
+ ### 修复:写入成功后调用超时、重试产生重复节点(issue #677)
215
+
216
+ - `mdcg_remember` 支持 `dedupe`(与 `cg(op=write)` 同一个幂等闸);**插件三类自动记忆默认带 `dedupe: true`**,可用 `memory.dedupe=false` 关闭;
217
+ - 服务端闸改为**同会话才幂等**:跨会话写同一句不会互相顶掉(叠加 `sessionPrivate` 时不再「命中但读不到」)。
218
+
219
+ ### 性能:flush 锁内 IO 从 O(N) 降到 O(1)(issue #677 C)
220
+
221
+ - `ShardedLog.append_many`:**一次 write + 一次 flush**;整批仍在同一把 `FileLock` 内(与 compact 互斥语义不变);
222
+ - 同时修两个崩溃安全缺陷:**残尾粘行**(末字节非换行先补 `\n`)、**失败回填丢 `superseded` 标记**(否则陈旧记录复活=旧盖新)。
223
+
224
+ ### 修复:`FileLock.__enter__` 异常路径泄漏 fd(issue #740)
225
+
226
+ - strict 超时 / 非重试 errno / `timeout` 类型错 / `sleep` 中 `KeyboardInterrupt` 四条路径现在都走 `_close_fd()`;
227
+ - `__exit__` 复用(幂等、绝不抛),重复 `__enter__` 先清旧句柄。
228
+
229
+ ### 口径收口:同一份指纹只留一个真源
230
+
231
+ - `reconcile._disk_hashes` 二元组收单值(#758);
232
+ - `twophase` 指纹与索引条目同源(#759,`_norm` 降为 legacy 兼容);
233
+ - 验证态继承改用索引 `content_hash` 比对、**不再读盘**(#757,撤 #352 §B 绕行)。
234
+
235
+ ### 修复:scrub 把正文引用行当成断言键(误判矛盾)
236
+
237
+ - 键里出现括号类标点即不是字段名;值以 `src_/ref_/doc_` 开头不算可断言值;
238
+ - **注**:`…(源:src_x)` 的真凶是「`…(源`」这个**带括号前缀键**,不是单字「源」(后者被长度闸过滤)。
239
+
240
+ ### 已知限制
241
+
242
+ - `cg(op=recall)`(预算装包路径)尚未接线 `strict_conditions`;
243
+ - `health_os()` 自身耗时未优化,仅被 `full=true` 挡在主路径外;
244
+ - scrub 的 `contradiction` 仍按字面键值比对,语义改写类误判只能靠「键形态」收敛,无法根除。
245
+ ## [0.9.22] - 2026-11-03
246
+
247
+ ### 修复:`cg(op=write)` 静默丢弃 `aliases`(issue #722,用户实测)
248
+
249
+ 调用方传 `aliases=[...]` 时参数被**静默丢弃**,手动改 frontmatter 才生效。现已补三处转发面:
250
+ `writepipe._OUTLET_PARAMS` / `op_table.write.params` / `mcp_server` 入口。
251
+
252
+ > ⚠ 如果你装的是 **0.9.21**,你遇到的就是这个 —— 该修复在 0.9.21 发布**之后**才进 main,所以没随它发出。
253
+
254
+ ### 新功能:会话身份 **A2 路线**(灵枢自读 DSH 会话文件算 `s5`)
255
+
256
+ - 新增 `resolve_sessions_root` / `locate_session_file` / `read_session_file` / `session5_resolve`;
257
+ - 守卫 **17 条**(`test_session5_resolve.py`);
258
+ - 复用**已登记**的 `MDCG_DSH_SESSIONS_ROOT`(不新造环境变量)。
259
+
260
+ ### 修复:`test_issue376_heartbeat_failed` 的 **A09** 是结构性竞态(issue #745)
261
+
262
+ A09 拿 `last_age_s`(`= time.time() - 最近成功 t`)做**跨调用** `==` 比较,而 `_st` 是测试早段算的、
263
+ `_OK_ONLY` 的读数在 A09 现场算,中间隔着 A01–A08 共 8 个检查 ⇒ 两侧时间差**几百毫秒**,
264
+ `last_age_s` 量化为 0.1s 桶 ⇒ **跨桶概率 ≈ Δt / 0.1s**,CI 慢一点必红。
265
+
266
+ 现改为**冻结时钟**(只替换 `sustain` 名字空间的 `time`,不污染全局),14 键仍**逐位比较**。
267
+
268
+ > 实际影响:本版之前,`python-tests` 会**间歇性红在同一行**,与你的改动无关 —— 看到别慌,本版已修。
269
+
270
+ ### 文档:密级(sensitivity)章节(`docs/ops/权限与复核模型.md`)
271
+
272
+ 默认 `internal`、`private` 需两个前提、三档写闸实测矩阵。
273
+
274
+ ### 文档:写入超时 ≠ 写入失败(`docs/ops/运维与排障.md`,issue #677 P3)
275
+
276
+ 三条规则:① 超时后**先查**再重试;② 要幂等就**自带 `node_id`**(同 id 覆盖,实测 `1→1`);
277
+ ③ `importance ≥ 0.7` 的重复条目**不好清**(自动 `protected`,删除需 `override`)。
278
+
279
+ ### 文档:`validity` 语义 + 四个易误读取舍(`README.md` + 两处 docstring,issue #672)
280
+
281
+ - `validity=true` **只排「已过期」,不排「未生效」**(`meta.validity_scope = "expired_only"`);
282
+ - `importance` 默认 0.5,但 **≥0.7 自动硬保护**;
283
+ - `calibration` **只给建议**,`apply=True` 才写回;
284
+ - 会话窗口的「重叠」**是设计**,不是冗余。
285
+
286
+ ### 其它
287
+
288
+ - `fix(op_table)`:`aliases` 从 `_GENERIC_PARAMS` 撤出(避免与 `write.params` 重复计数);
289
+ - `chore(cogmap)`:重挂行号(`mcp_server` 加 `aliases` 后漂移 4 行)。
290
+
291
+ ## [0.9.21] - 2026-10-31
292
+
293
+ ### 修复:规范文档**随包分发**(0.9.20 只给了外链)
294
+
295
+ 0.9.20 的做法是「README 给 GitHub 绝对链接」——解决了「知道有」,**没解决「装完能读到」**。
296
+
297
+ **本版把 7 个用户该遵守/该查的规范放进 `files` 白名单**:
298
+
299
+ | 文件 | 用途 |
300
+ |---|---|
301
+ | `docs/mdcg/写入别名aliases规范_v0.6.md` | **写记忆时怎么补 `aliases`**(0.9.19 新增能力) |
302
+ | `docs/mdcg/CCG六要素编译.md` | 六要素怎么写 |
303
+ | `docs/mdcg/guardrail-charter.md` | 护栏宪章(对外公开法案) |
304
+ | `docs/mdcg/MCP工具名口径_v1.0.md` | 工具名口径 |
305
+ | `docs/mdcg/recall_metadata.md` | 召回元数据 |
306
+ | `docs/mdcg/世界模型功能端_使用与运维_v1.0.md` | 世界模型面使用与运维 |
307
+ | `docs/mdcg/cogmap_ops.md` | cogmap 操作 |
308
+
309
+ ⇒ 装完包后,这 7 个文件在 `node_modules/@furongjun1999/dsh-memory/docs/mdcg/` 下可直接读。README 文档地图的链接也改回**包内相对路径**。
310
+
311
+ ### 为什么不整目录打包
312
+
313
+ `docs/mdcg/` 共 **47 个 .md**,其中混着内部记录(`release_v0.3.0.md`、`CSRE_索引与负条件修复_20261012.md`、各 `plans_*`、`D_meta_工程化方案` 等)。
314
+ **整目录打包会把内部记录也发出去**,所以按文件挑 7 个。
315
+
316
+ ### 仍未打包(明确边界)
317
+
318
+ - `docs/theory/`(19 个,内部理论)
319
+ - `docs/eval/`(136 个,内部评测)
320
+ - `docs/plans/`(25 个,内部计划)
321
+ - `docs/ops/`(8 个,安装运维——README 里既有相对链接,**在 npm 页面上仍点不开**,属存量问题)
322
+
323
+ ## [0.9.20] - 2026-10-31
324
+
325
+ ### 修复:规范文档的可见性(0.9.19 的疏漏)
326
+
327
+ 0.9.19 的 CHANGELOG 里写了「规范全文:`docs/mdcg/写入别名aliases规范_v0.6.md`」,
328
+ **但 `docs/mdcg/` 从来不在 npm 包的 `files` 白名单里** ⇒ 那是个**包内死链**,用户装了包也找不到。
329
+
330
+ **本版修复**:
331
+
332
+ | 面 | 改动 |
333
+ |---|---|
334
+ | `README.md` · 文档地图 | 新增一行「**写入规范**」,用 **GitHub 绝对 URL** 链到「写入别名 aliases」「CCG 六要素编译」「护栏宪章」,并**明确标注「这几个不在 npm 包里」** |
335
+ | `CHANGELOG.md` · 0.9.19 节 | 死链改成 GitHub URL,并标注「不在 npm 包里,需在仓库看」 |
336
+
337
+ ⚠️ **为什么不用相对路径**:README 里既有链接都是相对路径(`docs/ops/README.md` 等),
338
+ 在 npm 包页面上**同样点不开**——本次新加的一律用绝对 URL。
339
+
340
+ > 这是「打包白名单」与「文档指引」之间的老问题:`docs/mdcg/` 有 47 个 .md,
341
+ > 其中既有用户该遵守的规范(`写入别名aliases`、`CCG六要素编译`、`guardrail-charter`),
342
+ > 也有内部记录(`release_v0.3.0`、`CSRE_索引与负条件修复`、各 `plans`)。
343
+ > **整目录打包会把内部记录也发出去**,所以本次选择「不打包 + README 给绝对链接」。
344
+
345
+ ## [0.9.19] - 2026-10-31
346
+
347
+ ### 新增:`aliases`(写入别名)——自然问法召不回的解法
348
+
349
+ **用法**:写记忆时给节点加 `aliases`,把「用户以后可能怎么问这件事」的说法写进去。
350
+
351
+ ```python
352
+ cg(op="write", node_id="...", content="""# 功能名:会话交接前的记忆固化
353
+ # 生效条件:聊交接、换会话、压缩、或他流露舍不得时
354
+ ...""",
355
+ aliases=["换掉", "被换", "别消失", "舍不得", "不想你走", "压缩上下文"])
356
+ ```
357
+
358
+ `aliases` **参与词法召回,但不进 `tags`**——`tags` 被机器判据占用(「是不是任务卡」「能不能当锚点」),
359
+ 混用会改变那些判据。
360
+
361
+ **写别名的正确方法**(实测总结):写之前**先自问一句「以后我会怎么问这件事?」**,把那些问法原样写进去(3–8 个,口语/情绪/近义都算)。
362
+
363
+ > ⚠️ **不要机械抽词**。实测:从功能名按空格切词自动生成,20 条 × 5 查询 = **提升 +0**
364
+ > (中文功能名没有空格,切出的是整句)。别名只能"想"出来,不能"切"出来。
365
+
366
+ **为什么需要它**——issue #722 的决定性案例:
367
+
368
+ | 匹配方式 | 条件「聊交接、换会话、压缩…」 vs 查询「我不想你被换掉」 |
369
+ |---|---|
370
+ | 整词匹配 | ❌ |
371
+ | 二元组重叠 | ❌ `换会/会话` vs `我不/…/被换/换掉` —— **交集空** |
372
+ | 查询扩展 | ❌ 扩出 `换掉/被换`,与 `换会话` **仍无交集** |
373
+ | 现有同义词表(10 组,全技术词) | ❌ |
374
+ | **加 `aliases`** | ✅ **命中** |
375
+
376
+ 规范全文(**不在 npm 包里,需在仓库看**):[docs/mdcg/写入别名aliases规范_v0.6.md](https://github.com/FuRongJun-1999/dsh-memory/blob/main/docs/mdcg/写入别名aliases规范_v0.6.md)
377
+
378
+ ### 修复
379
+
380
+ - **Web 面板 `permissionNote` 不认通配符 `*`**(#723 / PR #724):全权令牌(`ops_allow: ["*"]`)下,
381
+ 「目标与任务」「自我认知」「时空关系」「审核与维护」四页的 **12/12 预设全部误报「未声明权限」**,
382
+ 而实际调用完全成功。根因是**前端与服务端判据不同口径**:
383
+ 服务端 `_in_scope` 认 `"*" in allow`,前端只做 `allowed.includes(op)`。现已对齐。
384
+
385
+ ⚠️ 判据正好反了的现象值得记:**全权令牌看到满屏红,窄令牌反而只有部分提示**。
386
+
387
+ ### 新增:写入把关判据(**尚未接线,仅提供可测函数**)
388
+
389
+ | 函数 | 作用 |
390
+ |---|---|
391
+ | `writegate.cond_is_metadata(cond_text)` | 判「生效条件」是否在描述载体/路径/方法(元数据),而非触发场景 |
392
+ | `writegate.check_condition_quality(content)` | 上述的写入把关包装,返回 `{ok, is_metadata, cond, hint}`;**任何情况不抛** |
393
+ | `writegate.aliases_is_thin(fm, content)` | 判别名是否「薄」(无别名,或只重复正文已有词) |
394
+
395
+ ⚠️ **这三个函数尚未接进 `add()`**——只提供可测入口,接线是下一次改动。
396
+
397
+ ### 内部:测试与守卫
398
+
399
+ - **`test_mode_parity` 的 `full_D` 跨分钟时间泄漏**(PR #720):`tombstone` 是内容哈希,
400
+ 而内容含墙钟聚合行 ⇒ 两个子进程跨分钟必然 DIFF。已在 `_RUNNER` 注入固定时间戳。
401
+ - 新增守卫:`test_723_permission_wildcard`(6 条,**跨侧口径一致性**,与 `test_rust_fold_parity` 同族)、
402
+ `test_722_condition_quality`(8 条)、`test_722_aliases_thin`(11 条)。
403
+
404
+ ### 实测基线(供对照,非承诺)
405
+
406
+ 本机库(32,845 节点)实测:
407
+
408
+ | 项 | 读数 |
409
+ |---|---|
410
+ | 自然问法召回条数 | **2 条** |
411
+ | `aliases` 覆盖率 | **0%** |
412
+ | `knowledge` 层里 `role=None`(索引卡片) | **99.7%** |
413
+ | 生效条件为元数据的比例 | **76.5%** |
414
+
415
+ ⇒ 所以 `aliases` 的价值取决于**写入时是否真的写了**。库内现有节点**不会自动获得**它。
416
+
417
+ ## [0.9.18] - 2026-10-30
418
+
419
+ ### ⚠️ BREAKING:注入块格式变更
420
+
421
+ `【本会话近期对话】` 块的行格式改为带**归因前缀**(issue #712 / PR #713):
422
+
423
+ ```
424
+ 旧:[user] 内容
425
+ 新:[10-30 14:23|本|私] [user] 内容
426
+ └──┬──┘ └┬┘ └┬┘
427
+ 时间 会话 密级
428
+ ```
429
+
430
+ | 段 | 取值 |
431
+ |---|---|
432
+ | 时间 | `MM-DD HH:mm`;缺失渲染 `??-?? ??:??` |
433
+ | 会话 | 等于当前会话 → `本`;其他 → `会话<后4位>`;缺失 → `?` |
434
+ | 密级 | `private`/`secret` → `私`;`public`/`internal`/`restricted` → `共`;缺失 → `?` |
435
+
436
+ **为什么改**:此前模型只看到 `[role] 内容`,无法判断「这是自己刚说的、还是别的会话说的、是私有还是共有」——
437
+ 实测出现过「把另一个窗口的话当成当前用户刚说的」的误引(#712)。
438
+
439
+ 块总长上限随之 `800 → 900` 字符(前缀约 20 字符/行)。
440
+ **若你有依赖旧格式的解析/断言,请同步。**
441
+
442
+ ### 新增
443
+
444
+ - **`cg(op=info).write_gate`**(#708):分层写入闸的**进程内计数**——`{mode, total, by_layer, recent, hint}`。
445
+ 此前 `warn` 档只写子进程 stderr,而 DSH 不转发 ⇒ 观察期等于没有。
446
+ 现在不依赖 stderr 转发、不写盘;`recent` 只留 `layer/tier/reason`(**无内容、无节点 id**),有界 20 条。
447
+ 计数**重启归零**,建议观察一个完整工作日再决定是否切 `enforce`。
448
+ - **`Principal.sessions_read`**(#712 / 方案 C 分档隔离):`None` = 旧行为逐位不变;集合 = 只读这些会话;
449
+ `{"*"}` = 全读。**`can_admin` 不削弱**(issue #35「设计者豁免」定稿)。
450
+ - **事件归因四要素**:`pack["recent"]` 条目现含 `session`/`t`/`id`/`sensitivity`/`actor`/`token_id`/`identity_role`/`parent`。
451
+ 事件新增稳定键 `id`(`re_<ms>_<6hex>`,**归因展示用,不得用于权限判定或去重定位**)。
452
+ - **理论文档**:《身份与人格:职业身份的可变性 vs 人格的一致性》
453
+ (`docs/theory/身份与人格_职业身份可变性与人格一致性_v0.1.md`)——
454
+ 区分**人格**(跨会话恒定,`self`/`anchor` 层)与**职业身份**(会话级,工作层 + 事件归因)。
455
+
456
+ ### 修复
457
+
458
+ - **`enforce` 档下裁决审计节点被同一闸挡住**(#708 ② / #709):`_write_review_record` 写 `structural`(2 档),
459
+ 却不传复核单元 ⇒ `decisions.jsonl` 还在、**可复核的 md 审计节点没了**。
460
+ 现在把本次裁决已取得的 `reviewed_by` 一路带进写入。
461
+ - **同一条链上两个更靠前的缺口**(查 #709 时发现):
462
+ - **`propose` 死锁**:候选入 inbox 本不落记忆盘,却按目标层要求复核单元 ⇒
463
+ enforce 下「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需提案 → 提案又要 reflect」。
464
+ 现在 `require_layer_write(..., skip_gate=False)` 新增该参数,**只** `propose` 传 `True`;
465
+ 层白名单与密级检查**照常执行**,`accept` 落盘仍走同一道闸。
466
+ - **`accept` 落业务节点**不传 `reviewed_by` ⇒ 「裁决过了、落盘被拦」。
467
+ - **`reviewed_by` 不再污染 frontmatter**:它是**写入闸的输入参数,不是记忆元数据**。
468
+ 此前用 `kw.get()` 只读不删,会经 `super().add(**kw)` 落进节点 fm(实测 `test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null`)。
469
+ 现在改为 `kw.pop()`。
470
+ - **`actor` 恒为 None**(身份归属空心):`MdCGSecure.remember_event` 里 `tenant`/`session`/`harness`/`unit`/`sensitivity`
471
+ **都从 principal 落值**,唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 `actor` 恒为 None。已补。
472
+ - **取窗顺序 bug ×2**(#712 / #715):`session_recall` 与 `session_compact` 都**先截末 N 条、再按会话过滤**
473
+ ⇒ 多会话并发时本会话消息被挤出窗口,`session="A"` 可能拿到**空 recent**(false-negative,极难被发现)。
474
+ `session_compact` 更重——它会压出「共 0 条事件」并**写入会话节点**(写错一条记忆)。
475
+ 修法:需要收窄时先取全量、再过滤、最后截回。
476
+ - **`session` 为 falsy 时静默退回全局窗口**(#712):现在会在 `degraded` 里加 `recent_global_window`,调用方看得见。
477
+ - **身份块恒为空**(#715):`【灵枢身份锚点】` 复用了**带会话过滤**的 timeline payload,
478
+ 而 `self`/`anchor` 节点的 `session` **恒为 `unattributed`** ⇒ 永久层被全部滤掉 ⇒ **块从不出现且无报错**。
479
+ 现在身份块**独立取数、不带会话过滤**;「最近记忆」块保持会话隔离。
480
+ 这正是理论 R3 的实案:**人格的可见性不该由会话决定**。
481
+ 另加 `else` 分支 `logger.info`——开关开了但无身份节点时显式提示,不再静默。
482
+ - **会话 id 为空时静默退回全局窗口**(PR #714 by LeeRolling):现在 `logger.warn` 一次(不刷屏)。
483
+
484
+ ### 内部
485
+
486
+ - `test/chaos_injection/test_fi_m09_guest_write_denied.py` 的读码锚点从「完整调用串」放宽为「`layer, sens` 两参在位」,
487
+ 并去掉两处硬编码行号。
488
+ - `test_generation_guard.py` 的 `NEW_INFO_KEYS` 登记 `write_gate`。
489
+ - `test_p45_session_identity.py` 的变异锚点同步新形态(**变异语义不变**)。
490
+ - 新增守卫:`test_issue712_session_window_attribution`(29 条,含取窗顺序/四要素/身份三维/分权)、
491
+ `test/issue715`(W715)、`test/issue714`(W714 / W714b)。
492
+
493
+ ### 升级须知
494
+
495
+ - **`--gate` 缺省仍是 `strict`**;`op=info` 只**新增**键;`sessions_read` 缺省 `None` = 旧行为逐位不变。
496
+ - 若你在 #708 / #709 遇到过问题:升级后 `cg(op="info")["write_gate"]` 可看 warn 计数,
497
+ `review accept` 的返回体里 **`record_error` 应为空**。
498
+ - 若你在 #712 / #715 遇到过问题:升级后注入块应带归因前缀,`autoRecallIdentity: true` 时身份块应出现。
499
+ ## [0.9.17] - 2026-10-28
500
+
501
+ ### 修复
502
+
503
+ - **`warn` 档对用户完全不可见(#708 ①)**:`security._write_gate_verdict` 只做 `sys.stderr.write`,而 DSH 不把这条
504
+ 转发进 `desktop-next.log` ⇒ 观察期等于没有。现在 `writegate` 维护**进程内计数**并经 `cg(op=info).write_gate` 透出:
505
+
506
+ ```python
507
+ cg(op="info")["write_gate"]
508
+ # {mode, total, by_layer: {"knowledge@L1": 3}, recent: [{layer,tier,reason}…], hint}
509
+ ```
510
+
511
+ 不依赖 stderr 转发、不写盘;`recent` 只留 `layer/tier/reason`(**无内容、无节点 id**),有界 20 条。
512
+ stderr 那行保留(宿主愿转发时仍实时可见)。
513
+
514
+ - **`enforce` 下裁决审计节点被同一闸挡住(#708 ② / #709)**:`_write_review_record` 写 `structural`(2 档:需 reflect+verify),
515
+ 却不传复核单元 ⇒ `decisions.jsonl` 还在、**可复核的 md 审计节点没了**。现在把本次裁决已取得的 `reviewed_by`
516
+ 一路带进写入:`review_decide → _finish_decision → _record_decision → _write_review_record → add(reviewed_by=…)`。
517
+
518
+ - **同一个漏洞的两个更靠前落点(查 #709 时发现,一并修)**:
519
+ - **`propose` 死锁**:候选入 inbox 本不落记忆盘,却按**目标层**要求复核单元 ⇒ `enforce` 下
520
+ 「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需提案 → 提案又要 reflect」。
521
+ 现在 `require_layer_write(..., skip_gate=False)` 新增该参数,**只** `propose` 传 `True`;
522
+ 层白名单与密级检查**照常执行**(跳过的只有 write_gate 一档),`accept` 落盘仍走同一道闸。
523
+ - **`accept` 落业务节点**不传 `reviewed_by` ⇒ 「裁决过了、落盘被拦」。现在一并透传。
524
+
525
+ - **`reviewed_by` 不再污染 frontmatter**:它是**写入闸的输入参数,不是记忆元数据**。此前沿用 `kw.get()` 只读不删,
526
+ 会经 `super().add(**kw)` 落进节点 fm(实测 `test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null`)。现在改为 `kw.pop()`。
527
+
528
+ ### 内部
529
+
530
+ - `test/chaos_injection/test_fi_m09_guest_write_denied.py` 的读码锚点从「完整调用串」放宽为「`layer, sens` 两参在位」
531
+ (`require_layer_write` 现在多了 `reviewers=` 实参);同时去掉两处硬编码行号——行号会随改动漂移。
532
+ - `test_generation_guard.py` 的 `NEW_INFO_KEYS` 登记 `write_gate`(`op=info` 的新增诊断键,与 `code_generation` 同类)。
533
+
534
+ ### 升级须知
535
+
536
+ - 本版**无破坏性变更**:`skip_gate` 缺省 `False`;`--gate` 缺省仍是 `strict`;`op=info` 只**新增**一个 `write_gate` 键。
537
+ - 若你在 #708 / #709 里遇到过问题:升级后 `cg(op="info")["write_gate"]` 可看 warn 计数,
538
+ `review accept` 的返回体里 **`record_error` 应为空**。
539
+ - 计数是**进程内累计、重启归零**(不落盘),建议观察一个完整工作日再决定是否切 `enforce`。
540
+ ## [0.9.16] - 2026-10-28
541
+
542
+ ### 修复
543
+
544
+ - **`/lingshu` 在 DSH 0.2.1-rc.3 上恒 503「宿主鉴权不可用」(#699)**:`createConsoleHandler` 在**挂载时**取一次
545
+ `ctx.get('connection')`,而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 `undefined` ——
546
+ 空值被闭包固化后每个请求都命中 503,宿主就绪也不自愈。现改为**每次请求实时取**(传取值函数,非函数则包成常量,向后兼容),
547
+ 503 文案改为「宿主鉴权服务尚未就绪,请稍后重试」。守卫 3 条,其中「连接后到 ⇒ 同一 handler 立刻 200」正是病灶点。
548
+ - **测试入口「零选中假绿」(#1910 跨仓报告)**:`--module` 的 help 教的是**斜杠**写法(`md_cg/test_issue4`),
549
+ 而实际目标名是**点号**(`md_cg.test_issue4`),旧实现未归一化 ⇒ 斜杠写法选中**零个目标**却仍 `SUMMARY 0/0` + `rc=0`。
550
+ 现归一化(斜杠 ≡ 点号、忽略 `.py`、空选择器不命中)+ **零选中不得返回 0**(执行路径 `rc=2`)。守卫 21 条含判别力自证。
551
+ - **F26-13 `_primary_bound` 注释与实现不符**:`#637` 注释承诺「T3 按分数>0 裁切」,但代码只在 `n_real == 0` 时裁。
552
+ 经实测:按注释补实现会**砸掉 S1b/S7 的「回退含异桶节点」契约**(`test_retr_s1b`/`test_retr_s7` 立即转红)⇒
553
+ 确认「默认不裁」是刻意取舍,改为**注释对齐实现**并把实证写进注释(防后来者重踩)。
554
+ - **F26-25 Rust 侧重音折叠缺失**:`normalize_en` 把非 ASCII 非中文一律变空格 ⇒ `café` → `caf`,而 Python 给 `cafe`。
555
+ 受 `Cargo.toml`「零第三方依赖」约束,改为**按 Python 口径生成** 963 条单字符映射表 + 三区间组合记号剥离;
556
+ 跨实现守卫 **29 条**逐项核对(含 `ß`/`ø` 不折、日文浊点不折的边界)。
557
+
558
+ ### 新增
559
+
560
+ - **门禁档位 `--gate fast|strict` + `--module` 过滤**(`scripts/run_tests.py`):
561
+ 「快 = 问题放一边 / 慢 = 细究根本原因」是价值观取舍,**选择权交给使用者**;守卫侧一行未改,
562
+ 「是否跑重质检」由上层决定。缺省 `strict`(不降低既有强度);**CI 环境 + `fast` 自动升级 strict** 防漏检。守卫 17 条。
563
+ - **配置登记生成器「只增不改」守护**(`scripts/gen_config_registry.py`):整文件重写会抹掉手工补的行
564
+ (实测事故:`MDCG_WARM_SEARCH`/`MDCG_VISION_ROOT` 消失)。现在写盘前用 AST 读旧表条目名,少一条就拒绝(`rc=3`),
565
+ `--force` 为显式逃逸口。守卫 14 条。
566
+ - **审计增加 `source` 键名集合维度**(`src/lib/hook_audit.ts`):#695 的关键缺口是「事件的 `source` 到底带哪些字段」不可观测。
567
+ 新增 `source_shapes` 桶,**只记键名、绝不记值**(哨兵守卫钉住)。实测本机 383 个会话 / 9,614 行:`user` 档占 18.4%,
568
+ 其中带 `rpcId` 80.3%、**仅 `kind` 的 19.7%** —— 这条读数把「来源归因」从猜测变成可量化。
569
+ - **`entry_from_row` 两处静默回落改为可观测**(`md_cg/config_registry.py`):`literal_eval` 失败与 `value_type` 缺失
570
+ 此前完全无痕(数值型登记会被静默当字符串)。新增 `literal_failures()` / `missing_value_types()` 两个读取口,**行为零变更**。守卫 15 条。
571
+
572
+ ### 文档
573
+
574
+ - **README 321 → 227 行**:把「图形界面」与「权限」两章各压到 ~14 行(一句话定位 + 最小命令 + 一张表 + 链接),
575
+ 细节移入 [`docs/ops/图形界面_安装与排障.md`](docs/ops/图形界面_安装与排障.md) 与 [`docs/ops/权限与复核模型.md`](docs/ops/权限与复核模型.md)。
576
+ README 的读者是「30 秒内决定要不要用」,细节属于 `docs/`。
577
+
578
+ ### 升级须知
579
+
580
+ - 本版**无破坏性变更**:`--gate` 缺省仍是 `strict`;`createConsoleHandler` 保留旧的「直接传值」调用方式;
581
+ `--module` 两种写法现在都能用(此前斜杠写法会零选中)。
582
+ - 若你在 DSH 0.2.1-rc.3 上遇到 `/lingshu` 恒 503:升级后**无需额外操作**,服务晚到也会自愈;
583
+ 若仍 503,请附 `$DSH_HOME/logs/dsh-memory-hook-audit.json` 的 `kinds` 段(不含内容)回帖。
584
+ ## [0.9.15] - 2026-10-27
585
+
586
+ 主题:**权限分层与复核模型落地**(读/写/裁三层各自可收窄)+ 一次数量级的性能修复 + 两个「装不上/起不来」的真 bug。
587
+
588
+ ### 新增 · 写入与裁决的复核模型
589
+
590
+ - **分层写入严格度闸**(`MDCG_WRITE_GATE`,缺省 `off`)——情景/目标/未解/负记忆(0 档)无复核也可直写;
591
+ 知识层需反思单元;结构层需反思+验证;自我/锚点层需反思+验证+**人工裁定**。
592
+ **无任何复核通道时只允许写 0 档**,其余一律拒写。
593
+ - **裁决双单元复核闸**(`MDCG_REVIEW_DUAL_CHECK`,缺省关)——裁决须带 `reviewed_by` 同时含反思与验证单元;
594
+ **同类重复不算齐备**(两个反思仍无验证);裁决者不得是提案者(`self_review_forbidden`);未知单元不静默计入。
595
+ - `MDCG_REVIEW_CHANNELS`(复核通道声明:`hive,subagent,team`)。注意它是**部署声明**:
596
+ 为空只表示「没声明过」,**不等于**本机没有子代理/蜂巢/团队。
597
+ - **设计者令牌覆盖面判据**——`DESIGNER_COVERAGE_OPS` / `coverage_gap()` / `HIGH_RISK_OPS` / `high_risk_granted()`;
598
+ `tokens verify` 输出附 `designer_coverage_gap`;签发时把「收窄缺读面」「给了高风险面」两类提示写进返回值 `warnings`
599
+ (库层不写 stderr,由 CLI 入口打印)。
600
+
601
+ ### 新增 · 图形界面(可选增量包)
602
+
603
+ - `ui/minimal/`:一行安装、逐文件可回滚、复用本机大脑桥(数据不出机);
604
+ 七页面板(概览 / 记忆 / 目标与任务 / 自我认知 / 时空关系 / 审核与维护 / 工具台)。
605
+ - `package.json` 的 `files` 白名单加入 `ui` 与 `web`,**随 npm 包分发**安装器、payload 与静态资源。
606
+ - **接线入库**:`dsh.client` / `exports["./client"]` 写进 `package.json`、`installConsoleWeb(...)` 写进 `src/index.ts`;
607
+ 产物由新增的 `scripts/build_ui.py` 生成(幂等;`--check` 只校验、缺文件 fail-closed;`build` 与 `prepublishOnly` 均自动执行)。
608
+ 于是**改插件清单不再需要重装 UI**;`install.ps1` 转为面向「从 npm 包装到本机插件目录」的最终用户,
609
+ 对无接线的旧插件包仍会自动补齐。守卫 `md_cg/test_ui_wiring_in_repo.py`(18 条)钉住声明/分发/构建三面不漂移。
610
+
611
+ ### 性能
612
+
613
+ - `protect.stats()` 改**条目口径**(读索引,不再逐节点读盘取 frontmatter):
614
+ 在役库(3.2 万节点)冷态 **310 s → 0.015 s**。该函数经 `cg(op=info)` 的 `protection` 段被无条件调用,
615
+ 是 UI 概览页「像卡死」的根因;修后概览页从 5 分钟级降到秒级。
616
+ 语义不变:全量比对 `protected` / `immutable` **差异 0**。
617
+
618
+ ### 修复
619
+
620
+ - **UI 增量包在 Windows 上装不上**:payload 被 `core.autocrlf` 检出成 CRLF,与 `integrity.json`(按 LF 记 sha256)失配,
621
+ 安装器误报「分享包文件缺失或损坏」。已用 `.gitattributes` 钉 `ui/minimal/payload/** eol=lf`。
622
+ - **hive serve 起不来**:`config.local.json` 的 `{"env": "DEEPSEEK_API_KEY"}` 读的是**调用进程**环境变量,
623
+ DSH 子进程继承不到机器级变量 ⇒ 误报「配置项解析失败」。已增 Windows 机器级回落
624
+ (进程 env 显式值仍优先;两者皆空仍 fail-fast)。
625
+ - 配置登记面补登记 `MDCG_WRITE_GATE` / `MDCG_REVIEW_CHANNELS` / `MDCG_REVIEW_DUAL_CHECK`。
626
+
627
+ ### 文档
628
+
629
+ - README 新增两章:「🖥️ 图形界面(可选增量包 · 面向 DSH)」与「🔐 权限:读 / 写 / 裁 三层,各自可收窄」,
630
+ 含七页中哪四页是命令面板、排障三条、只读面 17 op、分层写入矩阵、裁决双单元、报错对照表。
631
+
632
+ ### 升级须知
633
+
634
+ - **三个新开关的缺省值都保持旧行为**(`MDCG_WRITE_GATE=off`、`MDCG_REVIEW_CHANNELS` 空、`MDCG_REVIEW_DUAL_CHECK` 关)
635
+ ⇒ 升级后行为不变,需显式开启。建议顺序:先 `warn` 观察,接好复核通道后再 `enforce`。
636
+ - 设计者令牌**不因升级而变宽**;若你的令牌曾被人为收窄,`tokens verify` 会报 `designer_coverage_gap` 并点名缺哪些面。
637
+ - Windows 用户此前 UI 装不上的,本版可直接安装。
638
+
639
+ ### 已知边界
640
+
641
+ - 写入闸与裁决闸只认「复核单元声明」,不做证据真伪校验(真伪由蜂巢/子代理侧签章承接)。
642
+ - `MDCG_WRITE_GATE=enforce` 前请先声明 `MDCG_REVIEW_CHANNELS`,否则知识层以上(含自动归档)会被拒写。