@kanadego/dsh-heartbeat 1.9.1 → 1.9.2

package/README.md

@@ -97,7 +97,9 @@ dsh plugin --profile web add file:D:/path/to/dsh-heartbeat
 
 重启 DSH 即生效——插件自动创建专用心跳会话并按节律运行，之后日常无需任何操作。
 
-**心跳预设是自动装的**：`0.1.7` 起的宿主不再从文件系统目录加载预设，插件改为在安装清单里**声明式注册**（与官方 standard 预设同机制），重启即注册，不需要任何手动操作。更早的宿主仍走原来的目录安装路径：启动时检查 `<DSH_HOME>/.agent-presets/heartbeat/`，缺失就按包内模板建好，**已有文件永不覆写**（你手改过的预设原样保留）。无论走哪条路径，没有这个预设心跳 agent 就是个"裸 agent"，连 `web_search` 都看不见——想手动检查/修复用 `preset status` / `preset install`（见下节）；在走目录安装的老宿主上，还可以把插件 config 的 `installPreset` 设为 `false` 关掉自装。
+**心跳预设是自动装的**：插件加载时直接向宿主注册（`agentPresets.register()`，v1.9.2 起），不需要任何手动操作，**安装清单里也不再声明宿主包**。早先那种"声明式"写法要求 profile 自己能解析 `@deepseek-ai/dsh-agent-preset`：解析不到，整个插件树加载失败（0.1.5 宿主）；手工把它的 peer 闭包补进 profile，又会把 cordis 的装载机制装成两份，之后**任何会话都无法恢复**（`prompt section "deployment:persona-prefix" is already registered`，0.2.0-rc.2）——两种都踩过，见 issue #2。`0.1.7` 之前的宿主仍走目录安装路径：启动时检查 `<DSH_HOME>/.agent-presets/heartbeat/`，缺失就按包内模板建好，**已有文件永不覆写**（你手改过的预设原样保留）。无论走哪条路径，没有这个预设心跳 agent 就是个"裸 agent"，连 `web_search` 都看不见——想手动检查/修复用 `preset status` / `preset install`（见下节）；把插件 config 的 `installPreset` 设为 `false` 可同时关掉运行时注册与目录自装，预设完全由你管。
+
+**数据默认放在包外**：`<DSH_HOME>/heartbeat-data`（没有 `DSH_HOME` 就是 `~/.dsh/heartbeat-data`），重装与升级都不会碰它。老版本装在包目录里的 `data/` 会在首次启动时自动搬过去（搬迁前先备份、逐文件校验通过才删原件，见下节「卸载」）。要换位置就用插件 config 的 `dataDir`，或环境变量 `HEARTBEAT_DATA_DIR`。
 
 ## CLI 命令
 
@@ -192,15 +194,28 @@ node <插件目录>/dist/cli/index.js <命令>
 dsh plugin --profile web remove @kanadego/dsh-heartbeat
 ```
 
-卸载只拆插件本体（包、挂载行、注册项，无残留引用）；**`data/` 用户数据默认保留在插件目录**，重装后记忆原样回来。想连数据一起删，手动删除 `data/` 目录或先用 `burn --all` 焚毁敏感内容。
+卸载只拆插件本体（包、挂载行、注册项，无残留引用），**不动用户数据**——v1.9.2 起数据默认住在包外的 `<DSH_HOME>/heartbeat-data`（`~/.dsh/heartbeat-data`），重装、升级、卸载都不会碰它。想连数据一起删，先 `burn --all` 焚毁敏感内容再删目录。
+
+老版本（≤ v1.9.1）装在包目录里的 `data/` 会被自动搬出去：启动时若发现包内有数据、包外还没有，就递归复制过去——**先备份一份、再逐文件校验**（文件清单、大小、sha256 全部一致），全部通过才删原目录与备份；任何一步失败都原地不动，继续用包内那份，并留痕 `data_dir_relocate_failed`。搬完之后老位置不会再被读取，也不会再创建。
+
+如果想自己指定位置（比如放到别的盘），在 profile 的 `cordis.patch.yml` 里给 `heartbeat` 覆盖：
+
+```yaml
+- id: heartbeat
+  config:
+    dataDir: D:/your/workspace/heartbeat-data
+```
+
+显式指定时**不会**触发自动搬迁，也不会被上面的默认值覆盖——从包内搬出去这件事需要你手动做（照第 1 条的路径拷过去即可）。
 
 ## 版本兼容
 
 | 插件版本 | 适配的 DSH |
 |---|---|
-| **v1.7.4 – v1.9.1**（当前） | `0.1.2-rc.1` – `0.2.0-rc.2` |
-| v1.7.2 – v1.7.3 | `0.1.2-rc.1` – `0.2.0-rc.1` |
-| v1.7.0 – v1.7.1 | `0.1.2-rc.1` – `0.1.7-rc.2` |
+| **v1.9.2**（当前） | `0.2.0-rc.1` – `0.2.0-rc.2` |
+| v1.7.4 – v1.9.1 | `0.2.0-rc.1` – `0.2.0-rc.2` |
+| v1.7.2 – v1.7.3 | `0.1.7-rc.1` – `0.2.0-rc.1` |
+| v1.7.0 – v1.7.1 | `0.1.5-rc.2` – `0.1.7-rc.2` |
 | v1.2.x – v1.6.4 | `0.1.2-rc.1` – `0.1.5-rc.2` |
 | v1.1 | `0.1.2-rc.1` |
 | v1.0 | ≤ `0.1.1-rc.2` |
@@ -214,6 +229,13 @@ dsh plugin --profile web remove @kanadego/dsh-heartbeat
 <details open>
 <summary><b>v1.9.x</b></summary>
 
+### v1.9.2 · 2026-10-10（修复：预设改为运行时注册 + 数据目录移出包外）
+
+- **预设不再写进安装清单**：修复了心跳模式预设在 profile 解析不到宿主包时，导致整个插件树加载失败、DSH 启动不起来的问题。现已改为插件在加载时自己向宿主注册，超时或失败会自动回退并留痕。
+- **补依赖不再把宿主装成两份**：修复了为解析预设包手工补齐依赖后，宿主装载机制出现两份实例、所有会话都无法恢复的问题。现在清单里不再出现任何宿主包，那条补法也用不上了。
+- **会话恢复失败不再无限重试**：修复了旧格式会话迁移被拒时，引擎室被反复重试拖住、永远空转的问题。现已把这类永久性失败单独识别，当场重建会话并把正身指过去；真正暂时性的错误仍照旧退避重试。
+- **数据目录默认移出包外**：修复了数据默认住在包目录里、`dsh plugin add` 与每次升级替换包目录时连带删掉画像、素材池与正身记录的问题（原本只有显式 `burn` 才会销毁）。默认位置现为 `<DSH_HOME>/heartbeat-data`；老版本装在包内的 `data/` 首次启动自动搬迁——先备份、再逐文件校验（清单、大小、sha256 全部一致），全部通过才删原件与备份，任何一步失败都原地不动。
+
 ### v1.9.1 · 2026-10-07（代码审查：86 项修复）
 
 进行了一次全量代码审查，共 86 项。没有功能上的加减，优化了代码结构，清理并修复了一批 bug 与潜在问题：

package/cordis.patch.yml

@@ -8,46 +8,25 @@
 #   - id: heartbeat
 #     config:
 #       dataDir: D:/your/workspace/data
-# Default: <packageRoot>/data.
+# Default: <DSH_HOME>/heartbeat-data (i.e. ~/.dsh/heartbeat-data), outside the
+# package. Data written by v1.9.1 and earlier sits at <packageRoot>/data and is
+# migrated out automatically on first start (backup, verify, then delete).
 - insert:
     - id: heartbeat
       name: '@kanadego/dsh-heartbeat'
 
-# ── Agent preset heartbeat（0.1.7 声明式预设，v1.7.1）─────────────────
-# 0.1.7 起 agentPresets 名册不再挂载文件系统用户根（~/.dsh/.agent-presets），
-# 预设改为组合里的 @deepseek-ai/dsh-agent-preset 声明行（与官方 preset-standard
-# 同款机制）。内容 = assets/presets/heartbeat/agent.cordis.yml 的移植：
-# compaction 组 + 唯一模型工具 tool-web(fetch:false)。
-# 刻意没有 persona 行：部署人格（soul card）+ 心跳提示词已够，绝不能让
-# "You are a coding agent" 盖掉人格。≤0.1.5 宿主继续走文件系统预设自装。
-- insert:
-    - id: preset-heartbeat
-      name: '@deepseek-ai/dsh-agent-preset'
-      config:
-        id: heartbeat
-        name: 心跳模式
-        description: 心跳 agent 专用：仅 web_search + 上下文折叠；无 shell、无文件、无子代理。
-        order: 20
-        plugins:
-          - id: compaction
-            name: cordis:group
-            group: true
-            isolate:
-              compaction: true
-              toolResultPruner: true
-            config:
-              - id: compaction-basic
-                name: '@deepseek-ai/dsh-compaction-basic'
-              - id: command-compact
-                name: '@deepseek-ai/dsh-command-compact'
-              - id: tool-result-pruner
-                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
-                config:
-                  thresholdChars: 8192
-                  headChars: 4096
-                  tailChars: 1024
-          - id: tool-web
-            name: '@deepseek-ai/dsh-tool-web'
-            config:
-              fetch: false
-              searchTimeoutMs: 60000
+# ── Agent preset heartbeat（改为插件运行时注册，v1.9.2 / issue #2）────────
+# 这里**故意不再**声明 `@deepseek-ai/dsh-agent-preset` 行。那行会让 profile
+# 必须自己能解析该包，而它的 peer 闭包里含着 cordis 自己的装载机制
+# （cordis-plugin-loader / -include / -group）：
+#   · profile 解析不到 → 整个插件树加载失败（0.1.5-rc.2 实测）；
+#   · 手工补进 peer 闭包 → 装载机制双实例，之后**任何会话 resume 全部失败**
+#     （`prompt section "deployment:persona-prefix" is already registered`，
+#     0.2.0-rc.2 实测）。
+# 两种都在 2026-10-10 被复现（见 issue #2）。现在预设定义活在插件里
+# （src/core/preset-definition.ts），加载时经 `agentPresets.register()` 运行时
+# 注册——declaring plugin 自己提供 definition 正是该 API 的用途；宿主没有这个
+# API 时只记一条审计，绝不让宿主挂掉。老宿主（仍扫名册文件系统用户根）继续由
+# preset-install 自装维持。内容与 assets/presets/heartbeat/agent.cordis.yml 一致：
+# compaction 组 + 唯一模型工具 tool-web(fetch:false)；刻意没有 persona 行——
+# 部署人格（soul card）+ 心跳提示词已够，绝不能让 "You are a coding agent" 盖掉人格。

package/dist/{chunk-BQCXYE7N.js → chunk-3MDBU6WY.js}

@@ -4,7 +4,7 @@ import {
 import {
   loadEncryptedText,
   saveEncryptedText
-} from "./chunk-7TW6DD6Q.js";
+} from "./chunk-K5Y6JP2B.js";
 
 // src/profile/inbox.ts
 import fs from "fs";
@@ -110,4 +110,4 @@ export {
   inboxHealthCheck,
   inboxFileExists
 };
-//# sourceMappingURL=chunk-BQCXYE7N.js.map
+//# sourceMappingURL=chunk-3MDBU6WY.js.map

package/dist/{chunk-HT57FOEF.js → chunk-AJ5HLAL7.js}

@@ -20,7 +20,7 @@ import {
   sendNewMessageHint,
   sendWeeklyReadyHint,
   weeklyDue
-} from "./chunk-WRJCINZ7.js";
+} from "./chunk-IG6YMUHW.js";
 import {
   getRuntime
 } from "./chunk-3QJJRXIR.js";
@@ -31,17 +31,17 @@ import {
   loadPool,
   seedsFilePath,
   surfaceSeed
-} from "./chunk-KOOQOMQY.js";
+} from "./chunk-JDH2LDFS.js";
 import {
   dedupeItems,
   inboxClear,
   inboxCount,
   inboxDrain,
   inboxFilePath
-} from "./chunk-BQCXYE7N.js";
+} from "./chunk-3MDBU6WY.js";
 import {
   snapshotIfDue
-} from "./chunk-QOQ7EPZZ.js";
+} from "./chunk-KB5SMG3F.js";
 import {
   appendAuditLine,
   applyOpsToDoc,
@@ -53,7 +53,7 @@ import {
   readAuditLines,
   readJournalTexts,
   runDeterministicAging
-} from "./chunk-OYVNWB5G.js";
+} from "./chunk-CUOSICYJ.js";
 import {
   decryptFile,
   encryptFile,
@@ -63,7 +63,7 @@ import {
   saveEncryptedText,
   saveJson,
   writeText
-} from "./chunk-7TW6DD6Q.js";
+} from "./chunk-K5Y6JP2B.js";
 import {
   atomicWriteJsonSync,
   burnFileSync
@@ -990,7 +990,7 @@ async function runConsolidation(guard, paths, policy, llm, now = Date.now()) {
     const report = applyOpsToDoc(guard, paths.dataDir, doc, profileOpsCast, schema, policy, now);
     const aged = runDeterministicAging(doc, policy, now);
     persistWithJournal(guard, paths.dataDir, doc, { runId, applied: report.applied, rejected: report.rejected });
-    const { addSeed: addSeed2, seedsFilePath: seedsFilePath2 } = await import("./pool-B34NTH6D.js");
+    const { addSeed: addSeed2, seedsFilePath: seedsFilePath2 } = await import("./pool-UTXQJJ5C.js");
     const seedAudit = (entry) => {
       try {
         appendAuditLine(paths.dataDir + "/logs/heartbeat.jsonl", entry);
@@ -1277,6 +1277,13 @@ function applyHeartbeatInterval(deps, intervalMin) {
   reschedule?.(v);
   appendAuditLine(deps.paths.logsDir + "/heartbeat.jsonl", { event: "interval_changed", intervalMin: v });
 }
+function looksPermanentResumeFailure(error) {
+  return [
+    /SessionFormatUnsupportedError/i,
+    /refuses the transformed artifact/i,
+    /session migration[^]*refus/i
+  ].some((re) => re.test(error));
+}
 function sessionEvents(session, fromSeq) {
   if (!session) return [];
   if (typeof session.snapshotEvents === "function") {
@@ -1398,6 +1405,11 @@ function makeHomeSetup(deps) {
   return async (agentCtx) => {
     const notes = [];
     const presetId = deps.agentPreset ?? "heartbeat";
+    try {
+      await withTimeout(deps.presetRegistration?.() ?? Promise.resolve(), 3e4, "preset registration timeout (30s)");
+    } catch (e) {
+      notes.push(`preset-register=threw(${String(e).slice(0, 120)})`);
+    }
     try {
       const presets = agentCtx.get("agentPresets");
       if (typeof presets?.mount !== "function") {
@@ -1539,12 +1551,15 @@ async function ensureAgent(deps) {
             agent = unwrap(handle);
             appendAuditLine(paths.logsDir + "/heartbeat.jsonl", { event: "agent_resume_ok", sessionId: savedId, model: agent.options?.model ?? "(none)" });
           } catch (resumeErr) {
+            const resumeMessage = String(resumeErr);
             appendAuditLine(paths.logsDir + "/heartbeat.jsonl", {
               event: "agent_resume_failed",
               sessionId: savedId,
-              error: String(resumeErr).slice(0, 160)
+              error: resumeMessage.slice(0, 160)
             });
-            if (!/not found/i.test(String(resumeErr))) {
+            const gone = /not found/i.test(resumeMessage);
+            const permanent = !gone && looksPermanentResumeFailure(resumeMessage);
+            if (!gone && !permanent) {
               appendAuditLine(paths.logsDir + "/heartbeat.jsonl", {
                 event: "agent_deferred",
                 sessionId: savedId,
@@ -1553,6 +1568,13 @@ async function ensureAgent(deps) {
               agentPromise = null;
               return null;
             }
+            if (permanent) {
+              appendAuditLine(paths.logsDir + "/heartbeat.jsonl", {
+                event: "agent_resume_permanent",
+                sessionId: savedId,
+                error: resumeMessage.slice(0, 160)
+              });
+            }
             try {
               const handle = await withTimeout(Promise.resolve(ctx.agents.create({ sessionId: savedId, meta: { cwd: paths.dataDir }, ...agentOptions ? { agentOptions } : {}, setup })), 3e4, "agents.create (self-heal) timeout");
               agent = unwrap(handle);
@@ -1760,7 +1782,7 @@ async function observeBoundSessions(bc) {
   const { deps, now } = bc;
   const { guard, paths } = deps;
   const { loadBindings, observeTargets } = await import("./bindings-225SI7KC.js");
-  const { inboxAppend, inboxFilePath: inboxFilePath2 } = await import("./inbox-JLT5G7TL.js");
+  const { inboxAppend, inboxFilePath: inboxFilePath2 } = await import("./inbox-P26DDMWC.js");
   const data = loadBindings(guard, paths.settingsDir);
   const targets = observeTargets(data);
   if (targets.length === 0) return;
@@ -2428,6 +2450,7 @@ export {
   StatusReader,
   buildDigest,
   applyHeartbeatInterval,
+  looksPermanentResumeFailure,
   sessionEvents,
   sessionEventCount,
   HOME_ROTATE_EVENT_COUNT,
@@ -2451,4 +2474,4 @@ export {
   beat,
   startOrchestrator
 };
-//# sourceMappingURL=chunk-HT57FOEF.js.map
+//# sourceMappingURL=chunk-AJ5HLAL7.js.map