@howillmakeit/skills-dsh
Howskills 合集的社区 DeepSeek Harness(dsh)集成包
实验性兼容开发者预览版 @deepseek-ai/dsh@0.1.0-rc.6，要求 Node.js ^22.19.0 || >=24.0.0。不承诺跨版本稳定。
这是什么
一个纯 Skill bundle：向 dsh 的 web profile 插入一个隔离的文件系统 Skill provider（providerName: howillmakeit-plugin，includeDefaultRoots: false），把本仓库的 skills（当前为 undress 技术工作去包装）暴露给 dsh。
约束与边界：
- 不注册原生工具；
- 不含 Web 客户端、遥测、网络访问、凭据处理；
- 没有
prepare/install/postinstall脚本。
工作原理
dsh 的插件树不是写死在一个配置文件里，而是由多层 patch 叠加组合出来的（profile bundle 机制）：内置 bundle 层（dsh-base、dsh-web-app…）→ 用户安装的第三方 bundle 层 → 用户 profile 自己的 cordis.patch.yml → 命令行 --patch overlay。本包就是其中一层 patch，完整链路如下。
第 1 步：安装，把包登记为 bundle 层
dsh plugin --profile web add @howillmakeit/skills-dsh@0.1.0dsh plugin 把参数转发给 web profile 目录内的 pnpm 安装本包，然后读取包的 package.json。由于包声明了 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }，dsh 识别出它是 profile bundle，自动把它追加进 profile manifest 的 dsh.profile.bundles 列表——下次启动时按 patch 层加载。
第 2 步：启动，patch 层组合
dsh 按 dsh.profile.bundles 顺序解析每个 bundle 声明的 patch 文件，与用户层、overlay 一起作用到空根上，得到最终插件树。本包的 patch（cordis.patch.yml）内容是一条 insert 指令，向插件树插入一个官方技能提供者插件行：
- insert:
- id: howillmakeit-skill-filesystem
name: '@deepseek-ai/dsh-skill-filesystem'
config:
providerName: howillmakeit-plugin
includeDefaultRoots: false
bundledSkillDir: <!!js 表达式，加载时求值，见下>第 3 步：加载，注册一个只看自己目录的 Skill 提供者
@deepseek-ai/dsh-skill-filesystem 是 dsh 官方包，职责是扫描本地目录里的 SKILL.md 并注册进 ctx.skills 注册表。base bundle 里已经有一个默认实例（providerName filesystem，负责 dsh 的项目/用户技能）；本包再注册一个唯一命名的实例 howillmakeit-plugin，并用 includeDefaultRoots: false 让它只扫描自己的根——不掺和 dsh 的项目/用户技能扫描，两个提供者互不干扰（官方 README 称此为"隔离提供方"模式）。
bundledSkillDir 的值是一个 !!js 表达式，插件行加载时在 dsh loader 上下文里求值（实际配置为单行，下面为便于阅读做了折行）：
bundledSkillDir: !!js process.getBuiltinModule('node:path').join(
process.getBuiltinModule('node:path').dirname(
process.getBuiltinModule('node:module').createRequire(baseUrl)
.resolve('@howillmakeit/skills-dsh/package.json')),
'skills')baseUrl是 dsh loader 上下文的属性，指向 profile 目录（pnpm 安装时本包就装在这里）；createRequire(baseUrl).resolve('@howillmakeit/skills-dsh/package.json')从 profile 目录解析出本包的真实安装位置；dirname(...)取包根目录，join(..., 'skills')指向包内的技能目录——即打进 npm tarball 的skills/。
这样技能根路径不写死，包装在哪都能正确解析。
第 4 步：技能被发现，进入模型的 tool catalog
skills/undress/SKILL.md符合 dsh 技能发现规范：一层深的<root>/<name>/SKILL.md，frontmatter 含 kebab-case 的name与description；- 提供者扫描并解析 frontmatter，注册进
ctx.skills注册表； @deepseek-ai/dsh-tool-skill把可调用技能渲染进模型的 tool catalog；- 之后模型侧按名字调用技能，技能通过 dsh 原生的 Skill、shell 和文件系统通道运行。
文件布局
| 文件 | 作用 |
|---|---|
package.json | npm 元数据 + 接入声明（dsh.bundle.patch 字段、files 白名单、engines） |
cordis.patch.yml | 方案核心：patch 层内容，插入 dsh-skill-filesystem 插件行 |
scripts/pack.mjs | 发版前把仓库根目录的 skills 同步到 ./skills 的构建脚本 |
skills/undress/SKILL.md | 真正的技能内容（frontmatter + 指令正文） |
skills/undress/agents/openai.yaml | OpenAI Agents SDK 风格接口文件，dsh 不读取，仅作其他宿主的兼容物 |
安装
dsh plugin --profile web add @howillmakeit/skills-dsh@0.1.0调用
让 dsh 按名字使用技能：
Use the undress skill to strip the packaging from this project:
what was reused, what was modified, what was implemented, what was verified.卸载
dsh plugin --profile web remove @howillmakeit/skills-dsh维护者发布流程
在本目录执行：
node scripts/pack.mjs # 把仓库根目录的 skills 同步到 ./skills
npm publish需要拥有 @howillmakeit npm scope。skills/ 是构建产物（已 gitignore），通过 files 列表打进 tarball。