技能中枢 xiatian-wuhan/dsh-skills-hub

Skills Hub · 技能中枢

看清每个 Skill 在模型上下文里到底花了多少，并把不需要的从目录里摘掉——文件不删。

它解决什么问题

Skill 不是免费的。它对上下文的影响有三层，而 DSH 只把结果给你、不把账单给你：

| 层 | 何时付费 | 现象 |
| 目录行 | 每一次请求 | 每个 skill 的 名称 + 截断后的介绍 都在系统提示里 |
| 目录副本 | 每次目录变更追加一份完整副本 | 改一次 skill，历史里就多一份完整目录，旧的不删 |
| 正文 | 模型调用 skill 时加载一次 | 之后永久留在历史里 |

Skills Hub 把这三层逐项量化，并给你一个不破坏文件的减负开关。

功能

- 真实目录成本：按 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.sh skills.sh/<owner>/<repo>/<skill>、GitHub github.com/<owner>/<repo>[/tree/<branch>/<path>]，文件由服务端拉取。
- 卸载：两步确认，仅删除该 skill 的文件，不影响插件本体。

本插件不注册任何模型工具或技能，自身对上下文的固定占用为 0 token。

安装

从 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。

通过插件市场索引

本仓库同时是一份 DSH 插件市场索引（format 1）。在 DSH 里 插件 → Discover → 索引源 → 添加 以下任一地址：

| 用途 | 地址 |
| 主地址（GitHub Pages） | https://xiatian-wuhan.github.io/dsh-skills-hub/index.json |
| 备用（raw，立即可用） | https://raw.githubusercontent.com/xiatian-wuhan/dsh-skills-hub/main/docs/index.json |
| 备用（jsDelivr 加速） | https://cdn.jsdelivr.net/gh/xiatian-wuhan/dsh-skills-hub@main/docs/index.json |

或让 agent 使用 plugin_market 工具检索该索引。发布新版本时运行 node scripts/make-index.mjs 更新索引（安装源会固定到该次提交）。

使用提示

- 打开面板先看顶部「目录成本 / 次请求」；点「按成本排序」找出最贵的 skill。
- 描述被标「截断」的 skill，模型只看到前 上限-3 个字符——把介绍写短比写全更有用。
- 长期不用又不想删的 skill，点「从目录隐藏」：成本归零，文件与 /名字 调用都保留。
- 「本会话已发布 N 次」数字越大，说明目录变动越多，历史里的目录副本也越多。

兼容性

- 需要 DSH ≥ 0.2.0（使用 ctx.shell 的 execute() 接口；0.1.x 的 run() 仍做了兼容）。
- Web 组合里 dsh-base 的全局 skill-filesystem / tool-skill 被 dsh-web-app 关闭，技能实际由 Agent 预设作用域提供。因此本插件按官方规则自行扫描 project / preset / user 各技能根，并与会话里已发布的目录交叉校验；若某部署的全局 ctx.skills 有内容，会自动作为覆盖层合入。

开发

生成市场索引（提交代码后运行，写入 docs/index.json）
node scripts/make-index.mjs

本地安装调试
dsh plugin --profile web add /absolute/path/to/dsh-skills-hub

仓库结构：index.js 是 Host 半区（HTTP 路由 + 扫描 + 成本计算），client.js 是浏览器半区（设置面板），cordis.patch.yml 声明要注入的服务。

Skills Hub 展示每个已安装技能在模型上下文中要花多少成本 —— 常驻的目录行、每次变更时追加的完整目录副本、首次使用时加载的正文 —— 并让你在不删除技能的前提下把它隐藏（disable-model-invocation）。它还会预览模型实际收到的目录消息（与 dsh-tool-skill 发布的字节完全一致），标出被目录上限截断的描述，并报告那些磁盘上存在、却从未进入目录的技能。

安装：dsh plugin --profile web add git+https://github.com/xiatian-wuhan/dsh-skills-hub.git，然后重启 dsh web，打开 Settings → Skills Hub。需要 DSH 0.2.0+。

License

MIT