feat(theme): 恢复主题桥,工作台页重新跟随 DSH 深浅色 (REQ-20261117-0013) #4

Merged
qiudl merged 1 commits from feat/REQ-20261117-0013-theme-bridge into main 2026-11-18 15:04:03 +08:00
Contributor

问题(升级引入的真实回归)

Gitea 0.5.x 线缺了 qiudl 0.4.x 分支的整套主题桥能力。升级到 0.5.3 后,所有工作台产物页都不再跟随 DSH 主题(浅色 / 深色 / 跟随系统全部失效),每个页面各自锁死自己的配色。

这比「某个页面配色不好看」严重得多——它是全局能力缺失。

移植内容

来自 qiudl 0.4.9-rc.2(theme.ts 无外部依赖,纯函数 + 浏览器脚本):

  • 新增 src/theme.ts(191 行):THEME_BRIDGE_JS / injectThemeBridge / 前缀判定 / 取值清洗
  • 模板路由补 /api/worktable/template/theme.js(独立打开、嵌套 iframe 时显式引用)
  • 站点路由对 .html / .htm 自动注入主题桥(幂等:已含 data-wt-theme-bridge 则原样返回,非 HTML 不受影响)
  • 新增 04_test/theme-bridge.test.mjs(7 个回归用例,含「改了桥但没接上」的接线防漏)

顺带修两处写死项(同属「不跟随主题」根因)

  1. dshell.css::root { color-scheme: dark } → color-scheme: light dark + 浅/深两套兜底 token
    —— 这是 skill 里记录过的历史事故(写死深色会让所有页面锁死深色),0.5.x 线又踩回来了
  2. dshell.css:正文字体改走 var(--dsw-font-family, ...)

版本

0.5.3-local.3 → 0.5.3-local.4

验证

  • build 通过;client-factory-gate 10/10
  • 主题桥测试 7/7(前缀判定、幂等注入、head/body 退化、external 模式、页面优先让位、接线齐全、dshell 不再写死深色)
  • 兼容回归 105/105
  • release-prep 全过:结构断言、独立安装 import、split anchor dom(14 场景)、sidebar popup、真实 Chromium split margin(5 场景)、server home(3 场景)
  • 双资产同源 sha256 3fcc19582398f9e95f146c95ada05bda306f1d98ce7cbc2fcf6fdef3681cf4f9

备注

上游 release-prep.mjs 门禁里 widget-mount / preview-files 两个用例在基线即失败(macOS /tmp→/private/tmp realpath、fixture 缺 top 字段),与本改动无关,打包时临时放行未提交。

## 问题(升级引入的真实回归) Gitea 0.5.x 线缺了 qiudl 0.4.x 分支的**整套主题桥能力**。升级到 0.5.3 后,所有工作台产物页都不再跟随 DSH 主题(浅色 / 深色 / 跟随系统全部失效),每个页面各自锁死自己的配色。 这比「某个页面配色不好看」严重得多——它是全局能力缺失。 ## 移植内容 来自 qiudl `0.4.9-rc.2`(`theme.ts` 无外部依赖,纯函数 + 浏览器脚本): - 新增 `src/theme.ts`(191 行):`THEME_BRIDGE_JS` / `injectThemeBridge` / 前缀判定 / 取值清洗 - 模板路由补 `/api/worktable/template/theme.js`(独立打开、嵌套 iframe 时显式引用) - 站点路由对 `.html` / `.htm` **自动注入**主题桥(幂等:已含 `data-wt-theme-bridge` 则原样返回,非 HTML 不受影响) - 新增 `04_test/theme-bridge.test.mjs`(7 个回归用例,含「改了桥但没接上」的接线防漏) ## 顺带修两处写死项(同属「不跟随主题」根因) 1. `dshell.css`:`:root { color-scheme: dark }` → `color-scheme: light dark` + 浅/深两套兜底 token —— 这是 skill 里记录过的历史事故(写死深色会让所有页面锁死深色),0.5.x 线又踩回来了 2. `dshell.css`:正文字体改走 `var(--dsw-font-family, ...)` ## 版本 `0.5.3-local.3` → `0.5.3-local.4` ## 验证 - build 通过;`client-factory-gate` **10/10** - 主题桥测试 **7/7**(前缀判定、幂等注入、head/body 退化、external 模式、页面优先让位、接线齐全、dshell 不再写死深色) - 兼容回归 **105/105** - `release-prep` 全过:结构断言、独立安装 import、split anchor dom(14 场景)、sidebar popup、**真实 Chromium split margin(5 场景)**、server home(3 场景) - 双资产同源 sha256 `3fcc19582398f9e95f146c95ada05bda306f1d98ce7cbc2fcf6fdef3681cf4f9` ## 备注 上游 `release-prep.mjs` 门禁里 `widget-mount` / `preview-files` 两个用例在基线即失败(macOS `/tmp`→`/private/tmp` realpath、fixture 缺 `top` 字段),与本改动无关,打包时临时放行未提交。
qiudl added 1 commit 2026-11-18 15:03:59 +08:00
问题:Gitea 0.5.x 线缺了 qiudl 0.4.x 分支的整套主题桥能力,升级后所有工作台
产物页都不再跟随 DSH 主题(浅色/深色/跟随系统全部失效),页面各自锁死自己的配色。
这是升级引入的真实回归,比单个页面的配色问题严重得多。

移植内容(来自 qiudl 0.4.9-rc.2,theme.ts 无外部依赖,纯函数 + 浏览器脚本):
- 新增 src/theme.ts(191 行):THEME_BRIDGE_JS / injectThemeBridge / 前缀判定
- 模板路由补 /api/worktable/template/theme.js(独立打开/嵌套 iframe 显式引用)
- 站点路由对 .html/.htm 自动注入主题桥(幂等:已含 data-wt-theme-bridge 则原样)
- 新增 04_test/theme-bridge.test.mjs(7 个回归用例,含接线防漏)

顺带修两处写死项(同属「不跟随主题」根因):
- dshell.css::root{color-scheme:dark} → color-scheme:light dark + 浅/深两套
  兜底 token(历史事故:写死深色会让所有页面锁死深色)
- dshell.css:正文字体改走 var(--dsw-font-family, ...)

版本 0.5.3-local.3 -> 0.5.3-local.4

验证:build 通过;client-factory-gate 10/10;主题桥测试 7/7;兼容回归 105/105;
release-prep 全过(结构断言、独立安装 import、split anchor dom 14 场景、
sidebar popup、真实 Chromium split margin 5 场景、server home 3 场景)
qiudl merged commit 2d25e4ec39 into main 2026-11-18 15:04:03 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoqu/dsh-worktable#4