5 Commits

39 changed files with 752 additions and 2013 deletions
+14 -2
View File
@@ -21,5 +21,17 @@ workplace/*
scripts/output/
scripts/.browser-profile/
# Dark Reader 源码下载目录(构建依赖已 vendor 到 ui/vendor/darkreader
docs/darkreader/
# 本地项目说明文件,不入库
AGENTS.md
CLAUDE.md
# Dark Reader 仅跟踪构建所需文件,完整源码保留在本地
third-party/darkreader/*
!third-party/darkreader/package.json
!third-party/darkreader/darkreader.js
!third-party/darkreader/darkreader.mjs
!third-party/darkreader/index.d.ts
!third-party/darkreader/LICENSE
!third-party/darkreader/SHA256SUMS
__pycache__/
*.pyc
-177
View File
@@ -1,177 +0,0 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## 项目概述
Halo 暗色模式插件 — 为 Halo 2.25 后台管理面板提供深色/浅色模式切换。不修改 Halo 核心代码,完全通过插件机制实现。
**核心技术栈**:Java(插件骨架,编译目标 21)、Vue 3 + TypeScript(前端 UI)、OKLCH 色彩空间(CSS 变量体系)、Gradle(构建)。
**⚠️ 构建环境**:本机没有 JDK 21,构建必须使用 JDK 25(路径已硬编码在 `gradle.properties``org.gradle.java.home`)。`options.release = 21` 保证字节码兼容 Halo API。不要改回 toolchain 方式——那会因找不到 JDK 21 而失败。
## 常用命令
```bash
# 后端 — 启用插件并启动 Halo 开发服务器(需要 Docker
./gradlew haloServer
# 后端 — 构建插件 JAR(产物在 build/libs/
./gradlew build
# 前端 — 进入 ui/ 开发
cd ui && pnpm install
# 前端 — 开发模式(watch 构建)
pnpm dev
# 前端 — 生产构建
pnpm build
# 前端 — 类型检查
pnpm type-check
# 前端 — Lintoxlint + eslint
pnpm lint
# 前端 — 格式化
pnpm prettier
# 前端 — 单元测试
pnpm test:unit
# 后端 — 仅运行 Java 测试
./gradlew test
```
## 架构概览
```
halo-dark-mode-plugin/
├── 后端 (Java/Gradle) ← 插件骨架,极简
│ ├── DarkModePlugin.java ← 继承 BasePlugin,仅 start()/stop()
│ └── plugin.yaml ← 插件清单(声明式元数据 + 版本约束)
├── 前端 (Vue 3 / TypeScript) ← 核心实现
│ ├── index.ts ← definePlugin() 入口,注册路由+组件
│ ├── darkreader-engine.ts ← Dark Reader 通用暗色引擎
│ ├── injector.ts ← ThemeToggle 侧边栏注入器(MutationObserver 方案)
│ ├── composables/
│ │ ├── useDarkMode.ts ← 单例状态管理(light/dark/auto + localStorage 持久化)
│ │ └── useSystemPreference.ts ← matchMedia 系统偏好监听
│ ├── components/
│ │ └── ThemeToggle.vue ← 侧边栏切换按钮
│ ├── views/
│ │ └── SettingsView.vue ← 设置页面(浅色/深色/跟随系统 三选一)
│ └── styles/
│ ├── index.css ← 样式入口(@import 聚合)
│ ├── variables.css ← 40+ CSS 变量(:root 浅色 + [data-halo-theme="dark"] 深色)
│ └── overrides/
│ ├── halo-core.css ← ★ 核心:真实 DOM 类名覆盖(最重要)
│ ├── layout.css ← 侧边栏/内容区/页脚
│ ├── components.css ← 旧版组件类覆盖(部分已失效,见下)
│ ├── forms.css / editor.css / scrollbar.css / utilities.css
└── 构建链
└── processUiResources ← Gradle task: ui/dist/ → resources/main/ui/
```
## 关键设计决策
### 主题切换机制
- **触发方式**`document.documentElement` 上设置/移除 `data-halo-theme="dark"` 属性
- **主引擎**Dark Reader(本地 vendored 于 `ui/vendor/darkreader`API 包由
`npm run api` 构建),监听 `useDarkMode().isDark`,深色时 `enable()`,浅色时
`disable()`,可自动分析 Halo 核心与第三方插件的动态 DOM
- **CSS 变量体系**:所有颜色通过 `--halo-*` 前缀的 CSS 自定义属性控制,一个语义变量对应一个视觉属性
- **颜色空间**:全部使用 OKLCH(感知均匀,暗色模式天然适配)
- **暗色配色策略**:用亮度层次区分背景(越"高"的层越亮),中性色含微量蓝色调,强调色略降饱和
- **CSS 覆盖定位**:现有 `overrides/` 仅作为 Dark Reader 的兼容层与兜底,
不再逐页新增手工转换规则;新页面残留统一交给 Dark Reader 处理
### ⚠️ 最关键的教训:Halo 2.25 用 UnoCSS,不是 Tailwind
Halo 2.25 的 Console 实际使用 **UnoCSS**hash 类如 `uno-*`)加 **BEM 语义aliyun "curl -sI --max-time 5 http://localhost/ 2>&1 |类**。**不要写 `.bg-white``.text-gray-900``.v-card` 这类 Tailwind/Vuetify 原子选择器**——它们在真实 DOM 中不存在,覆盖会静默失效。
真实 DOM 里的容器类名(已被 `halo-core.css` 覆盖):
| 语义 | 真实类名 |
| ------------------- | --------------------------------------------------------------------------------------------- |
| 页面顶栏 | `.page-header` / `.page-header__title-text` |
| 列表卡片容器 | `.card-wrapper` |
| 文章/用户列表项标题 | `.entity-field-title` / `.entity-field-title-body` |
| 分页 | `.pagination` / `.pagination__btn` |
| 标签 | `.tag-default` / `.tag-content` |
| 模态框 | `.modal-content` / `.modal-header` / `.modal-body` / `.modal-footer` |
| 详情页描述项 | `.description-item-wrapper` / `.description-item__label` / `.description-item__content` |
| Toast | `.toast-container .toast-body` |
| 用户头像 | `.avatar-wrapper` / `.avatar-circle` |
新增覆盖时:**先到真实环境确认类名,不要凭经验写**。
### 覆盖策略(重写后)
`halo-core.css` 是主要覆盖文件,按语义类精准覆盖。它包含三类规则:
1. **BEM 语义类**(如 `.card-wrapper`)— 直接 `[data-halo-theme="dark"] .card-wrapper { background-color: var(--halo-bg-card) }`
2. **通用 UnoCSS 工具类**(如 `.bg-gray-50``.hover:text-gray-600`)— 批量覆盖文字/背景/边框
3. **根背景兜底**`html, body { background-color: var(--halo-bg-body) !important }`body 不设暗色会在溢出时露白)
`components.css` 等旧文件里的 Tailwind/Vuetify 选择器部分已失效,保留但优先维护 `halo-core.css`
### 状态管理
- `useDarkMode()` 是**模块级单例** — 所有组件共享同一份 `theme` ref 和 `isDark` computed
- 三个主题模式:`light` / `dark` / `auto`(跟随系统)
- 持久化:`localStorage` key `halo-dark-mode-theme`,默认 `auto`
- FOUC 防护:插件 bundle 顶部同步执行脚本,DOM 渲染前设置 `data-halo-theme`
### ThemeToggle 侧边栏注入
Halo 扩展点系统**没有侧边栏插槽**。`injector.ts``MutationObserver` 监听 `.sidebar__profile` 元素出现,在其上方插入容器并挂载 `ThemeToggle.vue` 组件。这是当前 Halo 插件体系下的合理变通方案。
### 前端入口
- `definePlugin()``@halo-dev/ui-shared` 导入(非旧版 `@halo-dev/console-shared`
- 路由使用 `() => import(...)` 懒加载
- 构建使用 `@halo-dev/ui-plugin-bundler-kit``viteConfig()` 包装器
### 后端
后端极简 — `DarkModePlugin extends BasePlugin` 仅含 `start()`/`stop()` 生命周期钩子。所有核心逻辑在前端。插件不依赖后端 Setting API。
## 打包约定(必须)
每次执行 `./gradlew build` 打 JAR 前,**必须先递增版本标签**:
1. 修改 `gradle.properties` 中的 `version`(如 `1.0.2``1.0.3`
2. 同步更新 `src/main/java/run/halo/darkmode/DarkModePlugin.java``@since`
3. 构建完成后核对 `build/libs/plugin-dark-mode-<新版本>.jar` 存在,且 JAR 内的
`ui/style.css``ui/main.js` 包含本次改动(用关键字检查,例如新增类名)
4. 向用户交付时明确给出新 JAR 路径和版本号,避免线上仍加载旧 bundle 的混淆
## 验证工作流(必须)
对 CSS 覆盖的任何改动,都要在**真实 Halo 环境**验证,不能只靠 `vite build` 通过:
1. 打开官方 demo 站 `https://demo.halocms.site/console`,登录 `demo / P@ssw0rd123..`
2. 用 Playwright 的 `page.addStyleTag({ path: 'ui/build/dist/style.css' })` 注入构建产物,并 `document.documentElement.setAttribute('data-halo-theme', 'dark')`
3. 遍历页面,扫描 `main *` 中残留的白色背景(`rgb(255,255,255)` 且尺寸 >100×40)和深色文字(`rgb(17,24,39)` 等)元素,记录其真实类名
4. 新增覆盖后重新构建、重新注入、重新扫描,直到零残留
5. 最终 `./gradlew build` 打 JAR,确认 `ui/style.css` 已更新
第三方插件页面(链接/订阅/瞬间等)在 demo 站已装,可一并验证。
## Playwright 自动化验证(workplace/
`workplace/` 目录包含基于 Playwright 的自动化验证工具(未提交到 git):
- **`login_wait.py`** — 启动带持久化配置的 Edge 窗口,打开 `https://blog.liuhangyv.top/console/login`,等待用户手动登录后将会话 cookie 保存到 `pw-profile/`。超时 280 秒。
- **`pw-profile/`** — Edge 浏览器持久化用户数据目录,登录后会话保留供后续 Playwright 脚本复用。
- **`roleTemplates.yaml`** — 预留的角色模板配置(当前为空)。
典型流程:先运行 `login_wait.py` 登录,再编写 Playwright 脚本复用 `pw-profile` 中的会话进行页面扫描。
## README.md
用户向 README,包含功能介绍、快速开始、构建命令和项目结构图。
+108 -49
View File
@@ -1,66 +1,97 @@
# dark-mode
# Halo 深色模式
Halo 2.25 暗色模式插件 — 为 Halo 后台管理面板提供深色/浅色模式切换,支持跟随系统、手动切换和偏好记忆。
为 Halo 后台管理面板提供深色/浅色模式切换,内置 Dark Reader 通用暗色引擎,支持手动切换、跟随系统与偏好记忆。
## 功能
## 功能特性
- ☀️/🌙 **三种模式**:浅色、深色、跟随系统
- 💾 **偏好持久化**:自动记忆用户选择(localStorage),刷新不丢失
- 🖥️ **系统偏好跟随**:切换系统外观时自动响应
- **瞬间切换**CSS 变量瞬时生效,无可见闪烁
- 🧩 **侧边栏注入**:切换按钮自动出现在侧边栏底部(UserProfileBanner 上方
- ⚙️ **设置页面**:提供详细的模式选择界面(菜单 → 偏好设置 → 深色模式
- 🔍 **Dark Reader 引擎**:内置成熟的开源暗色转换引擎,自动分析页面 CSS 与 DOM,
第三方插件页面的黑字/白底也能自动转换,不再依赖逐页手工覆盖
- 🎨 **OKLCH 色彩空间**:感知均匀,暗色模式天然适配,WCAG AA 对比度保证
- 📦 **零后端依赖**:纯前端实现,不需要后端 API
-**覆盖已验证**:仪表盘、内容管理(文章/页面/评论)、链接、订阅、瞬间、用户、主题、设置、编辑器、模态框等页面已针对 Halo 2.25 真实 DOM 逐一验证
- **三种模式**:浅色、深色、跟随系统
- **偏好持久化**:自动记忆用户选择(localStorage),刷新不丢失
- **系统偏好跟随**:切换系统外观时自动响应
- **Dark Reader 引擎**:自动分析页面 CSS 与 DOM,覆盖 Halo 核心页面和第三方插件页面
- **侧边栏一键切换**:切换按钮自动出现在侧边栏 UserProfileBanner 上方
- **设置页面**:在「偏好设置 → 深色模式」中详细选择显示模式
- **零后端依赖**:纯前端实现,不需要额外后端 API
## 安装
1. 从 Releases 下载 `plugin-dark-mode-<version>.jar`
2. 在 Halo 后台的「插件管理」中上传并安装。
3. 启用插件后,侧边栏底部会出现深色模式切换按钮。
## 使用
安装并启用后,可以直接点击侧边栏按钮在深色和浅色模式之间切换,也可以进入设置页面选择固定模式:
| 配置项 | 可选值 | 说明 |
| -------- | --------- | -------------------- |
| 主题模式 | `light` | 始终使用浅色模式 |
| 主题模式 | `dark` | 始终使用深色模式 |
| 主题模式 | `auto` | 跟随系统外观自动切换 |
## 技术原理
- 插件通过 `useDarkMode()` 管理 `light` / `dark` / `auto` 三种状态。
- 深色模式下调用 Dark Reader 的 `enable()`,浅色模式下调用 `disable()`
- Dark Reader 会持续监听页面 DOM 变化,因此第三方插件动态渲染的内容也能自动转换。
- 插件自身只保留切换器与设置页所需的最小 UI 变量,不再维护逐页手工 CSS 覆盖。
> 说明:Dark Reader 的样式注入是异步的,刷新瞬间仍可能存在极短闪白;插件通过同步设置 `color-scheme` 缓解,但无法完全消除。
## 第三方依赖
- [Dark Reader](https://github.com/darkreader/darkreader) `4.9.129`[MIT License](https://github.com/darkreader/darkreader/blob/main/LICENSE)。
- 构建所需文件位于 `third-party/darkreader/`,由 `ui/package.json` 通过本地文件依赖引用。
- 升级或替换 Dark Reader 构建文件后,请校验 `third-party/darkreader/SHA256SUMS`
Linux / macOS 使用 `sha256sum -c SHA256SUMS`Windows 使用 `Get-FileHash -Algorithm SHA256` 对比。
## 开发环境
- Java 21+(Halo 插件编译要求;本机开发使用 JDK 25 + `--release 21`
- Halo `>=2.25.0`
- Java 21+(项目使用 `--release 21` 编译)
- Node.js 18+
- pnpm
- Docker`haloServer` 开发服务器需要)
## 快速开始
## 从源码构建
仓库使用标准 Gradle 结构,并提交了 Gradle Wrapper。
Linux / macOS
```bash
# 启用插件并启动 Halo 开发服务器
./gradlew haloServer
./gradlew clean build
```
# 前端开发(watch 模式)
Windows
```powershell
.\gradlew.bat clean build
```
构建产物位于 `build/libs/plugin-dark-mode-<version>.jar`
## 前端开发
```bash
cd ui
pnpm install
pnpm dev
```
## 构建
常用检查命令:
```bash
# 完整构建(后端 + 前端)
./gradlew build
```
构建完成后,插件 JAR 文件位于 `build/libs/`,可直接在 Halo 后台安装。
## 前端命令
```bash
cd ui
pnpm dev # 开发构建(watch
pnpm build # 生产构建
pnpm type-check # TypeScript 类型检查
pnpm lint # Lintoxlint + eslint
pnpm prettier # 代码格式化
pnpm test:unit # 单元测试
pnpm type-check # TypeScript 类型检查
pnpm lint # Lintoxlint + eslint
pnpm build # 生产构建
```
## 项目结构
```text
├── build.gradle # 根构建BOM 2.25.0, DevTools 0.8.0
├── build.gradle # 根构建配置
├── settings.gradle # 包含 :ui 子项目
├── gradle/wrapper/ # Gradle Wrapper
├── src/
│ └── main/
│ ├── java/run/halo/darkmode/
@@ -68,13 +99,18 @@ pnpm test:unit # 单元测试
│ └── resources/
│ └── plugin.yaml # 插件清单
├── third-party/
│ └── darkreader/ # Dark Reader 构建产物(MIT
└── ui/
├── package.json # 前端依赖
├── vite.config.ts # Vite 配置
└── src/
├── index.ts # definePlugin 入口
├── darkreader-engine.ts # Dark Reader 通用暗色引擎
├── injector.ts # ThemeToggle 侧边栏注入
├── injector.ts # 侧边栏切换器注入
├── composables/
│ ├── useDarkMode.ts # 核心状态管理(模块级单例)
│ ├── useDarkMode.ts # 主题状态管理(模块级单例)
│ └── useSystemPreference.ts # 系统偏好监听
├── components/
│ └── ThemeToggle.vue # 侧边栏切换按钮
@@ -82,17 +118,40 @@ pnpm test:unit # 单元测试
│ └── SettingsView.vue # 设置页面
└── styles/
├── index.css # 样式入口
── variables.css # 40+ CSS 变量(浅色 + 深色)
└── overrides/
├── halo-core.css # ★ 核心:真实 DOM 类名覆盖
├── layout.css # 侧边栏/内容区/页脚
├── components.css # 组件类覆盖
├── forms.css # FormKit 表单
├── editor.css # 富文本编辑器
├── scrollbar.css # 滚动条
└── utilities.css # 通用工具类
── variables.css # 插件自身 UI 变量
```
## 测试
```bash
./gradlew test
```
运行时验证脚本位于 `scripts/verify-toggle.py`,用于检查主题切换、localStorage 持久化以及 Dark Reader 注入状态。
## 更新日志
### v1.0.5
- 同步设置 `color-scheme`,缓解深色模式刷新闪烁
- 增加多标签页主题同步与 `useDarkMode` 单元测试
- 侧边栏切换按钮与设置选项支持键盘操作
- 后端日志改用 Lombok `@Slf4j`
- 裁剪 vendored `package.json`,新增 Dark Reader `SHA256SUMS` 完整性校验
- `plugin.yaml` 改为安装后由用户手动启用
### v1.0.4
- 改为纯 Dark Reader 引擎,移除手工 CSS 覆盖
- 移除 Monaco 手动主题同步,暗色转换统一交给 Dark Reader
- 整理 `third-party/darkreader` 目录,仅保留构建所需文件
### v1.0.3
- 引入 Dark Reader 通用暗色引擎
- 保留原有手工 CSS 作为兼容层,覆盖核心页面与第三方插件页面
- 增加 Monaco 日志查看器主题同步
## 许可证
[GPL-3.0](./LICENSE) © LHY
+151
View File
@@ -0,0 +1,151 @@
# 修复计划 — halo-dark-mode-plugin2026-08-08
> 依据:`docs/review-2026-08-08.md`
> 状态:待用户审批
> 审批通过后按 P2 → P3 顺序执行
## 一、修复总览
| ID | 优先级 | 问题 | 修复方式 | 主要涉及文件 |
| --- | --- | --- | --- | --- |
| P2-1 | P2 | 深色用户刷新 console 会浅色闪烁 | 同步设置 `color-scheme`,在 `enable()` 前减少闪烁 | `ui/src/composables/useDarkMode.ts``ui/src/darkreader-engine.ts` |
| P2-2 | P2 | 本地项目文档仍描述旧的手工 CSS / Monaco 架构 | 同步 AGENTS.md、CLAUDE.md、scripts/README.md 到纯 Dark Reader 现状 | `AGENTS.md``CLAUDE.md``scripts/README.md` |
| P2-3 | P2 | `scripts/``workplace/` 脚本双份 | 删除重复脚本;专用分析脚本保留在 `workplace/` 或迁移,待确认 | `workplace/login_wait.py``workplace/scan_dark.py` 等 |
| P2-4 | P2 | 前端无单元测试 | 为 `useDarkMode` 补测试,覆盖 light/dark/auto、持久化与非法回退 | `ui/src/composables/__tests__/useDarkMode.spec.ts` |
| P2-5 | P2 | 多标签页主题不同步 | 监听 `storage` 事件同步主题 | `ui/src/composables/useDarkMode.ts` |
| P2-6 | P2 | 切换器/设置选项不可键盘操作 | 改为原生 `button` + ARIA,或原生 radio 语义 | `ui/src/components/ThemeToggle.vue``ui/src/views/SettingsView.vue` |
| P3-1 | P3 | 后端使用 `System.out.println` | 使用 Lombok `@Slf4j` 输出日志 | `src/main/java/run/halo/darkmode/DarkModePlugin.java` |
| P3-2 | P3 | vendored package.json 保留完整 devDependencies | 裁剪为最小字段,只保留构建所需元数据 | `third-party/darkreader/package.json` |
| P3-3 | P3 | 无 Dark Reader 升级/完整性机制 | 增加 `SHA256SUMS` 并写入 README 校验说明 | `third-party/darkreader/SHA256SUMS``README.md``.gitignore` |
| P3-4 | P3 | `data-halo-theme` 属性为历史遗留 | 保留属性,但在代码注释中说明兼容性遗留 | `ui/src/composables/useDarkMode.ts``ui/src/styles/variables.css` |
| P3-6 | P3 | `plugin.yaml``spec.enabled: true` | 建议改为 `false`,安装后由用户启用 | `src/main/resources/plugin.yaml` |
## 二、详细修复说明
### P2-1 FOUC 闪烁
-`useDarkMode.ts``applyHtmlAttribute()` 中同步设置:
`document.documentElement.style.colorScheme = isDark ? 'dark' : 'light'`
- `darkreader-engine.ts` 保持现有 `enable()/disable()` 逻辑。
- `color-scheme` 只能缓解浏览器控件/滚动条闪烁,无法完全消除 DR 异步注入间隙;
该限制会写进注释和 README。
### P2-2 本地项目文档
- `AGENTS.md` / `CLAUDE.md`
- 删除 `overrides/``halo-core.css`、Monaco 同步、FOUC 同步脚本等旧描述
- 统一为“纯 Dark Reader 策略”
- `scripts/README.md`
- 把“Monaco 日志查看器主题同步”改为检查 `data-darkreader-mode`
- 补充 `verify-toggle.py` 的新三向断言说明
### P2-3 脚本收口
- 明确 `scripts/` 为正式工具目录。
- 计划删除的重复文件(需审批):
- `workplace/login_wait.py`(重复 `scripts/login-wait.py`
- `workplace/scan_dark.py`(重复 `scripts/scan-dark.py`
- `workplace/fetch_bundle.py``probe_conflict.py``aggregate.py` 属于专用分析工具,
默认保留在 `workplace/`;如需一并迁移到 `scripts/`,请在审批时注明。
### P2-4 单元测试
新增 `ui/src/composables/__tests__/useDarkMode.spec.ts`,覆盖:
1. 默认 `auto` + 系统深色 → `isDark = true`
2. `auto` 下点击切换 → 变成显式深色/浅色
3. `dark ↔ light` 往返切换
4. `setTheme()` 持久化到 localStorage
5. localStorage 非法值回退到 `auto`
6. `storage` 事件跨标签页同步
同时移除 `pnpm test:unit``--passWithNoTests`,防止测试静默通过。
### P2-5 多标签页同步
- `useDarkMode.ts` 增加:
`window.addEventListener('storage', handler)`
- 仅当 `newValue` 是合法 `light/dark/auto` 时更新 `theme`
### P2-6 可访问性
- `ThemeToggle.vue`
- `div` 改为 `<button type="button">`
- 增加 `:aria-pressed="isDark"`
- 保留现有样式并补按钮 reset
- `SettingsView.vue`
- 选项容器加 `role="radiogroup"`
- 每个选项改为 `<button type="button" role="radio" :aria-checked="...">`
- 键盘 Tab / Enter / Space 原生可用
### P3-1 后端日志
- `DarkModePlugin.java` 增加 `@Slf4j`
- `System.out.println` 改为 `log.info(...)`
- 保留 start/stop 语义不变
### P3-2 vendored package.json
- 裁剪为:
`name / version / description / main / module / types / license`
- 删除 scripts、devDependencies、optionalDependencies 等构建无关字段
- 更新后执行 `pnpm install` 同步 lockfile
### P3-3 完整性校验
- 新增 `third-party/darkreader/SHA256SUMS`,记录:
`darkreader.js``darkreader.mjs``package.json``index.d.ts``LICENSE`
- `.gitignore` 白名单增加 `SHA256SUMS`
- README 增加“升级 Dark Reader 后校验 SHA256SUMS”说明
### P3-4 历史遗留属性
- 保留 `data-halo-theme`verify-toggle.py 仍使用)
-`useDarkMode.ts``variables.css` 增加注释:
该属性当前无 CSS 消费方,仅为兼容性遗留标记
### P3-6 plugin.yaml
- 建议将 `spec.enabled` 改为 `false`
- 理由:官方 manifest 文档建议生产环境由用户安装后手动启用
## 三、暂缓项(本计划不做)
- P3-5 i18n:目标用户为中文,暂不引入国际化
- Dark Reader 完整源码保留在本地但不入库:维持现状
- 不新增界面截图:README 已可用,后续上架前再补
## 四、回归验证
```bash
cd ui
pnpm install
pnpm type-check
pnpm lint
pnpm test:unit
pnpm build
cd ..
./gradlew test
./gradlew build
```
运行时验证:
```bash
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\verify-toggle.py
```
验收标准:
- 单测至少覆盖 P2-4 中列出的 6 个场景且全部通过
- `pnpm test:unit` 不再 `--passWithNoTests`
- 深色刷新时 `color-scheme` 已同步
- 键盘可操作侧边栏按钮与设置选项
- `SHA256SUMS` 可校验,README 有说明
- 后端日志不再输出到 stdout
## 五、版本与提交
- 修复内容涉及运行时代码,后续打 JAR 时按项目约定递增版本(1.0.4 → 1.0.5
- 本次审批通过后,先提交代码修复,再按需打包
+81
View File
@@ -0,0 +1,81 @@
# 代码审查交接单 — halo-dark-mode-plugin2026-08-08
> 由审查窗口产出,供开发窗口执行。结论:**可合入,无 P1 阻断问题**。
> 审查基线:`HEAD = 363f30d`(工作区干净,已与 origin/main 同步)。
> 审查范围:Dark Reader 迁移相关 4 个提交(202ab53 / 0bb552b / 88a071f / 363f30d)。
## 一、开发窗口无需重复验证(审查窗口已实测)
- `vite build` 通过:main.js 109.96KBgzip 37.79KB)、style.css 3.76KBDark Reader 已打入 bundle`enable/disable` 具名导出解析正常
- `vue-tsc --build` 通过(exit 0
- `pnpm-lock.yaml``file:../third-party/darkreader` 依赖一致(含 malevic 0.20.2
- 构建产物 style.css 已无 `[data-halo-theme=dark]` 规则(属性属历史遗留)
- DR 产物头 `v4.9.129` 与 README 一致
## 二、待办清单(建议按 P2 → P3 顺序执行)
### P2-1 FOUC:深色用户刷新 console 会浅色闪烁
- 位置:`ui/src/darkreader-engine.ts`watch immediate 块,33-46 行)
- 原因:bundle 在 console 渲染后才执行,DR `enable()` 是异步分析+注入,无同步兜底
- 建议:`enable()` 前同步设 `document.documentElement.style.colorScheme = 'dark'`;或作为已知限制写进文档
### P2-2 本地项目文档滞后(与"纯 DR 策略"不符)
- `AGENTS.md` / `CLAUDE.md`:仍描述 `halo-core.css``overrides/`、Monaco 同步、FOUC 同步脚本——这些已不存在(`ui/src/styles/` 只剩 `index.css` + `variables.css`
- `scripts/README.md` 45-52 行:仍写"Monaco 日志查看器主题同步",实际已改为检查 `data-darkreader-mode`
- 建议:同步到纯 DR 现状
### P2-3 验证工具双份、命名不一致
- `scripts/`login-wait.py、scan-dark.py、verify-toggle.py
- `workplace/`login_wait.py、scan_dark.py、fetch_bundle.py、probe_conflict.py、aggregate.py
- 建议:统一收口到 `scripts/`,旧文件删除需用户书面确认
### P2-4 前端零单元测试
- `pnpm test:unit``vitest --passWithNoTests`,恒绿
- 建议:为 `ui/src/composables/useDarkMode.ts` 补 3-4 个用例,覆盖 `toggle()` 的 light/dark/auto 三种迁移与持久化回退
### P2-5 多标签页主题不同步
- 位置:`ui/src/composables/useDarkMode.ts`
- 建议:监听 `storage` 事件同步主题
### P2-6 可访问性
- `ui/src/components/ThemeToggle.vue` 10-15 行:div+@click,无 role/tabindex/键盘/aria-pressed
- `ui/src/views/SettingsView.vue` 36-41 行:选项 div+@click,同上
- 建议:补键盘与 ARIA(或改原生 radio 语义)
### P3-1 后端日志
- 位置:`src/main/java/run/halo/darkmode/DarkModePlugin.java` 24、29 行 `System.out.println`
- 建议:build.gradle 已有 Lombok,改 `@Slf4j` + `log.info`
### P3-2 vendored package.json 保留完整 devDependencies
- 位置:`third-party/darkreader/package.json`
- 建议:裁剪为 name/version/main/module/types/license 最小字段(`file:` 依赖不会安装 devDeps,但保持干净)
### P3-3 无 DR 升级/完整性机制
- 建议:README 或脚本记录 DR 产物 SHA-256,固定版本
### P3-4 data-halo-theme 属性 + variables.css 已成历史遗留
- 构建产物已无 `[data-halo-theme=dark]` 规则,属性无 CSS 消费方
- 建议:保留可以,但注释说明是兼容性遗留
### P3-5 文案硬编码中文,无 i18n
- 低优先级(目标用户中文),可暂缓
### P3-6 plugin.yaml `spec.enabled: true`
- 确认是否有意(Halo 通常安装后由用户启用)
## 三、完成后回归验证清单
```bash
cd ui
pnpm build # 构建通过
pnpm type-check # 类型检查通过
pnpm lint # 通过
# 真实环境验证(AGENTS.md 规定流程)
python scripts\verify-toggle.py # 三向断言全 PASS(属性/存储/Dark Reader 翻转)
```
## 四、无需改动的亮点(避免开发窗口误改)
- third-party/darkreader 只跟踪 5 个构建必需文件 + gitignore 白名单,LICENSE/版权头保留,合规 ✅
- style.css 从 ~500KB 降到 3.76KB,纯 DR 策略成立 ✅
- verify-toggle.py 的 darkreader 断言与策略一致 ✅
+157
View File
@@ -0,0 +1,157 @@
# Halo 暗色模式残留排查报告
> 排查时间:2026-08-07
> 排查环境:腾讯云生产站 `blog.liuhangyv.top`Halo Pro 2.24.2
> 排查方式:Playwright 自动化全路由扫描,共 92 个后台路由
## 一、结论摘要
1. **部署版本没有问题**。服务端实际加载的 `bundle.css` 与本仓库 `ui/build/dist/style.css` 的 194 条暗色规则完全一致,不存在"部署了旧包"的情况。
2. **73 个后台路由存在深浅色残留**,19 个路由完全干净(主要是 Shop 插件全家桶、快照页、权限页)。
3. 残留可归纳为 **3 类根因**
- 插件 CSS 加载顺序在最前,同特异性规则被后加载的 Halo 核心样式覆盖;
- UnoCSS 哈希类前缀已从 `i-*` 变为 `uno-*`,现有兜底规则匹配不到;
- 第三方插件页面(AstraHub、RSS 订阅、私密文章、AI 评论等)基本没有覆盖。
## 二、扫描方法与产物
### 方法
1. Playwright 启动持久化 Edge 上下文,复用已登录会话;
2. 从 Vue Router 读取全部注册路由(92 个),逐页加载;
3. 每页强制 `data-halo-theme="dark"`,等待网络空闲后扫描;
4. 扫描规则:可见且尺寸大于 50×20 的元素,背景 RGB 均 >235 记为浅色背景残留,直接文本颜色 RGB 均 <70 记为深色文字残留;
5. 每页截图存档,结果按页面 + 元素分组去重。
### 产物(均在 `workplace/`
| 文件 | 说明 |
|------|------|
| `scan_dark.py` | 全路由扫描脚本 |
| `scan-results.json` | 原始扫描结果(92 页 × 元素级) |
| `aggregate.txt` | 按元素/类名/问题聚合后的明细 |
| `shots/*.png` | 92 页深色模式截图 |
| `deployed-bundle.css` | 服务端实际部署的 CSS 快照 |
| `probe_conflict.py` / `fetch_bundle.py` | 样式表加载顺序与版本对比脚本 |
## 三、总体数据
| 指标 | 数值 |
|------|------|
| 扫描路由数 | 92 |
| 存在残留的路由 | 73 |
| 完全干净的路由 | 19 |
| 去重后的残留组 | 134 |
| 页面 × 元素残留条目 | 256 |
| 影响页面最多的残留 | 侧边栏 `.menu-item-title.active` 高亮背景(68 页) |
| 次多 | `.empty-title` 深色文字(16 页) |
无残留的 19 个路由:`/console/403`、Shop 插件全部 11 个页面、`/console/app-store/privacy-policy``/console/posts/snapshots``/console/single-pages/snapshots``/console/users/auth-providers``/console/users/roles`
## 四、根因分析
### 根因 1(P0):插件 CSS 加载顺序在最前,同特异性规则被 Halo 核心样式覆盖
**证据**(来自 `probe_conflict.py`):
- 插件 `bundle.css``document.styleSheets` 的第 0 张表;
- Halo 核心样式 `process-bar-DsZ2lvXx.css` 是第 9 张表,加载更晚;
- 双方存在同特异性规则,CSS 级联规则让"后加载者"胜出:
| 规则 | 特异性 | 结果 |
|------|--------|------|
| Halo`.description-item-wrapper .description-item__label { color: rgb(17 24 39) }` | (0,2,0) | 胜出 |
| 插件:`[data-halo-theme="dark"] .description-item__label { color: var(--halo-text-secondary) }` | (0,2,0) | 被覆盖 |
**受影响页面**`/console/overview``/console/schedule-calendar``/console/theme` 的详情描述项(名称、Halo、站点地址等文字仍是深色)。
**修复建议**
- 对这类核心语义类统一加 `!important`
- 或把前缀从 `[data-halo-theme="dark"]` 提升为 `html[data-halo-theme="dark"]`,把特异性从 (0,2,0) 提高到 (0,2,1)。
推荐两者并用(提高特异性 + `!important` 双保险),因为 Halo 核心样式后续仍可能继续调整。
### 根因 2(P0):UnoCSS 哈希类前缀已变化,现有兜底规则失效
**证据**
- 大量残留元素的类名是 `uno-*` 前缀(如 `uno-ga61as``uno-529526``uno-b60d0h`);
- `plugin-pages.css` 中的兜底规则只覆盖 `[class*="i-"]`,这是旧版 UnoCSS 的哈希前缀;
- 部署 CSS 探针确认:`menu-item-title``empty-title``alert-wrapper` 三个关键字在暗色规则中完全不存在。
**受影响页面**AI Foundation 全家桶(每页 3–24 处)、数据迁移、装备/关注/照片/时间线/投票的卡片头部"新增"栏、SummaraidGPT 等。
**修复建议**
- 新增 `[class*="uno-"]` 的兜底覆盖(背景、文字、边框三件套),并加 `!important`
- 保留 `i-*` 规则,因为扫描中仍有少量 `i-*` 哈希(如 `.i-p4hnaq`)在真实页面出现,两个前缀并存。
### 根因 3(P0):核心语义类缺覆盖
以下类在部署 CSS 中**完全没有暗色规则**,属于新增覆盖而非覆盖失效:
| 类名 | 残留内容 | 影响页面 |
|------|----------|----------|
| `.menu-item-title.active` | 高亮背景 `rgb(243,244,246)` | 68 页 |
| `.empty-title` | 文字 `rgb(17,24,39)` | 16 页 |
| `.alert-wrapper` / `.alert-default` | 背景 `rgb(249,250,251)` | 3 页(概览、许可证、导入) |
| `.description-item__label/content` | 文字 `rgb(17,24,39)` | 3 页(同特异性失效,见根因 1) |
**修复建议**
- 侧边栏高亮:覆盖 `.menu-item-title.active`(含 `:hover`),用 `--halo-menu-item-active` 变量;
- 空状态:覆盖 `.empty-title`,用 `--halo-text-secondary`
- 提示条:覆盖 `.alert-wrapper` 及各变体的背景/边框/文字。
### 根因 4(P1):第三方插件页面几乎未覆盖
| 插件/页面 | 残留类名 | 说明 |
|-----------|----------|------|
| AstraHub + 心愿便签 | `.ah-card``.ah-topbar``.ah-float-nav``.ah-topbar-brand` | 两插件共用同一套 `ah-*` UI,覆盖一次可同时生效 |
| RSS 订阅 | `.subscription-panel``.feed-toolbar``.feed-status-tabs``.feed-stream``.feed-brief__title` | 整个页面几乎整片浅色 |
| 私密文章 | `.focus-card``.overview-card``.list-card``.empty-state` | 半透明白背景叠在深色上,文字也是深色 |
| AI 评论自动处理 | `.setting-panel``.form-row``.sidebar-card``.tabs-wrap``.list-col``.reply-card` | 设置页和日志页整片浅色 |
| 数据工坊 | `.modal-content``.uno-*` 卡片 | 弹窗与主内容区均残留 |
| 代码注入器 | `.uno-*` 侧栏/编辑区 | 整页浅色 |
| Meilisearch 概览 | `.uno-*` | 卡片与标题残留 |
| 日志查看器 | `.monaco-editor``.margin``.lines-content` | **Monaco Editor 自带独立主题系统**,仅靠 CSS 覆盖很难稳定 |
| 导入/存储工具 | `.uno-*` | 提示卡片、分页栏残留 |
**修复建议**
- `ah-*``feed-*``focus-card/overview-card/list-card``setting-panel/form-row/sidebar-card` 等语义类按插件页面补 `!important` 规则;
- Monaco 不要硬啃 CSS,优先在 JS 里监听主题切换并调用 `monaco.editor.setTheme('vs-dark')`,或加载官方 dark 主题 CSS;
- 每个插件补完后再跑一次 `scan_dark.py` 验证零残留。
### 根因 5(P2):历史遗留规则与自相矛盾的选择器
- `components.css` 中大量 `.v-*`Vuetify 类)在 Halo 2.25 的真实 DOM 中不存在,属无效规则(CLAUDE.md 已记录);
- `[class*="tag-"]``[class*="modal"]` 等宽泛匹配容易误伤,建议逐步收紧;
- `utilities.css``halo-core.css` 对链接色的规则互相覆盖,最终生效结果不明确;
- `halo-core.css``html, body` 编译后为 `[data-halo-theme="dark"] html`,该选择器**永远不匹配**(html 元素不会是其自身的后代),根背景兜底实际只靠 `body` 一条,页面在特殊滚动场景下仍有露白风险。
## 五、修复优先级清单
### P0(一次重构后全站收益最大)
1. 全局暗色规则前缀从 `[data-halo-theme="dark"]` 升级为 `html[data-halo-theme="dark"]`
2. 核心语义类(`.page-header``.card-wrapper``.description-item-*``.table` 等)加 `!important`
3. 新增 `.menu-item-title.active``.empty-title``.alert-wrapper` 覆盖;
4. 新增 `[class*="uno-"]` 兜底三件套;
5. 修正根背景规则,让 `html` 本身也参与暗色。
### P1(按插件逐个补齐并复扫)
6. `ah-*``feed-*`、私密文章、AI 评论插件语义类覆盖;
7. Monaco 主题切换接入;
8. 数据工坊、代码注入器、Meilisearch、导入/存储工具等 `uno-*` 页面复查。
### P2(清理)
9. 删除失效的 Vuetify 类规则,收敛宽泛匹配;
10. 统一链接色规则,消除重复/冲突。
## 六、完整残留明细
`workplace/aggregate.txt`(134 组,含影响页面列表),原始数据见 `workplace/scan-results.json`
+1 -1
View File
@@ -1,3 +1,3 @@
version=1.0.3
version=1.0.5
org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8
org.gradle.java.home=D:/settings/Language/Java/jdk-25.0.1
+19 -14
View File
@@ -1,6 +1,6 @@
# 暗色模式回归扫描工具
# 暗色模式回归扫描与运行时验证工具
用 Playwright 驱动 Edge 对 Halo 后台做全路由深浅色残留扫描,验证每次 CSS 改动
用 Playwright 驱动 Edge 对 Halo 后台做全路由深浅色残留扫描与运行时切换验证
## 依赖
@@ -20,13 +20,13 @@ D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\login-wait.py
已有登录态想复用,可显式指定 profile:
```powershell
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\scan-dark.py --profile workplace\pw-profile
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\scan-dark.py --profile scripts\.browser-profile
```
## 常用命令
```powershell
# 全路由深色扫描,注入本地构建产物做预部署验证,存在残留时返回非 0
# 全路由深色扫描(历史 CSS 工作流保留)
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\scan-dark.py --local-css ui\build\dist\style.css --assert-zero
# 只扫指定页面
@@ -36,25 +36,30 @@ D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\scan-dark.py --page
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\scan-dark.py --mode light --pages /console/dashboard,/console/posts
```
## 输出
- `scripts/output/scan-results.json`:按路由分组的结果
- `scripts/output/shots/*.png`:每页截图
- 均已被 gitignore,不入库。
## 切换行为验证
```powershell
D:\settings\settings\uv\my_uv_env\Scripts\python.exe scripts\verify-toggle.py
```
部署新版插件后运行,会检查侧边栏按钮切换、`data-halo-theme` 属性、
localStorage 持久化以及 Monaco 日志查看器主题是否同步。
部署新版插件后运行,会检查
- `data-halo-theme` 属性翻转
- localStorage 持久化翻转
- `data-darkreader-mode`Dark Reader 注入状态)翻转
三项全部 PASS 时返回 0。
## 输出
- `scripts/output/scan-results.json`:按路由分组的结果
- `scripts/output/shots/*.png`:每页截图
- 均已被 gitignore,不入库。
## 注意事项
- 扫描会忽略 `img/canvas/video/svg/iframe`,避免把文章图片、编辑器画布等内容性
元素误判为界面残留。
- 路由从 Vue Router 动态发现,Halo 或插件升级新增页面后无需维护清单。
- `--local-css``add_style_tag` 追加本地样式(不替换线上 bundle),可安全验证
CSS 修复;JS 改动(如 Monaco 主题同步)需要重新构建并部署后再跑 `verify-toggle.py`
- `scan-dark.py` 主要为历史手工 CSS 工作流保留;当前暗色转换由 Dark Reader 负责,
运行时行为验证以 `verify-toggle.py` 为准
+29 -27
View File
@@ -1,7 +1,4 @@
"""验证侧边栏主题切换:点击后检查 data-halo-theme、localStorage 与 Monaco 主题同步。
部署新版插件后运行可获得完整结果;预部署阶段 Monaco 断言会提示跳过。
"""
"""验证侧边栏主题切换:点击后检查 data-halo-theme、localStorage 与 Dark Reader 模式。"""
import argparse
import pathlib
import sys
@@ -13,6 +10,16 @@ DEFAULT_PROFILE = pathlib.Path(__file__).parent / ".browser-profile"
BASE = "https://blog.liuhangyv.top"
def read_state(page) -> dict:
return page.evaluate(
"""() => ({
attr: document.documentElement.getAttribute('data-halo-theme'),
darkreader: document.documentElement.getAttribute('data-darkreader-mode'),
stored: localStorage.getItem('halo-dark-mode-theme'),
})"""
)
def main() -> int:
parser = argparse.ArgumentParser(description="验证主题切换运行时行为")
parser.add_argument("--base", default=BASE)
@@ -21,7 +28,9 @@ def main() -> int:
with sync_playwright() as p:
ctx = p.chromium.launch_persistent_context(
args.profile, channel="msedge", headless=True,
args.profile,
channel="msedge",
headless=True,
viewport={"width": 1600, "height": 950},
)
page = ctx.pages[0] if ctx.pages else ctx.new_page()
@@ -38,38 +47,31 @@ def main() -> int:
toggle = page.locator(".theme-toggle")
toggle.wait_for(state="visible", timeout=15000)
before = page.evaluate("() => ({ attr: document.documentElement.getAttribute('data-halo-theme'), stored: localStorage.getItem('halo-dark-mode-theme') })")
before = read_state(page)
toggle.click()
time.sleep(0.5)
after = page.evaluate("() => ({ attr: document.documentElement.getAttribute('data-halo-theme'), stored: localStorage.getItem('halo-dark-mode-theme') })")
time.sleep(1)
after = read_state(page)
toggle.click()
time.sleep(0.5)
restored = page.evaluate("() => ({ attr: document.documentElement.getAttribute('data-halo-theme'), stored: localStorage.getItem('halo-dark-mode-theme') })")
time.sleep(1)
restored = read_state(page)
attr_flipped = before["attr"] != after["attr"] and before["attr"] == restored["attr"]
stored_flipped = before["stored"] != after["stored"] and before["stored"] == restored["stored"]
darkreader_flipped = (
before["darkreader"] != after["darkreader"]
and before["darkreader"] == restored["darkreader"]
)
print(f"初始: {before}")
print(f"切换: {after}")
print(f"还原: {restored}")
print(f"属性翻转: {'PASS' if attr_flipped else 'FAIL'} 存储翻转: {'PASS' if stored_flipped else 'FAIL'}")
print(
f"属性翻转: {'PASS' if attr_flipped else 'FAIL'} "
f"存储翻转: {'PASS' if stored_flipped else 'FAIL'} "
f"Dark Reader 翻转: {'PASS' if darkreader_flipped else 'FAIL'}"
)
page.goto(args.base + "/console/log-viewer", wait_until="domcontentloaded")
try:
page.wait_for_load_state("networkidle", timeout=6000)
except Exception:
pass
time.sleep(2)
has_monaco = page.locator(".monaco-editor").count() > 0
if has_monaco:
dark_attr = page.evaluate("document.documentElement.getAttribute('data-halo-theme')") == "dark"
theme_cls = page.evaluate("() => { const el = document.querySelector('.monaco-editor'); return el ? el.className : '' }")
monaco_dark = "vs-dark" in theme_cls
print(f"Monaco 实例: 存在 | 属性dark={dark_attr} | 主题类含vs-dark={monaco_dark} | class={theme_cls[:60]}")
print(f"Monaco 主题同步: {'PASS' if (dark_attr and monaco_dark) or (not dark_attr and not monaco_dark) else 'FAIL(可能部署的还是旧版 JS'}")
else:
print("Monaco 实例: 未检测到,跳过主题断言(日志页面可能未加载或路由不同)")
ctx.close()
return 0 if attr_flipped and stored_flipped else 1
return 0 if attr_flipped and stored_flipped and darkreader_flipped else 1
if __name__ == "__main__":
@@ -1,5 +1,6 @@
package run.halo.darkmode;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import run.halo.app.plugin.BasePlugin;
import run.halo.app.plugin.PluginContext;
@@ -10,8 +11,9 @@ import run.halo.app.plugin.PluginContext;
* <p>Only one main class extending {@link BasePlugin} is allowed per plugin.</p>
*
* @author LHY
* @since 1.0.3
* @since 1.0.5
*/
@Slf4j
@Component
public class DarkModePlugin extends BasePlugin {
@@ -21,11 +23,11 @@ public class DarkModePlugin extends BasePlugin {
@Override
public void start() {
System.out.println("插件启动成功!");
log.info("插件启动成功!");
}
@Override
public void stop() {
System.out.println("插件停止!");
log.info("插件停止!");
}
}
}
+1 -1
View File
@@ -6,7 +6,7 @@ metadata:
# The name defines how the plugin is invoked, A unique name
name: dark-mode
spec:
enabled: true
enabled: false
requires: ">=2.25.0"
author:
name: LHY
+5
View File
@@ -0,0 +1,5 @@
0b126b96a0d76a1ff1b1c7cc7088c3ee1903dea2119abded2fb3913b340b63b1 darkreader.js
fbacd711bfd26b33b160881b50028a3e22e8f083b62ec727baebc0c4ad14b052 darkreader.mjs
5f7ebb5de2d74e011d87b86c2cc12048d667981599bdc9c527f98de9e0503a26 package.json
ab1ba9694b242323d15ed4839457c14fe04891966568413d5cd5eb78156dae1f index.d.ts
3f018657498dc4a805af22cc872688f1cd699bbe0045c82d29aeb0c8e65843e5 LICENSE
+2 -2
View File
@@ -8,7 +8,7 @@
"lint:eslint": "eslint . --fix",
"lint": "run-s lint:*",
"prettier": "prettier --write src/",
"test:unit": "vitest --passWithNoTests",
"test:unit": "vitest",
"type-check": "vue-tsc --build"
},
"prettier": {
@@ -23,7 +23,7 @@
"@halo-dev/ui-shared": "^2.25.1",
"axios": "^1.13.5",
"canvas-confetti": "^1.9.3",
"darkreader": "file:./vendor/darkreader",
"darkreader": "file:../third-party/darkreader",
"vue": "^3.5.28"
},
"devDependencies": {
+5 -5
View File
@@ -24,8 +24,8 @@ importers:
specifier: ^1.9.3
version: 1.9.4
darkreader:
specifier: file:./vendor/darkreader
version: file:vendor/darkreader
specifier: file:../third-party/darkreader
version: file:../third-party/darkreader
vue:
specifier: ^3.5.28
version: 3.5.41(typescript@5.8.3)
@@ -1085,8 +1085,8 @@ packages:
csstype@3.2.3:
resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
darkreader@file:vendor/darkreader:
resolution: {directory: vendor/darkreader, type: directory}
darkreader@file:../third-party/darkreader:
resolution: {directory: ../third-party/darkreader, type: directory}
data-urls@5.0.0:
resolution: {integrity: sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==}
@@ -3320,7 +3320,7 @@ snapshots:
csstype@3.2.3: {}
darkreader@file:vendor/darkreader: {}
darkreader@file:../third-party/darkreader: {}
data-urls@5.0.0:
dependencies:
+19 -4
View File
@@ -7,13 +7,19 @@ const { isDark, toggle } = useDarkMode()
</script>
<template>
<div class="theme-toggle" @click="toggle">
<button
type="button"
class="theme-toggle"
:aria-pressed="isDark"
:aria-label="isDark ? '切换到浅色模式' : '切换到深色模式'"
@click="toggle"
>
<IconSunLine v-if="isDark" class="theme-toggle__icon" />
<IconMoonLine v-else class="theme-toggle__icon" />
<span class="theme-toggle__label">
{{ isDark ? '浅色模式' : '深色模式' }}
</span>
</div>
</button>
</template>
<style scoped>
@@ -21,9 +27,13 @@ const { isDark, toggle } = useDarkMode()
display: flex;
align-items: center;
gap: 0.5rem;
width: 100%;
padding: 0.5rem 0.75rem;
cursor: pointer;
border: 0;
background: transparent;
color: var(--halo-text-secondary);
font: inherit;
cursor: pointer;
border-radius: 0.25rem;
transition: background-color 0.15s, color 0.15s;
user-select: none;
@@ -34,6 +44,11 @@ const { isDark, toggle } = useDarkMode()
color: var(--halo-text-primary);
}
.theme-toggle:focus-visible {
outline: 2px solid var(--halo-accent-primary);
outline-offset: 2px;
}
.theme-toggle__icon {
width: 1.125rem;
height: 1.125rem;
@@ -44,4 +59,4 @@ const { isDark, toggle } = useDarkMode()
font-size: 0.8125rem;
white-space: nowrap;
}
</style>
</style>
@@ -0,0 +1,106 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { nextTick } from 'vue'
const STORAGE_KEY = 'halo-dark-mode-theme'
function mockMatchMedia(matches: boolean): void {
window.matchMedia = vi.fn().mockImplementation((query: string) => ({
matches,
media: query,
onchange: null,
addEventListener: vi.fn(),
removeEventListener: vi.fn(),
addListener: vi.fn(),
removeListener: vi.fn(),
dispatchEvent: vi.fn(),
}))
}
describe('useDarkMode', () => {
let useDarkMode: typeof import('../useDarkMode').useDarkMode
async function load(systemDark = false): Promise<void> {
vi.resetModules()
localStorage.clear()
mockMatchMedia(systemDark)
const mod = await import('../useDarkMode')
useDarkMode = mod.useDarkMode
}
beforeEach(async () => {
await load(false)
})
it('默认 auto 且系统为深色时 isDark 为 true', async () => {
await load(true)
const { theme, isDark } = useDarkMode()
expect(theme.value).toBe('auto')
expect(isDark.value).toBe(true)
})
it('auto 模式下点击切换变为显式深色并持久化', async () => {
const { theme, toggle } = useDarkMode()
toggle()
expect(theme.value).toBe('dark')
await nextTick()
expect(localStorage.getItem(STORAGE_KEY)).toBe('dark')
})
it('auto 且系统为深色时点击切换变为显式浅色', async () => {
await load(true)
const { theme, toggle } = useDarkMode()
toggle()
expect(theme.value).toBe('light')
await nextTick()
expect(localStorage.getItem(STORAGE_KEY)).toBe('light')
})
it('dark 与 light 之间往返切换', async () => {
const { theme, toggle } = useDarkMode()
theme.value = 'dark'
toggle()
expect(theme.value).toBe('light')
toggle()
expect(theme.value).toBe('dark')
await nextTick()
expect(localStorage.getItem(STORAGE_KEY)).toBe('dark')
})
it('setTheme 会持久化到 localStorage', async () => {
const { setTheme } = useDarkMode()
setTheme('dark')
await nextTick()
expect(localStorage.getItem(STORAGE_KEY)).toBe('dark')
})
it('localStorage 非法值回退到 auto', async () => {
localStorage.setItem(STORAGE_KEY, 'not-a-theme')
await load(false)
const { theme } = useDarkMode()
expect(theme.value).toBe('auto')
})
it('storage 事件会同步其他标签页的主题', () => {
const { theme, setTheme } = useDarkMode()
setTheme('light')
window.dispatchEvent(
new StorageEvent('storage', {
key: STORAGE_KEY,
newValue: 'dark',
}),
)
expect(theme.value).toBe('dark')
})
it('storage 事件忽略非法值', () => {
const { theme, setTheme } = useDarkMode()
setTheme('light')
window.dispatchEvent(
new StorageEvent('storage', {
key: STORAGE_KEY,
newValue: 'invalid',
}),
)
expect(theme.value).toBe('light')
})
})
+19 -4
View File
@@ -26,13 +26,19 @@ function persistTheme(theme: ThemeMode): void {
}
}
/** 将 data-halo-theme 属性应用到 <html> 元素 */
/**
* 将主题状态同步到 <html>。
* data-halo-theme 为兼容性遗留标记,当前已无 CSS 消费方,保留给外部脚本与验证工具;
* color-scheme 用于在 Dark Reader 异步注入前同步浏览器控件外观,缓解 FOUC。
*/
function applyHtmlAttribute(isDark: boolean): void {
const root = document.documentElement
if (isDark) {
document.documentElement.setAttribute('data-halo-theme', 'dark')
root.setAttribute('data-halo-theme', 'dark')
} else {
document.documentElement.removeAttribute('data-halo-theme')
root.removeAttribute('data-halo-theme')
}
root.style.colorScheme = isDark ? 'dark' : 'light'
}
// 模块级单例 — 所有组件共享同一个状态
@@ -52,6 +58,15 @@ watch(isDark, (dark) => applyHtmlAttribute(dark), { immediate: true })
// 监听 theme 变化 → 持久化
watch(theme, (t) => persistTheme(t))
// 多标签页同步:其他标签页修改主题时跟随更新
window.addEventListener('storage', (event) => {
if (event.key !== STORAGE_KEY) return
const value = event.newValue
if (value === 'light' || value === 'dark' || value === 'auto') {
theme.value = value
}
})
// 监听系统偏好变化 → 仅在 'auto' 模式下响应
onChange((systemDark) => {
if (theme.value === 'auto') {
@@ -83,4 +98,4 @@ export function useDarkMode() {
setTheme,
toggle,
}
}
}
+3 -2
View File
@@ -4,8 +4,9 @@ import { useDarkMode } from './composables/useDarkMode'
/**
* Dark Reader 引擎参数。
* brightness/contrast 保持默认观感,背景色与现有 Halo 暗色变量接近,
* 让 Dark Reader 补全第三方插件页面时不会显得突兀
* 纯 Dark Reader 策略下不再维护手工 CSS 覆盖;
* 这里只调整通用观感参数,让核心与第三方插件页面转换后风格统一
* 注意:DR 注入为异步过程,刷新闪烁只能由 useDarkMode 的 color-scheme 同步缓解。
*/
const DARK_READER_THEME = {
brightness: 100,
+1 -3
View File
@@ -4,11 +4,9 @@ import { markRaw } from 'vue'
import './styles/index.css'
import { initDarkReaderEngine } from './darkreader-engine'
import { injectThemeToggle } from './injector'
import { initMonacoThemeSync } from './monaco-theme'
// 在插件加载后将切换器注入到侧边栏,并让 Monaco 跟随主题
// 在插件加载后将切换器注入到侧边栏,暗色转换完全交给 Dark Reader
injectThemeToggle()
initMonacoThemeSync()
initDarkReaderEngine()
export default definePlugin({
-43
View File
@@ -1,43 +0,0 @@
/**
* 让 Monaco Editor(日志查看器)跟随 Halo 暗色模式。
* 优先调用 Monaco 官方主题 APICSS 兜底见 styles/overrides/editor.css。
*/
type MonacoLike = {
editor?: {
setTheme: (name: string) => void
}
}
const DARK_THEME = 'vs-dark'
const LIGHT_THEME = 'vs'
function getMonaco(): MonacoLike | undefined {
return (window as unknown as { monaco?: MonacoLike }).monaco
}
function applyMonacoTheme(): void {
const monaco = getMonaco()
if (!monaco?.editor?.setTheme) return
const isDark = document.documentElement.getAttribute('data-halo-theme') === 'dark'
monaco.editor.setTheme(isDark ? DARK_THEME : LIGHT_THEME)
}
/** 初始化 Monaco 主题同步:立即应用,并监听属性变化与实例懒加载。 */
export function initMonacoThemeSync(): void {
applyMonacoTheme()
const attributeObserver = new MutationObserver(() => applyMonacoTheme())
attributeObserver.observe(document.documentElement, {
attributes: true,
attributeFilter: ['data-halo-theme'],
})
// 日志页面可能懒加载 Monaco,实例渲染后再补一次
const instanceObserver = new MutationObserver(() => {
if (document.querySelector('.monaco-editor')) {
applyMonacoTheme()
}
})
instanceObserver.observe(document.body, { childList: true, subtree: true })
}
+2 -11
View File
@@ -1,15 +1,6 @@
/* ============================================================
Halo Dark Mode — 样式入口
按加载顺序导入所有样式文件
仅保留插件自身 UI 变量;页面暗色转换完全交给 Dark Reader。
============================================================ */
@import './variables.css';
@import './overrides/halo-core.css';
@import './overrides/plugin-pages.css';
@import './overrides/uno-fallback.css';
@import './overrides/utilities.css';
@import './overrides/layout.css';
@import './overrides/components.css';
@import './overrides/forms.css';
@import './overrides/editor.css';
@import './overrides/scrollbar.css';
@import './variables.css';
-70
View File
@@ -1,70 +0,0 @@
/* ============================================================
Halo Dark Mode — Halo 组件库覆盖(已清理)
已删除 Halo 2.25 中不存在的 Vuetify 类(.v-card 等),
真实 DOM 类覆盖请优先维护 halo-core.css。
============================================================ */
[data-halo-theme="dark"] {
/* ===== 模态框(具体类 + !important,防被核心 scoped 样式覆盖) ===== */
.modal-content,
.modal-header,
.modal-body,
.modal-footer {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
}
/* ===== 表格 VTable ===== */
table {
background-color: var(--halo-bg-card);
color: var(--halo-text-primary);
}
thead,
.table-header {
background-color: var(--halo-table-header-bg);
}
thead th,
.table-header th {
color: var(--halo-text-secondary);
border-color: var(--halo-table-border);
}
tbody td,
.table-body td {
border-color: var(--halo-table-border);
}
tbody tr:hover,
.table-row:hover {
background-color: var(--halo-table-row-hover);
}
/* ===== 分页 ===== */
.pagination {
color: var(--halo-text-secondary);
}
.pagination .active {
background-color: var(--halo-accent-primary);
color: var(--halo-accent-primary-text);
}
/* ===== 面包屑 ===== */
.breadcrumb {
color: var(--halo-text-secondary);
}
.breadcrumb a {
color: var(--halo-text-link);
}
/* ===== Toast / 通知 ===== */
.toast-notification,
[class*="toast"] {
background-color: var(--halo-bg-card);
color: var(--halo-text-primary);
border-color: var(--halo-border-base);
}
}
-263
View File
@@ -1,263 +0,0 @@
/* ============================================================
Halo Dark Mode — 富文本编辑器覆盖
@halo-dev/richtext-editor + TipTap / ProseMirror
+ Bytemd (Markdown 编辑器) + CodeMirror
============================================================ */
[data-halo-theme="dark"] {
/* ===== Bytemd Markdown 编辑器 ===== */
.bytemd {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.bytemd-toolbar {
background-color: var(--halo-bg-content) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-light) !important;
}
.bytemd-toolbar-icon {
color: var(--halo-text-secondary) !important;
}
.bytemd-toolbar-icon:hover {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
}
.bytemd-toolbar-tab-active,
.bytemd-toolbar-icon-active {
color: var(--halo-accent-primary) !important;
}
.bytemd-editor,
.bytemd-editor .CodeMirror {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
}
.bytemd-preview {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
}
.bytemd-status,
.bytemd-status-right,
.bytemd-status-left {
background-color: var(--halo-bg-content) !important;
color: var(--halo-text-secondary) !important;
border-color: var(--halo-border-light) !important;
}
.bytemd-dropdown,
.bytemd-dropdown-menu,
[class*="bytemd-dropdown"] {
background-color: var(--halo-bg-dropdown) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.bytemd-dropdown-title {
color: var(--halo-text-secondary) !important;
}
.bytemd-dropdown-item {
color: var(--halo-text-primary) !important;
}
.bytemd-dropdown-item:hover {
background-color: var(--halo-bg-hover) !important;
}
.bytemd-sidebar,
.bytemd-toc,
.bytemd-toc ul,
.bytemd-toc li {
background-color: var(--halo-bg-content) !important;
color: var(--halo-text-secondary) !important;
}
.bytemd-toc-active {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-accent-primary) !important;
}
.bytemd-floating-btn {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-secondary) !important;
border-color: var(--halo-border-base) !important;
}
.bytemd-floating-btn:hover {
background-color: var(--halo-bg-hover) !important;
}
.bytemd-floating-btn.active {
background-color: var(--halo-bg-active) !important;
color: var(--halo-accent-primary) !important;
}
.bytemd-code-theme-toggle,
.bytemd-copy-code-btn,
[class*="bytemd"] button {
color: var(--halo-text-secondary) !important;
}
.bytemd-copy-code-btn:hover,
[class*="bytemd"] button:hover {
color: var(--halo-text-primary) !important;
background-color: var(--halo-bg-hover) !important;
}
/* 编辑器内 markdown 正文 */
.bytemd-preview .markdown-body,
.bytemd-editor .markdown-body {
color: var(--halo-text-primary) !important;
}
.bytemd-preview .markdown-body p,
.bytemd-preview .markdown-body li,
.bytemd-preview .markdown-body h1,
.bytemd-preview .markdown-body h2,
.bytemd-preview .markdown-body h3,
.bytemd-preview .markdown-body h4,
.bytemd-preview .markdown-body td,
.bytemd-preview .markdown-body th,
.bytemd-preview .markdown-body blockquote {
color: var(--halo-text-primary) !important;
}
.bytemd-preview .markdown-body code,
.bytemd-preview .markdown-body pre,
.bytemd-preview .markdown-body pre code {
background-color: oklch(22% 0.02 250) !important;
color: oklch(85% 0.05 160) !important;
}
.bytemd-preview .markdown-body table tr,
.bytemd-preview .markdown-body table tr:nth-child(2n) {
background-color: var(--halo-bg-card) !important;
}
.bytemd-preview .markdown-body table td,
.bytemd-preview .markdown-body table th {
border-color: var(--halo-border-base) !important;
}
/* ===== CodeMirror 代码编辑器 ===== */
.CodeMirror {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
}
.CodeMirror-gutters {
background-color: var(--halo-bg-content) !important;
border-color: var(--halo-border-light) !important;
}
.CodeMirror-linenumber {
color: var(--halo-text-tertiary) !important;
}
.CodeMirror-cursor {
border-color: var(--halo-text-primary) !important;
}
.CodeMirror-selected {
background-color: oklch(30% 0.04 160 / 50%) !important;
}
.cm-s-default .cm-header,
.cm-s-default .cm-strong,
.cm-s-default .cm-em,
.cm-s-default .cm-link,
.cm-s-default .cm-url {
color: var(--halo-text-primary) !important;
}
.cm-s-default .cm-comment {
color: var(--halo-text-tertiary) !important;
}
.cm-s-default .cm-quote {
color: var(--halo-accent-success) !important;
}
.cm-s-default .cm-tag {
color: var(--halo-accent-primary) !important;
}
.CodeMirror pre.CodeMirror-placeholder {
color: var(--halo-text-tertiary) !important;
}
.CodeMirror-activeline-background {
background-color: var(--halo-bg-hover) !important;
}
.CodeMirror-lines {
color: var(--halo-text-primary) !important;
}
/* ===== ProseMirror / TipTap 编辑器主体 ===== */
.ProseMirror,
.tiptap,
[class*="editor-content"] {
color: var(--halo-text-primary);
background-color: var(--halo-bg-input);
}
/* ===== 编辑器菜单栏 ===== */
.editor-toolbar,
.editor-menubar,
[class*="editor-toolbar"],
[class*="editor-menubar"] {
background-color: var(--halo-bg-card);
border-color: var(--halo-border-base);
}
.editor-toolbar button,
.editor-menubar button {
color: var(--halo-text-secondary);
}
.editor-toolbar button:hover,
.editor-menubar button:hover,
.editor-toolbar button.is-active,
.editor-menubar button.is-active {
background-color: var(--halo-bg-hover);
color: var(--halo-text-primary);
}
/* ===== 代码块 ===== */
.ProseMirror pre,
.ProseMirror code,
.tiptap pre,
.tiptap code {
background-color: oklch(20% 0.015 250);
color: oklch(85% 0.03 160);
}
/* ===== Bubble menu / floating menu ===== */
.tippy-box,
.tiptap-bubble-menu,
.floating-menu {
background-color: var(--halo-bg-dropdown);
border-color: var(--halo-border-base);
color: var(--halo-text-primary);
}
/* ===== 编辑器占位符 ===== */
.ProseMirror p.is-editor-empty:first-child::before {
color: var(--halo-text-tertiary);
}
/* ===== 链接 ===== */
.ProseMirror a,
.tiptap a {
color: var(--halo-text-link);
}
/* ===== 选中文字 ===== */
.ProseMirror ::selection,
.tiptap ::selection {
background-color: oklch(30% 0.04 160 / 50%);
}
}
/* ===== Monaco Editor(日志查看器,JS 主题优先,此处仅兜底) ===== */
html[data-halo-theme="dark"] .monaco-editor.vs,
html[data-halo-theme="dark"] .monaco-editor.vs .margin,
html[data-halo-theme="dark"] .monaco-editor.vs .lines-content,
html[data-halo-theme="dark"] .monaco-editor.vs .monaco-scrollable-element {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .monaco-editor.vs .line-numbers {
color: var(--halo-text-tertiary) !important;
}
html[data-halo-theme="dark"] .monaco-editor.vs .cursor {
border-color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .monaco-editor.vs .selected-text,
html[data-halo-theme="dark"] .monaco-editor.vs .view-overlays .selected-text {
background-color: oklch(30% 0.04 160 / 50%) !important;
}
html[data-halo-theme="dark"] .monaco-editor.vs .find-widget,
html[data-halo-theme="dark"] .monaco-editor.vs .monaco-hover {
background-color: var(--halo-bg-dropdown) !important;
color: var(--halo-text-primary) !important;
}
/* ===== 编辑器链接(覆盖通用链接色规则) ===== */
html[data-halo-theme="dark"] .ProseMirror a,
html[data-halo-theme="dark"] .tiptap a {
color: var(--halo-text-link) !important;
}
-102
View File
@@ -1,102 +0,0 @@
/* ============================================================
Halo Dark Mode — FormKit 表单组件覆盖
覆盖输入框、选择器、开关、复选框等表单元素
============================================================ */
[data-halo-theme="dark"] {
/* ===== 输入框 ===== */
input[type="text"],
input[type="password"],
input[type="email"],
input[type="number"],
input[type="search"],
input[type="url"],
input[type="tel"],
textarea,
select,
.formkit-input,
[data-formkit-input] {
background-color: var(--halo-bg-input);
color: var(--halo-text-primary);
border-color: var(--halo-border-input);
}
input:focus,
textarea:focus,
select:focus,
.formkit-input:focus {
border-color: var(--halo-border-focus);
outline-color: var(--halo-border-focus);
}
input::placeholder,
textarea::placeholder,
.formkit-input::placeholder {
color: var(--halo-text-tertiary);
}
input:disabled,
textarea:disabled,
select:disabled {
background-color: var(--halo-bg-disabled);
color: var(--halo-text-tertiary);
}
/* ===== 复选框/单选框 ===== */
input[type="checkbox"],
input[type="radio"],
.formkit-checkbox,
.formkit-radio {
accent-color: var(--halo-accent-primary);
}
/* ===== FormKit 标签和帮助文本 ===== */
.formkit-label,
.formkit-legend {
color: var(--halo-text-secondary);
}
.formkit-help,
.formkit-message {
color: var(--halo-text-tertiary);
}
/* ===== FormKit 外层 ===== */
.formkit-outer {
color: var(--halo-text-primary);
}
/* ===== FormKit 前缀/后缀 ===== */
.formkit-prefix,
.formkit-suffix {
background-color: var(--halo-bg-hover);
color: var(--halo-text-secondary);
border-color: var(--halo-border-input);
}
/* ===== 选择器下拉 ===== */
select option {
background-color: var(--halo-bg-dropdown);
color: var(--halo-text-primary);
}
/* ===== 代码块 in forms ===== */
.formkit-code {
background-color: var(--halo-bg-hover);
color: var(--halo-text-primary);
border-color: var(--halo-border-base);
}
}
/* ===== 强表单覆盖(scoped 哈希类特异性更高,需 html 前缀 + !important ===== */
html[data-halo-theme="dark"] input:not([type="checkbox"]):not([type="radio"]):not([type="color"]),
html[data-halo-theme="dark"] textarea,
html[data-halo-theme="dark"] select {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-input) !important;
}
html[data-halo-theme="dark"] input:not([type="checkbox"]):not([type="radio"]):not([type="color"])::placeholder,
html[data-halo-theme="dark"] textarea::placeholder,
html[data-halo-theme="dark"] select::placeholder {
color: var(--halo-text-tertiary) !important;
}
-308
View File
@@ -1,308 +0,0 @@
/* ===== 根元素背景(html 自身携带属性,需独立选择器) ===== */
html[data-halo-theme="dark"] {
background-color: var(--halo-bg-body) !important;
}
/* ============================================================
Halo Dark Mode — Halo 核心 BEM 类覆盖
基于 Halo 2.25 真实 DOM 扫描(demo.halocms.site)得出的选择器
============================================================ */
[data-halo-theme="dark"] {
/* ===== 页面根背景(body 溢出时兜底,html 见文件顶部独立规则) ===== */
body {
background-color: var(--halo-bg-body) !important;
color: var(--halo-text-primary);
}
/* ===== Toast 通知 ===== */
.toast-container .toast-body {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base);
}
/* ===== Markdown 正文(编辑器预览/瞬间预览) ===== */
.markdown-body {
background-color: transparent;
color: var(--halo-text-primary);
}
.markdown-body p,
.markdown-body li,
.markdown-body h1,
.markdown-body h2,
.markdown-body h3,
.markdown-body h4,
.markdown-body h5,
.markdown-body h6,
.markdown-body td,
.markdown-body th,
.markdown-body blockquote,
.markdown-body a {
color: var(--halo-text-primary);
}
.markdown-body a {
color: var(--halo-text-link);
}
.markdown-body code,
.markdown-body tt {
background-color: oklch(28% 0.02 250);
color: oklch(85% 0.05 160);
}
.markdown-body pre,
.markdown-body .highlight pre {
background-color: oklch(20% 0.015 250);
color: oklch(85% 0.03 160);
}
.markdown-body table tr,
.markdown-body table tr:nth-child(2n) {
background-color: var(--halo-bg-card);
}
.markdown-body table td,
.markdown-body table th {
border-color: var(--halo-border-base);
}
.markdown-body hr {
background-color: var(--halo-border-base);
}
/* ===== 页面顶栏 ===== */
.page-header {
background-color: var(--halo-bg-card);
}
.page-header__title-text {
color: var(--halo-text-primary);
}
.page-header__actions .btn,
.page-header__actions button {
background-color: var(--halo-bg-card);
color: var(--halo-text-primary);
border-color: var(--halo-border-base);
}
.page-header__actions .btn:hover,
.page-header__actions button:hover {
background-color: var(--halo-bg-hover);
}
.page-header__actions .btn-content {
color: var(--halo-text-primary);
}
/* ===== 卡片容器(列表页、详情页主容器) ===== */
.card-wrapper {
background-color: var(--halo-bg-card);
border-color: var(--halo-border-base);
color: var(--halo-text-primary);
}
/* ===== 实体字段列表(文章/页面/评论列表项) ===== */
.entity-field-title {
color: var(--halo-text-primary);
}
.entity-field-title-body {
color: var(--halo-text-primary);
}
.entity-field-description {
color: var(--halo-text-secondary);
}
/* ===== 分页 ===== */
.pagination {
background-color: var(--halo-bg-card);
color: var(--halo-text-secondary);
}
.pagination__btn {
background-color: var(--halo-bg-hover);
color: var(--halo-text-secondary);
}
.pagination__btn:hover {
background-color: var(--halo-bg-active);
color: var(--halo-text-primary);
}
.pagination__select {
background-color: var(--halo-bg-input);
color: var(--halo-text-primary);
border-color: var(--halo-border-input);
}
/* ===== 标签/徽章(BEM ===== */
.tag-wrapper,
.tag-default,
.tag-pill {
background-color: var(--halo-bg-hover);
color: var(--halo-text-secondary);
}
.tag-content,
.tag-left-icon,
.tag-right-icon {
color: var(--halo-text-secondary);
}
/* ===== 头像 ===== */
.avatar-wrapper,
.avatar-circle {
background-color: var(--halo-bg-hover);
}
/* ===== 按钮(默认态) ===== */
.btn-default,
.btn-secondary,
.btn-sm,
.btn-md,
.btn-lg,
.btn[class*="btn"]:not(.btn-primary):not(.btn-danger) {
background-color: var(--halo-bg-card);
color: var(--halo-text-primary);
border-color: var(--halo-border-base);
}
.btn-default:hover,
.btn-secondary:hover,
.btn-sm:hover,
.btn-md:hover,
.btn-lg:hover {
background-color: var(--halo-bg-hover);
}
.btn-content {
color: var(--halo-text-primary);
}
/* ===== 表单容器(FormKit ===== */
.formkit-inner {
background-color: var(--halo-bg-input);
}
.formkit-inner input,
.formkit-inner textarea,
.formkit-inner select {
background-color: transparent;
color: var(--halo-text-primary);
}
.formkit-inner .border,
.formkit-inner [class*="border-gray"] {
border-color: var(--halo-border-input);
}
/* ===== 下拉菜单 ===== */
.entity-dropdown {
background-color: var(--halo-bg-dropdown);
color: var(--halo-text-primary);
border-color: var(--halo-border-base);
}
.entity-dropdown-trigger {
background-color: var(--halo-bg-hover);
color: var(--halo-text-secondary);
}
.entity-dropdown-trigger:hover {
background-color: var(--halo-bg-active);
color: var(--halo-text-primary);
}
/* ===== 描述项(详情页列表,如用户详情) ===== */
.description-item-wrapper {
background-color: var(--halo-bg-card);
border-color: var(--halo-border-light);
}
.description-item__label {
color: var(--halo-text-secondary) !important;
}
.description-item__content {
color: var(--halo-text-primary) !important;
}
/* ===== 已选指示器 ===== */
.entity-selected-indicator {
color: var(--halo-accent-primary);
}
/* ===== 表格 ===== */
.table,
[class*="table-"] td,
[class*="table-"] th {
border-color: var(--halo-table-border);
color: var(--halo-text-primary);
}
/* ===== 通用文字(UnoCSS hash 类包含 Tailwind 语义) ===== */
.hover\:text-gray-600:hover,
.hover\:text-gray-700:hover,
.hover\:text-gray-500:hover,
.text-gray-600,
.text-gray-700,
.text-gray-500 {
color: var(--halo-text-secondary);
}
.text-gray-900,
.text-gray-800 {
color: var(--halo-text-primary);
}
.text-gray-400,
.text-gray-300 {
color: var(--halo-text-tertiary);
}
/* ===== 通用背景 ===== */
.bg-gray-50,
.bg-gray-100,
.bg-white {
background-color: var(--halo-bg-card);
}
.bg-gray-200 {
background-color: var(--halo-bg-hover);
}
.hover\:bg-gray-50:hover,
.hover\:bg-gray-100:hover,
.hover\:bg-gray-200:hover {
background-color: var(--halo-bg-hover);
}
/* ===== 边框 ===== */
.border,
.border-gray-200,
.border-gray-300 {
border-color: var(--halo-border-base);
}
}
/* ===== 侧边栏激活菜单(Halo 核心 .menu-item-title.active ===== */
html[data-halo-theme="dark"] .menu-item-title.active,
html[data-halo-theme="dark"] .menu-item-title.active:hover {
background-color: var(--halo-menu-item-active) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .menu-item-title.active::after {
background: var(--halo-accent-primary) !important;
}
/* ===== 空状态标题 ===== */
html[data-halo-theme="dark"] .empty-wrapper .empty-title {
color: var(--halo-text-secondary) !important;
}
/* ===== 提示条(Alert ===== */
html[data-halo-theme="dark"] .alert-wrapper {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .alert-wrapper .alert-title,
html[data-halo-theme="dark"] .alert-wrapper .alert-description,
html[data-halo-theme="dark"] .alert-wrapper .alert-icon {
color: var(--halo-text-secondary) !important;
}
html[data-halo-theme="dark"] .alert-wrapper.alert-warning {
border-color: oklch(40% 0.12 85) !important;
}
html[data-halo-theme="dark"] .alert-wrapper.alert-error {
border-color: oklch(40% 0.17 25) !important;
}
html[data-halo-theme="dark"] .alert-wrapper.alert-success {
border-color: oklch(40% 0.14 150) !important;
}
/* ===== 实体列表标题链接(覆盖通用链接色,hover 变链接色) ===== */
html[data-halo-theme="dark"] .entity-field-title a,
html[data-halo-theme="dark"] .entity-field-title-body a {
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .entity-field-title a:hover,
html[data-halo-theme="dark"] .entity-field-title-body a:hover {
color: var(--halo-text-link) !important;
}
-61
View File
@@ -1,61 +0,0 @@
/* ============================================================
Halo Dark Mode — 核心布局覆盖
覆盖 BasicLayout.vue 的硬编码颜色
============================================================ */
[data-halo-theme="dark"] {
/* ===== 页面整体 ===== */
.layout {
background-color: var(--halo-bg-body);
}
/* ===== 侧边栏 ===== */
.sidebar {
background-color: var(--halo-bg-sidebar);
box-shadow: var(--halo-shadow-sm);
}
.sidebar__search {
background-color: var(--halo-search-bg);
color: var(--halo-search-placeholder);
}
.sidebar__search:hover {
color: var(--halo-search-text);
}
.sidebar__search-icon {
color: inherit;
}
.sidebar__search-shortcut {
color: var(--halo-text-tertiary);
}
.sidebar__logo {
filter: brightness(0.9) invert(0);
}
.sidebar__profile {
border-top-color: var(--halo-border-light);
}
/* ===== 内容区 ===== */
.main-content {
background-color: var(--halo-bg-content);
color: var(--halo-text-primary);
}
.main-content__footer-text {
color: var(--halo-text-tertiary);
}
.main-content__footer-link {
color: var(--halo-text-link);
}
/* ===== 页面标题 ===== */
.page-title {
color: var(--halo-text-primary);
}
}
-383
View File
@@ -1,383 +0,0 @@
/* ============================================================
Halo Dark Mode — 第三方插件页面覆盖
针对用户服务器上已安装插件的内部 UI 残留。
⚠️ 这些插件使用 Vue scoped 样式 ([data-v-xxx])
需用 !important 才能稳定覆盖。
============================================================ */
[data-halo-theme="dark"] {
/* ===== 装备管理插件 (halo-plugin-equipments) ===== */
.equipments .group,
.equipment-group .group,
main .group {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
.equipment-card,
.equipment-card__name,
.equipment-card__desc,
[class*="equipment"] {
color: var(--halo-text-primary) !important;
}
/* ===== 日程日历插件 (plugin-calendar) ===== */
.week-picker {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
}
.week-picker select,
.week-picker input,
.week-picker button {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-input) !important;
}
.day-column__body {
background-color: var(--halo-bg-content) !important;
border-color: var(--halo-border-light) !important;
}
.day-column,
.calendar-column,
[class*="day-column"] {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
}
[class*="calendar"] th,
[class*="calendar"] td {
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
/* ===== 心愿便签插件 (plugin-wishboard) ===== */
.ah-body {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
}
.wb-s-card {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.wb-s-card-title {
color: var(--halo-text-primary) !important;
}
.wb-s-card-count {
color: var(--halo-accent-primary) !important;
}
.wb-s-list,
.wb-s-list-item,
[class*="wb-s-"] {
color: var(--halo-text-primary) !important;
}
/* ===== 瞬间插件 (plugin-moments) ===== */
.moment-editor,
.editor-main,
.moment-editor .card,
.editor-main .card {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.moments-content .card,
.moments-content .preview,
.moment-preview,
.moment-card,
[class*="moment-"] .card {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
}
.moment-author-name,
.moment-content,
.moment-time,
[class*="moment"] p,
[class*="moment"] span,
[class*="moment"] div {
color: var(--halo-text-primary) !important;
}
.moment-editor input,
.moment-editor textarea,
.editor-main input,
.editor-main textarea {
background-color: var(--halo-bg-input) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-input) !important;
}
/* ===== 抽奖插件 (plugin-lottery) ===== */
[class*="lottery"] {
color: var(--halo-text-primary) !important;
}
/* ===== 存储工具箱 (plugin-storage-toolkit) ===== */
.toolkit-wrapper,
.st-scope {
background-color: var(--halo-bg-content) !important;
color: var(--halo-text-primary) !important;
}
.st-pill-tabs,
.stat-card.st-card,
.panel-card.st-card,
.st-card {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.st-card h3,
.st-card h4,
.st-card p,
.st-card span,
.st-card li,
[class*="st-"] .title,
[class*="st-"] .name {
color: var(--halo-text-primary) !important;
}
[class*="st-"] {
color: var(--halo-text-primary) !important;
}
/* ===== 应用市场已安装 (Halo 内置 app-store) ===== */
.tabbar-wrapper,
.tabbar-outline,
[class*="tabbar"] {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.tabbar-item,
[class*="tabbar"] a,
[class*="tabbar"] span {
color: var(--halo-text-primary) !important;
}
.tabbar-item:hover,
[class*="tabbar"] a:hover {
background-color: var(--halo-bg-active) !important;
color: var(--halo-text-primary) !important;
}
/* 已安装应用页的筛选和卡片 */
.app-card,
.app-card-header,
.app-card-body,
[class*="app-card"] {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.app-card .title,
.app-card .name,
.app-card .desc,
[class*="app-card"] h3,
[class*="app-card"] p {
color: var(--halo-text-primary) !important;
}
/* ===== 文档/示例页面 (docs__box) ===== */
.docs__box {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
.docs__box h3,
.docs__box h4,
.docs__box p,
.docs__box li,
.docs__box a {
color: var(--halo-text-primary) !important;
}
.docs__box a:hover {
color: var(--halo-text-link) !important;
}
/* ===== 通用:任何插件页面的亮色卡片兜底 ===== */
main .bg-gray-50,
main .bg-gray-100,
main .bg-gray-200 {
background-color: var(--halo-bg-hover) !important;
}
main .bg-white {
background-color: var(--halo-bg-card) !important;
}
/* ===== 应用卡片内筛选 tabUnoCSS hash 类,用上下文定位) ===== */
.card-wrapper .card-header [class*="i-"],
.card-header [class*="i-"],
.card-wrapper .card-body [class*="i-"],
.card-body [class*="i-"],
[class*="app-card"] [class*="i-"] {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
}
.card-wrapper .card-header [class*="i-"]:hover,
.card-header [class*="i-"]:hover,
.card-wrapper .card-body [class*="i-"]:hover,
.card-body [class*="i-"]:hover {
background-color: var(--halo-bg-active) !important;
color: var(--halo-text-primary) !important;
}
/* ===== 存储工具箱表格表头 (col-*) ===== */
.col-name,
.col-count,
.col-size,
.col-percent,
[class*="col-"] {
background-color: var(--halo-table-header-bg) !important;
color: var(--halo-text-secondary) !important;
}
/* ===== 侧边栏用户资料(Halo Pro 特有) ===== */
.sidebar__profile .user-profile {
background-color: transparent !important;
}
.user-profile__name {
color: var(--halo-text-primary) !important;
}
.user-profile__roles .tag-default,
.user-profile__roles .tag-wrapper {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-secondary) !important;
}
.user-profile__action-button {
color: var(--halo-text-secondary) !important;
background-color: transparent !important;
}
.user-profile__action-button:hover {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
}
}
/* ===== AstraHub / 心愿便签(共用 ah-* UI ===== */
html[data-halo-theme="dark"] .ah-card,
html[data-halo-theme="dark"] .ah-topbar,
html[data-halo-theme="dark"] .ah-topbar-search,
html[data-halo-theme="dark"] .ah-float-nav {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .ah-topbar-search {
background-color: var(--halo-bg-input) !important;
}
html[data-halo-theme="dark"] .ah-topbar-brand,
html[data-halo-theme="dark"] .planet-hero-title {
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .ah-topbar-search input {
background-color: transparent !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .planet-links-more {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-secondary) !important;
}
/* ===== RSS 订阅(links/rss ===== */
html[data-halo-theme="dark"] .subscription-panel,
html[data-halo-theme="dark"] .feed-main,
html[data-halo-theme="dark"] .feed-toolbar,
html[data-halo-theme="dark"] .feed-stream,
html[data-halo-theme="dark"] .feed-stream__footer {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .feed-status-tabs {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-secondary) !important;
}
html[data-halo-theme="dark"] .feed-brief__title,
html[data-halo-theme="dark"] .feed-stream p,
html[data-halo-theme="dark"] .feed-stream a,
html[data-halo-theme="dark"] .subscription-panel a,
html[data-halo-theme="dark"] .subscription-panel span {
color: var(--halo-text-primary) !important;
}
/* ===== 私密文章插件 ===== */
html[data-halo-theme="dark"] .focus-card,
html[data-halo-theme="dark"] .overview-card,
html[data-halo-theme="dark"] .list-card,
html[data-halo-theme="dark"] .empty-state {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .overview-card h2,
html[data-halo-theme="dark"] .page-shell h2,
html[data-halo-theme="dark"] .overview-stats dd,
html[data-halo-theme="dark"] .overview-stats dt {
color: var(--halo-text-primary) !important;
}
/* ===== AI 评论自动处理插件 ===== */
html[data-halo-theme="dark"] .settings-container,
html[data-halo-theme="dark"] .setting-panel,
html[data-halo-theme="dark"] .tabs-wrap,
html[data-halo-theme="dark"] .sidebar-card,
html[data-halo-theme="dark"] .list-empty,
html[data-halo-theme="dark"] .reply-card {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .form-row,
html[data-halo-theme="dark"] .list-col,
html[data-halo-theme="dark"] .panel-header,
html[data-halo-theme="dark"] .card-footer {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .section-header__text h3,
html[data-halo-theme="dark"] .sidebar-header h4,
html[data-halo-theme="dark"] .panel-header h3,
html[data-halo-theme="dark"] .reply-card h3 {
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .wake-word-tag {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-secondary) !important;
}
/* ===== 数据工坊 / 代码注入器等工具页语义容器 ===== */
html[data-halo-theme="dark"] .data-studio-card-body,
html[data-halo-theme="dark"] .injector-view-card-body,
html[data-halo-theme="dark"] .injector-editor-container {
background-color: var(--halo-bg-card) !important;
border-color: var(--halo-border-base) !important;
color: var(--halo-text-primary) !important;
}
/* ===== 示例插件页 ===== */
html[data-halo-theme="dark"] main section#plugin-starter {
background-color: var(--halo-bg-body) !important;
color: var(--halo-text-primary) !important;
}
/* ===== 友链卡片徽章 ===== */
html[data-halo-theme="dark"] .link-badge {
background-color: var(--halo-bg-hover) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
/* ===== 日程日历插件(time-column 布局) ===== */
html[data-halo-theme="dark"] .time-column__header,
html[data-halo-theme="dark"] .time-column__body,
html[data-halo-theme="dark"] [class*="time-column"] {
background-color: var(--halo-bg-card) !important;
color: var(--halo-text-primary) !important;
border-color: var(--halo-border-base) !important;
}
html[data-halo-theme="dark"] .entry-card-header__title {
color: var(--halo-text-primary) !important;
}
/* ===== 存储工具箱补充类 ===== */
html[data-halo-theme="dark"] .stat-value,
html[data-halo-theme="dark"] .stat-card .card-title,
html[data-halo-theme="dark"] .panel-card .card-title {
color: var(--halo-text-primary) !important;
}
html[data-halo-theme="dark"] .bar-track {
background-color: var(--halo-bg-disabled) !important;
}
-48
View File
@@ -1,48 +0,0 @@
/* ============================================================
Halo Dark Mode — 滚动条覆盖
OverlayScrollbars + 原生滚动条
============================================================ */
[data-halo-theme="dark"] {
/* ===== OverlayScrollbars ===== */
.os-scrollbar .os-scrollbar-handle {
background-color: var(--halo-scrollbar-thumb);
}
.os-scrollbar .os-scrollbar-track {
background-color: var(--halo-scrollbar-track);
}
.os-scrollbar .os-scrollbar-handle:hover {
background-color: oklch(45% 0.03 250);
}
/* ===== 原生滚动条(Firefox ===== */
* {
scrollbar-color: var(--halo-scrollbar-thumb) var(--halo-scrollbar-track);
scrollbar-width: thin;
}
/* ===== 原生滚动条(WebkitChrome/Edge/Safari ===== */
::-webkit-scrollbar {
width: 8px;
height: 8px;
}
::-webkit-scrollbar-track {
background: var(--halo-scrollbar-track);
}
::-webkit-scrollbar-thumb {
background: var(--halo-scrollbar-thumb);
border-radius: 4px;
}
::-webkit-scrollbar-thumb:hover {
background: oklch(45% 0.03 250);
}
::-webkit-scrollbar-corner {
background: var(--halo-scrollbar-track);
}
}
-34
View File
@@ -1,34 +0,0 @@
/* ============================================================
Halo Dark Mode — UnoCSS 哈希类兜底
Halo 2.25 中 UnoCSS 同时生成 uno-* / i-* 哈希类,
这些类随构建变化,只能按结构定位兜底,不写死哈希值。
注意:本文件规则刻意不加 !important,便于后续语义规则覆盖。
============================================================ */
/* 文字兜底:只修正文本元素,豁免表单控件 */
html[data-halo-theme="dark"] main [class*="uno-"]:not(input):not(select):not(textarea) {
color: var(--halo-text-primary);
}
/* 块级容器背景兜底:豁免交互元素与表单控件 */
html[data-halo-theme="dark"] main [class*="uno-"]:not(button):not(a):not(input):not(select):not(textarea):not(label) {
background-color: var(--halo-bg-card);
border-color: var(--halo-border-base);
}
/* 页面级容器使用内容区背景 */
html[data-halo-theme="dark"] main > [class*="uno-"] {
background-color: var(--halo-bg-content);
}
/* 卡片头/卡片体内的 uno-* 区块使用 hover 级背景 */
html[data-halo-theme="dark"] .card-header [class*="uno-"],
html[data-halo-theme="dark"] .card-body [class*="uno-"] {
background-color: var(--halo-bg-hover);
border-color: var(--halo-border-light);
}
/* 旧版 i-* 哈希:只做文字兜底,避免给图标类设置背景 */
html[data-halo-theme="dark"] main [class*="i-"]:not(input):not(select):not(textarea) {
color: var(--halo-text-primary);
}
-74
View File
@@ -1,74 +0,0 @@
/* ============================================================
Halo Dark Mode — Tailwind 工具类覆盖
覆盖 Tailwind 的颜色类和常见 UI 原子类
============================================================ */
[data-halo-theme="dark"] {
/* ===== 背景色 ===== */
.bg-white {
background-color: var(--halo-bg-card);
}
.bg-gray-50,
.bg-gray-100 {
background-color: var(--halo-bg-content);
}
.bg-gray-200 {
background-color: var(--halo-bg-hover);
}
/* ===== 文字色 ===== */
.text-gray-900,
.text-gray-800 {
color: var(--halo-text-primary);
}
.text-gray-700,
.text-gray-600,
.text-gray-500 {
color: var(--halo-text-secondary);
}
.text-gray-400,
.text-gray-300 {
color: var(--halo-text-tertiary);
}
/* ===== 边框 ===== */
.border,
.border-gray-200,
.border-gray-300 {
border-color: var(--halo-border-base);
}
.divide-y > :not([hidden]) ~ :not([hidden]),
.divide-x > :not([hidden]) ~ :not([hidden]) {
border-color: var(--halo-border-light);
}
/* ===== 阴影 ===== */
.shadow {
box-shadow: var(--halo-shadow-base);
}
.shadow-sm {
box-shadow: var(--halo-shadow-sm);
}
.shadow-lg,
.shadow-xl {
box-shadow: var(--halo-shadow-lg);
}
/* ===== 链接 ===== */
html[data-halo-theme="dark"] a:not([class*="text-"]) {
color: var(--halo-text-link);
}
/* ===== 通用悬停 ===== */
.hover\:bg-gray-50:hover,
.hover\:bg-gray-100:hover {
background-color: var(--halo-bg-hover);
}
}
+1 -56
View File
@@ -3,6 +3,7 @@
配色策略: OKLCH 颜色空间 | 中性色微蓝着色调 | 亮度层次替代阴影
============================================================ */
/* 说明:data-halo-theme 为兼容性遗留标记,当前已无 CSS 消费方,保留给外部脚本与验证工具。 */
/* ===== 浅色模式(Halo 默认,此处定义为显式回退) ===== */
:root {
--halo-bg-body: oklch(97% 0.005 250);
@@ -58,59 +59,3 @@
--halo-tag-bg: oklch(90% 0.04 160);
--halo-tag-text: oklch(40% 0.1 160);
}
/* ===== 深色模式 ===== */
[data-halo-theme="dark"] {
--halo-bg-body: oklch(14% 0.01 250);
--halo-bg-sidebar: oklch(16% 0.015 250);
--halo-bg-content: oklch(14% 0.01 250);
--halo-bg-card: oklch(18% 0.015 250);
--halo-bg-input: oklch(20% 0.015 250);
--halo-bg-hover: oklch(24% 0.02 250);
--halo-bg-active: oklch(28% 0.03 160);
--halo-bg-disabled: oklch(16% 0.005 250);
--halo-bg-tooltip: oklch(25% 0.01 250);
--halo-bg-modal: oklch(0% 0 0 / 60%);
--halo-bg-dropdown: oklch(20% 0.015 250);
--halo-text-primary: oklch(92% 0.005 250);
--halo-text-secondary: oklch(70% 0.01 250);
--halo-text-tertiary: oklch(50% 0.01 250);
--halo-text-link: oklch(72% 0.14 160);
--halo-text-inverse: oklch(14% 0.01 250);
--halo-border-base: oklch(28% 0.015 250);
--halo-border-light: oklch(22% 0.01 250);
--halo-border-input: oklch(30% 0.015 250);
--halo-border-focus: oklch(65% 0.14 160);
--halo-accent-primary: oklch(60% 0.13 160);
--halo-accent-primary-hover: oklch(66% 0.12 160);
--halo-accent-primary-text: oklch(14% 0.02 160);
--halo-accent-danger: oklch(50% 0.18 25);
--halo-accent-danger-hover: oklch(56% 0.17 25);
--halo-accent-success: oklch(58% 0.16 150);
--halo-accent-warning: oklch(65% 0.16 85);
--halo-shadow-sm: 0 1px 2px oklch(0% 0 0 / 30%);
--halo-shadow-base: 0 2px 8px oklch(0% 0 0 / 40%);
--halo-shadow-lg: 0 4px 16px oklch(0% 0 0 / 50%);
--halo-scrollbar-thumb: oklch(35% 0.02 250);
--halo-scrollbar-track: oklch(18% 0.01 250);
--halo-search-bg: oklch(20% 0.015 250);
--halo-search-text: oklch(70% 0.01 250);
--halo-search-placeholder: oklch(50% 0.01 250);
--halo-menu-item-hover: oklch(22% 0.02 160);
--halo-menu-item-active: oklch(28% 0.04 160);
--halo-menu-group-title: oklch(55% 0.01 250);
--halo-table-header-bg: oklch(18% 0.01 250);
--halo-table-row-hover: oklch(22% 0.015 250);
--halo-table-border: oklch(26% 0.015 250);
--halo-tag-bg: oklch(22% 0.03 160);
--halo-tag-text: oklch(80% 0.08 160);
}
+22 -5
View File
@@ -31,17 +31,24 @@ const modeOptions: { value: ThemeMode; label: string; description: string }[] =
当前生效<strong>{{ currentEffectiveMode }}</strong>
</div>
<div class="dark-mode-settings__options">
<div
<div
class="dark-mode-settings__options"
role="radiogroup"
aria-label="主题模式"
>
<button
v-for="option in modeOptions"
:key="option.value"
type="button"
role="radio"
class="dark-mode-settings__option"
:class="{ 'is-active': theme === option.value }"
:aria-checked="theme === option.value"
@click="setTheme(option.value)"
>
<div class="dark-mode-settings__option-label">{{ option.label }}</div>
<div class="dark-mode-settings__option-desc">{{ option.description }}</div>
</div>
</button>
</div>
</div>
</div>
@@ -95,10 +102,15 @@ const modeOptions: { value: ThemeMode; label: string; description: string }[] =
}
.dark-mode-settings__option {
width: 100%;
padding: 0.75rem 1rem;
border: 1px solid var(--halo-border-base);
background: transparent;
color: inherit;
font: inherit;
text-align: left;
border-radius: 0.375rem;
cursor: pointer;
border: 1px solid var(--halo-border-base);
transition: background-color 0.15s, border-color 0.15s;
}
@@ -106,6 +118,11 @@ const modeOptions: { value: ThemeMode; label: string; description: string }[] =
background-color: var(--halo-bg-hover);
}
.dark-mode-settings__option:focus-visible {
outline: 2px solid var(--halo-accent-primary);
outline-offset: 2px;
}
.dark-mode-settings__option.is-active {
background-color: var(--halo-menu-item-active);
border-color: var(--halo-accent-primary);
@@ -122,4 +139,4 @@ const modeOptions: { value: ThemeMode; label: string; description: string }[] =
font-size: 0.8125rem;
color: var(--halo-text-tertiary);
}
</style>
</style>
-46
View File
@@ -1,46 +0,0 @@
# 启动带持久化配置的 Edge 窗口,等待用户登录 Halo 后台。
# 登录成功后脚本自动退出,会话会保留在 pw-profile 目录里供后续扫描使用。
import pathlib
import sys
import time
from playwright.sync_api import sync_playwright
PROFILE = pathlib.Path(__file__).parent / "pw-profile"
LOGIN_URL = "https://blog.liuhangyv.top/console/login"
TIMEOUT_S = 280
def main() -> int:
with sync_playwright() as p:
ctx = p.chromium.launch_persistent_context(
str(PROFILE),
channel="msedge",
headless=False,
viewport={"width": 1600, "height": 950},
)
page = ctx.pages[0] if ctx.pages else ctx.new_page()
page.goto(LOGIN_URL)
print("浏览器窗口已打开,请在其中登录 Halo 后台...", flush=True)
deadline = time.time() + TIMEOUT_S
while time.time() < deadline:
try:
url = page.url
except Exception:
print("检测到窗口被关闭", flush=True)
return 2
if "/console" in url and "/login" not in url:
time.sleep(3) # 等待会话 cookie 写入磁盘
print(f"检测到登录成功: {url}", flush=True)
ctx.close()
return 0
time.sleep(2)
print("等待超时,未检测到登录", flush=True)
ctx.close()
return 1
if __name__ == "__main__":
sys.exit(main())
-214
View File
@@ -1,214 +0,0 @@
# Halo 后台暗色模式残留扫描器
# 自动发现侧边栏全部 /console 路由,逐页扫描浅色背景 / 深色文字残留并截图。
import json
import pathlib
import re
import sys
import time
from playwright.sync_api import sync_playwright
BASE = "https://blog.liuhangyv.top"
ROOT = pathlib.Path(__file__).parent
PROFILE = ROOT / "pw-profile"
SHOTS = ROOT / "shots"
OUT = ROOT / "scan-results.json"
# 在每个页面加载前强制插件进入深色模式
INIT_JS = """
try { localStorage.setItem('halo-dark-mode-theme', 'dark'); } catch(e) {}
document.documentElement.setAttribute('data-halo-theme', 'dark');
"""
# 页面内扫描:浅色背景(RGB 均 >235 且不透明)、深色文字(RGB 均 <70)
SCAN_JS = r"""
() => {
const results = [];
const seen = new Set();
const isVisible = (el) => {
const cs = getComputedStyle(el);
return cs.display !== 'none' && cs.visibility !== 'hidden' && +cs.opacity > 0.05;
};
const shortPath = (el) => {
const parts = [];
let cur = el;
for (let i = 0; i < 5 && cur && cur !== document.body; i++) {
let p = cur.tagName.toLowerCase();
if (cur.id) p += '#' + cur.id;
else if (typeof cur.className === 'string' && cur.className.trim()) {
p += '.' + cur.className.trim().split(/\s+/).slice(0, 2).join('.');
}
parts.unshift(p);
cur = cur.parentElement;
}
return parts.join(' > ');
};
document.querySelectorAll('body *').forEach(el => {
if (!isVisible(el)) return;
const r = el.getBoundingClientRect();
if (r.width < 50 || r.height < 20) return;
const cs = getComputedStyle(el);
const issues = [];
const bg = cs.backgroundColor.match(/rgba?\(([\d.]+),\s*([\d.]+),\s*([\d.]+)(?:,\s*([\d.]+))?\)/);
if (bg && bg[4] !== '0' && +bg[1] > 235 && +bg[2] > 235 && +bg[3] > 235) {
issues.push('light-bg ' + cs.backgroundColor);
}
const hasText = [...el.childNodes].some(n => n.nodeType === 3 && n.textContent.trim());
const c = cs.color.match(/rgba?\(([\d.]+),\s*([\d.]+),\s*([\d.]+)/);
if (hasText && c && +c[1] < 70 && +c[2] < 70 && +c[3] < 70) {
issues.push('dark-text ' + cs.color);
}
if (!issues.length) return;
const cls = (typeof el.className === 'string' ? el.className : '').trim().replace(/\s+/g, ' ').slice(0, 150);
const key = el.tagName + '|' + cls + '|' + issues.join(',');
if (seen.has(key)) return;
seen.add(key);
results.push({
tag: el.tagName.toLowerCase(),
cls,
path: shortPath(el),
issues,
size: Math.round(r.width) + 'x' + Math.round(r.height),
text: (el.textContent || '').trim().slice(0, 40),
});
});
return results;
}
"""
def slug(route: str) -> str:
return re.sub(r"[^a-z0-9]+", "-", route.lower()).strip("-") or "root"
def main() -> int:
SHOTS.mkdir(exist_ok=True)
with sync_playwright() as p:
ctx = p.chromium.launch_persistent_context(
str(PROFILE),
channel="msedge",
headless=True,
viewport={"width": 1600, "height": 950},
)
ctx.add_init_script(INIT_JS)
page = ctx.pages[0] if ctx.pages else ctx.new_page()
page.goto(BASE + "/console/dashboard", wait_until="domcontentloaded")
try:
page.wait_for_load_state("networkidle", timeout=10000)
except Exception:
pass
time.sleep(3)
if "/login" in page.url:
print("SESSION_EXPIRED 登录态失效,需要重新登录", flush=True)
ctx.close()
return 3
dark = page.evaluate("document.documentElement.getAttribute('data-halo-theme')")
print(f"data-halo-theme = {dark}", flush=True)
# 普查样式表:确认服务端实际部署的插件 CSS 覆盖了哪些内容
census = page.evaluate(
"""() => {
const out = [];
for (const sheet of document.styleSheets) {
let rules;
try { rules = sheet.cssRules; } catch (e) { continue; }
let darkRules = 0;
let samples = [];
for (const r of rules) {
const t = r.cssText || '';
if (t.includes('data-halo-theme')) {
darkRules++;
if (samples.length < 3) samples.push(t.slice(0, 100));
}
}
if (darkRules > 0) {
out.push({ href: sheet.href || '(inline)', total: rules.length, darkRules, samples });
}
}
return out;
}"""
)
print("=== 包含暗色规则的样式表 ===", flush=True)
for c in census:
print(f" {c['href']} dark规则数={c['darkRules']}", flush=True)
# 关键字探针:确认部署的 CSS 是否包含关键覆盖(判断部署版本新旧)
keywords = page.evaluate(
"""() => {
const kws = ['description-item', 'bytemd', 'week-picker', 'menu-item-title',
'alert-wrapper', 'entity-field-title', 'sidebar__profile', 'card-wrapper'];
const found = {};
for (const kw of kws) found[kw] = false;
for (const sheet of document.styleSheets) {
let rules;
try { rules = sheet.cssRules; } catch (e) { continue; }
for (const r of rules) {
const t = r.cssText || '';
if (!t.includes('data-halo-theme')) continue;
for (const kw of kws) if (t.includes(kw)) found[kw] = true;
}
}
return found;
}"""
)
print(f"=== 部署 CSS 关键字探针 === {keywords}", flush=True)
# 从 Vue Router 读取全部已注册路由(含插件注册的菜单页)
try:
routes = page.evaluate(
"""() => {
const app = document.querySelector('#app').__vue_app__;
const router = app.config.globalProperties.$router;
return router.getRoutes().map(r => r.path);
}"""
)
except Exception as e:
print(f"Router 读取失败,回退到锚点抓取: {e}", flush=True)
routes = page.evaluate(
"""() => [...new Set([...document.querySelectorAll('a[href]')]
.map(a => a.getAttribute('href'))
.filter(h => h && h.startsWith('/console')))]"""
)
# Halo Console 的 router base 是 /console/getRoutes() 返回的路径不带 base
routes = sorted(
{
r if r.startswith("/console") else "/console" + r
for r in routes
if r.startswith("/") and ":" not in r and r not in ("/", "/console")
}
)
# 编辑器路由只保留一个样本,避免重复扫描
editor = [r for r in routes if "editor" in r]
routes = [r for r in routes if "editor" not in r] + editor[:1]
print(f"发现 {len(routes)} 个后台路由: {routes}", flush=True)
all_results = {}
all_results["__stylesheet_census__"] = census
for route in routes:
try:
page.goto(BASE + route, wait_until="domcontentloaded")
try:
page.wait_for_load_state("networkidle", timeout=6000)
except Exception:
pass
time.sleep(1.5)
# 兜底:再设一次暗色属性,防止插件脚本时序问题
page.evaluate("document.documentElement.setAttribute('data-halo-theme','dark')")
time.sleep(0.3)
items = page.evaluate(SCAN_JS)
all_results[route] = items
page.screenshot(path=str(SHOTS / (slug(route) + ".png")))
print(f"{route}: {len(items)} 处疑似残留", flush=True)
except Exception as e: # noqa: BLE001
all_results[route] = {"error": str(e)[:200]}
print(f"{route}: 扫描失败 {e}", flush=True)
OUT.write_text(json.dumps(all_results, ensure_ascii=False, indent=2), encoding="utf-8")
ctx.close()
print(f"DONE -> {OUT}", flush=True)
return 0
if __name__ == "__main__":
sys.exit(main())