From b9c3c1a9120165faca163116d87723fd4be56191 Mon Sep 17 00:00:00 2001 From: QQ Date: Tue, 3 Nov 2026 10:36:00 +0800 Subject: [PATCH] =?UTF-8?q?docs(todo):=20=E9=87=8D=E5=86=99=E8=BF=9B?= =?UTF-8?q?=E5=BA=A6=E6=B8=85=E5=8D=95=EF=BC=8C=E8=A1=A5=E9=BD=90=20v1.1?= =?UTF-8?q?=20=E5=8A=A8=E6=95=88=E5=B1=82=E4=B8=8E=E5=85=A8=E9=83=A8?= =?UTF-8?q?=E9=83=A8=E7=BD=B2=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 顶部加「当前状态」表(线上地址 / 版本 / 生效主题 / 当前标签 / 仓库 / 回滚方式) - 阶段 6 标记完成;新增阶段 7 动效层(7.1–7.7 全勾) - 部署记录补全 7 条(含 favicon ?v=2、备案号页脚、动效层两次、登录布局单文件 cp) - 新增「待办 / 可选增强」8.1–8.5:公安备案号、登录后语言切换、favicon 缓存、内页微调、移动端实拍 --- docs/TODO.md | 83 ++++++++++++++++++++++++++++++++-------------------- 1 file changed, 52 insertions(+), 31 deletions(-) diff --git a/docs/TODO.md b/docs/TODO.md index 3419e2c..cfdc25f 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -1,14 +1,23 @@ -# TODO · Gitea 蓝白 ins 风外观定制(v1.0) +# TODO · QQGit 蓝白 ins 风外观定制 -> 本文件是仓库里的持久化清单;GUI 会话里还有一份同名 todo 面板,两者内容一致。 -> 状态:`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准 +> 仓库里唯一持久化的进度清单。`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准 + +## 当前状态(2026-11-03) + +| 项目 | 值 | +| --- | --- | +| 线上地址 | | +| Gitea 版本 | 1.21.11(`bindata, sqlite`) | +| 生效主题 | `DEFAULT_THEME = qq-auto`(浅色 `qq-light` / 深色 `qq-dark` / 跟随系统 `qq-auto`) | +| 当前标签 | `v1.1-live`(动效层上线) | +| 源码仓库 | (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 密码,`.gitignore` 排除,不进仓库) +- [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`) @@ -16,11 +25,9 @@ ## 阶段 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.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 — 完成 @@ -35,9 +42,9 @@ - [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) +- [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 · 离线预览与候选版 — 完成 @@ -47,37 +54,51 @@ - [x] 5.4 提交并打标签 `v1.0-rc1` - [x] 5.5 QQ 在预览页验收通过(2026-11-03),直接进入阶段 6 -## 阶段 6 · 部署上线 — 等待批准 +## 阶段 6 · 部署上线 — 完成 - [x] 6.1 `scripts/deploy.sh`:默认**预演**,列出将复制的文件与备份路径,零改动 -- [x] 6.2 `--yes` 真部署:`tar` 备份 → `rsync custom/` → `chown -R git:git` → `systemctl restart gitea` +- [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.8 覆盖 `custom/templates/base/footer_content.tmpl`:删掉官方整条页脚(Powered by Gitea / 版本 / 耗时 / 语言 / 许可证 / API),改为悬挂式页脚显示 **闽ICP备2023002932号**(`position:fixed` 贴底 + `body{padding-bottom:42px}`,2026-11-03 已部署) - [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) | `/var/backups/gitea-custom-20261103-093751.tar.gz` | -| 2026-11-03 09:39 | 语言圆点 + 页脚去重 二次部署 | `/var/backups/gitea-custom-20261103-093913.tar.gz` | -| 2026-11-03 09:xx | 主题显示名修补 三次部署 | 见 `/var/backups/` 最新包 | +| 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 10:32 | 登录表单一行式布局(手工 `cp` 单文件,未经 `deploy.sh`) | 无(同上包内其余文件不变) | -`app.ini` 每次改动前都另存 `app.ini.bak-<时间戳>`。 +`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` 时被触发,已 `stop` + `reset-failed`,站点仍 200) - -## v1.1 动效层(首页 + 登录页) - -- [x] 7.1 `qq-fx.css` / `qq-fx.js`:粒子星座、旋转光环、渐变标题、打字口号、毛玻璃卡片 -- [x] 7.2 登录页卡片化(不覆盖模板,纯 CSS 作用域 `.page-content.user.signin`) -- [x] 7.3 页脚补语言切换(`{{if not .SignedUser}}` + `/?lang=xx` 纯链接,不依赖 JS) -- [x] 7.4 修复 index.css 干扰:`.page-footer` 窄屏 column/space-between、`.inline.field` 堆叠 → 全部用显式 flex 规则钉死 -- [x] 7.5 上线并实拍验证(桌面浅色 / 登录页 / 深色走预览图) -- [ ] 7.6 待 QQ 提供公安联网备案号后追加 + (装 `librsvg2-bin` 时 dpkg 顺带尝试配置 openresty 失败,端口 80 被 nginx 占用;已 `stop` + `reset-failed`,站点仍 200,**未去修复以免动生产**)