前言¶
在 DeepSeek Harness（DSH）里跑智能体任务，成本往往落在两处：工具返回塞进上下文里的 Token，以及模型在报错、重试之间多走的轮次。官方工具覆盖面广，但在读大文件、批量改仓库、Native / PTC 两种 harness 模式下，返回体偏大或格式不利于模型继续写代码时，任务会变慢、账单会变厚。
下面介绍社区插件 dsh-ops（npm 包名 dsh-ops，仓库 T-Auto/dsh-ops）。它以提高 Token 效率为明确目标：用新增的 ops 系列工具替代或隐藏部分官方工具，并配合 DSH 预留的 tools_addition 做渐进式加载，在常见场景里压低提示词膨胀和调用次数。维护方为 T-Auto 团队；在 SkillHub 等社区目录中归类为「模型推理」相关插件。截至资料记录，GitHub 约 3665 stars、101 forks（以仓库页面实时数据为准）。
这是什么¶
dsh-ops 是面向 DSH 的底层操作工具插件，自述定位为：低改动面、低侵入性，并尽量与其它插件兼容。它不另起一套 harness，而是在现有 DSH 进程里挂载组件，把文件、Shell、PTC、可选 TUI 侧栏等能力按 profile 装进你的桌面端、Web 或 dsh-TUI 应用。
当前发行版源码以 MIT 许可分发（package.json 记录版本 0.4.1）。插件以当前 DSH 进程权限运行；安装前应在 GitHub 核对源码与 许可证 / 溯源说明。
核心功能¶
ops 工具与官方工具的取舍¶
插件通过 ops 命名空间的工具完成多数读写与命令操作，并可在策略层隐藏部分官方工具，减少模型在功能重叠工具之间来回试探。设计强调「方案级」替换而非全盘改写 DSH，便于与社区其它插件并存。
渐进式 tools_addition¶
启用 DSH 预留的 tools_addition 动态工具加载，把 PDF、Word 读取、大批量文件修改等偏重场景放在按需加载的高级能力里。常见对话不会把这些工具的 schema 一次性塞进系统提示，从而控制 Token；需要时再加载，避免提示词长期膨胀。
Native 模式¶
为 Native harness 提供返回更紧凑、带行号、错误信息更清晰的操作面，目标是遏制「报错—盲目重试」循环，减少无效轮次。
PTC 模式¶
为 PTC（Programmatic Tool Calling）模式提供返回结构化 JSON 的工具，降低模型在 PTC 下编写 TypeScript 时的 Token 总量与心智负担。仓库说明 PTC SDK 目录包含 18 个 API：其中 15 个为文件/文档类工具，另有批处理、结果引用和加载器相关接口。细节见仓库 PTC 设计与使用。
Windows 上的 Shell 行为¶
仅 Windows 平台：可启用与 DSH 原生 bash 行为一致的 ops_bash，并可选禁用 PowerShell，使 Shell 类任务路径与 Linux/macOS 体验更一致。可选载荷 @dsh-ops/bash-win32-x64 的许可与上游组件说明见仓库 PROVENANCE。
dsh-TUI 可选只读侧栏¶
在 dsh-TUI 中启用 dsh-ops/tui 插件行并重启后，可增加 OPS 只读侧栏：不抢焦点、不触发额外工具调用，用于浏览有界保留元数据。聚焦后支持 f 筛选、n/p 翻页、a 确认跨会话提醒等本地快捷键。说明见 侧栏文档。
已移除的后台组件¶
早期版本曾内置 FastCtx 后台任务（dsh-ops/background）；0.3.2 之后该组件已移除。若 profile 仍保留 background 行，加载时仅记录警告、不发布工具，可直接从配置删掉该行。旧版在 <DSH_HOME>/dsh-ops/ 下 provision 的文件需按 README 单独清理。
安装与启用¶
安装方式分两类：DSH 插件市场（npm 包名）与 npm 一键安装 / 官方 CLI。请勿使用未在文档出现的 dsh plugin add github:owner/repo 形式。
插件市场¶
- 在目标 DSH 应用的插件市场中搜索 npm 包名
dsh-ops。 - 选择「自定义地址」，填入华为云 npm 镜像（文档当前推荐，因 npmmirror 存在已知问题）：
https://mirrors.huaweicloud.com/repository/npm/
- 安装后在应用中启用插件。若能稳定访问 npm 官方源，也可选官方源。
npm 一键安装¶
必须先初始化目标 DSH 应用，并显式选择 profile。tui 对应 dsh-TUI 产品的 dsh-tui profile，不是旧版 tui 目录名。
桌面端应使用桌面应用自带的 CLI；默认探测路径为 Windows 下的 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd。安装目录不同时加 --dsh-cli 指向该 dsh.cmd。
预演安装（不修改 profile）可加 --dry-run：
npx --yes dsh-ops@latest install --profile desktop
npx --yes dsh-ops@latest install --profile web
npx --yes dsh-ops@latest install --profile tui
也可直接使用官方 CLI（注意 desktop profile 只能用桌面自带入口，普通 dsh CLI 不能管理保留的 desktop profile）：
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
更新、状态与卸载¶
更新：重新执行相同的 npx ... install --profile ...，或 dsh plugin ... add dsh-ops@latest，并按应用提示重载或重启。
查看状态 / 卸载（将 desktop 换成 web 或 tui）：
npx --yes dsh-ops@latest status --profile desktop
npx --yes dsh-ops@latest uninstall --profile desktop
也可在插件市场卸载，或 dsh plugin --profile ... remove dsh-ops。单独 provision 的 Bash 运行时可用 dsh-ops bash-runtime remove --yes 移除。清理旧版 <DSH_HOME>/dsh-ops/ 遗留时可用 npx --yes dsh-ops@latest uninstall --yes；~/.fastctx/ 默认不删，需要时加 --purge-fastctx。
典型用法与文档入口¶
安装并启用后，ops 工具会随 DSH 会话出现在模型可调用的工具列表中；具体工具名、参数与策略（例如隐藏哪些官方工具）以仓库 使用指南、组件参考、配置参考 为准。
PTC 集成与 Native 行为差异见 native-ptc.md。排错与验收可参考 常见问题、手动验收。
README 中附有团队在自用 benchmark 上的 Token 效率对比示意图；完整 benchmark 以仓库后续更新为准，本文不复述未公开的数字。
适用场景与注意¶
更适合谁：长期在 DSH 里做仓库级读写、Shell、文档处理或 PTC 脚本生成的开发者；希望在不大改工作流的前提下压低 Token 与轮次；需要 Windows 上与原生 bash 对齐的 Shell 行为；使用 dsh-TUI 且希望有只读 OPS 元数据侧栏的用户。
需要注意：
- 插件与 DSH 同权限运行，涉及文件删除、Shell 命令、批量修改等操作前，应理解策略与工具范围。
- 与隐藏官方工具相关的策略可能影响你或其它插件对内置工具的依赖，升级 dsh-ops 或 DSH 后建议对照 CHANGELOG。
- 社区目录（如 SkillHub 插件页）独立于 DeepSeek / 幻方，并非官方应用商店；安装源以 README 写的 npm 包与镜像为准。
- 支持平台（package.json）：win32 / linux / darwin，x64 / arm64。
结尾¶
dsh-ops 把「少 Token、少轮次」做成可安装的 DSH 插件：ops 工具面、tools_addition 渐进加载、Native / PTC 双模式优化，以及可选 TUI 侧栏，都在同一 npm 包 dsh-ops 下按 profile 交付。若要浏览简介与分类，可打开社区目录 dsh-ops；源码、安装细节与路线图见 GitHub T-Auto/dsh-ops。
