工作流技能包 CH3SH-LC/dsh-skill-packdge

dsh-skill-packdge

DeepSeek Harness 的 packdge 技能提供器插件：把「技能 + hooks + 工具 + 数据」按工作流打包成一个目录（packdge），自动发现并注册为
{packdge}-{skill} 形式的技能，多个 packdge 并行共存不重名。

什么是 packdge

一个 packdge = 一个工作流目录：

myworkflow/
├── packdge.json # 清单：{ "name": "myworkflow", "description": "..." }，name 必须等于目录名 ├── skills/ # 普通 DSH 技能包（SKILL.md，frontmatter 必须有 description） ├── hooks/ # 会话钩子（可选） ├── config/ # 工作流配置（可选） ├── docs/ # 工作流文档（可选） └── tools/ # 工作流脚本/工具（可选）

注册后每个技能名为 myworkflow-<skill>；技能正文通过 resourceBase 定位到 packdge 内的资源目录，因此技能可以引用 hooks/tools/config 里的相对路径资源。

安装

1. 把插件链接进 web profile：

dsh plugin --profile web add .

或手动将本目录链接到 $DSH_HOME/profiles/web/node_modules/dsh-skill-packdge。

2. 在 $DSH_HOME/cordis.patch.yml 中加入：

- insert:
- id: dsh-skill-packdge
name: dsh-skill-packdge

3. 放置你的 packdge：默认扫描 $DSH_HOME/packdge/（用户根）与项目 .dsh/packdge/（项目根），也可通过 customPackdgeDirs 指定额外根。

4. 重启 dsh web（或刷新页面）后生效。

配置

| 字段 | 默认 | 说明 |
| providerName | packdge | 注册到技能注册表的 provider 名 |
| includeDefaultRoots | true | 是否扫描项目与用户默认 packdge 根 |
| dshHome | $DSH_HOME 或 ~/.dsh | harness 配置根（用户 packdge 根为 <dshHome>/packdge） |
| customPackdgeDirs | [] | 额外 packdge 根（优先级在项目根与用户根之间） |
| enabledPackdges | [] | 仅允许这些 packdge 贡献；空列表 = 全部 |
| disabledPackdges | [] | 排除这些 packdge（与 enabled 重叠会被拒绝） |
| watch | true | 监听 packdge 根变化，实时刷新目录 |
| watchUsePolling | false | 使用轮询代替原生文件事件 |
| watchStabilityThresholdMs | 200 | 文件变更稳定阈值 |
| watchPollIntervalMs | 100 | 稳定性/轮询探测间隔 |
| watchFollowSymlinks | true | 是否跟随符号链接 |
| refreshSpecialSkillsIndex | true | 对自带 config/special-skills.json 的 packdge 刷新其 inventory 段（宿主平面执行，保留其余字段，仅内容变化时写入） |

与官方 @deepseek-ai/dsh-skill-packdge 的关系

本插件是 packdge 机制的开源独立版：同一份提供器代码，包名与仓库独立。

- 注册表为每个技能附加 group = packdge id，供 UI 分组；该字段需要带 packdge 支持的 harness 构建（官方版本上会被忽略，技能照常注册为扁平列表）。
- /skill、/packdge 层级斜杠菜单属于 harness UI 侧能力，需要对应 UI 支持，本插件不包含。

开发

pnpm run typecheck # tsc --noEmit
pnpm run build # tsc 类型产物 + tsdown 运行时产物
pnpm run test # vitest（含真实 Loader 组合测试）

许可证

MIT