@max-null/dsh-memory 0.4.1 → 0.5.2

package/dist/injection.js

@@ -0,0 +1,52 @@
+/**
+ * 注入渲染（0.5.2）：`memory:recall` 与面板「注入预览」共用的确定性
+ * 渲染——摘要化 + 预算截断。纯函数、无模型调用：注入行 = 每条记忆的
+ * 单行摘要（内容过长取首行截断），超出预算（字符数）时按「最近更新
+ * 优先」贪心保留，省略计数返回给 UI 提示。
+ */
+/** 摘要截断上限（字符）：中英混合场景下 ~40-60 token。 */
+export const DEFAULT_SUMMARY_CHARS = 80;
+/** 注入预算（字符）：0.5.2 起默认开启，防常驻注入随记忆增长膨胀上下文。 */
+export const DEFAULT_INJECTION_BUDGET = 1500;
+/** 单条注入行的固定标记开销（不含摘要本体）。 */
+const LINE_OVERHEAD = 27;
+/**
+ * 确定性摘要：取首行，超过 maxChars 截断加省略号。
+ * 空内容/空首行回退为去掉换行后的前 maxChars（保证 any 内容有摘要）。
+ */
+export function deriveSummary(content, maxChars) {
+    const firstLine = content.split('\n')[0].trim();
+    if (firstLine !== '') {
+        return firstLine.length <= maxChars ? firstLine : `${firstLine.slice(0, maxChars)}…`;
+    }
+    const collapsed = content.replace(/\s+/g, ' ').trim();
+    if (collapsed === '')
+        return content;
+    return collapsed.length <= maxChars ? collapsed : `${collapsed.slice(0, maxChars)}…`;
+}
+/** 一条注入行的渲染文本（与面板预览完全一致）。 */
+export function injectionLine(record, summaryChars) {
+    return `- [memory:${String(record.id).slice(0, 8)}:${record.namespace}] ${deriveSummary(record.content, summaryChars)}`;
+}
+/**
+ * 由候选记录渲染注入行：按使用序降序（lastUsedAt 优先、缺省回退
+ * updatedAt——最近使用/更新的记忆最先），逐条累加开销直到预算用尽；
+ * 预算为 null 或非正数时全量注入（不过滤）。
+ */
+export function renderInjection(records, budget, summaryChars) {
+    const ordered = [...records].sort((left, right) => (right.lastUsedAt ?? right.updatedAt) - (left.lastUsedAt ?? left.updatedAt));
+    const lines = [];
+    let chars = 0;
+    let omitted = 0;
+    for (const record of ordered) {
+        const text = injectionLine(record, summaryChars);
+        const cost = text.length + LINE_OVERHEAD;
+        if (budget !== null && budget > 0 && chars + cost > budget) {
+            omitted++;
+            continue;
+        }
+        lines.push(text);
+        chars += cost;
+    }
+    return { lines, budget: budget ?? null, omitted, chars };
+}

package/dist/remote.d.ts

@@ -29,12 +29,16 @@ export declare class MemoryGateway extends TypertRemoteService {
     /** Force-reload storage files (external edits; JsonStorageBackend has no watch). */
     reload(cwd?: string): Promise<MemoryRecord[]>;
     /**
-     * 注入预览（0.3.5）：开发者查看当前注入到 system prompt 的记忆内容
-     * ——self 自述 + 实际注入的 global approved+injected 记忆。
+     * 注入预览（0.3.5 + 0.5.2）：开发者查看当前注入到 system prompt 的记忆
+     * 内容——self 自述 + 当前会话工作区（cwd）的 approved+injected 记忆，
+     * 经摘要化 + 预算截断（与 memory:recall 同源渲染）。
      */
-    injectionPreview(): {
+    injectionPreview(cwd?: string, budget?: number | null, summaryChars?: number): Promise<{
         self: string;
-        injected: MemoryRecord[];
-    };
+        lines: string[];
+        budget: number | null;
+        omitted: number;
+        chars: number;
+    }>;
 }
 export default MemoryGateway;

package/dist/remote.js

@@ -43,6 +43,7 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
 import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol';
 import { MemoryId } from "./engine.js";
 import { SELF_DESCRIPTION } from "./self.js";
+import { DEFAULT_INJECTION_BUDGET, DEFAULT_SUMMARY_CHARS, renderInjection } from "./injection.js";
 /** Client-callable memory surface; registered as the `memory` Typert namespace. */
 let MemoryGateway = (() => {
     let _classSuper = TypertRemoteService;
@@ -109,11 +110,17 @@ let MemoryGateway = (() => {
             return this.ctx.memory.list({}, cwd);
         }
         /**
-         * 注入预览（0.3.5）：开发者查看当前注入到 system prompt 的记忆内容
-         * ——self 自述 + 实际注入的 global approved+injected 记忆。
+         * 注入预览（0.3.5 + 0.5.2）：开发者查看当前注入到 system prompt 的记忆
+         * 内容——self 自述 + 当前会话工作区（cwd）的 approved+injected 记忆，
+         * 经摘要化 + 预算截断（与 memory:recall 同源渲染）。
          */
-        injectionPreview() {
-            return { self: SELF_DESCRIPTION, injected: this.ctx.memory.recallRecords() };
+        async injectionPreview(cwd, budget, summaryChars) {
+            if (cwd !== undefined)
+                await this.ctx.memory.ensureProjectOpen(cwd);
+            return {
+                self: SELF_DESCRIPTION,
+                ...renderInjection(this.ctx.memory.recallRecords(cwd), budget ?? DEFAULT_INJECTION_BUDGET, summaryChars ?? DEFAULT_SUMMARY_CHARS),
+            };
         }
     };
 })();

package/dist/routes.js

@@ -1,5 +1,6 @@
 import { createRequire } from 'node:module';
 import { SELF_DESCRIPTION } from "./self.js";
+import { DEFAULT_INJECTION_BUDGET, DEFAULT_SUMMARY_CHARS, renderInjection } from "./injection.js";
 const require = createRequire(import.meta.url);
 /** Body size bound of one JSON request. */
 const MAX_BODY_BYTES = 1 << 20;
@@ -168,11 +169,20 @@ export function mountMemoryApi(ctx) {
                 ...record.keywords === undefined ? {} : { keywords: record.keywords },
             }, cwdOf(record));
         },
-        'injectionPreview': () => {
+        'injectionPreview': async (payload) => {
             const memory = ctx.get('memory');
             if (memory === undefined)
                 throw new MemoryApiError('service-unavailable', 'memory service unavailable', 503);
-            return { self: SELF_DESCRIPTION, injected: memory.recallRecords() };
+            const record = payload;
+            const cwd = cwdOf(record);
+            if (cwd !== undefined)
+                await memory.ensureProjectOpen(cwd);
+            // 0.5.2：预览与真实注入同源（renderInjection）——摘要化 + 预算截断一致
+            const budget = typeof record?.budget === 'number' && record.budget > 0
+                ? record.budget
+                : record?.budget === null ? null : DEFAULT_INJECTION_BUDGET;
+            const summaryChars = typeof record?.summaryChars === 'number' && record.summaryChars > 0 ? record.summaryChars : DEFAULT_SUMMARY_CHARS;
+            return { self: SELF_DESCRIPTION, ...renderInjection(memory.recallRecords(cwd), budget, summaryChars) };
         },
     };
     const fence = (req) => isTrusted(req, webRuntime.trustedHosts);

package/dist/self.js

@@ -18,8 +18,8 @@ const SELF_VERSION = (() => {
 export const SELF_DESCRIPTION = `[记忆系统自述] 当前环境内置跨会话记忆服务（dsh-memory v${SELF_VERSION}）。`
     + '工作机制：①记忆以明文 JSON 存储（global→$DSH_HOME/storages、工作区→会话工作区 .dsh/storages 随 git 分享）；'
     + '②模型写入即 suggested（待审核），仅人工审核（memory_confirm）后才 approved；'
-    + '③每轮注入 system prompt 的只有「global 的 approved + injected 开关打开」的记忆（常驻注入由用户控制，审核≠注入）；'
-    + '④工作区记忆按会话工作区路由，靠 memory_search 检索（含待审核条目，可先评估再引用）；'
+    + '③每轮注入 system prompt 的 = 「global 的 approved + injected」+「当前会话工作区的 approved + injected」，逐条为单行摘要（内容全文靠 memory_search 检索），并受注入预算限制（超预算按最近更新优先，省略条数在面板「注入预览」可见；常驻注入由用户控制，审核≠注入）；'
+    + '④工作区记忆按会话工作区路由（存储跟随仓库），memory_search 为 BM25 检索（中文 2-gram + 关键词加权，可配置语义融合），可检索任意状态（含待审核条目，可先评估再引用）；'
     + '⑤修正过时内容用 memory_update（改动重置待审核，注入开关保留）。'
     + `可用记忆工具共 6 个：memory_save / memory_list / memory_search / memory_confirm / memory_forget / memory_update。`
     + '使用建议：相关历史上下文先 memory_search 检索再引用；新习惯/约定用 memory_save 写入（落在待审核）。'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-memory",
-  "version": "0.4.1",
+  "version": "0.5.2",
   "description": "Cross-session plaintext memory plugin for the DeepSeek Harness — deterministic BM25 recall, human-owned, no embeddings",
   "license": "MIT",
   "publishConfig": {
@@ -61,22 +61,22 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-storage": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-storage-domain": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-storage-json": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-system-prompt": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.0.1-rc.5"
+    "@deepseek-ai/dsh-storage": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
-    "@deepseek-ai/dsh-storage": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-storage-domain": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-storage-json": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-system-prompt": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.0.1-rc.5",
+    "@deepseek-ai/dsh-storage": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.1",
     "@types/node": "^26.2.0",
     "tsx": "^4.0.0",
     "typescript": "^5.5.0",