前言¶
在 DSH 里装过不少 skill 之后，常见情况是：名字记得不全、描述记不清、某条 skill 到底允许模型还是用户调用也要翻配置或目录。社区目录和 GitHub 能查到仓库说明，但和「当前这台机器、当前 profile 实际加载了哪些 skill」并不总是一致。若只想在客户端里按名称或描述筛一遍，并直接打开对应 SKILL.md 原文，而不做安装、编辑或调用 skill，就需要一个只做「列表 + 阅读」的轻量工具。
下面介绍社区插件 dsh-skill-peek（维护者 bona11122，分类：客户端）。它以侧栏面板形式接入 DSH Web 客户端，仅检索与查看 SKILL.md，不做其它能力扩展。
这是什么¶
dsh-skill-peek 是 DeepSeek Harness 的客户端 bundle 插件：两个代码文件、零第三方依赖、不需要构建。打开左侧面板中的「技能速览」，即可按来源分组浏览本机已加载的 skills，并在右侧阅读 SKILL.md 全文及相关元信息。
- 目录页：https://www.skillhub.cn/plugins/bona11122/dsh-skill-peek
- 源码与说明：https://github.com/bona11122/dsh-skill-peek
- 许可证：MIT（见仓库
LICENSE） - 当前 package 版本：
0.1.1（以仓库package.json为准）
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。本文安装与用法均来自上述仓库 README，未使用 dsh plugin add github:… 一类未在资料中出现的命令。
核心功能¶
资料中明确列出的能力如下。
分组与折叠¶
技能按来源分组：项目 / 自定义 / 运行时 / 用户 / 内置 / 其他。点击分组标题可折叠；输入搜索条件时相关分组会自动展开。
检索¶
支持按名称或描述即时过滤；按 Esc 可清空搜索框。
权限展示¶
每一行显示 模型 / 用户 两枚徽章；不可调用的项以灰色虚线加删除线样式区分。
原文视图¶
右栏展示来源、provider、路径、描述、「何时使用」以及 SKILL.md 全文。若某 skill 在运行时注册但没有可读文件，界面会提示「没有可读的 SKILL.md」。项目类 skill 的路径按当前活动会话的工作目录解析。
分栏布局¶
可拖动分隔条调整左右宽度；双击分隔条恢复默认 340px 宽度；面板聚焦后可用方向键微调宽度。
宿主 HTTP 接口（仅 loopback）¶
插件在宿主侧注册两条只接受本机访问的路由，非 loopback 请求返回 403：
| 路由 | 返回 |
|---|---|
GET /api/skill-peek/list |
技能数组：名称、描述、来源、路径、调用权限 |
GET /api/skill-peek/read?name=&level= |
单个 SKILL.md 全文 |
安装与启用¶
需要 DSH Web profile，且引擎版本 >= 0.2.1-rc.3（README 与 package.json 中 dsh.engines 一致）。
方式一：手动写入 profile¶
在所用 profile 的 package.json 中，将本仓库作为本地 link 依赖，并加入 dsh.profile.bundles：
{
"dependencies": { "dsh-skill-peek": "link:<本仓库绝对路径>" },
"dsh": { "profile": { "bundles": ["…原有的一串…", "dsh-skill-peek"] } }
}
将 <本仓库绝对路径> 换成本地 dsh-skill-peek 目录的绝对路径；bundles 数组在保留原有条目基础上追加 "dsh-skill-peek"。
重启 DSH 后，左侧面板列表中应出现 「技能速览」。
方式二：使用仓库内安装脚本¶
在仓库根目录执行（资料原文）：
node tools/install-profile.mjs
脚本会创建 junction、写入上述 dependencies 与 bundles；默认 profile 目录为 ~/.dsh/profiles/desktop，可用第一个命令行参数覆盖该路径。撤销安装：
node tools/uninstall-profile.mjs
典型用法¶
- 按上一节完成安装并重启 DSH。
- 在 Web 客户端左侧面板打开 「技能速览」。
- 在搜索框输入 skill 名称或描述片段，列表即时过滤；需要时按
Esc清空。 - 点击左侧某一 skill，在右侧查看路径、权限徽章与
SKILL.md全文。 - 需要对比左右栏宽度时，拖动分隔条；双击分隔条回到 340px。
若要以 HTTP 自检（仍须本机 loopback），可对照 README 中的 GET /api/skill-peek/list 与 GET /api/skill-peek/read?name=&level=；日常以侧栏 UI 为主即可。
维护者在 README 中还提供了开发侧命令（非最终用户必跑）：
node tools/smoke.mjs # 宿主路由 + UI 渲染 + 折叠 / 搜索 / 分隔条
node tools/dump-preview-data.mjs # 刷新 preview/data.js
适用场景与注意¶
适合谁： 已在 DSH Web 环境使用多来源 skills、需要快速确认「本机当前加载了哪些 skill、各自 SKILL.md 写什么、模型/用户能否调用」的开发者；不需要在插件内改 skill 或触发 skill 执行的场景。
运行与权限： 插件随当前 DSH 进程与 profile 加载，列表与读文件行为受宿主权限与工作目录影响；安装前建议浏览 GitHub 源码并确认 MIT 许可证是否满足你的合规要求。
范围边界： 插件只做检索与阅读，不包含 skill 安装、编辑、marketplace 集成等能力；与 SkillHub 目录页信息互补，但不替代对仓库本身的审计。
结尾¶
dsh-skill-peek 把「本机 skills 清单 + SKILL.md 原文」收进侧栏，分组、搜索、权限徽章和分栏阅读都在同一面板完成，依赖少、无需构建。若你正在 Web profile 下维护较多 agent skills，可先按 README 写入 bundle 或跑 install-profile.mjs，再从「技能速览」核对实际加载情况。
