SUPER DOLPHINHARNESS DRIVER DOCS

RELEASE READINESS

发布状态

用可复验门槛区分准备完成与真正发布,并明确当前仍处于 Unreleased。

先说结论

Super Dolphin 目前还没有经过验证的公开版本,CHANGELOG.md 中只有 [Unreleased]。候选准备完成后仍需人工批准和独立发布动作,因此“准备好了”不能写成“已经发布”。网站保留的 GitHub 地址目前也不能匿名访问。

这里的能力描述固定到产品 commit 8ed277ce674195cd29b97231c31f9690f3f2407b。当前 Codex 集成、Claude 适配、Antigravity LSP-only 与其他 Harness planned/not verified 的状态,不应被推导成 tag、Release、二进制或兼容性承诺。

怎么理解

发布流程按证据逐层推进:

阶段必须证明什么是否授权发布
冻结候选输入单一 committed SHA、干净工作区、身份与许可证一致
文档与生成真源链接、Roadmap 语义、code/project/capability map 无漂移
仓库验证guard、聚焦测试、完整测试、前端与 SQL 检查按变更面通过
构建公开源码候选default-deny 导出、secret scan、确定性 receipt 与独立复验
人工评审文件清单、许可证、安全渠道、限制和本机信息全部复核仅仓库所有者明确批准后
发布动作创建/调整仓库、推送候选、配置安全与分支保护、clean clone 复验需要单独授权
发布后复核链接、模板、许可证渲染与公开 SHA 可复现已发布后的验证

构建、测试或生成一个候选包只代表准备证据增加,不代表可以修改仓库可见性、推送、创建 tag 或发布 GitHub Release。

怎么使用

  1. 选择唯一源码 SHA,并在所有验证期间保持候选不变。
  2. 运行文档链接、生成地图、guard、测试、构建及变更相关检查,记录命令、exit status 与 SHA。
  3. 由受评审的导出流程从 committed Git tree 构建公共候选;未分类路径必须 fail closed。
  4. 生成记录文件路径、mode、size 与 SHA-256 的确定性 receipt,并由独立验证拒绝任何缺失、额外、修改或 chmod 变化。
  5. 人工检查完整文件清单、许可证归属、安全入口、Roadmap 表述、绝对本机路径和私密数据。
  6. 仓库所有者明确记录 approved for publication 后,才可执行获得授权的具体发布动作。
  7. 从公开仓库 clean clone,重跑其声明的 setup 与治理检查,再记录公开 SHA。

常见问题

出现下列任一情况必须停止发布:

  • 必需检查为红色或被跳过。
  • 评审后源码 SHA 或候选内容发生变化。
  • 怀疑存在 secret、私密路径、用户数据或机器身份泄漏。
  • 公共源码 receipt 无法独立复现。
  • 文档声称了不可用的命令、平台、版本或支持渠道。
  • 仓库名称、模块、许可证或 canonical identity 不一致。
  • 发布授权缺失、含糊或只覆盖部分动作。

修复后必须从受影响的最早阶段重新生成证据;不能用手工复制、黑名单过滤、忽略 warning 或“本机看起来正常”替代可复验流程。

适用范围

  • Roadmap 的“已实现”“验证中”与“未来方向”是不同状态,也都不承诺交付日期。
  • 网站采用的仓库 URL 与产品发布策略中的 canonical identity 仍需发布前统一;当前选择不证明公开仓库已存在。
  • Tag、GitHub Release、二进制制品、checksums 和平台兼容性需要独立版本与验证证据。
  • 发布清单描述门槛,不授予任何人改变远端状态的权限。

延伸阅读

了解当前能力与未来方向可回到项目与社区;准备提交改动时阅读贡献指南