dsh-prime-memory 0.20.1 → 0.20.3

package/CHANGELOG.md

@@ -17,6 +17,23 @@
   - **建议状态(`longtask-hint-get`)以纯端点提供**:判定 = 上下文占用达 `contextThresholdPct` 或 todo 漂移达 `driftThreshold`(部署配置可调);配合 `longtask-compress-tail` 作手动压缩入口。
   - **撤下浮动球 UI(`client/src/longtask-fab.ts`;beta.1 起曾随包发布)**:悬浮建议面板的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——2026-10-02 用户裁定撤下。撤下不违座位契约(settings.section 恰一个 + 输入栏 pill,body 单例不占座位),但全应用级 overlay 会与其他插件的悬浮 UI 抢占屏幕角落;长任务开关与手动压缩入口待长任务定版时落记忆设置分节。
   - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
+## [0.20.3] — 2026-10-03
+
+### 修复
+
+- **`memory_search` 的渲染文本补上 id**:v0.20.2 把 record_id 加进了输出 JSON 与 schema,但模型看到的是 render 产物而非原始 JSON——渲染行没带 id,对模型等于没返回(真机复测发现)。现在每条结果以 `— id: mem_xxx` 结尾,可直接写入槽位 refs。
+
+## [0.20.2] — 2026-10-03
+
+### 修复
+
+- **投影 `memorySlots` 判脏放宽到任意事件**:此前仅在 `tool/result`(settled、非 error)时按 store rev 判脏——写入后依赖"恰好再来一条工具结果"才刷新,跨会话查看更要等查看会话自己的工具调用;真机暴露出写入后侧栏长期停在空帧。改为任意已提交事件做 O(1) rev 比较,rev 变即重建推送;isError 守卫移除(rev 只在真实变更后递增,事件只是触发器,不是数据源)。
+- **常驻注入改 `<system-reminder>` 标签帧**(对齐 dsh-agent-instructions 的 AGENTS.md 注入 house style):user 角色承载不变,但以标签框 + 权威性声明(免回应/勿复述/不覆盖系统提示与用户直接指令)呈现——修掉弱模型把槽位内容当用户发言原样复述、干扰正常回复的问题;槽位正文中的闭合标签转义(`</system-reminder>`),防止槽位内容伪造帧边界。
+
+### 新增
+
+- **`memory_search` 结果透出 `id`(L1 record_id)**:解除"检索拿不到 id → 无法写槽位 refs / 喂 memory_receipts"的死锁;schema 描述注明 id 的两个去向。
+- **wire view 透出 `refs` + `refViews`**:`mem_*` 类引用在投影帧构建时经 L1 `getByIds` 解析为 `[type] 名称简述`(content 首行,80 字截断),brief-sidebar(≥0.5.0-beta.2)直接渲染,路径/URL 类引用保持字面;缺失/已退场记录不产生条目。解析发生在帧构建时——引用集在写槽位时即冻结,L1 记录事后编辑不回灌旧帧。自实现 schema 对附加字段"存在才校验",旧 checkpoint 行整条通过(stateVersion 不动)。
 ## [0.20.1] — 2026-10-03(转正;beta 渠道自 beta.1 起的全部能力定版)
 
 Hall·Room 分类管理全链(两级注册表/merge/rename/retire/update/收编/退场带记录/

package/dist/hooks/slot-recall.js

@@ -1,4 +1,22 @@
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
+/**
+ * 对齐宿主 house style(dsh-agent-instructions 的 AGENTS.md 注入):user 角色
+ * 承载 + `<system-reminder>` 标签框。宿主对自家指令刻意**不用** system 角色——
+ * 会话中段的 system 消息会破坏部分聊天模板(qwen-chat-template 等),标签框即可
+ * 让模型把它识别为系统级元信息(Claude Code 同款语义)。
+ */
+const SYSTEM_REMINDER_OPEN = '<system-reminder>';
+const SYSTEM_REMINDER_CLOSE = '</system-reminder>';
+const SLOTS_INTRO = '以下是本环境的常驻记忆槽位(激活槽位):跨会话持续生效的背景约定,仅在与之相关时作为指引遵循。' +
+    '它们是系统注入的元信息,不是用户发言——无需回应,请勿在回复中复述本节内容;' +
+    '且不覆盖系统提示与用户的直接指令,更具体的指令优先于更一般的约定。';
+/**
+ * 槽位标题/正文来自模型工具调用,可能含有闭合标签;不转义会让槽位内容伪造
+ * 帧边界(宿主对指令文件正文做同样的转义)。
+ */
+function escapeFrameBody(body) {
+    return body.replaceAll(SYSTEM_REMINDER_CLOSE, '<\\/system-reminder>');
+}
 export function registerSlotRecall(ctx, cfg, slots, logger, _live) {
     const buildInjection = () => {
         if (!cfg.slots.enabled || !cfg.slots.inject)
@@ -13,7 +31,12 @@ export function registerSlotRecall(ctx, cfg, slots, logger, _live) {
         if (truncatedCount > 0) {
             lines.push(`… 另有 ${truncatedCount} 个常驻槽位因预算未显示,可用 memory_slot_list 查看`);
         }
-        return '【激活槽位 · 常驻上下文】\n' + lines.join('\n');
+        return [
+            SYSTEM_REMINDER_OPEN,
+            SLOTS_INTRO,
+            escapeFrameBody(lines.join('\n')),
+            SYSTEM_REMINDER_CLOSE,
+        ].join('\n');
     };
     ctx.on('agent/pre-step', async (payload, next) => {
         const decision = await next();

package/dist/index.js

@@ -373,7 +373,7 @@ export async function apply(ctx, config) {
     // 激活槽位(active slot):工具面 + 常驻注入 + 服务端投影(均走 ctx.effect,可撤销)
     registerSlotTools(ctx, config, stores.slots, logger, modes, live, stores.l1);
     const slotRecall = registerSlotRecall(ctx, config, stores.slots, logger, live);
-    registerSlotsProjection(ctx, stores.slots);
+    registerSlotsProjection(ctx, stores.slots, stores.l1);
     void slotRecall;
     registerMemoryRpc(ctx, config, stores, logger, {
         degraded: () => !storageOk || db.isDegraded(),

package/dist/projection/slots.d.ts

@@ -17,6 +17,20 @@ export interface SlotsViewSlot {
     kind: string;
     status: string;
     priority: number;
+    /** 原始引用(L1 record_id / 文件路径 / URL);存在才校验,旧 checkpoint 无此字段照常通过。 */
+    refs?: string[];
+    /**
+     * L1 record_id 类引用的解析视图(v0.20.2):ref → 名称简述(content 首行截断)。
+     * 前端展示用;解析发生在投影帧构建时(帧随 slots rev 刷新,L1 记录后续编辑
+     * 不回灌旧帧——引用集在写入时即冻结,可接受)。缺失/已退场记录不产生条目,
+     * 前端回落显示原始 ref。
+     */
+    refViews?: SlotRefView[];
+}
+/** 一条 record_id 引用的展示解析。 */
+export interface SlotRefView {
+    ref: string;
+    title: string;
 }
 export interface SlotsProjectionState {
     rev: number;
@@ -51,5 +65,13 @@ interface SchemaLike<T> {
 export declare const stateSchema: SchemaLike<SlotsProjectionState>;
 /** wire view 校验:registry 在 view 出网前调用(也覆盖 live drive 的发布路径)。 */
 export declare const viewSchema: SchemaLike<SlotsView>;
-export declare function registerSlotsProjection(ctx: Context, store: SlotStore): void;
+/** 投影需要的 L1 只读面(结构化声明,避免跨模块类型耦合)。 */
+export interface L1LookupFace {
+    getByIds(ids: string[]): Array<{
+        id: string;
+        content: string;
+        type: string;
+    }>;
+}
+export declare function registerSlotsProjection(ctx: Context, store: SlotStore, l1?: L1LookupFace): void;
 export {};

package/dist/projection/slots.js

@@ -40,6 +40,26 @@ function parseSlotsPayload(value, what) {
         if (typeof priority !== 'number' || !Number.isInteger(priority) || priority < 0 || priority > 100) {
             invalid(at, 'priority 必须是 0-100 的整数');
         }
+        // refs / refViews:存在才校验(附加字段,旧 checkpoint 行没有也必须整条通过)
+        if (item.refs !== undefined) {
+            if (!Array.isArray(item.refs))
+                invalid(at, 'refs 必须是字符串数组');
+            item.refs.forEach((r, i) => {
+                if (typeof r !== 'string')
+                    invalid(at + '.refs[' + i + ']', '必须是字符串');
+            });
+        }
+        if (item.refViews !== undefined) {
+            if (!Array.isArray(item.refViews))
+                invalid(at, 'refViews 必须是数组');
+            item.refViews.forEach((v, i) => {
+                const at2 = at + '.refViews[' + i + ']';
+                const view = requireRecord(v, at2);
+                if (typeof view.ref !== 'string' || typeof view.title !== 'string') {
+                    invalid(at2, 'ref/title 必须是字符串');
+                }
+            });
+        }
     });
     return value;
 }
@@ -51,9 +71,38 @@ export const stateSchema = {
 export const viewSchema = {
     parse: (value) => parseSlotsPayload(value, 'memorySlots.view'),
 };
-function buildState(store) {
+/** L1 record_id 的引用形态(newId('mem') 生成)。 */
+const RECORD_REF_PREFIX = 'mem_';
+/** refView 名称简述的截断上限(展示用,全文走 memory_receipts / memory_read_scene)。 */
+const REF_TITLE_MAX = 80;
+/**
+ * 把槽位 refs 里的 L1 record_id 解析成名称简述([type] content 首行截断)。
+ * 只解析 record_id 类引用;路径/URL 保持字面。缺失/已退场记录不产生条目。
+ */
+function resolveRefViews(refs, l1) {
+    const recordRefs = refs.filter((r) => r.startsWith(RECORD_REF_PREFIX));
+    if (recordRefs.length === 0 || l1 === undefined)
+        return undefined;
+    const byId = new Map(l1.getByIds(recordRefs).map((r) => [r.id, r]));
+    const views = [];
+    for (const ref of recordRefs) {
+        const record = byId.get(ref);
+        if (record === undefined)
+            continue;
+        const firstLine = record.content.split('\n', 1)[0] ?? '';
+        const summary = firstLine.length > REF_TITLE_MAX ? firstLine.slice(0, REF_TITLE_MAX) + '…' : firstLine;
+        views.push({ ref, title: '[' + record.type + '] ' + summary });
+    }
+    return views.length > 0 ? views : undefined;
+}
+function buildState(store, l1) {
     const snap = store.projectionSnapshot();
-    return { rev: store.revision(), count: snap.count, openCount: snap.openCount, slots: snap.slots };
+    const slots = snap.slots.map((slot) => {
+        if (slot.refs === undefined)
+            return slot;
+        return { ...slot, refViews: resolveRefViews(slot.refs, l1) };
+    });
+    return { rev: store.revision(), count: snap.count, openCount: snap.openCount, slots };
 }
 /**
  * view 引用稳定:同一 state 连续两次 view() 满足 Object.is(注册表据此判脏,
@@ -75,27 +124,22 @@ function view(state) {
 }
 /**
  * apply(state, event):同步。
- * - 仅 tool/result(settled,非 error)才检查:tool/call 在 store 变更提交前发生,按
- *   call 折会读到 stale;tool/result settled 才保证变更已落库(对齐 deliverables-fold)。
- * - 闭包 SlotStore,同步读 revision():rev 未变 → 本插件槽位未动 → 返回同引用
- *   (满足 I1b,避免 republish thrash);rev 变 → 重建快照。
- * - 任何无关事件 → 返回同引用(不 spread)。
+ * - **任意已提交事件都判脏**(v0.18.4 起):此前仅在 tool/result(settled、非 error)
+ *   时检查,实际运行中暴露出脆弱性——写入后的投影帧依赖"该会话恰好再来一条
+ *   tool/result"才刷新;跨会话场景(会话 A 写、会话 B 看)更是要等 B 自己的下一次
+ *   工具调用。改为对所有事件做 O(1) revision 比较:rev 未变 → 同引用(满足 I1b,
+ *   无 republish thrash);rev 变 → 立即重建。写入后的下一条任意事件(用户消息、
+ *   turn 边界、其他工具结果)都会把新帧推给客户端。
+ * - isError 守卫一并移除:rev 只在 store 真实变更后递增(persist 内联 RMW),
+ *   事件成败与否不影响"store 是否变了"这一事实;错误事件后重建读到的仍是
+ *   当前真实快照,不会引入错误数据。
  */
-function applySlotsEvent(state, event, store) {
-    if (event.type !== 'tool/result')
-        return state;
-    const data = event.data;
-    // v4 native（宿主 ≥0.1.7-rc.1）：isError 在 message 顶层；v3 wrapper：块上 isError（历史兼容）。
-    const isError = data?.message?.isError === true ||
-        (Array.isArray(data?.message?.content) &&
-            data.message.content.some((c) => c.isError === true));
-    if (isError)
-        return state;
+function applySlotsEvent(state, event, store, l1) {
     if (store.revision() === state.rev)
         return state;
-    return buildState(store);
+    return buildState(store, l1);
 }
-export function registerSlotsProjection(ctx, store) {
+export function registerSlotsProjection(ctx, store, l1) {
     ctx.inject(['sessionProjections'], (injected) => {
         const registry = injected
             .sessionProjections;
@@ -104,8 +148,8 @@ export function registerSlotsProjection(ctx, store) {
         registry.register({
             key: MEMORY_SLOTS_KEY,
             stateSchema,
-            init: () => buildState(store),
-            apply: (state, event) => applySlotsEvent(state, event, store),
+            init: () => buildState(store, l1),
+            apply: (state, event) => applySlotsEvent(state, event, store, l1),
             wire: { viewSchema, view },
             stateVersion: 0,
         });

package/dist/store/slots.d.ts

@@ -50,6 +50,8 @@ export interface SlotView {
     kind: SlotKind;
     status: SlotStatus;
     priority: number;
+    /** 原始引用(v0.20.2 透出,供展示侧解析 L1 record_id → 名称简述)。 */
+    refs?: string[];
 }
 export declare class SlotStore {
     private readonly file;
@@ -118,7 +120,7 @@ export declare class SlotStore {
      * 返回过期条数。
      */
     expireDue(now?: number): Promise<number>;
-    /** 投影只读快照(全量,不含 body)。 */
+    /** 投影只读快照(全量,不含 body;refs 存在才带上)。 */
     projectionSnapshot(): {
         count: number;
         openCount: number;

package/dist/store/slots.js

@@ -274,7 +274,7 @@ export class SlotStore {
             await this.persist();
         return n;
     }
-    /** 投影只读快照(全量,不含 body)。 */
+    /** 投影只读快照(全量,不含 body;refs 存在才带上)。 */
     projectionSnapshot() {
         return {
             count: this.slots.length,
@@ -285,6 +285,7 @@ export class SlotStore {
                 kind: s.kind,
                 status: s.status,
                 priority: s.priority,
+                ...(s.refs.length > 0 ? { refs: [...s.refs] } : {}),
             })),
         };
     }

package/dist/tools/index.js

@@ -135,6 +135,7 @@ roomRegistry) {
                         items: {
                             type: 'object',
                             properties: {
+                                id: { type: 'string', description: 'L1 record_id:可写入槽位 refs 或喂给 memory_receipts' },
                                 content: { type: 'string' },
                                 type: { type: 'string' },
                                 scene_name: { type: 'string' },
@@ -177,6 +178,7 @@ roomRegistry) {
             }
             return {
                 items: items.map((h) => ({
+                    id: h.id,
                     content: h.content,
                     type: h.type,
                     scene_name: h.scene_name,
@@ -1314,8 +1316,13 @@ function renderGraphCards(items) {
 function renderMemoryItems(items) {
     if (!items || items.length === 0)
         return '(没有找到相关记忆)';
+    // id 必须进渲染文本:模型看到的是 render 产物而非原始 JSON——漏了它,
+    // "search 返回 record_id" 对模型等于没返回(真机教训,v0.20.3)。
     return items
-        .map((it, i) => `${i + 1}. [${it.type ?? ''}]${it.scene_name ? ` (${it.scene_name})` : ''} ${it.content ?? ''}`)
+        .map((it, i) => {
+        const head = `${i + 1}. [${it.type ?? ''}]${it.scene_name ? ` (${it.scene_name})` : ''} ${it.content ?? ''}`;
+        return it.id ? `${head} — id: ${it.id}` : head;
+    })
         .join('\n');
 }
 function renderConversationItems(items) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",