dsh-tdai-memory 0.2.11 → 0.2.12

package/README.md

@@ -110,8 +110,15 @@ settings page (记忆 / Memory) or directly in `settings.yaml` under
 >   the plugin patches it automatically on first start — **restart `dsh web`
 >   once more** and the section appears. A dsh update overwrites the patch;
 >   the next plugin start re-applies it.
-> - Settings changes apply **after a restart** (TdaiCore is built at startup).
-> - Tested against DSH `0.1.0-rc.6`, `0.1.0-rc.7`, and `0.1.0-rc.8`.
+> - Settings changes apply **after a restart** (TdaiCore is built at startup).
+> - Tested against DSH `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, and
+>   `0.1.1-rc.1`.
+
+`node-llama-cpp` is an optional peer used only by the fully local embedding
+backend. It is intentionally not installed by default because its native build
+requires explicit pnpm build approval. Remote OpenAI-compatible embeddings do
+not need it. Users who select the local backend should install and approve
+`node-llama-cpp` in the target DSH profile separately.
 
 ## Known trade-offs
 
@@ -128,3 +135,4 @@ settings page (记忆 / Memory) or directly in `settings.yaml` under
 ## License
 
 MIT
+

package/README.zh.md

@@ -16,7 +16,11 @@
 - **自动召回注入**：每次组装提示词时，按当前用户消息检索相关记忆 + 画像，作为动态上下文注入（模型"凭空想起"）
 - **工具**：`tdai_memory_search`（L1 结构化检索）、`tdai_conversation_search`（L0 原文检索）
 
-数据目录复用现有 `~/.memory-tencentdb/memory-tdai`，**旧记忆无缝继承**。
+数据目录复用现有 `~/.memory-tencentdb/memory-tdai`，**旧记忆无缝继承**。
+
+`node-llama-cpp` 仅供完全本地的 embedding 后端使用，现在声明为可选 peer，默认安装不会再触发原生构建脚本。使用 OpenAI 兼容远程 embedding 时不需要它；选择本地后端的用户需在目标 DSH profile 中单独安装并批准 `node-llama-cpp` 的构建。
+
+已针对 DSH `0.1.0-rc.6`、`0.1.0-rc.7`、`0.1.0-rc.8` 和 `0.1.1-rc.1` 测试。
 
 ## 架构（移植方式）
 
@@ -70,3 +74,4 @@ tdai-memory:
 - **dedup**：LLM 冲突检测输出解析不稳（曾导致 stored=0），默认关闭；开启需换更稳的模型
 - **L1 记忆向量**：随存储写入（8088 embedding 快）；L0 向量走后台任务，headless 退出时由 `destroy()` drain
 - **升级**：上游拉新代码后，在 tdai 项目目录重跑 `npx tsc -p dsh-tsconfig.json`（产物在 `dist-dsh/`）
+

package/client.js

@@ -347,3 +347,4 @@ window.__ModuleLoader__.load({
     return module.exports;
   }
 });
+

package/index.js

@@ -25,7 +25,6 @@ import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-sett
 import { TdaiCore } from "./vendor/tdai/core/tdai-core.js";
 import { parseConfig } from "./vendor/tdai/config.js";
 import { StandaloneHostAdapter } from "./vendor/tdai/adapters/standalone/host-adapter.js";
-import { ensureSettingsNamespaceExposed } from "./vendor/dsh-settings-expose.js";
 
 /** Cordis plugin name. */
 const name = "tdai-memory";
@@ -382,12 +381,6 @@ function apply(ctx, config) {
     },
   });
 
-  // dsh-host-apiproxy hard-codes which settings namespaces the Web client may
-  // see; without this, the settings section answers `settings-not-exposed`
-  // on any stock install. Patch the allowlist idempotently (self-heals after
-  // dsh updates overwrite the file).
-  ensureSettingsNamespaceExposed(ctx, "tdai-memory", ctx.logger);
-
   // Fallback when no settings service ever mounts: build from the entry
   // config. One-shot — if the settings mount arrives later, its build
   // supersedes this one. Delayed past the 0ms window so headless/web boots

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-tdai-memory",
-    "version":  "0.2.11",
+    "version":  "0.2.12",
     "description":  "DeepSeek Harness 的 TencentDB Agent Memory 移植：L0 对话捕获 → L1 结构化记忆提取 → L2 场景/L3 画像，自动召回注入 + 记忆/对话搜索工具；复用现有 ~/.memory-tencentdb/memory-tdai 数据；附 Web UI 设置栏。",
     "type":  "module",
     "main":  "index.js",
@@ -61,15 +61,19 @@
                          "sqlite-vec":  "0.1.7-alpha.2",
                          "undici":  "^8.1.0"
                      },
-    "optionalDependencies":  {
-                                 "node-llama-cpp":  "^3.19.1"
-                             },
-    "peerDependencies":  {
-                             "react":  "^18.2.0",
-                             "@deepseek-ai/dsh-tools":  "^0.1.0-rc.6",
-                             "@deepseek-ai/dsh-settings":  "^0.1.0-rc.6"
+    "peerDependencies":  {
+                             "react":  "^18.2.0",
+                             "@deepseek-ai/dsh-tools":  "^0.1.0-rc.6 || ^0.1.1-rc.1",
+                             "@deepseek-ai/dsh-settings":  "^0.1.0-rc.6 || ^0.1.1-rc.1",
+                             "node-llama-cpp":  "^3.19.1"
                          },
+    "peerDependenciesMeta":  {
+                                 "node-llama-cpp":  {
+                                                        "optional":  true
+                                                    }
+                             },
     "scripts":  {
-                    "test":  "node tests/settings-scope-compat.test.mjs"
+                    "test":  "node tests/settings-scope-compat.test.mjs && node tests/install-contract.test.mjs"
                 }
-}
+}
+

package/vendor/dsh-settings-expose.js

@@ -1,75 +0,0 @@
-/**
- * dsh-host-apiproxy exposes only namespaces listed in its hard-coded
- * WEB_SETTINGS_NAMESPACES allowlist to the Web settings client. A namespace
- * registered by a third-party plugin answers `settings-not-exposed` even
- * though it is registered — upstream explicitly defers letting plugins
- * expose their own configuration.
- *
- * This module idempotently patches that allowlist in the dsh installation
- * actually loaded by the host process, so the plugin's settings section
- * becomes visible in the Web UI without manual edits. A dsh update
- * overwrites the file; the next plugin start re-patches it.
- */
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join, sep } from "node:path";
-
-/**
- * Ensure `nsName` is present in dsh-host-apiproxy's WEB_SETTINGS_NAMESPACES.
- * No-op when already exposed or when the file cannot be located/patched.
- * @param {import("cordis").Context} ctx
- * @param {string} nsName - settings namespace short name (e.g. "tdai-memory").
- * @param {{info?: Function, warn?: Function}} logger - dsh logger.
- */
-export function ensureSettingsNamespaceExposed(ctx, nsName, logger) {
-  void ctx;
-  try {
-    const target = findApiproxyIndex();
-    if (!target) {
-      logger?.warn?.(`[settings-expose] could not locate dsh-host-apiproxy; add "${nsName}" to WEB_SETTINGS_NAMESPACES in dsh-host-apiproxy/lib/index.js to get a Web settings section`);
-      return;
-    }
-    let src;
-    try {
-      src = readFileSync(target, "utf8");
-    } catch (error) {
-      logger?.warn?.(`[settings-expose] cannot read ${target}: ${String(error)}`);
-      return;
-    }
-    const body = src.match(/const WEB_SETTINGS_NAMESPACES = \[([\s\S]*?)\];/)?.[1] ?? "";
-    if (body.includes(`"${nsName}"`)) return; // already exposed (manual or previous patch)
-    const patched = src.replace(/(const WEB_SETTINGS_NAMESPACES = \[[\s\S]*?)(\n\s*\];)/, (_, pre, post) => {
-      const trailingComma = /,\s*$/.test(pre) ? "" : ",";
-      const sep2 = pre.trimEnd().endsWith("[") ? "" : trailingComma;
-      return `${pre}${sep2}\n\t"${nsName}"${post}`;
-    });
-    if (patched === src) {
-      logger?.warn?.(`[settings-expose] allowlist pattern not found in ${target}; add "${nsName}" to WEB_SETTINGS_NAMESPACES manually`);
-      return;
-    }
-    writeFileSync(target, patched, "utf8");
-    logger?.info?.(`[settings-expose] added "${nsName}" to WEB_SETTINGS_NAMESPACES (${target}) — restart dsh web for the settings section to appear`);
-  } catch (error) {
-    logger?.warn?.(`[settings-expose] failed: ${String(error)}`);
-  }
-}
-
-function findApiproxyIndex() {
-  // 1) The host process has already loaded dsh-host-apiproxy: read the real
-  //    module path from the CommonJS module cache (any install layout).
-  try {
-    const Module = createRequire(import.meta.url)("module");
-    const cache = Module._cache ?? {};
-    for (const key of Object.keys(cache)) {
-      if (key.includes(`${sep}dsh-host-apiproxy${sep}`) && key.endsWith(`${sep}index.js`)) return key;
-    }
-  } catch { /* fall through */ }
-  // 2) Fallback: sibling of @deepseek-ai/dsh-settings (dsh's nested layout).
-  try {
-    const require = createRequire(import.meta.url);
-    const settingsEntry = require.resolve("@deepseek-ai/dsh-settings");
-    const candidate = join(dirname(dirname(dirname(settingsEntry))), "dsh-host-apiproxy", "lib", "index.js");
-    if (existsSync(candidate)) return candidate;
-  } catch { /* fall through */ }
-  return "";
-}