# TODO · QQGit 蓝白 ins 风外观定制 > 仓库里唯一持久化的进度清单。`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准 ## 当前状态(2026-11-03) | 项目 | 值 | | --- | --- | | 线上地址 | | | Gitea 版本 | 1.21.11(`bindata, sqlite`) | | 生效主题 | `DEFAULT_THEME = qq-auto`(浅色 `qq-light` / 深色 `qq-dark` / 跟随系统 `qq-auto`) | | 当前标签 | `v1.2.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 密码的整份 `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 右上角胶囊切换 浅色 / 自动 / 深色(切 ``,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 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,**未去修复以免动生产**)