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,92 @@
+# Phase 5b：/terminal 彩蛋 + /books 书评画廊 + Sveltia 管理台试水 - 完成总结
+
+## 交付结论
+- 结果：完成
+- 完成时间：2026-10-25 13:46
+
+## 假设回顾
+### 已验证假设
+- Sveltia 内建图片优化保持关闭（开了会抹 EXIF 断构建期提取管线）
+- 书评 description 由正文首段精炼可接受（用户后续可自行策展润色）
+
+### 仍未完全验证的假设
+- 无
+
+## 交付范围
+### 已交付
+- T1 /terminal 终端彩蛋页
+- T2 /books 书评画廊
+- T3 Sveltia 管理台试水
+- T5 /opensource 开源独立页（用户追加需求）
+- T4 验证收官
+
+### 未交付
+- 无
+
+### 偏差说明
+- 无
+
+## 简化决策
+### 保持简单的关键选择
+- 最简单可行方案：三车道并行按预研方案实施；Sveltia 试水不改现有任何流（只加不改）
+- 暂不引入：终端插件化命令系统、书封真实图片扫描
+- 不做的抽象/配置化：多管理后端适配
+
+### 本轮明确不做的内容
+- moments PWA 上传端点、/stack·/colophon 页（后续池）
+
+## 变更边界
+### 本轮主要改动模块
+- 见 tasks.md 的 boundary 记录
+
+### 明确未触碰的区域
+- moments PWA 上传端点、/stack·/colophon 页（后续池）
+
+## 验证证据
+### 备注
+- 机器证据：runs.jsonl（见验证范围的机器验证率）
+
+## 验证范围
+- 级别：package
+- 机器验证率：5/5
+- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
+
+## 哲学生效证据
+### 行为成效回填
+- Development Record 行为门禁通过
+
+### 一致性门禁回顾
+- 验收面（checklist 或成功标准）已通过
+
+## Git Records
+- Date Time：2026-10-25 13:46
+- Scope：Phase 5b：/terminal 彩蛋 + /books 书评画廊 + Sveltia 管理台试水
+- Feature：T1 /terminal 终端彩蛋页；T2 /books 书评画廊；T3 Sveltia 管理台试水；T5 /opensource 开源独立页（用户追加需求）；T4 验证收官
+- Action：Commit / Push
+- Effect：Development Record 行为门禁通过
+- Commit：pending local commit
+- 提交区间：f1ee07838d577125f8f1677e6b662a3bb320ce32..1b610f0bbf430aae3f001cf0c8138ab775fc0662
+- Push：not-run (push stage follows commit)
+
+## AGENTS.md 增量提议
+```diff
+Astro 7 内容层双坑（EXIF 全空调试半日定位）：①loader 包装层在 baseLoader.load() 之后 ctx.store.set 的字段会被解析阶段静默丢弃——必须拦截 baseLoader 的写入时机内联增强（代理 store.set，enrich Promise 收集后 await）；②持久化数据仓（node_modules/.astro）增量复用旧条目——改 loader 逻辑后必须清数据仓或换 loader name，否则旧值复利胜出。团队协作：车道临时服务端口要与主验证端口分离（18742 Sveltia 冲突教训）；多车道并发时 add -A 会卷入他车道文件（提交信息如实备案或收窄 add）。Sveltia×gitea 机制：整文件 JSON=sidecar 同构、删条目连带独占 jpg（实测推翻文档）、omit_empty_optional_fields 会丢必需空字段。裸 clone 构建改造是 Sveltia 自动上线的硬前置（下一包首任务）。
+```
+
+## 被拒绝的扩展提议
+- 无
+
+## 门禁证据
+- check_spec_package.py exit 0
+
+## 遗留事项
+- 无；问题处置见下方结构化区块
+
+## 问题处置
+
+```json
+{
+  "issues": [],
+  "version": 1
+}
+```