@furongjun1999/dsh-memory 0.9.15 → 0.9.16

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/CHANGELOG.md CHANGED
@@ -4,6 +4,50 @@
4
4
 
5
5
  格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循语义化版本。
6
6
 
7
+ ## [0.9.16] - 2026-10-28
8
+
9
+ ### 修复
10
+
11
+ - **`/lingshu` 在 DSH 0.2.1-rc.3 上恒 503「宿主鉴权不可用」(#699)**:`createConsoleHandler` 在**挂载时**取一次
12
+ `ctx.get('connection')`,而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 `undefined` ——
13
+ 空值被闭包固化后每个请求都命中 503,宿主就绪也不自愈。现改为**每次请求实时取**(传取值函数,非函数则包成常量,向后兼容),
14
+ 503 文案改为「宿主鉴权服务尚未就绪,请稍后重试」。守卫 3 条,其中「连接后到 ⇒ 同一 handler 立刻 200」正是病灶点。
15
+ - **测试入口「零选中假绿」(#1910 跨仓报告)**:`--module` 的 help 教的是**斜杠**写法(`md_cg/test_issue4`),
16
+ 而实际目标名是**点号**(`md_cg.test_issue4`),旧实现未归一化 ⇒ 斜杠写法选中**零个目标**却仍 `SUMMARY 0/0` + `rc=0`。
17
+ 现归一化(斜杠 ≡ 点号、忽略 `.py`、空选择器不命中)+ **零选中不得返回 0**(执行路径 `rc=2`)。守卫 21 条含判别力自证。
18
+ - **F26-13 `_primary_bound` 注释与实现不符**:`#637` 注释承诺「T3 按分数>0 裁切」,但代码只在 `n_real == 0` 时裁。
19
+ 经实测:按注释补实现会**砸掉 S1b/S7 的「回退含异桶节点」契约**(`test_retr_s1b`/`test_retr_s7` 立即转红)⇒
20
+ 确认「默认不裁」是刻意取舍,改为**注释对齐实现**并把实证写进注释(防后来者重踩)。
21
+ - **F26-25 Rust 侧重音折叠缺失**:`normalize_en` 把非 ASCII 非中文一律变空格 ⇒ `café` → `caf`,而 Python 给 `cafe`。
22
+ 受 `Cargo.toml`「零第三方依赖」约束,改为**按 Python 口径生成** 963 条单字符映射表 + 三区间组合记号剥离;
23
+ 跨实现守卫 **29 条**逐项核对(含 `ß`/`ø` 不折、日文浊点不折的边界)。
24
+
25
+ ### 新增
26
+
27
+ - **门禁档位 `--gate fast|strict` + `--module` 过滤**(`scripts/run_tests.py`):
28
+ 「快 = 问题放一边 / 慢 = 细究根本原因」是价值观取舍,**选择权交给使用者**;守卫侧一行未改,
29
+ 「是否跑重质检」由上层决定。缺省 `strict`(不降低既有强度);**CI 环境 + `fast` 自动升级 strict** 防漏检。守卫 17 条。
30
+ - **配置登记生成器「只增不改」守护**(`scripts/gen_config_registry.py`):整文件重写会抹掉手工补的行
31
+ (实测事故:`MDCG_WARM_SEARCH`/`MDCG_VISION_ROOT` 消失)。现在写盘前用 AST 读旧表条目名,少一条就拒绝(`rc=3`),
32
+ `--force` 为显式逃逸口。守卫 14 条。
33
+ - **审计增加 `source` 键名集合维度**(`src/lib/hook_audit.ts`):#695 的关键缺口是「事件的 `source` 到底带哪些字段」不可观测。
34
+ 新增 `source_shapes` 桶,**只记键名、绝不记值**(哨兵守卫钉住)。实测本机 383 个会话 / 9,614 行:`user` 档占 18.4%,
35
+ 其中带 `rpcId` 80.3%、**仅 `kind` 的 19.7%** —— 这条读数把「来源归因」从猜测变成可量化。
36
+ - **`entry_from_row` 两处静默回落改为可观测**(`md_cg/config_registry.py`):`literal_eval` 失败与 `value_type` 缺失
37
+ 此前完全无痕(数值型登记会被静默当字符串)。新增 `literal_failures()` / `missing_value_types()` 两个读取口,**行为零变更**。守卫 15 条。
38
+
39
+ ### 文档
40
+
41
+ - **README 321 → 227 行**:把「图形界面」与「权限」两章各压到 ~14 行(一句话定位 + 最小命令 + 一张表 + 链接),
42
+ 细节移入 [`docs/ops/图形界面_安装与排障.md`](docs/ops/图形界面_安装与排障.md) 与 [`docs/ops/权限与复核模型.md`](docs/ops/权限与复核模型.md)。
43
+ README 的读者是「30 秒内决定要不要用」,细节属于 `docs/`。
44
+
45
+ ### 升级须知
46
+
47
+ - 本版**无破坏性变更**:`--gate` 缺省仍是 `strict`;`createConsoleHandler` 保留旧的「直接传值」调用方式;
48
+ `--module` 两种写法现在都能用(此前斜杠写法会零选中)。
49
+ - 若你在 DSH 0.2.1-rc.3 上遇到 `/lingshu` 恒 503:升级后**无需额外操作**,服务晚到也会自愈;
50
+ 若仍 503,请附 `$DSH_HOME/logs/dsh-memory-hook-audit.json` 的 `kinds` 段(不含内容)回帖。
7
51
  ## [0.9.15] - 2026-10-27
8
52
 
9
53
  主题:**权限分层与复核模型落地**(读/写/裁三层各自可收窄)+ 一次数量级的性能修复 + 两个「装不上/起不来」的真 bug。
package/README.md CHANGED
@@ -156,127 +156,33 @@ DeepSeek Harness (cordis)
156
156
 
157
157
  ## 🖥️ 图形界面(可选增量包 · 面向 DSH)
158
158
 
159
- 灵枢本体是 MCP/插件,本身不带界面。`ui/minimal/` 是一个**可选增量包**:装到灵枢插件目录后,
160
- DSH 左侧会出现「灵枢」面板,也可直接访问 `http://127.0.0.1:<DSH端口>/lingshu`。
159
+ 灵枢本体不带界面。`ui/minimal/` 是**可选增量包**:装到插件目录后 DSH 左侧出现「灵枢」面板(也可直接开 `http://127.0.0.1:<DSH端口>/lingshu`)。
161
160
 
162
161
  ```powershell
163
- # 先只检查(不写任何文件,可随时跑)
164
- powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <你的灵枢插件目录> -CheckOnly
165
-
166
- # 安装(就地上屏;只改 UI 代码与插件清单)
167
- powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <你的灵枢插件目录>
168
-
169
- # 卸载(逐文件恢复安装前内容)
170
- powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <你的灵枢插件目录> -Uninstall
162
+ powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <灵枢插件目录> -CheckOnly # 只检查,不写文件
163
+ powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <灵枢插件目录> # 安装(可逐文件回滚)
164
+ powershell -ExecutionPolicy Bypass -File ui/minimal/install.ps1 -PluginPath <灵枢插件目录> -Uninstall # 卸载
171
165
  ```
172
166
 
173
- > **0.9.15 起:接线随仓库与 npm 包自带**——`dsh.client` / `exports["./client"]`(`package.json`)与
174
- > `installConsoleWeb(...)` 调用(`src/index.ts`)都在仓库里;静态产物由 `scripts/build_ui.py` 生成
175
- > (`build` 与 `prepublishOnly` 自动执行,`--check` 只校验)。所以**改插件清单不再需要重装 UI**。
176
- > 从 npm 包装到本机插件目录时,`install.ps1` 只需铺静态产物;对**无接线的旧插件包**它仍会自动补齐清单。
177
-
178
- | 安装器铺什么 | 安装器**不**动什么 |
179
- |---|---|
180
- | payload 9 个文件(`web/` · `lib/client.js` · `console_web.mjs` · `build-ui.mjs`) | DSH profile / 插件 root / 记忆库 |
181
- | (仅对无接线的旧包)补 `dsh.client`、`exports["./client"]` 与 `lib/index.js` 接线 | 凭据、令牌、自动记忆开关 |
182
- | — | 你的既有节点数据 |
183
-
184
- **生效方式**:client bundle 与 `/plugins/lingshu/*` 路由在 DSH **启动时**注册 ⇒ 装完需**重启 DSH**(安装器自己也会这么提示)。
185
-
186
- ### 七个页面与「命令面板」语义
187
-
188
- | 页面 | 内容 |
189
- |---|---|
190
- | 概览 / 记忆 | 打开即加载(最近记忆、检索、写入入口) |
191
- | 目标与任务 · 自我认知 · 时空关系 · 审核与维护 | **命令面板**:打开是空的,先点操作项,再点「执行查询」 |
192
- | 工具台 | 实时读取灵枢真实工具目录,可填表或直接写 JSON 调用 |
193
-
194
- > 写操作与裁决在界面上**需二次确认**(请求带 `confirm:true`,否则服务端返回 409);只读查询不需要。
195
-
196
- ### 排障(三条实测过的坑)
197
-
198
- | 现象 | 原因 | 处置 |
199
- |---|---|---|
200
- | `分享包文件缺失或损坏:web/index.html`(文件明明在) | payload 被 CRLF 检出,与 `integrity.json`(按 LF 记 sha256)失配 | 0.9.15 起已用 `.gitattributes` 钉 `eol=lf`;旧版可让 git 重新检出该目录(`git rm --cached -r ui/minimal/payload && git checkout -- ui/minimal/payload`) |
201
- | `之前安装的文件发生改变` / 卸载时报同样话 | 插件目录残留旧版 `.lingshu-ui-backup-v1/state.json`(记着过期 hash) | 把该目录整体移出插件目录(保留备份)后重跑安装器 |
202
- | 装完左侧没有「灵枢」 | ①没重启 DSH ②`package.json` 缺 `dsh.client` ③浏览器缓存旧前端 | ①重启 ②重跑安装器 ③硬刷新(Ctrl+Shift+R) |
203
-
204
- > 数据不出本机:UI 复用你原有灵枢的本机大脑桥;`/plugins/lingshu/call` 走同源校验 + CSRF + DSH 登录态,未登录一律 401。
205
- > 面向最终用户的逐步说明见 [`ui/minimal/使用说明.md`](ui/minimal/使用说明.md)。
206
-
167
+ 装完需**重启 DSH**(client bundle 在启动时注册)。0.9.15 起接线随包自带,改插件清单不必重装 UI。
168
+ 页面语义、三条实测坑(hash 失配 / 备份残留 / 左侧无图标)与排障 → [图形界面:安装与排障](docs/ops/图形界面_安装与排障.md) · 逐步说明 [使用说明](ui/minimal/使用说明.md)。
207
169
  ## 🔐 权限:读 / 写 / 裁 三层,各自可收窄
208
170
 
209
- 灵枢默认以**只读 guest** 运行(读得到、写不进)。写与裁需要令牌,并且按 2026-10-27 的三条裁定执行:
210
-
211
- > **设计者只读 · 写需谨慎 · 裁决须反思与验证单元复核。**
212
- > 理由是:自我人格的偏移与失忆是毁灭性的,全权限在不可靠的情况下就是灾难。
213
-
214
- ### 1)令牌:签发、收窄、体检
171
+ 默认以**只读 guest** 运行(读得到、写不进)。三条裁定:**设计者只读 · 写需谨慎 · 裁决须反思与验证单元复核**——自我人格的偏移与失忆是毁灭性的,全权限在不可靠的情况下就是灾难。
215
172
 
216
173
  ```bash
217
- # 签发(不传 --ops-allow 即角色默认;designer 的默认是 ["*"] 全集)
218
- python -m md_cg.tokens issue --role designer --actor my-agent
219
-
220
- # 收窄成「只读面」——给界面、自动化、子智能体用这个(只能收窄,不能放大)
221
- python -m md_cg.tokens issue --role designer --actor ui-panel \
222
- --ops-allow info,help,status,edges,read,route,recent,identity,self_state,\
223
- metacognition,review,protect,evolution,sustain,goal,task,whitebox
224
-
225
- # 体检(含 designer 覆盖面缺口报告)
226
- python -m md_cg.tokens verify --token-file-in <令牌文件>
227
- ```
228
-
229
- | 面 | 建议给谁 | op 边界 |
230
- |---|---|---|
231
- | **只读面**(17 个) | 界面面板、子智能体、只读巡检 | 上表;**不含** `write` / `verify` / `forget` / `scrub` / `consolidate` / `index_*` / `export` / `maintain` / `link` |
232
- | 写面 | 记录单元 | 追加 `write`(+ 按需 `session` / `ingest` / `ccg`) |
233
- | 裁决面 | 验证单元 | 追加 `verify`;`redteam` 门控与再审批仍然生效 |
234
-
235
- 签发后注入宿主:`config.env.MDCG_TOKEN`(如 DSH 的 profile 配置),或写密钥环 `~/.mdcg/token`;
236
- 令牌库默认 `~/.mdcg/_tokens.json`(可用 `MDCG_TOKEN_FILE` 覆盖)。
237
-
238
- ### 2)分层写入:一层比一层严
239
-
240
- `MDCG_WRITE_GATE` 控制这张表是否生效(`off` 缺省 / `warn` 只记录 / `enforce` 真阻断):
241
-
242
- | 档 | 层 | 有复核通道时需 | **无任何复核通道时** |
243
- |---|---|---|---|
244
- | 0 | `contextual` · `goals` · `unresolved` · `rejected` | 无要求 | ✅ 允许直写(放宽通道) |
245
- | 1 | `knowledge` | 反思单元 | ❌ 拒写 |
246
- | 2 | `structural` | 反思 + 验证单元 | ❌ 拒写 |
247
- | 3 | `self` · `anchor` | 反思 + 验证 + **人工裁定** | ❌ 拒写 |
248
-
249
- 复核通道用 `MDCG_REVIEW_CHANNELS` **声明**(`hive,subagent,team` 任选)。注意:该变量是**部署声明**,
250
- 为空只表示「没声明过」,**不等于**本机没有子代理/蜂巢/团队。
251
-
252
- ### 3)裁决:双单元复核 + 不得自证
253
-
254
- `MDCG_REVIEW_DUAL_CHECK=1` 开启后,裁决必须带齐两类复核单元:
255
-
256
- ```python
257
- cg(op="review", action="decide", pid="…", decision="accept",
258
- reviewed_by=["反思单元", "验证单元"]) # 中英文同义均可:reflect / verify / human
174
+ python -m md_cg.tokens issue --role designer --actor my-agent # 签发(designer 默认全集)
175
+ python -m md_cg.tokens verify --token-file-in <令牌文件> # 体检(含覆盖面缺口报告)
259
176
  ```
260
177
 
261
- | 判据 | 行为 |
262
- |---|---|
263
- | 缺反思或验证 | `dual_check_required`(点名缺哪方) |
264
- | 同类重复(两个反思) | 仍算缺验证——**同侧互证不构成复核** |
265
- | 裁决者 == 提案者 | `self_review_forbidden` |
266
- | 未知单元 | `unknown_review_unit`(不静默计入) |
267
-
268
- 与既有闸门**正交**:`redteam` + `needs_reapproval` 管打回与再审批;`verify_readonly` 管「判据由 propose 声明、裁决阶段不可改」;本闸只回答「谁复核过」。
269
-
270
- ### 4)一眼对照报错
271
-
272
- | 报错 | 含义 | 处置 |
178
+ | 面 | 给谁 | op 边界 |
273
179
  |---|---|---|
274
- | `AccessDenied: 本令牌的 ops 作用域不含 op=xxx` | 令牌 ops 被收窄,缺该 op | 重签并补 `--ops-allow`,或换有权限的令牌 |
275
- | `designer_coverage_gap`(`verify` 输出) | 设计者令牌缺「查看/裁决」面 | 补 op 重签;缺项会列出来 |
276
- | `write_gate ... deny` | 目标层需要复核而当前无通道/证据 | 声明 `MDCG_REVIEW_CHANNELS` 或补复核单元;或先切 `warn` 观察 |
277
- | `dual_check_required` / `self_review_forbidden` | 见上表 | 补单元 / 换裁决者 |
278
- | `redteam_required` / `reapproval_required` | 红队门控与再审批 | 带 `redteam.verdict=pass`(轮次递增) |
180
+ | 只读面 | 界面面板 · 子智能体 · 巡检 | 17 个(**不含** `write`/`verify`/`forget`/`scrub`/`consolidate`/`index_*`/`export`/`maintain`/`link`) |
181
+ | 写面 | 记录单元 | 追加 `write` |
182
+ | 裁决面 | 验证单元 | 追加 `verify` |
279
183
 
184
+ 写入按层收紧:`contextual` 可直写 → `knowledge` 需反思单元 → `structural` 需反思+验证 → `self`/`anchor` 需人工裁定(`MDCG_WRITE_GATE` 三态:`off`/`warn`/`enforce`)。裁决需**双单元复核且不得自证**(`MDCG_REVIEW_DUAL_CHECK=1`)。
185
+ 完整规则、开关与报错对照 → [权限与复核模型](docs/ops/权限与复核模型.md)。
280
186
  ## 📚 文档地图
281
187
 
282
188
  | 去哪里 | 看什么 |
package/lib/hooks.js CHANGED
@@ -901,6 +901,11 @@ export function installMemoryHooks(ctx, mdcg, opts) {
901
901
  // 落盘审计(issue #56):source.kind 分布——先于两级判据记录**完整**输入分布
902
902
  // (含被滤与放行),「宿主到底给这条消息标了什么 kind」是排障第一问。
903
903
  audit.observeKind(kindOf(event.data.source));
904
+ // issue #695 诊断面:记录 source 的**键名集合**(不含任何值)。
905
+ // kind 只说「以什么形式提交」,键名集合才能回答「source 带哪些字段」——
906
+ // 外部桥接经 sessions.prompt() 注入的控制提示同样走 kind="user",
907
+ // 靠这一维才有可核验的盘面读数(绝不记内容)。
908
+ audit.observeSourceShape(event.data.source);
904
909
  // H1 **消息级**判据:委派/中继消息(`form: 'relay'` 语义=「另一个 agent
905
910
  // 发给本 agent 的消息」)不写。先于 kind 判据,理由见 isRelayedMessage 注释。
906
911
  if (isRelayedMessage(event.data.source)) {
@@ -28,14 +28,21 @@ async function readBody(req) {
28
28
  try { return JSON.parse(Buffer.concat(chunks).toString('utf8')); }
29
29
  catch { throw Object.assign(new Error('请求必须是有效 JSON'), { status: 400 }); }
30
30
  }
31
- export function createConsoleHandler(mdcg, config, assets, connection) {
31
+ // issue #699(2026-10-28):第 4 参改为**取值函数**。原实现由挂载点 `ctx.get('connection')` 取值,
32
+ // 而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 undefined ⇒
33
+ // 空值被闭包固化,此后每次请求都命中 503「宿主鉴权不可用」,宿主就绪也不会自愈。
34
+ // 现在改为**每次请求实时取**:服务晚到也能自愈。
35
+ // 兼容:传的不是函数(旧调用方式/直接给实例)时按常量包裹,行为与旧版一致。
36
+ export function createConsoleHandler(mdcg, config, assets, getConnection) {
37
+ const connectionOf = typeof getConnection === 'function' ? getConnection : () => getConnection
32
38
  const csrf = randomBytes(32).toString('hex');
33
39
  let catalog = null;
34
40
  const tools = async () => catalog ?? (catalog = await mdcg.bridge.listTools());
35
41
  return async (req, res) => {
36
42
  try {
37
43
  const path = new URL(req.url, 'http://localhost').pathname;
38
- if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权不可用' });
44
+ const connection = connectionOf()
45
+ if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权服务尚未就绪,请稍后重试' });
39
46
  const admission = connection.admit(req);
40
47
  if ('rejection' in admission) return reply(res, admission.rejection, { error: admission.rejection === 401 ? '未登录,请返回 DSH 登录' : '请求来源不可信' });
41
48
  if (req.method === 'GET' && assets[path]) {
@@ -88,7 +95,8 @@ export function installConsoleWeb(ctx, config, disposers, mdcg) {
88
95
  '/plugins/lingshu/style.css': [asset('style.css'), 'text/css; charset=utf-8'],
89
96
  '/plugins/lingshu/entry.js': [asset('entry.js'), 'application/javascript; charset=utf-8'],
90
97
  };
91
- const handler = createConsoleHandler(mdcg, config, assets, ctx.get('connection'));
98
+ // issue #699:传**取值函数**(每次请求实时取),不再把挂载瞬间的值闭包固化。
99
+ const handler = createConsoleHandler(mdcg, config, assets, () => ctx.get('connection'));
92
100
  for (const path of ['/lingshu', '/lingshu/', '/plugins/lingshu']) disposers.push(web.register({ kind: path === '/plugins/lingshu' ? 'prefix' : 'exact', path, handler }));
93
101
  disposers.push(web.tapIndex(html => html.includes('data-lingshu-entry') ? html : html.replace('</body>', '<script data-lingshu-entry src="/plugins/lingshu/entry.js"></script></body>')));
94
102
  ctx.logger.info('dsh-memory: 极简灵枢控制台已挂载 /lingshu(复用唯一大脑桥)');
@@ -24,6 +24,12 @@ export interface HookAuditState {
24
24
  };
25
25
  /** 进入消息级处理的 `source.kind` 分布(缺字段/空串/非字符串记 "undefined")。 */
26
26
  kinds: Record<string, number>;
27
+ /** `source` 的**键名集合**分布(issue #695:只记键名,绝不记值)。
28
+ * 为什么需要:`kind` 只说明「以什么形式提交」,不说明「谁提交的」。
29
+ * 外部桥接经 `sessions.prompt()` 注入的控制提示同样以 kind="user" 通过,
30
+ * 只看 kind 无法区分;而**键名集合**(如 `kind` / `form+kind` / `kind+origin`)
31
+ * 能直接回答「这条事件的 source 到底带哪些字段」,是排查来源归因缺口的第一读数。 */
32
+ source_shapes: Record<string, number>;
27
33
  /** 最近 ≤MAX_LAST 条摘要。 */
28
34
  last: HookAuditEntry[];
29
35
  updated_at: string;
@@ -32,6 +38,9 @@ export declare const DEFAULT_HOOK_AUDIT_PATH: string;
32
38
  /** `source.kind` 的规范化取值:非字符串(含缺字段)或空串一律记 "undefined"
33
39
  * (不可辨认即无值——空串与缺字段在排障上同义)。 */
34
40
  export declare function kindOf(source: unknown): string;
41
+ /** `source` 的键名集合(排序后 join '+'):空对象记 "empty",非对象记 "not-object"。
42
+ * 只取 `Object.keys`——**绝不读值**,因此不含任何内容/凭据。 */
43
+ export declare function sourceShapeOf(source: unknown): string;
35
44
  /**
36
45
  * 有界落盘审计记录器(**静默降级**:任何公共方法都不会抛错)。
37
46
  *
@@ -50,6 +59,12 @@ export declare class HookAuditRecorder {
50
59
  filtered(reason: HookFilterReason, kind?: string): void;
51
60
  /** `source.kind` 分布(每条**进入消息级处理**的事件调一次,含被滤与放行)。 */
52
61
  observeKind(kind: string): void;
62
+ /** `source` 的键名集合分布(issue #695):只记**键名**,不记任何值。
63
+ *
64
+ * 与 `observeKind` 的分工:kind 回答「以什么形式提交」,本方法回答「source 带哪些字段」。
65
+ * 两者都不参与写入判定(本模块是诊断面,红线不动)。
66
+ */
67
+ observeSourceShape(source: unknown): void;
53
68
  /** 成功**发起**的写入(按 role;发起后失败另记 skipped.failed)。 */
54
69
  written(role: HookWriteRole): void;
55
70
  /** 跳过写入(脱敏置空 / 认知图未就绪 / 写入失败)。 */
@@ -66,6 +66,16 @@ export function kindOf(source) {
66
66
  const k = source?.kind;
67
67
  return typeof k === 'string' && k.length > 0 ? k : 'undefined';
68
68
  }
69
+ /** `source` 的键名集合(排序后 join '+'):空对象记 "empty",非对象记 "not-object"。
70
+ * 只取 `Object.keys`——**绝不读值**,因此不含任何内容/凭据。 */
71
+ export function sourceShapeOf(source) {
72
+ if (source === null || source === undefined)
73
+ return 'undefined';
74
+ if (typeof source !== 'object')
75
+ return 'not-object';
76
+ const keys = Object.keys(source).sort();
77
+ return keys.length ? keys.join('+') : 'empty';
78
+ }
69
79
  function nowIso() {
70
80
  return new Date().toISOString();
71
81
  }
@@ -77,6 +87,7 @@ function emptyState() {
77
87
  skipped: { sanitized: 0, not_ready: 0, failed: 0 },
78
88
  },
79
89
  kinds: {},
90
+ source_shapes: {},
80
91
  last: [],
81
92
  updated_at: nowIso(),
82
93
  };
@@ -126,6 +137,12 @@ function mergeState(raw) {
126
137
  s.kinds[k] = Math.floor(v);
127
138
  }
128
139
  }
140
+ if (r.source_shapes && typeof r.source_shapes === 'object') {
141
+ for (const [k, v] of Object.entries(r.source_shapes)) {
142
+ if (typeof v === 'number' && Number.isFinite(v) && v > 0)
143
+ s.source_shapes[k] = Math.floor(v);
144
+ }
145
+ }
129
146
  if (Array.isArray(r.last)) {
130
147
  for (const e of r.last) {
131
148
  if (!e || typeof e !== 'object')
@@ -196,6 +213,17 @@ export class HookAuditRecorder {
196
213
  s.kinds[key] = (s.kinds[key] ?? 0) + 1;
197
214
  });
198
215
  }
216
+ /** `source` 的键名集合分布(issue #695):只记**键名**,不记任何值。
217
+ *
218
+ * 与 `observeKind` 的分工:kind 回答「以什么形式提交」,本方法回答「source 带哪些字段」。
219
+ * 两者都不参与写入判定(本模块是诊断面,红线不动)。
220
+ */
221
+ observeSourceShape(source) {
222
+ const shape = sourceShapeOf(source);
223
+ this.#mutate((s) => {
224
+ s.source_shapes[shape] = (s.source_shapes[shape] ?? 0) + 1;
225
+ });
226
+ }
199
227
  /** 成功**发起**的写入(按 role;发起后失败另记 skipped.failed)。 */
200
228
  written(role) {
201
229
  this.#mutate((s) => {
@@ -195,6 +195,26 @@ CURATED_ENTRIES = _table_entries()
195
195
  _ENTRY_CACHE = None
196
196
 
197
197
 
198
+ #: F26-17(2026-10-28):`ast.literal_eval` 解析失败的登记项——**不再是静默回落**。
199
+ #: 形状:[(name, value_repr)],进程内累积;`literal_failures()` 供守卫/诊断读取。
200
+ #: 为什么只做「可观测」而不动 `value_type`:把 `or "str"` 改成按值推断会改变既有条目字段,
201
+ #: 而 `config_registry_guard` 要比对「registry 缺省 == 分区表实际值」,属另一批改动,需单独评估影响面。
202
+ _LITERAL_FAILURES = []
203
+
204
+ #: F26-17 第二条潜在沉默:`value_type` 缺失(会被 `or "str"` 静默回落)。
205
+ _MISSING_VALUE_TYPE = []
206
+
207
+
208
+ def literal_failures():
209
+ """生效条件:返回本进程内 `entry_from_row` 累积的解析失败项副本([(name, value_repr)])。"""
210
+ return list(_LITERAL_FAILURES)
211
+
212
+
213
+ def missing_value_types():
214
+ """生效条件:返回 `value_type` 缺失(会被回落成 str)的登记项副本。"""
215
+ return list(_MISSING_VALUE_TYPE)
216
+
217
+
198
218
  def entry_from_row(row, fields=None):
199
219
  """生成件的元组行 → 条目 dict(字段序 = `config_registry_bulk.ROW_FIELDS`)。"""
200
220
  fields = fields or _bulk.ROW_FIELDS
@@ -204,7 +224,15 @@ def entry_from_row(row, fields=None):
204
224
  try:
205
225
  val = ast.literal_eval(d["value_repr"])
206
226
  except Exception:
227
+ # 保持既有行为(值原样保留、value_type 仍回落 str),但**留痕**:
228
+ # 此前这里完全静默,「登记值写错了字面量」在 registry 里看不出来。
207
229
  val = d["value_repr"]
230
+ _LITERAL_FAILURES.append((d.get("name"), d.get("value_repr")))
231
+ _vt = d.get("value_type")
232
+ if not _vt:
233
+ # F26-17 第二条潜在沉默:`value_type` 缺失时下面会回落成 "str",
234
+ # 于是一个**数值型**登记会被静默当成字符串(当前数据里 0 命中,属防御性留痕)。
235
+ _MISSING_VALUE_TYPE.append((d.get("name"), d.get("value_repr")))
208
236
  files = None
209
237
  if d.get("kind") == "env" and d.get("anchor_file"):
210
238
  files = [f for f in d["anchor_file"].split(";") if f]
package/md_cg/mdcg.py CHANGED
@@ -5601,8 +5601,16 @@ class MdCG:
5601
5601
  # issue #637(2026-10-23):T3_global_scan 是「全量兜底、无词法闸」的出口——
5602
5602
  # 只要有一个折叠后 bigram 重合就会进候选,其中大量条目 score=0.0(零相关)。
5603
5603
  # 这些条目此前随 k 截断混入返回集,调用方(自动召回注入)无法区分
5604
- # 「有相关记忆」与「库里有字就回」。T3 出口按**分数>0** 裁切:
5605
- # 零分条目既不出现在结果里,也不再占用 k 配额。
5604
+ # 「有相关记忆」与「库里有字就回」。
5605
+ #
5606
+ # **裁切条件(F26-13 更正,2026-10-28)**:本函数**默认不裁**——T3 仍按 k 预算返回。
5607
+ # 这是刻意的取舍,不是漏实现:S1b/S7 的「回退含异桶节点」契约**依赖**
5608
+ # 「默认可返回零分填充」。实证:按「无条件按真命中数封顶」改过一版,
5609
+ # `test_retr_s1b` 与 `test_retr_s7` **立即转红**(2026-10-28 实测),故回退。
5610
+ # 真正的零分裁切点在**下游** `search` 的门槛过滤(`_min_score`,见本文件
5611
+ # `scored = [_p for _p in scored if _p[1] >= _min_score]`):
5612
+ # 设 `MDCG_MIN_SCORE>0` 后零分条目不进结果、也不占 k 配额(默认 -1 = 不过滤)。
5613
+ # 原注释的「T3 出口按分数>0 裁切」措辞过强,易被读成无条件裁切。
5606
5614
  # 边界:只作用于 T3;T2 里被 S5 降到 0 的真候选、reach 图扩散邻居(#89② 收窄
5607
5615
  # 保护的两种形态)不受影响——它们是「有信号但被降权」,与 T3 的「本来就没信号」不同。
5608
5616
  return self._primary_slots(k, n_neg)
@@ -0,0 +1,90 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:配置登记「潜在静默回落」的可观测性守卫(F26-17 主体·前半)
3
+ # 生效条件:python -X utf8 -m md_cg.test_config_registry_silent_fallback;被测面=config_registry.entry_from_row 的两条回落路径(literal_eval 失败 / value_type 缺失)
4
+ # 子功能:①当前数据基线(两处均 0 命中,说明是防御性缺口而非活跃缺陷)②literal_eval 失败必须被 literal_failures() 记到 ③value_type 缺失必须被 missing_value_types() 记到 ④两者都**不得改变既有行为**(值原样保留、value_type 仍回落 str)
5
+ # 执行:直接构造 ROW_FIELDS 元组喂 entry_from_row,断言留痕 + 断言行为不变
6
+ # 验证方式:全部 PASS exit 0,否则 exit 1
7
+ # 不适用条件:不判 value_type 应当推断成什么(那是下一步「按值推断」,会动 427 条登记、需单独评估对 config_registry_guard 的影响)
8
+ """F26-17 前半:把「潜在静默」变成可观测,且不改变任何既有行为。
9
+
10
+ 病灶(`md_cg/config_registry.py::entry_from_row`):
11
+ · `val = ast.literal_eval(d["value_repr"])` 失败时**原样保留字符串**,无任何痕迹;
12
+ · `"value_type": d.get("value_type") or "str"` —— 缺失时静默回落成 str,
13
+ 一个**数值型**登记会被当成字符串。
14
+
15
+ 实测基线:当前 317 条登记里两处都是 **0 命中** ⇒ 属防御性缺口(陷阱存在但未触发),
16
+ 故本轮只加可观测、不改行为;「按值推断 value_type」留作下一步。
17
+ """
18
+ import os
19
+ import sys
20
+
21
+ ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
22
+ sys.path.insert(0, ROOT)
23
+
24
+ from md_cg import config_registry as cr # noqa: E402
25
+ from md_cg.config_registry_bulk import ROW_FIELDS # noqa: E402
26
+
27
+ _PASS, _FAIL = [], []
28
+
29
+
30
+ def ok(cond, msg, detail=""):
31
+ (_PASS if cond else _FAIL).append(msg)
32
+ print((" PASS " if cond else " FAIL ") + msg + ((" <- " + str(detail)) if detail and not cond else ""))
33
+
34
+
35
+ def _row(**over):
36
+ base = {f: "" for f in ROW_FIELDS}
37
+ base.update({"name": "PROBE_X", "face": "TUNE", "layer": "L0", "kind": "const",
38
+ "tunable": False, "value_repr": "1", "value_type": "int",
39
+ "anchor_how": "const_assign", "anchor_file": "x.py",
40
+ "anchor_symbol": "X", "status": "uncalibrated", "evidence": "",
41
+ "since": "test", "notes": ""})
42
+ base.update(over)
43
+ return tuple(base[f] for f in ROW_FIELDS)
44
+
45
+
46
+ def main():
47
+ print("== A 当前数据基线(防御性缺口:陷阱在、未触发)")
48
+ rows = cr.entries()
49
+ ok(len(rows) > 200, "A1 registry 条目数正常(>200)", len(rows))
50
+ ok(cr.literal_failures() == [],
51
+ "A2 当前无 literal_eval 失败项", cr.literal_failures()[:3])
52
+ ok(cr.missing_value_types() == [],
53
+ "A3 当前无 value_type 缺失项", cr.missing_value_types()[:3])
54
+ ok(all(r.get("value_type") for r in rows), "A4 无条目 value_type 为空")
55
+
56
+ print("== B literal_eval 失败必须留痕(判别力自证)")
57
+ before = len(cr.literal_failures())
58
+ e = cr.entry_from_row(_row(name="PROBE_BAD", value_repr="not-a-literal("))
59
+ after = cr.literal_failures()
60
+ ok(len(after) == before + 1, "B1 失败项被记到(+1)", (before, len(after)))
61
+ ok(any(n == "PROBE_BAD" for n, _v in after), "B2 记的是该条名字")
62
+ ok(e["value"] == "not-a-literal(", "B3 **行为不变**:值原样保留", e["value"])
63
+ ok(e["value_type"] == "int", "B4 **行为不变**:value_type 仍取行内声明", e["value_type"])
64
+
65
+ print("== C value_type 缺失必须留痕(判别力自证)")
66
+ before2 = len(cr.missing_value_types())
67
+ e2 = cr.entry_from_row(_row(name="PROBE_NOVT", value_type="", value_repr="42"))
68
+ after2 = cr.missing_value_types()
69
+ ok(len(after2) == before2 + 1, "C1 缺失项被记到(+1)", (before2, len(after2)))
70
+ ok(any(n == "PROBE_NOVT" for n, _v in after2), "C2 记的是该条名字")
71
+ ok(e2["value_type"] == "str", "C3 **行为不变**:仍回落 str(不擅自改成推断值)", e2["value_type"])
72
+ ok(e2["value"] == 42, "C4 值仍被正确解析", e2["value"])
73
+
74
+ print("== D 正常行不得被误记")
75
+ n_lit, n_vt = len(cr.literal_failures()), len(cr.missing_value_types())
76
+ e3 = cr.entry_from_row(_row(name="PROBE_OK", value_repr="[1, 2]", value_type="list"))
77
+ ok(len(cr.literal_failures()) == n_lit, "D1 正常行不进 literal 失败表")
78
+ ok(len(cr.missing_value_types()) == n_vt, "D2 正常行不进 value_type 缺失表")
79
+ ok(e3["value"] == [1, 2] and e3["value_type"] == "list", "D3 正常行字段正确")
80
+
81
+ print()
82
+ print("配置登记静默回落守卫:%d 通过 / %d 失败" % (len(_PASS), len(_FAIL)))
83
+ if _FAIL:
84
+ for f in _FAIL:
85
+ print(" -", f)
86
+ return 0 if not _FAIL else 1
87
+
88
+
89
+ if __name__ == "__main__":
90
+ raise SystemExit(main())
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@furongjun1999/dsh-memory",
3
- "version": "0.9.15",
3
+ "version": "0.9.16",
4
4
  "description": "灵枢(Lingshu·líng shū)DeepSeek Harness 插件:完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH,对话自动沉淀进 md_cg 认知图(md 文档)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
package/src/hooks.ts CHANGED
@@ -972,6 +972,11 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
972
972
  // 落盘审计(issue #56):source.kind 分布——先于两级判据记录**完整**输入分布
973
973
  // (含被滤与放行),「宿主到底给这条消息标了什么 kind」是排障第一问。
974
974
  audit.observeKind(kindOf(event.data.source))
975
+ // issue #695 诊断面:记录 source 的**键名集合**(不含任何值)。
976
+ // kind 只说「以什么形式提交」,键名集合才能回答「source 带哪些字段」——
977
+ // 外部桥接经 sessions.prompt() 注入的控制提示同样走 kind="user",
978
+ // 靠这一维才有可核验的盘面读数(绝不记内容)。
979
+ audit.observeSourceShape(event.data.source)
975
980
  // H1 **消息级**判据:委派/中继消息(`form: 'relay'` 语义=「另一个 agent
976
981
  // 发给本 agent 的消息」)不写。先于 kind 判据,理由见 isRelayedMessage 注释。
977
982
  if (isRelayedMessage(event.data.source)) {
@@ -28,14 +28,21 @@ async function readBody(req) {
28
28
  try { return JSON.parse(Buffer.concat(chunks).toString('utf8')); }
29
29
  catch { throw Object.assign(new Error('请求必须是有效 JSON'), { status: 400 }); }
30
30
  }
31
- export function createConsoleHandler(mdcg, config, assets, connection) {
31
+ // issue #699(2026-10-28):第 4 参改为**取值函数**。原实现由挂载点 `ctx.get('connection')` 取值,
32
+ // 而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 undefined ⇒
33
+ // 空值被闭包固化,此后每次请求都命中 503「宿主鉴权不可用」,宿主就绪也不会自愈。
34
+ // 现在改为**每次请求实时取**:服务晚到也能自愈。
35
+ // 兼容:传的不是函数(旧调用方式/直接给实例)时按常量包裹,行为与旧版一致。
36
+ export function createConsoleHandler(mdcg, config, assets, getConnection) {
37
+ const connectionOf = typeof getConnection === 'function' ? getConnection : () => getConnection
32
38
  const csrf = randomBytes(32).toString('hex');
33
39
  let catalog = null;
34
40
  const tools = async () => catalog ?? (catalog = await mdcg.bridge.listTools());
35
41
  return async (req, res) => {
36
42
  try {
37
43
  const path = new URL(req.url, 'http://localhost').pathname;
38
- if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权不可用' });
44
+ const connection = connectionOf()
45
+ if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权服务尚未就绪,请稍后重试' });
39
46
  const admission = connection.admit(req);
40
47
  if ('rejection' in admission) return reply(res, admission.rejection, { error: admission.rejection === 401 ? '未登录,请返回 DSH 登录' : '请求来源不可信' });
41
48
  if (req.method === 'GET' && assets[path]) {
@@ -88,7 +95,8 @@ export function installConsoleWeb(ctx, config, disposers, mdcg) {
88
95
  '/plugins/lingshu/style.css': [asset('style.css'), 'text/css; charset=utf-8'],
89
96
  '/plugins/lingshu/entry.js': [asset('entry.js'), 'application/javascript; charset=utf-8'],
90
97
  };
91
- const handler = createConsoleHandler(mdcg, config, assets, ctx.get('connection'));
98
+ // issue #699:传**取值函数**(每次请求实时取),不再把挂载瞬间的值闭包固化。
99
+ const handler = createConsoleHandler(mdcg, config, assets, () => ctx.get('connection'));
92
100
  for (const path of ['/lingshu', '/lingshu/', '/plugins/lingshu']) disposers.push(web.register({ kind: path === '/plugins/lingshu' ? 'prefix' : 'exact', path, handler }));
93
101
  disposers.push(web.tapIndex(html => html.includes('data-lingshu-entry') ? html : html.replace('</body>', '<script data-lingshu-entry src="/plugins/lingshu/entry.js"></script></body>')));
94
102
  ctx.logger.info('dsh-memory: 极简灵枢控制台已挂载 /lingshu(复用唯一大脑桥)');
@@ -67,6 +67,12 @@ export interface HookAuditState {
67
67
  }
68
68
  /** 进入消息级处理的 `source.kind` 分布(缺字段/空串/非字符串记 "undefined")。 */
69
69
  kinds: Record<string, number>
70
+ /** `source` 的**键名集合**分布(issue #695:只记键名,绝不记值)。
71
+ * 为什么需要:`kind` 只说明「以什么形式提交」,不说明「谁提交的」。
72
+ * 外部桥接经 `sessions.prompt()` 注入的控制提示同样以 kind="user" 通过,
73
+ * 只看 kind 无法区分;而**键名集合**(如 `kind` / `form+kind` / `kind+origin`)
74
+ * 能直接回答「这条事件的 source 到底带哪些字段」,是排查来源归因缺口的第一读数。 */
75
+ source_shapes: Record<string, number>
70
76
  /** 最近 ≤MAX_LAST 条摘要。 */
71
77
  last: HookAuditEntry[]
72
78
  updated_at: string
@@ -105,6 +111,15 @@ export function kindOf(source: unknown): string {
105
111
  return typeof k === 'string' && k.length > 0 ? k : 'undefined'
106
112
  }
107
113
 
114
+ /** `source` 的键名集合(排序后 join '+'):空对象记 "empty",非对象记 "not-object"。
115
+ * 只取 `Object.keys`——**绝不读值**,因此不含任何内容/凭据。 */
116
+ export function sourceShapeOf(source: unknown): string {
117
+ if (source === null || source === undefined) return 'undefined'
118
+ if (typeof source !== 'object') return 'not-object'
119
+ const keys = Object.keys(source as Record<string, unknown>).sort()
120
+ return keys.length ? keys.join('+') : 'empty'
121
+ }
122
+
108
123
  function nowIso(): string {
109
124
  return new Date().toISOString()
110
125
  }
@@ -117,6 +132,7 @@ function emptyState(): HookAuditState {
117
132
  skipped: { sanitized: 0, not_ready: 0, failed: 0 },
118
133
  },
119
134
  kinds: {},
135
+ source_shapes: {},
120
136
  last: [],
121
137
  updated_at: nowIso(),
122
138
  }
@@ -144,7 +160,7 @@ function sumCounts(bucket: unknown, keys: readonly string[]): number | null {
144
160
  function mergeState(raw: unknown): HookAuditState {
145
161
  const s = emptyState()
146
162
  if (!raw || typeof raw !== 'object') return s
147
- const r = raw as { counts?: unknown; kinds?: unknown; last?: unknown }
163
+ const r = raw as { counts?: unknown; kinds?: unknown; source_shapes?: unknown; last?: unknown }
148
164
  if (r.counts && typeof r.counts === 'object') {
149
165
  const c = r.counts as { filtered?: unknown; written?: unknown; skipped?: unknown }
150
166
  const buckets: Array<[Record<string, number>, string[], unknown]> = [
@@ -162,6 +178,11 @@ function mergeState(raw: unknown): HookAuditState {
162
178
  if (typeof v === 'number' && Number.isFinite(v) && v > 0) s.kinds[k] = Math.floor(v)
163
179
  }
164
180
  }
181
+ if (r.source_shapes && typeof r.source_shapes === 'object') {
182
+ for (const [k, v] of Object.entries(r.source_shapes as Record<string, unknown>)) {
183
+ if (typeof v === 'number' && Number.isFinite(v) && v > 0) s.source_shapes[k] = Math.floor(v)
184
+ }
185
+ }
165
186
  if (Array.isArray(r.last)) {
166
187
  for (const e of r.last) {
167
188
  if (!e || typeof e !== 'object') continue
@@ -230,6 +251,18 @@ export class HookAuditRecorder {
230
251
  })
231
252
  }
232
253
 
254
+ /** `source` 的键名集合分布(issue #695):只记**键名**,不记任何值。
255
+ *
256
+ * 与 `observeKind` 的分工:kind 回答「以什么形式提交」,本方法回答「source 带哪些字段」。
257
+ * 两者都不参与写入判定(本模块是诊断面,红线不动)。
258
+ */
259
+ observeSourceShape(source: unknown): void {
260
+ const shape = sourceShapeOf(source)
261
+ this.#mutate((s) => {
262
+ s.source_shapes[shape] = (s.source_shapes[shape] ?? 0) + 1
263
+ })
264
+ }
265
+
233
266
  /** 成功**发起**的写入(按 role;发起后失败另记 skipped.failed)。 */
234
267
  written(role: HookWriteRole): void {
235
268
  this.#mutate((s) => {
@@ -27,11 +27,11 @@
27
27
  },
28
28
  {
29
29
  "path": "src/lib/console_web.mjs",
30
- "sha256": "9CF53424EBE0477002B507D1FDE065A1634CE3ACB50E6AAE69995F6D5CB42FCC"
30
+ "sha256": "9C8F8450571729688033033F35345B18E9EEB68B871E3A4C53A9B619F28AA61E"
31
31
  },
32
32
  {
33
33
  "path": "lib/lib/console_web.mjs",
34
- "sha256": "9CF53424EBE0477002B507D1FDE065A1634CE3ACB50E6AAE69995F6D5CB42FCC"
34
+ "sha256": "9C8F8450571729688033033F35345B18E9EEB68B871E3A4C53A9B619F28AA61E"
35
35
  },
36
36
  {
37
37
  "path": "lib/client.js",
@@ -28,14 +28,21 @@ async function readBody(req) {
28
28
  try { return JSON.parse(Buffer.concat(chunks).toString('utf8')); }
29
29
  catch { throw Object.assign(new Error('请求必须是有效 JSON'), { status: 400 }); }
30
30
  }
31
- export function createConsoleHandler(mdcg, config, assets, connection) {
31
+ // issue #699(2026-10-28):第 4 参改为**取值函数**。原实现由挂载点 `ctx.get('connection')` 取值,
32
+ // 而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 undefined ⇒
33
+ // 空值被闭包固化,此后每次请求都命中 503「宿主鉴权不可用」,宿主就绪也不会自愈。
34
+ // 现在改为**每次请求实时取**:服务晚到也能自愈。
35
+ // 兼容:传的不是函数(旧调用方式/直接给实例)时按常量包裹,行为与旧版一致。
36
+ export function createConsoleHandler(mdcg, config, assets, getConnection) {
37
+ const connectionOf = typeof getConnection === 'function' ? getConnection : () => getConnection
32
38
  const csrf = randomBytes(32).toString('hex');
33
39
  let catalog = null;
34
40
  const tools = async () => catalog ?? (catalog = await mdcg.bridge.listTools());
35
41
  return async (req, res) => {
36
42
  try {
37
43
  const path = new URL(req.url, 'http://localhost').pathname;
38
- if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权不可用' });
44
+ const connection = connectionOf()
45
+ if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权服务尚未就绪,请稍后重试' });
39
46
  const admission = connection.admit(req);
40
47
  if ('rejection' in admission) return reply(res, admission.rejection, { error: admission.rejection === 401 ? '未登录,请返回 DSH 登录' : '请求来源不可信' });
41
48
  if (req.method === 'GET' && assets[path]) {
@@ -88,7 +95,8 @@ export function installConsoleWeb(ctx, config, disposers, mdcg) {
88
95
  '/plugins/lingshu/style.css': [asset('style.css'), 'text/css; charset=utf-8'],
89
96
  '/plugins/lingshu/entry.js': [asset('entry.js'), 'application/javascript; charset=utf-8'],
90
97
  };
91
- const handler = createConsoleHandler(mdcg, config, assets, ctx.get('connection'));
98
+ // issue #699:传**取值函数**(每次请求实时取),不再把挂载瞬间的值闭包固化。
99
+ const handler = createConsoleHandler(mdcg, config, assets, () => ctx.get('connection'));
92
100
  for (const path of ['/lingshu', '/lingshu/', '/plugins/lingshu']) disposers.push(web.register({ kind: path === '/plugins/lingshu' ? 'prefix' : 'exact', path, handler }));
93
101
  disposers.push(web.tapIndex(html => html.includes('data-lingshu-entry') ? html : html.replace('</body>', '<script data-lingshu-entry src="/plugins/lingshu/entry.js"></script></body>')));
94
102
  ctx.logger.info('dsh-memory: 极简灵枢控制台已挂载 /lingshu(复用唯一大脑桥)');
@@ -28,14 +28,21 @@ async function readBody(req) {
28
28
  try { return JSON.parse(Buffer.concat(chunks).toString('utf8')); }
29
29
  catch { throw Object.assign(new Error('请求必须是有效 JSON'), { status: 400 }); }
30
30
  }
31
- export function createConsoleHandler(mdcg, config, assets, connection) {
31
+ // issue #699(2026-10-28):第 4 参改为**取值函数**。原实现由挂载点 `ctx.get('connection')` 取值,
32
+ // 而 cordis 的 `Context.get(name, strict=true)` 在服务 fiber 未就绪时返回 undefined ⇒
33
+ // 空值被闭包固化,此后每次请求都命中 503「宿主鉴权不可用」,宿主就绪也不会自愈。
34
+ // 现在改为**每次请求实时取**:服务晚到也能自愈。
35
+ // 兼容:传的不是函数(旧调用方式/直接给实例)时按常量包裹,行为与旧版一致。
36
+ export function createConsoleHandler(mdcg, config, assets, getConnection) {
37
+ const connectionOf = typeof getConnection === 'function' ? getConnection : () => getConnection
32
38
  const csrf = randomBytes(32).toString('hex');
33
39
  let catalog = null;
34
40
  const tools = async () => catalog ?? (catalog = await mdcg.bridge.listTools());
35
41
  return async (req, res) => {
36
42
  try {
37
43
  const path = new URL(req.url, 'http://localhost').pathname;
38
- if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权不可用' });
44
+ const connection = connectionOf()
45
+ if (!connection || typeof connection.admit !== 'function') return reply(res, 503, { error: '宿主鉴权服务尚未就绪,请稍后重试' });
39
46
  const admission = connection.admit(req);
40
47
  if ('rejection' in admission) return reply(res, admission.rejection, { error: admission.rejection === 401 ? '未登录,请返回 DSH 登录' : '请求来源不可信' });
41
48
  if (req.method === 'GET' && assets[path]) {
@@ -88,7 +95,8 @@ export function installConsoleWeb(ctx, config, disposers, mdcg) {
88
95
  '/plugins/lingshu/style.css': [asset('style.css'), 'text/css; charset=utf-8'],
89
96
  '/plugins/lingshu/entry.js': [asset('entry.js'), 'application/javascript; charset=utf-8'],
90
97
  };
91
- const handler = createConsoleHandler(mdcg, config, assets, ctx.get('connection'));
98
+ // issue #699:传**取值函数**(每次请求实时取),不再把挂载瞬间的值闭包固化。
99
+ const handler = createConsoleHandler(mdcg, config, assets, () => ctx.get('connection'));
92
100
  for (const path of ['/lingshu', '/lingshu/', '/plugins/lingshu']) disposers.push(web.register({ kind: path === '/plugins/lingshu' ? 'prefix' : 'exact', path, handler }));
93
101
  disposers.push(web.tapIndex(html => html.includes('data-lingshu-entry') ? html : html.replace('</body>', '<script data-lingshu-entry src="/plugins/lingshu/entry.js"></script></body>')));
94
102
  ctx.logger.info('dsh-memory: 极简灵枢控制台已挂载 /lingshu(复用唯一大脑桥)');