前言¶

在 DSH Web 里，开发者经常需要确认当前普通会话能调用哪些 skill，以及每个 skill 的说明字段。已有做法不一定在 Web 设置面板中提供这样的只读列表。

@winterchenhuan/dsh-skills-viewer 为 DeepSeek Harness Web 增加一个只读的 Skills 设置页。它通过 skill.list wire RPC 获取当前普通会话可调用 skill 目录，并以只读列表渲染。该插件不提供 skill body 预览。

DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

• 包名：@winterchenhuan/dsh-skills-viewer
• 维护者：winterhuan
• 许可证：MIT
• 定位：Read-only Skills settings page plugin for DeepSeek Harness Web

它解决的问题是：在 Web GUI 的 Settings 面板中查看当前普通会话可用的 skill 列表，并对照 description 和 whenToUse。

核心功能¶

1、在 Settings 面板注册名为 Skills 的设置页。

2、通过 skill.list wire RPC 获取当前普通会话可调用 skill 目录。

3、以只读列表渲染 skill 信息，列表按 skill 名称字母排序。

4、skill 行显示：

• name
• model: off 徽章
• description
• whenToUse

5、搜索框可按 name、description 或 whenToUse 过滤。

6、会话变化时重新获取；无当前会话或导航指向 subagent 时显示空状态。

7、纯 UI 插件：节点端 apply 为空；浏览器端通过 dsh.client 注入 slots、locale 和 connection。

8、注册 settings.section 列表项，id 为 skills，order: 90。

9、声明 dsh.bundle；dsh plugin add 会自动插入 skills-viewer 配置行。

10、声明 dsh.client；Web host 可从 lib/client.js 提供预构建浏览器 bundle。

安装与启用¶

安装命令要求 dsh 和 pnpm 都在 PATH 上。dsh plugin 会原样转发参数给 pnpm。

dsh plugin --profile web add -w @winterchenhuan/dsh-skills-viewer
dsh web --dump-config     # verify the skills-viewer layer is present
dsh web                   # boot the Web GUI

第一条把包安装进 Web profile；第二条确认配置中存在 skills-viewer 层；第三条启动 Web GUI。

-w / --workspace-root 是必需的，因为 Web profile 目录是 pnpm workspace root。包声明了 dsh.bundle，所以 dsh plugin add 会自动插入 skills-viewer 行；不要手动编辑 profile 的 cordis.patch.yml。

如果是本地目录：

dsh plugin --profile web add -w /path/to/dsh-skills-viewer

移除：

dsh plugin --profile web remove @winterchenhuan/dsh-skills-viewer

典型用法¶

开发或验证本地构建时，可以运行：

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

这些命令分别用于安装依赖、类型检查、运行测试和构建。

在 Web 设置页中使用时：

1、进入 Settings 面板。

2、打开 Skills 页。

3、查看当前普通会话的 skill 列表。

4、用搜索框按 name、description 或 whenToUse 过滤。

适用场景与注意¶

适合：

• 想以只读方式查看当前普通会话可调用 skill 的 DSH Web 用户。
• 需要在 Web 设置页中快速对照 description 和 whenToUse 的场景。
• 不依赖手动刷新按钮、不要求 skill body 预览的工作流。

注意：

• 该页面不提供 skill body 预览。
• 没有手动刷新按钮，也没有 skills/change 订阅。
• 列表按当前会话获取；当前导航指向 subagent 时显示空状态。
• 分离会话会短暂重试，然后显示 retry action，而不是原始 session-not-found 诊断。
• 安装前应按当前 dsh 进程权限检查源码与 MIT 许可证。

链接¶

• 社区目录：检索 @winterchenhuan/dsh-skills-viewer
• GitHub：https://github.com/winterhuan/dsh-skills-viewer