QQgit/docs/TODO.md

5.0 KiB
Raw Blame History

TODO · Gitea 蓝白 ins 风外观定制(v1.0)

本文件是仓库里的持久化清单;GUI 会话里还有一份同名 todo 面板,两者内容一致。 状态:[x] 完成 [~] 进行中 [ ] 未开始 [!] 等待批准

阶段 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 密码,.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/:image-ca10a7ce.png(日间)、image-33a59194.png(夜间)
  • 2.3 矢量 SVG:logo.svg(内嵌 @media (prefers-color-scheme:dark) 自动换色)、 logo-light.svg、logo-dark.svg、favicon.svg(32 栅格重绘,非缩放)
  • 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
  • 4.4 custom/templates/custom/footer.tmpl:.qq-footer 页脚(ICP 备案号留注释占位)
  • 4.5 custom/templates/home.tmpl:基于官方精简,logo 168×168 + 三卡首页(沿用官方 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 备份 → rsync 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.8 覆盖 custom/templates/base/footer_content.tmpl:删掉官方整条页脚(Powered by Gitea / 版本 / 耗时 / 语言 / 许可证 / API),改为悬挂式页脚显示 闽ICP备2023002932号(position:fixed 贴底 + body{padding-bottom:42px},2026-11-03 已部署)
  • 6.7 部署后修补:语言圆点统一品牌蓝(压掉 Shell 亮绿)、页脚去重(不再出现两行 Powered by Gitea)、主题选择器显示名改为 QQGit · 浅色/深色/跟随系统

部署记录

时间 动作 备份
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/ 最新包

app.ini 每次改动前都另存 app.ini.bak-<时间戳>。

已知遗留(不在本次范围)

  • 服务器 dpkg --audit 中 openresty / openresty-opm / openresty-resty 处于半配置状态 (既有问题,非本次引入;装 librsvg2-bin 时被触发,已 stop + reset-failed,站点仍 200)