8.7 KiB
8.7 KiB
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.1-live(控制台铺满整屏) |
| 源码仓库 | https://github.com/newbieQQ/QQGit(private) |
| 回滚方式 | ./scripts/rollback.sh /var/backups/gitea-custom-<时间戳>.tar.gz |
阶段 1 · Git 基线与素材归档 — 完成
- 1.1
git init -b main,user.name=QQ、user.email=qq@qyhhh.top - 1.2 快照线上
/var/lib/gitea/custom→baseline/custom/ - 1.3 快照
/etc/gitea/app.ini的[ui]段 →baseline/app-ini/ui-section.txt(含 SMTP 密码的整份app.ini已被.gitignore排除) - 1.4
gitea embedded view导出官方 1.21.11 模板 23 个 →upstream-templates-1.21.11/ - 1.5 导出官方
index.css/theme-auto.css作为变量派生源 →vendor/ - 1.6 提交并打标签
v0.0-baseline(commit62b45b2)
阶段 2 · Logo 套件 — 完成
- 2.1 决策锁定 方案 2-A:日间
#60A5FA圆章 + 纯白负空间 Git-Q;夜间仅把圆章提到#38BDF8 - 2.2 原图归档
design-assets/:logo-2a-light-raw.png(日间)、logo-2a-dark-raw.png(夜间) - 2.3 矢量 SVG:
logo.svg(内嵌@media (prefers-color-scheme:dark)自动换色)、logo-light.svg、logo-dark.svg、favicon.svg - 2.4 位图导出:
logo.png(512)、logo-dark.png(512)、favicon.png(180)、apple-touch-icon.png(180)、favicon-32.png(32) - 2.5 三底色目视确认(
#FFFFFF/#0D1117/#161B22):圆外 100% 透明,无白框
阶段 3 · 三套主题 CSS — 完成
- 3.1
scripts/build_theme.py:解析官方:root→ 叠加台面/主色 → 派生 primary 明暗族与 alpha 族 - 3.2
degreen():色相 60–170°(绿/黄绿)统一转 188° 青蓝,保留明度与饱和度 - 3.3 修正则坑:
url("data:image/svg+xml;...")值被截断 → 改用支持引号的表达式并跳过 degreen - 3.4 产出
theme-qq-auto.css/theme-qq-light.css/theme-qq-dark.css(各 243 变量) - 3.5
scripts/audit_colors.py审计:三套主题无绿色残留,全部通过
阶段 4 · 模板钩子与细节层 — 完成
- 4.1 本地内置
JetBrains Monowoff2(400/500/700),不走 CDN - 4.2
custom/public/assets/css/qq-ui.css:字体、8px 圆角、顶栏毛玻璃、滚动条、卡片、页脚 - 4.3
custom/templates/custom/header.tmpl:preload 字体 + 引入qq-ui.css+theme-colormeta + 带版本号的 favicon 链接 - 4.4
custom/templates/custom/footer.tmpl:默认留空(页脚改由base/footer_content.tmpl覆盖承载) - 4.5
custom/templates/home.tmpl:基于官方精简,logo + 三卡首页(沿用官方 i18n key)
阶段 5 · 离线预览与候选版 — 完成
- 5.1
preview/index.html:首页 / 仓库列表 / 文件页+代码块 / 组件 / Logo 双底色校验 5 段 - 5.2 右上角胶囊切换 浅色 / 自动 / 深色(切
<link disabled>,localStorage 记忆) - 5.3
scripts/check_preview.py:变量、类名、日夜媒体查询全绿;24 个资源引用零缺失 - 5.4 提交并打标签
v1.0-rc1 - 5.5 QQ 在预览页验收通过(2026-11-03),直接进入阶段 6
阶段 6 · 部署上线 — 完成
- 6.1
scripts/deploy.sh:默认预演,列出将复制的文件与备份路径,零改动 - 6.2
--yes真部署:tar备份 → 拷贝custom/→chown -R git:git→systemctl restart gitea - 6.3
--patch-ini:备份app.ini后把[ui]改为DEFAULT_THEME=qq-auto并追加qq-auto,qq-light,qq-dark - 6.4
scripts/rollback.sh+docs/DEPLOY.md(含部署后 7 项自查清单) - 6.5 已获 QQ 明确批准并执行
./scripts/deploy.sh --yes --patch-ini(2026-11-03 09:37) - 6.6 部署后验收通过,已打标签
v1.0-live - 6.7 部署后修补:语言圆点统一品牌蓝(压掉 Shell 亮绿)、页脚去重(不再出现两行 Powered by Gitea)、主题选择器显示名改为
QQGit · 浅色/深色/跟随系统 - 6.8 覆盖
custom/templates/base/footer_content.tmpl:删掉官方整条页脚(Powered by Gitea / 版本 / 耗时 / 语言 / 许可证 / API),改为悬挂式页脚显示 闽ICP备2023002932号(position:fixed贴底 +body{padding-bottom:42px})
阶段 7 · 动效层(首页 + 登录页)— 完成,已上线
- 7.1
custom/public/assets/js/qq-fx.js:仅 home / signin 生效,Canvas 粒子星座(DPR≤2、按面积定点、近邻连线)、口号打字机、hero 鼠标光斑;prefers-reduced-motion只画一帧静态星图 - 7.2
custom/public/assets/css/qq-fx.css:光雾漂移、conic 渐变旋转光环、渐变流动标题、毛玻璃卡片;登录页卡片化(不覆盖模板,纯 CSS 作用域.page-content.user.signin) - 7.3 页脚补语言切换:
{{if not .SignedUser}}+/?lang=zh-CN|en-US纯链接(刻意不用.ui.dropdown,那个依赖 index.js 初始化) - 7.4 修复官方样式干扰:
.page-footer窄屏被改成column+space-between→ 用!important钉死row/nowrap/center;.inline.field窄容器退化成堆叠 → 显式flex row+ label 96px + inputflex:1,登录容器 430px → 560px - 7.5 修 headless 截图假故障:
html, body的transition会冻在过渡起始值,导致深色预览发白;删过渡 +prefers-reduced-motion全关动画 - 7.6 提交
dd19bbb(tagv1.1-rc1)→ 部署 → 实拍复核 → 修布局25d8895(tagv1.1-live) - 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 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,未去修复以免动生产)