From f57b1bde5fc90ce55bd335ef62982bb2855271f7 Mon Sep 17 00:00:00 2001
From: wait4xx <X@alumni.nudt.edu.cn>
Date: Sun, 25 Oct 2026 20:16:40 +0800
Subject: [PATCH] =?UTF-8?q?feat(admin):=20Sveltia=20=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E5=8F=B0=E6=AD=A3=E5=BC=8F=E6=94=B6=E7=BC=96=E2=80=94=E2=80=94?=
 =?UTF-8?q?=E9=A1=B5=E8=84=9A=E5=85=A5=E5=8F=A3=E4=B8=8E=E4=BD=BF=E7=94=A8?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Footer「管理」入口（data-astro-reload 绕 ClientRouter，官方集成守则）
- docs/管理台.md：Token 登录/上传流/纪律（title 必填、内建优化禁用的
  why、删除连带实测行为）/已知限制——试水期结论"值得留"转正

验证: pnpm astro build exit 0；dist 页脚含 /admin/ 入口

Spec: none (收编小特性：入口+文档，单提交意图)

Co-authored-by: GLM-5.3
---
 docs/管理台.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/管理台.md

diff --git a/docs/管理台.md b/docs/管理台.md
new file mode 100644
index 0000000..0850027
--- /dev/null
+++ b/docs/管理台.md
@@ -0,0 +1,25 @@
+# 管理台（Sveltia CMS）使用指南
+
+> 地址：`https://wait4x.online/admin/`（页脚「管理」入口）｜ 用途：照片上传与 sidecar 编辑的图形界面 ｜ 保存即 commit 到 main → webhook 自动构建发布（约 10 秒上线）
+
+## 登录
+
+选 **Sign In with Token** → 用 gitea 的 access token（宿主 `~/docker_apps/gitea/init-templates.txt` 里的 api-token，或 gitea 网页新建 scope=read/write:repository）。token 存浏览器 localStorage，下次免登。
+
+## 照片上传流
+
+1. 图库照片 → New Entry：填标题（**必填**，空标题会让构建炸——实测坑）、选分组（street/landscape）、可写 alt
+2. 图片字段 → 资产库上传 jpg（与 sidecar 同目录落位，零重压缩）
+3. Save → 自动 commit + 构建 → 画廊出现（EXIF 构建期自动提取，exif 字段留空即可）
+
+## 纪律（与写作指南同源）
+
+- **图片体积**：上传前自行压缩（长边 ≤2400px）——Sveltia 内建优化**刻意关闭**（会抹 EXIF 断构建期提取管线）
+- **删除**：删条目会连带删除被其独占引用的 jpg（实测行为，官方文档说的"不连带"是错的）
+- EXIF 覆盖字段一般留空；文章 markdown 仍建议本地/gitea web 写（Sveltia 只管照片）
+- 保存直连 main 无分支缓冲——webhook 构建是安全网，构建失败 gitea 的 webhook 投递记录可查
+
+## 已知限制
+
+- 启动时探测 /api/forgejo 报 404 属良性回落（日志噪音，无影响）
+- 大视频仍走仓外 store + /media/ 绝对路径（见写作指南体积纪律表）