docs(polaris): 同步设计与部署文档现状

对齐深色玻璃样式、响应式布局、数据规模与配置生效范围。明确仅由 polaris-v* 标签触发发布，并保留历史规格说明。
2026-10-14 16:38:07 +08:00
parent d53dbac88e
commit 86f6eb39b2
6 changed files with 287 additions and 118 deletions
@@ -0,0 +1,17 @@
+# Polaris 文档与当前实现对齐（2026-10-14）
+
+状态：用户已确认调整后的方案；设计文档和部署说明已更新（2026-10-14）。未修改产品代码、配置或 CI 工作流。
+
+## 范围
+
+1. 更新 `docs/design/Polaris 项目说明文档.md`：将当前部署方式统一为 standalone；依据现有 CSS 描述深色玻璃视觉、移动端布局、8 类 51 条链接及 6 条常用链接；更正阶段清单与目录结构；明确 `settings.theme`、`settings.background` 仅有数据模型与校验，未驱动样式。背景素材属于可更换内容，不写死图片路径、画面类型或具体背景外观。
+2. 更新 `docs/design/Polaris 首页设计文档.md`、`Polaris 分类页设计文档.md`：在保留历史设计意图的同时，按现有代码描述深色玻璃风格和移动端顶部横栏；区分尚未实现的双主题、背景配置生效与已实现的分类网格三档断点（≥1280px 三列、1000–1279px 两列、≤999px 单列），不规定具体背景素材及其内容。
+3. 对日期命名的 `docs/design/2026-08-26-Polaris-首页实现规格.md` 增加历史规格状态说明和现状索引，不逐行重写历史验收要求；历史 `docs/superpowers/plans/` 保持原貌。
+4. 修订 `deploy/README.md` 的触发方式和镜像摘要说明：仅推送 `polaris-v*` 标签才运行 CI；验证通过后发布带完整 commit SHA 的镜像；workflow 已实现摘要输出，但 registry、runner 与服务器行为仍待现场验证。明确 Compose 目前只要求镜像变量非空，digest 固定是部署操作约定而非自动校验。
+
+## 边界与验证
+
+- 不修改应用代码、配置数据、工作流或标签触发条件；不处理未来 Go API。
+- 不以当前背景文件或壁纸内容作为设计基线；用户可不定期替换背景素材，视觉描述以现有 CSS 中稳定的色彩、表面与交互样式为准。
+- 不碰仓库 `note/` 中已有的删除/新增改动，亦不处理仓库外或已删除的历史笔记。
+- 编辑前检查目标文件缩进和换行形式；完成后检查文档差异、搜索剩余过时表述并核对 Git 工作树。纯文档更新不要求构建或测试。