theme v1

.workbuddy/memory/MEMORY.md

@@ -88,6 +88,13 @@
 - 静态文件是**显式 embed 清单**（`static/fs.go`），新增 css/js 必须手动加进 `//go:embed` 那行，否则运行期 404。
 - 主题属性在 head 内联脚本里打（cookie `theme`），**不能挪回 body**，否则深色用户白闪。
 - 页面级样式尽量用类，不用 `style=`（深色下内联写死色值会露白，`.tb-img-uploader` 踩过）。
+- **移动端（≤640px）语言切换与主题按钮不在顶栏**：顶栏 `.tb-nav-utils` 被 `display:none !important` 隐藏，
+  改由 `#tb-mobile-utils` 固定底栏承载（`position:fixed;bottom:0;z-index:1000`，body 预留 `padding-bottom:56px`）。
+  顶栏图标只在 >640px 出现。用户曾误以为"按钮不见了"，先解释位置再排查。
+  ⚠️ `/_/{domain}` 箱主页把 `IsUserPage` 设为 true（`route/question/page.go:133`），语言切换整块包在
+  `{{ if not .IsUserPage }}` 里（header.html:272 桌面 / :314 移动），所以**箱主页没有语言切换入口**——
+  **这是有意设计，不是缺陷**（用户 2026-10-19 明确：箱主页属箱主个性化，以箱主配置为准）。
+  别把它当 bug 去"修"，要动先问。
 - ⚠️ **UIkit 3.3.3 有 `.uk-flex::before/::after{display:none}`**：给带 `uk-flex` 的元素加伪元素遮罩必须写
   `.tb-cover.uk-flex::after` 这类复合选择器，否则静默失效（不报错）。
 - 视觉自检：`TEST_PREVIEW=1 go test ./templates -run TestGenPreview` → `outputs/preview-*.html`；
@@ -99,6 +106,21 @@
   （置顶/私密/被举报/已读、投票未开始/进行中/已结束/已参与）。题型配色曾由 Go 的
   `fieldTypeLabelClass` 生成（已删），故 grep `uk-label` 搜不到，改前先搜模板函数名。
 
+## 主题系统
+
+- 一套主题 = `static/css/themes/<slug>.css` 一个文件，**只覆盖令牌**（配色/图案/整页背景），不碰布局。
+  新增主题：复制 `_scaffold.css` → 改名 → 登记到 `[theme] available`；`static/fs.go` 已嵌整个目录，无需改清单。
+- 作用域：仅 `/_/*` 箱主相关页面（`question.Pager` 注入 `ThemeSlug`）；`/user` 后台与全站其它页面不主题化。
+  优先级 `users.theme > [theme] default > 基础外观`；`""`=跟随站点默认，`"default"`=箱主明确选基础外观（不加载 css）。
+- ⚠️ 主题 css **必须成对写**：`html[data-theme-style="x"]`（0,1,1，压过 `:root` 的 0,1,0）+
+  `html[data-theme="dark"][data-theme-style="x"]`（0,2,1，压过 base 的 dark）。只写浅色块会让深色模式被浅色令牌污染。
+  兜底测试 `TestThemeCSSComplete`（检查两个选择器 + 10 个颜色令牌齐全）。
+- ⚠️ **UIkit 3.3.3 的主题色是编译期常量 `#1e87f0`**，令牌注入不进去。base.css 里有一段「UIkit 组件跟随主题色」
+  按组件映射（a/uk-link、uk-button-primary、checkbox/radio、input:focus、uk-tab active）。新增会显示主色的组件时，
+  先确认它是否已映射，否则换主题后会出现「页面变粉、按钮还蓝」。
+- 静态资源版本号统一 `conf.StaticVersion`（base.css 与主题 css 共用），改样式只改这一处；页面通过 `.StaticVersion` 取。
+- 整页背景用 `--tb-page-image`（cover）与 `--tb-page-pattern`（平铺，`--tb-page-pattern-size` 控尺寸），图案叠在图片之上。
+
 ## 其它约定
 
 - 校验靠 `valid:"required;maxlen:N"` 标签（`internal/form/*.go`），别在 handler 手写。