chore: 整理 third-party Dark Reader 目录并移除本地说明文件跟踪

2026-08-08 17:38:08 +08:00
parent 202ab537d1
commit 0bb552b026
1004 changed files with 115066 additions and 20081 deletions
@@ -7,14 +7,15 @@ Halo 2.25 暗色模式插件 — 为 Halo 后台管理面板提供深色/浅色
 - ☀️/🌙 **三种模式**：浅色、深色、跟随系统
 - 💾 **偏好持久化**：自动记忆用户选择（localStorage），刷新不丢失
 - 🖥️ **系统偏好跟随**：切换系统外观时自动响应
- ⚡ **瞬间切换**：CSS 变量瞬时生效，无可见闪烁
+- 🔍 **Dark Reader 引擎**：内置成熟的开源暗色转换引擎，自动分析页面 CSS 与 DOM，第三方插件页面的黑字/白底也能自动转换
 - 🧩 **侧边栏注入**：切换按钮自动出现在侧边栏底部（UserProfileBanner 上方）
 - ⚙️ **设置页面**：提供详细的模式选择界面（菜单 → 偏好设置 → 深色模式）
- 🔍 **Dark Reader 引擎**：内置成熟的开源暗色转换引擎，自动分析页面 CSS 与 DOM，
-  第三方插件页面的黑字/白底也能自动转换，不再依赖逐页手工覆盖
- 🎨 **OKLCH 色彩空间**：感知均匀，暗色模式天然适配，WCAG AA 对比度保证
 - 📦 **零后端依赖**：纯前端实现，不需要后端 API
- ✅ **覆盖已验证**：仪表盘、内容管理（文章/页面/评论）、链接、订阅、瞬间、用户、主题、设置、编辑器、模态框等页面已针对 Halo 2.25 真实 DOM 逐一验证
+
+## 第三方依赖
+
+- [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` 通过本地文件依赖引用。

 ## 开发环境

@@ -68,7 +69,11 @@ pnpm test:unit     # 单元测试
 │       └── resources/
 │           └── plugin.yaml            # 插件清单
 │
+├── third-party/
+│   └── darkreader/           # Dark Reader 4.9.129（MIT）
+│
 └── ui/
+    ├── package.json          # 通过 file:../third-party/darkreader 引用 Dark Reader
    └── src/
        ├── index.ts                   # definePlugin 入口
        ├── darkreader-engine.ts       # Dark Reader 通用暗色引擎
@@ -82,17 +87,9 @@ 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 变量
 ```

 ## 许可证

-[GPL-3.0](./LICENSE) © LHY
+[GPL-3.0](./LICENSE) © LHY