docs(changelog): 测试服 API 文档站登录改 Gitea 账号 SSO(登录一次30天免登录)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

changelogs-v2/2026-06/12_测试服API文档站登录改Gitea账号SSO-环境变更-全员.md

@@ -0,0 +1,25 @@
+# 【环境变更·全员】测试服 API 文档站(doc.html)登录改 Gitea 账号 SSO——登录一次 30 天免登录
+
+> 站点:https://api.test.1814.love:9443/doc.html | 生效:2026-06-12 | 无 PR(测试服 nginx + oauth2-proxy 配置变更,不涉及业务代码)
+> 已端到端实测:Gitea 登录→授权→文档加载→二次访问纯 Cookie 免登录
+
+## ⚠️ 关键说明
+
+1. **文档站专用账号(hulalv)停用**:访问 doc.html 不再弹浏览器账号密码框,改为跳转 Gitea 登录页,**用你自己的 Gitea(git.1814.love)账号登录**。
+2. **浏览器已登录 Gitea 的话全程无感**:直接跳回文档页,一个键都不用按。
+3. **首次使用会出现一次「授权 knife4j-api-docs-sso 访问您的帐户?」确认页**:点「应用授权」即可,每个账号只出现这一次。
+4. **登录一次 30 天免登录**(Cookie 有效期 720h,期间自动静默续期),浏览器重启也不用重新登录。
+5. **API 调用本身零影响**:/admin/、/mp/、/v3/ 等接口的认证方式不变,仅 doc.html、/webjars/、/v2/api-docs、/swagger-resources 四个文档路径换了认证。
+
+## 1. 行为对照
+
+| 场景 | 旧 | 新 |
+|---|---|---|
+| 打开 doc.html | 浏览器弹 Basic Auth 框,输文档专用账号 | 跳 Gitea 登录页(已登录 Gitea 则无感直进) |
+| 浏览器重启后 | 重新弹框输密码 | Cookie 30 天内免登录 |
+| 账号管理 | 共享一个 hulalv 账号 | 各自 Gitea 账号(cz/liutao/mmg/wx/yst 均可用) |
+
+## 2. 遇到问题
+
+- 跳转后 Gitea 登录不上:确认用的是 git.1814.love 的账号密码(忘记密码可在 Gitea 页面重置)。
+- 登录后报错或循环跳转:联系 wx(服务端 oauth2-proxy 日志可查)。