# 客户端文档维护策略

客户端软件持续更新，界面与配置参数可能发生变更。本文档说明接入文档的维护与验证机制，以及过期内容的反馈渠道。

## 最近核验

每篇客户端接入文档的顶部标有「最近核验」日期，用于记录最近一次真实客户端核验。日期本身不能说明覆盖了哪些系统、版本和配置分支，应同时查看下方的核验范围。

历史页面若只有日期，会显示「核验范围未记录」，不代表所有分支都已验证。未在范围中列出的 App / CLI、系统或可选功能，需要单独确认兼容性。

页脚的「最后更新于」是另一回事，它来自 Git 提交时间，改一个错别字也会刷新。判断内容是否跟得上客户端版本，看「最近核验」。

## 核验周期

目标是 30 天内至少核验一次。每次核验检查：

| 检查项     | 说明                             |
| ---------- | -------------------------------- |
| 安装方式   | 命令、包名、下载入口是否仍然有效 |
| 配置项名称 | 客户端改版后设置项常被改名或移位 |
| 截图       | 与当前界面是否一致               |
| 验证步骤   | 文档给出的验证命令能否正常返回   |

客户端发布大版本时应触发额外核验，不等周期到期。

## 记录核验范围

完成真实客户端测试后，在页面 frontmatter 中更新 `verifiedAt`，并用 `verifiedWith` 记录客户端完整版本号、操作系统及版本、配置方式和成功验证的功能。`verifiedWith` 是一段字符串，会显示在核验日期下方；中英文页面应记录同一组事实。

核验至少包含一次真实模型回复；安装成功或能获取模型列表不等于推理成功。部分分支完成时，只记录已通过的范围，在正文标出其余分支尚未核验。修改措辞、通过文档构建或翻译同步不应刷新核验日期。

## 覆盖范围

策略适用于 [Agents](https://docs.tryflux.net/docs/agents/claude-code.md) 和 [ChatBot](https://docs.tryflux.net/docs/chatbot/cherry-studio.md) 两类客户端接入文档。

计费、错误码、API 端点这类文档不标核验日期，它们跟随 Flux 自身变更，改动时同步更新。

## 发现内容过期

文档与实际不符时，请按 [排障](https://docs.tryflux.net/docs/troubleshooting.md#怎么反馈) 的模板向平台反馈，并附上客户端版本号。同一份文档在不同版本下的表现可能完全不同。

## 相关入口

- [快速开始](https://docs.tryflux.net/docs/quickstart.md) — 按客户端选择接入方式
- [排障](https://docs.tryflux.net/docs/troubleshooting.md) — 按症状定位问题