终末地终端主题INnoVationEE/dsh-endfield-theme

面向 DeepSeek Harness 的 Field Terminal

一个非官方的、即插即用的视觉主题，适用于 DeepSeek Harness (dsh) Web UI。Field Terminal 为本地界面赋予了一种柠檬黄工业指挥甲板美学，灵感来自《明日方舟：终末地》，且不会修改生成的 React 打包文件。

Field Terminal 主题预览

[!IMPORTANT]
DeepSeek Harness 目前处于开发者预览阶段，可能会发布破坏性的 Web UI 变更。此主题会修补通过 npm 安装的前端打包文件，因此在升级 @deepseek-ai/dsh 后，你可能需要重新安装它。

亮点

| 区域 | 设计处理 |
| --- | --- |
| 颜色 | 柠檬黄 #FFF44F 取代了原本的蓝色强调色。 |
| 几何 | 直角、硬朗的黑色边缘、被裁切的消息和按钮边角，以及工业风的灰度表面。 |
| 深度 | 偏移的按钮阴影，以及对话框和浮动面板的层叠黑黄阴影。 |
| 导航 | 黄色侧边栏导轨、品牌条、带纹理的面板，以及五色状态栏。 |
| 内容 | 黄色 Markdown 强调、终端风格标签、自定义选中颜色，以及条纹滚动条。 |
| 氛围 | 42 px 网格、左上角环境光晕，以及深色模式下的等高线纹理。 |
| 字体排印 | 内置 HarmonyOS Sans SC、Space Grotesk、Novecento Wide、Gilroy 和 Roboto 字体。 |
| 主题 | 深色“终端舱”处理和较浅的“纸质工作台”处理。 |

与 DeepSeek Harness 的关系

本仓库是官方 DeepSeek Harness 的社区主题，后者是由 DeepSeek AI 开发的开源智能体框架。它面向通过以下命令启动的 Web UI：

npx @deepseek-ai/dsh web

Web UI 默认在 http://127.0.0.1:3080 提供服务。有关设置和使用方法，请参阅官方 DeepSeek Harness Web UI 指南。

Field Terminal 不由 DeepSeek AI 维护，也不与其关联。它是一个直接的主题覆盖层，而非官方 dsh 插件。

安装

先决条件

- Node.js 以及可正常工作的 DeepSeek Harness Web UI 安装。
- 在 macOS、Linux、WSL 或兼容 shell 上的 Bash。

应用主题

git clone https://github.com/INnoVationEE/dsh-endfield-theme.git
cd dsh-endfield-theme
./install.sh

保持 Web UI 运行，然后在浏览器中执行强制刷新（macOS 上为 Cmd+Shift+R，Windows/Linux 上为 Ctrl+Shift+R）。通常无需重启服务器。

安装程序是幂等的：它会创建首次运行备份，将主题资源复制到检测到的 dsh-web-frontend/dist 目录中，并将样式表和辅助脚本注入到 index.html 中。

更新后重新应用

DeepSeek Harness 升级可能会替换其生成的前端文件。升级后请再次运行安装程序：

./install.sh

移除主题

./revert.sh
还原后请强制刷新 Web UI。

工作原理

- endfield.css 覆盖 Web UI 的 --dsw- 静态和语义设计令牌，同时适用于浅色和深色模式。
- 额外的结构性 CSS 添加了方形几何、切角、工业风阴影、网格和纹理层、侧边栏处理以及 Markdown 强调样式。
- theme-assets.js 将侧边栏字标替换为捆绑的 Field Terminal 图稿，并在 React 重新挂载品牌区域后恢复它。
- usage-monitor.js 在侧边栏设置控件上方添加一个自包含的 DeepSeek 余额和使用量小组件。
- install.sh 仅向 index.html 添加样式表和脚本标签；它不会重写应用程序的组件包。

使用量监控

侧边栏小组件中的可选字段支持两种数据源：

- API 余额： 每 60 秒调用一次官方 GET https://api.deepseek.com/user/balance 端点。API 密钥存储在此 Web UI 源的浏览器 localStorage 中，并且该小组件仅将其发送到 api.deepseek.com。
- 平台令牌使用量： 使用可选的平台 userToken 调用未公开的 platform.deepseek.com/api/v0/usage/amount 端点。由于 CORS、WAF 规则、身份验证变更或端点变更，此尽力而为的集成可能会失败；余额报告会独立继续。

安全说明：

- 切勿将 API 密钥或平台令牌提交到此仓库。
- 浏览器 localStorage 可被在同一源上运行的脚本读取。仅在受信任的本地 Web UI 会话中配置该小组件。
- 要清除已存储的凭据，请打开小组件设置，清空两个凭据字段，然后保存。
- 当请求不可用时，使用量监控会优雅地失败；它不会阻塞主题的其余部分。

仓库布局

| 路径 | 用途 |
| --- | --- |
| endfield.css | 主设计令牌和结构性样式覆盖。 |
| usage-monitor.js | 自包含的 API 余额和令牌使用量小组件。 |
| theme-assets.js | 侧边栏 logo 注入和重新挂载处理。 |
| assets/ | Logo、面板纹理、按钮纹理和装饰图稿。 |
| fonts/ | 捆绑的界面和显示字体。 |
| endfield-texture.png | 等高线背景纹理。 |
| favicon.svg | 柠檬黄色的 Field Terminal 网站图标。 |
| docs/field-terminal-preview.png | 隐私安全的仓库预览图。 |
| install.sh | 幂等主题安装程序。 |
| revert.sh | 恢复保存的前端文件并移除注入的资源。 |

故障排除

找不到 dsh-web-frontend/dist

至少使用 npx @deepseek-ai/dsh web 启动一次官方 Web UI，然后重新运行 ./install.sh。安装程序会在本地 npm npx 缓存中搜索前端发行版。

如果你的前端发行版存储在其他位置，请显式设置其路径：

DSH_DIST=/absolute/path/to/dsh-web-frontend/dist ./install.sh

旧主题仍然可见
执行强制刷新。如果你编辑了 endfield.css，请重新运行 ./install.sh，以便将更新后的文件复制到前端发行版中。

DeepSeek Harness 更新后布局出现异常

运行 ./revert.sh，确认原版 Web UI 正常工作，然后再次运行 ./install.sh。如果上游标记或设计令牌发生了变化，请提交一个 issue，并附上已安装的 @deepseek-ai/dsh 版本和一张截图。

致谢与免责声明

- 为官方 DeepSeek Harness Web UI 构建。
- 视觉方向改编自 grad-research-workbench。
- assets/ 中的主题美术资源以及 endfield-texture.png 是在生成式图像辅助下创作的。
- 视觉处理灵感来自 Arknights: Endfield*。这是一个非官方的粉丝自制项目，与 DeepSeek AI、Hypergryph、GRYPHLINE 或其关联公司无隶属关系，亦未获得其认可或赞助。所有产品名称和商标均归其各自所有者所有。