dsh-mem0-memory 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -5,6 +5,18 @@
 
 ## [Unreleased]
 
+### 0.1.5（2026-10-18）
+
+- **适配 DSH 0.2.x（0.2.1-rc.2 实测）**，两处改动，缺一不可：
+  1. **peer 范围放宽**：`@deepseek-ai/dsh-agent-loop` 由 `^0.1.0-rc.6`（= `>=0.1.0-rc.6 <0.2.0`）改为 **`^0.1.0-rc.6 || ^0.2.1-rc.2`**。0.2.1 起底座新增「插件兼容性硬校验」，旧范围会被判为不兼容并**拒绝安装 + 回滚**（`installation rejected: Plugin dsh-mem0-memory@0.1.4 is incompatible with dsh 0.2.1-rc.2`）。
+      - 选**有界区间**而非 `*`/`>=`：本插件会向会话写入事件，声明「任何版本都支持」会在 DSH 大版本再变时静默踩雷（参见 2026-08-19 会话损坏事故）。0.3.x 起需重新验证后再放宽。
+      - 覆盖：0.1.5-rc.3（旧线）✅、0.2.1-rc.2（新线）✅、0.2.x 后续 rc/补丁 ✅。
+  2. **注入消息的 `source.kind` 改写**：`{ kind: "plugin", plugin: "dsh-mem0-memory", form: "recall" }` → **`{ kind: "plugin:dsh-mem0-memory", form: "recall" }`**。
+      - 根因：0.2.x 引入 session format **v4**，其 `source()` 校验**明确禁止 `kind:"plugin"`**（要求生产者自有 kind，`plugin:<name>` 即 V3→V4 迁移器对未知插件的标准映射）。若只放宽 peer 不改这里，结果是「装得上、但每轮对话在注入后报 `format v4 message requires a producer-owned source kind` 而失败」——比装不上更糟。
+      - 兼容性：0.1.x 的写入门槛只要求「kind 为非空字符串」，`kind:"plugin"` 的强校验仅针对 `system/message`，`user/message` 不受限 → 同一份代码在 0.1.x 与 0.2.x 上都能跑，无需按底座版本分支。
+- 影响面：`lib/index.js`（注入点一处）、`package.json`（版本 + peer）；server / G1 解析器 / 导入命令未改动。
+- 验证：0.2.1-rc.2 真实环境实跑（安装通过、注入链完整、会话可关闭重开、转录 v4 事件形态正确）。
+
 ### 0.1.4（2026-08-23）
 
 - **server 自动拉起（autoStartServer）**：DSH 启动时插件探测 mem0 server 的 `/health`（3s 超时）——未在跑则自动 spawn 一次（`detached` 子进程，不随 DSH 退出）；已在跑则不动。用户装了插件 = 期望「与平台同步启动」，忘记手动开 server 也能工作。

package/README.md

@@ -152,6 +152,8 @@ python scripts/mem0-server.py --port 18200 # 启动服务
 > 重启后，**跑一次首次导入（见下节）**，历史会话就进记忆库了——之后自动增量，不用再管。
 >
 > **peer 依赖警告可忽略**：安装时 pnpm 可能提示 `missing peer @deepseek-ai/cordis` / `@deepseek-ai/dsh-agent-loop`——这是声明性警告，插件运行时会从 DSH 的 bundle 安装处解析这些依赖，无需处理。
+>
+> **兼容的 DSH 版本**：`dsh-agent-loop` peer 范围 = `^0.1.0-rc.6 || ^0.2.1-rc.2`（0.1.5-rc.3 与 0.2.1-rc.2 均已验证）。DSH 0.2.1 起底座会做插件兼容性硬校验，版本号不在范围内会被**拒绝安装**；若你用的是更晚的大版本（0.3.x 起），请先确认插件已跟进再装。
 
 ## 首次导入：把你的历史会话装进记忆库
 

package/lib/index.js

@@ -350,13 +350,21 @@ export async function apply(ctx, config = {}) {
       // 注入：在最后一条 claimed 消息之后插入记忆块。
       // 必须带消息 id 且 content 用文本块数组 —— DSH 的 user/message 事件校验要求
       // message.id 为非空字符串、content 为块数组，缺失会把整个 session 持久化日志判为损坏。
+      //
+      // source.kind（2026-10-18 适配 DSH 0.2.x / session format v4）：
+      //   0.2.x 的 v4 格式禁止 `kind:"plugin"` 这个 catch-all 包装
+      //   （dsh-session-format-v3-to-v4 的 source() 校验：kind 必须非空且 ≠ "plugin"），
+      //   要求生产者声明自有 kind；V3→V4 迁移器对未知插件的映射结果就是 `plugin:<name>`，
+      //   此处直接用同一命名，保证新写记录与迁移后的历史记录同形。
+      //   兼容性：0.1.x 的写入门槛只要求「kind 是非空字符串」，`kind:"plugin"` 的强校验
+      //   仅针对 system/message，user/message 不受限制 → 该写法 0.1.x 与 0.2.x 同时合法。
       const lastClaimedIndex = decision.messages.findLastIndex((message) => messages.includes(message));
       await probe(`lastClaimedIndex=${lastClaimedIndex}`);
       const injected = {
         role: "user",
         id: randomUUID(),
         content: [{ type: "text", text: result.block }],
-        source: { kind: "plugin", plugin: "dsh-mem0-memory", form: "recall" },
+        source: { kind: "plugin:dsh-mem0-memory", form: "recall" },
       };
       const finalMessages = decision.messages.toSpliced(lastClaimedIndex + 1, 0, injected);
       await probe(`injected! finalMessages=${finalMessages.length}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mem0-memory",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Thin bridge: recall Mem0 memories into DSH agent context via agent/pre-step injection.",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6 || ^0.2.1-rc.2"
   },
   "license": "MIT",
   "repository": {