QQgit/docs/TODO.md

11 KiB
Raw Blame History

TODO · QQGit 蓝白 ins 风外观定制

仓库里唯一持久化的进度清单。[x] 完成 [~] 进行中 [ ] 未开始 [!] 等待批准

当前状态(2026-11-05)

项目 值
线上地址 https://git.qyhhh.top
Gitea 版本 1.21.11(生产数据库:MySQL)
生效主题 DEFAULT_THEME = qq-auto(浅色 qq-light / 深色 qq-dark / 跟随系统 qq-auto)
当前标签 v1.3.13-live(搜索框去内框 + 最近动态首项直角修复)
进行中 v1.4 未登录落地页(方案 A 首屏 + 方案 B 仓库卡,见 docs/PLAN-landing-v1.4.md)
源码仓库 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(commit 62b45b2)

阶段 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 Mono woff2(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-color meta + 带版本号的 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 + input flex:1,登录容器 430px → 560px
  • 7.5 修 headless 截图假故障:html, body 的 transition 会冻在过渡起始值,导致深色预览发白;删过渡 + prefers-reduced-motion 全关动画
  • 7.6 提交 dd19bbb(tag v1.1-rc1)→ 部署 → 实拍复核 → 修布局 25d8895(tag v1.1-live)
  • 7.7 移动端 375px 适配:光斑横向溢出裁剪、光环与标题字号压缩

阶段 8 · 落地页 v1.4(方案 A + B)— 进行中,等待 QQ 批准上线

  • 8.1 按 docs/PLAN-landing-v1.4.md 重写 custom/templates/home.tmpl:首屏左 7 / 右 5 分栏(标题 / 口号 / 搜索 / 双按钮 + 毛玻璃分支图 + terminal 复制窗)
  • 8.2 新增 custom/public/assets/js/qq-home.js:公开 API 取数(sort=updated,客户端按星标→更新时间排序,排除 fork/镜像/私有/归档),骨架屏 → 3 张卡片;失败或 0 条静默隐藏
  • 8.3 qq-pages.css 重写落地页段(1280px 限宽、蓝白色阶、语言圆点仅品牌蓝、hover / 焦点环、暗色变量、1024 / 640 断点、reduced-motion);Dashboard 段原样保留
  • 8.4 删除数字条(方案 A);三张功能卡降级为分隔线下方收尾
  • 8.5 离线预览更新:preview/index.html 首页段 + 假数据 6 条、?only=home&bare=1 截图模式、preview/mobile-frame.html 供 375px 复核(headless Chrome 窗口宽度下限 500px)
  • 8.6 截图 1440 / 834 / 375 的浅色与深色;audit_colors.py、check_preview.py 全绿
  • [!] 8.7 待 QQ 看过截图后:提交并打标签 v1.4-rc1 → ./scripts/deploy.sh 预演 → 批准后 --yes → 实拍复核 → 打标签 v1.4-live

部署记录

时间 动作 备份
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,未去修复以免动生产)