dsh-memory-engine 0.5.7 → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 阿木
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,6 +4,22 @@ DSH 插件的本地记忆引擎，带神经网络可视化。它让 agent 保存
 
 当前版本：0.5.2。Node ≥22，零新增依赖；DSH 宿主提供 `@deepseek-ai/dsh-tools@0.2.1-rc.3`。本机安装已启用，无需重复安装。
 
+## 支持的 DSH 版本
+
+实测可用范围：**@deepseek-ai/dsh-tools 0.1.0-rc.8 ~ 0.2.2-alpha.2**（本插件只用其中的 defineTool，这几个版本签名一致）。
+
+插件对宿主做了三处兜底，所以版本不合适时也不会「装上了却什么都没有」：
+
+| 宿主情况 | 插件行为 |
+| --- | --- |
+| 有 ctx.effect | 正常注册，随插件卸载一起清理 |
+| 没有 ctx.effect | 直接注册工具，功能不减少，日志留一条提示 |
+| 解析不到 @deepseek-ai/dsh-tools | 用内置直通 defineTool，工具照常可用 |
+| 没有 header.actions 插槽 | 图谱按钮退到 iews.actions（在「更多视图」菜单里） |
+| 完全没有 slots 服务 | 跳过按钮，记忆工具不受影响 |
+
+peerDependencies 已放宽为 >=0.1.0-rc.8 <0.3.0 并标为 optional——宿主自带这份 SDK，不该因为版本号不匹配而装不上。
+
 ## 界面
 
 安装并启用插件后，完全退出 DSH 再打开。进入任意会话，头部第一行会出现 **🧠 记忆图谱** 按钮。
@@ -219,3 +235,7 @@ node --test test/*.test.mjs
 本地开发安装：将本包作为目标 DSH profile 的 link 依赖，并启用同名 bundle；客户端入口已声明为 web/immediately。完全退出再打开 DSH。不要复制宿主 SDK 到包里。
 
 文件写入仍继承原 MemoryStore 的单进程同步事务方式；多个独立宿主同时修改同一文件不提供跨进程锁。历史验收和本次截图、反向验证 HTML、文件变更清单位于相邻的 dsh-memory-engine-deliveries 目录。
+
+## 许可
+
+MIT。可以商用、可以修改、可以再发布，保留版权声明即可（见 [LICENSE](./LICENSE)）。

package/lib/client.js

@@ -9,6 +9,9 @@ window.__ModuleLoader__.load({
     // views.actions 是「更多视图」下拉菜单的行（Chat/Trajectory 旁边的 ⋯），
     // 注册进去只是菜单里多一行，看不见；header.actions 才是头部正常按钮区。
     var SLOT_NAME = "conversation.session.header.actions";
+    // 不同 DSH 版本暴露的插槽名不一样：新版本用 header.actions，
+    // 老版本没有这个槽时退回 views.actions（会出现在「更多视图」菜单里，虽然不显眼但能用）。
+    var SLOT_FALLBACKS = ["conversation.session.header.actions", "conversation.session.header.views.actions"];
     var VIEW_URL = "http://127.0.0.1:18886/index.html";
 
     function MemoryButton() {
@@ -56,16 +59,35 @@ window.__ModuleLoader__.load({
       return React.createElement(React.Fragment, null, button, ReactDOM.createPortal(overlay, document.body));
     }
 
-    function apply(ctx) {
-      try {
-        ctx.slots.inject(SLOT_NAME, function () {
-          return ctx.slots.register({
-            name: SLOT_NAME,
+    function registerOn(slots, name) {
+      var disposable = null;
+      slots.inject(name, function () {
+        try {
+          disposable = slots.register({
+            name: name,
             id: "memory-engine-map",
             order: 50,
             label: function () { return "记忆图谱"; },
           }, MemoryButton);
-        });
+        } catch (error) {
+          try { console.error("[dsh-memory-engine] 注册到 " + name + " 失败：", error); } catch (ignored) {}
+        }
+        return disposable;
+      });
+      return disposable;
+    }
+
+    function apply(ctx) {
+      try {
+        if (!ctx || !ctx.slots || typeof ctx.slots.inject !== "function") {
+          try { console.warn("[dsh-memory-engine] 宿主没有 slots 服务，跳过图谱按钮（记忆工具不受影响）"); } catch (ignored) {}
+          return;
+        }
+        // 只注册第一个能用的插槽：优先 header.actions，老宿主没有就退到 views.actions
+        var target = ctx.slots && typeof ctx.slots.has === "function" && !ctx.slots.has(SLOT_FALLBACKS[0])
+          ? SLOT_FALLBACKS[1]
+          : SLOT_NAME;
+        registerOn(ctx.slots, target);
       } catch (error) {
         try { console.error("[dsh-memory-engine] 插槽注册失败：", error); } catch (ignored) {}
       }

package/lib/index.js

@@ -154,15 +154,33 @@ export function createTools(defineTool, store = new MemoryStore(), { map = gener
   ];
 }
 
+// 宿主 SDK 的 defineTool 在不同 DSH 版本间签名一致（实测 0.1.0-rc.8 ~ 0.2.2-alpha.2 都是
+// defineTool(options)），但**包不一定能解析到**——比如插件被装在宿主 node_modules 之外。
+// 解析失败时退回一个直通实现：工具照常注册，只是少了宿主的返回值包装。
+async function resolveDefineTool(warning) {
+  try {
+    const sdk = await import('@deepseek-ai/dsh-tools');
+    if (typeof sdk.defineTool === 'function') {
+      const version = sdk.version ?? '';
+      if (version) warning(`宿主 dsh-tools 版本 ${version}`);
+      return sdk.defineTool;
+    }
+    warning('@deepseek-ai/dsh-tools 没有导出 defineTool，改用内置直通实现');
+  } catch (error) {
+    warning(`解析 @deepseek-ai/dsh-tools 失败（${error.message}），改用内置直通实现`);
+  }
+  return options => options;
+}
+
 export function apply(ctx) {
   try {
     if (typeof ctx?.tools?.register !== 'function') throw new Error('tools 服务不可用');
-    if (typeof ctx.effect !== 'function') throw new Error('ctx.effect 不可用');
-    const registration = ctx.effect(async () => {
+    // ctx.effect 是较新宿主才有的生命周期钩子。没有它就直接注册——
+    // 否则老版本 DSH 上插件会「装上了但一个工具都没有」，这是最糟的失败方式。
+    const setup = async () => {
       const disposers = [];
       try {
-        // The host resolves this public SDK; no bundled copy or runtime dependency.
-        const { defineTool } = await import('@deepseek-ai/dsh-tools');
+        const defineTool = await resolveDefineTool(message => warn(ctx, message));
         const store = new MemoryStore();
         for (const tool of createTools(defineTool, store, { warning: message => warn(ctx, message) })) disposers.push(ctx.tools.register(tool));
         try {
@@ -182,8 +200,14 @@ export function apply(ctx) {
         for (const dispose of disposers.reverse()) { try { dispose(); } catch { /* keep unwinding */ } }
         report(ctx, error);
       }
-    }, 'memory-engine.tools');
-    // Await setup without returning its disposer as a second plugin teardown.
-    return Promise.resolve(registration).then(() => undefined, error => { report(ctx, error); });
+    };
+
+    if (typeof ctx.effect === 'function') {
+      const registration = ctx.effect(setup, 'memory-engine.tools');
+      // Await setup without returning its disposer as a second plugin teardown.
+      return Promise.resolve(registration).then(() => undefined, error => { report(ctx, error); });
+    }
+    warn(ctx, '宿主没有 ctx.effect，直接用注册式初始化（功能不减少）');
+    return Promise.resolve(setup()).then(() => undefined, error => { report(ctx, error); });
   } catch (error) { report(ctx, error); }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-engine",
-  "version": "0.5.7",
+  "version": "0.6.1",
   "description": "Local DSH memory engine with neuron network visualization and private file import",
   "keywords": [
     "dsh",
@@ -29,14 +29,15 @@
     "lib/",
     "scripts/",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=22"
   },
   "dependencies": {},
   "peerDependencies": {
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.3"
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.3.0"
   },
   "dsh": {
     "bundle": {
@@ -48,6 +49,11 @@
     }
   },
   "bugs": "https://github.com/",
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
+  },
   "scripts": {
     "test": "node --test test/*.test.mjs"
   }