dsh-layered-memory 0.6.0 → 0.7.0

package/dist/tools/index.js

@@ -38,17 +38,18 @@ export function registerMemoryTools(ctx, cfg, stores, logger, modes) {
                             additionalProperties: false,
                         },
                     },
+                    notice: { type: 'string', description: '非搜索结果的状态提示（如本会话记忆已关闭）' },
                 },
                 additionalProperties: false,
             },
             render: (_args, value) => [
-                { type: 'text', text: renderMemoryItems(value.items ?? []) },
+                { type: 'text', text: value.notice ?? renderMemoryItems(value.items ?? []) },
             ],
         },
         execute: async (args, exec) => {
             const family = familyOfCaller(exec.agent?.id);
             if (family === null)
-                return { items: [] };
+                return { items: [], notice: OFF_NOTICE };
             const limit = Math.min(Math.max(args.limit ?? 5, 1), 20);
             const hits = await stores.l1.search(args.query, limit, { type: args.type || undefined, family: family ?? undefined });
             return {
@@ -86,16 +87,17 @@ export function registerMemoryTools(ctx, cfg, stores, logger, modes) {
                             additionalProperties: false,
                         },
                     },
+                    notice: { type: 'string', description: '非搜索结果的状态提示（如本会话记忆已关闭）' },
                 },
                 additionalProperties: false,
             },
             render: (_args, value) => [
-                { type: 'text', text: renderConversationItems(value.items ?? []) },
+                { type: 'text', text: value.notice ?? renderConversationItems(value.items ?? []) },
             ],
         },
         execute: async (args, exec) => {
             if (familyOfCaller(exec.agent?.id) === null)
-                return { items: [] };
+                return { items: [], notice: OFF_NOTICE };
             const limit = Math.min(Math.max(args.limit ?? 5, 1), 20);
             const records = await stores.l0.search(args.query, limit);
             return {

package/dist/util/filelog.d.ts

@@ -1,4 +1,6 @@
 import type { MemoryLogger } from '../types.js';
+/** 体积检查抽样间隔：每 N 条写检查一次，减少同步 stat 系统调用（超限误差 ≤ N 条日志）。 */
+export declare const SIZE_CHECK_INTERVAL = 32;
 /** 错误对象转带堆栈的单行描述（诊断日志用，非 Error 直接字符串化）。 */
 export declare function errDetail(err: unknown): string;
 export declare function withFileLog(dataDir: string, logger: MemoryLogger): MemoryLogger;

package/dist/util/filelog.js

@@ -3,9 +3,13 @@
  * 这里镜像 warn/error/info 到数据目录 memory.log，供事后诊断蒸馏管线。
  * 写入失败静默忽略——诊断日志绝不能反过来拖垮管线。
  */
-import { appendFileSync, existsSync, renameSync, statSync } from 'node:fs';
+import { appendFileSync, existsSync, renameSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 const MAX_LOG_BYTES = 2 * 1024 * 1024;
+/** 轮转 rename 连续失败多少次后放弃归档、直接截断重开（Windows 文件占用兜底）。 */
+const ROTATE_FAIL_LIMIT = 5;
+/** 体积检查抽样间隔：每 N 条写检查一次，减少同步 stat 系统调用（超限误差 ≤ N 条日志）。 */
+export const SIZE_CHECK_INTERVAL = 32;
 /** 错误对象转带堆栈的单行描述（诊断日志用，非 Error 直接字符串化）。 */
 export function errDetail(err) {
     if (err instanceof Error)
@@ -14,10 +18,23 @@ export function errDetail(err) {
 }
 export function withFileLog(dataDir, logger) {
     const logPath = join(dataDir, 'memory.log');
+    let rotateFailures = 0;
+    let writesSinceCheck = 0;
     const write = (level, msg) => {
         try {
-            if (existsSync(logPath) && statSync(logPath).size > MAX_LOG_BYTES) {
-                renameSync(logPath, `${logPath}.1`);
+            if (writesSinceCheck++ % SIZE_CHECK_INTERVAL === 0 && existsSync(logPath) && statSync(logPath).size > MAX_LOG_BYTES) {
+                try {
+                    renameSync(logPath, `${logPath}.1`);
+                    rotateFailures = 0;
+                }
+                catch {
+                    // rename 可能因文件被占用失败（Windows EBUSY）：连续失败达上限后
+                    // 截断重开，保住"日志体积有上界"的底线（放弃 .1 归档，保当前日志可用）
+                    if (++rotateFailures >= ROTATE_FAIL_LIMIT) {
+                        writeFileSync(logPath, '');
+                        rotateFailures = 0;
+                    }
+                }
             }
             appendFileSync(logPath, `${new Date().toISOString()} [${level}] ${msg}\n`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-layered-memory",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "L0~L3 分层蒸馏记忆插件 for DeepSeek Harness：自动捕获对话（L0）、抽取原子记忆（L1）、整合场景块（L2）、蒸馏核心画像/团队方法论（L3），并在模型步骤前自动召回注入。移植自 MemoryCore (TencentDB Agent Memory) 的管线设计。",
   "type": "module",
   "main": "dist/index.js",

package/assets/readme/hero.svg

@@ -1,58 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg"
-     width="1200" height="400" viewBox="0 0 1200 400"
-     role="img" aria-labelledby="title desc">
-  <title id="title">dsh-layered-memory</title>
-  <desc id="desc">DeepSeek Harness 分层蒸馏记忆插件：对话经 L0 捕获、L1 原子记忆、L2 场景整合、L3 画像蒸馏四层提炼，宽度递减表示数据精炼；模型每一步前自动召回注入。</desc>
-
-  <rect width="1200" height="400" rx="26" fill="#0B0E14"/>
-
-  <!-- ── 标题区 ── -->
-  <g id="title-block" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">
-    <text x="64" y="88" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
-          font-size="22" letter-spacing="2" fill="#8B93A7">DEEPSEEK HARNESS · PERSISTENT PLUGIN</text>
-    <text x="64" y="152" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
-          font-size="48" font-weight="700" fill="#F2F3F5">dsh-layered-memory</text>
-    <text x="64" y="198" font-size="34" fill="#C9CFDB">对话自动分层蒸馏成记忆，</text>
-    <text x="64" y="244" font-size="34" fill="#C9CFDB">模型每步前自动召回注入。</text>
-    <text x="64" y="288" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
-          font-size="18" fill="#6B7484">MIT LICENSE · v0.5.0 · SESSION-LEVEL MODES</text>
-  </g>
-
-  <!-- ── 分层管线（宽度递减 = 数据精炼） ── -->
-  <g id="distill-pipeline">
-    <!-- L0 -->
-    <rect x="704" y="96" width="436" height="46" rx="12" fill="#11161F" stroke="#232A38" stroke-width="1.5"/>
-    <circle cx="732" cy="119" r="6" fill="#2DD4BF"/>
-    <text x="760" y="126" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="20" fill="#2DD4BF">L0</text>
-    <text x="800" y="126" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif" font-size="20" fill="#F2F3F5">原始对话</text>
-    <text x="1120" y="126" text-anchor="end" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="16" fill="#6B7484">conversations/</text>
-    <!-- L1 -->
-    <rect x="704" y="158" width="396" height="46" rx="12" fill="#11161F" stroke="#232A38" stroke-width="1.5"/>
-    <circle cx="732" cy="181" r="6" fill="#2DD4BF"/>
-    <text x="760" y="188" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="20" fill="#2DD4BF">L1</text>
-    <text x="800" y="188" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif" font-size="20" fill="#F2F3F5">原子记忆</text>
-    <text x="1080" y="188" text-anchor="end" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="16" fill="#6B7484">records/</text>
-    <!-- L2 -->
-    <rect x="704" y="220" width="356" height="46" rx="12" fill="#11161F" stroke="#232A38" stroke-width="1.5"/>
-    <circle cx="732" cy="243" r="6" fill="#2DD4BF"/>
-    <text x="760" y="250" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="20" fill="#2DD4BF">L2</text>
-    <text x="800" y="250" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif" font-size="20" fill="#F2F3F5">场景块</text>
-    <text x="1040" y="250" text-anchor="end" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="16" fill="#6B7484">scenes/</text>
-    <!-- L3 -->
-    <rect x="704" y="282" width="316" height="46" rx="12" fill="#11161F" stroke="#232A38" stroke-width="1.5"/>
-    <circle cx="732" cy="305" r="6" fill="#2DD4BF"/>
-    <text x="760" y="312" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="20" fill="#2DD4BF">L3</text>
-    <text x="800" y="312" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif" font-size="20" fill="#F2F3F5">核心画像</text>
-    <text x="1010" y="312" text-anchor="end" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="16" fill="#6B7484">persona-*.md</text>
-
-    <!-- 层间蒸馏箭头（左侧圆点列） -->
-    <path d="M732 142 v10 l-5 -5 M732 152 l5 -5" stroke="#2DD4BF" stroke-width="2" fill="none"/>
-    <path d="M732 204 v10 l-5 -5 M732 214 l5 -5" stroke="#2DD4BF" stroke-width="2" fill="none"/>
-    <path d="M732 266 v10 l-5 -5 M732 276 l5 -5" stroke="#2DD4BF" stroke-width="2" fill="none"/>
-
-    <!-- 召回回路说明 -->
-    <circle cx="716" cy="352" r="5" fill="#F5A623"/>
-    <text x="734" y="357" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
-          font-size="18" fill="#8B93A7">pre-step 自动召回注入 · 与写入同档</text>
-  </g>
-</svg>