@furongjun1999/dsh-memory 0.9.12 → 0.9.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md 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.9)**
13
+ **高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.9.12)**
14
14
 
15
15
  📖 **[第三方上手教程](https://znsvdekx.vibedrop.site/)** —— 《灵枢 dsh-memory 初学者上手研究报告》(由第三方独立编写,非本项目官方文档)
16
16
 
@@ -49,6 +49,20 @@
49
49
  开 ① 后注入的是独立块【灵枢身份锚点】:最多 3 条、单条 160 字符、整块 640 字符,
50
50
  不占「最近记忆」块的预算,且与其它注入面一样过不可信边界标记与脱敏。
51
51
 
52
+ ## ⏱️ 长会话提醒(每 10 个真实用户回合)
53
+
54
+ 插件会在长会话里提醒做间歇归档(工作纪律第 16 条)。计轮单位是**真实用户回合**(用户消息条数),
55
+ 不是模型请求次数——一次请求内部会触发多次 system-prompt 组装,按组装次数计会把"每 10 轮"退化成"每一步"。
56
+
57
+ | 配置 | 行为 |
58
+ |---|---|
59
+ | memory.turnReminder: 10(默认) | 每 10 个用户回合提醒一次,**只出现一步** |
60
+ | memory.turnReminder: N | 自定义间隔(1~100) |
61
+ | memory.turnReminder: false | 整条关闭 |
62
+
63
+ 提醒只在命中那一步注入、下一步即消失(接受两份快照的代价),不会常驻上下文,
64
+ 也不会因并行会话共用一个计数器而放大频率(无会话标识时不提醒)。
65
+
52
66
  ## ⚡ 三条命令上手
53
67
 
54
68
  ```bash
@@ -82,7 +96,7 @@ python -m md_cg.mcp_server # 直连自检:收到 initialize 应答
82
96
  ## ✨ 核心亮点
83
97
 
84
98
  - **🧠 不失忆**——落盘即长期留存,遗忘只能显式发起、不做静默淘汰;检索索引只是派生物,**原文即真源**
85
- - **⚡ 高性能**——Rust 检索内核(零第三方依赖)+ `--serve` 进程实例支撑多智能体并发。公开基准 [hive-memory-bench](https://github.com/FuRongJun-1999/hive-memory-bench) 六家同口径:**逐字保真 100% · 保地基 68.4% · 证据链 97.7–99.2% · 写入 0.011–0.019 秒(零 LLM,同表其余 75.7–658.5 秒)**
99
+ - **⚡ 高性能**——Rust 检索内核(零第三方依赖)+ `--serve` 进程实例支撑多智能体并发。公开基准 [hive-memory-bench](https://github.com/FuRongJun-1999/hive-memory-bench) 六家同口径:**逐字保真 100% · 保地基 68.4%/65.0% · 证据链 97–100% · 写入 0.013–0.020 秒(零 LLM,同表其余 75.7–658.5 秒)**
86
100
  - **🛡️ 无幻觉**——记什么、取什么、能不能写入全部由确定性规则裁决,不依赖 LLM 黑箱;写没写成功只看 `committed`,绝不假装通过
87
101
  - **🔌 多智能体适用**——同一份大脑 + 同一份纪律,接入 DSH · CodeBuddy · ZCode · Codex CLI · Claude Code,任何 MCP 宿主可直接挂载
88
102
  - **📊 可复现评测**——权威对照在独立公开基准 hive-memory-bench;另公开两个自建题池;**已有两份第三方独立验证**(七轮复评 + LoCoMo 独立复现,自报数字逐位一致)
package/lib/hooks.d.ts CHANGED
@@ -77,6 +77,12 @@ export interface MemoryHooksOptions {
77
77
  autoRecall: boolean;
78
78
  /** 自动召回条数(默认 4)。 */
79
79
  autoRecallLimit: number;
80
+ /** 逢十轮提醒(纪律第 16 条;issue #645)。缺省 10 = 每 10 个真实用户回合提醒一次;
81
+ * 数字 = 自定义间隔(1~100);false = 关闭。
82
+ *
83
+ * 计轮单位是「用户消息条数」,不是 assemble 次数——实测一次模型请求约 10 次 assemble,
84
+ * 按 assemble 计数会把「每 10 轮」退化成「每一步」。 */
85
+ turnReminder?: boolean | number;
80
86
  /** 身份锚点独立注入块(issue #635,默认 false = 保持既有行为)。
81
87
  *
82
88
  * 背景:永久层(self/anchor)被 RECALL_SKIP_LAYERS 跳过,用户写完「我是谁」永远
@@ -184,6 +190,6 @@ export declare function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null
184
190
  * 不等收尾」。zcode 端由 `scripts/zcode_window_hook.py` 注入提醒;**DSH 端此前
185
191
  * 完全没有实现**——纪律在产物里、机制不在,代理只能靠自觉(实测:整场长会话
186
192
  * 一次归档都没做)。本函数是该缺口的判定单点。 */
187
- export declare function shouldRemindTurn(n: number): boolean;
193
+ export declare function shouldRemindTurn(n: number, interval?: number): boolean;
188
194
  /** 提醒文本(不含注入边界转义——转义在 push 站点做,与其它块同规)。 */
189
195
  export declare function formatTurnReminder(n: number): string;
package/lib/hooks.js CHANGED
@@ -698,10 +698,23 @@ export function installMemoryHooks(ctx, mdcg, opts) {
698
698
  // 因此本实现把「要不要补」交还给宿主:压缩归档后宿主会把 retained 置空并重新投影快照
699
699
  // (RuntimeContextProjection 的 retained === null 分支),本块自然跟着回来——
700
700
  // 不需要插件自己数步数做自愈。
701
- /** 进程内轮次计数(session → 已 assemble 轮数)。见 shouldRemindTurn。 */
702
- /** 进程内「本十轮段提醒文本」(session → 文本):段内每轮重推同一文本,避免快照增删。 */
703
- const remindText = new Map();
704
- const turnSeq = new Map();
701
+ /** 真实轮次计数(session → 用户消息条数)。issue #645:计轮单位必须是「用户回合」,
702
+ * 不是 assemble 次数——实测一步约 10 次 assemble,按 assemble 计数会把「每 10 轮」
703
+ * 退化成「每一步」,提醒于是常驻上下文、agent 反复空转归档。 */
704
+ const userTurns = new Map();
705
+ /** 待推送提醒(session → 文本):用户回合计数命中时写入,assemble 时只消费一次;
706
+ * 不做 sticky 重推(那是提醒常驻的直接原因)。 */
707
+ const pendingReminder = new Map();
708
+ /** 提醒间隔:false → 0(关闭);数字 → clamp 1..100;未设 → 10。 */
709
+ const reminderInterval = (() => {
710
+ const cfg = opts.turnReminder;
711
+ if (cfg === false)
712
+ return 0;
713
+ const n = typeof cfg === 'number' ? cfg : 10;
714
+ if (!Number.isFinite(n))
715
+ return 10;
716
+ return Math.max(1, Math.min(100, Math.floor(n)));
717
+ })();
705
718
  if (opts.autoRecall) {
706
719
  const recallLimit = Math.max(1, Math.min(10, opts.autoRecallLimit || 4));
707
720
  ctx.on('system-prompt/assemble', async (assembly, _ctx, next) => {
@@ -724,22 +737,17 @@ export function installMemoryHooks(ctx, mdcg, opts) {
724
737
  // 真机单实例下两者逐位等价(差异窗口不可达)。
725
738
  const sid = sessionIdOf(hostCtx?.agent?.session)
726
739
  || (observedSession ? currentSession() : '');
727
- // 逢十轮提醒(纪律第 16 条):assemble 每轮触发一次 ⇒ 以此计轮。
728
- // 状态只在本进程内(重启归零):宁可多提醒一次,不留假状态。
729
- const turnKey = sid || '__no_sid__';
730
- const turnNo = (turnSeq.get(turnKey) ?? 0) + 1;
731
- turnSeq.set(turnKey, turnNo);
732
- // 粘性提醒(2026-10-21):只在触发轮 push、下一轮就消失会让宿主多追两份快照
733
- // (10→11 增删各一次)。故把「本轮所属十轮段的提醒文本」按会话记住,
734
- // 段内每轮**原样重推**(文本不变 ⇒ 渲染快照不追加),跨段才换一次文本。
735
- if (shouldRemindTurn(turnNo)) {
736
- remindText.set(turnKey, escapePromptBraces(formatTurnReminder(turnNo)));
737
- }
738
- const sticky = remindText.get(turnKey);
739
- if (sticky) {
740
- assembly.contexts.push({ name: 'lingshu:turn-reminder', text: sticky });
740
+ // 逢十轮提醒(纪律第 16 条;issue #645 修正):计数挪到 session/event 的真实
741
+ // 用户回合上,这里只消费一次待推文本。旧实现把 assemble 当轮次 + 段内永久重推
742
+ // ⇒ 提醒几乎常驻、agent 反复空转归档;sid 缺失时还回落共用键 __no_sid__,
743
+ // 并行会话互相污染频率。现改为:无 sid 不提醒;提醒只在本回合第一次 assemble 出现。
744
+ if (sid) {
745
+ const pending = pendingReminder.get(sid);
746
+ if (pending) {
747
+ pendingReminder.delete(sid);
748
+ assembly.contexts.push({ name: 'lingshu:turn-reminder', text: pending });
749
+ }
741
750
  }
742
- // issue #635:身份锚点独立块(默认关)。开启时多取几条,按层分流:
743
751
  // 非永久层 → 既有「最近记忆」块;self/anchor → 独立「身份锚点」块(独立预算)。
744
752
  const identityOn = opts.autoRecallIdentity === true;
745
753
  const timelinePayload = await graph.timeline(identityOn ? recallLimit + IDENTITY_MAX_ITEMS : recallLimit, sid ? { session: sid } : {});
@@ -881,6 +889,16 @@ export function installMemoryHooks(ctx, mdcg, opts) {
881
889
  const text = extractText(event.data.content);
882
890
  if (!text)
883
891
  return;
892
+ // 逢十轮提醒的**计轮点**(issue #645):真实用户回合 = 用户消息条数。
893
+ // 放在脱敏之前——被脱敏丢弃的消息也是一次真实交互,不应影响计数。
894
+ // 无 sid 不计数、不提醒(旧实现回落共用键 __no_sid__,并行会话会互相污染频率)。
895
+ if (sid && reminderInterval > 0) {
896
+ const n = (userTurns.get(sid) ?? 0) + 1;
897
+ userTurns.set(sid, n);
898
+ if (shouldRemindTurn(n, reminderInterval)) {
899
+ pendingReminder.set(sid, escapePromptBraces(formatTurnReminder(n)));
900
+ }
901
+ }
884
902
  const safe = sanitize(text); // 脱敏:纯凭据消息 → null → 跳过写入
885
903
  if (safe === null) {
886
904
  audit.skipped('sanitized', 'user');
@@ -975,8 +993,13 @@ export function installMemoryHooks(ctx, mdcg, opts) {
975
993
  * 不等收尾」。zcode 端由 `scripts/zcode_window_hook.py` 注入提醒;**DSH 端此前
976
994
  * 完全没有实现**——纪律在产物里、机制不在,代理只能靠自觉(实测:整场长会话
977
995
  * 一次归档都没做)。本函数是该缺口的判定单点。 */
978
- export function shouldRemindTurn(n) {
979
- return Number.isFinite(n) && n >= 10 && n % 10 === 0;
996
+ export function shouldRemindTurn(n, interval = 10) {
997
+ if (!Number.isFinite(n) || !Number.isFinite(interval))
998
+ return false;
999
+ const step = Math.floor(interval);
1000
+ if (step <= 0)
1001
+ return false;
1002
+ return n >= step && n % step === 0;
980
1003
  }
981
1004
  /** 提醒文本(不含注入边界转义——转义在 push 站点做,与其它块同规)。 */
982
1005
  export function formatTurnReminder(n) {
package/lib/index.js CHANGED
@@ -111,6 +111,9 @@ export const Config = z.object({
111
111
  autoRecallLimit: z.number().default(4),
112
112
  /** issue #635:self/anchor 层单列「身份锚点」块(默认 false = 维持既有行为)。 */
113
113
  autoRecallIdentity: z.boolean().default(false),
114
+ /** 逢十轮提醒(纪律第 16 条;issue #645):缺省 10 = 每 10 个真实用户回合;
115
+ * false = 关闭;数字 = 自定义间隔(1~100)。 */
116
+ turnReminder: z.union([z.boolean(), z.number()]).default(10),
114
117
  desensitize: z.boolean().default(true),
115
118
  /** **短期会话窗口**(滑动窗口,2026-10-06)——「短期保留近 N 条对话记录」
116
119
  * 的机制实现(长期记忆仍走灵枢的显式调用)。
@@ -134,7 +137,7 @@ export const Config = z.object({
134
137
  })
135
138
  .default({ enabled: true, turns: 10 }),
136
139
  })
137
- .default({ userMessage: true, assistantMessage: false, toolResult: false, importance: 0.6, autoRecall: true, autoRecallLimit: 4, autoRecallIdentity: false, desensitize: true, contextWindow: { enabled: true, turns: 10 } }),
140
+ .default({ userMessage: true, assistantMessage: false, toolResult: false, importance: 0.6, autoRecall: true, autoRecallLimit: 4, autoRecallIdentity: false, turnReminder: 10, desensitize: true, contextWindow: { enabled: true, turns: 10 } }),
138
141
  toolCallTimeoutMs: z.number().default(60_000),
139
142
  maxRetryDelayMs: z.number().default(30_000),
140
143
  failOnStartupError: z.boolean().default(false),
@@ -349,6 +349,8 @@ ENV_ROWS = [
349
349
  ('MDCG_PREFILTER', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_PREFILTER', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关(未设=开/缺省即字面量)', 'unknown', ''),
350
350
  ('MDCG_PREFILTER_MIN', 'TUNE', 'tune', 'env', True, "'50'", 'str', 'value', 'MDCG_PREFILTER_MIN', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关(未设=开/缺省即字面量)', 'unknown', ''),
351
351
  ('MDCG_RECONCILE_BG', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_RECONCILE_BG', 'value', 'env_literal', 'md_cg/mcp_server.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关', 'unknown', ''),
352
+ ('MDCG_MIN_SCORE', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_MIN_SCORE', 'value', 'env_literal', 'md_cg/mdcg.py', '', 'uncalibrated', '2026-10-23 手补:issue #637 可配最低分(0=关)', 'unknown', ''),
353
+ ('MDCG_RECALL_MIN_SCORE', 'TUNE', 'tune', 'env', True, "'-1'", 'str', 'value', 'MDCG_RECALL_MIN_SCORE', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-23 手补:issue #637 召回面最低分(-1=关)', 'unknown', ''),
352
354
  ]
353
355
 
354
356
  # 环境面**分类登记**(只登记「属于环境面」与值域类型;**不登记缺省值**)