@furongjun1999/dsh-memory 0.4.11 → 0.5.0

package/src/lib/prompt_safety.ts

@@ -1,62 +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: string): string {
-  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
-}
+/**
+ * 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: string): string {
+  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/src/lib/python_path.ts

@@ -1,71 +1,71 @@
-/**
- * python_path.ts —— Python 解释器的**平台感知**解析（issue #19）
- *
- * 要解决的问题（首次安装即失效，且不自愈）
- * ------------------------------------------------
- * 解释器默认值此前是**字面量 `'python'`**。Linux/macOS 按 PEP 394 只要求提供
- * `python3`——发行版默认状态就是这样，不是用户把环境装坏了。于是 `spawn('python')`
- * 抛 `ENOENT`，桥重试 8 次后进入 failed 终态：插件看起来装好了，工具不注册、
- * 记忆只读（`guest`）、必须重启 DSH 才会再试一次。同时日志被
- * `灵枢调用超时（60000ms）：initialize` 刷屏，把人引向「超时/性能」的错误方向，
- * 而第一因是更早一行不起眼的 `spawn … ENOENT`。
- * Windows 上 `python` 通常存在，所以该缺陷只在作者机器之外暴露。
- *
- * 解析顺序（高 → 低）
- * ------------------------------------------------
- *   ① `config.python` —— 用户显式配置，**原样尊重**（本模块不介入）
- *   ② env `MDCG_PYTHON` —— 容器 / CI 固定解释器；命名风格与既有
- *      `MDCG_ROOT` / `MDCG_CHILD_CWD` 一致
- *   ③ 平台默认：`win32` → `python`（**逐字节保持既有行为**）；其它 → `python3`
- *
- * 边界（诚实声明，勿据此扩大承诺）
- * ------------------------------------------------
- * - **不做** PATH 扫描式候选回退（`python3` → `python3.12` → `python` 取首个存在）：
- *   隐式行为在跨平台/多环境（conda、pyenv、WSL）下难以预测，且失败模式从
- *   「明确 ENOENT」退化为「悄悄选了另一个解释器」。解释器名特殊时请显式配置
- *   或设 `MDCG_PYTHON`。
- * - md_cg 侧**不挑** Python 版本：只要存在解释器即可（issue 复现方实测 conda 的
- *   `python3.12` 亦正常握手）。
- * - 本模块只**解析名字**，不校验可执行文件是否真的存在（校验属调用方职责，
- *   且 `stat` 结果会被 PATH/沙箱差异推翻）。
- */
-
-/** 解释器覆盖的环境变量名（与 MDCG_ROOT 等同风格，便于容器固定）。 */
-export const PYTHON_ENV_VAR = 'MDCG_PYTHON'
-
-/**
- * 解析默认 Python 解释器（issue #19）。
- *
- * 参数刻意做成**可注入**（platform / env）而非直接读全局：默认值此前写死导致的
- * 正是「不可测 → 只在作者机器上成立」，注入后回归测试可在任意平台断言三分支。
- */
-export function defaultPython(
-  platform: string = process.platform,
-  env: Readonly<Record<string, string | undefined>> = process.env,
-): string {
-  const explicit = (env[PYTHON_ENV_VAR] ?? '').trim()
-  if (explicit) return explicit
-  return platform === 'win32' ? 'python' : 'python3'
-}
-
-/** 自检命令文案（按平台给出**可照抄**的写法，issue #19 影响面第 4 条）。 */
-export function selfCheckCommand(python: string = defaultPython()): string {
-  return `${python} -m md_cg.mcp_server`
-}
-
-/**
- * spawn 失败（ENOENT）时的修复指引。
- *
- * 为什么值得单列一条日志：该缺陷的原始日志把「解释器名不匹配」伪装成
- * 「调用超时」，用户按超时方向排查只会浪费一轮；把成因与三条修法写在
- * **同一行**，可诊断性直接闭环。
- */
-export function explainMissingPython(python: string): string {
-  return `解释器「${python}」不可执行（ENOENT）。Linux/macOS 发行版按 PEP 394 只提供 `
-    + 'python3（这是默认状态，不是环境损坏）。修法（任一）：'
-    + "① cordis.yml 的 config.python 设为 'python3'（优先级最高）；"
-    + '② 设环境变量 MDCG_PYTHON=python3（容器/CI 推荐）；'
-    + '③ 确认 python3 在 PATH 中（which python3）。改完需重启 DSH。'
-}
-
-export default { defaultPython, selfCheckCommand, explainMissingPython, PYTHON_ENV_VAR }
+/**
+ * python_path.ts —— Python 解释器的**平台感知**解析（issue #19）
+ *
+ * 要解决的问题（首次安装即失效，且不自愈）
+ * ------------------------------------------------
+ * 解释器默认值此前是**字面量 `'python'`**。Linux/macOS 按 PEP 394 只要求提供
+ * `python3`——发行版默认状态就是这样，不是用户把环境装坏了。于是 `spawn('python')`
+ * 抛 `ENOENT`，桥重试 8 次后进入 failed 终态：插件看起来装好了，工具不注册、
+ * 记忆只读（`guest`）、必须重启 DSH 才会再试一次。同时日志被
+ * `灵枢调用超时（60000ms）：initialize` 刷屏，把人引向「超时/性能」的错误方向，
+ * 而第一因是更早一行不起眼的 `spawn … ENOENT`。
+ * Windows 上 `python` 通常存在，所以该缺陷只在作者机器之外暴露。
+ *
+ * 解析顺序（高 → 低）
+ * ------------------------------------------------
+ *   ① `config.python` —— 用户显式配置，**原样尊重**（本模块不介入）
+ *   ② env `MDCG_PYTHON` —— 容器 / CI 固定解释器；命名风格与既有
+ *      `MDCG_ROOT` / `MDCG_CHILD_CWD` 一致
+ *   ③ 平台默认：`win32` → `python`（**逐字节保持既有行为**）；其它 → `python3`
+ *
+ * 边界（诚实声明，勿据此扩大承诺）
+ * ------------------------------------------------
+ * - **不做** PATH 扫描式候选回退（`python3` → `python3.12` → `python` 取首个存在）：
+ *   隐式行为在跨平台/多环境（conda、pyenv、WSL）下难以预测，且失败模式从
+ *   「明确 ENOENT」退化为「悄悄选了另一个解释器」。解释器名特殊时请显式配置
+ *   或设 `MDCG_PYTHON`。
+ * - md_cg 侧**不挑** Python 版本：只要存在解释器即可（issue 复现方实测 conda 的
+ *   `python3.12` 亦正常握手）。
+ * - 本模块只**解析名字**，不校验可执行文件是否真的存在（校验属调用方职责，
+ *   且 `stat` 结果会被 PATH/沙箱差异推翻）。
+ */
+
+/** 解释器覆盖的环境变量名（与 MDCG_ROOT 等同风格，便于容器固定）。 */
+export const PYTHON_ENV_VAR = 'MDCG_PYTHON'
+
+/**
+ * 解析默认 Python 解释器（issue #19）。
+ *
+ * 参数刻意做成**可注入**（platform / env）而非直接读全局：默认值此前写死导致的
+ * 正是「不可测 → 只在作者机器上成立」，注入后回归测试可在任意平台断言三分支。
+ */
+export function defaultPython(
+  platform: string = process.platform,
+  env: Readonly<Record<string, string | undefined>> = process.env,
+): string {
+  const explicit = (env[PYTHON_ENV_VAR] ?? '').trim()
+  if (explicit) return explicit
+  return platform === 'win32' ? 'python' : 'python3'
+}
+
+/** 自检命令文案（按平台给出**可照抄**的写法，issue #19 影响面第 4 条）。 */
+export function selfCheckCommand(python: string = defaultPython()): string {
+  return `${python} -m md_cg.mcp_server`
+}
+
+/**
+ * spawn 失败（ENOENT）时的修复指引。
+ *
+ * 为什么值得单列一条日志：该缺陷的原始日志把「解释器名不匹配」伪装成
+ * 「调用超时」，用户按超时方向排查只会浪费一轮；把成因与三条修法写在
+ * **同一行**，可诊断性直接闭环。
+ */
+export function explainMissingPython(python: string): string {
+  return `解释器「${python}」不可执行（ENOENT）。Linux/macOS 发行版按 PEP 394 只提供 `
+    + 'python3（这是默认状态，不是环境损坏）。修法（任一）：'
+    + "① cordis.yml 的 config.python 设为 'python3'（优先级最高）；"
+    + '② 设环境变量 MDCG_PYTHON=python3（容器/CI 推荐）；'
+    + '③ 确认 python3 在 PATH 中（which python3）。改完需重启 DSH。'
+}
+
+export default { defaultPython, selfCheckCommand, explainMissingPython, PYTHON_ENV_VAR }