dsh-web: Skill for Claude Code

dsh-web 发布（release / publish）

本技能固化 dsh-web 全家桶的完整发版流程：全仓统一版本（四个卫星仓先发同版本）→ 提交 → 打 tag → 推送触发 GitHub Actions 发布管线（构建/测试/npm 发布/GitHub Release）→ 发布后验证。

授权与按需入口

• 先区分任务，不因加载本技能而执行发版。 发布管线/配置修复、版本核对、兼容性审计只读取相关章节并执行已授权的检查或修复；修复完成后交付证据，不自动 bump、合入 main、创建/推送 tag、npm publish、创建/修改 GitHub Release 或触发发布 dispatch。
• 只有用户当前明确要求实际发布时才进入完整流程；目标版本未指定时才适用下一 patch 默认。token、NPM_PUBLISH_ENABLED、已有 tag、历史发布许可和 CI 全绿均不是当前发布授权。
• 坏版本调查先只读核实影响。deprecate、删除/重推 tag、补发、回滚和修改已发布说明须在当前明确授权范围内；越界则报告所需决定，不自行补救历史未经授权发布。
• 根规则管安全与常规 dev 同步；本技能只补充获授权的发布集成与发布后版本提交回流。切分支/整合前遵循共享 checkout 保护，先核对基线、索引及其他会话占用；命令块是步骤示例，不是可整段无条件执行的脚本。
• 审计自动升级读第 0 节；实际发布依次完成版本选择、卫星仓对齐发版、兼容门禁、dev 集成、main 发版与第 5 节验证；失败时读取第 4 节恢复规则。只改文档无需构建、迁移矩阵或发布动作。

仓库事实（先读，决定每一步怎么做）

• 仓库：zhu1090093659/dsh-web（PUBLIC），本机路径 /Users/zcl/code/dsh-web。
• 本仓家族包由 scripts/lib/family-packages.mjs 得到，版本与包数量以 node scripts/verify-version.mjs X.Y.Z 的输出为准，不在技能中手抄固定数量；全部发布到 npm scope @linxin666，registry 固定 registry.npmjs.org。
• 卫星仓（4 个）：皮肤中心、宠物、社区插件索引与预设中心拥有独立仓库 dsh-skins / dsh-pet / dsh-community-plugins / dsh-presets，各自持有 CI、门禁与 tag 发布管线，本仓以已发布的 npm 包消费它们；清单与市场 pin 的归属见 family-satellite Note。
• 卫星仓版本策略（从下一版本起，见第 2 节）：卫星仓不再各自持有版本线；每次发版四个卫星仓与本仓发同一个 X.Y.Z，且卫星先发、本仓后发。已有版本不追溯，对齐只从下一个版本开始。
• 版本策略：全仓统一版本（tag vX.Y.Z = 每个家族包与根别名包的 version，由管线强制校验）。
• 未指定具体版本号时：不追问版本号；以远端最新且已发布的正式 vX.Y.Z tag 为上一版本， 默认目标为下一个补丁版本 X.Y.(Z+1)。用户明确给出版本号，或明确要求 major/minor/prerelease 变更时，按该要求执行；远端 tag 与 npm 已发布版本不一致时，按下方失败恢复规则处理，不自行猜测。
• npm 不允许重复发布同一版本号：已发布过的版本号（如 0.1.3/0.1.4/0.1.5）不可重发， 只能 bump 到下一个版本。
• 发布通道：npm 发布全部由 GitHub Actions 管线完成，使用仓库 secret NPM_TOKEN （npm automation token，@linxin666 scope）；本机 npm 登录态不固定（无登录态时 npm whoami 401 属正常；本机当前以 linxin666 登录），发版不依赖本机登录态。
• npm 通道已恢复（2026-08-31 起）：release.yml 的 workflow env NPM_PUBLISH_ENABLED: 'true'；发布管线执行完整门禁、版本校验后运行 pnpm -r publish --tag latest 与 legacy 双发（均以该开关门控），发布后立即用 scripts/verify-registry.mjs 断言每个家族包的 tag 版本都能从 registry 解析 （带重试预算，覆盖 npm 传播延迟）。开关曾因家族跟踪未上 npm 的 @deepseek-ai/* alpha cohort 而被暂停（决策记录 .agents/notes/archived/process/2026-08-28-pause-release-npm-publish-unstable-dsh-alpha.md， 恢复记录 .agents/notes/archived/process/2026-08-30-restore-npm-publish-alpha.2.md）。 若将来 cohort 再次无法从 registry 解析，把开关改回 'false'，tag 推送即退回 GitHub-Release-only（此时 mount smoke 的 auto 模式以 workspace 打包的 file: tarball 验证本 tag 构建）。
• 根 package.json 是 private（不发布）；pnpm -r publish 自动跳过。它的 version 与家族包同步 bump：git / link 安装仓库根别名 bundle 时，插件管理器显示的就是它。
• 分支模型：dev 是开发分支（集成分支），本地开发与远程 PR 统一以 dev 为目标（远端默认分支）；main 是稳定分支（发布分支），只接收 dev 上测试通过后合入的代码，发版 tag 一律从 main 打。dev / main 均已启用分支保护（要求 PR + CI 全绿；管理员可绕过，维护者直推 仍可用，功能改动仍须先经 dev）。
• 仓库禁 emoji（所有文件含提交信息与 tag 信息）；CI 会校验。