@furongjun1999/dsh-memory 0.4.7 → 0.4.9

package/lib/index.d.ts

@@ -17,8 +17,10 @@
  *   name: '@furongjun1999/dsh-memory'
  *   config:
  *     mdcg:                              # 记忆真源：认知图（md 文档）
- *       # root = 记忆写入路径（用户可改）。缺省 = 插件仓自身 data/mdcg。
- *       # 覆盖优先级：env MDCG_ROOT > <插件仓>/data/paths.json > 本项 > 默认
+ *       # root = 记忆写入路径（用户可改）。缺省 = 用户级状态根 data/mdcg
+ *       #   （~/.dsh/.dsh-memory/data/mdcg；**不在插件包内**——包内数据会被
+ *       #    pnpm 更新连目录一起删掉，见 src/lib/datapath.ts 头注）
+ *       # 覆盖优先级：env MDCG_ROOT > <用户级状态根>/paths.json > 本项 > 默认
  *       # root: 'D:/somewhere/mdcg'        # 例：把记忆库放到别处
  *       actor: 'dsh-memory'
  *     env:                               # 写入凭据：默认【关闭】，由你决定是否打开

package/lib/index.js

@@ -17,8 +17,10 @@
  *   name: '@furongjun1999/dsh-memory'
  *   config:
  *     mdcg:                              # 记忆真源：认知图（md 文档）
- *       # root = 记忆写入路径（用户可改）。缺省 = 插件仓自身 data/mdcg。
- *       # 覆盖优先级：env MDCG_ROOT > <插件仓>/data/paths.json > 本项 > 默认
+ *       # root = 记忆写入路径（用户可改）。缺省 = 用户级状态根 data/mdcg
+ *       #   （~/.dsh/.dsh-memory/data/mdcg；**不在插件包内**——包内数据会被
+ *       #    pnpm 更新连目录一起删掉，见 src/lib/datapath.ts 头注）
+ *       # 覆盖优先级：env MDCG_ROOT > <用户级状态根>/paths.json > 本项 > 默认
  *       # root: 'D:/somewhere/mdcg'        # 例：把记忆库放到别处
  *       actor: 'dsh-memory'
  *     env:                               # 写入凭据：默认【关闭】，由你决定是否打开
@@ -50,7 +52,7 @@ import { installMemoryHooks } from './hooks.js';
 // LIB 本地库：角色扮演网页 / 互维维护 / 白箱 LLM 适配器统一收在 src/lib/。
 import { installRoleplayWeb } from './lib/roleplay_web.js';
 import { MdcgClient } from './lib/mdcg_client.js';
-import { describeDataPaths, mdcgRoot } from './lib/datapath.js';
+import { describeDataPaths, migrateLegacyData, mdcgRoot, repoRoot } from './lib/datapath.js';
 // 写入凭据密钥环（首启引导）：显式配置 → ~/.mdcg/token → 首启自动签发。
 import { resolveToken } from './lib/token_store.js';
 /**
@@ -118,8 +120,9 @@ export const Config = z.object({
         .default({ enabled: false, heartbeatMs: 10 * 60 * 1000 }),
     /** 认知图（md_cg）：记忆唯一真源。
      *  root 为**记忆写入路径**（用户可改）。缺省空串 = 未指定，按优先级解析：
-     *    ① env MDCG_ROOT ② `<插件仓>/data/paths.json` 的 root
-     *    ③ 本项 ④ 默认 `<插件仓>/data/mdcg`
+     *    ① env MDCG_ROOT ② `<用户级状态根>/paths.json` 的 root
+     *    （旧 `<插件仓>/data/paths.json` 兼容读）
+     *    ③ 本项 ④ 默认 `<用户级状态根>/data/mdcg`
      *  相对路径一律相对**插件仓根**解析——历史教训：相对 cwd 的相对路径随
      *  宿主 cwd 漂移，cwd 落在别仓时记忆真源分裂成互不可见的两处。
      *  tenant/actor 决定私有内容加解密的身份：与 migrate_roleplay 的
@@ -193,13 +196,33 @@ export async function apply(ctx, config) {
             timeoutMs: config.toolCallTimeoutMs,
             maxRetryDelayMs: config.maxRetryDelayMs,
         });
+        // 数据面迁出插件包（issue #18 相邻问题）：旧版把运行时数据与路径配置写在包内
+        // `<pkg>/data`，pnpm 更新会连目录一起替换（实机实证：data/ 54 文件 → 0，
+        // 46 条记忆节点靠人工备份回填）。首启把「旧位置仍有货」的数据**复制**到用户级
+        // 数据根；必须在 mdcg.start() 之前——store 要在 Python 子进程接管前就位。
+        const migrated = migrateLegacyData();
+        if (migrated.ran) {
+            ctx.logger.info(`dsh-memory: 数据面已迁出插件包（旧位置只复制未删除）：`
+                + `${migrated.from} → ${migrated.to}（${migrated.copied} 项`
+                + `${migrated.failed.length ? `，失败 ${migrated.failed.join(',')}` : ''}）`);
+        }
         mdcg.start();
         // 启动留痕：把「记忆真源在哪、由谁决定、路径是否存在」写进可审计日志，
         // 避免再次出现「以为在记忆、其实写到了别仓」的静默分裂（历史事故）。
         const dp = describeDataPaths(config.mdcg.root);
         ctx.logger.info(`dsh-memory: 记忆真源路径 = ${dp.mdcgRoot}（来源 ${dp.source}，`
-            + `dataRoot=${dp.dataRoot}，存在=${dp.mdcgRootExists ? '是' : '否（首次写入将创建）'}，`
+            + `状态根=${dp.stateRoot}，dataRoot=${dp.dataRoot}，`
+            + `存在=${dp.mdcgRootExists ? '是' : '否（首次写入将创建）'}，`
             + `用户可改：${dp.pathsFile}）`);
+        // 包管理器装的插件 + 路径配置还在旧包内位置：pnpm 下次更新会把该文件连目录一起
+        // 删除，用户配置随之丢失（回落默认根 → 表现为「记忆不见了」）。只在真的会被删的
+        // 布局下提醒（开发用的 git clone 不含 node_modules 段 → 不打扰）。
+        const pnpmManaged = repoRoot().split(/[\\/]/).includes('node_modules');
+        if (pnpmManaged && String(dp.pathsFileSource) === 'legacy') {
+            ctx.logger.warn(`dsh-memory: 路径配置仍在插件包内（${dp.pathsFile}）——pnpm 更新该包会连目录`
+                + `一起删除。请复制到 ${String(dp.stateRoot)}/paths.json 后重启`
+                + `（数据面已自动复制到 ${String(dp.dataRoot)}）。`);
+        }
         brainReady = await mdcg.waitReady();
         if (brainReady) {
             ctx.logger.info(`dsh-memory: 认知图已就绪（MDCG_ROOT=${resolvedRoot}）`);

package/lib/lib/datapath.d.ts

@@ -2,9 +2,84 @@ export declare const ENV_DATA_ROOT = "MDCG_DATA_ROOT";
 export declare const ENV_MDCG_ROOT = "MDCG_ROOT";
 /** 插件仓根目录：自本模块所在目录向上找 package.json（对构建层级不敏感）。 */
 export declare function repoRoot(): string;
-/** 用户可编辑的路径配置文件（固定在插件仓 data/，不受 dataRoot 取值影响）。 */
+export declare const ENV_STATE_ROOT = "MDCG_STATE_ROOT";
+/**
+ * 用户级状态根（**插件包目录之外**）：路径配置与默认数据根的落点。
+ * 优先级：`MDCG_STATE_ROOT` → `$DSH_HOME/.dsh-memory` → `~/.dsh/.dsh-memory`。
+ * `DSH_HOME` **未必**由宿主注入（本仓 `dsh/dsh-web-start.bat` 自行 set），
+ * 故家目录兜底；`~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志同址）。
+ */
+export declare function stateRoot(): string;
+/** 旧版落点（插件包内 `data/`）——更新时会被整个替换，只作兼容读与迁移源。 */
+export declare function legacyDataRoot(): string;
+/**
+ * 用户可编辑的路径配置文件：
+ *   `<用户级状态根>/paths.json` → 不存在则回落**旧** `<插件仓>/data/paths.json`
+ *   （兼容读）→ 都不存在返回新位置（首次写入时创建）。
+ * 不做自动复制：配置文件是「谁说了算」的唯一真源，悄悄复制会让旧件的后续编辑
+ * 静默失效——迁移只搬数据面，配置显式交给用户搬（或用 `set_user_root`）。
+ */
 export declare function pathsFile(): string;
+/** 生效中的 paths.json 位置来源：`user`=用户级 / `legacy`=旧包内（兼容读）。 */
+export declare function pathsFileSource(): 'user' | 'legacy';
+/** 默认数据根 = 用户级状态根下 `data/`（**插件包目录之外**，更新不触碰）。 */
 export declare function defaultDataRoot(): string;
+export interface LegacyMigration {
+    /** 是否真的搬了（false 时 `reason` 说明为何没搬）。 */
+    ran: boolean;
+    reason: string;
+    from: string;
+    to: string;
+    /** 复制成功的顶层条目数。 */
+    copied: number;
+    /** 复制失败的顶层条目（权限/占用等，逐项吞掉不抛）。 */
+    failed: string[];
+}
+/**
+ * 一次性迁移：把旧版留在**插件包内** `data/` 的数据面复制到用户级默认数据根。
+ *
+ * 触发条件（三条同时满足，缺一不动）：
+ *   ① 数据根未被显式配置（env `MDCG_DATA_ROOT` / paths.json 的 `data_root` 都未设，
+ *      即 `dataRoot()` 恰为默认值）——显式配置是用户的决定，越权搬运等于改他的真源；
+ *   ② 旧位置存在；
+ *   ③ 目标顶层条目不存在或为空目录（**不覆盖、不合并**已有数据）。
+ *
+ * 只复制不删除（旧目录随后由 pnpm 更新自然移除）；`paths.json` 不复制
+ * （配置走 `pathsFile()` 兼容读，复制会制造「哪个文件说了算」的两说）。
+ * 任何异常逐项吞掉并记入 `failed`——迁移是增益，不该成为启动失败源。
+ *
+ * 边界（如实）：pnpm 更新是**先替换包目录再启动新代码**，故旧数据在升级瞬间
+ * 即已消失，本函数只能接手「旧位置那时仍在」的情形（手工安装、就地覆盖、
+ * 或包目录未被清理）；已在升级中丢掉的数据无法由此恢复——发布说明须提示
+ * 0.4.8 及更早用户升级前备份 `<profile>/node_modules/<pkg>/data/`。
+ */
+export declare function migrateLegacyData(): LegacyMigration;
+export declare const ENV_CHILD_CWD = "MDCG_CHILD_CWD";
+/**
+ * 子进程的工作目录（**必须落在插件包目录之外**）。
+ *
+ * 为什么不能沿用 `repoRoot()`：Windows 不允许删除／改名「正被某进程当作 CWD」
+ * 的目录。DSH 的插件按 hoisted 布局安装在 `<profile>/node_modules/<pkg>`，
+ * 而 `pnpm` 每次更新该包都要先 `rmdir` 包目录 → 子进程一旦把包目录当 CWD，
+ * 更新必然 `ERR_PNPM_EBUSY: resource busy or locked`（含升级回滚一起失败，
+ * 应用内永远升不动这个插件）。注意落点也**不能**是 `<包>/data`——它仍在包内，
+ * 实测同样 `err=32`。
+ *
+ * 落点要求「稳定存在」：进程 cwd 指向已消失的目录会引出新的怪问题，故按稳定度
+ * 排候选目录，取**第一个能建成**的：
+ *   1. `MDCG_CHILD_CWD`（显式覆盖）
+ *   2. `$DSH_HOME/.dsh-memory/run`
+ *   3. `~/.dsh/.dsh-memory/run` —— 家目录兜底：`DSH_HOME` **未必**由宿主注入
+ *      （本仓 `dsh/dsh-web-start.bat` 是自行 `set DSH_HOME=%USERPROFILE%\.dsh`），
+ *      而 `~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志、`token_store` 密钥环同址）
+ *   4. 系统临时目录（可能被清理，故排最后）
+ * 全部建不成时不抛错，交给 spawn 报错——cwd 落点只是防呆，不该成为启动失败源。
+ *
+ * 安全性：`python -m` 的模块解析由 `pythonPathValue()` 的 PYTHONPATH 独立保证，
+ * 不依赖 cwd；已实测 cwd=包目录 与 cwd=包外 时，MCP initialize 握手与
+ * tools/list 工具面（33 个工具）完全一致。
+ */
+export declare function runRoot(): string;
 /** 数据根（记忆/账本/运行态的父目录）。 */
 export declare function dataRoot(): string;
 /**

package/lib/lib/datapath.js

@@ -2,21 +2,33 @@
  * datapath.ts · 灵枢数据根解析（记忆写入路径可配置）
  *
  * 与 Python 侧 `md_cg/datapath.py` **同口径**——两侧读同一份
- * `<插件仓>/data/paths.json`，避免大脑与脚本对「记忆真源在哪」各持一说。
+ * `<用户级状态根>/paths.json`（新位置；旧版 `<插件仓>/data/paths.json`
+ * 仍兼容读），避免大脑与脚本对「记忆真源在哪」各持一说。
+ *
+ * 为什么默认不再取「插件仓自身 data/」（issue #18 相邻问题，数据丢失级）：
+ *   DSH 插件按 hoisted 布局装在 `<profile>/node_modules/<pkg>`，`pnpm` 更新该包
+ *   会**整个替换包目录**——运行时数据落在包内（`<pkg>/data`）时，每次更新成功
+ *   即连目录一起删掉（贡献者实机实证：`data/` 54 文件 → 0，46 条记忆节点只能
+ *   靠人工备份回填）；`paths.json` 同址，用户配置一并丢失。故默认数据根与配置
+ *   文件一律落**用户级状态根**（见 `stateRoot()`），与包目录彻底解耦。
  *
  * 优先级（高 → 低）：
  *   1. 环境变量 `MDCG_DATA_ROOT`（数据根）／ `MDCG_ROOT`（认知图根）
- *   2. 用户可编辑配置 `<插件仓>/data/paths.json` 的 `data_root` / `root`
+ *   2. 用户可编辑配置 `paths.json` 的 `data_root` / `root`
+ *      （位置：`<用户级状态根>/paths.json`；旧 `<插件仓>/data/paths.json` 兼容读）
  *   3. 插件配置项 `mdcg.root`（可为空=未指定）
- *   4. 默认 `<插件仓>/data/mdcg`（**自身仓库**，与进程 cwd 解耦）
+ *   4. 默认 `<用户级状态根>/data/mdcg`
  *
- * 为什么默认不再取「相对 cwd 的 data/mdcg」：
+ * 为什么默认不取「相对 cwd 的 data/mdcg」：
  *   node 侧插件与 python 侧脚本的 cwd 不同，相对路径会漂移成
  *   `<cwd>/data/mdcg`。历史事故：宿主 cwd 落在 AEIS 时，记忆真源
  *   分裂到 `AEIS/data/mdcg`，与插件仓 `data/` 变成互不可见的两处。
- *   锚定 `package.json` 所在目录后，默认值稳定且可预期。
+ *
+ * 旧数据接手：`migrateLegacyData()` 在默认数据根生效且旧包内位置仍有内容时
+ * 一次性**复制**（不删除、不覆盖）到用户级位置——见该函数注释。
  */
-import { existsSync, readFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
 import { delimiter, dirname, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const ENV_DATA_ROOT = 'MDCG_DATA_ROOT';
@@ -41,9 +53,52 @@ export function repoRoot() {
     cachedRepoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
     return cachedRepoRoot;
 }
-/** 用户可编辑的路径配置文件（固定在插件仓 data/，不受 dataRoot 取值影响）。 */
+export const ENV_STATE_ROOT = 'MDCG_STATE_ROOT';
+let cachedStateRoot = null;
+/**
+ * 用户级状态根（**插件包目录之外**）：路径配置与默认数据根的落点。
+ * 优先级：`MDCG_STATE_ROOT` → `$DSH_HOME/.dsh-memory` → `~/.dsh/.dsh-memory`。
+ * `DSH_HOME` **未必**由宿主注入（本仓 `dsh/dsh-web-start.bat` 自行 set），
+ * 故家目录兜底；`~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志同址）。
+ */
+export function stateRoot() {
+    if (cachedStateRoot)
+        return cachedStateRoot;
+    const env = process.env[ENV_STATE_ROOT];
+    if (env) {
+        cachedStateRoot = resolve(env);
+        return cachedStateRoot;
+    }
+    const dshHome = process.env['DSH_HOME'];
+    cachedStateRoot = dshHome
+        ? join(resolve(dshHome), '.dsh-memory')
+        : join(homedir(), '.dsh', '.dsh-memory');
+    return cachedStateRoot;
+}
+/** 旧版落点（插件包内 `data/`）——更新时会被整个替换，只作兼容读与迁移源。 */
+export function legacyDataRoot() {
+    return join(repoRoot(), 'data');
+}
+function samePath(a, b) {
+    return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
+/**
+ * 用户可编辑的路径配置文件：
+ *   `<用户级状态根>/paths.json` → 不存在则回落**旧** `<插件仓>/data/paths.json`
+ *   （兼容读）→ 都不存在返回新位置（首次写入时创建）。
+ * 不做自动复制：配置文件是「谁说了算」的唯一真源，悄悄复制会让旧件的后续编辑
+ * 静默失效——迁移只搬数据面，配置显式交给用户搬（或用 `set_user_root`）。
+ */
 export function pathsFile() {
-    return join(repoRoot(), 'data', 'paths.json');
+    const current = join(stateRoot(), 'paths.json');
+    if (existsSync(current))
+        return current;
+    const legacy = join(legacyDataRoot(), 'paths.json');
+    return existsSync(legacy) ? legacy : current;
+}
+/** 生效中的 paths.json 位置来源：`user`=用户级 / `legacy`=旧包内（兼容读）。 */
+export function pathsFileSource() {
+    return samePath(dirname(pathsFile()), stateRoot()) ? 'user' : 'legacy';
 }
 function readUserPaths() {
     try {
@@ -59,8 +114,133 @@ function readUserPaths() {
 function anchor(p) {
     return isAbsolute(p) ? p : resolve(repoRoot(), p);
 }
+/** 默认数据根 = 用户级状态根下 `data/`（**插件包目录之外**，更新不触碰）。 */
 export function defaultDataRoot() {
-    return join(repoRoot(), 'data');
+    return join(stateRoot(), 'data');
+}
+/** dst 为「空目录」时 true（不存在/非目录/有内容均为 false）。 */
+function isEmptyDir(p) {
+    try {
+        return readdirSync(p).length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 一次性迁移：把旧版留在**插件包内** `data/` 的数据面复制到用户级默认数据根。
+ *
+ * 触发条件（三条同时满足，缺一不动）：
+ *   ① 数据根未被显式配置（env `MDCG_DATA_ROOT` / paths.json 的 `data_root` 都未设，
+ *      即 `dataRoot()` 恰为默认值）——显式配置是用户的决定，越权搬运等于改他的真源；
+ *   ② 旧位置存在；
+ *   ③ 目标顶层条目不存在或为空目录（**不覆盖、不合并**已有数据）。
+ *
+ * 只复制不删除（旧目录随后由 pnpm 更新自然移除）；`paths.json` 不复制
+ * （配置走 `pathsFile()` 兼容读，复制会制造「哪个文件说了算」的两说）。
+ * 任何异常逐项吞掉并记入 `failed`——迁移是增益，不该成为启动失败源。
+ *
+ * 边界（如实）：pnpm 更新是**先替换包目录再启动新代码**，故旧数据在升级瞬间
+ * 即已消失，本函数只能接手「旧位置那时仍在」的情形（手工安装、就地覆盖、
+ * 或包目录未被清理）；已在升级中丢掉的数据无法由此恢复——发布说明须提示
+ * 0.4.8 及更早用户升级前备份 `<profile>/node_modules/<pkg>/data/`。
+ */
+export function migrateLegacyData() {
+    const from = legacyDataRoot();
+    const to = defaultDataRoot();
+    const out = { ran: false, reason: '', from, to, copied: 0, failed: [] };
+    if (!samePath(dataRoot(), to)) {
+        out.reason = '数据根为显式配置（env/paths.json），不迁移';
+        return out;
+    }
+    if (!existsSync(from)) {
+        out.reason = '旧位置不存在（多为更新时已随包目录被替换）';
+        return out;
+    }
+    let entries;
+    try {
+        entries = readdirSync(from);
+    }
+    catch {
+        out.reason = '旧位置不可读';
+        return out;
+    }
+    const names = entries.filter((n) => n !== 'paths.json');
+    if (!names.length) {
+        out.reason = '旧位置无数据';
+        return out;
+    }
+    for (const name of names) {
+        const src = join(from, name);
+        const dst = join(to, name);
+        // 新位置已有实质内容 → 跳过（宁可少搬，不可覆盖）
+        if (existsSync(dst) && !isEmptyDir(dst))
+            continue;
+        try {
+            mkdirSync(to, { recursive: true });
+            cpSync(src, dst, { recursive: true, force: false, errorOnExist: false });
+            out.copied += 1;
+        }
+        catch {
+            out.failed.push(name);
+        }
+    }
+    out.ran = out.copied > 0;
+    if (!out.ran)
+        out.reason = out.failed.length ? '目标不可写' : '新位置已有数据，未覆盖';
+    return out;
+}
+export const ENV_CHILD_CWD = 'MDCG_CHILD_CWD';
+let cachedRunRoot = null;
+/**
+ * 子进程的工作目录（**必须落在插件包目录之外**）。
+ *
+ * 为什么不能沿用 `repoRoot()`：Windows 不允许删除／改名「正被某进程当作 CWD」
+ * 的目录。DSH 的插件按 hoisted 布局安装在 `<profile>/node_modules/<pkg>`，
+ * 而 `pnpm` 每次更新该包都要先 `rmdir` 包目录 → 子进程一旦把包目录当 CWD，
+ * 更新必然 `ERR_PNPM_EBUSY: resource busy or locked`（含升级回滚一起失败，
+ * 应用内永远升不动这个插件）。注意落点也**不能**是 `<包>/data`——它仍在包内，
+ * 实测同样 `err=32`。
+ *
+ * 落点要求「稳定存在」：进程 cwd 指向已消失的目录会引出新的怪问题，故按稳定度
+ * 排候选目录，取**第一个能建成**的：
+ *   1. `MDCG_CHILD_CWD`（显式覆盖）
+ *   2. `$DSH_HOME/.dsh-memory/run`
+ *   3. `~/.dsh/.dsh-memory/run` —— 家目录兜底：`DSH_HOME` **未必**由宿主注入
+ *      （本仓 `dsh/dsh-web-start.bat` 是自行 `set DSH_HOME=%USERPROFILE%\.dsh`），
+ *      而 `~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志、`token_store` 密钥环同址）
+ *   4. 系统临时目录（可能被清理，故排最后）
+ * 全部建不成时不抛错，交给 spawn 报错——cwd 落点只是防呆，不该成为启动失败源。
+ *
+ * 安全性：`python -m` 的模块解析由 `pythonPathValue()` 的 PYTHONPATH 独立保证，
+ * 不依赖 cwd；已实测 cwd=包目录 与 cwd=包外 时，MCP initialize 握手与
+ * tools/list 工具面（33 个工具）完全一致。
+ */
+export function runRoot() {
+    if (cachedRunRoot)
+        return cachedRunRoot;
+    const candidates = [];
+    const override = process.env[ENV_CHILD_CWD];
+    if (override)
+        candidates.push(resolve(override));
+    const dshHome = process.env['DSH_HOME'];
+    if (dshHome)
+        candidates.push(join(resolve(dshHome), '.dsh-memory', 'run'));
+    candidates.push(join(homedir(), '.dsh', '.dsh-memory', 'run'));
+    candidates.push(join(tmpdir(), 'dsh-memory-run'));
+    for (const dir of candidates) {
+        try {
+            mkdirSync(dir, { recursive: true });
+            cachedRunRoot = dir;
+            return dir;
+        }
+        catch {
+            /* 该候选不可用（父目录只读等）→ 试下一个 */
+        }
+    }
+    const last = candidates[candidates.length - 1] ?? tmpdir();
+    cachedRunRoot = last;
+    return last;
 }
 /** 数据根（记忆/账本/运行态的父目录）。 */
 export function dataRoot() {
@@ -108,22 +288,28 @@ export function describeDataPaths(configured) {
     const dr = dataRoot();
     const mr = mdcgRoot(configured);
     const paths = readUserPaths();
-    let source = 'default(插件仓自身 data/)';
+    const pfSource = pathsFileSource();
+    let source = 'default(用户级状态根 data/)';
     if (process.env[ENV_DATA_ROOT])
         source = `env:${ENV_DATA_ROOT}`;
     else if (process.env[ENV_MDCG_ROOT])
         source = `env:${ENV_MDCG_ROOT}`;
-    else if (typeof paths['data_root'] === 'string' || typeof paths['root'] === 'string')
-        source = 'paths.json';
+    else if (typeof paths['data_root'] === 'string' || typeof paths['root'] === 'string') {
+        source = pfSource === 'user' ? 'paths.json(用户级)' : 'paths.json(兼容读旧包内位置)';
+    }
     else if (configured && configured.trim())
         source = 'config.mdcg.root';
     return {
         repoRoot: repoRoot(),
+        stateRoot: stateRoot(),
         dataRoot: dr,
         mdcgRoot: mr,
         source,
         pathsFile: pathsFile(),
-        isDefault: dr === defaultDataRoot(),
+        pathsFileSource: pfSource,
+        isDefault: samePath(dr, defaultDataRoot()),
+        legacyDataRoot: legacyDataRoot(),
+        legacyDataExists: existsSync(legacyDataRoot()),
         dataRootExists: existsSync(dr),
         mdcgRootExists: existsSync(mr),
     };

package/lib/lib/mdcg_client.d.ts

@@ -43,9 +43,12 @@ export interface MdcgOptions {
     args?: string[];
     /** 认知图根目录（MDCG_ROOT）。 */
     root: string;
-    /** Python 子进程工作目录，默认**插件仓根**（issue #12：Python 只把 cwd
-     *  注入 sys.path，宿主在插件仓外启动时 `python -m md_cg.mcp_server`
-     *  找不到随包 md_cg → 必然 ModuleNotFoundError → 静默降级只读 guest）。 */
+    /** Python 子进程工作目录，默认 `runRoot()`——**插件包目录之外**的稳定目录
+     *  （issue #18：Windows 不允许删除/改名「正被某进程当作 cwd」的目录，
+     *  cwd 落在包内会让 pnpm 更新本包必然 `ERR_PNPM_EBUSY` 且永不自愈）。
+     *  模块解析**不依赖 cwd**：`python -m` 靠 `PYTHONPATH`
+     *  （见 `pythonPathValue()`）解析随包 md_cg，issue #12 口径不变。
+     *  显式传入本项时完全尊重原值。 */
     cwd?: string;
     /** 调用主体标识（MDCG_ACTOR）。私有内容按 (tenant, actor) 派生 DEK，
      *  故与迁移脚本 --actor 必须一致，否则读不到已迁移节点。 */

package/lib/lib/mdcg_client.js

@@ -35,7 +35,7 @@
  *   的**所有写入**（记忆沉淀 / 角色定义 / 对话转录）统一经 `mdcg_remember`。
  */
 import { LingshuBridge } from '../bridge.js';
-import { pythonPathValue, repoRoot } from './datapath.js';
+import { pythonPathValue, runRoot } from './datapath.js';
 const DEFAULT_ARGS = ['-m', 'md_cg.mcp_server'];
 /** 认知图依据强度：这些 basis 视为「强依据」，可支撑 pass。
  *  取值须在 md_cg.mdcg.VERIFICATION_BASIS 允许集内：
@@ -63,10 +63,11 @@ function collectItems(payload) {
 export class MdcgClient {
     bridge;
     constructor(opts) {
-        // issue #12：cwd 与 PYTHONPATH 双保险锚定插件仓根——cwd 是 `python -m`
-        // 解析随包包的主通道，PYTHONPATH 覆盖显式自定义 args 的场景。opts.env
-        // 显式提供 PYTHONPATH 时完全接管（其展开在最后：显式配置原样尊重）。
-        const cwd = opts.cwd ?? repoRoot();
+        // 子进程 cwd 必须落在插件包目录之外，否则 pnpm 更新本插件时
+        // rmdir 包目录会撞上 Windows 的「目录被当作 CWD」共享冲突 → ERR_PNPM_EBUSY。
+        // 模块解析不依赖 cwd：PYTHONPATH（pythonPathValue()）已锚定随包 md_cg；
+        // opts.env 显式提供 PYTHONPATH 时完全接管（其展开在最后）。详见 datapath.runRoot()。
+        const cwd = opts.cwd ?? runRoot();
         const env = {
             // ⚠️ 必须显式 utf-8：Windows 下 piped 子进程默认 gbk + surrogateescape，
             // Node 写出的 UTF-8 中文会被解成孤立代理字符（\udcXX），md_cg 在落盘 /

package/lib/lib/mutual.js

@@ -15,7 +15,7 @@ import { exec, spawn } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
-import { pythonPathValue, repoRoot } from './datapath.js';
+import { pythonPathValue, runRoot } from './datapath.js';
 const DEFAULTS = {
     heartbeatMs: 10 * 60 * 1000,
     warnMs: 25 * 60 * 1000,
@@ -120,9 +120,9 @@ export async function ensureHarness(python = 'python', opts = DEFAULTS) {
                 windowsHide: true,
                 detached: true,
                 stdio: 'ignore',
-                // issue #12 同类：锚定插件仓根 + PYTHONPATH，与 mdcg_client / token_store
-                // 同口径——不随宿主 cwd 漂移；harness 包不在仓内时注入不劣化（回落用户环境）。
-                cwd: repoRoot(),
+                // 同 mdcg_client：cwd 必须在包外（否则 pnpm 更新时 rmdir 包目录被 Windows
+                // 拒绝 → ERR_PNPM_EBUSY）；模块解析由 PYTHONPATH 保证，见 datapath.runRoot()。
+                cwd: runRoot(),
                 env: { ...process.env, PYTHONPATH: pythonPathValue() },
             });
         }

package/lib/lib/prompt_safety.d.ts

@@ -0,0 +1,48 @@
+/**
+ * prompt_safety.ts · 注入边界文本安全（宿主严格模板的转义）
+ *
+ * ── 根因（issue #16，2026-09-16）────────────────────────────────────────
+ * dsh 宿主 `@deepseek-ai/dsh-system-prompt` 的 `interpolate()` 会对**每个
+ * section / context** 文本做严格 `{{variable}}` 插值，且**四类一律 throw**：
+ *   ① `{{` 之后能找到 `}}` 但不成简单组（GROUP_AT = /^\{\{([^{}]*)\}\}/ 不匹配）
+ *   ② 组成立但名不匹配 /^[a-z][a-z0-9_]*$/（如 `{{.Architecture}}`）
+ *   ③ 名合法但未注册（如 `{{name}}`）
+ *   ④ 已注册但值为 undefined
+ * `renderContextSections()` 逐 context 调用它，throw 直接冒泡到
+ * `system-prompt/assemble` → **该轮请求整体失败**。
+ *
+ * ── 伤害路径 ───────────────────────────────────────────────────────────
+ * 自动记忆把用户命令原样沉淀（如 `docker inspect --format '{{.Architecture}}'`）
+ * → auto-recall 把含裸 `{{` 的预览推入 `assembly.contexts`
+ * → 宿主每轮 assemble 必抛 → **会话永久不可用**（记忆永久在库，非偶发故障）。
+ *
+ * ── 处置：为何只在注入边界转义，不在写入侧 ────────────────────────────
+ *   ① 记忆真源必须保真：`{{.Architecture}}` 是用户命令原文，写入侧转义会
+ *      不可逆失真，且 cg(op=read) / 工具面 / 检索都依赖原文（= 污染真源）；
+ *   ② 伤害面就是「注入到 prompt 的文本」，在注入边界处理即**最小充分**；
+ *   ③ 与写入侧 desensitize 不冲突：脱敏是**隐私**要求（不许落盘），
+ *      转义是**渲染安全**要求（落盘保真、渲染时规避）——层次不同。
+ *
+ * ── 转义策略：确保文本中不出现连续两个 `{` ────────────────────────────
+ * 依据（宿主源码 `lib/index.js:109-116`）：`interpolate` 以
+ * `text.indexOf("{{")` 为**唯一扫描锚点**；破坏 `{{` 序列后循环不进入，
+ * 文本走 `text.slice(last)` 原样返回。
+ *   · `}}` 无需处理——它只在 `{{` 成组时参与解析，锚点已破即无意义；
+ *   · 逐对打断（而非 `split('{{').join(...)`）：后者对 `{{{a}}}` 会产出
+ *     `{ {{a}}}`——新锚点仍在（相邻 `{` 重新合成），不幂等也不安全；
+ *   · 跨 context 拼接安全：`joinContextSections` 以 `"\n\n"` 分隔并带固定
+ *     前缀（`lib/index.js:85-87`，前缀以 `.` 结尾），边界不会合成新 `{{`；
+ *   · 为何不用零宽字符：显示上「看起来一样」但复制会带入不可见字符
+ *     （终端粘贴即出错）——诚实性优先，宁可让改写可见。
+ *
+ * 幂等：结果中不存在 `{{`，重复调用结果不变。
+ * 边界：本函数只服务**注入到宿主 prompt 的文本**；记忆真源与工具返回原文
+ *       一律不动（工具结果不进 assembly 插值面）。
+ */
+/**
+ * 把文本中每一对相邻的 `{` 打断（插入半角空格），使其不再包含 `{{`。
+ *
+ * 不含 `{{` 的文本**原样返回**（零改写，保真）。
+ * 例：`{{.Architecture}}` → `{ {.Architecture}}`；`{{{a}}}` → `{ { {a}}}`。
+ */
+export declare function escapePromptBraces(text: string): string;

package/lib/lib/prompt_safety.js

@@ -0,0 +1,62 @@
+/**
+ * prompt_safety.ts · 注入边界文本安全（宿主严格模板的转义）
+ *
+ * ── 根因（issue #16，2026-09-16）────────────────────────────────────────
+ * dsh 宿主 `@deepseek-ai/dsh-system-prompt` 的 `interpolate()` 会对**每个
+ * section / context** 文本做严格 `{{variable}}` 插值，且**四类一律 throw**：
+ *   ① `{{` 之后能找到 `}}` 但不成简单组（GROUP_AT = /^\{\{([^{}]*)\}\}/ 不匹配）
+ *   ② 组成立但名不匹配 /^[a-z][a-z0-9_]*$/（如 `{{.Architecture}}`）
+ *   ③ 名合法但未注册（如 `{{name}}`）
+ *   ④ 已注册但值为 undefined
+ * `renderContextSections()` 逐 context 调用它，throw 直接冒泡到
+ * `system-prompt/assemble` → **该轮请求整体失败**。
+ *
+ * ── 伤害路径 ───────────────────────────────────────────────────────────
+ * 自动记忆把用户命令原样沉淀（如 `docker inspect --format '{{.Architecture}}'`）
+ * → auto-recall 把含裸 `{{` 的预览推入 `assembly.contexts`
+ * → 宿主每轮 assemble 必抛 → **会话永久不可用**（记忆永久在库，非偶发故障）。
+ *
+ * ── 处置：为何只在注入边界转义，不在写入侧 ────────────────────────────
+ *   ① 记忆真源必须保真：`{{.Architecture}}` 是用户命令原文，写入侧转义会
+ *      不可逆失真，且 cg(op=read) / 工具面 / 检索都依赖原文（= 污染真源）；
+ *   ② 伤害面就是「注入到 prompt 的文本」，在注入边界处理即**最小充分**；
+ *   ③ 与写入侧 desensitize 不冲突：脱敏是**隐私**要求（不许落盘），
+ *      转义是**渲染安全**要求（落盘保真、渲染时规避）——层次不同。
+ *
+ * ── 转义策略：确保文本中不出现连续两个 `{` ────────────────────────────
+ * 依据（宿主源码 `lib/index.js:109-116`）：`interpolate` 以
+ * `text.indexOf("{{")` 为**唯一扫描锚点**；破坏 `{{` 序列后循环不进入，
+ * 文本走 `text.slice(last)` 原样返回。
+ *   · `}}` 无需处理——它只在 `{{` 成组时参与解析，锚点已破即无意义；
+ *   · 逐对打断（而非 `split('{{').join(...)`）：后者对 `{{{a}}}` 会产出
+ *     `{ {{a}}}`——新锚点仍在（相邻 `{` 重新合成），不幂等也不安全；
+ *   · 跨 context 拼接安全：`joinContextSections` 以 `"\n\n"` 分隔并带固定
+ *     前缀（`lib/index.js:85-87`，前缀以 `.` 结尾），边界不会合成新 `{{`；
+ *   · 为何不用零宽字符：显示上「看起来一样」但复制会带入不可见字符
+ *     （终端粘贴即出错）——诚实性优先，宁可让改写可见。
+ *
+ * 幂等：结果中不存在 `{{`，重复调用结果不变。
+ * 边界：本函数只服务**注入到宿主 prompt 的文本**；记忆真源与工具返回原文
+ *       一律不动（工具结果不进 assembly 插值面）。
+ */
+/** 宿主严格模板的扫描锚点。 */
+const TEMPLATE_OPEN = '{{';
+/**
+ * 把文本中每一对相邻的 `{` 打断（插入半角空格），使其不再包含 `{{`。
+ *
+ * 不含 `{{` 的文本**原样返回**（零改写，保真）。
+ * 例：`{{.Architecture}}` → `{ {.Architecture}}`；`{{{a}}}` → `{ { {a}}}`。
+ */
+export function escapePromptBraces(text) {
+    if (!text.includes(TEMPLATE_OPEN))
+        return text;
+    let out = '';
+    for (let i = 0; i < text.length; i++) {
+        const ch = text.charAt(i);
+        out += ch;
+        // 该 `{` 与下一个字符构成锚点 → 立即插入空格打断
+        if (ch === '{' && text.charAt(i + 1) === '{')
+            out += ' ';
+    }
+    return out;
+}

package/lib/lib/token_store.js

@@ -30,7 +30,7 @@ import { spawnSync } from 'node:child_process';
 import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
-import { pythonPathValue, repoRoot } from './datapath.js';
+import { pythonPathValue, runRoot } from './datapath.js';
 /** 默认密钥环路径：与 md_cg 的 `~/.mdcg/` 约定同目录（`_tokens.json` 亦在此）。 */
 export function defaultKeyringPath() {
     return join(homedir(), '.mdcg', 'token');
@@ -66,10 +66,9 @@ function issueToken(python, role, actor, clearance) {
             windowsHide: true,
             timeout: 15_000,
             // 与工作纪律第 15 条同源：显式 UTF-8 + PYTHONUTF8，规避 Windows GBK 解码异常。
-            // issue #12：cwd+PYTHONPATH 锚定插件仓根——否则 npm 包形态下宿主在仓外
-            // 启动时 `python -m md_cg.tokens` 找不到随包 md_cg，首启签发静默失败，
-            // md_cg 侧降级只读 guest（写入全不落盘且无报错）。
-            cwd: repoRoot(),
+            // 模块解析靠 PYTHONPATH 锚定随包 md_cg（不依赖 cwd）；cwd 取包外目录，
+            // 否则 pnpm 更新本插件时 rmdir 包目录必报 ERR_PNPM_EBUSY。见 datapath.runRoot()。
+            cwd: runRoot(),
             env: {
                 ...process.env,
                 PYTHONPATH: pythonPathValue(),