dsh-bingxing
让同一步里的多个 grep / glob 真正并行，而不改它们的实现。
面向 DeepSeek Harness Desktop 的纯 Host 文件系统插件。
简体中文 · English
插件 0.1.2 · 纯 Host / ESM · 无 Client、无 UI
核心能力 · 工作方式 · 快速开始 · 配置 · 验证 · 常见问题
现网 grep 和 glob 没有声明 isConcurrencySafe，同一步多个调用会被排成独占。read、web_search 等已经声明。这个插件只给已注册的原定义对象补上并发声明，让 AGENTS.md 里「多个只读调用放进同一步」对搜索工具也生效。
不重写 grep/glob，不自写顺序控制，不改 DSH 核心。超限 spill（grep-results.txt / glob-results.txt）仍由原 tools/post-execute 按对象身份写出。bash、edit、write 一律不声明。
核心能力
| 能力 | 具体行为 |
|---|---|
| 原对象补声明 | ctx.tools.get("grep") / get("glob") 拿到的就是注册时的定义；只设置 isConcurrencySafe = () => true |
| 调度器生效 | 分类发生在 tools/execute 之前；精确 true 才 parallel |
| 保持 spill | 不换对象，避免 post-execute 因身份变化跳过超限结果文件 |
| 写工具仍独占 | edit / bash 不声明；grep、edit、grep 在 edit 处断开 |
| 可卸载 | 去掉 desktop patch 中本插件那一条 insert，⌘Q 后恢复现网串行 |
工作方式
- 加载：Desktop 用户 patch 在内置 bundle 之后插入本插件。
- 定位原定义：先全局
get；grep/glob 若在 preset 作用域，则在已有 agent 和agent/created上按 agent 可见对象补声明。同一对象只补一次。 - 调度：agent-loop 读
executionMode；同一步多个并行安全调用可以重叠，且不超过maxParallelToolCalls（默认 10）。 - 屏障：遇到未声明的工具就停止开新调用、排空后再把独占当下一组。
- 卸载：注释或删除本插件 insert，不动其他插件；完全退出后重开。
插件 dispose 时会删掉自己加上的属性。仅热卸载不够替代 ⌘Q。
快速开始
1. 前置条件
- 已安装并可运行 DeepSeek Harness Desktop。
- 已验证环境：macOS、Desktop
0.2.1-alpha.4.20261020.1。这是具体本机安装构建，不是所有同名/其他版本的兼容承诺。 - Git 用于下载；运行源码不需要新的 npm 依赖。Windows、Linux 及其他 SDK 构建尚未验证。
2. 下载插件
目标目录应尚不存在；已有安装不要覆盖。
DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
git clone https://github.com/yueyexiayu/dsh-bingxing.git "$DSH_HOME/plugins/dsh-bingxing"
3. 配置 Desktop 加载
将下面一项合并到现有 $DSH_HOME/profiles/desktop/cordis.patch.yml，不要覆盖其他插件配置。路径相对于这份 profile patch 文件。
- insert:
- id: dsh-bingxing
name: ../../plugins/dsh-bingxing/lib/index.js
仓库内的 bundle patch 是包内相对路径，不能直接当作 profile 相对路径使用。无需改 DSH 官方源码，也不要用 CLI 插件管理器向 Desktop profile 安装依赖。
4. 启动与确认
完整退出 Desktop（macOS：⌘Q）后重新打开。同一步发出多个 grep 或 glob 时，会话里应看到多个 tool/call 先集中出现，而不是 call→result 严格交替。卸载后应恢复交替串行。
配置
本插件没有配置文件，也没有自定义 HTTP 路由。只注入 tools 和 agents。
进阶：作用域与共存
grep/glob 由 @deepseek-ai/dsh-tool-fs-search 在 agent preset 作用域注册。全局 tools.get("grep") 可能看不到它们；插件会在 agent/created 上补同一原对象。
单调用超时仍由官方 dsh-tool-call-timeout-policy 做成 per-call deadline，不中止整步。
验证
在已验证的 Desktop 0.2.1-alpha.4.20261020.1 上：
ELECTRON_RUN_AS_NODE=1跑test/*.test.mjs：6 项通过（声明、原对象身份、同名 register 失败、无插件串行、有插件重叠、edit/bash 独占、超限 spill、失败隔离、dispose 恢复）。- Desktop 三次 ⌘Q：挂载后并行、卸载后串行、恢复挂载后再次并行。一次真实任务中，同一步 6 个 grep/glob 的
tool/call跨度 2–3ms，工具池约 34ms。
未在 Windows/Linux 或其他 Desktop 版本上验证。没有 GitHub Actions；不要把上述本机结果当成实时 CI。
cd "$DSH_HOME/plugins/dsh-bingxing"
/usr/local/bin/node --check lib/index.js
ELECTRON_RUN_AS_NODE=1 "/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness" --test test/*.test.mjs
常见问题
为什么不能重新 register 一个 grep？
全局 tools.register 禁止同名。新对象还会让原 post-execute 因身份检查跳过 spill。
为什么不把 bash 也标成并行安全？
bash 可能写文件。本插件只声明 grep 和 glob。
如何卸载？
只注释或删除 desktop cordis.patch.yml 里 id: dsh-bingxing 那一条 insert，然后 ⌘Q。不要清空整个 patch，也不要删掉其他条目。
社区与许可
公开仓库 Topic 为 dsh-plugin。官方 DSH 不会自动抓仓库；社区目录按该 Topic 扫描，进全量目录还需对方核实。本仓库未附带许可证文件。
只改声明，不换实现 · Read in English →
