dsh-plus-plus：DeepSeek Harness 的本地控制平面

DeepSeek Harness（DSH）采用「一切皆插件」的架构。在实际使用中，开发者往往难以直观掌握已安装插件的具体能力（如是否访问文件系统、执行 Shell、获取凭证），且 Harness 本身未提供配置快照、回滚及使用量统计功能。DSH++ 是一个本地优先的控制平面插件，旨在填补这一运维层面的空白。

核心能力¶

DSH++ 提供了以下三个主要功能模块：

• 插件安全审计：通过 dshpp audit 统计已安装插件，分析其能力边界，进行风险分级，并标记应移除的组件。
• 工作流回归测试：通过 dshpp test 对当前 DSH 配置运行固定任务集，对比存储的基线，检测回归问题。若发现回归，命令将返回非零退出码，适合作为 CI 流水线的检查点。
• 生命周期管理：包括检测 Harness 安装状态、对 $DSH_HOME 进行快照与回滚、运行诊断检查、以及管理 Providers 和 Credentials。

安装与启用¶

前置条件：Node.js >= 20。

全局安装：

npm i -g .

作为 Harness 插件安装（添加 /dshpp 斜杠命令）：

dsh plugin --profile web add github:limlnx523/dsh-plus-plus

常用用法¶

安装完成后，可通过以下命令进行操作：

• dshpp status：查看 DSH 环境概览（Home、Env、Settings、Backups）。
• dshpp audit：生成插件安全风险报告。
• dshpp test：对 DSH 工作流进行回归测试。
• dshpp doctor：运行诊断检查清单。
• dshpp web：启动本地 Web 控制台。

Web 控制台与配置¶

• Web 控制台：运行 dshpp web 可在本地启动控制台，访问地址为 http://127.0.0.1:4848/。该服务仅绑定本地回环接口。控制台会展示 Providers、掩码凭证、备份、使用量与成本、会话日志、插件列表及回归测试结果。除非使用 --show 参数，否则密钥默认被掩码。
• 配置存储：
  • Harness 主目录：$DSH_HOME 或 ~/.dsh
  • 凭证存储：$DSH_HOME/.env（该文件不应被提交到版本控制）
  • DSH++ 状态：~/.dsh-plus-plus/（存储备份、Provider 清单、回归基线）

注意事项¶

• 无第三方依赖：插件不依赖任何第三方运行时库，使用 Node.js 内置模块。
• 权限安全：插件运行时拥有当前 DSH 进程的权限。安装前请检查源码与许可证。
• 凭证管理：所有凭证存储在 $DSH_HOME/.env 中，快照时会警告是否包含敏感信息。