服务监控

本页用于承接文档站层面的监控说明，而不是直接暴露业务监控内部接口。

推荐入口

• 文档首页：/
• 快速开始：/docs/register/
• FAQ：/docs/faq/
• 后台健康检查（运维用）：/wd/admin/health
• 文档后台：/wd/admin/

什么时候应该看这页

• 用户反馈“文档站打不开”或“下载不了脚本”
• 刚完成一次发布，想做发布后验活
• 某个 CLI 最近连续报错，想先判断是站点问题还是工具配置问题
• 需要向运营或客服解释“当前是否是系统性问题”

你应该关注什么

1. 当前站点是否可达。
2. 安装脚本下载是否正常。
3. CLI 配置步骤是否发生变更。
4. 是否有分组策略或额度策略调整。

一次标准验活应该包含什么

如果你刚完成发布，建议至少做下面 4 个检查：

检查项	期望结果	说明
首页 /wd/	HTTP 200	说明站点入口正常
快速开始 /wd/docs/register/	HTTP 200	说明核心用户链路页面可访问
后台健康检查 /wd/admin/health	ok: true	说明后台服务已启动且路径配置正确
下载资源 /wd/data/releases.json	可读取	说明下载面板不会出现空链接或 404

建议检查顺序

面向读者

1. 先打开首页和 快速开始。
2. 再打开你正在使用的目标页，例如 /docs/cli/ 或 /docs/ccswitch/。
3. 如果页面正常但命令仍失败，优先去 FAQ 排障。

面向运维

1. 检查站点首页和 /wd/docs/register/ 是否返回 200。
2. 检查 /wd/admin/health 是否返回 ok: true。
3. 检查下载资源 /wd/data/releases.json 是否可读、脚本文件是否可下载。
4. 若刚发布过，确认 systemd 状态、Nginx 状态和最近构建结果一致。

发现异常后先去哪里

现象	第一落点	为什么
只有某个工具报错	FAQ 或对应 CLI 页面	更可能是本地配置、令牌或模型名问题
下载入口失效	下载资源与发布链路	更可能是 releases.json 或静态资源同步问题
/wd/admin/health 异常	后台服务与部署脚本	更可能是进程未启动、路径错或最近一次部署失败
多个页面同时异常	Nginx / 静态站点	更可能是站点整体发布或反代问题

典型问题如何分流

现象	更可能的问题面	下一步
页面整体打不开	站点或反向代理	先做健康检查，再看发布链路
页面能开，脚本下载失败	发布目录或资源同步	检查 releases.json 和下载文件
只有某个 CLI 报错	用户本地配置或令牌分组	直接去对应 FAQ
发布后文档没更新	构建/同步未完成	检查后台构建状态和发布时间

监控页未来可扩展内容

• 外部状态页嵌入
• 发布历史
• 维护公告
• 常见故障分流入口

对客服和运营的建议

• 不要把这页当成“技术细节堆放页”，它更适合做状态判断和跳转分流。
• 对外沟通时，先说明是“页面问题”“下载问题”还是“工具配置问题”，再把用户引导到对应页面。
• 如果需要把异常提交给运维，至少带上访问时间、目标 URL、地区和复现方式。