今天下午主要在 6767-api 这边整理文档。之前一直觉得少了一份服务器配置说明,比如各种大模型通道的 key 到底该放哪儿,业务配置和模型渠道配置怎么划分,每次全靠脑子记。今天干脆写了份 server-config.md 挂在文档库里,明确了职责划分:普通的业务配置各回各的 env 环境变量,而模型渠道配置统一收归到全局配置文件里,并保证权限安全。同步在 Docusaurus 站点上更新了侧边栏和顶部导航,把它作为一个独立的“服务器配置”分类展示,最后重新构建了文档站。理顺这一层之后,以后部署和查配置就清晰多了。
今天把 6767-api 的文档好好整理了一下。之前各个接口的说明写得比较散,零零碎碎的,入口看着也简陋。索性在项目下单独搭了一个 Docusaurus 文档站,把日程查询、Shizuku 随机图、TTS 语音等接口说明全部以 Markdown 形式迁了进去,并把旧的 HTML 页面改成了自动跳转。Docusaurus 这套工具确实省心,侧边栏、路由和文档结构开箱即用,比自己拿 HTML 硬糊舒服多了。虽然现在还没把它当作博客的主入口,但已经开始有了正式 API 文档的感觉了。