chore(spec): 归档 add-terminal-books-admin——五任务四车道收敛

Spec: 2026-10-25_add-terminal-books-admin Co-authored-by: GLM-5.3
2026-10-25 13:46:56 +08:00
1 parent cef648db9a
commit 0e792a70cc
@@ -0,0 +1,72 @@
+# Phase 5b：/terminal 彩蛋 + /books 书评画廊 + Sveltia 管理台试水 - 项目范围
+
+<!-- spec-format: 2 -->
+
+## 1. 问题定义
+- **项目目标**：三个预研方案落地——终端彩蛋（极客人格记忆点）、书评索引画廊（阅读轨策展面）、Sveltia 管理台（照片上传/编辑体验升级试水）
+- **目标用户**：站长（写作/管理体验）与读者（浏览乐趣）
+- **核心价值**：二期池前三项交付；Sveltia 试水失败可全身而退
+
+## 2. 假设与待确认
+
+### 2.1 已确认事实
+- 三方案预研完成（op-artalk A+B / op-gitea Sveltia，含坑清单与工作量）
+- Sveltia 机制全对上：整文件 JSON=sidecar 同构、media_folder '' 裸文件名、token 登录、保存即 commit→webhook 自动构建
+- gitea CORS 未配是唯一硬前置
+
+### 2.2 关键假设
+- Sveltia 内建图片优化保持关闭（开了会抹 EXIF 断构建期提取管线）
+- 书评 description 由正文首段精炼可接受（用户后续可自行策展润色）
+
+### 2.3 待确认问题
+- [x] Sveltia 试水体验是否合手 → 结论：值得留（双冒烟过，编辑器 aria/草稿保存扎实）；生产自动化待裸 clone 改造（下一包首任务）
+
+### 2.4 可选解释与取舍
+- /books 不进主导航（书评列表行内入口）> 导航加第五项 -> 防膨胀
+- 色脊排版卡 > 满色书封卡（mood 深浅不一跨亮暗风险）-> 色脊
+
+### 2.5 已证伪路径
+- 无
+
+## 3. 功能范围
+
+### 3.1 核心功能（MVP）
+- [x] T1 /terminal 彩蛋页
+- [x] T2 /books 书评画廊（zh/en）
+- [x] T3 Sveltia 管理台试水（含 gitea CORS）
+- [x] T5 /opensource 开源独立页（2026-10-25 用户追加：与文章/图库/关于平权）
+- [x] T4 验证收官
+
+### 3.2 扩展功能
+- /books 进导航（若用户要求）
+
+### 3.3 不在范围内
+- moments PWA 上传端点、/stack·/colophon 页（后续池）
+
+## 4. 最小实现路径
+- 最简单可行方案：三车道并行按预研方案实施；Sveltia 试水不改现有任何流（只加不改）
+- 暂不引入：终端插件化命令系统、书封真实图片扫描
+- 不做的抽象/配置化：多管理后端适配
+
+## 5. 技术决策
+- 技术栈：预研方案原样（vanilla TS 终端 / 色脊卡静态页 / Sveltia 官方集成）
+- 证据协议：evidence: runs
+- 本轮允许改动：src/pages/、src/content.config.ts、content/posts/（五篇补字段）、public/admin/、infra/gitea/README、gitea 运行时 [cors]
+- 本轮不应触碰：content/photos 既有 sidecar 结构、发布链、生产 nginx
+- Git integration branch：`spec/2026-10-25_add-terminal-books-admin`
+
+### 5.1 验证策略
+- 范围级别：package
+- 变更对象：两个新页面、posts schema 扩展、admin 静态目录、gitea 运行时
+- 快速检查：`pnpm astro build`
+- 集成检查：terminal/books 产物断言 + Sveltia 双冒烟走通 commit→webhook→build
+- 全项目检查：E2E 30 项 + 新页视觉复核；仅在 gitea 运行时或发布链变更时升级范围
+- 升级触发：只有 Sveltia 冒烟引发 gitea 行为异常时，才升级验证范围并记录理由
+
+## 6. 成功标准与验证方式
+- [x] /terminal 可交互（help/ls/theme/sudo 彩蛋实跑） -> verify: task_0004
+- [x] /books zh/en 五书呈现（色脊+mood） -> verify: task_0002
+- [x] Sveltia 冒烟双通过（改+建全链） -> verify: task_0003
+
+## 7. 风险与约束
+- gitea restart 窗口（秒级，公告无需）；Sveltia 保存直连 main——已有 webhook 管线为安全网