dsh-capability-inspector

by tree201

工作流与自动化github收录于 08-23

DeepSeek Harness 的只读运行时诊断与健康检查插件

A read-only runtime diagnostics and health-check plugin for DeepSeek Harness.

安装

dsh plugin --profile web add github:tree201/dsh-capability-inspector

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

English | 简体中文

DSH Capability Inspector 是 DeepSeek Harness 的只读运行时诊断与健康检查插件。

它提供 inspect_dsh 工具,帮助用户回答以下问题:

  • 当前 DeepSeek Harness / DSH profile 实际启用了哪些能力?
  • Agent 当前能看到哪些工具、模型和 Skills?
  • Workspace 和 Session 持久化是否正常?
  • 为什么某个 DSH 插件、模型提供方或能力没有生效?
  • 当前故障发生在配置、加载还是运行时能力层?

可以把它理解为 DeepSeek Harness Doctor、DSH 体检工具或 DSH Capability Matrix。

当前检查范围

  • Node.js 版本、操作系统、CPU 架构和工作目录
  • 当前 Agent scope 内可见的工具
  • LLM providers 及其模型目录
  • Skills、来源和调用方式
  • Workspaces、目录状态和关联会话数量
  • Session persistence 状态
  • 缺失能力和检查错误汇总

插件不会返回 API Key 或其他凭据明文,不会修改配置,也不会自动修复问题。

安装

从 GitHub 安装

dsh plugin --profile web add github:tree201/dsh-capability-inspector
dsh web

DeepSeek Harness 当前仍处于开发者预览阶段。如果 Git 安装触发 pnpm 构建授权提示,请先阅读 DSH 官方插件安装文档并确认源码可信。

从本地目录安装

dsh plugin --profile web add /absolute/path/to/dsh-capability-inspector
dsh web

使用

安装并重启 DSH 后,在对话中直接说:

检查当前 DSH 环境,列出可用能力和警告。

也可以提出更具体的问题:

查看当前 Agent 有哪些工具和 Skills。

检查模型提供方和模型目录。

检查工作区和会话持久化状态。

Agent 会调用 inspect_dsh 并返回结构化诊断报告。

工具参数

inspect_dsh 支持以下 scope:

  • summary:完整报告,默认值
  • tools:工具目录
  • models:模型提供方和模型目录
  • skills:Skill 目录
  • workspaces:工作区状态
  • sessions:会话持久化状态

设计边界

首版只使用 DeepSeek Harness 公开的只读枚举 API:

  • 不读取 Cordis 私有反射状态
  • 不显示凭据明文
  • 不修改 profile 或运行时配置
  • 单项检查失败不会中断完整报告
  • 无法检查在本插件加载之前就已失败的插件
  • 当前不会自动修复故障

开发

pnpm install
pnpm run check

验证内容包括 TypeScript 类型检查、单元测试和构建。

相关关键词

DeepSeek Harness、DSH、DSH plugin、DeepSeek Harness plugin、DSH Doctor、DSH diagnostics、MCP troubleshooting、Agent capability inspector、capability matrix、运行时诊断、插件体检、模型与工具检查。

许可证

MIT

原始 README: https://github.com/tree201/dsh-capability-inspector/blob/main/README.zh-CN.md ↗