前言¶
DeepSeek Harness(DSH)把界面、主题和扩展都做成可插拔插件。默认皮肤偏工具向,长时间盯会话、遥测和模型控件时,视觉层次往往比较平。若你希望在不改业务逻辑的前提下,给桌面端或 Web 端套一层统一的深色 tech-gothic 风格,并顺带修一批与主题 token 相关的可读性问题,社区里有人做了专门的外观插件。dsh-theme-admech(机械神教 · 铸炉圣殿)就是这一类「趣味换装」向的纯外观套件:非官方粉丝向皮肤,自带原创 SVG 与齿轮-骷髅徽记,当前版本 v0.9.3,维护者为 RichardDou0607。
下面介绍它是什么、能改哪些界面细节,以及如何安装与使用可选的 macOS 应用图标替换流程。
这是什么¶
dsh-theme-admech 是面向 DSH 的 Forge-Cathedral tech-gothic 主题插件:通过宿主侧的 cordis.patch.yml 与客户端注入(@deepseek-ai/dsh-client-ui-theme)改写 Web UI 的样式、图标与部分启动体验。README 明确其为 Unofficial fan-made skin,背景与装饰为原创矢量素材,齿轮-骷髅 emblem 由素材提供方给出,主题只改颜色与等比缩放、不重绘该徽记。
与「只换几组 CSS 变量」的轻量换肤不同,这个插件覆盖了启动前奏、输入区神殿 crest、过程明细行图标、底部遥测条、模型菜单里的推理等级滑块,以及若干状态按钮与标签的配色修复;macOS 上还可选把 DSH 应用包图标换成主题版(需系统「App 管理」授权)。
许可为混合许可(非单一 OSI 许可):代码部分 MIT;原创主题素材为 CC BY-NC-SA 4.0;齿轮-骷髅徽记权利见仓库 ASSETS-LICENSE.md。安装前请阅读 README 中的「许可 / IP」与 DISCLAIMER.md。
核心功能¶
以下能力均来自仓库 README 与 package.json(v0.9.3),按版本脉络归纳,便于对照 changelog。
视觉与布局¶
- 铸炉圣殿背景:中央为直线段构成的尖拱 portal(faceted pointed arch),替代早期纯弧线;输入框去掉大弧线顶饰,改为尖顶双塔、尖拱窗与齿轮-骷髅 crest,装饰压在上边框、不侵入正文区(v0.4 及后续迭代)。
- 图标体系:
src/icons.json定义 32 枚 UI 图标;v0.9.1 起为展开后的「运行命令」等过程明细行补充data-variant→ 主题 glyph 映射,避免退回原生>_终端图标。 - 深色仪器面板:会话统计、Token 用量、上下文等弹层统一为铁 + 黄铜仪表风格(v0.8.0)。
启动与遥测¶
- 一段式启动:宿主通过
webserver/index-inject注入启动前奏(暗色大教堂、徽记、「铸造圣殿」标题、黄铜进度轨);客户端showSplash()检测到前奏后以is-continue续播点火动画,并隐藏原生HARNESS / Loading plugins…屏;客户端加载失败时脚本会撤掉前奏,避免遮住错误页(v0.8.0)。 - 机魂遥测条:底部速率 / 命中率 / 上下文三个原生统计按钮改为黄铜仪表(拉丁文 + 中文小标题、等宽读数、分段增益条),仅写
data-*与自定义属性,不向 React 节点插 DOM(v0.8.0)。
推理等级与输入区¶
- 模型菜单内离散滑块:推理等级钻取列表改为横向 Off / Low / High / Max 四档滑块,仍提交原生
menuitemradio,键盘与读屏行为不变(v0.8.0)。 - v0.9.2:按需求移除输入框内的「思考程度」进度条与相关点击交互,输入区只保留模型控件;模型菜单里的滑块与拖拽逻辑保留。
- 状态修复(v0.9.0):推荐标签「推荐」在黄铜 token 下不可见的问题已单独配色;发送键在排队 / 插话 / 停止等状态下统一火星红主按钮样式,避免退化成「纯金圆点」。
macOS 应用图标(可选)¶
- 提供 1024px 规范的应用图标资源(
assets/app-icon/),可用python3 tools/build-macos-app-icon.py生成。 - v0.9.3:
tools/build-macos-app-icon-fixer.sh生成替换器 applet;在「系统设置 → 隐私与安全性 → App 管理」授权后,可在 不退出 DSH 的情况下替换/Applications/DeepSeek Harness.app内icon.icns/icon.png,并刷新 Dock;官方图标备份在~/.dsh-theme-admech/app-icon-backup/。DSH 更新会恢复官方图标,需重新运行替换器。
平台与验证¶
- README 写明 macOS + Windows verified;Windows 适配细节见 README 文末「Windows 适配(v0.7.0 · 实测)」及
tools/win-audit/审计脚本。 - 维护者使用
layout_audit/layout_assert在 1440×900 与 390×844 等视口做布局验收(报告中为 0 errors)。
开发 profile 若以 link: 指向本仓库:client 侧支持 HMR;宿主侧启动前奏注入需在插件行重新挂载或于「插件」页停用/启用一次后刷新页面。
安装与启用¶
插件与 DSH 同一进程权限运行。安装前请自行审阅 GitHub 源码与上述混合许可,确认符合你的使用与分发场景。社区目录 SkillHub 插件页 提供索引,与 DeepSeek / 幻方无官方从属关系。
DSH Desktop¶
- 左侧栏 插件 → 添加插件(或箭头 → 安装第三方插件)。
- 输入 Git 地址(README 原文):
github:RichardDou0607/dsh-theme-admech
或使用 HTTPS 地址:
https://github.com/RichardDou0607/dsh-theme-admech
- 安装 → 立即启用;若提示重启则重启 DSH。
也可下载仓库 ZIP,解压后按本地目录安装。
DSH Web / CLI¶
README 给出的命令为:
dsh plugin --profile web add "github:RichardDou0607/dsh-theme-admech"
Windows 上若 github: 因 Git 代理或证书链失败,README 建议改用本地 file: 路径(示例为 file:C:\dsh-theme-admech\dsh-theme-admech-main,需换成你本机解压目录)。
Windows 提示(README):
github:依赖 Git 与可用网络环境;推荐在代理不稳的机器上使用「下载 ZIP → 本地file:安装」。file:安装在同一磁盘卷下为硬链接,改源码后需重启 profile 进程才会加载新客户端 bundle。
典型用法¶
启用主题后的日常使用¶
安装并启用后,刷新或重启 DSH 即可看到铸炉圣殿背景、主题图标与遥测条样式。若你调整了宿主侧注入(例如开发中的 link: profile),按 README 在「插件」页重新挂载插件后再刷新。
减少动态效果时,启动前奏会保留静态画面直至界面挂载;自动化可用 URL 片段 #admech-splash=0 跳过前奏(README v0.8.0)。
替换 macOS 应用图标¶
首次需要系统授权「修改其他 App」。在克隆或解压后的插件目录执行:
tools/build-macos-app-icon-fixer.sh
脚本会生成并打开替换器;授权后复制主题图标到 DSH 应用包并刷新 LaunchServices / Dock。查看或还原:
tools/install-macos-app-icon.sh status
tools/install-macos-app-icon.sh restore
若 Dock 仍显示旧图标,README 建议退出并重新打开一次 DSH。替换会使应用包 codesign 校验失效,本地启动一般不受影响,需要时可 restore。
从源码构建客户端 bundle¶
修改 src/ 后需重新生成 lib/client.js:
node src/build-client.mjs
node --check lib/client.js
package.json 中 npm run build 等价于上述构建步骤。
适用场景与注意¶
适合谁
- 长期在 DSH 上做智能体 / 工具开发,希望界面统一为深色 tech-gothic,并愿意接受粉丝向视觉与混合许可约束的用户。
- 需要在 macOS 上可选更换 DSH 应用图标,且能接受 App 管理与 codesign 相关说明的用户。
- Windows 用户可参考 README 实测章节与 ZIP +
file:安装路径,避免强依赖github:拉取。
边界与限制(README「边界」)
- 背景为矢量 SVG 插画,非照片级;深色 only;设置页、仪式动画、音效未做;tool 卡 / 审批卡未逐组件精修。
- 非官方粉丝作品,与 Games Workshop 无关联;公开分发前请确认素材与商标风险。
安全与合规
- 插件代码在 DSH 进程内执行,安装第三方插件前请检查仓库提交历史与依赖。
- 星标与社区热度以各站点实时数据为准;撰写时 GitHub 显示为社区小体量项目,请以你打开仓库时的信息为准。
结尾¶
dsh-theme-admech 把 DSH 的 Web 界面收成一套 Forge-Cathedral tech-gothic 皮肤:从启动前奏、输入区 crest 到底部遥测与推理等级控件,并针对推荐标签、发送键等状态做了主题向修复;macOS 还可选一键替换应用图标。若你使用 DSH 的插件模型做环境定制,可以把它当作「趣味换装」类参考实现,同时务必遵守仓库中的混合许可与非官方免责声明。