dsh-memory-palace 1.8.0-alpha.2 → 1.8.0

package/README.md

@@ -2,7 +2,7 @@
 
 把 WorkBuddy 的文件式记忆系统移植进 [DeepSeek Harness](https://www.deepseek.com/harness/) —— 为 Harness 提供**跨会话持久化、人类可直接编辑的 Markdown 记忆**。
 
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![npm](https://img.shields.io/npm/v/dsh-memory-palace.svg?label=npm&labelColor=000000&color=ff4b01)](https://www.npmjs.com/package/dsh-memory-palace) [![DeepSeek Harness:0.1.7-rc.2](https://img.shields.io/badge/DeepSeek%20Harness-0.1.7--rc.2-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness) [![Desktop: supported](https://img.shields.io/badge/Desktop-supported-success.svg?labelColor=4D6BFE)](#安装)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![npm](https://img.shields.io/npm/v/dsh-memory-palace.svg?label=npm&labelColor=000000&color=ff4b01)](https://www.npmjs.com/package/dsh-memory-palace) [![DeepSeek Harness:0.2.0-rc.1](https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.1-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness) [![Desktop: supported](https://img.shields.io/badge/Desktop-supported-success.svg?labelColor=4D6BFE)](#安装)
 
 ## 特性
 
@@ -79,7 +79,7 @@
 
 ```bash
 dsh plugin --profile web add github:lovezi0/dsh-memory-palace
-# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.7.2
+# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.8.0
 ```
 
 方式二：clone 后本地安装（开发 / 修改源码场景）
@@ -124,6 +124,11 @@ dsh plugin --profile web remove dsh-memory-palace
 ## 版本历史
 
 - **1.8.0**
+    - dsh peer [0.1.7 ... 0.2.0]
+    - npm publish
+    - **1.8.0-alpha.4**
+        - 💥移除 stderr log 输出
+        - 💪新增不同 profiles 场景下 log文件 *详情见 [DEVELOPMENT.md](./DEVELOPMENT.md#日志落盘)*
     - **1.8.0-alpha.2**
         - 🐛修复多会话并发导致写侧串台 @sunligh91
         - 🐛删除会话分桶后遗留的三个全局状态死字段

package/lib/client.js

@@ -69,7 +69,7 @@ window.__ModuleLoader__.load({
       notifyProjectDone: "项目记忆蒸馏完成",
       notifyFail: "记忆蒸馏失败",
       distillDebugLogLabel: "蒸馏调试日志",
-      distillDebugLogHint: "开启后向 dsh 服务端控制台（stderr）输出蒸馏 LLM 调用诊断。info 级别仅输出元数据（不含文本）；配合 distillLogLevel=debug 会额外打印 LLM 原始响应（分隔符包裹），仅限受信本地排障。",
+      distillDebugLogHint: "开启后把本插件全部诊断日志落盘到 profile 目录下的 .memory-palace/logs/<会话 id>/（不再输出控制台）。info.log 收失败/跳过留痕与子代理终态台账；debug.log 收详单，配合 distillLogLevel=debug 时另含 LLM 原始响应。关闭时零输出，仅排障用。",
       dev: "开发",
       devDesc: "蒸馏调试日志与超时",
       distillTimeoutLabel: "蒸馏超时（秒）",
@@ -143,7 +143,7 @@ window.__ModuleLoader__.load({
       notifyProjectDone: "Project memory distilled",
       notifyFail: "Memory distillation failed",
       distillDebugLogLabel: "Distill debug log",
-      distillDebugLogHint: "When on, prints distill LLM call diagnostics to the dsh server console (stderr). info level prints metadata only (no text); with distillLogLevel=debug it additionally prints the raw LLM response (wrapped in delimiters), for trusted local troubleshooting only.",
+      distillDebugLogHint: "When on, writes all plugin diagnostics to .memory-palace/logs/<session-id>/ under the profile directory (no console output). info.log holds failure/skip traces and the subagent ledger; debug.log holds verbose detail plus the raw LLM response when distillLogLevel=debug. Off means zero output; troubleshooting only.",
       dev: "Developer",
       devDesc: "Distill debug log and timeout",
       distillTimeoutLabel: "Distill timeout (s)",

package/lib/common/logger.mjs

@@ -0,0 +1,150 @@
+// dsh-memory-palace v1.8.0-alpha.4：统一日志落盘模块。
+//
+// 背景：插件原先所有诊断输出走 console.error → dsh 服务端 stderr。但 Desktop 下 stderr 只进
+// host 进程内存（apps/desktop/src/host-process.ts:204 存末 64KB），仅崩溃时随报告落盘，正常运行
+// 时完全不可见；而插件其余落盘点只有 Markdown 记忆文件 —— 于是子代理的失败/跳过、蒸馏链路的
+// 跳过原因全都无痕可查。
+//
+// 落点（与 dsh 原生 @deepseek-ai/dsh-plugin-manager 同构）：
+//   <profileContext.dir>/.memory-palace/logs/<session-id>/<level>.log
+//   其中 profileContext.dir = $DSH_HOME/profiles/<profile>。取径依据：宿主 CLI 与 Desktop 都经
+//   同一个 runProfile 启动（apps/cli/src/profile-boot.ts:298 provide、apps/desktop-host/src/index.ts:25
+//   runProfile({profile:'desktop'})），故 ctx.get('profileContext').dir 两端都可用。
+//
+// 门控：统一受 distillDebugLog 控制 —— false（默认）时零输出（既不写终端也不写文件）。
+// 分级：按【行级别】分流 —— warn/info → info.log；debug → debug.log。
+//
+// 失败安全：调用方都位于 turn 结算 / pre-step 钩子栈上，抛错会污染整个 turn（agent/pre-step 抛错
+// 毁 turn 是已知宿主契约），故所有 fs 错误一律吞掉；写入经独立 promise 链串行（不与记忆落盘锁
+// 共用 —— 日志 IO 不得拖慢记忆写入，且二者语义无关）。
+import { appendFile, mkdir, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+
+/** 单文件大小上限（字节）；超出后停止追加（不删旧内容）。 */
+const MAX_FILE_BYTES = 1024 * 1024;
+/**
+ * 拿不到会话身份时的兜底目录名。
+ * ⚠️ 必须与 index.mjs 既有的 `__nosession__` 约定一致（`sid || "__nosession__"`），
+ * 否则会出现两套"无身份"目录并存，排查时难以判断哪份是哪条路径落的。
+ */
+const NO_SESSION = "__nosession__";
+
+/** 本地时间戳（禁用 toISOString：UTC 会跨日错位，见 AGENTS.md §⑤）。 */
+function stamp() {
+  const d = new Date();
+  const p = (n, w = 2) => String(n).padStart(w, "0");
+  return (
+    `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ` +
+    `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`
+  );
+}
+
+/** JSON 化额外字段；循环引用等异常一律降级为字符串（日志失败不得影响主流程）。 */
+function safeJson(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+
+/**
+ * @param {{ ctx: object, getConfig: () => object }} deps
+ * @returns {{ for: (sessionId?: string, scope?: string) => object }}
+ */
+export function createLogger({ ctx, getConfig }) {
+  let chain = Promise.resolve(); // 独立写链（全局串行）
+  const capped = new Set();      // 已达大小上限的文件（停止追加）
+  const prepared = new Set();    // 已确保存在的目录
+
+  // 落盘根 = profile 目录 + 私有尾目录。profileContext 缺失（测试 mock / 非 dsh 启动的宿主）时
+  // 返回 null → 放弃落盘，绝不猜路径（process.cwd() 在 CLI 下是用户目录；import.meta.url 在
+  // 本地软链安装下解析到开发仓库路径，二者都不可靠）。
+  function logRoot() {
+    const pc = typeof ctx?.get === "function" ? ctx.get("profileContext") : undefined;
+    const dir = pc?.dir;
+    return typeof dir === "string" && dir ? join(dir, ".memory-palace", "logs") : null;
+  }
+
+  function fileOf(root, sessionId, level) {
+    const box = typeof sessionId === "string" && sessionId ? sessionId : NO_SESSION;
+    return join(root, box, level === "debug" ? "debug.log" : "info.log");
+  }
+
+  async function put(file, text) {
+    if (capped.has(file)) return;
+    const dir = dirname(file);
+    if (!prepared.has(dir)) {
+      // 0700/0600：与原生 plugin-manager 同款收紧（日志含 cwd / sessionId / 路径等本机信息）。
+      // Windows 下 mode 不生效但不报错（plugin-manager 同样如此）；Linux/macOS 上生效。
+      await mkdir(dir, { recursive: true, mode: 0o700 });
+      prepared.add(dir);
+    }
+    const info = await stat(file).catch(() => null);
+    if (info !== null && info.size >= MAX_FILE_BYTES) {
+      capped.add(file);
+      return;
+    }
+    // mode 仅在文件首次创建时生效（已存在则忽略），故对新老文件都安全。
+    await appendFile(file, text, { encoding: "utf8", mode: 0o600 });
+  }
+
+  /** 入链写入（fire-and-forget）：调用点同步返回，异常全部吞掉。 */
+  function enqueue(file, text) {
+    chain = chain.then(() => put(file, text)).catch(() => {});
+  }
+
+  /** 门控 + 取径 + 入链；任一环节不可用即静默返回。 */
+  function emit(sessionId, level, scope, why, extra) {
+    let cfg = null;
+    try {
+      cfg = getConfig();
+    } catch {
+      return;
+    }
+    if (!cfg?.distillDebugLog) return;
+    const root = logRoot();
+    if (!root) return;
+    const tail = extra === undefined ? "" : ` ${safeJson(extra)}`;
+    enqueue(fileOf(root, sessionId, level), `${stamp()} [${level}] ${scope} · ${why}${tail}\n`);
+  }
+
+  return {
+    /** 等待已入链的写入全部落盘（测试用；生产侧 fire-and-forget，无需等待）。 */
+    flush: () => chain,
+    /**
+     * 绑定会话与模块名，返回该作用域的日志器。
+     * @param {string|undefined} sessionId 会话 id（缺省落 __nosession__/）
+     * @param {string} scope 模块名（subagent / distill / projection / plugin）
+     */
+    for(sessionId, scope) {
+      const name = scope || "plugin";
+      return {
+        /** 失败/跳过留痕（warn 级 → info.log）。 */
+        dbgFail: (why, extra) => emit(sessionId, "warn", name, why, extra),
+        /** 详单（debug 级 → debug.log）。 */
+        dbg: (why, extra) => emit(sessionId, "debug", name, why, extra),
+        /** 信息行（info 级 → info.log），如子代理终态台账。 */
+        info: (why, extra) => emit(sessionId, "info", name, why, extra),
+        /** LLM 原始响应等文本块（debug 级 → debug.log）；调用点须已过双门控。 */
+        raw(text) {
+          let cfg = null;
+          try {
+            cfg = getConfig();
+          } catch {
+            return;
+          }
+          if (!cfg?.distillDebugLog) return;
+          const root = logRoot();
+          if (!root) return;
+          enqueue(
+            fileOf(root, sessionId, "debug"),
+            `${stamp()} [debug] ${name} · llm raw text begin >>>\n` +
+              `--------------------------->\n${text}\n<----------------------------\n` +
+              `${stamp()} [debug] ${name} · llm raw text end <<<\n`,
+          );
+        },
+      };
+    },
+  };
+}

package/lib/distill.mjs

@@ -13,14 +13,18 @@ import { runWithRetry, RETRY_CONSTANTS } from "./common/retry.mjs";
 /**
  * @param {{ ctx: object, getConfig: () => object, paths: object, records: object }} deps
  */
-export function createDistill({ ctx, getConfig, paths, records }) {
+export function createDistill({ ctx, getConfig, paths, records, logger }) {
   const cfg = () => getConfig();
 
-  // 调试日志（v1.3.0）：dbgFail=失败/跳过留痕（无条件输出，不受开关控制，保证排障可观测）；
-  // dbg=受 distillDebugLog 开关控制的详单（模型解析/请求参数/流进度计数/错误详情）。
-  // 隐私红线：只打计数/字符数/元数据/错误 message+stack 首行，绝不打印对话或 MEMORY.md 文本。
-  const dbgFail = (why, extra) => console.error(`[memory-palace] distill skip: ${why}`, extra ? JSON.stringify(extra) : "");
-  const dbg = (why, extra) => { if (!cfg().distillDebugLog) return; console.error(`[memory-palace][debug] ${why}`, extra !== undefined ? JSON.stringify(extra) : ""); };
+  // 日志（v1.8.0-alpha.4）：原 stderr 输出改为经统一 logger 落盘
+  // （`<profileDir>/.memory-palace/logs/<sessionId>/{info,debug}.log`，见 common/logger.mjs）。
+  // 按【会话】取作用域日志器——工厂级闭包会让并发会话的日志落到同一目录；logger 未注入时降级为 no-op。
+  // dbgFail=失败/跳过留痕（warn 级 → info.log）；dbg=详单（debug 级 → debug.log）；
+  // 两者统一受 distillDebugLog 门控：关闭时（默认）本插件零输出（既不写终端也不写文件）。
+  // 隐私红线：只打计数/字符数/错误 message+stack 首行等元数据，绝不打印对话或 MEMORY.md 文本
+  // （唯一例外：distillLogLevel=debug 时的 LLM 原始响应，经 raw() 显式落 debug.log）。
+  const noop = () => {};
+  const logFor = (session) => (typeof logger?.for === "function" ? logger.for(session?.id, "distill") : null);
 
   // 模型解析（v1.2.3 修复）：summaryModel 存的是注册表 models[].id 原样（client 下拉 value = m.id），
   // pi-ai getModel(provider, id) 按 model.id 全等匹配（pi-ai models.js: getModels(provider).find(m => m.id === id)），
@@ -46,6 +50,9 @@ export function createDistill({ ctx, getConfig, paths, records }) {
     return null;
   }
   async function resolveModel(summaryModel, session) {
+    const log = logFor(session);
+    const dbg = log ? log.dbg : noop;
+    const dbgFail = log ? log.dbgFail : noop;
     const sm = (summaryModel || "").trim();
     if (sm) {
       const hit = await findModelInRegistry(sm);
@@ -97,6 +104,9 @@ export function createDistill({ ctx, getConfig, paths, records }) {
   // v1.8.0：唯一调用方 = 按钮「蒸馏会话」（全量 fromSeq=0）；原 smart 模式自动摘要链路已删除。
   // 返回 { ok, summary, durableCount }；失败 { ok:false }（调用方各自决定降级策略）。
   async function distillSessionCore(session, dirs, fromSeq, opts) {
+    const log = logFor(session);
+    const dbg = log ? log.dbg : noop;
+    const dbgFail = log ? log.dbgFail : noop;
     const allowDelete = !!(opts && opts.allowDelete);
     // 回喂存量记忆（v1.4.0 特性3）：feedbackEnabled 开启即回喂项目级 + 用户级 MEMORY.md 全文
     // （逐行编号、无截断）。delete 由 allowDelete 决定（手动按钮传 true）。
@@ -185,17 +195,11 @@ export function createDistill({ ctx, getConfig, paths, records }) {
     const { finish, text, chunks, deltaChars, tFirstChunk } = result;
     dbg("session finish", { kind: finish?.kind, attempts: result.attempts });
     dbg("session stream done", { chunks, deltaChars, firstChunkMs: tFirstChunk });
-    // 本地调试（受 distillDebugLog + distillLogLevel==="debug" 双门控）：把 LLM 原始响应 text 原样打到 stderr，
-    // 并用分隔符整段包裹，便于从 stderr 一眼框住起止、不与其它 dbg 行混淆。
-    if (cfg().distillDebugLog && cfg().distillLogLevel === "debug") {
-      console.error("[memory-palace][debug] session llm raw text begin >>>");
-      console.error("--------------------------->");
-      console.error(text);
-      console.error("<----------------------------");
-      console.error("[memory-palace][debug] session llm raw text end <<<");
-    }
+    // 本地调试（受 distillDebugLog + distillLogLevel==="debug" 双门控）：LLM 原始响应写入 debug.log，
+    // 用分隔符整段包裹，便于一眼框住起止、不与其它 dbg 行混淆。
+    if (cfg().distillLogLevel === "debug") log?.raw(text);
     if (finish && finish.kind === "max-tokens") {
-      console.error("[memory-palace] distill warn: llm finish max-tokens (attempting partial JSON)", JSON.stringify({}));
+      dbgFail("session llm finish max-tokens (attempting partial JSON)", {});
     }
     if (!text) {
       dbgFail("empty llm text");
@@ -279,6 +283,9 @@ export function createDistill({ ctx, getConfig, paths, records }) {
   // 流程：读主目标 MEMORY.md → DISTILL_PROMPT 蒸馏 → 写 memory-cover.md（同目录，保证 rename 原子）
   // → 完整性检查 → 备份 MEMORY.md.{时间戳} → rename 覆盖 → cover 随 rename 消失。
   async function distillProjectMemory(cwd, session) {
+    const log = logFor(session);
+    const dbg = log ? log.dbg : noop;
+    const dbgFail = log ? log.dbgFail : noop;
     const c = cfg();
     if (!c.enabled) return { ok: false, message: "memory-palace 已停用。" };
     const dirs = paths.writeDirs(cwd);
@@ -338,14 +345,8 @@ export function createDistill({ ctx, getConfig, paths, records }) {
         return { ok: false, message: `蒸馏${kindZh}（重试 ${e?.attempts || 0} 次后仍失败）：${cls.message || ""}` };
       }
       const { finish, text, chunks, deltaChars, gotFirstChunk, tFirstChunk } = result;
-      // 本地调试（受 distillDebugLog + distillLogLevel==="debug" 双门控，与会话蒸馏路径一致）：分隔符包裹整段原始响应。
-      if (cfg().distillDebugLog && cfg().distillLogLevel === "debug") {
-        console.error("[memory-palace][debug] project llm raw text begin >>>");
-        console.error("--------------------------->");
-        console.error(text);
-        console.error("<----------------------------");
-        console.error("[memory-palace][debug] project llm raw text end <<<");
-      }
+      // 本地调试（受 distillDebugLog + distillLogLevel==="debug" 双门控，与会话蒸馏路径一致）：原始响应写入 debug.log。
+      if (cfg().distillLogLevel === "debug") log?.raw(text);
       if (finish && finish.kind === "max-tokens") {
         dbg("project finish", { kind: "max-tokens", attempts: result.attempts });
       } else {

package/lib/hybrid/subagent.mjs

@@ -52,19 +52,29 @@ async function resolveModel(cfg, ctx, session) {
 }
 
 // 单次流式调用（带 tools）。finish.kind 为 error/aborted 时抛出由上层降级；tool-calls/stop 正常返回。
+// v1.8.0-alpha.4：附带 LLM 流统计（字段与 distill.mjs 的 streamOnce 对齐）供 dbg("stream turn") 落盘。
+// 起因：子代理链路此前看不到任何 LLM 行为——耗时只能靠相邻两条日志的时间戳手动相减，
+// 无法判断慢在网关排队还是模型生成。
 async function streamTurn(ctx, params, timeoutMs) {
   const signal = AbortSignal.timeout(timeoutMs);
+  const t0 = Date.now();
+  let chunks = 0;
+  let deltaChars = 0;
+  let tFirstChunk = null;
   const res = ctx.llm.stream({ ...params, signal });
   const asm = new BlockAssembler();
   for await (const ch of res) {
     signal.throwIfAborted();
+    chunks++;
+    deltaChars += ch.text?.length || 0;
+    if (tFirstChunk === null) tFirstChunk = Date.now() - t0;
     asm.push(ch);
   }
   const finish = asm.finish;
   if (finish.kind === "error" || finish.kind === "aborted") {
     throw new Error(finish.failure?.message || finish.kind);
   }
-  return { finish, asm };
+  return { finish, asm, stats: { chunks, deltaChars, firstChunkMs: tFirstChunk, elapsedMs: Date.now() - t0 } };
 }
 
 // 把本轮 surface 事件投影为消息数组（seq >= fromSeq；与 distillSessionCore 同源逻辑）。
@@ -236,17 +246,21 @@ function applyLogOps(logFiles, dateStr, ops) {
 // 记忆子 agent 主入口。每轮必跑（定案：不走闸门）；plan 模式拦截由调用方（index.mjs _settle）负责。
 // 返回 { ok, mode }：mode = "noop"（无重点收尾）| "written"（有落盘）| "no-tool-support"；
 // ok=false 表示整体失败（不推进断点、下一次 turn/end 自动补蒸；不降级为任何轻量写入）。
-export async function runMemorySubagent({ ctx, getConfig, paths, state, session, dirs, isError, getSeq, setSeq }) {
+export async function runMemorySubagent({ ctx, getConfig, paths, state, session, dirs, isError, getSeq, setSeq, logger }) {
   const cfg = getConfig();
   // 增量断点按会话取用：调用方（index.mjs）注入 getSeq/setSeq（按 sessionId 分桶）。
   // 未注入时回落全局 state.lastSummarizedSeq，保持旧行为与向后兼容。
   const readSeq = typeof getSeq === "function" ? getSeq : () => state.lastSummarizedSeq;
   const writeSeq = typeof setSeq === "function" ? setSeq : (v) => { state.lastSummarizedSeq = v; };
-  // 调试日志（v1.6.0）：与 distill.mjs 同款门控。dbgFail=失败/跳过留痕（无条件输出，排障可观测）；
-  // dbg=受 distillDebugLog 开关控制的详单（模型解析/请求参数/流进度/ops 结果计数）。
-  // 隐私红线：只打计数/字符数/元数据/错误 message，绝不打印对话或日志正文文本。
-  const dbgFail = (why, extra) => console.error(`[memory-palace] subagent warn: ${why}`, extra ? JSON.stringify(extra) : "");
-  const dbg = (why, extra) => { if (!cfg.distillDebugLog) return; console.error(`[memory-palace][debug] subagent ${why}`, extra !== undefined ? JSON.stringify(extra) : ""); };
+  // 日志（v1.8.0-alpha.4）：原 stderr 输出改为经统一 logger 落盘
+  // （`<profileDir>/.memory-palace/logs/<sessionId>/{info,debug}.log`，见 common/logger.mjs）。
+  // dbgFail=失败/跳过留痕（warn 级 → info.log）；dbg=详单（debug 级 → debug.log）。
+  // 两者统一受 distillDebugLog 门控：关闭时（默认）本插件零输出（既不写终端也不写文件）。
+  // 隐私红线：只打计数/字符数/错误 message 等元数据，绝不打印对话或日志正文文本。
+  // logger 未注入时（如直接调本函数的单测）降级为 no-op，绝不让日志拖垮主流程。
+  const logSink = typeof logger?.for === "function" ? logger.for(session?.id, "subagent") : null;
+  const dbgFail = logSink ? logSink.dbgFail : () => {};
+  const dbg = logSink ? logSink.dbg : () => {};
   if (!cfg.enabled || !session || !dirs.length) {
     dbgFail("disabled or no session/dirs", { enabled: !!cfg.enabled, hasSession: !!session, dirs: dirs.length });
     return { ok: false, mode: "disabled" };
@@ -346,21 +360,30 @@ export async function runMemorySubagent({ ctx, getConfig, paths, state, session,
     let unknownHits = 0;
     let retries = 0;
     const unknownNames = new Set();
+    // v1.8.0-alpha.4：随返回值带上统计量，供调用方（index.mjs _settle）写终态台账行。
+    // 这些量原本算完即弃，却是排障刚需（本轮跑没跑、成没成、写了几条、误调几次）。
+    const stats = (round) => ({
+      round, appliedWrites, toolAttempts, unknownHits, retries, unknownNames: [...unknownNames],
+    });
     for (let round = 0; round < MAX_ROUNDS; round++) {
-      const { finish, asm } = await streamTurn(ctx, { provider, model, system, messages, tools }, timeoutMs);
+      const { finish, asm, stats: llmStats } = await streamTurn(ctx, { provider, model, system, messages, tools }, timeoutMs);
+      // LLM 流统计（debug 级 → debug.log）：每轮一次，直接看得到耗时与流进度。
+      // ⚠️ 必须解构成 `llmStats` 而非 `stats`：本循环体内已有 `const stats = (round) => …`（结算统计量
+      //    函数），同名解构会把它遮蔽，导致后面的 `stats(round)` 抛 "stats is not a function"。
+      dbg("stream turn", { round, ...llmStats });
       if (finish.kind === "stop") {
         // v1.6.3 stop 三态判定（修复：误调未知工具后模型直接收尾 → 日志丢失且断点被无脑推进）。
         // ① 有落盘 → 正常完成，推进断点。
         if (appliedWrites > 0) {
           writeSeq(session.seq);
           dbg("done", { round, mode: "written", appliedWrites });
-          return { ok: true, mode: "written" };
+          return { ok: true, mode: "written", stats: stats(round) };
         }
         // ② 从未调用任何工具 → 模型判定本轮无实质内容（noop），推进断点。
         if (toolAttempts === 0) {
           writeSeq(session.seq);
           dbg("done", { round, mode: "noop" });
-          return { ok: true, mode: "noop" };
+          return { ok: true, mode: "noop", stats: stats(round) };
         }
         // ③ 命中过未知工具且零写入 → 回告工具清单 + 催促重试（预算 MAX_RETRY 次）。
         if (unknownHits > 0 && retries < MAX_RETRY) {
@@ -379,13 +402,13 @@ export async function runMemorySubagent({ ctx, getConfig, paths, state, session,
         }
         // ④ 重试预算耗尽 / 已知工具用错后自主放弃 → 零写入，不推进断点（下一轮 turn/end 补蒸）。
         dbgFail("no write applied", { round, toolAttempts, unknownHits, retries });
-        return { ok: false, mode: "no-write" };
+        return { ok: false, mode: "no-write", stats: stats(round) };
       }
       if (finish.kind !== "tool-calls") {
         // max-tokens 等异常收尾：返回失败，断点不推进——下一次 turn/end 子代理自动补蒸。
         // v1.6.0 定案：不降级为轻量原文写入（无格式原文会破坏日志章节化结构），宁缺勿滥。
         dbgFail(`finish ${finish.kind}`, { round });
-        return { ok: false, mode: `finish-${finish.kind}` };
+        return { ok: false, mode: `finish-${finish.kind}`, stats: stats(round) };
       }
       messages.push(asm.message({ kind: "model", provider, model }));
       const calls = asm.blocks().filter((b) => b.type === "tool-call");
@@ -411,7 +434,7 @@ export async function runMemorySubagent({ ctx, getConfig, paths, state, session,
       }
     }
     dbgFail("max-rounds exceeded", { rounds: MAX_ROUNDS });
-    return { ok: false, mode: "max-rounds" };
+    return { ok: false, mode: "max-rounds", stats: stats(MAX_ROUNDS) };
   } catch (e) {
     if (e?.name === "TimeoutError" || /timeout|abort/i.test(String(e?.message))) {
       dbgFail("timeout", { timeoutMs });

package/lib/index.js

@@ -30,6 +30,7 @@ import Schema from "@deepseek-ai/schemastery";
 // settingsNamespace，设置节注册改用 SettingsProvider 实例方法 installSection（经 ctx.inject(["settings"])）。
 import { extractText, extractToolErrorText } from "./common/text.mjs";
 import { createPaths } from "./common/paths.mjs";
+import { createLogger } from "./common/logger.mjs";
 import { planModeOf } from "./common/planmode.mjs";
 import { createRecords } from "./common/records.mjs";
 import { createDistill } from "./distill.mjs";
@@ -79,9 +80,9 @@ export const Config = Schema.object({
   // `silentPresets`（会话预设级静默）决定，不再有独立的写入闸门。
   summaryModel: Schema.string().default("").description("记忆插件当前使用的模型（手动「蒸馏会话」/「蒸馏项目记忆」与记忆子代理共用）。留空=复用当前会话 provider/model；也可填 provider/model（如 deepseek/deepseek-chat）固定廉价模型省 token。").volatile(),
   summaryTimeoutMs: Schema.number().default(60000).description("蒸馏 LLM 调用的超时（毫秒），超时视为失败并降级；覆盖手动「蒸馏会话」/「蒸馏项目记忆」与记忆子代理三条链路；默认 60000（60s）。").volatile(),
-  distillDebugLog: Schema.boolean().default(false).description("调试开关：向 dsh 服务端 stderr 输出蒸馏 LLM 调用诊断。distillLogLevel=info 时仅输出元数据（模型解析/请求参数/流进度/错误详情，不含文本）；distillLogLevel=debug 会额外打印 LLM 原始响应文本（分隔符包裹），仅限受信本地排障开启。").volatile(),
-  // ---- v1.4.1：蒸馏 stderr 日志级别（平铺键，不进 UI；默认 info；distillDebugLog=true 时生效） ----
-  distillLogLevel: Schema.string().default("info").description("蒸馏 stderr 日志级别：info=仅元数据诊断（默认，不打印 LLM 原始响应）；debug=额外打印 LLM 原始响应文本（分隔符包裹），仅限受信本地排障开启。无需 UI 配置，经 profile 的 cordis.patch.yml 在 memory-palace 条目 config 下设置 distillLogLevel 键（dsh 0.1.7 起 settings.yaml 已被宿主移除、导入 profile patch）。").volatile(),
+  distillDebugLog: Schema.boolean().default(false).description("调试开关：开启后把本插件**全部诊断日志落盘**（v1.8.0-alpha.4 起不再输出 stderr）。落点 = `<profile 目录>/.memory-palace/logs/<会话 id>/`（如 `$DSH_HOME/profiles/web/.memory-palace/logs/<sid>/`），按级别分文件：`info.log` 收失败/跳过留痕与子代理终态台账，`debug.log` 收详单（`distillLogLevel=debug` 时另含 LLM 原始响应）。关闭（默认）时零输出。单文件上限 1 MB、不自动清理。仅排障用").volatile(),
+  // ---- v1.4.1：蒸馏日志级别（平铺键，不进 UI；默认 info；distillDebugLog=true 时生效） ----
+  distillLogLevel: Schema.string().default("info").description("日志级别：`info`=只落盘元数据诊断（默认，不含 LLM 原始响应）；`debug`=额外把 LLM 原始响应文本落盘到 `debug.log`（分隔符包裹），仅限受信本地排障开启。无需 UI 配置，经 profile 的 cordis.patch.yml 在 memory-palace 条目 config 下设置 distillLogLevel 键（dsh 0.1.7 起 settings.yaml 已被宿主移除、导入 profile patch）。").volatile(),
   // ---- v1.4.0：手动「蒸馏会话」最终输出软预算（v1.4.1 起语义变更：prompt 软约束，思考不受限；实际硬上限由模型自身 maxTokens 决定） ----
   summaryMaxTokens: Schema.number().default(2000).description("手动「蒸馏会话」LLM 的最终输出软预算（prompt 约束，思考不受限；实际硬上限由模型自身 maxTokens 决定）。默认 2000；可调大以容纳更多 durable 事实。").volatile(),
   projectMaxTokens: Schema.number().default(8000).description("手动「蒸馏项目记忆」LLM 的最终输出软预算（prompt 约束，思考不受限；实际硬上限由模型自身 maxTokens 决定）。默认 8000。").volatile(),
@@ -248,7 +249,11 @@ export function apply(ctx, config) {
   // ---- 装配：路径解析 / 记录读写 / 蒸馏 / 工具 / route ----
   const paths = createPaths(() => source(), () => state.activeCwd);
   const records = createRecords({ getConfig: () => source(), paths });
-  const distill = createDistill({ ctx, getConfig: () => source(), paths, records });
+  // v1.8.0-alpha.4：统一日志落盘器——原 stderr 输出（含原「无条件」的失败留痕）全部改为落盘，
+  // 落点 `<profileDir>/.memory-palace/logs/<sessionId>/{info,debug}.log`，统一受 distillDebugLog 门控。
+  // 取径与分级依据见 src/common/logger.mjs 文件头。
+  const logger = createLogger({ ctx, getConfig: () => source() });
+  const distill = createDistill({ ctx, getConfig: () => source(), paths, records, logger });
   registerTools({ ctx, getConfig: () => source(), paths, state });
   registerApi({ ctx, paths, distill, getSettingsFace });
   // v1.8.0：记忆子代理模块（原 hybrid）。必须【无条件注册】——apply() 同步段执行时 settings 服务
@@ -261,7 +266,7 @@ export function apply(ctx, config) {
   // v1.7.0 特性1：E 投影通道（记忆正文常驻注入）。与 hybrid 同理，无条件注册——
   // 其内部读热配置，无副作用（enabled=false 或命中静默预设时 buildProjections 返回空）。
   // v1.7.2：把 isSessionSilent 透传下去——投影按**会话**判定，故必须知道 agent 所属会话的预设。
-  registerProjection({ ctx, getConfig: () => source(), paths, isSilent: isSessionSilent });
+  registerProjection({ ctx, getConfig: () => source(), paths, isSilent: isSessionSilent, logger });
 
   // ---------- v1.7.2：静默会话（enabled=false 或命中静默预设）的工具 schema 隐身 ----------
   // 背景：`complete: true` 只收缩 sections、**不裁剪 tools**——记忆工具的 schema 仍会经 toolProvider
@@ -309,7 +314,8 @@ export function apply(ctx, config) {
     } catch (error) {
       // 绝不冒泡：restrict 抛错（如某工具因异常未注册命中 unknown-tool）时降级为"不隐身"，
       // 由 execute 的 enabled 兜底保证功能仍停用，只是没省掉 schema token。
-      console.error(`[memory-palace] tool-hide skipped: ${error?.message || String(error)}`);
+      // v1.8.0-alpha.4：原 stderr 输出改为落盘（warn 级 → info.log），受 distillDebugLog 门控。
+      logger.for(sessionId, "plugin").dbgFail("tool-hide skipped", { message: error?.message || String(error) });
     }
   }
 
@@ -510,10 +516,19 @@ export function apply(ctx, config) {
         session,
         dirs,
         isError: effectiveIsError,
+        logger,
         // 断点按会话分桶：全局单值在并发会话下会被互相重置，导致子代理静默 noop、日志不落盘。
         getSeq: () => state.seqBySession.get(sid) ?? session?.firstLiveSeq ?? 0,
         setSeq: (v) => state.seqBySession.set(sid, v),
       })
+      .then((r) => {
+        // v1.8.0-alpha.4 终态台账：每轮结算留一行（info 级 → info.log），把子代理结果与其已算好的
+        // 统计量落盘。原先这些量算完即弃，导致「本轮跑没跑、成没成、写了几条」无从查证。
+        // 写入本身同样受 distillDebugLog 门控（emit 内部判定），失败静默、绝不影响主流程。
+        logger.for(sid, "subagent").info(`done ok=${!!r?.ok} mode=${r?.mode ?? "?"}`, {
+          ...(r?.stats ?? {}), cwd: cwd ?? "", isError: effectiveIsError,
+        });
+      })
       .catch(() => {});
   }
 

package/lib/projection.mjs

@@ -152,7 +152,7 @@ export function buildProjections({ getConfig, paths, session, isSilent }) {
  * 注册 E 投影钩子。
  * @param {{ ctx: object, getConfig: () => object, paths: object, isSilent?: (session?: object) => boolean }} deps
  */
-export function registerProjection({ ctx, getConfig, paths, isSilent }) {
+export function registerProjection({ ctx, getConfig, paths, isSilent, logger }) {
   ctx.on("agent/pre-step", async ({ agent, messages, step, signal }, next) => {
     // 先让瀑布流继续，拿到宿主与其他插件合成后的决策——投影要折叠进它的 messages。
     const decision = await next();
@@ -178,9 +178,10 @@ export function registerProjection({ ctx, getConfig, paths, isSilent }) {
     } catch (error) {
       // 🔴 绝不冒泡：pre-step 抛错会让整个 turn 失败（宿主契约，见文件头）。
       // 契约失效时表现为"记忆正文不注入"，这行 warn 是唯一排查线索。
-      console.error(
-        `[memory-palace] projection skipped (step ${step}): ${error?.message || String(error)}`,
-      );
+      // v1.8.0-alpha.4：原 stderr 输出改为落盘（warn 级 → info.log），受 distillDebugLog 门控。
+      logger?.for?.(agent?.session?.id, "projection")?.dbgFail(`projection skipped (step ${step})`, {
+        message: error?.message || String(error),
+      });
       return decision;
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-palace",
-  "version": "1.8.0-alpha.2",
+  "version": "1.8.0",
   "description": "把 WorkBuddy 的文件式记忆系统移植进 DeepSeek Harness：用户级 + 工作区的人类可读 Markdown 记忆（~/.deepseek-harness/MEMORY.md 与 <cwd>/.deepseek-harness/memory/）。",
   "type": "module",
   "main": "lib/index.js",
@@ -42,13 +42,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.7-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.2.0-rc.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.2.0-rc.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.1 || ^0.1.7-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.7-alpha.1"
+    "@deepseek-ai/dsh-settings": "^0.2.0-rc.1"
   },
   "scripts": {
     "build": "node scripts/build.mjs",