运维 Runbook

本 Runbook 覆盖 AgentHub 公开站点、文档、本地预览和集成证据。它刻意保持 secret-free：生产主机路径、回滚命令、key 和私有日志属于私有运维 workspace。

日常检查

验证近期部署时使用 cache-busting：

curl.exe -I "https://hub.vectorcontrol.tech/zh/docs/desktop?v=YYYYMMDDTHHMMSS"
curl.exe "https://hub.vectorcontrol.tech/llms.txt?v=YYYYMMDDTHHMMSS"

本地构建门禁

在登记的发布源 worktree 中运行：

pnpm build
pnpm test
pnpm lint

预期结果：

• out/ 中存在 static export；
• 本地化 docs 同时导出到 out/en/docs/... 和 out/zh/docs/...；
• tests 覆盖 docs registry、i18n routes、search index、nav、footer 和 hero 行为；
• lint 没有新增 warning。

Docs 发布门禁

每个新增 docs route 必须更新：

漏掉任一项都可能导致页面能渲染，但 search、sidebar、prev/next、crawler discovery 或 zh/en parity 出现漂移。

视觉 QA 门禁

UI 或 docs layout 改动后检查：

• 桌面视口约 1440 x 900；
• 移动视口约 390 x 844；
• /zh、/en、/zh/docs、/en/docs；
• 本次变更的 docs route；
• 页面包含 Desktop mock 时的主题切换状态；
• mock 文案可见时的语言切换状态。

重点观察：

• pill、button、nav、footer 内文字是否换行或溢出；
• 是否残留旧紫色强调，而不是 TokenDance Blue；
• 是否出现纯黑 footer 背景；
• Desktop mock 的 hover 阴影是否过重；
• 非交互 mock preview 内是否出现浏览器默认 focus 框；
• docs 正文是否回退成无样式文本。

产品运行信号

验证 AgentHub 产品行为时，记录公开安全的信号，不要复制私有日志：

Smoke 报告和 issue 分流可使用这张表。不要把完整 prompt、raw provider output、私有文件内容、access token 或 host-specific log 粘进公开文档。

线上 Smoke 形状

一条线上 smoke 记录应包含：

site: hub.vectorcontrol.tech
version: cache-busting timestamp
routes: /zh, /en, /zh/docs, /en/docs, changed deep docs route
checks: body keyword, status code, discovery files, no stale old hero
result: pass/fail

公开 changelog 只写变化内容，不写服务器文件位置。

故障分流

Runtime 事故分流

公开站点本身健康、但产品行为失败时，使用这张表分流：

公开 issue 只记录 error code、request id、route class 和脱敏 id。local log、host path、queue name、callback payload、raw runtime output 只能留在私有 operator workspace。

状态词

使用保守状态词：

不确定时使用更保守的词，并链接到 roadmap 或 changelog。