独立 bash 5.3.15，用于通用命令、构建、Git、管道和脚本。
独立 PowerShell 7.6.6，用于必要的 Windows 原生操作，沿用宿主 pwsh 工具。
Rust 编写的高性能增强工具，支持批量读取、搜索、替换和有界输出，减少不必要的输入输出。由于部分工具不经过 DSH 的受限终端后端，命令与后台任务工具只在完全权限时启用。

执行顺序：工具包 → bash → PowerShell 7。bash 报错在 bash 内修正，不随意换 shell，不混用两套语法。

仅支持 Windows x64；目标宿主 DSH 0.2.0-rc.2。English

安装、更新、卸载

官方插件市场

在目标 DSH 应用的插件市场中输入 npm 包名 dsh-ops，安装后选择启用。安装归属于当前运行的 profile，桌面端为 desktop。发布包依赖完整 FastCtx、bash 和 PowerShell 7 载荷；不使用安装脚本下载，不改系统 PATH。

npm 一键安装

npx --yes dsh-ops@latest install --profile desktop
npx --yes dsh-ops@latest install --profile web
npx --yes dsh-ops@latest install --profile tui

必须显式选择目标 profile；tui 映射到 dsh-TUI 产品的 dsh-tui profile，不是旧的 tui 目录。请先初始化目标应用。该入口委托官方 DSH CLI 安装，不另写一套 profile 锁与回滚逻辑。

桌面端必须使用桌面应用自带的 CLI；默认探测 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd。安装在其它位置时加 --dsh-cli "<安装目录>\resources\runtime\cli\bin\dsh.cmd"。Web/TUI 需要可用的 DSH CLI，可同样显式指定。

也可以直接使用官方命令：

dsh plugin --profile web add dsh-ops
dsh plugin --profile dsh-tui add dsh-ops
"<桌面安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-ops

普通 DSH CLI 不能管理保留的 desktop profile；不要把它与桌面自带入口混淆。

更新：重新运行相同的 npx --yes dsh-ops@latest install --profile ...，或用官方 CLI add dsh-ops@latest。按应用提示重载；替换已加载代码时重启应用。

当前 npm 版本为 0.2.3：提示词提醒 ops_* 只传声明字段，标题统一为 dsh-ops，并更新中英文介绍和图标；保留 0.2.2 的 bash schema 修复，三个运行包仍使用 0.2.1。原始载荷发布记录见 docs/release-0.2.1.md。

卸载与查看状态：

npx --yes dsh-ops@latest status --profile desktop
npx --yes dsh-ops@latest uninstall --profile desktop

把 desktop 换成 web 或 tui 即可。也可在市场卸载，或执行官方 dsh plugin --profile ... remove dsh-ops。二进制随 profile 的插件依赖管理；卸载移除依赖引用，不误删系统 shell、其它 profile 的副本或包管理器共享缓存。

旧版显式 provision 的 <DSH_HOME>/dsh-ops/ 文件需单独清理：npx --yes dsh-ops@latest uninstall --yes。默认不删 ~/.fastctx/ 持久状态；需要时显式加 --purge-fastctx。卸载/降权不保证已经启动的持久后台任务终止，先处理自己的任务。

配置方式与工具列表

在 DSH 的配置编辑器中找到 dsh-ops 行，调整 config 后保存；未知配置键会点名报错。主要默认值：

config:
  enableShellTools: true
  publishBashTool: true
  promptPolicy: true
  toolCallTimeoutMs: 300000
  required: false
  shellPolicy: advise
  allowSystemShellFallback: true
  # binaryPath: 'C:\tools\fastctx.exe'
  # bashPath: 'C:\tools\bash.exe'

enableShellTools：部署开关，开启仍须会话 danger-full-access 才发布 FastCtx 命令/job 组。
publishBashTool：是否发布 ops_bash，同样要求完全权限和宿主 subprocess 服务。
promptPolicy：是否注入紧凑三层路由说明；可用 extraGuidance 追加指导。
toolCallTimeoutMs：FastCtx RPC 等待超时，不代表服务端工作已终止。
required：运行时不可用时是否拒绝激活。
shellPolicy：默认 advise；deny-host-shell 拒绝 deniedHostTools 列表中的宿主 shell（默认 [pwsh, bash, pwsh_persistent]）。这也会禁用第三层 pwsh，谨慎开启。
binaryPath / bashPath：可选显式路径；不可用时报错，不悄悄换执行器。一般无需配置。

工具	用途	完全权限要求
`ops_inspect_local_file`	批量文本范围、编码、PDF 文本、hex	无命令权限门¹
`ops_grep`	Rust 正则搜索、多文件过滤、计数/摘要	无命令权限门¹
`ops_glob`	多模式找路径，支持排除	无命令权限门¹
`ops_replace`	跨文件批量替换；精确编辑仍用宿主 edit	无命令权限门¹
`ops_bash`	优先的通用 bash 命令执行器	是
`ops_run`	有界 bash 命令结果	是
`ops_run_background`	启动后台任务	是
`ops_job_output` / `ops_job_list` / `ops_job_kill`	查看、列出、停止当前会话启动的任务	是
宿主 `pwsh`	使用随包 PowerShell 7 的 Windows 原生操作	沿用宿主策略

¹ 文件工具不是宿主文件系统沙箱。 它们未接入 DSH 的受限文件后端，尤其 ops_replace 没有 workspace confinement。不要把该插件视为不可信受限环境的安全方案。图片交给宿主 read_image，插件不会假装已看过图片。

命令工具随会话权限变化发布/撤销，调用前重查权限。后台 job 按会话和当前连接隔离；断线后不能重新认领旧任务。手动验证清单与schema 测量记录了验证范围，不构成运行时无缺陷保证。

许可证

插件源码分发采用 MIT AND Apache-2.0：vendor/fastctx/ 之外为 MIT；vendored FastCtx 为 Apache-2.0。见 NOTICE、vendor/fastctx/LICENSE-APACHE 与 vendor/fastctx/NOTICE。

独立的 Windows 载荷包另按上游组件许可证分发：Git for Windows 包含 GPL 等许可组件，PowerShell 包含 MIT 与第三方组件。其原始许可证、声明及来源记录随载荷保留；插件的 MIT 许可不替代这些许可。详见 PROVENANCE.md。

致谢

Rust 工具基于 yc-duan 的 Codex 插件 FastCtx 并使用其源代码。vendor 标识与删除型分发改动记在 vendor/fastctx/FORK.md 和 vendor/fastctx/UPSTREAM.md。需要转载的 FastCtx 声明如下：

This product includes FastCtx (https://github.com/yc-duan/fastctx), Copyright (c) 2026 yc-duan, used under the Apache License 2.0.

FastCtx is redistributed and/or modified here by the maintainer of this distribution. Any such change is that maintainer's own work and their sole responsibility. It is not endorsed by, not supported by, and not attributable to the author of FastCtx, who accepts no liability of any kind arising from this distribution or from anything built on top of it.