3.4 KiB
3.4 KiB
Phase 5b：/terminal 彩蛋 + /books 书评画廊 + Sveltia 管理台试水 - 项目范围
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 待确认问题
- Sveltia 试水体验是否合手 → 结论：值得留（双冒烟过，编辑器 aria/草稿保存扎实）；生产自动化待裸 clone 改造（下一包首任务）
2.4 可选解释与取舍
- /books 不进主导航（书评列表行内入口）> 导航加第五项 -> 防膨胀
- 色脊排版卡 > 满色书封卡（mood 深浅不一跨亮暗风险）-> 色脊
2.5 已证伪路径
- 无
3. 功能范围
3.1 核心功能（MVP）
- T1 /terminal 彩蛋页
- T2 /books 书评画廊（zh/en）
- T3 Sveltia 管理台试水（含 gitea CORS）
- T5 /opensource 开源独立页（2026-10-25 用户追加：与文章/图库/关于平权）
- 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. 成功标准与验证方式
- /terminal 可交互（help/ls/theme/sudo 彩蛋实跑） -> verify: task_0004
- /books zh/en 五书呈现（色脊+mood） -> verify: task_0002
- Sveltia 冒烟双通过（改+建全链） -> verify: task_0003
7. 风险与约束
- gitea restart 窗口（秒级，公告无需）；Sveltia 保存直连 main——已有 webhook 管线为安全网