MIT 的 DSH 插件：把官方工具面换成持久 bash、结构化 read、原子 write 与多格式 edit，另带可选 AST 工具与两个预设。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-12
许可证
MIT
01它能帮你完成什么？
让 DSH Agent 有一个带状态的 shell 和精确的文件读取，而不是一次一条命令
持久的 bash：`cd`、`export` 跨调用保持状态，冗长日志自动压缩，超长输出只留头尾、完整内容落盘，长命令自动转后台
大部分时间都在 shell 和文件工具里打转的 DSH 用户
用原子写入、多种补丁格式和回传 diff 来改文件
返回 diff 的原子 `write`，支持 replace / patch / hashline / apply-patch 的 `edit`，多段编辑、唯一性校验与空白差异模糊匹配
希望在大文件和归档上少失败几次的用户
在官方 standard 与 PTC 预设之外，装上 Tool Plus 预设
两条 `@deepseek-ai/dsh-agent-preset` 声明随插件提供，装完即可在预设列表里选；设置页「Tool Plus → 预设」可做最小更新、对齐模板、恢复随包与查看差异
需要统一某个 DSH profile 暴露哪些工具的团队
02如何接入 DeepSeek Harness？
前置条件
- 全局安装 `dsh` CLI（`npm i -g @deepseek-ai/dsh`），Node.js ≥ 24.9
- pnpm ≥ 10.4，因为 `--allow-build` 要放行本包与 `koffi` 的安装脚本
- Windows 上需要 Git Bash 作为 bash 执行环境
- 面向 DeepSeek Harness `dsh` v0.2.2-rc.1——README 标注它是 pre-release，接口可能变动
安装步骤
- 01
Web profile：`dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`
$ dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
- 02
桌面端：profile 由桌面应用独占，先 `cd ~/.dsh/profiles/desktop`，再执行 `pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`
- 03
pnpm 版本太低用不了 `--allow-build` 时，往该 profile 的 `pnpm-workspace.yaml` 加两个 `allowBuilds:` 条目，或在 profile 目录里执行 `pnpm approve-builds --all`，再重跑安装命令
验证接入成功
作者未说明
03DSH 适配与能力边界
DSH 插件（基于 Oh My Pi 内核移植）：安装后接管官方 bash / pwsh / 文件 / 搜索工具，另带可选的 `ast_grep` / `ast_edit` 与两个随补丁层声明的 agent 预设
持久 bash 与安全删除
Agent 发来的 shell 命令→跨调用保持状态、压缩日志、只留头尾并把完整输出落盘、长命令自动转后台，`rm` 把文件移入系统回收站
各平台回收站落点不同：网络盘没有回收站，macOS 需要 10.12+，部分 Linux 桌面环境看不到条目结构化 `read`
一个路径，可带 `:N-M`、`:raw` 或多区间→按行区间读取、大代码文件返回结构摘要、直接读 zip/tar、SQLite、notebook、PDF、图片直读并自动缩放，网页抓取时可用本机浏览器渲染 SPA
抓取 JS 渲染的页面时可能启动本机浏览器原子 `write` 与多格式 `edit`
文件内容或一条编辑指令→返回 diff 的原子写入、可直接写归档成员与 SQLite 的补丁式写入，以及 replace / patch / hashline / apply-patch 四种编辑格式
多段编辑会做唯一性校验与空白差异模糊匹配grep / glob 与可选 AST 工具
一个模式或文件名 glob→全文搜索与文件名匹配，支持 mtime 排序、上下文行与可配置忽略规则；可选 `ast_grep` / `ast_edit` 做语法树搜索与重写
`ast_grep` / `ast_edit` 默认关闭，需要在设置里开启预设管理
设置页的「Tool Plus → 预设」→最小更新、对齐模板、恢复随包声明，或先看差异再动手
写入走宿主自己的 `ctx.configEditor`，因此自带 profile 锁、并发保护、原子写与失败回滚
04适合谁？何时不该用？
适合
- 大部分时间都在 shell 和文件工具里打转的 DSH 用户
- 希望在大文件和归档上少失败几次的用户
- 需要统一某个 DSH profile 暴露哪些工具的团队
不适合
- README 建议在 `danger-full-access` 下使用，因为沙箱模式可能误拦文件写入。
- 在 Linux 上跑 SWE-bench Multilingual 时解题率与官方持平，但每题总 token 与系统提示词 token 更高；README 明确不承诺在 Linux 上更省 token 或性能更强。
- `--allow-build` 需要 pnpm ≥ 10.4；在 pnpm 11 上不加会报 `ERR_PNPM_IGNORED_BUILDS` 装不上。插件面向 `dsh` v0.2.2-rc.1 这个 pre-release，接口可能变动。
05兼容性、维护与安全提示
- 安全 `rm` 把文件移进系统回收站，但各平台不统一：网络盘没有回收站，macOS 需要 10.12+，部分 Linux 桌面环境看不到条目，只能到落点自行还原。
- README 建议在 `danger-full-access` 下使用，因为沙箱模式可能误拦文件写入。
- 在 Linux 上跑 SWE-bench Multilingual 时解题率与官方持平，但每题总 token 与系统提示词 token 更高；README 明确不承诺在 Linux 上更省 token 或性能更强。
- `--allow-build` 需要 pnpm ≥ 10.4；在 pnpm 11 上不加会报 `ERR_PNPM_IGNORED_BUILDS` 装不上。插件面向 `dsh` v0.2.2-rc.1 这个 pre-release，接口可能变动。
- 不提供单独的 `pwsh` 工具，shell 场景统一由持久 `bash` 承担；在 Windows 上这意味着需要 Git Bash。
MIT 源码；本文所有事实均来自记录提交处的仓库 README，未做独立安全审计。
06常见问题
Web profile 上怎么装 Tool Plus？
执行 `dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`。两个 `--allow-build` 分别放行本包与 `koffi` 的安装脚本，需要 pnpm ≥ 10.4；pnpm 11 上不加会直接装不上。
为什么桌面端装法不一样？
桌面应用的 profile 由它独占，`dsh plugin --profile desktop` 会被拒绝。要进它自己的目录：`cd ~/.dsh/profiles/desktop`，再执行 `pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`。
它真的比官方工具省 token 吗？
按它自己的基准测试并不是。在 Linux 上跑 SWE-bench Multilingual，解题率与官方持平，`bash` 单次返回的 token 更少，但每题总 token 与系统提示词 token 更高，所以 README 明确说不承诺在 Linux 上更省 token 或性能更强。
安全 `rm` 具体做了什么？
把文件移进系统回收站而不是永久删除：Windows 是回收站，macOS 是 `~/.Trash`，Linux 是 `$XDG_DATA_HOME/Trash`。网络盘没有回收站，macOS 需要 10.12+，部分 Linux 桌面环境看不到条目；真要删除时用 `command rm`。
它面向哪个 DSH 版本与环境？
DeepSeek Harness `dsh` v0.2.2-rc.1（README 提醒这是 pre-release，接口可能变动），需要 Node.js ≥ 24.9、全局安装的 `dsh`、Windows 上的 Git Bash，并按建议在 `danger-full-access` 下使用。
07相关的 DSH 工作流
dsh-our-free-model
作者 ebony-vinyl
在 dsh 里装上这个插件即可，无需登录、注册或填 API Key，就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness（dsh）路由套件：先装运行时注入器，再加载任务感知的推理模式路由预设（已实测 P1-P23）。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件，旨在减少 Token 消耗与任务耗时
brooks-lint
作者 hyhmrright
基于 12 本经典工程书籍的 AI 代码评审工具，提供腐化风险诊断、书籍引用、严重度标签及 6 种分析模式。
08数据与来源
DeepSeek Harness 基础工具增强：持久 bash、结构化 read、多模式 edit、原子 write、全文搜索、图像直读，一个插件全覆盖。基于 [Oh My Pi](https://github.com/can1357/oh…
| **Tool Plus 标准增强版** | 官方 standard | 官方标准模式全部能力 + 文件/Shell 工具集换成本插件 |
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-11-12。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。