deepseek-harness-angelina-themes

DeepSeek Harness Angelina Themes

把 Codex 的安洁莉娜亮色、暗色主题移植到 DeepSeek Harness 的独立 dsh-plugin。它保留 Harness 原生的对话布局和控件行为，只把视觉层替换成安洁莉娜主题：背景图、视差、磨砂玻璃、清晰的文字层级，以及在低性能或移动环境下的优雅降级。

English: README.en.md

先看效果

亮色主题使用清晨屋顶和暖灰色玻璃；暗色主题使用夜景和低亮度冷色玻璃。两种主题都给输入区、菜单、对话框和消息气泡保留足够的背景分离度，文字不会直接压在人物或高对比背景上。

Angelina Light 明亮、偏暖、适合日间长时间工作	Angelina Dark 低亮度、偏冷、适合夜间使用

视差分层

背景和人物不是一张被整体移动的图片，而是两张透明/不透明图层。指针移动时，远景只做很小幅度位移，人物和信件做更明显的位移；标题、选择器、输入框和正文保持原位，避免阅读时跟着晃动。

Background layer 城市、天空、屋顶与月光位置	Foreground layer 安洁莉娜、信件和前景碎片

细节一览

操作菜单 半透明底色、细边框和柔和阴影	排序菜单 分组标题、选中状态和内容对比度

磨砂玻璃配方

主题把玻璃定义为可复用的 CSS 变量，菜单和设置卡片使用同一套配方，避免出现“顶栏很糊、卡片很硬”或不同浮层透明度不一致的问题。

background: rgba(43, 51, 58, 0.66);
backdrop-filter: blur(18px) saturate(104%);

实际应用范围遵循叶节点策略：只给可见的菜单、卡片、输入框和气泡加玻璃，不给 sidebar/frame 祖先加滤镜，因此不会破坏固定定位浮层、滚动容器或对话层级。活跃对话区域使用浅层 3px 背景模糊，内部文字和控件保持锐利。

视差参数

每组两个数依次是 X/Y 位移系数；指针坐标会先按视口归一化到 -1..1，数值越大，图层位移越明显。视差容器使用 pointer-events: none，不会挡住任何 Harness 控件。

安装

GitHub 安装（推荐）

需要 DeepSeek Harness Web profile 和 Node.js 20+。仓库已经提交 lib/ 构建产物，用户安装时不需要在本机编译插件。

dsh plugin --profile web add github:bilbillm/deepseek-harness-angelina-themes

重启 Web profile：

dsh web
# 或者
npx @deepseek-ai/dsh web

打开 设置 → 通用设置，在 安洁莉娜主题 中选择亮色或暗色。主题选择保存在浏览器本地，刷新或重启后仍会保留。

卸载：

dsh plugin --profile web remove dsh-angelina-themes

本地 checkout 安装

适合想马上测试本地改动的情况。 dsh plugin 会把相对路径锚定到当前命令目录：

cd C:\Users\lumoren\Documents\GitHub\deepseek-harness-angelina-themes
pnpm install
pnpm build
dsh plugin --profile web add .

修改 src/ 后重新运行 pnpm build，然后重启 DSH Web profile。当前仓库的 lib/ 已可直接安装，普通用户不需要执行构建步骤。

与 Harness 的兼容策略

• 上游 Harness 0.1.0-rc.6 只投影活动主题的配色模式和 token，不投影第三方 CSS 选择器需要的主题 id；插件会同步 body[data-ds-theme]，卸载时恢复原值。
• feature/angelina-themes fork 已经内置主题时，插件先读取 ctx.theme.getTheme().themes，复用已有 id，只注册缺失项，避免重复 id。
• fork 如果已经创建 #dsh-angelina-parallax 和 body[data-dsh-angelina-parallax]，插件不会再创建第二套视差层或指针监听。
• 插件可以和 dsh-motion、dsh-conversation-minimap 一起安装；主题只负责视觉层，不接管动画插件或会话数据。

构建、测试与审计

pnpm install
pnpm generate-assets
pnpm typecheck
pnpm build
pnpm test
pnpm smoke

一次性执行完整检查：

pnpm verify

src/themes.json 是唯一的 token 源文件；src/assets/ 保存可审计的 WebP 素材；生成器把素材嵌入客户端 data URI，因此运行时不依赖第三方图片域名。构建输出为 lib/index.js、lib/client.js 及对应类型声明。

常见问题

安装后看不到主题选项？ 先确认 profile 是 web，再重启 DSH；如果仍未出现，运行 dsh plugin --profile web why dsh-angelina-themes 检查依赖是否安装到当前 profile。

为什么移动端没有视差？ 触摸输入、视口宽度不超过 900px、系统开启减少动态效果、页面失焦或隐藏时都会停用/复位视差。这是为了保持可读性、续航和触控稳定性。

为什么选择内置浅色/深色后安洁莉娜主题消失？ 这是预期行为。切回 Harness 内置主题会把插件选择标记恢复为 system，不会覆盖宿主的主题设置；之后可以再次选择安洁莉娜亮色或暗色。

许可证与素材

代码和元数据按 MIT 发布。安洁莉娜、《明日方舟》及相关原作、美术和商标权利归各自权利人所有。本项目为非官方同人定制，不代表 DeepSeek、OpenAI、鹰角网络、悠星或《明日方舟》。

素材来源与第三方声明见：ASSET-PROVENANCE.md · THIRD-PARTY-NOTICES.md