From 4060020965fadcf49705cdda7f9f8a94b2a978b5 Mon Sep 17 00:00:00 2001 From: QQ Date: Mon, 2 Nov 2026 18:25:37 +0800 Subject: [PATCH] =?UTF-8?q?docs(todo):=20=E5=88=86=E9=98=B6=E6=AE=B5?= =?UTF-8?q?=E4=BB=BB=E5=8A=A1=E6=B8=85=E5=8D=95=E8=90=BD=E7=9B=98=E4=B8=BA?= =?UTF-8?q?=20docs/TODO.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 3 ++- docs/TODO.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 docs/TODO.md diff --git a/README.md b/README.md index 6b33e58..cddf1d3 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,8 @@ │ └── public/assets/ # css(qq-ui + 3 主题)/ img(Logo 全套)/ fonts ├── preview/ # 离线可视化预览画廊(本地打开即可看效果,无需线上改动) ├── scripts/ # build_theme.py / audit_colors.py / deploy.sh / rollback.sh -└── docs/DEPLOY.md # 部署与回滚手册 +├── docs/DEPLOY.md # 部署与回滚手册 +└── docs/TODO.md # 分阶段任务清单(本仓库的持久化 todo) ``` ## 四、看预览(不碰线上) diff --git a/docs/TODO.md b/docs/TODO.md new file mode 100644 index 0000000..3cb6ff9 --- /dev/null +++ b/docs/TODO.md @@ -0,0 +1,62 @@ +# TODO · Gitea 蓝白 ins 风外观定制(v1.0) + +> 本文件是仓库里的持久化清单;GUI 会话里还有一份同名 todo 面板,两者内容一致。 +> 状态:`[x]` 完成 `[~]` 进行中 `[ ]` 未开始 `[!]` 等待批准 + +## 阶段 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.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/`:`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.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 +- [x] 4.4 `custom/templates/custom/footer.tmpl`:`.qq-footer` 页脚(ICP 备案号留注释占位) +- [x] 4.5 `custom/templates/home.tmpl`:基于官方精简,logo 168×168 + 三卡首页(沿用官方 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` +- [ ] 5.5 **等 QQ 在预览页验收**(满意 → 进入阶段 6;要改 → 只动 `build_theme.py` 常量出 rc2) + +## 阶段 6 · 部署上线 — 等待批准 + +- [x] 6.1 `scripts/deploy.sh`:默认**预演**,列出将复制的文件与备份路径,零改动 +- [x] 6.2 `--yes` 真部署:`tar` 备份 → `rsync 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 项自查清单) +- [!] 6.5 **必须由 QQ 明确批准后才能执行** `./scripts/deploy.sh --yes` +- [ ] 6.6 部署后验收,通过则打标签 `v1.0-live` + +## 已知遗留(不在本次范围) + +- [ ] 服务器 `dpkg --audit` 中 openresty / openresty-opm / openresty-resty 处于半配置状态 + (**既有问题,非本次引入**;装 `librsvg2-bin` 时被触发,已 `stop` + `reset-failed`,站点仍 200)