QQgit/docs/TODO.md

63 行
4.1 KiB
Markdown
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 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)