@deepwhale-cn/dsh-release-selfcheck
安装
dsh plugin --profile web add @deepwhale-cn/dsh-release-selfcheck
给 AI Agent 用的发布前自检能力。装进 DeepSeek Harness（DSH）后，Agent 在发版、上传安装包、切换下载链接、创建 Release 之前会自动按这套清单自查。
一句话：它挡的不是"报错"，而是**「没有报错但事情没做成 / 做错了」**。
为什么需要它
最常见的发布事故，全都发生在所有 CI job 都是绿的、日志里没有任何异常的时候。下面每一条都是真实踩过的坑：
| 事故 | 表面现象 | 真实后果 |
|---|
迁移脚本的临时目录叫了 assets，撞上仓库已有的 assets/ | 工作流"成功" | 把 11 个无关的网站图片一起传上了对象存储 |
| 两个 macOS 构建 job 的产物同名 | 四个 job 全绿 | macOS arm64 整个丢失，该平台用户没得下载 |
用 unzip -l 的输出做断言，把完好的包判成坏包 | 构建"失败" | 正确产物被拦下，排查方向被带偏 |
命令行参数 --key=value 不被解析器支持 | 脚本打印"无需处理"、退出码 0 | 阈值静默丢失，该做的一件没做 |
| 改一个 JSON 字段时整段配置被顺手删掉 | 构建成功 | 打出签名无效的包，只影响其中一个平台 |
验证步骤用 curl -o /dev/null 而非 -I | 看起来在"验证" | 几个 GB 白下载，白等十几分钟 |
共同点：没有报错，但事情没做成或做错了。所以本 skill 的核心不是"看有没有报错"，而是逐个断言可核对的最终结果。
三条铁律
1. 断言「结果」，不要断言「过程」
| ❌ | ✅ |
|---|
函数返回了 changed=true | 目标文件里到底有没有那段内容 |
| 所有 job 都 success | 产物清单里每个平台在不在 |
| 命令 exit 0 | HTTP 状态码是不是 200（用 -I） |
| 日志里没报错 | 下载回来的哈希与原件一致 |
并且：判据要对着「应该是什么」，不能对着「手里有什么」。验证器与上传器的过滤规则必须同源——否则会出现"上传器刻意跳过某类文件，验证器却拿整个目录去核对"，于是报出假失败。
2. 只上传「显式清单」，不上传「某个目录的全部内容」
目录内容会变，清单不会。这是"多传了 11 个无关文件"那次事故的根因。
3. 先自检环境与权限，再验业务逻辑
否则一旦失败，你无法判断是环境问题还是逻辑问题，排查时间成倍增加。
安装
npm install @deepwhale-cn/dsh-release-selfcheck
然后在你的 DSH profile 里把它列为 bundle：
{
"dependencies": {
"@deepwhale-cn/dsh-release-selfcheck": "^0.1.0"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@deepwhale-cn/dsh-release-selfcheck"
]
}
}
}
重启后，Agent 在涉及发布的对话里会自动带上这套检查清单。
自检脚本
技能正文里带一个可直接运行的脚本（路径在注册时自动替换为真实完整路径）：
SELFCHECK=/path/to/skill/selfcheck.sh # 由技能正文给出
# 看当前配置与自动推断结果
bash $SELFCHECK config
# 产物清单比对（核心）：多一个要问为什么，少一个要问为什么
bash $SELFCHECK manifest expected.txt ./实际目录
# 版本一致性：包版本 / git tag / 各站点 / 各产品线
bash $SELFCHECK versions
# 线上页面下载链接逐条 HEAD（403 = 源站没有；000 = 网络抖动）
bash $SELFCHECK links https://example.com/download.html
# 发布纪律：主程序是否正式发布、附加发布是否标了 Pre-release、latest 指向谁
bash $SELFCHECK release v1.0.19 suite-v1.0.19
配置（全部可选，不设则自动推断）
| 环境变量 | 说明 | 默认 |
|---|
SELFCHECK_REPO_DIR | 仓库根目录 | 从当前目录向上找 package.json |
SELFCHECK_REPO_SLUG | 仓库 slug（owner/repo） | 从 git remote origin 推断 |
SELFCHECK_MAIN_SITE | 主站目录（用于跨站版本比对） | 不设则跳过该项 |
SELFCHECK_PAGES_INDEX | 静态托管站的 index 路径 | <repo>/docs/index.html |
SELFCHECK_MAIN_SITE=/path/to/main-site bash $SELFCHECK versions
覆盖范围
- A. 产物清单 —— 预期 vs 实际逐一比对，防止多传/漏传
- B. 版本一致性 —— 包版本、git tag、多个站点、多个产品线互不覆盖
- C. 平台与架构 —— 解包看二进制头，不只看文件名；随包载荷架构要与包一致
- D. 上传内容过滤 —— 该排除的排除，但同名不同用途的别一刀切
- E. 站点上线前 —— 从线上页面抽链接、逐条 HEAD、部署后再验
- F. 发布纪律 —— 正式/预发布标记、latest 不被附加发布抢走
- G. 对外内容合规 —— 与合规审核 skill 配合（本 skill 管"东西对不对"，它管"话能不能说"）
- H. 现场清理 —— 进程回收、临时文件清理、不误删别人的文件
另含一节**「已知假阳性」**，防止检查本身误伤（例如下载目录里出现 .blockmap 是正常的、锁文件里的敏感词是 base64 巧合）。
注意
- 本 skill 提供的是检查方法与判据，不是任何具体项目的发布脚本；命令里的仓库名、站点路径都需按你的情况配置。
- 脚本只做能机械核对的部分。架构是否正确、清单是否合理这类判断，仍需人（或 Agent）来看。
- 依赖
ctx.skills（由 @deepseek-ai/dsh-skill 提供）。该服务缺失时插件静默跳过，不会影响 profile 启动。
相关
License
MIT
