前言¶
在使用 DeepSeek Harness（DSH）時，技能（Skill）對上下文的影響往往被忽視。每個 Skill 的目錄行、每次目錄變更追加的完整副本，以及模型調用時的正文加載，都會持續消耗上下文空間。現有方式只能看到結果，看不到成本，也難以在不刪除文件的情況下快速減負。
Skills Hub 把這三層影響逐項量化，並提供了不破壞文件的減負開關，讓開發者可以看清並控制每個 Skill 的上下文成本。
它是什麼¶
Skills Hub 是一個 DeepSeek Harness 插件，由 xiatian-wuhan 維護。它聚焦於「技能對模型上下文的作用」，展示每個 Skill 的目錄成本、正文成本、截斷與隱藏狀態，預覽模型實際收到的技能目錄，支持一鍵從模型目錄摘除（保留文件），並提供搜索、URL 導入與卸載能力。
核心功能¶
- 真實目錄成本：按 DSH 的渲染規則逐字計算（
- \name`: description，空白歸一化後按catalogDescriptionMaxLength` 截斷，默認 500 字符）。token 爲估算值（CJK ≈ 1.1/字，其餘 ≈ 4 字符/token）。 - 模型實際看到的目錄：面板給出兩個版本——本會話已發佈（從會話裏真實的
skill-catalog消息取出，與模型收到的那條逐字一致）與下次發佈預演（按當前配置推算，同樣逐字對齊 DSH 模板）。 - 目錄漂移告警：當前技能集合與會話已發佈的那份不一致時，提示「目錄已變更：+ / - / ~，下次請求將追加一份完整副本」。
- 一鍵減負：「從目錄隱藏」寫入
disable-model-invocation: true，文件保留、/名字仍可手動調用，但不再進入模型目錄，成本立刻歸零。 - 分類篩選：
全部/內置/第三方（內置 = 隨 DSH、插件或 Agent 預設安裝，只讀；第三方 = 裝在項目或用戶目錄，可改可刪），帶數量、可與搜索疊加。 - 爲什麼模型看不到它：DSH 對無效 frontmatter 是靜默跳過的。面板列出磁盤上存在卻沒進目錄的技能及原因（缺 frontmatter、name 非 kebab-case、布爾值非法、同名被高優先級目錄覆蓋）。
- 從 URL 導入：ClawHub
clawhub.ai/<owner>/<skill>、Skills.shskills.sh/<owner>/<repo>/<skill>、GitHubgithub.com/<owner>/<repo>/[tree/<branch>/<path>]，文件由服務端拉取。 - 卸載：兩步確認，僅刪除該 skill 的文件，不影響插件本體。
安裝與啓用¶
從 GitHub 安裝：
dsh plugin --profile web add git+https://github.com/xiatian-wuhan/dsh-skills-hub.git
固定到某個提交（可復現）：
dsh plugin --profile web add "git+https://github.com/xiatian-wuhan/dsh-skills-hub.git#<commit>"
安裝後重啓 dsh web，打開 設置 → Skills Hub。
典型用法¶
- 打開面板先看頂部「目錄成本 / 次請求」；點「按成本排序」找出最貴的 skill。
- 描述被標「截斷」的 skill，模型只看到前
上限-3個字符——把介紹寫短比寫全更有用。 - 長期不用又不想刪的 skill，點「從目錄隱藏」：成本歸零，文件與
/名字調用都保留。 - 「本會話已發佈 N 次」數字越大，說明目錄變動越多，歷史裏的目錄副本也越多。
適用場景與注意¶
適合需要精細管理技能上下文成本的開發者，尤其在使用大量 Skill 或對上下文長度敏感的場景。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
短結尾¶
Skills Hub 通過逐層量化技能的上下文成本，幫助你在不刪除文件的情況下靈活減負，適合需要精細控制上下文空間的 DSH 使用者。
