dsh-publish-plugin
English | 简体中文
把 DeepSeek Harness 插件一键发布到 npm + GitHub（双平台必发）的 DSH 插件：/publish-dsh-plugin 命令（人在 Web GUI / TUI 里直接操作）+ publish_plugin 工具（模型驱动）。两者共享同一个发布域，且都是 fail-closed：没有显式确认绝不执行。
安装
# 从 npm（推荐——已发布的包）
dsh plugin --profile web add dsh-publish-plugin
# 或从 git
dsh plugin --profile web add github:liulei237136/dsh-publish-plugin安装后 /publish-dsh-plugin 命令与 publish_plugin 工具同时可用（组合里有命令注册表时命令才注册，有工具注册表时工具才注册）。
命令面用法
① /publish-dsh-plugin → 发现当前会话目录（及向上/直接子目录）的插件候选
② /publish-dsh-plugin <插件名> → 校验 manifest + 冲突检查 + 动作汇总
③ /publish-dsh-plugin <插件名> yes → 执行（npm publish + GitHub 建仓/推送 + tag + topic）- 不带
yes永远只汇总不执行（fail-closed）； - 版本冲突（npm 上该版本已存在）时报错提示提升版本；包名/仓库已存在视为升级发布（发新版本、推已有仓库）；
- 执行前会再查一遍冲突。
工具面用法
对模型说"把这个插件发了"即可。模型调用 publish_plugin（参数 plugin_path 可选，默认当前会话目录），工具校验后展示动作汇总并经 ctx.approval 请求一次性确认——只有 allowed-once 才执行。发布完成后结果回到模型，可继续验证安装、写 CHANGELOG、处理失败。
前置条件
- Node.js + npm（发布机器）
ghCLI 已安装并登录（gh auth login；gh 在 host 启动之后安装的需要重启 host——PATH 是启动时快照）- npm 发布认证——npm 现在要求 2FA 或 bypass token（具体命令见下方 Troubleshooting）：
- 在 npm 账号上启用 2FA（auth-only 模式即可，发布不需要 OTP）；或 - 创建带 Bypass 2FA 的 Granular Access Token 并配置为认证 token
Troubleshooting（踩坑记录）
| 症状 | 原因与解决 |
|---|---|
npm error 403 Forbidden - PUT ... - Two-factor authentication or granular access token with bypass 2fa enabled is required to publish packages | npm 要求启用 2FA 才能发布。在账号启用 2FA（npm profile enable-2fa auth-only，发布无需每次 OTP），或在 https://www.npmjs.com/settings/<你的账号>/tokens 创建带 Bypass 2FA 的 Granular Access Token，然后 npm config set //registry.npmjs.org/:_authToken=<token> |
npm error ENEEDAUTH: need auth ... You need to authorize this machine using npm adduser | 未登录：执行 npm login，或设置 NPM_TOKEN（环境变量；新设环境变量需要重启 host） |
GitHub 仓库：gh 未登录（检查失败） | 执行 gh auth login；如果 gh 是在 host 启动之后安装的，需要重启 host（PATH 是启动时快照） |
| 命令/工具不可见，或改动不生效 | bundle 层不热重载（只有用户 profile 的 cordis.patch.yml 热重载）。安装或修改 bundle 后请重启 web profile |
从 git 安装时 pnpm 拦截 prepare | pnpm ≥10 需要在 profile 的 pnpm-workspace.yaml 放行构建脚本（pnpm 会打印具体 key，dsh plugin 也有提示） |
说明
- 发布是同步等待子进程（npm publish / gh 可能耗时较长），期间 UI 等待结果，可用取消信号中断；Windows 上取消信号只终止 npm/gh 的 cmd 包装进程，其子进程可能残留，必要时手动清理；
- 部分失败会明确报告"已完成哪些步骤"，剩余步骤需手动收尾（例如 npm 已发布但 GitHub 失败）；
- 发布前会先做 git 预检（脏工作树 / remote 不匹配直接拒绝），因此这类失败不会产生任何副作用——插件绝不改 remote、绝不自动提交；
- 工具面在无
ctx.approval的组合中拒绝执行（fail-closed）； - 发布后给出的安装命令使用
--profile web，因为dsh plugin必须指定 profile；读者按自己的 profile（如tui）替换即可。
---
维护者请看 CONTRIBUTING.md（本地开发、测试与自举发布流程），固定决策与实现说明在 docs/design.md。