@furongjun1999/dsh-memory 0.9.17 → 0.9.18

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,88 @@
4
4
 
5
5
  格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循语义化版本。
6
6
 
7
+ ## [0.9.18] - 2026-10-30
8
+
9
+ ### ⚠️ BREAKING:注入块格式变更
10
+
11
+ `【本会话近期对话】` 块的行格式改为带**归因前缀**(issue #712 / PR #713):
12
+
13
+ ```
14
+ 旧:[user] 内容
15
+ 新:[10-30 14:23|本|私] [user] 内容
16
+ └──┬──┘ └┬┘ └┬┘
17
+ 时间 会话 密级
18
+ ```
19
+
20
+ | 段 | 取值 |
21
+ |---|---|
22
+ | 时间 | `MM-DD HH:mm`;缺失渲染 `??-?? ??:??` |
23
+ | 会话 | 等于当前会话 → `本`;其他 → `会话<后4位>`;缺失 → `?` |
24
+ | 密级 | `private`/`secret` → `私`;`public`/`internal`/`restricted` → `共`;缺失 → `?` |
25
+
26
+ **为什么改**:此前模型只看到 `[role] 内容`,无法判断「这是自己刚说的、还是别的会话说的、是私有还是共有」——
27
+ 实测出现过「把另一个窗口的话当成当前用户刚说的」的误引(#712)。
28
+
29
+ 块总长上限随之 `800 → 900` 字符(前缀约 20 字符/行)。
30
+ **若你有依赖旧格式的解析/断言,请同步。**
31
+
32
+ ### 新增
33
+
34
+ - **`cg(op=info).write_gate`**(#708):分层写入闸的**进程内计数**——`{mode, total, by_layer, recent, hint}`。
35
+ 此前 `warn` 档只写子进程 stderr,而 DSH 不转发 ⇒ 观察期等于没有。
36
+ 现在不依赖 stderr 转发、不写盘;`recent` 只留 `layer/tier/reason`(**无内容、无节点 id**),有界 20 条。
37
+ 计数**重启归零**,建议观察一个完整工作日再决定是否切 `enforce`。
38
+ - **`Principal.sessions_read`**(#712 / 方案 C 分档隔离):`None` = 旧行为逐位不变;集合 = 只读这些会话;
39
+ `{"*"}` = 全读。**`can_admin` 不削弱**(issue #35「设计者豁免」定稿)。
40
+ - **事件归因四要素**:`pack["recent"]` 条目现含 `session`/`t`/`id`/`sensitivity`/`actor`/`token_id`/`identity_role`/`parent`。
41
+ 事件新增稳定键 `id`(`re_<ms>_<6hex>`,**归因展示用,不得用于权限判定或去重定位**)。
42
+ - **理论文档**:《身份与人格:职业身份的可变性 vs 人格的一致性》
43
+ (`docs/theory/身份与人格_职业身份可变性与人格一致性_v0.1.md`)——
44
+ 区分**人格**(跨会话恒定,`self`/`anchor` 层)与**职业身份**(会话级,工作层 + 事件归因)。
45
+
46
+ ### 修复
47
+
48
+ - **`enforce` 档下裁决审计节点被同一闸挡住**(#708 ② / #709):`_write_review_record` 写 `structural`(2 档),
49
+ 却不传复核单元 ⇒ `decisions.jsonl` 还在、**可复核的 md 审计节点没了**。
50
+ 现在把本次裁决已取得的 `reviewed_by` 一路带进写入。
51
+ - **同一条链上两个更靠前的缺口**(查 #709 时发现):
52
+ - **`propose` 死锁**:候选入 inbox 本不落记忆盘,却按目标层要求复核单元 ⇒
53
+ enforce 下「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需提案 → 提案又要 reflect」。
54
+ 现在 `require_layer_write(..., skip_gate=False)` 新增该参数,**只** `propose` 传 `True`;
55
+ 层白名单与密级检查**照常执行**,`accept` 落盘仍走同一道闸。
56
+ - **`accept` 落业务节点**不传 `reviewed_by` ⇒ 「裁决过了、落盘被拦」。
57
+ - **`reviewed_by` 不再污染 frontmatter**:它是**写入闸的输入参数,不是记忆元数据**。
58
+ 此前用 `kw.get()` 只读不删,会经 `super().add(**kw)` 落进节点 fm(实测 `test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null`)。
59
+ 现在改为 `kw.pop()`。
60
+ - **`actor` 恒为 None**(身份归属空心):`MdCGSecure.remember_event` 里 `tenant`/`session`/`harness`/`unit`/`sensitivity`
61
+ **都从 principal 落值**,唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 `actor` 恒为 None。已补。
62
+ - **取窗顺序 bug ×2**(#712 / #715):`session_recall` 与 `session_compact` 都**先截末 N 条、再按会话过滤**
63
+ ⇒ 多会话并发时本会话消息被挤出窗口,`session="A"` 可能拿到**空 recent**(false-negative,极难被发现)。
64
+ `session_compact` 更重——它会压出「共 0 条事件」并**写入会话节点**(写错一条记忆)。
65
+ 修法:需要收窄时先取全量、再过滤、最后截回。
66
+ - **`session` 为 falsy 时静默退回全局窗口**(#712):现在会在 `degraded` 里加 `recent_global_window`,调用方看得见。
67
+ - **身份块恒为空**(#715):`【灵枢身份锚点】` 复用了**带会话过滤**的 timeline payload,
68
+ 而 `self`/`anchor` 节点的 `session` **恒为 `unattributed`** ⇒ 永久层被全部滤掉 ⇒ **块从不出现且无报错**。
69
+ 现在身份块**独立取数、不带会话过滤**;「最近记忆」块保持会话隔离。
70
+ 这正是理论 R3 的实案:**人格的可见性不该由会话决定**。
71
+ 另加 `else` 分支 `logger.info`——开关开了但无身份节点时显式提示,不再静默。
72
+ - **会话 id 为空时静默退回全局窗口**(PR #714 by LeeRolling):现在 `logger.warn` 一次(不刷屏)。
73
+
74
+ ### 内部
75
+
76
+ - `test/chaos_injection/test_fi_m09_guest_write_denied.py` 的读码锚点从「完整调用串」放宽为「`layer, sens` 两参在位」,
77
+ 并去掉两处硬编码行号。
78
+ - `test_generation_guard.py` 的 `NEW_INFO_KEYS` 登记 `write_gate`。
79
+ - `test_p45_session_identity.py` 的变异锚点同步新形态(**变异语义不变**)。
80
+ - 新增守卫:`test_issue712_session_window_attribution`(29 条,含取窗顺序/四要素/身份三维/分权)、
81
+ `test/issue715`(W715)、`test/issue714`(W714 / W714b)。
82
+
83
+ ### 升级须知
84
+
85
+ - **`--gate` 缺省仍是 `strict`**;`op=info` 只**新增**键;`sessions_read` 缺省 `None` = 旧行为逐位不变。
86
+ - 若你在 #708 / #709 遇到过问题:升级后 `cg(op="info")["write_gate"]` 可看 warn 计数,
87
+ `review accept` 的返回体里 **`record_error` 应为空**。
88
+ - 若你在 #712 / #715 遇到过问题:升级后注入块应带归因前缀,`autoRecallIdentity: true` 时身份块应出现。
7
89
  ## [0.9.17] - 2026-10-28
8
90
 
9
91
  ### 修复
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  ![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)![DSH 适配](https://img.shields.io/badge/DSH-0.2.1--rc.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1)![downloads](https://badgen.net/npm/dt/@furongjun1999/dsh-memory?label=downloads&color=4E9BF1)![Protocol](https://img.shields.io/badge/Protocol-MCP-blue)![Node](https://img.shields.io/badge/Node-%3E%3D22.19-brightgreen)![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
12
12
 
13
- **高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.9.14)**
13
+ **高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.9.17)**
14
14
 
15
15
  📖 **[第三方上手教程](https://znsvdekx.vibedrop.site/)** —— 《灵枢 dsh-memory 初学者上手研究报告》(由第三方独立编写,非本项目官方文档)
16
16
 
@@ -181,7 +181,7 @@ python -m md_cg.tokens verify --token-file-in <令牌文件> # 体检
181
181
  | 写面 | 记录单元 | 追加 `write` |
182
182
  | 裁决面 | 验证单元 | 追加 `verify` |
183
183
 
184
- 写入按层收紧:`contextual` 可直写 → `knowledge` 需反思单元 → `structural` 需反思+验证 → `self`/`anchor` 需人工裁定(`MDCG_WRITE_GATE` 三态:`off`/`warn`/`enforce`)。裁决需**双单元复核且不得自证**(`MDCG_REVIEW_DUAL_CHECK=1`)。
184
+ 写入按层收紧:`contextual` 可直写 → `knowledge` 需反思单元 → `structural` 需反思+验证 → `self`/`anchor` 需人工裁定(`MDCG_WRITE_GATE` 三态:`off`/`warn`/`enforce`)。裁决需**双单元复核且不得自证**(`MDCG_REVIEW_DUAL_CHECK=1`)。`warn` 档判定用 **`cg(op=info).write_gate`** 查(进程内计数,不依赖宿主转发 stderr)——先观察再切 `enforce`。
185
185
  完整规则、开关与报错对照 → [权限与复核模型](docs/ops/权限与复核模型.md)。
186
186
  ## 📚 文档地图
187
187
 
package/lib/hooks.d.ts CHANGED
@@ -177,7 +177,15 @@ export declare function renderIdentityAnchors(payload: unknown): string;
177
177
  * (逐条整放/整弃;最后才 slice 是错的——那会把最新一条切掉半截)。
178
178
  *
179
179
  * 空载荷 / 无 recent 段 / 全空条目 → 返回空串(调用方据此**不 push** 第二块)。 */
180
- export declare function formatSessionWindow(payload: unknown, limit: number): string;
180
+ export interface SessionWindowOptions {
181
+ /** 当前会话 id;提供时用于标注「本会话」还是「其他会话」(不用于过滤——
182
+ * 过滤由服务端 `session_recall` 按 `meta.session` 完成,前端再滤一次
183
+ * 会与服务端判据分裂成两份,本仓已多次栽在这上面)。 */
184
+ session?: string;
185
+ /** 是否渲染归因前缀(默认 true)。设 false 可得旧格式(仅测试/回退用)。 */
186
+ attribution?: boolean;
187
+ }
188
+ export declare function formatSessionWindow(payload: unknown, limit: number, opts?: SessionWindowOptions): string;
181
189
  /** 安装自动记忆钩子(effect 作用域内,随插件卸载自动移除)。
182
190
  * 返回幂等收尾函数,由调用方随插件关闭/更新调用,输出一次审计摘要(#606)。
183
191
  *
package/lib/hooks.js CHANGED
@@ -421,8 +421,12 @@ export function renderIdentityAnchors(payload) {
421
421
  const WINDOW_BUDGET_TOKENS = 600;
422
422
  /** 单条窗口条目预览上限(字符)。 */
423
423
  const WINDOW_ITEM_CHARS = 120;
424
- /** 窗口块总长上限(字符)。 */
425
- const WINDOW_MAX_CHARS = 800;
424
+ /** 窗口块总长上限(字符)。
425
+ *
426
+ * issue #712(2026-10-30):归因前缀(`[MM-DD HH:mm|会话|密级] `,约 20 字符/行)
427
+ * 会占预算,故由 800 上调到 **900**(10 行 × 20 = 200,实测内容量持平)。
428
+ * 该块定位仍是「存在性锚点 / 接续提示」——宁可少注入几条,不挤占宿主上下文。 */
429
+ const WINDOW_MAX_CHARS = 900;
426
430
  /** 单条窗口条目的 role 字段上限(字符,issue #354 [P1-12])。
427
431
  *
428
432
  * 缺陷:`text` 有 120 字上限,`role` 却**完全不限长**——一条 3000 字的恶意
@@ -430,19 +434,7 @@ const WINDOW_MAX_CHARS = 800;
430
434
  * 让下一条正常历史立刻 break,整个窗口被单条记录劫持。
431
435
  * role 只是 `user`/`assistant` 一类的短标签,32 字足够任何合法取值。 */
432
436
  const WINDOW_ROLE_CHARS = 32;
433
- /** 会话窗口载荷 → 注入文本(限幅沿 RECALL 分级渲染的风格:单条 ≤120 字、
434
- * 整块 ≤800 字)。
435
- *
436
- * `cg(op=session, action=recall)` 的 `recent` 段 = `{role, text, t}` 列表,
437
- * 按**新→旧**排列(服务端 `recent_events` 的 newest_first)。渲染取**旧→新**
438
- * (对话流水的自然阅读序),但**裁剪保最新**:先按服务端序(新→旧)逐条
439
- * 试放入上限(放不下就**停在更旧的条目上**,整条不放入),最后整体反转
440
- * ——总长受限时丢掉的是**最旧**条目(近因优先),且**不切条目中间**
441
- * (逐条整放/整弃;最后才 slice 是错的——那会把最新一条切掉半截)。
442
- *
443
- * 空载荷 / 无 recent 段 / 全空条目 → 返回空串(调用方据此**不 push** 第二块)。 */
444
- // issue #563:同上,导出仅为可测。
445
- export function formatSessionWindow(payload, limit) {
437
+ export function formatSessionWindow(payload, limit, opts = {}) {
446
438
  const items = (payload && typeof payload === 'object'
447
439
  && Array.isArray(payload.recent))
448
440
  ? payload.recent
@@ -450,6 +442,37 @@ export function formatSessionWindow(payload, limit) {
450
442
  const rows = [];
451
443
  const max = Math.max(1, Math.floor(limit) || 10);
452
444
  let used = 0;
445
+ const curSid = String(opts.session ?? '').trim();
446
+ const wantAttr = opts.attribution !== false;
447
+ // issue #712(2026-10-30):归因前缀——让模型能区分「本会话/其他会话」「私有/共有」
448
+ // 「刚刚/过去」。库层与注入面已带齐四要素(md_cg/mdcos.py 的 recent 段),此处负责
449
+ // **渲染出来**;不渲染等于模型永远看不到,等于没做(这正是 PR #712 的原病灶)。
450
+ // ⚠️ 本改动**变更输出格式**(BREAKING):原 `[role] text` → `[MM-DD HH:mm|会话|密级] [role] text`。
451
+ // 前缀会占预算,故 WINDOW_MAX_CHARS 同步上调(见该常量注释)。
452
+ const stamp = (t) => {
453
+ const n = Number(t);
454
+ if (!Number.isFinite(n) || n <= 0)
455
+ return '??-?? ??:??';
456
+ const d = new Date(n * 1000);
457
+ const p = (x) => String(x).padStart(2, '0');
458
+ return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
459
+ };
460
+ const sessTag = (s) => {
461
+ const v = String(s ?? '').trim();
462
+ if (!v)
463
+ return '?';
464
+ if (curSid && v === curSid)
465
+ return '本';
466
+ return `会话${v.slice(-4)}`;
467
+ };
468
+ const sensTag = (s) => {
469
+ const v = String(s ?? '').trim().toLowerCase();
470
+ if (v === 'private' || v === 'secret')
471
+ return '私';
472
+ if (v === 'public' || v === 'internal' || v === 'restricted')
473
+ return '共';
474
+ return '?';
475
+ };
453
476
  for (const it of items.slice(0, max)) {
454
477
  // issue #354 [P1-12]:role 与 text 同受单条上限约束——只限 text 时一条超长
455
478
  // role 就能让首行突破整块预算并把后续历史全部挤出(首行 used===0 绕过了
@@ -463,7 +486,10 @@ export function formatSessionWindow(payload, limit) {
463
486
  const body = safe.length > WINDOW_ITEM_CHARS
464
487
  ? safe.slice(0, WINDOW_ITEM_CHARS) + '…'
465
488
  : safe;
466
- const row = `[${role}] ${body}`;
489
+ const attr = wantAttr
490
+ ? `[${stamp(it['t'])}|${sessTag(it['session'])}|${sensTag(it['sensitivity'])}] `
491
+ : '';
492
+ const row = `${attr}[${role}] ${body}`;
467
493
  const next = used === 0 ? row.length : used + 1 + row.length;
468
494
  // issue #354 [P1-12]:单条超预算时不再「首条整放」——超过 WINDOW_MAX_CHARS 的
469
495
  // 行一律不放(截断 body 已在上面做完,理论上不可达,作 fail-closed 兜底)。
@@ -635,6 +661,7 @@ export function installMemoryHooks(ctx, mdcg, opts) {
635
661
  * **逐位等价**(差异窗口「本实例未观测 ∧ 模块单点非空」单实例下不可达;
636
662
  * HMR 重载时新实例回落 '' 属更保守行为)。 */
637
663
  let observedSession = false;
664
+ let warnedEmptySid = false;
638
665
  /** 记忆沉淀(fire-and-forget)。认知图未就绪则跳过并告警(不退回 AEIS)。
639
666
  * `role`=null 表示**读预热**(user-recall)——审计只统计写入路径,
640
667
  * 故读预热不参与 written/skipped 计数(它不写记忆)。 */
@@ -732,6 +759,12 @@ export function installMemoryHooks(ctx, mdcg, opts) {
732
759
  const hostCtx = _ctx;
733
760
  const sid = sessionIdOf(hostCtx?.agent?.session)
734
761
  || (observedSession ? currentSession() : '');
762
+ // 会话 id 为空时后端会退回全局滚动窗口(跨会话串台)。只告警一次,
763
+ // 避免每个 assemble step 刷日志;不改注入内容或数据路径。
764
+ if (!sid && !warnedEmptySid) {
765
+ warnedEmptySid = true;
766
+ ctx.logger.warn('dsh-memory: 会话 id 为空,短期窗口可能退回全局滚动窗口(跨会话串台);请检查 host.agent.session 或会话观测是否可用');
767
+ }
735
768
  // 逢十轮提醒的消费面(#657):不受 autoRecall 门控。
736
769
  if (sid) {
737
770
  const pending = pendingReminder.get(sid);
@@ -760,7 +793,24 @@ export function installMemoryHooks(ctx, mdcg, opts) {
760
793
  // (提醒消费已在门控外做掉,见上;此处不再重复——重复块是 #657 修复的残留。)
761
794
  // 非永久层 → 既有「最近记忆」块;self/anchor → 独立「身份锚点」块(独立预算)。
762
795
  const identityOn = opts.autoRecallIdentity === true;
763
- const timelinePayload = await graph.timeline(identityOn ? recallLimit + IDENTITY_MAX_ITEMS : recallLimit, sid ? { session: sid } : {});
796
+ const timelinePayload = await graph.timeline(recallLimit, sid ? { session: sid } : {});
797
+ // issue #715(2026-10-30 外部报告,逐行复现):**身份块必须单独取数**。
798
+ //
799
+ // 病灶:此前身份块复用上面这份**带会话过滤**的 payload(还把 limit 加 3 试图
800
+ // 「多取 3 条」),但 `self`/`anchor` 节点的 `session` **恒为 `unattributed`**
801
+ // ——身份锚点在语义上就注定跨会话(`identity` 写入不带 session_id 时即如此,
802
+ // 状态卡与关系节点同理)。两者叠加 ⇒ 永久层被会话过滤全部滤掉 ⇒
803
+ // `renderIdentityAnchors` 拿到空集 ⇒ **块从不出现且无任何报错**(静默失效)。
804
+ //
805
+ // 这正是《身份与人格》理论的 R3:**人格的可见性不该由会话决定**。
806
+ // 用会话过滤去筛人格节点是**类别错误**,不是参数没调好。
807
+ //
808
+ // 故身份块改为**不带会话过滤**取数(不传 session ⇒ 跨会话视图),
809
+ // 再由 `renderIdentityAnchors` 只挑 self/anchor(其余层照样被它跳过)。
810
+ // 「最近记忆」块保持会话隔离不变——那是工作记忆,本就该跟会话走。
811
+ const identityPayload = identityOn
812
+ ? await graph.timeline(IDENTITY_MAX_ITEMS * 3, {})
813
+ : null;
764
814
  const text = formatTimelineDecayed(timelinePayload);
765
815
  if (text) {
766
816
  // 注入边界转义(issue #16):宿主 system-prompt 对 context 文本做严格
@@ -795,13 +845,21 @@ export function installMemoryHooks(ctx, mdcg, opts) {
795
845
  }
796
846
  if (identityOn) {
797
847
  try {
798
- const idText = renderIdentityAnchors(timelinePayload);
848
+ // issue #715:用**独立取数**的 payload(不带会话过滤),不再复用已滤会话的那份。
849
+ const idText = renderIdentityAnchors(identityPayload);
799
850
  if (idText) {
800
851
  assembly.contexts.push({
801
852
  name: 'lingshu:identity-anchor',
802
853
  text: escapePromptBraces(renderUntrustedMemoryBlock('【灵枢身份锚点】(self/anchor 层,独立预算)\n' + idText)),
803
854
  });
804
855
  }
856
+ else {
857
+ // issue #715(静默失效):此前「开关开了但块从不出现」与「库里确实没有
858
+ // self/anchor 节点」**完全不可分辨**——catch 不触发(没抛错),也没有任何
859
+ // 提示。开着的功能不生效却无声,比报错更难查。故此处显式留痕。
860
+ ctx.logger.info('dsh-memory: autoRecallIdentity 已开启但无可注入的身份节点'
861
+ + '(self/anchor 层为空——请用 cg(op=identity, action=anchor) 建立锚点)');
862
+ }
805
863
  }
806
864
  catch (err) {
807
865
  // issue #128 同款纪律:fail-soft 但不静默——空 catch 会被
@@ -821,7 +879,8 @@ export function installMemoryHooks(ctx, mdcg, opts) {
821
879
  if (cwEnabled) {
822
880
  try {
823
881
  const win = await graph.sessionRecall(sid, cwTurns, WINDOW_BUDGET_TOKENS);
824
- const winText = formatSessionWindow(win, cwTurns);
882
+ // issue #712:传 sid 用于**标注**(本会话/其他会话),不用于过滤。
883
+ const winText = formatSessionWindow(win, cwTurns, { session: sid });
825
884
  if (winText) {
826
885
  // 注入边界同规(文件头硬约束):不可信内容边界 + `{{` 转义,
827
886
  // 都只改注入副本——窗口原文在库内保真。
package/md_cg/mdcg.py CHANGED
@@ -201,6 +201,12 @@ NEG_COVERAGE_MAX = 3
201
201
 
202
202
 
203
203
  # 生效条件:card 为 dict 且 card["negative_coverage"] 为真值时返回 True,否则 False(非 dict 一律 False)。
204
+ # 生效条件:恒返回 6 位十六进制串(sha1(text) 前 6 位)——issue #712 事件稳定键的后半段;
205
+ # 确定性派生(同一 text 恒得同一串),故存量无 id 的事件每次读到同一个 id,不需要写盘。
206
+ def _event_suffix(text) -> str:
207
+ return hashlib.sha1((text or "").encode("utf-8", "replace")).hexdigest()[:6]
208
+
209
+
204
210
  def _is_neg_coverage(card) -> bool:
205
211
  """「该结果条目是负覆盖提示、不是候选答案」的判据单点(H10①③)。
206
212
 
@@ -4158,9 +4164,22 @@ class MdCG:
4158
4164
  window: int = DEFAULT_RECENT_WINDOW):
4159
4165
  """追加一条近期事件(原始、未结构化),并按窗口滚动截断。"""
4160
4166
  check_recent_event(role, text, window)
4161
- rec = {"t": time.time(), "role": role or "user",
4167
+ # issue #712(2026-10-30):事件补**稳定键** `id`——归因展示用(让模型能引用
4168
+ # 「哪一条」),**不是幂等键**:`remember_event` 的语义是事件流 append,用户连说
4169
+ # 两遍同一句话是**两条真实事件**,去重会丢真事件;且 `append_jsonl` 在锁外
4170
+ # (`roll_recent` 才加 FileLock),"读盘判重 + 写"之间有竞态,去重本身无法幂等。
4171
+ # ⇒ 因此:**允许撞键**,且该键**不得**用于权限判定或去重定位。
4172
+ # `t` 先算到变量再拼 id(不要 `time.time()` 调两次,否则 id 与 t 不一致)。
4173
+ _t = time.time()
4174
+ rec = {"t": _t, "role": role or "user",
4162
4175
  "text": text or "", "tags": list(tags or []),
4163
4176
  "meta": dict(meta or {})}
4177
+ rec["id"] = "re_%d_%s" % (int(_t * 1000), _event_suffix(rec["text"]))
4178
+ # issue #712:`actor` 落 **meta.actor**(不加顶层键——顶层形状已被事件对拍守卫
4179
+ # 与 `recent_record_ok` 的口径钉住,加顶层键会波及存量读面)。
4180
+ # 恒保证该键存在(值可为 None=未声明):注入面统一从 meta.actor 取,
4181
+ # 若键时有时无,取值方就得写两套分支(本仓教训:同一判据两份迟早各漏一次)。
4182
+ rec["meta"].setdefault("actor", None)
4164
4183
  append_jsonl(self.recent_log, rec)
4165
4184
  dropped = self.roll_recent(window)
4166
4185
  return {"event": rec, "dropped": dropped}
@@ -4193,6 +4212,12 @@ class MdCG:
4193
4212
  if since is not None:
4194
4213
  recs = [r for r in recs if float(r.get("t") or 0) >= float(since)]
4195
4214
  out = recs[-limit:] if limit else recs
4215
+ # issue #712:读侧为**存量无 id 的行**派生同口径稳定键(确定性派生,不用随机——
4216
+ # 同一条事件每次读到必须得到同一个 id)。**不写盘**:只在返回副本上补,
4217
+ # 盘面 `_recent.jsonl` 保持原样(重写盘面会让存量行形状变化,属重大回归面)。
4218
+ out = [dict(r, id=r.get("id") or "re_%d_%s" % (int(float(r.get("t") or 0) * 1000),
4219
+ _event_suffix(r.get("text") or "")))
4220
+ for r in out]
4196
4221
  return list(reversed(out)) if newest_first else out
4197
4222
 
4198
4223
  # 生效条件:无条件读取全部记录并在 FileLock 下把 recent_log 原子写空,返回被清条数(无记录时为 0);
package/md_cg/mdcos.py CHANGED
@@ -4640,7 +4640,25 @@ class MdCGOS(MdCG):
4640
4640
  pack["degraded"].append("tasks")
4641
4641
  # ③ 近期事件(原始滚动窗口)
4642
4642
  try:
4643
- evs = self.recent_events(limit=max(1, int(recent_limit or 10)))
4643
+ # issue #712(2026-10-30 使用者裁定方案 C):**取窗顺序**修正——需要按会话
4644
+ # 收窄时**先取全量、再过滤、最后截**。修前是先截末 N 条(本行)再由下方
4645
+ # 4656 过滤 ⇒ 多会话并发时本会话消息被别会话挤出窗口,`session="A"` 可能
4646
+ # 拿到**空 recent**(过滤器没错,窗口错了;false-negative,极难被现有测试
4647
+ # 发现)。选 `limit=0`(全量)而非 `recent_limit×K`:① 本函数 ② goals 段
4648
+ # 已是「全量取数 → 过滤 → 截断」形态(`active_goals(limit=None)` 后切
4649
+ # `[:_PACK_ROWS]`),倍数窗会成为本文件里的第二种形态;② 外部会话条数无
4650
+ # 上界,倍数窗只是把失败概率变小;③ `MdCGSecure.recent_events` 内部本就
4651
+ # `super().recent_events(limit=0, …)` 再 `keep[:limit]`,故此处传 0
4652
+ # **不新增读盘量**。
4653
+ _win = max(1, int(recent_limit or 10))
4654
+ _sess_arg = session if (session and str(session).strip() != "*") else None
4655
+ # issue #712 D 项:分档会话读权限。仅当 `sessions_read` 是集合且不含
4656
+ # "*" 时收窄(None = 与历史逐位相同)。can_admin 不在此处特殊处理——
4657
+ # 它按 issue #35 定稿本就全读,本判据只做「减法」。
4658
+ _sr = getattr(getattr(self, "principal", None), "sessions_read", None)
4659
+ _sr_narrow = isinstance(_sr, tuple) and bool(_sr) and "*" not in _sr
4660
+ _narrow = bool(_sess_arg) or _sr_narrow
4661
+ evs = self.recent_events(limit=0 if _narrow else _win)
4644
4662
  # issue #65(外部报告 by ducc239,对 v0.7.5 实测,本 workflow 修前复现):
4645
4663
  # 本段此前**不传会话**,而 `MdCGSecure.recent_events` 无 session 形参
4646
4664
  # (只有 private/secret 档做会话归属判断、默认档全放行)⇒ recent 恒为
@@ -4653,11 +4671,34 @@ class MdCGOS(MdCG):
4653
4671
  # 的 "*" 同款语义);
4654
4672
  # falsy(None/"")→ 退回旧行为(全局窗口,存量调用面零迁移)。
4655
4673
  # `strip()` 防空白包裹的 "*"(" * " 也按汇总处理)。
4656
- if session and str(session).strip() != "*":
4674
+ if _sess_arg:
4657
4675
  evs = [r for r in evs if (r.get("meta") or {}).get("session") == session]
4676
+ if _sr_narrow:
4677
+ evs = [r for r in evs if (r.get("meta") or {}).get("session") in _sr]
4678
+ if _narrow:
4679
+ evs = evs[:_win]
4680
+ if not session:
4681
+ # issue #712 C 项:falsy 会话**不再静默退回全局窗口**——把「你正在读
4682
+ # 全局窗口」放进 degraded,让调用方/工具面看得见(只写日志等于没留痕,
4683
+ # #708 的教训)。
4684
+ pack["degraded"].append("recent_global_window")
4685
+ # issue #712 B 项:注入面恢复**四要素**(会话/时间/身份/id)。
4686
+ # 修前只留 role/text/t,模型因此无法判断「这条是哪个会话说的、私有还是
4687
+ # 共有、谁说的」——「跨窗口串台」的用户侧困惑正源于此。
4688
+ # 取值一律防御式(meta 可能缺失/非 dict),与上一段的既有写法同款。
4658
4689
  pack["recent"] = [{"role": r.get("role"),
4659
4690
  "text": (r.get("text") or "")[:300],
4660
- "t": r.get("t")} for r in evs]
4691
+ "t": r.get("t"),
4692
+ "id": r.get("id"),
4693
+ "session": (r.get("meta") or {}).get("session"),
4694
+ "sensitivity": (r.get("meta") or {}).get("sensitivity"),
4695
+ "actor": (r.get("meta") or {}).get("actor"),
4696
+ # 2026-10-30 理论《身份与人格》:归因三维(编号/职业身份/汇报线)。
4697
+ # 只透出**归因必需**的,不透权限快照(理由见 remember_event 注释)。
4698
+ "token_id": (r.get("meta") or {}).get("token_id"),
4699
+ "identity_role": (r.get("meta") or {}).get("identity_role"),
4700
+ "parent": (r.get("meta") or {}).get("parent")}
4701
+ for r in evs]
4661
4702
  except Exception: # noqa: BLE001
4662
4703
  pack["degraded"].append("recent")
4663
4704
  # ④ 未解问题(驱动主动补全)
@@ -4725,13 +4766,20 @@ class MdCGOS(MdCG):
4725
4766
  零依赖启发式(无嵌入 / 无 LLM):按行去重 + 角色配比 + 截断。
4726
4767
  返回体显式声明 heuristic=True,不冒充语义摘要(语义归纳见 consolidate)。
4727
4768
  """
4769
+ # issue #712(2026-10-30 验证单元复核发现):**与 session_recall 同型的取窗 bug**——
4770
+ # 修前先截末 N 条、后按会话过滤 ⇒ 多会话并发时本会话事件被挤出窗口,
4771
+ # `session_compact(session=A, note=True)` 可能压出「共 0 条事件」并**写入会话节点**
4772
+ # (比 session_recall 更严重:那只是少看到,这会**写错**一条记忆)。
4773
+ # 修法同 session_recall:需要收窄时先取全量、再过滤、最后再截回 limit。
4774
+ _lc = max(1, int(limit or 40))
4775
+ _narrow_c = bool(session)
4728
4776
  try:
4729
- evs = self.recent_events(limit=max(1, int(limit or 40)))
4777
+ evs = self.recent_events(limit=0 if _narrow_c else _lc)
4730
4778
  except Exception: # noqa: BLE001
4731
4779
  evs = []
4732
- if session:
4780
+ if _narrow_c:
4733
4781
  evs = [r for r in evs
4734
- if (r.get("meta") or {}).get("session") == session]
4782
+ if (r.get("meta") or {}).get("session") == session][:_lc]
4735
4783
  roles, seen, points = {}, set(), []
4736
4784
  for r in evs:
4737
4785
  role = r.get("role") or "user"
@@ -6950,6 +6998,24 @@ class MdCGSecure(MdCGOS):
6950
6998
  # 归因不可辨认;且请求声明对事件面静默失效);现与节点/入队同一单点
6951
6999
  # 解析——事件面与写面同口径(显式 meta["session"] 仍不可覆盖)。
6952
7000
  m.setdefault("session", self._attributed_session(sens))
7001
+ # issue #712(2026-10-30 验证单元复核发现):**身份归属此前漏落**——
7002
+ # 同函数里 tenant/session/harness/unit/sensitivity 都从 principal 落值,
7003
+ # 唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 actor 恒为 None,
7004
+ # 「哪些是自己做的、哪些是别人做的」这一要素在库层是空的。
7005
+ # 用 setdefault:调用方显式传 meta["actor"] 时不被覆盖(与上面同款口径)。
7006
+ m.setdefault("actor", self.principal.actor)
7007
+ # 2026-10-30 理论《身份与人格》七要素落地:仅补**归因必需**的三维,
7008
+ # 不给事件加权限快照(clearance/layers_allow/ops_allow 一律不写——权限是
7009
+ # 当前态不是历史事实,固化进事件会造出「假的当时有权」;权限由
7010
+ # sensitivity(数据属性)+ 读取时判据承担)。
7011
+ # · token_id = **编号**(同名不同人可区分)
7012
+ # · identity_role = **职业身份**(干什么;与 role 参数的 user/assistant 不同层,
7013
+ # 故用不同键名,避免与消息角色混淆)
7014
+ # · parent = **汇报线**(有上级时才落)
7015
+ m.setdefault("token_id", getattr(self.principal, "token_id", None))
7016
+ m.setdefault("identity_role", getattr(self.principal, "role", None))
7017
+ if getattr(self.principal, "parent", None):
7018
+ m.setdefault("parent", self.principal.parent)
6953
7019
  if getattr(self.principal, "harness", None):
6954
7020
  m.setdefault("harness", self.principal.harness)
6955
7021
  if getattr(self.principal, "unit", None):
package/md_cg/security.py CHANGED
@@ -134,7 +134,7 @@ class Principal:
134
134
  theory_version —— 当前声明的协议版本(审计与 whoami 用)
135
135
  """
136
136
 
137
- # 生效条件:clearance 须为模块级常量 SENSITIVITY_ORDER 成员(否则 _rank 抛 AccessDenied),session 为假值(含 None/空串)时生成 sess_ 随机串并把 session_auto 置 True(未获声明的进程自动随机;写归因三态收口的识别位,消费方 MdCGSecure._attributed_session),session 真值时原样采用并把 session_auto 置 False(显式声明的来源),expires_at 为假值(含 None/0)时存 None 否则 float(expires_at),layers_allow/ops_allow 为 None 时存 None 否则 tuple 化。
137
+ # 生效条件:clearance 须为模块级常量 SENSITIVITY_ORDER 成员(否则 _rank 抛 AccessDenied),session 为假值(含 None/空串)时生成 sess_ 随机串并把 session_auto 置 True(未获声明的进程自动随机;写归因三态收口的识别位,消费方 MdCGSecure._attributed_session),session 真值时原样采用并把 session_auto 置 False(显式声明的来源),expires_at 为假值(含 None/0)时存 None 否则 float(expires_at),layers_allow/ops_allow 为 None 时存 None 否则 tuple 化;sessions_read 为 None 时存 None(=旧行为,不限制会话读面),为集合(含 list/tuple/set)时 tuple 化并去重(=只允许读这些会话,'*' 表示全部,见 session_recall 的 recent 段)。
138
138
  def __init__(self, tenant: str = "default", actor: str = "system",
139
139
  clearance: str = DEFAULT_SENSITIVITY, can_write: bool = True,
140
140
  can_admin: bool = False, session: str = None,
@@ -142,7 +142,7 @@ class Principal:
142
142
  role: str = None, token_id: str = None, parent: str = None,
143
143
  expires_at: float = None, layers_allow=None, ops_allow=None,
144
144
  auth_mode: str = "direct", theory_ok: bool = True,
145
- theory_version: str = None):
145
+ theory_version: str = None, sessions_read=None):
146
146
  _rank(clearance) # 校验
147
147
  self.tenant = tenant
148
148
  self.actor = actor
@@ -171,6 +171,13 @@ class Principal:
171
171
  self.unit = unit
172
172
  self.role = (role or "system")
173
173
  self.token_id = token_id
174
+ # issue #712(2026-10-30 使用者裁定方案 C):**分档会话读权限**。
175
+ # None = 旧行为逐位不变(internal/public 事件跨会话可见;私有档仍由 _readable 的
176
+ # 既有口径按 principal.session 绑定,本字段不参与);
177
+ # 集合 = 只允许读这些会话('*' 表示全部)——仅在 session_recall 的 recent 段生效;
178
+ # 注意:can_admin 仍可读所有档(issue #35「设计者豁免」定稿),本字段**不削弱**它。
179
+ self.sessions_read = (None if sessions_read is None
180
+ else tuple(dict.fromkeys(str(x) for x in sessions_read)))
174
181
  self.parent = parent
175
182
  self.expires_at = float(expires_at) if expires_at else None
176
183
  self.layers_allow = None if layers_allow is None else tuple(layers_allow)
@@ -0,0 +1,225 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:#712 会话窗口四要素组装 + 分档会话隔离(方案 C)守卫
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue712_session_window_attribution;被测面=remember_event 的 id / recent_events 派生 / session_recall 的取窗顺序与四要素 / Principal.sessions_read
4
+ # 子功能:①事件有稳定键且确定性派生 ②注入面 recent 条目含 session/sensitivity/actor/id 四要素 ③**取窗顺序**:按会话收窄时先取全量再过滤再截(修前会得到空窗口)④falsy 会话进 degraded 不再静默 ⑤sessions_read 仅集合生效、can_admin 不被削弱
5
+ # 执行:临时库造两会话交错事件,按窗口小于本会话消息数的条件断言不空;再验四要素与权限分档
6
+ # 验证方式:全部 PASS exit 0;每条守卫都能独立变红(见各 ok() 的失败面)
7
+ # 不适用条件:不判 hooks.ts 的渲染格式(本批未改渲染);不判 MCP 序列化;不判 DSH 宿主是否转发 stderr
8
+ """#712:会话窗口消息组装(会话·时间·身份·id)+ 分档会话隔离。
9
+
10
+ 病灶(取证见 PR #712 审查):
11
+ ① 事件无 id,模型无法引用「哪一条」;
12
+ ② 注入面条目只留 role/text/t ⇒ 模型不知道「哪个会话说的、私有还是共有、谁说的」;
13
+ ③ **取窗顺序 bug**:先截末 N 条再按会话过滤 ⇒ 多会话并发时本会话消息被挤出窗口,
14
+ session="A" 可能拿到**空 recent**(false-negative,极难被发现);
15
+ ④ session 为 falsy 时静默退回全局窗口,无任何留痕。
16
+ """
17
+ import os
18
+ import shutil
19
+ import sys
20
+ import tempfile
21
+
22
+ ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
23
+ sys.path.insert(0, ROOT)
24
+
25
+ _PASS, _FAIL = [], []
26
+
27
+
28
+ def ok(cond, msg, detail=""):
29
+ (_PASS if cond else _FAIL).append(msg)
30
+ print((" PASS " if cond else " FAIL ") + msg + ((" <- " + str(detail)) if detail and not cond else ""))
31
+
32
+
33
+ def main():
34
+ T = tempfile.mkdtemp(prefix="i712g_")
35
+ try:
36
+ for k in list(os.environ):
37
+ if k.startswith("MDCG_"):
38
+ del os.environ[k]
39
+ os.environ.update(MDCG_ROOT=os.path.join(T, "brain"),
40
+ MDCG_STATE_ROOT=os.path.join(T, "stroot"),
41
+ MDCG_AUX_ROOT=os.path.join(T, "auxroot"),
42
+ MDCG_DATA_ROOT=os.path.join(T, "dataroot"),
43
+ MDCG_EXPORT_ROOT=T, MDCG_SUSTAIN="0", MDCG_SLEEP="0")
44
+ from md_cg.mdcos import MdCGSecure
45
+ from md_cg.security import Principal
46
+ from md_cg.tokens import role_spec
47
+
48
+ sg = role_spec("designer")
49
+ p = Principal(role="designer", clearance="secret", can_write=sg["can_write"],
50
+ can_admin=sg["can_admin"], layers_allow=sg["layers_allow"],
51
+ ops_allow=sg["ops_allow"], session="sessX")
52
+ cg = MdCGSecure(os.path.join(T, "brain"), principal=p, autoflush=1)
53
+
54
+ print("== A 事件稳定键")
55
+ r1 = cg.remember_event("user", "hello A", meta={"session": "sessA"})
56
+ ev = r1.get("event") or {}
57
+ ok(bool(ev.get("id")), "A1 事件带 id", ev.get("id"))
58
+ ok(str(ev.get("id") or "").startswith("re_"), "A2 id 形如 re_<ms>_<hex>", ev.get("id"))
59
+ ok("actor" in (ev.get("meta") or {}), "A3 meta.actor 键存在(值为 None 亦可)", ev.get("meta"))
60
+ ok("actor" not in ev, "A4 **不加**顶层 actor 键(顶层形状不被动)", list(ev)[:8])
61
+ # 确定性:同 t 同 text 派生同 id
62
+ from md_cg.mdcg import _event_suffix
63
+ ok(_event_suffix("abc") == _event_suffix("abc"), "A5 后缀确定性(同一 text 恒同串)")
64
+
65
+ print("== B 取窗顺序(本批核心)")
66
+ # 造交错事件:A 3 条、B 5 条,交替;窗口 recent_limit=3
67
+ cg.remember_event("user", "A-1", meta={"session": "sessA"})
68
+ for i in range(5):
69
+ cg.remember_event("user", "B-%d" % i, meta={"session": "sessB"})
70
+ cg.remember_event("user", "A-2", meta={"session": "sessA"})
71
+ cg.remember_event("user", "A-3", meta={"session": "sessA"})
72
+ pack = cg.session_recall("sessA", limit=1, recent_limit=3)
73
+ rec = pack.get("recent") or []
74
+ ok(len(rec) > 0,
75
+ "B1 session=sessA 且 A 的消息数(3) >= 窗口(3) 时**不空**(修前:先截后滤 ⇒ 可能空)",
76
+ len(rec))
77
+ ok(all((x.get("session") == "sessA") for x in rec),
78
+ "B2 窗口里**只有** sessA 的条目(无跨会话泄漏)",
79
+ [x.get("session") for x in rec][:5])
80
+ # 更极端:A 只有 1 条,且被大量 B 消息夹在中间
81
+ cg2 = MdCGSecure(os.path.join(T, "brain2"), principal=p, autoflush=1)
82
+ for i in range(20):
83
+ cg2.remember_event("user", "Bx-%d" % i, meta={"session": "sessB2"})
84
+ cg2.remember_event("user", "A-only", meta={"session": "sessA2"})
85
+ for i in range(20):
86
+ cg2.remember_event("user", "By-%d" % i, meta={"session": "sessB2"})
87
+ pack2 = cg2.session_recall("sessA2", limit=1, recent_limit=3)
88
+ rec2 = pack2.get("recent") or []
89
+ ok(len(rec2) == 1 and (rec2[0].get("text") or "").startswith("A-only"),
90
+ "B3 **A 仅 1 条且被 40 条 B 夹住**时仍能取到(修前必空——这是核心回归)",
91
+ [(x.get("session"), (x.get("text") or "")[:8]) for x in rec2][:4])
92
+ cg2.close()
93
+
94
+ print("== C 四要素齐备")
95
+ ok(rec, "C0 有条目可查", len(rec))
96
+ if rec:
97
+ keys = set(rec[0].keys())
98
+ ok({"role", "text", "t", "id", "session", "sensitivity", "actor"} <= keys,
99
+ "C1 条目含 role/text/t/id/session/sensitivity/actor", sorted(keys))
100
+ ok(rec[0].get("session") == "sessA", "C2 session 取值正确", rec[0].get("session"))
101
+
102
+ print("== D falsy 会话留痕")
103
+ pack3 = cg.session_recall(None, limit=1, recent_limit=3)
104
+ ok("recent_global_window" in (pack3.get("degraded") or []),
105
+ "D1 session=None 时 degraded 含 recent_global_window(不再静默)",
106
+ pack3.get("degraded"))
107
+ pack4 = cg.session_recall("sessA", limit=1, recent_limit=3)
108
+ ok("recent_global_window" not in (pack4.get("degraded") or []),
109
+ "D2 给了会话则**不**打该标记(不误报)", pack4.get("degraded"))
110
+
111
+ print("== E sessions_read 分档(方案 C)")
112
+ ok(p.sessions_read is None, "E1 缺省 None(旧行为,不限制)", p.sessions_read)
113
+ p_none = Principal(role="designer", clearance="secret", can_write=True,
114
+ can_admin=False, layers_allow=["*"], session="sessX")
115
+ cg3 = MdCGSecure(os.path.join(T, "brain"), principal=p_none, autoflush=1)
116
+ pk = cg3.session_recall("sessA", limit=1, recent_limit=5)
117
+ ok(len(pk.get("recent") or []) > 0, "E2 sessions_read=None 时按参数正常取(旧行为)",
118
+ len(pk.get("recent") or []))
119
+ cg3.close()
120
+ p_nar = Principal(role="designer", clearance="secret", can_write=True,
121
+ can_admin=False, layers_allow=["*"], session="sessX",
122
+ sessions_read=["sessB"])
123
+ cg4 = MdCGSecure(os.path.join(T, "brain"), principal=p_nar, autoflush=1)
124
+ pk4 = cg4.session_recall("sessA", limit=1, recent_limit=10)
125
+ ok(all((x.get("session") == "sessB") for x in (pk4.get("recent") or [])),
126
+ "E3 sessions_read={sessB} 时**读不到** sessA(收紧生效)",
127
+ [x.get("session") for x in (pk4.get("recent") or [])][:5])
128
+ cg4.close()
129
+ p_all = Principal(role="designer", clearance="secret", can_write=True,
130
+ can_admin=False, layers_allow=["*"], session="sessX",
131
+ sessions_read=["*"])
132
+ cg5 = MdCGSecure(os.path.join(T, "brain"), principal=p_all, autoflush=1)
133
+ pk5 = cg5.session_recall("sessA", limit=1, recent_limit=10)
134
+ ok(len(pk5.get("recent") or []) > 0, "E4 sessions_read 为星号时全读(不收窄)",
135
+ len(pk5.get("recent") or []))
136
+ cg5.close()
137
+
138
+ print("== F 窗口上限(验证单元指出的零守卫项)")
139
+ # 若把 `evs = evs[:_win]` 整行删掉(回到「收窄后全量返回」= 另一种回归),
140
+ # 下面是唯一能抓到它的断言:收窄后条数**不得超过** recent_limit。
141
+ cgf = MdCGSecure(os.path.join(T, "brainf"), principal=p, autoflush=1)
142
+ for i in range(15):
143
+ cgf.remember_event("user", "FA-%d" % i, meta={"session": "sessFA"})
144
+ for i in range(15):
145
+ cgf.remember_event("user", "FB-%d" % i, meta={"session": "sessFB"})
146
+ pkf = cgf.session_recall("sessFA", limit=1, recent_limit=4)
147
+ recf = pkf.get("recent") or []
148
+ ok(len(recf) == 4,
149
+ "F1 收窄后**必须截回** recent_limit(删 evs[:_win] 即红:会返回 15 条)", len(recf))
150
+ ok(all((x.get("session") == "sessFA") for x in recf),
151
+ "F2 且全部属于本会话", [x.get("session") for x in recf][:4])
152
+ # 确定性:同一会话连着取两次,id 序列必须一致(读侧派生不得随机)
153
+ a1 = [x.get("id") for x in recf]
154
+ a2 = [x.get("id") for x in (cgf.session_recall("sessFA", limit=1, recent_limit=4).get("recent") or [])]
155
+ ok(a1 == a2, "F3 两次读取的 id 序列一致(派生确定性)", (a1[:2], a2[:2]))
156
+ cgf.close()
157
+
158
+ print("== G session_compact 的同型取窗 bug(验证单元发现)")
159
+ cgc = MdCGSecure(os.path.join(T, "brainc"), principal=p, autoflush=1)
160
+ for i in range(25):
161
+ cgc.remember_event("user", "CB-%d 这是一条足够长的测试消息内容" % i,
162
+ meta={"session": "sessCB"})
163
+ cgc.remember_event("user", "CA-only 本会话唯一的一条足够长的消息内容",
164
+ meta={"session": "sessCA"})
165
+ for i in range(25):
166
+ cgc.remember_event("user", "CC-%d 另一条足够长的测试消息内容" % i,
167
+ meta={"session": "sessCC"})
168
+ cpk = cgc.session_compact(session="sessCA", limit=5)
169
+ ok((cpk.get("events") or 0) >= 1,
170
+ "G1 session_compact 在「本会话仅 1 条、被 50 条夹住」时**不空**",
171
+ cpk.get("events"))
172
+ cgc.close()
173
+
174
+ print("== H 身份归属(actor 不得恒为 None)")
175
+ cgh = MdCGSecure(os.path.join(T, "brainh"), principal=p, autoflush=1)
176
+ cgh.remember_event("user", "谁说的?", meta={"session": "sessH"})
177
+ pkh = cgh.session_recall("sessH", limit=1, recent_limit=3)
178
+ rech = pkh.get("recent") or []
179
+ ok(rech, "H0 有条目", len(rech))
180
+ if rech:
181
+ ok(rech[0].get("actor") is not None,
182
+ "H1 **actor 非 None**(修前恒 None——「谁说的」要素空心)", rech[0].get("actor"))
183
+ ok(rech[0].get("actor") == p.actor or rech[0].get("actor") == "designer",
184
+ "H2 actor 取自 principal.actor", (rech[0].get("actor"), p.actor))
185
+ ok(rech[0].get("sensitivity") is not None,
186
+ "H3 sensitivity 非 None(经安全档写入时必落)", rech[0].get("sensitivity"))
187
+ cgh.close()
188
+
189
+
190
+ print("== I 身份三维(理论《身份与人格》R2 最小归因四元组)")
191
+ cgi = MdCGSecure(os.path.join(T, "braini"), principal=p, autoflush=1)
192
+ cgi.remember_event("user", "身份三维测试", meta={"session": "sessI"})
193
+ pki = cgi.session_recall("sessI", limit=1, recent_limit=3)
194
+ reci = pki.get("recent") or []
195
+ ok(reci, "I0 有条目", len(reci))
196
+ if reci:
197
+ it = reci[0]
198
+ # 编号口径(理论《身份与人格》补注):令牌模式 = token_id;
199
+ # **直连模式(auth_mode=direct)没有令牌**,以 session 代之——
200
+ # 两者至少一个非空即满足「编号」要素。
201
+ _no = it.get("token_id") or it.get("session")
202
+ ok(bool(it.get("session")) and bool(it.get("id"))
203
+ and bool(it.get("actor")) and bool(_no),
204
+ "I1 **最小归因四元组齐**(会话/编号/名字/id;直连模式以 session 作编号)",
205
+ (it.get("session"), it.get("id"), it.get("actor"), _no))
206
+ ok(it.get("identity_role") is not None,
207
+ "I2 identity_role 非 None(职业身份)", it.get("identity_role"))
208
+ ok("clearance" not in it and "ops_allow" not in it and "layers_allow" not in it,
209
+ "I3 **不含权限快照**(理论第 7 条:权限不写入事件)", sorted(it.keys()))
210
+ cgi.close()
211
+
212
+ cg.close()
213
+ finally:
214
+ shutil.rmtree(T, ignore_errors=True)
215
+
216
+ print()
217
+ print("#712 守卫:%d 通过 / %d 失败" % (len(_PASS), len(_FAIL)))
218
+ if _FAIL:
219
+ for f in _FAIL:
220
+ print(" -", f)
221
+ return 0 if not _FAIL else 1
222
+
223
+
224
+ if __name__ == "__main__":
225
+ raise SystemExit(main())
@@ -357,10 +357,12 @@ def _r65_group():
357
357
  # 每条变异声明**期望转红的断言项**;实跑红项与期望必须**恰好相等**——多红=断言语义
358
358
  # 纠缠,少红=该判据空转(本仓教训:test_neg_condition_hits 的「整条命中档」曾 31 条
359
359
  # 断言全绿而分支已删)。锚点漂移(命中次数 ≠1)→ ANCHOR-MISS + 退出码 2(fail-closed)。
360
+ # issue #712(2026-10-30):会话过滤改为「先算 _sess_arg、再具名判定」,锚点随之更新。
361
+ # **变异语义不变**:删掉 if _sess_arg 与其过滤体 ⇒ recent 回到全进程窗口。
360
362
  _R65_A_BLOCK = (
361
- ' if session and str(session).strip() != "*":\n'
363
+ ' if _sess_arg:\n'
362
364
  ' evs = [r for r in evs if (r.get("meta") or {}).get("session") == session]\n')
363
- _R65_A_COND = 'if session and str(session).strip() != "*":'
365
+ _R65_A_COND = '_sess_arg = session if (session and str(session).strip() != "*") else None'
364
366
  _R65_A_STRIP = 'str(session).strip() != "*"'
365
367
  _R65_A_FILTER = ('evs = [r for r in evs '
366
368
  'if (r.get("meta") or {}).get("session") == session]')
@@ -370,7 +372,7 @@ _R65_ANCHORS = (_R65_A_BLOCK, _R65_A_COND, _R65_A_STRIP, _R65_A_FILTER, _R65_A_D
370
372
  _R65_MUTATIONS = (
371
373
  ("①删整段会话过滤(recent 回到全进程窗口)", _R65_A_BLOCK, "",
372
374
  {"R65.1", "R65.2", "R65.3", "R65.6a", "R65.9"}),
373
- ("②删 \"*\" 例外(星号也过滤)", _R65_A_COND, "if session:",
375
+ ("②删 \"*\" 例外(星号也过滤)", _R65_A_COND, "_sess_arg = session if session else None",
374
376
  {"R65.4a", "R65.4b"}),
375
377
  ("③去 strip(\" * \" 不再按汇总处理)", _R65_A_STRIP, 'str(session) != "*"',
376
378
  {"R65.4b"}),
@@ -464,4 +466,4 @@ def _r65_self_proof():
464
466
 
465
467
  if __name__ == "__main__":
466
468
  _rc = main()
467
- sys.exit(_rc if _rc in (0, 2) else 1)
469
+ sys.exit(_rc if _rc in (0, 2) else 1)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@furongjun1999/dsh-memory",
3
- "version": "0.9.17",
3
+ "version": "0.9.18",
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
@@ -493,8 +493,12 @@ export function renderIdentityAnchors(payload: unknown): string {
493
493
  const WINDOW_BUDGET_TOKENS = 600
494
494
  /** 单条窗口条目预览上限(字符)。 */
495
495
  const WINDOW_ITEM_CHARS = 120
496
- /** 窗口块总长上限(字符)。 */
497
- const WINDOW_MAX_CHARS = 800
496
+ /** 窗口块总长上限(字符)。
497
+ *
498
+ * issue #712(2026-10-30):归因前缀(`[MM-DD HH:mm|会话|密级] `,约 20 字符/行)
499
+ * 会占预算,故由 800 上调到 **900**(10 行 × 20 = 200,实测内容量持平)。
500
+ * 该块定位仍是「存在性锚点 / 接续提示」——宁可少注入几条,不挤占宿主上下文。 */
501
+ const WINDOW_MAX_CHARS = 900
498
502
  /** 单条窗口条目的 role 字段上限(字符,issue #354 [P1-12])。
499
503
  *
500
504
  * 缺陷:`text` 有 120 字上限,`role` 却**完全不限长**——一条 3000 字的恶意
@@ -515,7 +519,18 @@ const WINDOW_ROLE_CHARS = 32
515
519
  *
516
520
  * 空载荷 / 无 recent 段 / 全空条目 → 返回空串(调用方据此**不 push** 第二块)。 */
517
521
  // issue #563:同上,导出仅为可测。
518
- export function formatSessionWindow(payload: unknown, limit: number): string {
522
+ export interface SessionWindowOptions {
523
+ /** 当前会话 id;提供时用于标注「本会话」还是「其他会话」(不用于过滤——
524
+ * 过滤由服务端 `session_recall` 按 `meta.session` 完成,前端再滤一次
525
+ * 会与服务端判据分裂成两份,本仓已多次栽在这上面)。 */
526
+ session?: string
527
+ /** 是否渲染归因前缀(默认 true)。设 false 可得旧格式(仅测试/回退用)。 */
528
+ attribution?: boolean
529
+ }
530
+
531
+ export function formatSessionWindow(
532
+ payload: unknown, limit: number, opts: SessionWindowOptions = {},
533
+ ): string {
519
534
  const items = (payload && typeof payload === 'object'
520
535
  && Array.isArray((payload as { recent?: unknown }).recent))
521
536
  ? (payload as { recent: Array<Record<string, unknown>> }).recent
@@ -523,6 +538,32 @@ export function formatSessionWindow(payload: unknown, limit: number): string {
523
538
  const rows: string[] = []
524
539
  const max = Math.max(1, Math.floor(limit) || 10)
525
540
  let used = 0
541
+ const curSid = String(opts.session ?? '').trim()
542
+ const wantAttr = opts.attribution !== false
543
+ // issue #712(2026-10-30):归因前缀——让模型能区分「本会话/其他会话」「私有/共有」
544
+ // 「刚刚/过去」。库层与注入面已带齐四要素(md_cg/mdcos.py 的 recent 段),此处负责
545
+ // **渲染出来**;不渲染等于模型永远看不到,等于没做(这正是 PR #712 的原病灶)。
546
+ // ⚠️ 本改动**变更输出格式**(BREAKING):原 `[role] text` → `[MM-DD HH:mm|会话|密级] [role] text`。
547
+ // 前缀会占预算,故 WINDOW_MAX_CHARS 同步上调(见该常量注释)。
548
+ const stamp = (t: unknown): string => {
549
+ const n = Number(t)
550
+ if (!Number.isFinite(n) || n <= 0) return '??-?? ??:??'
551
+ const d = new Date(n * 1000)
552
+ const p = (x: number): string => String(x).padStart(2, '0')
553
+ return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
554
+ }
555
+ const sessTag = (s: unknown): string => {
556
+ const v = String(s ?? '').trim()
557
+ if (!v) return '?'
558
+ if (curSid && v === curSid) return '本'
559
+ return `会话${v.slice(-4)}`
560
+ }
561
+ const sensTag = (s: unknown): string => {
562
+ const v = String(s ?? '').trim().toLowerCase()
563
+ if (v === 'private' || v === 'secret') return '私'
564
+ if (v === 'public' || v === 'internal' || v === 'restricted') return '共'
565
+ return '?'
566
+ }
526
567
  for (const it of items.slice(0, max)) {
527
568
  // issue #354 [P1-12]:role 与 text 同受单条上限约束——只限 text 时一条超长
528
569
  // role 就能让首行突破整块预算并把后续历史全部挤出(首行 used===0 绕过了
@@ -535,7 +576,10 @@ export function formatSessionWindow(payload: unknown, limit: number): string {
535
576
  const body = safe.length > WINDOW_ITEM_CHARS
536
577
  ? safe.slice(0, WINDOW_ITEM_CHARS) + '…'
537
578
  : safe
538
- const row = `[${role}] ${body}`
579
+ const attr = wantAttr
580
+ ? `[${stamp(it['t'])}|${sessTag(it['session'])}|${sensTag(it['sensitivity'])}] `
581
+ : ''
582
+ const row = `${attr}[${role}] ${body}`
539
583
  const next = used === 0 ? row.length : used + 1 + row.length
540
584
  // issue #354 [P1-12]:单条超预算时不再「首条整放」——超过 WINDOW_MAX_CHARS 的
541
585
  // 行一律不放(截断 body 已在上面做完,理论上不可达,作 fail-closed 兜底)。
@@ -711,6 +755,7 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
711
755
  * **逐位等价**(差异窗口「本实例未观测 ∧ 模块单点非空」单实例下不可达;
712
756
  * HMR 重载时新实例回落 '' 属更保守行为)。 */
713
757
  let observedSession = false
758
+ let warnedEmptySid = false
714
759
 
715
760
  /** 记忆沉淀(fire-and-forget)。认知图未就绪则跳过并告警(不退回 AEIS)。
716
761
  * `role`=null 表示**读预热**(user-recall)——审计只统计写入路径,
@@ -800,6 +845,12 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
800
845
  const hostCtx = (_ctx as unknown) as { agent?: { session?: unknown } } | undefined
801
846
  const sid = sessionIdOf(hostCtx?.agent?.session)
802
847
  || (observedSession ? currentSession() : '')
848
+ // 会话 id 为空时后端会退回全局滚动窗口(跨会话串台)。只告警一次,
849
+ // 避免每个 assemble step 刷日志;不改注入内容或数据路径。
850
+ if (!sid && !warnedEmptySid) {
851
+ warnedEmptySid = true
852
+ ctx.logger.warn('dsh-memory: 会话 id 为空,短期窗口可能退回全局滚动窗口(跨会话串台);请检查 host.agent.session 或会话观测是否可用')
853
+ }
803
854
  // 逢十轮提醒的消费面(#657):不受 autoRecall 门控。
804
855
  if (sid) {
805
856
  const pending = pendingReminder.get(sid)
@@ -829,8 +880,25 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
829
880
  // 非永久层 → 既有「最近记忆」块;self/anchor → 独立「身份锚点」块(独立预算)。
830
881
  const identityOn = opts.autoRecallIdentity === true
831
882
  const timelinePayload = await graph.timeline(
832
- identityOn ? recallLimit + IDENTITY_MAX_ITEMS : recallLimit,
883
+ recallLimit,
833
884
  sid ? { session: sid } : {})
885
+ // issue #715(2026-10-30 外部报告,逐行复现):**身份块必须单独取数**。
886
+ //
887
+ // 病灶:此前身份块复用上面这份**带会话过滤**的 payload(还把 limit 加 3 试图
888
+ // 「多取 3 条」),但 `self`/`anchor` 节点的 `session` **恒为 `unattributed`**
889
+ // ——身份锚点在语义上就注定跨会话(`identity` 写入不带 session_id 时即如此,
890
+ // 状态卡与关系节点同理)。两者叠加 ⇒ 永久层被会话过滤全部滤掉 ⇒
891
+ // `renderIdentityAnchors` 拿到空集 ⇒ **块从不出现且无任何报错**(静默失效)。
892
+ //
893
+ // 这正是《身份与人格》理论的 R3:**人格的可见性不该由会话决定**。
894
+ // 用会话过滤去筛人格节点是**类别错误**,不是参数没调好。
895
+ //
896
+ // 故身份块改为**不带会话过滤**取数(不传 session ⇒ 跨会话视图),
897
+ // 再由 `renderIdentityAnchors` 只挑 self/anchor(其余层照样被它跳过)。
898
+ // 「最近记忆」块保持会话隔离不变——那是工作记忆,本就该跟会话走。
899
+ const identityPayload = identityOn
900
+ ? await graph.timeline(IDENTITY_MAX_ITEMS * 3, {})
901
+ : null
834
902
  const text = formatTimelineDecayed(timelinePayload)
835
903
  if (text) {
836
904
  // 注入边界转义(issue #16):宿主 system-prompt 对 context 文本做严格
@@ -866,13 +934,21 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
866
934
  }
867
935
  if (identityOn) {
868
936
  try {
869
- const idText = renderIdentityAnchors(timelinePayload)
937
+ // issue #715:用**独立取数**的 payload(不带会话过滤),不再复用已滤会话的那份。
938
+ const idText = renderIdentityAnchors(identityPayload)
870
939
  if (idText) {
871
940
  assembly.contexts.push({
872
941
  name: 'lingshu:identity-anchor',
873
942
  text: escapePromptBraces(renderUntrustedMemoryBlock(
874
943
  '【灵枢身份锚点】(self/anchor 层,独立预算)\n' + idText)),
875
944
  })
945
+ } else {
946
+ // issue #715(静默失效):此前「开关开了但块从不出现」与「库里确实没有
947
+ // self/anchor 节点」**完全不可分辨**——catch 不触发(没抛错),也没有任何
948
+ // 提示。开着的功能不生效却无声,比报错更难查。故此处显式留痕。
949
+ ctx.logger.info(
950
+ 'dsh-memory: autoRecallIdentity 已开启但无可注入的身份节点'
951
+ + '(self/anchor 层为空——请用 cg(op=identity, action=anchor) 建立锚点)')
876
952
  }
877
953
  } catch (err) {
878
954
  // issue #128 同款纪律:fail-soft 但不静默——空 catch 会被
@@ -892,7 +968,8 @@ export function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts:
892
968
  if (cwEnabled) {
893
969
  try {
894
970
  const win = await graph.sessionRecall(sid, cwTurns, WINDOW_BUDGET_TOKENS)
895
- const winText = formatSessionWindow(win, cwTurns)
971
+ // issue #712:传 sid 用于**标注**(本会话/其他会话),不用于过滤。
972
+ const winText = formatSessionWindow(win, cwTurns, { session: sid })
896
973
  if (winText) {
897
974
  // 注入边界同规(文件头硬约束):不可信内容边界 + `{{` 转义,
898
975
  // 都只改注入副本——窗口原文在库内保真。