feature/gitea-branding
dev
自建 Gitea(https://git.f.novalon.cn)从出厂外观换成「睿新致遠 / NOVALON」品牌,并顺路补上落后的两个安全版本。
https://git.f.novalon.cn
1.27.2 → 28.2.0
fix(git): restrict hook permissions
packObjectsHook
EGRESS_MODE=strict
infra/cicd/gitea-custom/
CustomPath=/data/gitea
infra/cicd/gitea/docker-compose.live.yml
novalon-brand.css
--color-primary
#C41E3A
#E13C58
custom/header.tmpl
signin_inner.tmpl
APP_NAME
CONTEXT.md
docs/lessons-learned.md
零 src/** 改动:本轮全部落在 infra/、docs/ 与四份项目级文档。
src/**
infra/
docs/
关闭:N/A
来源:本轮由「Gitea 能否按最新 logo 做自定义装饰」的口头需求直接展开,无对应 Issue;执行计划与判据见会话内批准的 plan 与 docs/acceptance/2026-10-22-gitea-branding/README.md。
docs/acceptance/2026-10-22-gitea-branding/README.md
硬性要求:提交 PR 前必须通过 bash scripts/check-pr-checklist.sh <本描述文件>,确保模板三节完整且所有 checklist 子项均已勾选。 不适用的子项仍须勾选并在行尾注明 N/A:<理由>;留空未勾选即视为门禁未过。
bash scripts/check-pr-checklist.sh <本描述文件>
N/A:<理由>
跨层变更(页面 ↔ 组件 ↔ CMS 内容模型 ↔ seed ↔ 测试)必须完成以下检查:
npm run type-check
TYPECHECK_EXIT=0
tsc --noEmit
npm run lint
LINT_EXIT=0
84 problems (0 errors, 84 warnings)
.sh/.py/.cjs/.md/.yml/.svg/.png
.cjs
infra/cicd/gitea-custom
href
Link
href="#"
https://www.novalon.cn
/assets/img/*
/assets/css/novalon-brand.css
verify-branding.sh
prisma/**
npm run db:seed
docs/acceptance/2026-10-22-gitea-branding/
next dev
--color-primary*
#0D0D0D
#navbar
console.log
TODO
FIXME
.only()
deploy-branding.sh
参考 docs/testing.md 与 docs/testing-guide.md
docs/testing.md
docs/testing-guide.md
build-brand-css.py
check-assets.py
name="user_name"
name="password"
action=
type="submit"
e2e/visual-snapshots
rgb(196,30,58)
rgb(225,60,88)
3px
display:none
<text>
npm run test:unit
npm run check:contrast
patch-compose.py
patch-app-ini.py
npm run test:coverage
coverageThreshold
config/test/jest.config.js
npm run test
git ls-remote
npm run check:headings
check:contrast
check:headings
DEVIATIONS
npm run lighthouse
lhci
next.config.mjs
public/**
npm run test:security:headers
README.md
CLAUDE.md
docs/deployment/cicd/README.md
infra/cicd/gitea-custom/README.md
DESIGN.md
PRODUCT.md
feat(gitea): …
CustomPath
chown
pg_dump
DROP
测试全绿 ≠ 功能可用。以下条目用于区分「验证过了」与「看起来验证过了」。
GITEA__server__APP_NAME
GITEA__DEFAULT__APP_NAME
[default]
$$
> /dev/null
docker cp
skip
todo
docs/acceptance/qa-tracker.md
origin/*
docker inspect
gitea help
gitea embedded extract
REQUIRE_SIGNIN_VIEW
/explore
gitea/gitea:28.2.0
/root/gitea-brand-backup-<TS>.tgz
/root/app.ini.bak-brand-<TS>
docker-compose.yml.bak-brand-<TS>
/root/gitea-pre28-*.sql
REQUIRE_SIGNIN_VIEW=false
SSH_PORT=22
2222:22
docs/deployment/cicd/03-credential-incident.md
cat
SECRET_KEY
INTERNAL_TOKEN
提交前执行:bash scripts/check-pr-checklist.sh 验证所有 checklist 子项已勾选。
bash scripts/check-pr-checklist.sh
自建 Gitea 此前是出厂外观(茶杯标 + 「Gitea: Git with a cup of tea」标题),而品牌「纯字标 + 朱砂条」已在官网落地;同时现网 1.27.2 落后两个安全版本 —— 1.27.3 的 fix(git): restrict hook permissions 打的正是本实例 8 月被入侵所用的 packObjectsHook 向量。装饰基准取自升级后从容器抽出的真实模板,不凭记忆手写。 - 升级 28.2.0:pg_dump 后还原到一次性探针库对账(116 表 / 20 仓库 / 8 用户全等),停服 8s;28.0.0 的 git egress BREAKING 按裁定收为 EGRESS_MODE=strict(实测 app.ini 无旧 ALLOWED_* 键、mirror 仓库 0 个 ⇒ 空白名单不伤业务)。 - 装饰层真源入库 infra/cicd/gitea-custom/(结构即实测 CustomPath=/data/gitea):页头/OG/默认头像换简标与刻版、novalon- brand.css 覆盖 --color-primary 全色阶、custom/header.tmpl 外链注入、signin_inner.tmpl 登录页加字标锁定(220×103)。 - 色阶由脚本生成并自带夹具:先对上游 14 档对账(light/dark 两档 ramp 命名互为反向,手敲必错),再喂上游蓝做反向自证,双双通过才写盘。 - 深档按钮改「黑字朱底」:Gitea 用同一令牌既当按钮底色又当链接文字色,AA 区间为空(按钮白字 L≤0.1833 vs 链接 on #1e1f20 L≥0.2362)⇒ #E13C58 × #0D0D0D 实测 4.62:1;深档链接 3.92:1 作为已登记让步保留(上游蓝同位 4.14,本就不达标)。 - deploy/verify 带预检、备份、内容 sha256 比对、负对照与 0/1/2/3 退出码分档,核心判红自动回滚(首轮就靠它把「标题未生效」与「装饰未生效」区分开)。 - 纠正两处生产口径失真:仓库那份「加固版」compose 从未上线(真实文件纳管为 infra/cicd/gitea/docker-compose.live.yml);生产 REQUIRE_SIGNIN_VIEW 实为 false,且 compose 的 DISABLE_REGISTRATION=false 会经 environment-to-ini 在重建时静默打开注册 —— 已对齐为 true。遗留的匿名浏览面与 SSH_PORT 错配只登记不擅动。
No dependencies set.
The note is not visible to the blocked user.
变更摘要
自建 Gitea(
https://git.f.novalon.cn)从出厂外观换成「睿新致遠 / NOVALON」品牌,并顺路补上落后的两个安全版本。1.27.2 → 28.2.0:1.27.3 含 16 条 SECURITY 修复,其中fix(git): restrict hook permissions(#39008)打的正是本实例 8 月被入侵所用的packObjectsHook向量;28.x 另带审计日志(#38189)。28.0.0 的 git egress BREAKING 已按裁定收为EGRESS_MODE=strict。infra/cicd/gitea-custom/(结构即实测CustomPath=/data/gitea)+infra/cicd/gitea/docker-compose.live.yml(生产编排的真实副本,此前只存在于服务器)。novalon-brand.css覆盖--color-primary全色阶(浅#C41E3A/ 深#E13C58)、custom/header.tmpl外链注入、signin_inner.tmpl登录页加字标锁定、导航加「官网」项、APP_NAME去出厂串。CONTEXT.md与docs/lessons-learned.md§5.52)。零
src/**改动:本轮全部落在infra/、docs/与四份项目级文档。关联 Issue
关闭:N/A
提交前检查
全链路检查
跨层变更(页面 ↔ 组件 ↔ CMS 内容模型 ↔ seed ↔ 测试)必须完成以下检查:
npm run type-check通过(0 error)— 实测TYPECHECK_EXIT=0(本树tsc --noEmit无输出)npm run lint通过:0 error,且 warning 数未新增(须与改动前基线逐行比对,不接受「本来就有一堆告警」)— 实测LINT_EXIT=0、84 problems (0 errors, 84 warnings);本次未新增任何被 lint 覆盖的语言文件(新增物为.sh/.py/.cjs/.md/.yml/.svg/.png,其中.cjs不在 eslint 项目配置范围内,已确认 lint 输出里无infra/cicd/gitea-custom条目)href、Link目标均已确认真实存在,无href="#"死链、无 404 死路 — 新增外链仅一枚https://www.novalon.cn(域名口径取仓库内主用写法:实测 269 处 vs 裸域 60 处);模板内资源路径/assets/img/*、/assets/css/novalon-brand.css全部由verify-branding.sh按内容 sha256 断言为 200 且与仓库文件逐字节相等,不是「200 就算过」src/**与零prisma/**改动,未触达内容模型;不需要重跑npm run db:seeddocs/acceptance/2026-10-22-gitea-branding/;本站next dev未涉及(无页面改动)--color-primary*,装饰 CSS 里除#0D0D0D(按钮文字色,甲方裁定的「黑字朱底」)外不写死任何色值,且脚本对「蓝残留」判红#navbar边框#C41E3A:每页 ≥ 3 处触达点,覆盖面积 ≤ 10% — 登录页实测触达点 4 处(页头简标底、#navbar朱砂条 3px、主按钮底色、链接与必填星号),朱砂为点缀非铺底;面积上限判据沿用品牌手册,本轮未做全站逐页统计(内部工具,非营销面)console.log/TODO/FIXME/.only()— 新增脚本无;deploy-branding.sh的打印是运维输出不是调试残留测试分层检查(L0–L3)
src/**改动,无新增工具函数/Hook/CMS 渲染器。替代验证:build-brand-css.py与check-assets.py各自内置「夹具对账 + 反向自证」,不通过就不写盘(详见下条)verify-branding.sh断言:登录页表单name="user_name"/name="password"/action=/type="submit"四项必须在场(模板覆盖改坏会当场判红并自动回滚)e2e/visual-snapshots,本站视觉基线 132 张与本轮无交集。Gitea 侧的「视觉回归」是 4 张真尺寸截图 + 计算样式探针(rgb(196,30,58)/rgb(225,60,88)/3px/ 字标 220×103 / 另一版display:none)build-brand-css.py先拿上游 14 档色阶做夹具对账(逐通道偏差 ≤1 才继续),再喂上游蓝要求「蓝残留」与「对比度不达标」双双判红(实测抓 50 + 2 处);②check-assets.py造 4 个明知违规的样本(含<text>、缺 viewBox、尺寸不符、清单文件缺失)要求全部判红,实测 4/4;③verify-branding.sh每次跑都请求一个不存在的路径,必须 404,否则前面的比对全部作废.only()/ 跳过态残留 —npm run test:unit、npm run check:contrast(44/44)实测通过;patch-compose.py/patch-app-ini.py在生产文件的本地副本上跑过首次 / 幂等重跑 / 缺锚点负对照三态质量门禁
npm run test:unit全部通过 — 本树实测,输出见 PR 评论粘贴npm run test:coverage通过coverageThreshold且未下调阈值 — N/A:零src/**改动,覆盖率分母未变;阈值真源config/test/jest.config.js未被本次变更触及npm run test(Playwright E2E)全部通过 — N/A:未改动任何被测页面;Gitea 侧的等价回归是真实 git 链路验证(HTTPSgit ls-remoteexit 0、SSH 2222 可达、EGRESS_MODE=strict生效且启动日志无告警、升级后 healthz 200)npm run check:contrast与npm run check:headings通过(WCAG 2.1 AA)—check:contrast实测 44/44 通过;check:headingsN/A(无页面渲染变化)。Gitea 侧对比度单独量过:浅档#C41E3A三处 5.84:1 全过;深档按钮#E13C58×#0D0D0D4.62:1 过,深档链接 3.92:1 未达正文 AA,作为已登记让步保留(上游蓝同位 4.14,本就不达标;登记在build-brand-css.py的DEVIATIONS,跌破下限即判红)npm run lighthouse满足lhci断言 — N/A:零前端产物变化(无src/**、无next.config.mjs、无public/**站点资产改动)npm run test:security:headers通过(若改动涉及响应头、CSP 或部署配置)— N/A:本站部署配置未改;Gitea 侧的部署配置确实改了,其影响面单独核过:升级后响应头仍无 CSP(与升级前一致,1.27.0 的 script-nonce 属可选启用),装饰层因此刻意只用外链 CSS、custom/header.tmpl内不写内联样式,启用 CSP 后也不会被打断README.md/CONTEXT.md/CLAUDE.md及docs/下受影响文件 — 已改 5 份:README.md(进度 + CI/CD 节)、CONTEXT.md(「Gitea 品牌装饰层的口径」与「CI 生产口径的两处失真」两行)、CLAUDE.md(四条命令 + 授权提示)、docs/deployment/cicd/README.md(2026-10-22 一节,含架构图版本号)、docs/lessons-learned.md§5.52;新增infra/cicd/gitea-custom/README.md与docs/acceptance/2026-10-22-gitea-branding/README.md;DESIGN.md/PRODUCT.mdN/A(本轮不改设计令牌与产品口径,品牌色值沿用手册 §3 已裁定的两档)feat(gitea): …,切片 = 「升级 + 装饰层 + 文档纠正」,三者不可分(装饰基准取自升级后的真实模板)EGRESS_MODE=strict、写入生产CustomPath+chown+ 重建、以及本轮的 worktree 提交与 PR;pg_dump与探针库还原为只读/一次性动作,探针库用完即DROP假绿灯纪律
GITEA__server__APP_NAME与GITEA__DEFAULT__APP_NAME两条路都被实测证伪(后者被 environment-to-ini 写成字面[default]段,go-ini 不认),最终改为直写 app.ini 顶层;③备份验证脚本自身有三处坏点($$被 shell 展开、建库失败被> /dev/null吞成「0 errors」、docker cp进 tmpfs 后 psql 找不到文件),修成「还原到探针库 + 表数与业务行数对账」后才拿到真结论skip/todo、下调阈值等方式让门禁变绿 — 未删任何判据;唯一的粒度调整是把「标题未生效」从回滚触发项降级为独立退出码,其判据本身仍在且仍打印红因docs/acceptance/qa-tracker.md的在途改动属另一会话,未代为处置origin/*与实测为准 — 生产事实全部取自docker inspect的 label 与挂载表、gitea help的CustomPath、容器内gitea embedded extract抽出的 28.2.0 原版模板;仓库里那份「加固版」compose 与运维文档的记载被实测证伪并已纠正(从未上线、REQUIRE_SIGNIN_VIEW实际为 false、DB 大小 61MB 而非文档的 1.7MB)docs/acceptance/2026-10-22-gitea-branding/README.md:①登录后内页(仓库/issue/后台)未做浏览器取证(需真实口令,本轮不把凭据喂进自动化),装饰层对其生效是推断不是实测;②strict egress 的负对照未做(需造 mirror = 写生产数据);③/explore匿名可浏览是否收口属策略裁定,本轮只登记其他说明
gitea/gitea:28.2.0,装饰已上线,verify-branding.sh13 项全绿 + 负对照通过。deploy-branding.sh判红自动回滚;手动回滚命令与备份位置(/root/gitea-brand-backup-<TS>.tgz、/root/app.ini.bak-brand-<TS>、docker-compose.yml.bak-brand-<TS>、/root/gitea-pre28-*.sql)见infra/cicd/gitea-custom/README.md。REQUIRE_SIGNIN_VIEW=false的匿名浏览面;②SSH_PORT=22与宿主2222:22的克隆地址错配(改动影响所有人已存 remote);③docs/deployment/cicd/03-credential-incident.md的明文口令 P0 仍未闭合,本轮未扩大也未修复,且预检用 rootcatapp.ini 时把SECRET_KEY/INTERNAL_TOKEN/ DB 口令带入了会话输出,建议按该文档流程轮换收口。View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.