文档：记录 CMS 配置错误待解决问题及排查思路

docs/CMS.md

@@ -77,13 +77,28 @@
    - 文件：`.gitea/workflows/deploy.yml`
    - 已实测：git push → Gitea → Runner → npm ci + build → 发布，全链路打通。
 
-### 阶段三：接入 CMS（进行中）
+### 阶段三：接入 CMS（进行中 · 遇到待解决问题）
 - `public/admin/` 已就绪（Sveltia CMS + config.yml，backend 指向 Gitea IP）
 - Gitea 已注册 OAuth 应用（Sveltia CMS，公开客户端 + PKCE）
   - client_id 已写入 config.yml
   - redirect_uri: http://8.137.165.96:8080/admin/
-- **待验证**：浏览器登录 /admin 的 OAuth 流程能否纯前端跑通（Sveltia 对
+- ✅ 安全组已放行 3000，浏览器可访问 Gitea
-  Gitea 的 token 交换是否需要额外中转服务）。需先放行安全组 3000 端口。
+- ⚠️ **待解决问题**：访问 /admin 时报
+  "There is an error in the CMS configuration. Please solve the issue and try again."
+  - 已排除：YAML 语法正确；已移除 local_backend 和无效的 locale 字段
+  - 据 Sveltia 文档，该错误出现在登录屏，通常因 collection/field 的 name
+    含非法字符（空格、`.`、`*`）或配置结构不被接受。本项目 name 均为合法英文，
+    故疑点转向某个字段写法（datetime 的 format 组合 / value_type / summary 过滤器）
+    或 backend 连接层。
+  - 排查手段（下次继续）：
+    1. 已在服务器临时部署最小化 config.yml 用于隔离（只含 title/pubDate/body）。
+    2. 需从浏览器 F12 控制台读取 Sveltia 打印的具体校验错误（最直接）。
+    3. 若最小配置可用，则逐项加回字段定位；若仍报错，排查 backend/CORS。
+  - 相关：Sveltia 文档提到自托管 Gitea 需在 Gitea 配置启用 CORS
+    （[server].CORS / cors 段），本项目 Gitea 尚未配置 CORS，登录后调用 API
+    可能受影响（此项与"配置错误"不同阶段，但一并待处理）。
+- 备注：CMS 在线编辑非阻塞项，静态站点 + CI 自动部署已可用；
+  内容当前可用 Markdown 文件方式维护，CMS 调通后再切到在线编辑。
 
 ### 测试访问地址（备案完成前）
 - 网站：http://8.137.165.96:8080