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，关键项应全是 ✓（记忆捕获、安全基线、子代理守卫默认关闭，显示 ✗ 是正常的，不是故障）。

工具一览

常用配置（简单版）

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

完整键值看 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。

常见问题（简洁版）

这插件不做什么

• 不压缩已在上下文里的内容（只在入口引导）。
• 不声称省了 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 已就绪，发布路线待定）。