公开治理
发布证据
TokenDance 组织官网公开发布前后需要验证的路由、SEO、i18n、视觉 QA 和产品状态证据。
为什么需要发布证据
产品状态页要求 live 入口具备当前发布证据。本页把公开站点能公开记录的证据类型固定下来,避免把私有服务器路径、回滚命令或密钥带进官网仓库。
公开证据清单
| 类别 | 公开证据 | 不公开 |
|---|---|---|
| Routes | /zh、/en、/zh/docs、/en/docs 和变更 docs route 的 HTTP 状态与关键词 | 部署目录、nginx 路径、SSH alias |
| Discovery | robots.txt、sitemap.xml、llms.txt 覆盖新增路由 | 私有 crawler 日志 |
| i18n | zh/en 产品 claims、登录边界、CTA、metadata 语义一致 | 翻译工作草稿或内部评审评论 |
| Visual QA | 桌面/移动截图 artifact 路径和无横向溢出结论 | 含私有路径或用户数据的截图 |
| Security | 无 secret、无私有路径、凭据边界正确 | 真实 key、admin token、provider payload |
当前重点路由
- /zh、/en:首页、产品矩阵、TokenDance Blue 设计、登录入口。
- /zh/docs、/en/docs:文档入口和产品导航。
- /zh/docs/gateway、/en/docs/gateway:Gateway base URL、SDK 示例和凭据边界。
- /zh/docs/gateway-access、/en/docs/gateway-access:API key、环境变量和最小验证。
- /zh/docs/gateway-status-support、/en/docs/gateway-status-support:错误、状态、限流和支持证据。
- /zh/docs/release-evidence、/en/docs/release-evidence:公开发布证据规则。
本地验证命令
powershell
pnpm lint
pnpm build
pnpm visual:qa
# From the TokenDance workspace root
.\scripts\verify-public-surfaces.ps1
.\scripts\verify-i18n-parity.ps1
.\scripts\verify-doc-freshness.ps1
.\scripts\verify-design-tokens.ps1
.\scripts\verify-governance.ps1 -SkipDiffCheck 状态升级规则
- 只有路由、发现文件、i18n、视觉 QA 和安全边界都有证据时,公开站点入口才能写 live。
- Gateway API live 不等于 key 自助、完整模型列表、额度视图、状态页和 SLA 都已发布。
- TokenDanceCode 是实验项目,发布证据只证明公开介绍和试用边界,不证明稳定产品支持。
- 含私有运维细节的证据只写入 server workspace 或私有 release note,不写入公开仓库。