dsh-skills-manager

Skills Manager 1.1.10 统一管理本机与项目 Skills，新增从公开 GitHub 仓库安装、预览更新和备份回退，并扩展到 20 多种 Agent 技能目录。

• DSH 0.2.0-rc.2（必需）：1.1.10 的 DSH peer 是精确版本列表，包含 0.2.0-rc.2，不含 0.2.1-alpha.1；Node.js 需要 ^22.19.0 或 >=24。
• Skills 与 Profile 备份（必需）：备份 DSH_HOME 下的 skills 与 skills-manager 目录、项目 .dsh/skills，以及 profiles/web 下的 package.json、cordis.patch.yml 和 pnpm-lock.yaml。
• 仅本机访问的 DSH（必需）：技能路由没有身份认证，只校验请求来源。保持 DSH 默认的 127.0.0.1 监听；需要远程访问时先在部署层加认证。
• 可信的技能来源（必需）：安装或启用前逐篇阅读 SKILL.md 和随附脚本；仓库技能来自第三方 GitHub 仓库，插件不校验发布者。
• 能访问 GitHub 与 npm 的网络（可选）：只有使用技能仓库（codeload.github.com）或检查插件更新（registry.npmjs.org）时需要；不需要任何账号或 Token。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

@michengai/[email protected]

1.1.10 声明的 DSH 版本是精确列表，包含 0.2.0-rc.2，不含 0.2.1-alpha.1。本页固定 DSH 0.2.0-rc.2，Node.js ^22.19.0 或 >=24。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add @michengai/[email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @michengai/dsh-skills-manager或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @michengai/dsh-skills-manager

设置 → 技能

全局技能、项目技能、技能仓库、回收站四个页签；浏览、启停、创建、导入、从仓库安装和更新都在这里操作。插件没有 cordis.patch.yml 条目配置字段。

$DSH_HOME/skills-manager/state.json

保存按来源和按技能的启停策略，不改写来源正文。文件损坏时所有技能会被停用并锁定写入。

$DSH_HOME/skills-manager/repositories.json

保存已添加的 GitHub 仓库、上次扫描到的技能列表，以及每个仓库技能的安装来源、内容快照和备份记录。

$DSH_HOME/skills

创建、导入和仓库安装的技能统一写入这里；项目技能只能创建到当前会话项目的 .dsh/skills。

npx --yes @deepseek-ai/[email protected] plugin --profile web add @michengai/[email protected]
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

owner/repo
https://github.com/owner/repo
https://github.com/owner/repo/tree/<分支或标签>/<技能子目录>

1. 停止正在运行的 DSH 后执行安装命令，再运行 npx --yes @deepseek-ai/[email protected] web 并刷新浏览器，打开设置 → 技能。
2. 先在全局页签按来源查看列表，停用不打算让 DSH 使用的来源；来源默认全部启用，启停只写 manager 策略，不改其他 Agent 的源文件。
3. 切到项目页签，核对当前会话项目里被识别的目录；在不熟悉的仓库中开会话前，先停用其中的项目来源。
4. 使用技能仓库时，添加仓库后先点查看详情读完 SKILL.md，再逐项安装；安装会写入全局 DSH Skills 并自动启用。
5. 不要把标题区的检查更新当成固定版本升级：它会安装当时 npm 的最新版。需要可回退组合时使用本页的精确版本命令。

1. 01
   在输出中查找 id: skills-manager 条目。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：合并配置中只有一个 skills-manager 条目，name 为 @michengai/dsh-skills-manager。

2. 02
   停用一个测试 Skill 并刷新列表。

   期望结果：state.json 更新，来源 SKILL.md 内容不变，界面显示已停用而不是已卸载。

3. 03
   在全局页签创建一个最小测试 Skill，移入回收站后再恢复。

   期望结果：技能目录出现在 DSH_HOME 的 skills 下，删除后进入 skills-manager/trash，恢复后回到原位置。

4. 04
   添加一个你自己的公开测试仓库，刷新后安装其中一个技能，再查看全局页签。

   期望结果：技能显示仓库来源链接并处于启用状态；repositories.json 出现对应安装记录，同名技能不会被覆盖。

• 搜索一个测试 Skill，阅读完整正文和诊断，只修改它的启停状态。
• 对一个从仓库安装的测试技能点刷新并检查更新，在预览里查看新增、修改和删除的文件，先不确认替换。

读取 21 个用户级和 17 个项目级技能目录，可列出宿主任意路径下的子目录名；向 DSH Skills 写入创建、导入和仓库安装的技能，整目录替换更新，回收站可永久删除；宿主进程从 GitHub 下载仓库 ZIP；一键更新会启动安装进程并修改当前 Profile 依赖。

数据存储：启停策略在 $DSH_HOME/skills-manager/state.json；仓库订阅和安装记录在 repositories.json；下载的仓库 ZIP 缓存在 repository-cache，更新前的旧版本保存在 repository-backups 且不自动清理；删除的技能进入 trash；上传导入的临时文件在 uploads，完成后删除；操作日志写入 $DSH_HOME/dsh-skills-manager.log（含技能名和本机路径）。可写技能在 DSH_HOME 的 skills 和项目 .dsh/skills。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

安装时提示与当前 DSH 版本不兼容

1.1.10 只接受列表中的 DSH 版本，包含 0.2.0-rc.2，不含 0.2.1-alpha.1。核对正在使用的 DSH 版本，不要用版本豁免参数强行安装。

设置页空白或启动日志出现 duplicate prefix route

这是作者在 1.1.9 修复的路由残留问题；确认安装的是 1.1.10，完全停止 DSH 后再启动。

请求返回 403 forbidden host

访问地址不是回环地址或 DSH 信任的主机。回到本机地址访问，或在 DSH 侧配置信任主机；不要修改插件的来源校验，并记住这项校验不等于身份认证。

仓库刷新失败或提示归档超过 32 MiB

只支持公开 GitHub 仓库，指定子目录也要下载整库；检查到 codeload.github.com 的网络，或换用体积更小的仓库。扫描失败会保留上次的列表。

提示扫描缓存缺失或损坏

对该仓库重新点刷新并检查更新，再执行安装或更新；不要手动改动 repository-cache 里的文件。

一键更新不可用或返回 403

一键更新只接受本机回环的同源请求，并且需要识别到 DSH CLI 或 Desktop 安装服务。改用本页的精确版本安装命令。

找到技能但当前会话没有使用

检查实际生效的来源、项目页签是否对应当前会话，以及同名副本是否被停用；要彻底关闭一个技能需要停用它的全部副本。