dsh-skills-manager

Skills Manager 1.2.33 集中扫描用户与项目技能,支持 ClawHub/skills.sh 发现、Git 仓库安装、分类、导入、回收站与备份恢复,并可按来源仓库浏览;可写 DSH、Shared Agent 和已登记项目的技能目录。

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
较高
适合新手
建议具备相关经验
兼容状态
声明兼容,尚未实测
验证状态
源码已审阅,未标记运行实测
本页目录(9)
中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 dsh-skills-manager 安装与配置教程 →
功能

这个插件能做什么

Skills Manager 1.2.33 集中扫描用户与项目技能,支持 ClawHub/skills.sh 发现、Git 仓库安装、分类、导入、回收站与备份恢复,并可按来源仓库浏览;可写 DSH、Shared Agent 和已登记项目的技能目录。

适合谁

需要Git、版本控制、提交能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。

准备

安装前准备

  • DSH 0.2.2-rc.1 与 Node.js(必需):1.2.33 声明的 engines.dsh 仍为 >=0.2.0-rc.1 <0.3.0-0,按官方 engines 优先规则接受 0.2.1-rc.5 与 0.2.2-rc.1;作者测试组合扩到 0.2.1-rc.4、0.2.1-rc.5 和 0.2.2-rc.1,这是作者声明,不是本站运行结果。插件 Node.js 要求 ^22.19.0 || >=24.0.0,本页命令固定 DSH 0.2.2-rc.1,宿主还要求 Node.js ≥24.9.0。仅静态复核,未运行验证。
  • 独立测试环境与状态备份(必需):使用独立 web Profile、不含敏感数据的测试工作区;升级前停止 DSH,备份 Profile、插件状态与受影响文件。
安装

如何安装 dsh-skills-manager

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

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

安装到
web Profile
DSH 基线
0.2.2-rc.1
安装来源
npm 预构建包(锁定版本)
固定目标
@michengai/[email protected]

E1 已静态复核 1.2.33(480df04d6eb4)的固定源码与发行物,本文命令固定 DSH 0.2.2-rc.1;只代表静态审阅,不是插件运行通过。仍在 DSH 0.2.1-rc.5 的环境保留升级前组合,不与新版交叉混装。

  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
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除
npx --yes @deepseek-ai/[email protected] plugin --profile web remove @michengai/dsh-skills-manager
配置

插件专属配置

$DSH_HOME/profiles/web/cordis.patch.yml
同一 Profile 的插件 Loader 行配置;备份整个配置和依赖/锁文件。
$DSH_HOME/skills-manager
state.json、roots.json、repositories.json、缓存、备份、回收站和安装身份,需要整体备份。

锁定插件自更新(不关闭市场或仓库网络) · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 锁定插件自更新(不关闭市场或仓库网络) 配置
- id: skills-manager
  config:
    updater: false

核对配置证据(外部链接,在新标签页打开)

只使用自己的公开测试仓库 · text。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 只使用自己的公开测试仓库 配置
owner/test-skills
https://github.com/owner/test-skills/tree/<固定标签>/<技能子目录>

核对配置证据(外部链接,在新标签页打开)

  1. 下列为待执行的隔离验证步骤,52DSH 本轮未安装或运行插件。
  2. 停止旧进程,按精确版本命令更新,再导出同一 web Profile 的组合配置。
  3. 先锁定 updater:false,逐项核对用户/项目/自定义来源及新增来源是否启用。
  4. 确认写入目标是测试 DSH、Shared Agent 或已登记工作区;先浏览内容,不直接批量安装发现页技能。
验证

配置检查与成功结果

  1. 01
    核对包版本、宿主和唯一挂载行;导出配置不算运行验证。
    复制验证命令
    npx --yes @deepseek-ai/[email protected] --profile web --dump-config

    期望结果:出现 @michengai/dsh-skills-manager 对应插件行,未重复挂载。

  2. 02
    在隔离环境创建一个无敏感内容的测试技能,核对目标目录后移入回收站并恢复,不永久删除。

    期望结果:SKILL.md 位于所选测试根,移入回收站后保留身份,恢复后文件与来源记录一致;本站未执行该验证。

使用

第一次使用建议这样验证

  • 只读打开一个已知测试技能,检查实际来源、路径、启停状态与完整正文,再决定是否导入。
权限

它可能接触哪些数据和能力

执行本机命令使用服务凭据写入本地文件

扫描用户、已登记项目和自定义来源,能写入/删除 DSH 与 Shared Agent 技能,执行整目录更新、回收恢复及永久清理。通用 HTTP(S) Git 仓库可启动本机 Git 子进程,继承进程环境与 Git 配置;插件自更新器可修改 Profile 并发起安装。在线更新开关只控制插件自更新,不禁止市场查询或仓库网络访问。插件注册 Agent 工具 create_skill,可在 DSH_HOME/skills 新建技能;默认由插件发起审批,1.2.31 起会话为 danger-full-access 时插件跳过审批直接写入。

数据存储:DSH_HOME/skills-manager 中保存 state.json、roots.json、repositories.json、repository-cache、repository-backups、trash 与导入临时状态;技能文件位于 DSH、Shared Agent 或已登记项目根,日志可包含本机路径。 面板还会只读各来源根的 .skills-lock.json 与技能目录内的 _skillhub_meta.json/_meta.json 用于按仓库分组,不写入这些文件。

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

排查

故障排查与数据清理

升级后新来源自动出现或启用
version 1 迁移可补齐新来源键,逐项复查,不能认为旧启停策略覆盖新增来源;损坏状态先备份再修复。
仓库导入失败、更新冲突或恢复失败
保留安装意图、缓存与备份,检查写入权限和本地修改,按错误重试;不要手工改 repositories.json 或永久清空回收站。
接口认证失败或更新按钮消失
使用本页固定的 DSH 版本(Connection 路径)。日志出现 Skills Manager routes require authenticated connection.fetch 或 Plugin updater requires authenticated connection.fetch,说明宿主没有提供该服务;1.2.32 起不存在可降级的旧 webServer 桥接。updater:false 仍锁定关闭自更新。
卸载后的清理步骤
  1. 停止 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @michengai/dsh-skills-manager,重启并检查入口已消失。
  2. 回退恢复升级前整套 Profile 与插件状态/文件备份;卸载不自动撤销文件写入或外部授权。
深入审计:兼容性、数据流与来源
证据

兼容性与审阅记录

兼容性说明

1.2.33 声明的 engines.dsh 仍为 >=0.2.0-rc.1 <0.3.0-0,按官方 engines 优先规则接受 0.2.1-rc.5 与 0.2.2-rc.1;作者测试组合扩到 0.2.1-rc.4、0.2.1-rc.5 和 0.2.2-rc.1,这是作者声明,不是本站运行结果。插件 Node.js 要求 ^22.19.0 || >=24.0.0,本页命令固定 DSH 0.2.2-rc.1,宿主还要求 Node.js ≥24.9.0。仅静态复核,未运行验证。

数据流

技能正文与路径 → 本机管理状态和 Web 面板;搜索词发往 clawhub.ai 或 skills.sh,GitHub ZIP 或通用 Git 主机内容下载到本机缓存并按确认写入技能目录。roots.json、state.json、repositories.json、备份和回收站保存在 DSH_HOME/skills-manager;管理 API 与插件自更新接口只经宿主 Connection 注册,宿主缺少该服务时只记录警告、不注册路由(失败关闭),1.2.32 起已无 webServer 兜底;面板还会只读各来源根的 .skills-lock.json 与技能目录内的 _skillhub_meta.json/_meta.json 用于按仓库分组,其中的链接来自本机文件内容。

源码审阅结论

2026-11-06 E1:从 09510fe0bdb5 升级到 480df04d6eb4,逐文件对照两版源码差异。npm SHA-512 与 integrity 一致,2 条 registry ECDSA 签名验证通过,provenance 声明的摘要与提交匹配,但未验证完整 Sigstore 信任链;53 个发行文件与固定提交逐字节一致。固定源码 151 个文件经 Git blob 校验。仅静态源码审阅,未安装或运行插件、未使用真实凭据,未独立重建产物。此前记录:2026-11-01 B2:重新下载 npm 1.2.26,SHA-512 与 integrity 一致,registry ECDSA 签名验证通过,gitHead、发行标签与固定提交一致,provenance 声明的摘要及工作流提交匹配但未验证完整 Sigstore 信任链。已审阅配置、会话/文件写入、网络、认证与迁移边界;仅静态源码审阅,未安装或运行插件、未使用真实凭据,未独立重建产物。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。

来源快照
08f3df46cca1
固定提交
480df04d6eb4
许可证
Apache-2.0
主要语言
JavaScript
中文资料
有完整中文配置资料