前言¶

DeepSeek Harness（DSH）的 Web 界面默认走系统主题令牌。想换一套固定视觉、又不想改应用源码时，常见做法是手动改 CSS 或 fork 前端——维护成本高，升级也容易断。

dsh-theme-endfield 走另一条路：作为纯 Client 半部插件，只覆盖主题令牌并注入一张样式表，不动 Host 侧代码。下面介绍它是什么、能做什么，以及如何安装与调整。

这是什么¶

dsh-theme-endfield（维护者 ymh0000123）是 DSH 的 Web 主题插件，参考《明日方舟：终末地》官网视觉风格，在 SkillHub 分类为「趣味换装」。核心视觉是奶油纸底、墨黑文字、信号黄强调、全直角工业编辑风。

插件在 GitHub 开源（MIT 许可证，当前 package.json 版本 1.0.0），不修改 DSH 应用代码，仅通过 Client 运行时覆盖主题令牌并注入样式。

视觉参考来源为终末地官网：国内版 https://endfield.hypergryph.com，国际版 https://endfield.gryphline.com。

设计语言¶

README 将设计语言概括为下表，完整色板、令牌映射与对比度规则见仓库 docs/design-language.md。

核心功能¶

主题覆盖¶

安装后，插件通过 DSH Client 的 theme 服务与 styles 内建能力，把界面切换到终末地风格。Host 半部（index.js）为空实现，全部逻辑在 client.js：令牌覆盖、样式表、设置页与各功能图层。

十个可配置开关¶

设置入口为 设置 › 终末地主题设置。共四组、十个开关，由 localStorage 持久化，文案跟随 DSH 语言设置（中/英）。各开关行为细节见 docs/features.md。

部分开关有依赖关系：例如动态等高线需先开等高线背景，大字入场动画需先开雷霆大字。

安装与启用¶

在 web profile 下执行官方安装命令：

dsh plugin --profile web add github:ymh0000123/dsh-theme-endfield

重启或重新加载 web profile 后生效。安装完成后，到 设置 › 终末地主题设置 按需调整开关。

卸载：

dsh plugin --profile web rm dsh-theme-endfield

典型用法¶

日常：安装后调设置¶

1. 执行上述 add 命令并重新加载 web profile。
2. 打开 设置 › 终末地主题设置。
3. 按需切换总开关、配色（谷地黄 / 武陵青）、圆角，以及背景、动画、娱乐相关选项。

临时试用（不安装）¶

README 提供了通过 Cordis 动态插件试用的方式，适合先体验再决定是否长期安装：

1. 复制 client.js 里 apply(ctx) { ... } 的函数体；
2. 用 cordis_define 新建插件，粘贴为 Client 代码（return { apply(ctx) { ... } }），再用 cordis_run 激活；
3. 刷新页面生效；在 Run 卡片上停止插件即完全卸载（令牌层与样式层自动拆除）。

注意：client.js 依赖 DSH Client 运行时的 theme 服务与 styles 内建，不能在普通浏览器里直接运行。

适用场景与注意¶

适合谁

• 长期在 DSH Web 界面工作、希望界面有统一终末地工业编辑风的用户。
• 只想换肤、不想改 DSH 源码或 fork 前端的开发者。

使用前注意

• 插件以当前 dsh 进程权限运行。安装前建议阅读 GitHub 仓库 源码，确认 client.js 行为符合预期，并核对 MIT 许可证。
• SkillHub（https://www.skillhub.cn）是独立的 DSH 插件社区目录，与 DeepSeek / 幻方无官方从属关系；目录页用于发现插件，安装仍以 README 中的 dsh plugin 命令为准。
• 部分背景与动画功能（如等高线、启动加载动画）会增加渲染开销；若机器较慢，可先关闭 02、03 组中的装饰项，只保留主题令牌与配色。

开发与校验¶

维护者提供了静态校验与测试脚本，主题样式表以 JavaScript 模板字符串形式维护，部分改动可能在「文件仍能解析」的情况下静默失效，因此用脚本固化不变量：

node check.js     # 样式表不变量（模板字符串、注释配平、变量定义、:root 陷阱）
node selftest.js  # 反向验证 check.js 真能抓到那些问题
npm test          # 全部校验：配色 / 设置页 / 渲染 / 覆盖率 / 性能

部分测试需在真实浏览器中量像素，本机需安装 Chrome；check.js、selftest.js 及若干设置页、配色相关测试可在纯进程内运行。详见 docs/testing.md。

结尾¶

dsh-theme-endfield 把 DSH Web 界面换成终末地官网的奶油纸底、墨黑文字与信号黄强调，通过十个本地持久化开关控制配色、背景与娱乐效果，安装与卸载各一条 dsh plugin 命令。

• 目录页：https://www.skillhub.cn/plugins/ymh0000123/dsh-theme-endfield
• GitHub：https://github.com/ymh0000123/dsh-theme-endfield