DeepSeek Harness 插件

gezi-wen/dsh-plugin-development

Star 数 ★ 0 下载量（近 30 天） 870 分类 技能包 收录于 2026-09-15 npm dsh-plugin-development

携带一份技能，讲怎么开发、调试、发布 DSH 插件——host/client 双半包骨架、把 fork 挂进丢弃式 profile 开发、发布到 GitHub 与 npm，以及发布过程中实际踩到的坑。安装插件即注册该技能。

安装

# npm 包（预构建）

dsh plugin --profile web add dsh-plugin-development

# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）

dsh plugin --profile web add github:gezi-wen/dsh-plugin-development

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络，工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截，所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS；dsh 会打印出需要添加的确切键名，把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下，重跑一次即可装上。放行构建本身就是一次信任判断：请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。

README

一个 DSH 插件，内容只有一份技能：安装时把包内的 skills/ 注册为一个技能根，于是这份技能随插件进入 agent 的技能目录。

dsh plugin --profile web add dsh-plugin-development

技能覆盖什么

  • 双半包骨架：package.json 的必要字段（main / exports["./client"] / dsh.bundle.patch / dsh.client）、cordis.patch.yml、手写的 ModuleLoader client 半
  • 对着 fork 开发：把 fork link 进一个丢弃式试验 profile，三级验证（配置组合 → 模块解析 → 真执行），以及 dsh plugin 与 profile 的关系
  • 发布与上线：推 GitHub / 发 npm，把新版本部署到正在运行的 profile 而不碰它的安装状态
  • 坑清单：包括宿主插件跑 PowerShell 子进程才会遇到的三个（AMSI 拦胖脚本、stdout 编码、编译缓存失效），以及「插件装了但界面不出现」的排查链

布局

package.json        # dsh.bundle.patch → cordis.patch.yml
cordis.patch.yml    # 插入一行 @deepseek-ai/dsh-skill-filesystem，customSkillDirs 指向 skills/
skills/
  dsh-plugin-development/
    SKILL.md
    REFERENCE.md

cordis.patch.yml 用的机制和 DSH 自带 agent preset 装载自己的技能是同一套：!!js 里的 baseUrl 解析到本包，所以路径跟着安装位置走。

License

MIT

内容来自项目 README（GitHub）↗

链接

GitHub 仓库 ↗ npm 包 ↗ 通过 dsh-market 安装 ↗

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus；发表内容需要 GitHub 账号。