DSH 与 SkillHub 技能市场
dsh-withskillhub 是 DeepSeek Harness 的独立插件。它把 SkillHub 的公开技能市场放进 DSH 网页端的“设置”侧边栏，让你不用离开 DSH 就能浏览、查看、下载、启用和更新技能。
这个插件只管理它自己下载的技能，不会改动你手工创建的 DSH 技能，也不会改动 DeepSeek Harness 本体代码。
你可以做什么
- 按下载量、分类或关键词浏览 SkillHub 技能。
- 点击技能查看完整概述、下载量、收藏量、版本、作者和分类。
- 一键将技能下载到本机的共享技能目录。
- 为需要 API Key 的技能直接跳转到 SkillHub 查看配置说明。
- 在“技能管理”中启用、停用、删除技能，或检查并安装最新版。
- 在下一次对话中，把已启用的本地技能提供给 AI 使用。
页面预览
技能市场会默认显示下载量较高的技能。你可以搜索、筛选分类，或者点击右上方的“前往 SkillHub”打开官网。
点击任意技能后，详情从右侧滑出。概述来自该技能发布包中的 SKILL.md 正文，而不是只有一两句简介。
开始前需要准备什么
- 已经能够在本机运行 DeepSeek Harness 的网页端。
- 已安装 Node.js 和 pnpm。
- 已把本仓库下载到 DeepSeek Harness 仓库旁边。下面的示例目录结构是：
D:\harness-lh-int8\
├─ deepseek-harness-master\
└─ dsh-withskillhub\
如果你的目录不同，不需要照抄盘符；只要在添加插件时把 ..\dsh-withskillhub 改成实际路径即可。
第一次安装
推荐方式：从 GitHub 直接安装
在 DeepSeek Harness 所在目录执行：
dsh plugin --profile web add github:lhwu1/dsh-withskillhub
dsh web --port 3080
首次从 GitHub 安装时，如果 DSH 提示需要允许构建，请按提示在允许构建列表中加入 dsh-withskillhub: true 后重新执行安装命令。只为你信任的仓库授予构建权限。
从源码安装：第一步，下载插件代码
在 DeepSeek Harness 仓库的同级目录执行：
git clone https://github.com/lhwu1/dsh-withskillhub.git
从源码安装：第二步，安装插件依赖并构建
进入插件目录后执行：
cd D:\harness-lh-int8\dsh-withskillhub
npm install
npm run build
npm install 会下载插件需要的依赖；npm run build 会生成 DSH 运行插件所需的文件。
从源码安装：第三步，把插件加入 DSH 网页配置
进入 DeepSeek Harness 仓库后执行：
cd D:\harness-lh-int8\deepseek-harness-master
pnpm dsh plugin --profile web add ..\dsh-withskillhub
这一步只会向 web 配置加入插件行，不会修改 packages/ 中的 Harness 源码。
从源码安装：第四步，启动网页端
仍在 DeepSeek Harness 仓库中执行：
pnpm dsh web --port 3080
浏览器打开 http://127.0.0.1:3080。进入左下角“设置”，侧边栏中应该会出现“技能市场”和“技能管理”。
如何使用技能市场
- 打开 DSH 网页端，进入“设置” → “技能市场”。
- 默认列表按下载量排序。可以在搜索框输入关键词，也可以选择分类或“最近更新”。
- 点击一条技能记录，右侧会打开技能详情。
- 阅读“概述”、版本、作者和统计信息；如果技能标记为“需要 API Key”，点击旁边链接到 SkillHub 获取配置说明。
- 点击“一键装配”。下载完成后会显示已装配状态。
- 回到正常对话并发送下一条消息。已启用的技能会在这次新请求中向 AI 开放。
技能市场只用于浏览和下载。整个远程市场列表不会直接放进 AI 的上下文，因此不会因为市场条目很多而占用对话空间。
如何管理已经下载的技能
打开“设置” → “技能管理”，这里会列出所有通过本插件装配的技能。
点击技能的名称或简介会从右侧打开详情。详情来自已下载到本机的文件，即使 SkillHub 暂时不可访问，仍然可以查看本地用途、完整 SKILL.md 概述和文件列表；联网时还会显示最新版本和更新日志。详情中的“在 SkillHub 查看”会打开技能来源页。
启用和停用
- 开关打开：技能会在下一次对话请求中提供给 AI。
- 开关关闭：技能保留在硬盘中，但不会提供给 AI。
- 重新打开开关即可恢复，不需要重新下载。
检测更新
点击“检测更新”后，插件会到 SkillHub 查询当前版本。
- 有新版本：自动下载并替换为最新版。
- 已是最新版：显示“已经是最新版本”。
- SkillHub 找不到该技能：显示“已下架”，但保留你本机的现有版本，方便你自行决定是否删除。
删除
点击“删除”会移除该技能的本地文件和安装记录。此操作不能从插件内撤销；之后仍可到技能市场重新装配。
技能保存在哪里
插件默认把技能保存到 DSH 的专用目录，而不是普通的用户技能目录。
未设置 DSH_HOME 时，Windows 默认位置是：
C:\Users\你的用户名\.dsh\skillhub\skills
如果你设置了 DSH_HOME 环境变量，则位置变为：
$env:DSH_HOME\skillhub\skills
目录大致如下：
.dsh\skillhub\skills\
├─ .dsh-withskillhub.json
├─ skillhub-发布者-技能名\
│ ├─ SKILL.md
│ └─ 其他由该技能提供的文件
└─ skillhub-另一个发布者-另一个技能\
└─ SKILL.md
.dsh-withskillhub.json 是插件的安装记录，保存技能来源、版本、安装时间和启用状态。不要手动修改它；请通过“技能管理”完成启用、停用、更新和删除。
停用技能时，插件会把该技能的入口文件 SKILL.md 临时改名为 .dsh-withskillhub-disabled.md。文件内容和附属资料都还在本机，重新启用后会自动恢复为 SKILL.md。
你自己放在 C:\Users\你的用户名\.dsh\skills 中的技能不由本插件管理，不会被删除、覆盖或混入 SkillHub 的安装记录。
常见问题
看不到“技能市场”和“技能管理”
确认第三步的添加命令执行成功，然后完全停止并重新启动 pnpm dsh web --port 3080。页面使用的是 web 配置，其他配置不会自动显示这两个入口。
已装配技能，但 AI 没有使用它
先到“技能管理”确认开关处于启用状态。然后新发一条消息或新开一次对话；技能列表在新的请求开始时刷新，不会回写到已经发送的消息中。
找不到本地技能文件
先检查是否设置过 DSH_HOME。没有设置时请到 C:\Users\你的用户名\.dsh\skillhub\skills 查找；设置过时请到 $env:DSH_HOME\skillhub\skills 查找。
技能详情里的概述显示不完整
概述由远端的 SKILL.md 提供。插件默认最多读取 256 KiB 并最多显示 20,000 个字符，避免超大技能文件拖慢页面；普通技能会显示完整正文。
提示正在显示上次成功获取的内容
这表示 SkillHub 当前无法连接、超时或返回异常数据，但插件保留了最近一次成功获取的市场内容。恢复网络后等待缓存时间结束，或者重新启动网页服务再刷新页面，即可重新请求最新数据。
技能需要 API Key，应该在哪里设置
在该技能详情中点击“前往 SkillHub 获取 API 配置”。不同技能的 API 服务商和配置方法不同，请以该技能在 SkillHub 中的说明为准。不要把 API Key 写入插件源码或提交到 Git 仓库。
可选配置
大多数用户不需要改配置。下面是插件可调整的参数，适合需要改变存储位置或下载限制的用户：
| 配置项 | 默认值 | 用途 |
|---|---|---|
apiBaseUrl |
https://api.skillhub.cn |
SkillHub 公开接口地址。 |
skillsRoot |
$DSH_HOME/skillhub/skills |
SkillHub 技能的专用存储目录。 |
maxFiles |
200 |
单个技能最多允许的文件数量。 |
maxPackageBytes |
26214400 |
单个技能所有文件允许的最大总大小。 |
requestTimeoutMs |
15000 |
每次请求 SkillHub 的最长等待时间，单位为毫秒。 |
cacheTtlMs |
300000 |
成功读取后保留市场、分类、详情和概述的时间，单位为毫秒。 |
staleCacheTtlMs |
86400000 |
SkillHub 暂时不可用时，允许继续显示过期缓存的最长时间，单位为毫秒。 |
maxOverviewBytes |
262144 |
用于详情概述的 SKILL.md 最大读取大小。 |
maxOverviewCharacters |
20000 |
页面中最多显示的概述字符数。 |
如果修改 skillsRoot，还必须同时把配置中的 dsh-withskillhub-filesystem.customSkillDirs 改为同一个目录；否则 DSH 找不到已下载的技能。
更新插件代码
当你从 GitHub 拉取了新的插件代码后，在插件目录执行：
npm install
npm run build
再进入 DeepSeek Harness 仓库执行：
pnpm dsh plugin --profile web update dsh-withskillhub
最后完全重启网页服务：
pnpm dsh web --port 3080
仅修改网页界面时，也可以在插件目录运行 npm run dev 进行开发时自动构建；涉及服务端路由、配置或插件包内容时，仍需要执行更新命令并重启网页服务。
开发者检查
修改插件后，在插件目录运行：
npm run validate
该命令会依次执行类型检查、单元测试和构建。
