客户端文档维护策略
客户端软件持续更新，界面与配置参数可能发生变更。本文档说明接入文档的维护与验证机制，以及过期内容的反馈渠道。
最近核验
每篇客户端接入文档的顶部标有「最近核验」日期，用于记录最近一次真实客户端核验。日期本身不能说明覆盖了哪些系统、版本和配置分支，应同时查看下方的核验范围。
历史页面若只有日期，会显示「核验范围未记录」，不代表所有分支都已验证。未在范围中列出的 App / CLI、系统或可选功能，需要单独确认兼容性。
页脚的「最后更新于」是另一回事，它来自 Git 提交时间，改一个错别字也会刷新。判断内容是否跟得上客户端版本，看「最近核验」。
核验周期
目标是 30 天内至少核验一次。每次核验检查：
| 检查项 | 说明 |
|---|---|
| 安装方式 | 命令、包名、下载入口是否仍然有效 |
| 配置项名称 | 客户端改版后设置项常被改名或移位 |
| 截图 | 与当前界面是否一致 |
| 验证步骤 | 文档给出的验证命令能否正常返回 |
客户端发布大版本时应触发额外核验，不等周期到期。
记录核验范围
完成真实客户端测试后，在页面 frontmatter 中更新 verifiedAt，并用 verifiedWith 记录客户端完整版本号、操作系统及版本、配置方式和成功验证的功能。verifiedWith 是一段字符串，会显示在核验日期下方；中英文页面应记录同一组事实。
核验至少包含一次真实模型回复；安装成功或能获取模型列表不等于推理成功。部分分支完成时，只记录已通过的范围，在正文标出其余分支尚未核验。修改措辞、通过文档构建或翻译同步不应刷新核验日期。
覆盖范围
策略适用于 Agents 和 ChatBot 两类客户端接入文档。
计费、错误码、API 端点这类文档不标核验日期，它们跟随 Flux 自身变更，改动时同步更新。
发现内容过期
文档与实际不符时，请按 排障 的模板向平台反馈，并附上客户端版本号。同一份文档在不同版本下的表现可能完全不同。