前言¶
在使用 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 使用者。
