endfield-ui-plugin/endfield-ui-plugin

一句话定位

把游戏《终末地》的工业风视觉系统封装为 DeepSeek Harness（DSH）的标准主题插件，安装后 dsh web 自动加载终末地外观，不修改 DSH 核心源码，也不影响用户数据。

核心能力

• 把工作台主色换成柠檬黄 + 工业灰黑，并重画侧栏、对话区、标题栏与底部状态栏的工业风皮肤
• 提供一段约 3.5 秒的开屏动画（含网格底纹、旋转圆环、品牌字样），结束后自然过渡到主界面
• 把右下角的"协议已同步"占位换成圆形上下文进度环，自动读取 DSH 原生的上下文占用百分比，无数据时切换为呼吸式演示
• 自带工业网格对话区背景与白色等高线侧栏纹理，缓解纯黑与纯白之间的视觉割裂
• 在不修改 DSH 源码的前提下注入主题：Host 端通过 /endfield-ui/* 提供 23 个本地素材，Client 端通过官方 Theme Token 与 shell.overlay 插槽覆盖外观
• 卸载即恢复 DSH 原生前端，用户的对话、配置等数据保留在 ~/.dsh 不受影响

技术实现

• 语言: JavaScript（ESM）
• 关键依赖: 仅依赖宿主提供的 react、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-theme、@deepseek-ai/dsh-client-ui-layout；插件本身不引入第三方 npm 包
• 架构模式: 标准 dsh 双端 Cordis 插件 —— Host 端声明 inject: ['webServer'] 注册静态资源路由，Client 端声明 inject: ['slots', 'theme'] 注入主题 token 与 shell.overlay 插槽；包内 dsh.bundle + cordis.patch.yml 让插件随 web profile 自动装载
• 入口文件: endfield-ui-plugin/index.js（Host 端，58 行）+ endfield-ui-plugin/client.js（Client 端，231 行）+ endfield-ui-plugin/theme.css（30 KB 样式）+ endfield-ui-plugin/cordis.patch.yml（patch 声明）

适用场景

喜欢《终末地》视觉风格、又希望保留 DSH 原生功能与数据完整性的用户。安装一条命令即可把 dsh web 的工作台换成工业风皮肤，适合想要个性化界面、且不愿手动改配置或接触 DSH 内部模块的普通用户。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:rison114514/dsh-endfield-ui/endfield-ui-plugin

配置项

本插件无需额外配置。安装后 dsh web 即可自动加载主题，没有开关、参数或环境变量需要手动调整；如需还原默认外观，执行 dsh plugin --profile web remove @rison/dsh-endfield-ui 即可。

常见问题

Q: 安装后会自动生效吗？

A: 会。插件声明了标准 dsh.bundle，启动 dsh web 时自动加载终末地风格，无需手动复制 CSS、修改 ~/.dsh 或追加 --patch 参数。

Q: 卸载后用户数据会丢失吗？

A: 不会。视觉层只注入样式与覆盖主题 token，不触碰 ~/.dsh 下的对话与配置数据；卸载后 DSH 原生前端完整恢复。

Q: 是否修改 DSH 核心源码？

A: 不修改。Host 端只注册 /endfield-ui/* 静态资源路由，Client 端通过官方 Theme Token 与 shell.overlay 插槽注入，无需 patch 宿主或复制文件。

Q: DSH 大版本升级后主题异常怎么办？

A: 主题通过 DSH DOM/CSS Module 特征选择器覆盖，大版本升级可能需要同步维护。建议先卸载插件确认原生页面正常，再向作者反馈。

Q: 桌面 App 是否可以公开分发？

A: 不建议。同仓 desktop-app/ 仅完成 ad-hoc 签名，公开分发需要 Developer ID 签名与公证，否则会被系统拦截；当前构建仅供本机自用。

Q: 第三方字体与游戏素材是否合规？

A: 第三方字体（Harmony、Novecento、Space Grotesk）保留各自许可证文件；图片素材含参考游戏视觉生成内容，公开发布前需逐项确认授权并替换不可再分发的素材。

上手难度

入门 —— 一条 add 命令加一次重启 dsh web 即生效，没有配置项和环境变量，普通用户无需阅读源码。

已知问题与限制

• workbench-logo.png 当前未被主题代码引用，但仍随包分发（按用户要求保留），冗余约 200 KB
• DSH 大版本升级时主题里依赖的若干 DOM/CSS Module 特征选择器可能失效，需要作者跟进适配
• 同仓提供的 desktop-app/ 仅在 macOS arm64 上完成构建与 ad-hoc 签名，Intel 版 (pack:mac:x64) 仅做构建练习，未做实测
• 部分图片素材疑似参考游戏《终末地》官方视觉生成，公开发布前需逐项确认授权，必要时替换为原创或可再分发素材
• 插件未在 package.json 中声明宽泛的 DSH 版本兼容范围，跨大版本使用时需自行验证

非官方同人主题：与游戏开发商及 DeepSeek 官方均无关联，不暗示合作或授权。

这个项目把终末地工业风视觉系统封装为 DeepSeek Harness 的独立 Cordis 插件，并提供可选的 Electron 桌面壳。当前插件版本 0.5.0 已声明标准 dsh.bundle，可用一条命令安装并自动生效。

结构

• endfield-ui-plugin/：双端 dsh 插件。核心交付物。Host 端提供素材，Client 端加载视觉外壳。
• desktop-app/：Electron 桌面入口（可选）。自动启动本地 dsh、装载插件并打开窗口。
• cover/：封面图素材。
• dsh-packaged-final.jpg / dsh-settings-final.jpg：界面预览。

方式一：只装插件（推荐 Web 用户）

dsh plugin --profile web add @rison/dsh-endfield-ui   # 或本地 tarball / GitHub tag
dsh web

安装后普通 dsh web 自动加载终末地风格，无需手动复制 CSS、改 ~/.dsh 或追加 --patch。 升级 / 卸载：dsh plugin --profile web update|remove @rison/dsh-endfield-ui。 详见 endfield-ui-plugin/README.md。

方式二：桌面 App（喜欢原生窗口的用户）

cd desktop-app
npm install
npm run pack:mac        # 构建 darwin-arm64 .app
npm run dist:mac:local  # 语法检查 + npm pack 校验 + 打包 + ad-hoc 签名 + 校验

桌面壳已改为消费标准插件：自动发现 dsh（DSH_BIN→用户选择→常见目录→PATH），未发现时显示终末地风格引导页（可选 dsh 可执行文件 / 源码目录），以标准 bundle 启动（不再传 --patch），含单实例锁、30s 启动超时与「复制诊断信息」、退出/崩溃可靠回收子进程。

打包产物：desktop-app/release/DSH 终末地工作台-darwin-arm64/DSH 终末地工作台.app（ad-hoc 签名，仅本机自用）。

开发状态

• 阶段 1（标准插件）：dsh.bundle.patch 已声明，0.5.0 发布准备完成，冒烟测试 8/8 通过。✅
• 阶段 2（桌面壳消费标准插件）：移除 --patch、dsh 自动发现、首次引导页、单实例锁、启动超时/诊断、dist 脚本，dist:mac:local 5/5 通过。✅
• 发布说明见 RELEASE.md；素材许可证与已知问题见该文件。
• 详见 HANDOFF.md。