dsh-skillhub

列出已经在磁盘上的 Skills：Agent home ~/.agents/skills 和 DSH home $DSH_HOME/skills。设置页管 Global Defaults，composer 面板管 Project 和 Chat 覆盖。

它不安装、不复制、不删除 skill 文件。关掉只是不进目录，文件夹还在。Host 插件技能出现在 Host plugins 下。关掉会占用目录名，避免它们再填进 <available_skills>。

词表见 CONTEXT.md。决策见 docs/adr/。

本机数据

内容	位置
Installed Skills	~/.agents/skills, $DSH_HOME/skills
可见性文档	$DSH_HOME/skillhub/（global.json, projects/<hash>.json, sessions/<id>.json）

项目可见性按本机文件夹哈希。不会写进 git 仓库。生效顺序是 Chat → Project → Global。Project 和 Chat 只存覆盖，父层改了，还在跟随的子孙立刻跟上。

可见性文档是 version 2：一层默认值，再加每条 Skill 的覆盖。Global「全部关闭」也会罩住以后新加的磁盘 Skill。旧 Session 快照保持显式，直到用户选 Follow parent for all。

不要提交 $DSH_HOME/skillhub/、.env、.dshx/，也不要提交编好的 lib/。client bundle 会嵌进本机绝对路径。

安装

克隆进 Harness 的 my-plugins/，或加一条指向这份检出的 file: 依赖。

pnpm --dir my-plugins/dsh-skillhub install --ignore-workspace
pnpm --dir my-plugins/dsh-skillhub test
pnpm --dir my-plugins/dsh-skillhub build
dshx check dsh-skillhub
dshx activation-plan dsh-skillhub --change new-client
dshx activate-new-client dsh-skillhub --profile web --port <live-web-port>

出现 CLIENT_MANIFEST_PRESENT 之后刷新 WebUI。不要再把这个 id 写进 dsh.profile.bundles。

Host HTTP 是 /skillhub/catalog。官方 /plugins 前缀只服务 client bundle，不要让它接管这个 API。

在 Web 上关掉 preset 里的 skill-filesystem 行，项目 skill 文件夹才会保持惰性。dsh-web-app 里的 host skill-filesystem 行已经关掉。

许可

MIT。见 LICENSE。