维护记录
完成的工作
- 按用户要求删除页脚右端的 powered by 徽标(
powered by + Claude Code 标,2026-10-24 上线)✅themes/self/layouts/partials/footer.html:删掉右侧整组 <a>(链接 claude.com/claude-code),footer 现在只剩左侧版权行;文件头注释的 local-diffs 清单同步更新themes/self/assets/custom.css:删掉 .footer-logo 规则段themes/self/layouts/partials/claude-code-logo.html:成为孤儿 partial,一并删除(删除前已与用户确认)AGENTS.md 的 footer 条目同步更新- 产物:重跑 unocss CLI 重新生成
assets/uno.css(footer 删掉的 ml-auto / flex / items-center 在别处仍在用,工具类无增减,只有主题变量顺序微调)+ 重新生成 uno.css.sha256 ✅
- 按用户要求改分页按钮(「上一页 / 下一页」,
.btn 只被这两处使用)的配色:亮色主题从陶土橙底墨字改成墨底纸字,暗色主题覆写成灰底(亮色 15% 叠在墨底上)纸字 ✅themes/self/assets/app.css:.btn 改 background-color: #191919 + color: #f0eee6,新增 .dark .btn 覆写;对比度亮色 ≈13:1、暗色 ≈9:1- 指纹重生成(diff 恰好只有
app.css 一条);本次没动模板类名,uno.css 产物无需重跑
遇到的问题
- Windows 下
pnpm run build-css 跑不起来 ⚠️ - pnpm 在 Windows 用 cmd 当脚本壳,./bin/build-css.sh 报「’.’ 不是内部或外部命令」。改用 Git Bash 直接 bash bin/build-css.sh。 node_modules/.bin/unocss 缺失 ⚠️ - pnpm 11 在这台 Windows / Git Bash 环境下没生成 .bin shim,包本体在 .pnpm store 里。改用 node node_modules/.pnpm/@unocss+cli@66.11.0/node_modules/@unocss/cli/bin/unocss.mjs 直跑,产物与 CI 一致。artifacts.sh check 的 JS 新鲜度在本机恒红 ⚠️ - 既有环境问题,与本次改动无关:core.autocrlf=true 把仓库里 LF 的 assets/js/*.js 检出成 CRLF,tsc 重编输出 LF,逐字节比对必然失败(在干净的 HEAD 上用 --rebuild 复现确认)。Linux / macOS 上不会这样。- 指纹文件的哈希基准是「git blob 字节」而不是工作区字节 ⚠️ - 本机
core.autocrlf=true 下,工作区文本文件全是 CRLF,直接 sha256sum 算出来的指纹提交上去 CI 必红(wasm 指纹在本机恒红也是同一根因)。本次改用临时 GIT_INDEX_FILE + git add -u 把改动吸进索引、再对每个 blob git cat-file 算哈希——blob 字节就是 CI 在 Linux 检出后的 LF 字节。行序也有讲究:check_css 是「uno.css 在首行 + 其余按 LC_ALL=C 路径排序」后逐行 diff,照着排的。已验证:新指纹与旧指纹的 diff 恰好只有四处预期变化,重算一遍逐字节一致。 pnpm run test 在本机有一例既有失败 ⚠️ - check-dead-links.test.ts 的 walkMarkdown 断言期望 content/about.md(正斜杠),Node 在 Windows 下返回 content\about.md——纯路径分隔符问题,与本次改动无关(干净基线上同样失败)。
下次建议
- 本地没有安装 Hugo(未在任何常见路径找到),无法用
hugo --minify 做端到端构建验证;footer 模板改动简单(删除一个完整的 <a> 元素),但推送前建议在有 Hugo 的环境跑一次 pnpm run build。 core.autocrlf=true 的 Windows 机器上跑 artifacts.sh check / stamp-* 恒红/会算出错误指纹;想让指纹工具在这类机器上可用,值得给 sha256_of 加一步「按 blob 语义规范化」或在文档里写明「必须在 LF 检出的环境跑」。