dsh-ops

dsh plugin --profile web add dsh-ops

<p align="center">

<img src="docs/assets/readme/dsh-ops-header.svg" alt="dsh-ops 表头" width="640">

</p>

<p align="center">

<strong>中文</strong> | <a href="README.en.md">English</a>

</p>

<div align="center" style="text-align: center;">

<a href="https://trendshift.io/repositories/296103" title="Trendshift · JavaScript 日榜">

<img src="https://trendshift.io/api/badge/trendshift/repositories/296103/daily?language=JavaScript" alt="Trendshift · JavaScript 日榜" width="250" height="55" style="vertical-align: middle;">

</a>

</div>

<p align="center">

<a href="https://www.npmjs.com/package/dsh-ops"><img alt="npm" src="https://img.shields.io/npm/v/dsh-ops?style=flat-square&color=6c5ce7"></a>

<a href="https://www.npmjs.com/package/dsh-ops"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-ops?style=flat-square&color=4b6fff"></a>

<a href="https://github.com/T-Auto/dsh-ops/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/T-Auto/dsh-ops?style=flat-square&color=eab308"></a>

<a href="https://upstar.dev/r/T-Auto/dsh-ops"><img alt="Upstar: #2 in JavaScript" src="https://upstar.dev/badge/T-Auto/dsh-ops.svg"></a>

</p>

dsh-ops

OPS 为 DSH 增加有界文件与文档工具。Native 模式返回紧凑、带行号的文本；PTC 代码从同一个按调用启动的 Rust worker 获取类型化 Outcome。宿主集成使用严格 TypeScript，编译后保持已有 JavaScript 包路径。

支持：Windows x64、Linux x64，以及 macOS 13+ 的 Apple Silicon 与 Intel（darwin-arm64、darwin-x64）。见 [macOS](docs/macos.zh.md)。

[!IMPORTANT]

本分支是 0.5.0 未发布候选：配置统一为单个 dsh-ops 行。下方 @latest 命令安装已发布版本；评估候选版本需自行构建本检出目录并打包，变更见[变更日志](docs/CHANGELOG.md)。

• 单行默认启用四个内置消费者：Standard/Cordis 发布 Native 常驻文件工具，PTC 发布类型化 API，Minimal 没有文件常驻基线。Native 发现与 PTC SDK 加载独立配置；高级选择仅在所属 agent 下一次请求激活，不在发现时执行动作。
• PTC SDK 目录包含 18 个 API：15 个文件/文档工具，加批处理、结果引用和加载器。仅暴露配置为常驻或已选择的 API；Native 与 PTC 分别提供自己的输出形式。
• 可按需发现有界 CSV/TSV、DOCX 主体段落与受限 PDF 文本层读取。尚不支持二进制 DOC、OCR、通用 PDF 渲染、网页搜索或 HTML 抓取；使用前请查看[文档格式限制](docs/原生内核.md)。
• 一个原生 Switch 配置页管理内置与显式列出的自定义消费者。总开关门控预设选项但保留保存意图；常驻、动态加载、Bash、文件替换和 Windows 宿主 PowerShell 隐藏独立控制，panel 与 TUI 默认关闭。内外消费者共用装配器，未列出的预设保持原样。旧行覆盖须迁入单行，兼容行已删除；见[设置](docs/配置参考.md)和[内部架构](docs/内部架构.md)。
• 内置消费者默认开启：Windows 随主包携带固定的 Niubash 1.5.0 完整载荷，不再默认下载 Git Bash 可选包；设置页的「Bash 执行器」卡片可在该载荷与扫描/手动输入的 Git Bash 之间切换（保存为 bashPath）。Linux/macOS 使用系统 Bash。dsh-ops bash-runtime install 用于显式安装/修复托管副本。所有 npm、插件市场及 CLI 更新方式的二进制位置与清理边界见[升级与卸载](docs/升级与卸载.md#二进制位置与更新清理)。PowerShell 仍由宿主管理。

OPS 只发布自身作用域内的工具与可选路由提示，不改写共享工具注册表。每次调用均检查权限与取消状态。Windows 受限 Bash 仍存在文档注明的部分约束与运行时兼容性限制。

历史 token 节省说法不能证明本候选版本通过发布门禁。ops 指广义 operations（运行操作），并非运维/SRE 产品。

安装、更新、卸载

官方插件市场

在目标 DSH 应用的插件市场中输入 npm 包名 dsh-ops，选择自定义地址，输入 https://mirrors.huaweicloud.com/repository/npm/，安装后选择启用。目前不推荐用npmmirror安装，有bug。

当然，如果你确定可以连接 npm 官方源那就选择官方源，如果你不确定那就按教程操作。

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，可同样显式指定。

安装或卸载时可加 --dry-run 预演。它按指定路径或 PATH（Windows 同时使用 PATHEXT）解析 CLI，检查文件、POSIX 执行权限及通过 Node 启动的入口文件，并在预演时同样拒绝不安全的 Windows 命令脚本路径；检查失败返回非零。预演只打印计划，不启动 CLI、不修改 profile。成功表示这些静态检查已通过，不保证所选程序的身份、版本、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

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

请安装 registry 发行包，或已完整构建并打包的源码 tarball。直接 git+https 安装与未构建的

源码检出缺少完整运行时；见[不支持通过 Git 通道安装](docs/升级与卸载.md#不支持通过-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 检查见

[宿主兼容范围与展示元数据](docs/使用指南.md#宿主兼容范围与展示元数据)。

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

卸载与查看状态

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 --yes 确认。不要误删系统 shell、其它 profile 或共享缓存。详见[二进制位置与更新清理](docs/升级与卸载.md#二进制位置与更新清理)。

旧版显式 provision 的 <DSH_HOME>/dsh-ops/ 文件（provision 的 shell，以及早期版本可 provision 的 FastCtx 运行时）需单独清理：npx --yes dsh-ops@latest uninstall --yes。已移除的后台组件留下的 ~/.fastctx/ 状态默认不删；需要时显式加 --purge-fastctx。

原 dsh-ops/background 组件（FastCtx 后台任务）已移除。仍保留该行的 profile 照常加载：该行不发布任何工具，只记录一条警告，可直接删除。

可选 OPS 只读侧栏

在 dsh-TUI 中启用 dsh-ops/tui 行并重启，即可添加 OPS 侧栏；不抢焦点，不执行额外工具调用。没有 tuiPanels 的宿主仅让该可选行等待，不影响其它组件。见 [侧栏说明](docs/tui-panel.zh.md)。 聚焦后可用 f 筛选、n/p 本地翻页、a 确认跨会话提醒；只浏览有界保留元数据，不拉取结果分页。

文档

• [第三方预设集成接口](docs/集成接口.md) · [外部 Native 提供者](docs/外部工具提供者.md) · [作用域诊断](docs/集成诊断.md)

• [使用指南](docs/使用指南.md) · [常见问题](docs/常见问题.md) · [组件参考](docs/组件参考.md) · [配置参考](docs/配置参考.md)
• [PTC 设计与使用](docs/native-ptc.md) · [手动验证](docs/手动验收.md)
• [贡献指南](docs/贡献指南.md) · [路线图](docs/路线图.md) · [变更日志](docs/CHANGELOG.md) · [溯源记录](docs/PROVENANCE.md)

许可证

当前 dsh-ops 源码以 MIT 许可分发，见 [LICENSE](LICENSE)。0.3.2 之前的版本曾内置以 Apache-2.0 许可的 FastCtx 源码；该源码随后台组件一并移除，当前发行版不再包含任何 FastCtx 代码或二进制。FastCtx 的许可文本与上游声明保留在 licenses/fastctx/，历史归属见 [NOTICE](NOTICE)。

Windows 随包 Niubash 及其 WinuxCmd、Git 等组件分别遵循上游许可证；原始许可证、NOTICE 与来源记录随完整载荷保留。Git Bash 仅保留为显式 legacy 后端与源码路径，不再默认下载其可选包。插件 MIT 许可不替代任何第三方许可；见 [NOTICE](NOTICE) 和[升级与卸载](docs/升级与卸载.md)。

致谢

早期版本（0.3.2 之前）曾内置并分发 yc-duan 的 Codex 插件 FastCtx，并使用其

…(truncated)