dsh-context-mode

这是给 DeepSeek Harness（DSH）的一个小插件。核心只有一句话：让进上下文的原始数据越少越好。

它不做花哨的事，只干三件实在的：把大文件和网页索引进本地知识库、把会把窗口撑爆的洪水工具拦下来改道、把数据处理丢进沙箱只带回答案。

---

它到底做什么？

1. 知识库：索引 + 检索

• ctx_index：把文件或整个目录切成小块，存进本地 SQLite 知识库（FTS5，支持中文模糊和英文词根）。
• ctx_search：只返回命中的小片段，不是整本书。默认每次最多回 12000 字节。
• ctx_fetch_and_index：抓网页转成 markdown 后同样入库，原网页字节不进上下文。
• ctx_purge：清空知识库（不可逆，想清楚再用）。

2. 路由拦截：洪水别进来

挂在工具执行前，直接挡掉或引导：

• 硬拦：curl、wget、inline-fetch 这类确定会拉大文件进上下文的命令，直接拒绝。
• 软引导：文件超过约 50KB 且不是精确分段读（没有 offset/limit），拒绝并告诉你该用 ctx_index 或 ctx_search。
• 白名单：pwd、echo、ls、whoami 这些无害命令，零摩擦放行。

3. 沙箱执行：只带答案回来

• ctx_execute：写一段代码在隔离沙箱里跑，只把 console.log 的结论带回来。原始数据留在沙箱，不进上下文。
• ctx_execute_file：把一个文件的内容当作输入数据（FILE_SRC），跑分析、统计、过滤，只返回结论。
• ctx_batch_execute：并行跑多段分析，结果自动入库，同一轮还能直接检索。

沙箱规则简单记住：代码里不能写 require("node:fs") 或 import（沙箱没有模块系统）；FILE_SRC 已经是文件完整内容，直接处理，不要再去读文件路径。

---

安装（一步到位）

cd "$HOME/.dsh/plugins/dsh-context-mode"
git clone https://github.com/pharaohnie/dsh-context-mode.git .  # 如果还没克隆
dsh plugin --profile web add "$HOME/.dsh/plugins/dsh-context-mode"
./relink-dsh-context-mode.sh

然后重启 DSH（UI 点重启，或重启服务进程）。

验证：跑 ctx_doctor，关键项应全是 ✓（记忆捕获、安全基线、子代理守卫默认关闭，显示 ✗ 是正常的，不是故障）。

---

工具一览

工具	一句话作用
ctx_index	文件/目录 → 知识库
ctx_search	检索，只回片段
ctx_fetch_and_index	抓网页 → 知识库
ctx_purge	清空知识库
ctx_execute	沙箱跑代码，带答案回来
ctx_execute_file	文件内容做数据分析
ctx_batch_execute	并行分析 + 同轮检索
ctx_doctor	自检状态
ctx_stats	看节省了多少上下文字节

---

常用配置（简单版）

大部分开关可用 CONTEXT_MODE_* 环境变量覆盖。几个常用的：

开关	默认	说明
routingEnabled	true	总开关
maxReadBytesBeforeAsk	51200	文件超过这个大小会被引导用检索
executeAllowShell	true	沙箱里允许用 shell 语言
memoryCapture	false	会话记忆捕获（隐私考虑默认关）
securityEnabled	false	安全基线（默认关，避免打扰）

完整键值看 src/config.ts，每个都有注释。

---

快速验证

1. 安装后重启 DSH。
2. 运行 ctx_doctor：关键项（tools、systemPrompt、FTS5、知识库、门禁）应为 ✓。
3. 运行 node scripts/smoke.ts：纯逻辑回归，不需要 DSH 运行时，直接跑。
4. 检查 curl http://127.0.0.1:3080/dsh-market/installed，dsh-context-mode 应显示 live True。

---

常见问题（简洁版）

现象	原因	修复
not installed	插件目录的 node_modules 链接坏了	重新执行 dsh plugin --profile web add
duplicate loader entry	同时在 bundles 和 cordis.patch.yml 注册了插件	保留 bundles 登记，删除 cordis.patch.yml 里的手动 insert 行
ERR_MODULE_NOT_FOUND	node_modules 指向了旧的 DSH npx 缓存	跑 ./relink-dsh-context-mode.sh

---

这插件不做什么

• 不压缩已在上下文里的内容（只在入口引导）。
• 不声称省了 98% 字节（ctx_stats 把两个口径并列：精确测量 + 估算下界，不混着报）。
• 不是数据沙箱（沙箱是资源隔离，不承诺程序绝对读不到宿主文件）。

---

运行要求

• Node ≥ 24（node:sqlite 自带 FTS5，直接加载 .ts，不需要预构建）。
• DSH v0.1.1-rc.2（或兼容版本）。
• 知识库默认在 ~/.context-mode/content，多进程共享时用 WAL 模式防写锁。

---

许可证

MIT。源码即入口：package.json 的 main 指向 src/index.ts，无构建产物（dist/ 已移除）。发布到 npm 前需要预构建并切换入口（pnpm run build 已就绪，发布路线待定）。