前言¶
在 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，再從「技能速覽」覈對實際加載情況。
