QQgit/docs/TODO.md

63 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# TODO · Gitea 蓝白 ins 风外观定制(v1.0)
> 本文件是仓库里的持久化清单;GUI 会话里还有一份同名 todo 面板,两者内容一致。
> 状态:`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准
## 阶段 1 · Git 基线与素材归档 — 完成
- [x] 1.1 `git init -b main`,`user.name=QQ`、`user.email=qq@qyhhh.top`
- [x] 1.2 快照线上 `/var/lib/gitea/custom` → `baseline/custom/`
- [x] 1.3 快照 `/etc/gitea/app.ini` 的 `[ui]` 段 → `baseline/app-ini/ui-section.txt`
(原件含 SMTP 密码,`.gitignore` 排除,不进仓库)
- [x] 1.4 `gitea embedded view` 导出官方 1.21.11 模板 23 个 → `upstream-templates-1.21.11/`
- [x] 1.5 导出官方 `index.css` / `theme-auto.css` 作为变量派生源 → `vendor/`
- [x] 1.6 提交并打标签 `v0.0-baseline`(commit `62b45b2`)
## 阶段 2 · Logo 套件 — 完成
- [x] 2.1 决策锁定 **方案 2-A**:日间 `#60A5FA` 圆章 + 纯白负空间 Git-Q;夜间仅把圆章提到 `#38BDF8`
- [x] 2.2 原图归档 `design-assets/`:`image-ca10a7ce.png`(日间)、`image-33a59194.png`(夜间)
- [x] 2.3 矢量 SVG:`logo.svg`(内嵌 `@media (prefers-color-scheme:dark)` 自动换色)、
`logo-light.svg`、`logo-dark.svg`、`favicon.svg`(32 栅格重绘,非缩放)
- [x] 2.4 位图导出:`logo.png`(512)、`logo-dark.png`(512)、`favicon.png`(180)、
`apple-touch-icon.png`(180)、`favicon-32.png`(32)
- [x] 2.5 三底色目视确认(`#FFFFFF` / `#0D1117` / `#161B22`):圆外 100% 透明,无白框
## 阶段 3 · 三套主题 CSS — 完成
- [x] 3.1 `scripts/build_theme.py`:解析官方 `:root` → 叠加台面/主色 → 派生 primary 明暗族与 alpha 族
- [x] 3.2 `degreen()`:色相 60–170°(绿/黄绿)统一转 188° 青蓝,保留明度与饱和度
- [x] 3.3 修正则坑:`url("data:image/svg+xml;...")` 值被截断 → 改用支持引号的表达式并跳过 degreen
- [x] 3.4 产出 `theme-qq-auto.css` / `theme-qq-light.css` / `theme-qq-dark.css`(各 243 变量)
- [x] 3.5 `scripts/audit_colors.py` 审计:三套主题**无绿色残留**,全部通过
## 阶段 4 · 模板钩子与细节层 — 完成
- [x] 4.1 本地内置 `JetBrains Mono` woff2(400/500/700),不走 CDN
- [x] 4.2 `custom/public/assets/css/qq-ui.css`:字体、8px 圆角、顶栏毛玻璃、滚动条、卡片、页脚
- [x] 4.3 `custom/templates/custom/header.tmpl`:preload 字体 + 引入 `qq-ui.css` + `theme-color` meta
- [x] 4.4 `custom/templates/custom/footer.tmpl`:`.qq-footer` 页脚(ICP 备案号留注释占位)
- [x] 4.5 `custom/templates/home.tmpl`:基于官方精简,logo 168×168 + 三卡首页(沿用官方 i18n key)
## 阶段 5 · 离线预览与候选版 — 完成
- [x] 5.1 `preview/index.html`:首页 / 仓库列表 / 文件页+代码块 / 组件 / Logo 双底色校验 5 段
- [x] 5.2 右上角胶囊切换 浅色 / 自动 / 深色(切 `<link disabled>`,localStorage 记忆)
- [x] 5.3 `scripts/check_preview.py`:变量、类名、日夜媒体查询全绿;24 个资源引用零缺失
- [x] 5.4 提交并打标签 `v1.0-rc1`
- [ ] 5.5 **等 QQ 在预览页验收**(满意 → 进入阶段 6;要改 → 只动 `build_theme.py` 常量出 rc2)
## 阶段 6 · 部署上线 — 等待批准
- [x] 6.1 `scripts/deploy.sh`:默认**预演**,列出将复制的文件与备份路径,零改动
- [x] 6.2 `--yes` 真部署:`tar` 备份 → `rsync custom/` → `chown -R git:git` → `systemctl restart gitea`
- [x] 6.3 `--patch-ini`:备份 `app.ini` 后把 `[ui]` 改为 `DEFAULT_THEME=qq-auto` 并追加 `qq-auto,qq-light,qq-dark`
- [x] 6.4 `scripts/rollback.sh` + `docs/DEPLOY.md`(含部署后 7 项自查清单)
- [!] 6.5 **必须由 QQ 明确批准后才能执行** `./scripts/deploy.sh --yes`
- [ ] 6.6 部署后验收,通过则打标签 `v1.0-live`
## 已知遗留(不在本次范围)
- [ ] 服务器 `dpkg --audit` 中 openresty / openresty-opm / openresty-resty 处于半配置状态
(**既有问题,非本次引入**;装 `librsvg2-bin` 时被触发,已 `stop` + `reset-failed`,站点仍 200)