DeepSeek Harness 的核心理念是插件化。在构建智能体或进行复杂开发任务时，基础的文件操作和 Shell 环境往往需要更稳定的支持。dsh-tool-plus 是一个基础工具增强插件，旨在通过持久化 bash、结构化读取和多模式编辑等功能，补齐这些短板。
核心功能¶
该插件覆盖了从基础 Shell 到高级文件操作的多个层面：
- 持久 bash：Shell 会话在调用间保持状态（
cd、export等变量不丢失）；自动处理长日志（压缩）、后台任务（超长输出自动后台）；可拦截cat、grep、find、sed-i等命令，引导使用专用工具。 - 安全删除：默认的
rm命令会将文件移入系统回收站而非永久删除。如需真删，请使用command rm。 - 结构化 read：支持按行区间读取（
:N-M）、原始内容（:raw）；大文件默认返回结构摘要，细节按需展开。支持读取 zip、tar、SQLite、notebook、PDF、图像及网页内容。 - 原子 write：写入操作返回 diff；支持补丁式写入 zip、tar 归档成员与 SQLite 数据库。
- 多模式 edit：默认为 replace 模式，另支持 patch、hashline、apply-patch 三种补丁格式。
- grep / glob：提供全文搜索与文件名匹配功能，支持 mtime 排序、上下文行及忽略规则配置。
- 可选 AST 工具：提供基于语法树的结构化搜索与重写能力（ast_grep / ast_edit）。
- agent 预设：随插件内置两套预设——Tool Plus 标准增强版和 PTC（Code Mode），安装后即可在预设列表中选择。
安装与启用¶
安装前需确保已全局安装 dsh CLI 并安装了 Node.js（版本 >= 22.19 或 >= 24）。
Web 端安装¶
dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
注：Web 端安装需要 pnpm >= 10.4。若版本较低报错，需在 ~/.dsh/profiles/web/pnpm-workspace.yaml 中允许构建，或执行 pnpm approve-builds --all。
桌面端安装¶
进入桌面端 profile 专属目录进行安装：
cd ~/.dsh/profiles/desktop
pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
本地开发¶
使用本地链接进行开发调试：
dsh plugin --profile web add link:<本仓库路径>
典型用法¶
安装完成后，插件会自动接管官方的 bash / pwsh / 文件 / 搜索工具。
- 读取特定行：使用
:N-M语法指定行区间。 - 读取原始内容：使用
:raw获取文件原始内容。 - 真删文件：在
rm前加上command前缀。 - 编辑补丁：使用
edit patch指定补丁模式。 - 选择预设：在工具设置中选择 “Tool Plus 标准增强版” 或 “PTC”。
注意事项¶
- 权限模式：建议在
danger-full-access模式下使用，避免沙箱模式因权限问题误拦文件写入。 - Shell 统一性：插件不提供单独的
pwsh工具，所有 shell 场景由持久bash统一承担。 - 安全删除机制：
rm删除的文件进入系统回收站，但各平台的落点与可见性不同（Windows/macOS/Linux 均有差异，如 Linux 下文件名通常变为 UUID）。 - 版本升级：0.1.9 或更早版本升级的用户，可安全删除
~/.dsh/.agent-presets/目录。
总结¶
dsh-tool-plus 通过一个插件集成了持久化 Shell、结构化文件读写、安全删除及多模式编辑能力，能够显著提升 DeepSeek Harness 环境下的开发与调试效率。如需查看更多细节或提交反馈，可访问插件目录或GitHub 仓库。
