文档站维护

当前目录

/opt/ynumerics-docs
├── mkdocs.yml
├── requirements.txt
├── docs/
└── site/

/var/www/ynumerics-docs
└── Nginx 实际发布的静态文件

更新流程

cd /opt/ynumerics-docs
source .venv/bin/activate
mkdocs build --strict
sudo rsync -a --delete site/ /var/www/ynumerics-docs/
sudo chown -R www-data:www-data /var/www/ynumerics-docs

无需重启 Nginx。

依赖版本

当前工作环境已经通过：

pip freeze > requirements.txt

后续重建环境优先使用：

pip install -r requirements.txt

不要随意升级到不兼容的 MkDocs/MkDocs Material 主版本。

主站文档入口

Sub2API 管理后台：

系统设置 → 通用设置 → 文档链接

填写：

https://docs.ynumerics.top

保存后，普通用户从 YNumerics API 主站即可进入本使用文档。

模型列表更新

新增、下线或改名模型后，同时更新 docs/models.md、首页和管理员路由页，并检查 Codex++ 的 “从上游获取模型” 是否能同步到最新列表。文档写清“如何使用”和协议限制，不写成测试报告。