中文 | English
致力优化dsh插件token效率，提升ai性能，减少token消耗，减少任务总时间的插件，解决 Windows 下 DSH 反复使用 PowerShell 报错造成的 token、时间和模型注意力浪费，会持续更新。
tips：本项目的 ops 是广义 operations （运行操作）的缩写，代指本插件处于dsh和系统/代码/文件操作的基础工具位置。本项目不是 operations（运维）插件。
在现阶段，本插件的三个主要功能：
- 提供独立 bash 5.3.15 并优先使用bash，让你的AI不再和PowerShell打架
- 独立 PowerShell 7.6.6，用于必要的 Windows 原生操作，沿用宿主
pwsh工具。PowerShell 7 比自带的 PowerShell 5 也有不少优化 - 一些 Rust 编写的性能更好的，更快的读取、查找、替换工具，加速任务运行，减少不必要的输入输出。由于部分工具不经过 DSH 的受限终端后端，命令与后台任务工具只在完全权限时启用。
- 未来会加入一系轻量短输出的好用的rust工具，致力于优化token效率，均可开关和单独配置
执行顺序：工具包 → bash → PowerShell 7。
仅支持 Windows x64，后续补充 Rust 工具后会支持 Linux 和 Mac（Linux 和 Mac 下不提供 bash 功能）。目标宿主 DSH 0.2.0-rc.2。
在目标 DSH 应用的插件市场中输入 npm 包名 dsh-ops，安装后选择启用。安装归属于当前运行的 profile，桌面端为 desktop。发布包依赖完整 FastCtx、bash 和 PowerShell 7 载荷；不使用安装脚本下载，不改系统 PATH。
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。按应用提示重载；替换已加载代码时重启应用。
当前版本 0.2.9 是纯 bug 修复版：PATH 回退时跳过 Windows WSL 启动器、在 spawn 前拒绝 ops_bash 未声明参数，并且不再通过 remount 持久化一次性旧 shell 回退迁移，避免配置重载期间拖慢 Desktop。没有新增 feat、组件、配置键或运行时能力。三个二进制依赖仍固定为 0.2.1，本次不重新发布 npm 载荷。
卸载与查看状态：
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-ops-bash & powershell 7 |
将默认终端改为bash，以及bash覆盖不到时提供powershell7 | 开 | ops_bash；宿主 pwsh 使用随包 PowerShell 7 |
dsh-ops-file |
更快、更高性能、输出更精简更省token的rust文件检索 | 开 | 四个文件工具 |
dsh-ops-background |
为科研仿真、模型训练及其他长进程后台任务提供托管 | 关 | 启动、输出、列出、终止后台任务 |
“默认终端改为 bash”指模型提示优先使用 ops_bash，不修改系统默认终端、PATH 或宿主原有 shell 工具名称。Shell 组件开时，通过官方配置生命周期临时指定 pwsh-sandbox 的 PowerShell 7 路径；关时按执行器最新原配置恢复，不写 profile 配置。执行器配置切换不代表取消已在运行的宿主命令。
提示词注册为独立运行时段，不写 AGENTS.md：Shell 关就撤销 bash/pwsh 路由；文件关就撤销检索说明；后台关就不发布后台工具及自有 job 指导。文件与后台共享一个插件拥有的 FastCtx 连接，关闭其中一个不关闭另一个。默认仅新增五个工具，不发布重复前台 ops_run。这些改变减少固定声明成本。极简预设会覆盖附加 system sections；PTC 模式经 SDK 调用底层工具，权限门不变。
在 DSH 的配置编辑器中找到对应的 dsh-ops/shell、dsh-ops/file 或 dsh-ops/background 行，调整 config 后保存；未知配置键会点名报错。也可直接在市场切换组件。主要配置：
config:
# background component only; its market row is disabled by default
enableShellTools: true
publishBashTool: true
promptPolicy: true
toolCallTimeoutMs: 300000
required: false
shellPolicy: advise
allowSystemShellFallback: false
# Managed update metadata; do not remove after the first startup self-check
# configUpdateVersion: 1
# binaryPath: 'C:\tools\fastctx.exe'
# bashPath: 'C:\tools\bash.exe'enableShellTools：后台组件的部署开关，开启仍须会话danger-full-access才发布四个后台工具；文件组件不发布命令工具。publishBashTool：是否发布ops_bash，同样要求完全权限和宿主 subprocess 服务。promptPolicy：是否注入该组件的运行时说明；可用extraGuidance追加指导。toolCallTimeoutMs：FastCtx RPC 等待超时，不代表服务端工作已终止。required：运行时不可用时是否拒绝激活。shellPolicy：默认advise；deny-host-shell拒绝deniedHostTools列表中的宿主 shell（默认[pwsh, bash, pwsh_persistent]）。这也会禁用第三层 pwsh，谨慎开启。allowSystemShellFallback：默认false，随包/已 provision 的 bash 缺失时不探测系统 PATH 或常见安装目录；后台组件也不绕过此选择调用 FastCtx 的自动探测。只有显式设true才使用未固定摘要的系统 bash，请自行信任与维护该执行器。显式bashPath是另一种操作者选择，并非自动回退。首次升级启动的迁移见下方“更新配置修改区”。shellPolicy与此开关独立：deny-host-shell遮蔽/拒绝宿主工具；禁止系统回退只约束插件自己的 bash 解析，不关闭宿主pwsh，也不提供文件系统沙箱。binaryPath/bashPath：可选显式路径；不可用时报错，不悄悄换执行器。一般无需配置。
| 工具 | 用途 | 完全权限要求 |
|---|---|---|
ops_inspect_local_file |
批量文本范围、编码、PDF 文本、hex | 无命令权限门¹ |
ops_grep |
Rust 正则搜索、多文件过滤、计数/摘要 | 无命令权限门¹ |
ops_glob |
多模式找路径，支持排除 | 无命令权限门¹ |
ops_replace |
跨文件批量替换；精确编辑仍用宿主 edit | 无命令权限门¹ |
ops_bash |
优先的通用 bash 命令执行器；短命令用 command，长脚本用 script_path |
是 |
ops_run_background |
启动后台任务 | 是 |
ops_job_output / ops_job_list / ops_job_kill |
查看、列出、停止当前会话启动的任务 | 是 |
宿主 pwsh |
使用随包 PowerShell 7 的 Windows 原生操作 | 沿用宿主策略 |
¹ 文件工具不是宿主文件系统沙箱。 它们未接入 DSH 的受限文件后端，尤其 ops_replace 没有 workspace confinement。不要把该插件提供的部分工具视为不可信受任限环境的安全方案。
ops_bash 的 command 适合短命令和短管道。对于超过约 1 KB，或包含 heredoc、引号、反斜杠、中文等内容的多行脚本，请先用宿主的文件工具写入脚本文件，再传入 script_path 执行；不要把整段 heredoc 塞进 command。这样可以显著减少模型在工具调用 JSON 中进行多层转义的负担，降低整轮因 MALFORMED_RESPONSE 作废的概率。
当随包 bash 载荷在 profile 的声明/lockfile 中存在、但实际 node_modules 已被宿主包管理器清理时，ops_bash 会返回可读的 ENOENT 诊断，而不是把裸的 spawn 异常抛给模型。此时应使用 profile 的 frozen install 或官方插件管理器恢复依赖；不会静默切换到未授权的系统 bash。
script_path 只接收脚本路径，脚本内容不会重复进入 ops_bash 的工具参数；command 与 script_path 必须二选一。该接口不会替模型修复非法 JSON，工具调用本身若未能解析，仍需由宿主或模型重试。
ops_bash 的参数是严格的：传入 schema 未声明的键会在执行前被拒绝，错误信息同时点出未知键与可接受的键，不会静默忽略。本工具没有 run_in_background，也没有 job id，命令一律前台执行。宿主 bash / pwsh 工具接受 run_in_background，因此模型容易把该参数套到 ops_bash 上；这样调用会被明确拒绝而不是静默当前台执行。服务、监听器、watch 等常驻进程请改用宿主 pwsh 工具的 run_in_background，或在命令内部自行脱离（例如 nohup ... & disown）。否则该次调用会一直占用到 timeoutMs（上限 MAX_BASH_TIMEOUT_MS，约 24.9 天）。
插件只回收自己启动的 fastctx serve 客户端：组件最后一个连接引用释放、连接关闭、宿主正常退出或强制退出时均有回收路径。runtime-host 是上游可复用的共享进程，父进程已退出不等于泄漏；无客户端且空闲约十分钟后自行退出。不要按进程名批量杀它。新版不自动清理旧版本已留下的进程。
lib/config-updates.js 集中维护一次性配置迁移。0.2.5 首次启动时逐个自有配置行执行自检：
- 未完成迁移（无
configUpdateVersion或值为0）：把旧allowSystemShellFallback: true改为false，在任何执行器解析/工具发布前生效。 - 通过官方 loader 的配置生命周期写回该行，并加入
configUpdateVersion: 1；保留其它字段，不修改外来插件、PATH 或全局配置。未启用的组件在它首次启动时迁移。 - 完成后重启/热加载不再覆盖；你之后主动改回
true会被保留。不要删除迁移标记，否则会重新自检。 - 没有 loader 配置行时只应用本次运行的安全值并告警；写入失败由迁移/loader 日志报告，未落盘的标记不能保证跨重启一次性。
插件源码分发采用 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.