Skip to content

文档维护与更新状态 ​

目录检查报告显示当前对外目录的更新情况。该站点只展示 default、正价纯pro号池、plus池;原始配置审计结果留在本机,不直接发布。

内容规则 ​

  • 正价纯pro号池:仅支持 Codex Responses,也是技能生图教程的默认推荐分组。技能生图通过 Responses 图片工具调用,plus池 也支持;兼容模式、API Key Mode 和独立 Images 接口仍使用 plus池。
  • plus池:支持 Responses 和 Chat Completions;图片模型使用其单独的 Images 入口。
  • 每个模型按平台、用途及池维护接口,不直接复制多渠道合并标签。
  • 模型列表不显示验证状态;入口与池逐项换行,模型 ID 保持完整。
  • 客户端配置区分 Windows PowerShell 与 macOS/Linux;JSON、TOML 内容可以共用,环境变量和文件路径分别给出。
  • 普通用户的图片配置以手动复制文件、编辑配置和工具内提示词为主,不提供必做的脚本检查或图片解码操作。
  • 基础 API 验证统一使用首页 HTTP 多标签模块,按协议说明分组、模型和结果,不在每个客户端或平台重复验证脚本。

更新流程(Linux 部署服务器) ​

以下为本机 Linux 维护命令,不是 Windows 客户端配置。源码目录为 /data/app/docs-ai:

bash
npm run models:check

检查无差异且源码已发布时退出 0;出现需维护的对外目录差异、获取失败或尚未发布时退出 1。检查每天北京时间 06:00 后五分钟内运行,只更新报告,不生成内容或自动发布。

独立的自动发布任务每天北京时间 06:10 后一分钟内运行:读取 NewAPI 模型、同步目录、验证客户端读取,再执行测试、构建、备份、发布与 HTTPS 回检。无变化时也更新核对日期。失败保留线上旧版,并恢复同步前的生成文件;不修改网关渠道、价格,也不提交模型生成请求。

在本机 Linux 查看状态或手动触发同一自动流程:

bash
systemctl list-timers docs-ai-auto-publish.timer --no-pager
systemctl status docs-ai-auto-publish.service --no-pager
journalctl -u docs-ai-auto-publish.service -n 30 --no-pager
systemctl start docs-ai-auto-publish.service

state/auto-publication.json 记录本次阶段、结果和备份位置。手动与自动发布共用排他锁。同步令牌通过 systemd 加密凭据传入,仅用于 GET /v1/models,不在源码或日志中保存明文;令牌轮换后需由维护人员更新加密凭据。

核对模型平台、池与执行渠道,维护 data/model-profiles.json 中各模型的 poolEndpoints,然后执行:

bash
npm run models:sync
npm run models:verify
npm run docs:publish

发布会运行测试、构建、示例与链接检查、备份和 HTTPS 内容回检;失败时恢复本次发布前的静态目录。不能仅凭公开目录合并标签增加某个池的协议,也不能把未知模型自动归入现有配置。

Codex 远程模型目录 ​

固定网址:codex-image-models.json;更新信息列出维护时间、模型 ID 和客户端元数据版本。兼容模式与 API Key Mode 在 provider 下配置 model_catalog_url,不再要求用户下载 JSON。用户配置中已有的 model_catalog_json 必须移除,否则不会读取远程目录。

npm run models:sync 同时更新站点模型页、远程目录和更新信息;models:verify、每日检查和发布前检查核对来源一致性,发布后通过 HTTPS 逐字节回检。目录名单从 NewAPI /v1/models 获取,与公开分组范围交叉筛选,只处理 GPT 文本/编程主模型;排除 GPT 图片、音频、视频及其他平台,不发布隐藏分组、令牌或内部提示词。用户自己的令牌权限仍由网关控制。

data/codex-gateway-models.json 保存筛选后的 NewAPI 名单。每次同步从 Codex 官方目录刷新元数据缓存 data/codex-model-metadata.json,并应用 data/codex-model-overrides.json 的兼容覆盖,目前仅覆盖 gpt-6.1-sol 的 use_responses_lite=false。未来新增 GPT 模型只要在 NewAPI 接口可见且能匹配官方元数据,就自动进入 JSON,不受本机 CLI 内置名单限制;自定义别名或尚无准确元数据的新模型停止同步,保留旧版,不能套用旧模型参数。

按池的文档表格仍需要显式审核各池路由,新 GPT 主模型可先进入 Codex 目录,不自动生成未经核对的按池接口说明。官方元数据暂时不可用时保留已审核缓存;模型接口失败或返回空名单时不会覆盖已发布目录。

维护机升级 Codex 后,可在本机 Linux 更新已验证版本,再同步与验证:

bash
npm run codex:metadata
npm run models:sync
npm run models:verify
npm run codex:verify

codex:verify 使用隔离目录与测试占位凭据,检查实际 Codex 客户端能否读取本地模拟的远程目录,不调用模型生成接口。发布后可在同一部署服务器执行:

bash
node scripts/verify-codex-catalog.mjs https://docs-ai.fq-hx.com/downloads/codex-image-models.json
node scripts/verify-codex-catalog.mjs https://docs-ai.fq-hx.com/downloads/codex-image-models.json auth-file

两条命令分别验证环境变量 API Key 与 auth.json API Key 的目录读取,均使用占位凭据,不读取本机真实密钥。目录更新由客户端刷新后生效,不保证已有会话即时切换。客户端版本变化后应重新验证;普通用户不需要执行这些维护命令。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。