@max-null/dsh-memory 0.9.0 → 0.9.1

package/README.md

@@ -86,7 +86,7 @@ memory_forget        →  随时删除（删除始终是人的动作）
 
 自动规则对**低频但关键**的记忆（长期约定、判据、委托）够不着：它们不会被反复检索，够不到阈值；勉强够到也会被 30 天撤下。这类走显式路径——在 `memory_save` / `memory_update` 里给 `injected` 即钉住，写的是与面板开关同一套语义（`injectedAuto: false`），此后不受两条自动规则影响。未审核与已隔离的记录不接受注入。
 
-注入有**字符预算**（默认 1500，config `injectionBudget`）：装不下的条目**整条丢弃**（不截内容），按「最近更新优先」取舍——所以 `injected: true` 不等于「每轮真的在场」，它只保证有资格排队。0.9.0 起这种出局不再无声：注入末尾会追加一行 `（另有 N 条常驻因预算未注入：id1, id2, …）`，**清理干净即自行消失**；面板的注入预览里也能展开看明细。诊断行本身不占预算。
+注入有**字符预算**（默认 1500，config `injectionBudget`）：装不下的条目**整条丢弃**（不截内容），按「最近更新优先」取舍——所以 `injected: true` 不等于「每轮真的在场」，它只保证有资格排队。0.9.0 起这种出局不再无声：注入末尾会追加一行 `（另有 N 条常驻因预算未注入：…）`，0.9.1 起列出的是**每条的短摘要**而不是 id——查 id 是什么的那一步最容易省略，省略了就等于没报；**清理干净即自行消失**。面板的注入预览里也能展开看明细。诊断行本身不占预算。
 
 记忆还可声明**有效性锚点**（环境变量 / 工具清单 / 插件版本）：所绑的值变化后，这条记忆被标记 `stale` 并撤下常驻，检索结果里也带出失效提示——环境变了，旧结论就不再被当成仍然正确。
 

package/dist/injection.d.ts

@@ -9,8 +9,10 @@ import type { MemoryRecord } from './engine.ts';
 export declare const DEFAULT_SUMMARY_CHARS = 80;
 /** 注入预算（字符）：0.5.2 起默认开启，防常驻注入随记忆增长膨胀上下文。 */
 export declare const DEFAULT_INJECTION_BUDGET = 1500;
-/** 诊断行列出的 id 上限（2026-09-18）：超出只列前 N 个，防这行本身失控。 */
-export declare const OMITTED_ID_LIMIT = 12;
+/** 诊断行列出的条数上限（2026-09-18）：超出只列前 N 个，防这行本身失控。 */
+export declare const OMITTED_NOTICE_LIMIT = 12;
+/** 诊断行里每条出局者的摘要长度（2026-09-18）：够认出是哪条即可。 */
+export declare const OMITTED_SUMMARY_CHARS = 24;
 /**
  * 确定性摘要：取首行，超过 maxChars 截断加省略号。
  * 空内容/空首行回退为去掉换行后的前 maxChars（保证 any 内容有摘要）。
@@ -26,13 +28,14 @@ export interface InjectionRender {
     /** 因预算被省略的候选条数（0 = 全部注入）。 */
     omitted: number;
     /**
-     * 被省略条目的明细：`id` 供预算诊断行与后续清理定位，`line` 与 {@link lines}
-     * 同格式，供面板明细直接渲染。诊断行**不占预算**——它由 `recallText` 追加在
-     * 注入行之后，不参与这里的截断。
+     * 被省略条目的明细：`summary` 供预算诊断行报出「是哪条」，`line` 与
+     * {@link lines} 同格式、供面板明细直接渲染，`id` 备用。诊断行**不占预算**——
+     * 它由 `recallText` 追加在注入行之后，不参与这里的截断。
      */
     omittedRecords: Array<{
         id: string;
         line: string;
+        summary: string;
     }>;
     /** 实际注入的字符数（摘要 + 标记开销之和；不含 {@link omittedRecords}）。 */
     chars: number;
@@ -44,8 +47,10 @@ export interface InjectionRender {
  */
 export declare function renderInjection(records: readonly MemoryRecord[], budget: number | null, summaryChars: number): InjectionRender;
 /**
- * 预算诊断行（2026-09-18）：列 id 而非摘要——列全文要约 4000 字符，id 列表约
- * 100 字符。**不占注入预算**（调用方把它追加在注入行之后），清理干净后自行消失
- * （`omitted === 0` 返回空串）；超出 {@link OMITTED_ID_LIMIT} 只列前 N 个。
+ * 预算诊断行（2026-09-18）：列出被预算挡在外面的条目，**带短摘要而不是只有 id**——
+ * 「主动去查这个 id 是什么」正是最容易省略的那一步，而省略它就等于看不出来。
+ * 只报出局者、不报进场者（后者本来就在注入列表里）。**不占注入预算**（调用方把它
+ * 追加在注入行之后），清理干净后自行消失（`omitted === 0` 返回空串）；超出
+ * {@link OMITTED_NOTICE_LIMIT} 只列前 N 个。
  */
 export declare function omittedNotice(rendered: InjectionRender): string;

package/dist/injection.js

@@ -8,8 +8,10 @@
 export const DEFAULT_SUMMARY_CHARS = 80;
 /** 注入预算（字符）：0.5.2 起默认开启，防常驻注入随记忆增长膨胀上下文。 */
 export const DEFAULT_INJECTION_BUDGET = 1500;
-/** 诊断行列出的 id 上限（2026-09-18）：超出只列前 N 个，防这行本身失控。 */
-export const OMITTED_ID_LIMIT = 12;
+/** 诊断行列出的条数上限（2026-09-18）：超出只列前 N 个，防这行本身失控。 */
+export const OMITTED_NOTICE_LIMIT = 12;
+/** 诊断行里每条出局者的摘要长度（2026-09-18）：够认出是哪条即可。 */
+export const OMITTED_SUMMARY_CHARS = 24;
 /** 单条注入行的固定标记开销（不含摘要本体）。 */
 const LINE_OVERHEAD = 27;
 /**
@@ -46,7 +48,11 @@ export function renderInjection(records, budget, summaryChars) {
         const cost = text.length + LINE_OVERHEAD;
         if (budget !== null && budget > 0 && chars + cost > budget) {
             omitted++;
-            omittedRecords.push({ id: String(record.id), line: text });
+            omittedRecords.push({
+                id: String(record.id),
+                line: text,
+                summary: deriveSummary(record.content, OMITTED_SUMMARY_CHARS),
+            });
             continue;
         }
         lines.push(text);
@@ -55,15 +61,17 @@ export function renderInjection(records, budget, summaryChars) {
     return { lines, budget: budget ?? null, omitted, omittedRecords, chars };
 }
 /**
- * 预算诊断行（2026-09-18）：列 id 而非摘要——列全文要约 4000 字符，id 列表约
- * 100 字符。**不占注入预算**（调用方把它追加在注入行之后），清理干净后自行消失
- * （`omitted === 0` 返回空串）；超出 {@link OMITTED_ID_LIMIT} 只列前 N 个。
+ * 预算诊断行（2026-09-18）：列出被预算挡在外面的条目，**带短摘要而不是只有 id**——
+ * 「主动去查这个 id 是什么」正是最容易省略的那一步，而省略它就等于看不出来。
+ * 只报出局者、不报进场者（后者本来就在注入列表里）。**不占注入预算**（调用方把它
+ * 追加在注入行之后），清理干净后自行消失（`omitted === 0` 返回空串）；超出
+ * {@link OMITTED_NOTICE_LIMIT} 只列前 N 个。
  */
 export function omittedNotice(rendered) {
     if (rendered.omitted === 0)
         return '';
-    const ids = rendered.omittedRecords.map(record => String(record.id).slice(0, 8));
-    const shown = ids.slice(0, OMITTED_ID_LIMIT);
-    const truncated = ids.length > shown.length ? '…' : '';
-    return `（另有 ${rendered.omitted} 条常驻因预算未注入：${shown.join(', ')}${truncated}）`;
+    const shown = rendered.omittedRecords.slice(0, OMITTED_NOTICE_LIMIT);
+    const labels = shown.map(record => record.summary);
+    const truncated = rendered.omittedRecords.length > shown.length ? '…' : '';
+    return `（另有 ${rendered.omitted} 条常驻因预算未注入：${labels.join('、')}${truncated}）`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-memory",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Cross-session plaintext memory plugin for the DeepSeek Harness — deterministic BM25 recall, writes take effect immediately, signal-driven injection, no embeddings",
   "license": "MIT",
   "publishConfig": {