README

中文 | English



  
    
  



  
  
  
  


 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。

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

- 单行默认启用四个内置消费者：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 抓取；使用前请查看文档格式限制。
- 一个原生 Switch 配置页管理内置与显式列出的自定义消费者。总开关门控预设选项但保留保存意图；常驻、动态加载、Bash、文件替换和 Windows 宿主 PowerShell 隐藏独立控制，panel 与 TUI 默认关闭。内外消费者共用装配器，未列出的预设保持原样。旧行覆盖须迁入单行，兼容行已删除；见设置和内部架构。
- 内置消费者默认开启：Windows 随主包携带固定的 Niubash 1.5.0 完整载荷，不再默认下载 Git Bash 可选包；设置页的「Bash 执行器」卡片可在该载荷与扫描/手动输入的 Git Bash 之间切换（保存为 bashPath）。Linux/macOS 使用系统 Bash。dsh-ops bash-runtime install 用于显式安装/修复托管副本。所有 npm、插件市场及 CLI 更新方式的二进制位置与清理边界见升级与卸载。PowerShell 仍由宿主管理。

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

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

 安装、更新、卸载

 官方插件市场

在目标 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 的包管理器管理；

Top issues

Discussions

Latest release

Full Changelog: https://github.com/T-Auto/dsh-ops/compare/v0.5.1...v0.5.2