持续维护
公开治理与发布边界
SEO、llms.txt、i18n、设计系统和安全边界的公开维护规则。
公开面必须同步
- 新增或删除公开路由时，同步 sitemap.xml、robots.txt、llms.txt、导航和页脚。
- 中文和英文页面必须保持产品 claims、登录边界、metadata 和 CTA 语义一致。
- 设计改动遵守 TokenDance / AgentHub 共享设计系统，使用 TokenDance Blue，不重新引入紫色主色。
- 公开文档不记录生产路径、secret、私有日志和回滚命令。
Docs 编写规则
| 场景 | 必须写清 | 不能写 |
|---|---|---|
| 产品页 | 定位、当前状态、入口、适用读者、下一步 | 把 roadmap 写成已经完成 |
| 接入页 | base URL、环境变量、最小验证、错误排查、凭据边界 | 真实 key、私有 host、内部模型名 |
| 身份页 | TokenDance ID OIDC、产品本地 session、授权边界 | 产品直连第三方 OAuth 或把登录等同授权 |
| 实验项目页 | 实验目的、当前能力、试用路径、低承诺边界 | 企业 SLA、稳定 marketplace、默认生产支持 |
上线前检查
- 运行 lint、TypeScript 和 build。
- 检查 /zh、/en、/zh/docs、/en/docs，以及新增或变更的 zh/en docs 路由。
- 当前关键 docs 路由包括 /zh/docs/ecosystem-architecture、/en/docs/ecosystem-architecture、/zh/docs/gateway、/en/docs/gateway、/zh/docs/product-status、/en/docs/product-status。
- 检查 llms.txt 和 sitemap.xml 中的 URL 与真实路由一致。
- 必要时补充桌面和移动端截图，确认无换行溢出、无旧色彩体系、无错误登录边界。
发布门禁
| 门禁 | 必须证明 |
|---|---|
| SEO / discovery | robots.txt、sitemap.xml、llms.txt 覆盖新增路由 |
| i18n parity | 中文和英文 claims、登录边界、CTA 与 metadata 语义一致 |
| Gateway wording | TokenDance API key 与 TokenDance ID session 分开描述 |
| Identity boundary | 第三方 provider 归 TokenDance ID，产品只消费 OIDC |
| Security risk | 公开仓库不包含 secret、私有路径、真实 key 或回滚命令 |
| Visual QA | 首页和 docs 关键路由有桌面/移动检查，无遮挡、无旧紫色漂移 |
读者 QA
- 第一次接触 TokenDance 的读者能否从 /docs 判断该先看哪个产品。
- 只想调用模型 API 的读者能否找到 Gateway base URL、key 边界、SDK 示例和错误排查方向。
- 想登录产品的读者能否理解 TokenDance ID 与产品本地授权的区别。
- 看到实验项目的读者能否明确哪些能试、哪些不能当成稳定承诺。
维护命令
powershell
pnpm build
# From the TokenDance workspace root
.\scripts\verify-public-surfaces.ps1
.\scripts\verify-i18n-parity.ps1
.\scripts\verify-design-tokens.ps1
.\scripts\verify-doc-freshness.ps1
.\scripts\verify-governance.ps1 -SkipDiffCheck