@furongjun1999/dsh-memory 0.9.17 → 0.9.21

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 (30) hide show
  1. package/CHANGELOG.md +208 -0
  2. package/README.md +3 -2
  3. package/docs/mdcg/CCG/345/205/255/350/246/201/347/264/240/347/274/226/350/257/221.md +30 -0
  4. package/docs/mdcg/MCP/345/267/245/345/205/267/345/220/215/345/217/243/345/276/204_v1.0.md +41 -0
  5. package/docs/mdcg/cogmap_ops.md +36 -0
  6. package/docs/mdcg/guardrail-charter.md +168 -0
  7. package/docs/mdcg/recall_metadata.md +41 -0
  8. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +384 -0
  9. package/docs/mdcg//345/206/231/345/205/245/345/210/253/345/220/215aliases/350/247/204/350/214/203_v0.6.md +128 -0
  10. package/lib/hooks.d.ts +9 -1
  11. package/lib/hooks.js +78 -19
  12. package/md_cg/mdcg.py +33 -2
  13. package/md_cg/mdcos.py +80 -6
  14. package/md_cg/repeat_guard.py +122 -0
  15. package/md_cg/security.py +9 -2
  16. package/md_cg/test_722_aliases_thin.py +85 -0
  17. package/md_cg/test_722_condition_quality.py +83 -0
  18. package/md_cg/test_723_permission_wildcard.py +80 -0
  19. package/md_cg/test_aliases_r2r3.py +92 -0
  20. package/md_cg/test_issue712_session_window_attribution.py +225 -0
  21. package/md_cg/test_logref.py +4 -4
  22. package/md_cg/test_mode_parity.py +11 -0
  23. package/md_cg/test_p27_docindex.py +12 -7
  24. package/md_cg/test_p45_session_identity.py +6 -4
  25. package/md_cg/test_repeat_guard_charter15.py +89 -0
  26. package/md_cg/writegate.py +101 -1
  27. package/package.json +9 -2
  28. package/src/hooks.ts +84 -7
  29. package/ui/minimal/payload/web/app.js +1 -1
  30. package/web/app.js +1 -1
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);
@@ -5387,7 +5412,13 @@ class MdCG:
5387
5412
  # 正是为了让旧调用方零改动(钩子由调用点显式传入,不靠 self 解析)。
5388
5413
  if index_keys and index_keys.get("hit"):
5389
5414
  return True
5390
- tags = " ".join(str(t) for t in (fm.get("tags") or []))
5415
+ # 命名与检索规范 R2(2026-10-30):`aliases` 是**名称别名表**,与 `tags` 物理分离——
5416
+ # 只参与检索召回,**不参与**身份/路由判据(tasks 的「是不是任务卡」、predict 的
5417
+ # 「能不能当锚点」都只读 tags,别名不得混入,否则会翻转那些判据)。
5418
+ # 容错:aliases 非 list 时按空处理(脏 frontmatter 不抛)。
5419
+ _aliases = fm.get("aliases")
5420
+ _aliases = _aliases if isinstance(_aliases, list) else []
5421
+ tags = " ".join(str(t) for t in ((fm.get("tags") or []) + _aliases))
5391
5422
  if body_lower is not None:
5392
5423
  body_l = body_lower(entry, content)
5393
5424
  else:
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,42 @@ 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),与上一段的既有写法同款。
4689
+ # 宪章第十五条(复读污染)· 注入过滤:给重复事件**加标注**(不折叠、不删条目——
4690
+ # 用户可能真的把同一句话说两遍,实测库里就有一条 x7 的是真发的)。
4691
+ # 只标不折:条数不变,模型能看到「这条重复了 N 次」。(history 去重
4692
+ # `repeat_guard.dedupe` 留给显式要求折叠的调用方,本段不用它。)
4693
+ from . import repeat_guard as _rg
4694
+ evs = _rg.annotate(evs)
4658
4695
  pack["recent"] = [{"role": r.get("role"),
4659
4696
  "text": (r.get("text") or "")[:300],
4660
- "t": r.get("t")} for r in evs]
4697
+ "t": r.get("t"),
4698
+ "id": r.get("id"),
4699
+ "session": (r.get("meta") or {}).get("session"),
4700
+ "sensitivity": (r.get("meta") or {}).get("sensitivity"),
4701
+ "actor": (r.get("meta") or {}).get("actor"),
4702
+ # 2026-10-30 理论《身份与人格》:归因三维(编号/职业身份/汇报线)。
4703
+ # 只透出**归因必需**的,不透权限快照(理由见 remember_event 注释)。
4704
+ "token_id": (r.get("meta") or {}).get("token_id"),
4705
+ "identity_role": (r.get("meta") or {}).get("identity_role"),
4706
+ "parent": (r.get("meta") or {}).get("parent"),
4707
+ # 宪章第十五条:复读标注(只在命中时有键,未命中不占位)
4708
+ **(dict(repeat=r["repeat"]) if isinstance(r.get("repeat"), dict) else {})}
4709
+ for r in evs]
4661
4710
  except Exception: # noqa: BLE001
4662
4711
  pack["degraded"].append("recent")
4663
4712
  # ④ 未解问题(驱动主动补全)
@@ -4725,13 +4774,20 @@ class MdCGOS(MdCG):
4725
4774
  零依赖启发式(无嵌入 / 无 LLM):按行去重 + 角色配比 + 截断。
4726
4775
  返回体显式声明 heuristic=True,不冒充语义摘要(语义归纳见 consolidate)。
4727
4776
  """
4777
+ # issue #712(2026-10-30 验证单元复核发现):**与 session_recall 同型的取窗 bug**——
4778
+ # 修前先截末 N 条、后按会话过滤 ⇒ 多会话并发时本会话事件被挤出窗口,
4779
+ # `session_compact(session=A, note=True)` 可能压出「共 0 条事件」并**写入会话节点**
4780
+ # (比 session_recall 更严重:那只是少看到,这会**写错**一条记忆)。
4781
+ # 修法同 session_recall:需要收窄时先取全量、再过滤、最后再截回 limit。
4782
+ _lc = max(1, int(limit or 40))
4783
+ _narrow_c = bool(session)
4728
4784
  try:
4729
- evs = self.recent_events(limit=max(1, int(limit or 40)))
4785
+ evs = self.recent_events(limit=0 if _narrow_c else _lc)
4730
4786
  except Exception: # noqa: BLE001
4731
4787
  evs = []
4732
- if session:
4788
+ if _narrow_c:
4733
4789
  evs = [r for r in evs
4734
- if (r.get("meta") or {}).get("session") == session]
4790
+ if (r.get("meta") or {}).get("session") == session][:_lc]
4735
4791
  roles, seen, points = {}, set(), []
4736
4792
  for r in evs:
4737
4793
  role = r.get("role") or "user"
@@ -6950,6 +7006,24 @@ class MdCGSecure(MdCGOS):
6950
7006
  # 归因不可辨认;且请求声明对事件面静默失效);现与节点/入队同一单点
6951
7007
  # 解析——事件面与写面同口径(显式 meta["session"] 仍不可覆盖)。
6952
7008
  m.setdefault("session", self._attributed_session(sens))
7009
+ # issue #712(2026-10-30 验证单元复核发现):**身份归属此前漏落**——
7010
+ # 同函数里 tenant/session/harness/unit/sensitivity 都从 principal 落值,
7011
+ # 唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 actor 恒为 None,
7012
+ # 「哪些是自己做的、哪些是别人做的」这一要素在库层是空的。
7013
+ # 用 setdefault:调用方显式传 meta["actor"] 时不被覆盖(与上面同款口径)。
7014
+ m.setdefault("actor", self.principal.actor)
7015
+ # 2026-10-30 理论《身份与人格》七要素落地:仅补**归因必需**的三维,
7016
+ # 不给事件加权限快照(clearance/layers_allow/ops_allow 一律不写——权限是
7017
+ # 当前态不是历史事实,固化进事件会造出「假的当时有权」;权限由
7018
+ # sensitivity(数据属性)+ 读取时判据承担)。
7019
+ # · token_id = **编号**(同名不同人可区分)
7020
+ # · identity_role = **职业身份**(干什么;与 role 参数的 user/assistant 不同层,
7021
+ # 故用不同键名,避免与消息角色混淆)
7022
+ # · parent = **汇报线**(有上级时才落)
7023
+ m.setdefault("token_id", getattr(self.principal, "token_id", None))
7024
+ m.setdefault("identity_role", getattr(self.principal, "role", None))
7025
+ if getattr(self.principal, "parent", None):
7026
+ m.setdefault("parent", self.principal.parent)
6953
7027
  if getattr(self.principal, "harness", None):
6954
7028
  m.setdefault("harness", self.principal.harness)
6955
7029
  if getattr(self.principal, "unit", None):
@@ -0,0 +1,122 @@
1
+ # -*- coding: utf-8 -*-
2
+ """宪章第十五条(复读污染)的实现:注入过滤 + history 去重 + 污染清除。
3
+
4
+ ## 为什么需要它
5
+
6
+ `docs/mdcg/guardrail-charter.md` 第十五条写:「幻觉锚点/失败复读自我强化——
7
+ 注入过滤 + history 去重 + 污染清除。」但**此前只有条文、没有实现**
8
+ (`src/` 与 `md_cg/` 搜「复读/degenerat/repetition」零命中)。
9
+
10
+ ## 关键取舍:**检测不等于删除**
11
+
12
+ 用户可能真的把同一句话说了两遍(实测库里就有一条 `role=user` 的消息重复 7 次,
13
+ 那是真发的,不是模型复读)。所以本模块**只做三件事,不做静默删除**:
14
+
15
+ 1. **检测**(`scan`):按 `(role, sha1(text))` 在**同一会话窗口内**计数;
16
+ 2. **标注**(`annotate`):给命中项打上 `repeat={count,suffix,first_t}`,供注入面渲染;
17
+ 3. **清理**(`dedupe`):**只保留最新一条 + 其余折叠为计数**,且**仅当调用方显式要求**
18
+ ——库内原文一个字都不动(与 `thinking-guard` 的「改注入副本、不改日志」同原则)。
19
+
20
+ ## 判据(阈值来源)
21
+
22
+ 仿 `dsh-degeneration-kit` 的 `rotationHit` 双阈值思路,但用于**事件窗口**而非思考块:
23
+
24
+ | 配置 | 默认 | 含义 |
25
+ |---|---|---|
26
+ | `minCount` | 3 | 同一 `(role, hash)` 至少出现这么多次才算「复读」 |
27
+ | `minChars` | 12 | 文本短于此长度不判(太短的话重复是正常的,如「好」「继续」) |
28
+ | `window` | 200 | 只看窗口内(与 `DEFAULT_RECENT_WINDOW` 同口径) |
29
+
30
+ ⚠️ `minChars=12` 这条是**从实测反推**的:实测库里 `x7` 那条长文本是真重复,
31
+ 而「好」「继续」这类短指令重复属正常对话,不该被判成污染。
32
+
33
+ ## 与智能论《扮演崩溃治理》的关系
34
+
35
+ 智能论 3.4 附录22.1:**「状态丢失(数不出搜索次数)= 扮演崩溃 → 状态外部化治之」**。
36
+ 本节做的是**事后**(`history 去重`),扮演崩溃的**事前**防线是「状态外置」
37
+ (把步骤清单/计数器写进任务消息,模型零判断)——两者互补,不是替代。
38
+ """
39
+
40
+ import hashlib
41
+
42
+ # 生效条件:恒返回 8 位十六进制(sha1(text) 前 8 位)——**纯确定性**,同一 text 恒得同一串;
43
+ # 用作「同一条事件」的判据,不参与任何权限判定。
44
+ def text_suffix(text) -> str:
45
+ return hashlib.sha1((text or "").encode("utf-8", "replace")).hexdigest()[:8]
46
+
47
+
48
+ # 生效条件:events 为可迭代的事件 dict 列表、min_count>=1、min_chars>=0 时,
49
+ # 按 (role, text_suffix(text)) 计数并返回命中项列表(按 count 降序);
50
+ # 文本长度 < min_chars 的条目不参与;非 dict 条目跳过(与 recent_record_ok 同款容错)。
51
+ def scan(events, min_count: int = 3, min_chars: int = 12):
52
+ """检测事件窗口内的重复(复读候选)。**只读,不修改入参**。"""
53
+ try:
54
+ lo = max(1, int(min_count))
55
+ lc = max(0, int(min_chars))
56
+ except (TypeError, ValueError):
57
+ lo, lc = 3, 12
58
+ buckets = {}
59
+ for ev in (events or ()):
60
+ if not isinstance(ev, dict):
61
+ continue
62
+ text = ev.get("text") or ""
63
+ if not isinstance(text, str) or len(text) < lc:
64
+ continue
65
+ key = (ev.get("role") or "user", text_suffix(text))
66
+ b = buckets.setdefault(key, {"count": 0, "suffix": key[1], "role": key[0],
67
+ "text": text[:200], "first_t": ev.get("t"),
68
+ "seqs": []})
69
+ b["count"] += 1
70
+ b["first_t"] = ev.get("t")
71
+ hits = [b for b in buckets.values() if b["count"] >= lo]
72
+ hits.sort(key=lambda b: -b["count"])
73
+ return hits
74
+
75
+
76
+ # 生效条件:scan 返回的命中列表非空时,为 events 中命中项**加** repeat 标注(返回新列表,
77
+ # 原 dict 不被修改——与「只改注入副本、库内正文保真」一致);未命中项原样透传。
78
+ def annotate(events, min_count: int = 3, min_chars: int = 12):
79
+ """给命中项加 `repeat={count, suffix}`。**返回新列表,不改原 dict**。"""
80
+ hits = scan(events, min_count=min_count, min_chars=min_chars)
81
+ if not hits:
82
+ return list(events or ())
83
+ by_key = {(b["role"], b["suffix"]): b for b in hits}
84
+ out = []
85
+ for ev in (events or ()):
86
+ if not isinstance(ev, dict):
87
+ out.append(ev)
88
+ continue
89
+ text = ev.get("text") or ""
90
+ h = by_key.get((ev.get("role") or "user", text_suffix(text))) if isinstance(text, str) else None
91
+ out.append(dict(ev, repeat={"count": h["count"], "suffix": h["suffix"]}) if h else ev)
92
+ return out
93
+
94
+
95
+ # 生效条件:events 非空且 dense=True 时,同一 (role, suffix) 只保留**最新一条**、
96
+ # 其余折叠为 `repeat:{count}` 标注(条目数减少,但每条都还在);dense=False 时等价于 annotate。
97
+ # **只作用于返回副本**:盘面 `_recent.jsonl` 不被读写。
98
+ def dedupe(events, min_count: int = 3, min_chars: int = 12):
99
+ """history 去重(注入面用):同一复读只留最新一条,其余合并为计数。**不写盘**。"""
100
+ rows = list(events or ())
101
+ hits = scan(rows, min_count=min_count, min_chars=min_chars)
102
+ if not hits:
103
+ return rows
104
+ by_key = {(b["role"], b["suffix"]): b for b in hits}
105
+ seen = set()
106
+ out = []
107
+ for ev in reversed(rows):
108
+ if not isinstance(ev, dict):
109
+ out.append(ev)
110
+ continue
111
+ text = ev.get("text") or ""
112
+ key = (ev.get("role") or "user", text_suffix(text)) if isinstance(text, str) else None
113
+ h = by_key.get(key) if key else None
114
+ if not h:
115
+ out.append(ev)
116
+ continue
117
+ if key in seen:
118
+ continue
119
+ seen.add(key)
120
+ out.append(dict(ev, repeat={"count": h["count"], "suffix": h["suffix"], "collapsed": True}))
121
+ out.reverse()
122
+ return out
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,85 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:写入别名(aliases)是否是「薄别名」的守卫(issue #722 / 规范 v0.6)
3
+ # 生效条件:python -X utf8 -m md_cg.test_722_aliases_thin;被测面=md_cg/writegate.py 的 aliases_is_thin
4
+ # 子功能:
5
+ # A. 无 aliases(缺失/空 list/非 list)⇒ 判为薄
6
+ # B. 别名全在正文里(只重复已有词)⇒ 判为薄
7
+ # C. 只要有一个别名在正文里找不到(有扩召回首)⇒ 判为不薄
8
+ # D. 不判数量(3 个精准别名不因"少"被判薄)
9
+ # E. 任何输入不抛
10
+ # 执行:纯函数级断言,不建库、不写盘
11
+ # 验证方式:全部 PASS exit 0;每条注明「怎么让它红」
12
+ # 不适用条件:不判"别名写得好不好"(判不了语义);不覆盖写入接线(尚未接 add)
13
+ """为什么要它:
14
+
15
+ issue #722 的决定性案例——条件 `聊交接、换会话、压缩、或他流露舍不得时`,
16
+ 查询 `我不想你被换掉`:整词 / 二元组 / 查询扩展 / 现有同义词表**四条路全废**,
17
+ 只有 `aliases=[换掉, 被换, 别消失, 舍不得, …]` 能让 `_like` 从不命中变命中。
18
+
19
+ 而库内 aliases 覆盖率为 **0/120 = 0%**(2026-10-31 实测)⇒ 需要一道写入把关,
20
+ 提示"本条无扩展别名,自然问法可能召不回"。本守卫只锁判据本身。
21
+ """
22
+ import os
23
+ import sys
24
+
25
+ ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
26
+ sys.path.insert(0, ROOT)
27
+
28
+ from md_cg.writegate import aliases_is_thin # noqa: E402
29
+
30
+ _PASS, _FAIL = [], []
31
+
32
+
33
+ def ok(cond, msg, detail=""):
34
+ (_PASS if cond else _FAIL).append(msg)
35
+ print((" PASS " if cond else " FAIL ") + msg + ((" <- " + str(detail)) if detail and not cond else ""))
36
+
37
+
38
+ BODY = "聊交接、换会话、压缩、或他流露舍不得时。正文里提到 换会话 和 压缩。"
39
+
40
+
41
+ def main():
42
+ print("== A 无 aliases(怎么让它红:把首个 return 改成 False)")
43
+ ok(aliases_is_thin({}, BODY) is True, "A1 缺 aliases ⇒ 薄")
44
+ ok(aliases_is_thin({"aliases": []}, BODY) is True, "A2 空 list ⇒ 薄")
45
+ ok(aliases_is_thin({"aliases": "换掉"}, BODY) is True, "A3 非 list ⇒ 薄(按缺处理)")
46
+ ok(aliases_is_thin(None, BODY) is True, "A4 fm 为 None ⇒ 薄")
47
+
48
+ print("== B 只重复正文(怎么让它红:把 s not in body 改成 s in body)")
49
+ ok(aliases_is_thin({"aliases": ["换会话", "压缩"]}, BODY) is True,
50
+ "B1 别名全在正文里 ⇒ 薄(没扩召回首)")
51
+
52
+ print("== C 有扩召回词(怎么让它红:把 C1 的 return 改成 True)")
53
+ ok(aliases_is_thin({"aliases": ["换会话", "换掉"]}, BODY) is False,
54
+ "C1 只要一个别名不在正文(换掉)⇒ 不薄")
55
+ ok(aliases_is_thin({"aliases": ["别消失"]}, BODY) is False,
56
+ "C2 单个扩展词也判不薄(不判数量)")
57
+
58
+ print("== D 不判数量(怎么让它红:加数量下限判断)")
59
+ ok(aliases_is_thin({"aliases": ["换掉"]}, BODY) is False,
60
+ "D1 1 个精准扩展词就够,不因\"少\"被判薄")
61
+
62
+ print("== E 不抛(怎么让它红:去掉 try/except 后传异常对象)")
63
+ ok(aliases_is_thin({"aliases": [None, ""]}, BODY) is True,
64
+ "E1 别名里含 None/空串 ⇒ 跳过,仍判薄")
65
+ try:
66
+ aliases_is_thin({"aliases": [{"a": 1}]}, BODY)
67
+ ok(True, "E2 别名含 dict 不抛")
68
+ except Exception as e: # noqa: BLE001
69
+ ok(False, "E2 别名含 dict 不抛", "%s: %s" % (type(e).__name__, e))
70
+ try:
71
+ aliases_is_thin({"aliases": ["换掉"]}, None)
72
+ ok(True, "E3 content 为 None 不抛")
73
+ except Exception as e: # noqa: BLE001
74
+ ok(False, "E3 content 为 None 不抛", "%s: %s" % (type(e).__name__, e))
75
+
76
+ print()
77
+ print("别名薄判据守卫:%d 通过 / %d 失败" % (len(_PASS), len(_FAIL)))
78
+ if _FAIL:
79
+ for f in _FAIL:
80
+ print(" -", f)
81
+ return 0 if not _FAIL else 1
82
+
83
+
84
+ if __name__ == "__main__":
85
+ raise SystemExit(main())