A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件,旨在减少 Token 消耗与任务耗时
★ 5,856⑂ 207👁 10⑃ 433● 510▤ 27
+25
日增长
+237
周增长
5,856
stars
207
forks
10
watchers
433
prs
510
issues
27
releases
README
中文 | English
dsh-ops
以提高token效率为目的,提供新增的ops系列工具并隐藏部分官方工具为方案的插件,低改动面,低侵入性,与其他插件广泛兼容。
- Bash 与宿主 Shell 隐藏独立配置;Windows 可用 ops_bash 替代 pwsh,也可保留官方 Shell。
- Native/PTC 消费者预设发布共享的有界工具面;Bash 由单行开关控制,关闭替换时原版工具保持可用。
- 第五个内置模式 ops-ptc 继承 PTC 工具面,由插件运行时注册(定义来自随包片段 presets/ops-ptc.patch.yml,不是插件管理器行),并可开启批量调用上下文提示(batchingGuidance):会话首轮注入一次英文教学(prompts/batching-guidance.md,进入历史、不改系统提示词),之后按根 run_code 程序形状(bypass/plan/shape,每类每轮一次、合规解锁)以 additionalContexts 纠偏、不阻断不改写程序;默认预设不强制:行详情页有一个按钮,点一次就把 ops-ptc 设为新会话默认,apply、重挂载与卸载都不会改你自己选的默认,详见预设与默认模式。
- 启用 DSH 预留的 tools_addition 动态工具加载,并提供渐进式纰漏的工具,作为高级功能(如pdf、word读取、超多文件批量修改)的加载平台,大大减少常见特定场景的token消耗量,且不会导致系统提示词膨胀
- 为 Native 模式提供返回紧凑、带行号和更好错误回馈的工具以遏制报错循环,减少调用轮次
- 为 PTC 模式提供一些返回结构化 JSON 值的工具以降低 ai 在 ptc 模式下编写 TypeScript 代码的token总量和心智负担
- PTC SDK 目录包含 18 个 API:15 个文件/文档工具,加批处理、结果引用和加载器。
左:deepseek-v4.1-flash-1017在各harness的跑分与开销右:ops在自用benchmark上取得的的成绩。完整benchmark将随后续更新发布dsh-ops团队将致力于持续优化dsh的token效率,以更低的成本更好地完成同样的任务
交流群:企鹅 1127808570
安装、更新、卸载
本分支候选的 Windows 默认载荷为完整 Niubash 1.5.0,随 dsh-ops 主包管理,不再默认下载 Git Bash 可选包。所有 npm、市场和 CLI 更新入口的二进制位置与清理边界见升级与卸载。@latest 仍指已发布版本,不代表此 PR 已发布。
官方插件市场
在目标 DSH 应用的插件市场中输入 npm 包名 dsh-ops,选择自定义地址,输入 https://mirrors.huaweicloud.com/repository/npm/,安装后选择启用。目前不推荐用npmmirror安装,有bug。
当然,如果你确定可以连接 npm 官方源那就选择官方源,如果你不确定那就按教程操作。
!在插件市场中选择自定义地址并填入华为云 npm 镜像
npm 一键安装
安装方法
console
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,可同样显式指定。
安装或卸载时可加 --dry-run 预演。它按指定路径或 PATH(Windows 同时使用 PATHEXT)解析 CLI,检查文件、POSIX 执行权限及通过 Node 启动的入口文件,并在预演时同样拒绝不安全的 Windows 命令脚本路径;检查失败返回非零。预演只打印计划,不启动 CLI、不修改 profile。成功表示这些静态检查已通过,不保证所选程序的身份、版本、profile 兼容性或后续安装结果。
也可以直接使用官方命令:
console
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;不要把它与桌面自带入口混淆。
请安装 registry 发行包,或已完整构建并打包的源码 tarball。直接 git+https 安装与未构建的
源码检出缺少完整运行时;见不支持通过 Git 通道安装。
更新方法
宿主支持从 DSH 0.2.2-rc.1 起;0.5 系列不再支持 0.2.0/0.2.1 或更早的 0.2.2 预览版。保留 DSH adapter 结构,按 0.2.2 原生工具准入和执行器接口接入。
组件图标导出、profile 刷新及配置/schema 检查见
宿主兼容范围与展示元数据。
重新运行相同的 npx --yes dsh-ops@latest install --profile ...,或用官方 CLI add dsh-ops@latest。按应用提示重载;替换已加载代码时重启应用。
卸载与查看状态
console
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 的包管理器管理;显式 provision 的副本不会随 npm 卸载,先查看 dsh-ops bash-runtime status,再用 dsh-ops bash-runtime remove --dry-run 预览、remove -Top issues
#455OPS 0.5.0:协同共进9 comments · 2026-10-28#784[BUG] 0.5.1 + DSH 0.2.2-rc.1(Windows / desktop profile / danger-full-access):publication 工具全部 PUBLICATION_DENIED,卸载即恢复7 comments · 2026-11-08#817[跟踪] 0.5.3:删除叠加的防御层,修复 bash 可用性、工具隐藏与固定开销4 comments · 2026-11-09#764[BUG] 0.5.0 + DSH 0.2.2-rc.1(Native/standard):未选中的延迟工具仍出现在可调用工具列表中,调用返回 PUBLICATION_DENIED(retry=never、无 nextAction),未指向 ops_discover_tools4 comments · 2026-11-07#883更新pwsh设计3 comments · 2026-11-13#771[BUG] Niubash / dsh-ops 运行时被 Windows Defender 误报并隔离的事件报告3 comments · 2026-11-07#750设置面板始终显示 dsh-win-pwsh7「未检测到」:client inject 缺 remote.pluginManager,检测静默降级成 unknown3 comments · 2026-11-07#704[BUG] 0.5.0 + dsh 0.2.2-rc.1:启动 dsh-tui 后首个会话创建失败 root.events.on is unavailable from a plugin activation3 comments · 2026-11-06
Discussions
#941此插件存在问题,请酌情安装!1 comments · 2026-11-14#769[Suggest]: fix 不好写可以先回滚一下啊 (4 comments · 2026-11-07#461I/O 层的跨平台归一化(Normalizer1 comments · 2026-10-28#460无状态并行批处理映射(Batch Mapper)1 comments · 2026-10-28#457OPS 0.5.0:协同共进0 comments · 2026-10-28#444是否可以考虑引入 Tree-sitter Queries 作为又一种轻量的读取方案?1 comments · 2026-10-27#441LiangShen 模式下 dsh-ops 的兼容性与工具调用1 comments · 2026-10-27#437发布一个支持V0.2.1-rc.3版本1 comments · 2026-10-27
Latest release
v0.5.5 v0.5.5 2026-11-13中文 | English 0.5.5 补丁版本,汇总了自 v0.5.4 以来的主要变更。本次为设置项逻辑更正后的重新发布构建,发布资产以本次上传的 SHA256SUMS 为准。 问题修复 - 修复强制默认预设会覆盖手动选择的问题:移除 global.forceDefaultOpsPtc 开关,改为行详情页的一次性按钮写入默认预设;apply、重挂载与卸载都不再改写默认,旧 profile 保存的该键仍可加载但不再生效。 @T-Auto - 修复 PTC 在关闭常驻工具与动态加载时仍注册 allowedTools 候选池的问题:没有 loader 的作用域不再声明这些 API,首轮提示词不再多出约 22.5k tokens,常驻与默认加载行为不变。 @T-Auto - 修复 Native 搜索诊断丢失并统一模式契约(867)。 @Haoming9527 The 0.5.5 patch release summarizes the main changes since v0.5.4. This is the re-published build with the settings correction; the uploaded SHA256SUMS describes the current assets. Bug Fixes - Fix the forced defau