QQgit/docs/TODO.md

113 lines
9.2 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 · QQGit 蓝白 ins 风外观定制
> 仓库里唯一持久化的进度清单。`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准
## 当前状态(2026-11-03)
| 项目 | 值 |
| --- | --- |
| 线上地址 | <https://git.qyhhh.top> |
| Gitea 版本 | 1.21.11(`bindata, sqlite`) |
| 生效主题 | `DEFAULT_THEME = qq-auto`(浅色 `qq-light` / 深色 `qq-dark` / 跟随系统 `qq-auto`) |
| 当前标签 | `v1.3.3-live`(右栏去重 + 热力图单层框) |
| 源码仓库 | <https://github.com/newbieQQ/QQGit>(private) |
| 回滚方式 | `./scripts/rollback.sh /var/backups/gitea-custom-<时间戳>.tar.gz` |
## 阶段 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 密码的整份 `app.ini` 已被 `.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/`:`logo-2a-light-raw.png`(日间)、`logo-2a-dark-raw.png`(夜间)
- [x] 2.3 矢量 SVG:`logo.svg`(内嵌 `@media (prefers-color-scheme:dark)` 自动换色)、`logo-light.svg`、`logo-dark.svg`、`favicon.svg`
- [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 + 带版本号的 favicon 链接
- [x] 4.4 `custom/templates/custom/footer.tmpl`:默认留空(页脚改由 `base/footer_content.tmpl` 覆盖承载)
- [x] 4.5 `custom/templates/home.tmpl`:基于官方精简,logo + 三卡首页(沿用官方 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`
- [x] 5.5 QQ 在预览页验收通过(2026-11-03),直接进入阶段 6
## 阶段 6 · 部署上线 — 完成
- [x] 6.1 `scripts/deploy.sh`:默认**预演**,列出将复制的文件与备份路径,零改动
- [x] 6.2 `--yes` 真部署:`tar` 备份 → 拷贝 `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 项自查清单)
- [x] 6.5 已获 QQ 明确批准并执行 `./scripts/deploy.sh --yes --patch-ini`(2026-11-03 09:37)
- [x] 6.6 部署后验收通过,已打标签 `v1.0-live`
- [x] 6.7 部署后修补:语言圆点统一品牌蓝(压掉 Shell 亮绿)、页脚去重(不再出现两行 Powered by Gitea)、主题选择器显示名改为 `QQGit · 浅色/深色/跟随系统`
- [x] 6.8 覆盖 `custom/templates/base/footer_content.tmpl`:删掉官方整条页脚(Powered by Gitea / 版本 / 耗时 / 语言 / 许可证 / API),改为悬挂式页脚显示 **闽ICP备2023002932号**(`position:fixed` 贴底 + `body{padding-bottom:42px}`)
## 阶段 7 · 动效层(首页 + 登录页)— 完成,已上线
- [x] 7.1 `custom/public/assets/js/qq-fx.js`:仅 home / signin 生效,Canvas 粒子星座(DPR≤2、按面积定点、近邻连线)、口号打字机、hero 鼠标光斑;`prefers-reduced-motion` 只画一帧静态星图
- [x] 7.2 `custom/public/assets/css/qq-fx.css`:光雾漂移、conic 渐变旋转光环、渐变流动标题、毛玻璃卡片;登录页卡片化(**不覆盖模板**,纯 CSS 作用域 `.page-content.user.signin`)
- [x] 7.3 页脚补语言切换:`{{if not .SignedUser}}` + `/?lang=zh-CN|en-US` **纯链接**(刻意不用 `.ui.dropdown`,那个依赖 index.js 初始化)
- [x] 7.4 修复官方样式干扰:`.page-footer` 窄屏被改成 `column` + `space-between` → 用 `!important` 钉死 `row/nowrap/center`;`.inline.field` 窄容器退化成堆叠 → 显式 `flex row` + label 96px + input `flex:1`,登录容器 430px → 560px
- [x] 7.5 修 headless 截图假故障:`html, body` 的 `transition` 会冻在过渡起始值,导致深色预览发白;删过渡 + `prefers-reduced-motion` 全关动画
- [x] 7.6 提交 `dd19bbb`(tag `v1.1-rc1`)→ 部署 → 实拍复核 → 修布局 `25d8895`(tag `v1.1-live`)
- [x] 7.7 移动端 375px 适配:光斑横向溢出裁剪、光环与标题字号压缩
## 部署记录
| 时间 | 动作 | 备份 |
| --- | --- | --- |
| 2026-11-03 09:37 | 首次上线:`deploy.sh --yes --patch-ini`(custom/ 全量 + `[ui]` 切 `qq-auto`) | `gitea-custom-20261103-093751.tar.gz` |
| 2026-11-03 09:39 | 语言圆点统一品牌蓝 + 页脚去重 | `gitea-custom-20261103-093913.tar.gz` |
| 2026-11-03 09:40 | 主题选择器显示名(`QQGit · 浅色/深色/跟随系统`) | `gitea-custom-20261103-094007.tar.gz` |
| 2026-11-03 09:59 | favicon 链接加 `?v=2` 绕过浏览器缓存 | `gitea-custom-20261103-095919.tar.gz` |
| 2026-11-03 10:04 | 页脚改造:删官方整条页脚,悬挂 ICP 备案号 | `gitea-custom-20261103-100439.tar.gz` |
| 2026-11-03 10:21 | **v1.1 动效层**首次上线(`qq-fx.css` / `qq-fx.js`)+ 页脚语言切换 | `gitea-custom-20261103-102149.tar.gz` |
| 2026-11-03 10:29 | 页脚居中修正 + 登录容器加宽 | `gitea-custom-20261103-102905.tar.gz` |
| 2026-11-03 14:28 | 页脚三段重排:左站点信息 / 中语言切换 / 右备案号(并补回被误删的语言切换) | `gitea-custom-20261103-142818.tar.gz` |
| 2026-11-03 11:05 | 控制台改为 GitHub 式限宽 1280 居中(非硬拉满屏) | `gitea-custom-20261103-110520.tar.gz` |
| 2026-11-03 11:14 | 右栏去重:删「我的组织」卡与新建仓库/组织入口,改「快捷入口」;热力图压平内层框 | `gitea-custom-20261103-111314.tar.gz` / `-111442.tar.gz` |
| 2026-11-03 11:02 | 控制台铺满整屏(去掉 1400px 限宽) | 见 `/var/backups/` 最新包 |
| 2026-11-03 11:00 | 右栏站点信息搬到底部条;右栏改「常用操作 + 我的组织」;清掉 summary 原生 ▶ | `gitea-custom-20261103-110017.tar.gz` |
| 2026-11-03 10:55 | 去掉 Logo 旋转光环 → 静态柔光;样式表加 `?v=3` | `gitea-custom-20261103-105538.tar.gz` |
| 2026-11-03 10:52 | 快捷导航折叠面板 + 三栏首行对齐(`--qq-row:34px`) | `gitea-custom-20261103-105231.tar.gz` |
| 2026-11-03 10:32 | 登录表单一行式布局(手工 `cp` 单文件,未经 `deploy.sh`) | 无(同上包内其余文件不变) |
| 2026-11-03 10:46 | **v1.2 GitHub 版式**:未登录落地页 + 登录后控制台(`qq-pages.css`、`home.tmpl`、`user/dashboard/dashboard.tmpl`) | `gitea-custom-20261103-104637.tar.gz` |
`app.ini` 每次改动前都另存 `/etc/gitea/app.ini.bak-<时间戳>`。
## 待办 / 可选增强
- [ ] 8.1 **公安联网备案号**:QQ 提供后并排加到 ICP 后面(`闽公网安备 …号`)
- [ ] 8.2 登录页语言切换目前只在**未登录**时出现;是否登录后也保留一个,待定
- [!] 8.3 favicon 在 QQ 的浏览器里仍需手动清缓存(无痕窗口可验证已生效;书签/主屏图标要删掉重加)
- [ ] 8.4 仓库页 / 设置页等内页是否也要微调(当前只动了首页与登录页)
- [ ] 8.5 线上移动端实拍复核(预览页的窄屏图只作参考,以 Gitea 自身响应式布局为准)
## 已知遗留(非本项目引入)
- [ ] 服务器 `dpkg --audit` 中 openresty / openresty-opm / openresty-resty 处于半配置状态
(装 `librsvg2-bin` 时 dpkg 顺带尝试配置 openresty 失败,端口 80 被 nginx 占用;已 `stop` + `reset-failed`,站点仍 200,**未去修复以免动生产**)