前言¶

在 DeepSeek Harness（DSH）里长时间写提示、调会话，界面大多仍是宿主默认的浅色或深色面板。社区里已有若干主题类插件，多半只做配色或少量装饰。若你希望侧栏、输入框和弹窗统一成石墨玻璃质感，背景里还有可调的流体粒子与鼠标弹性网格，又能在设置里一键关掉、不改动原本的浅色 / 深色偏好，「高达 · 石墨」（dsh-gundam-graphite-theme）就是针对这类需求的客户端皮肤插件。下面按定位、功能、安装与设置说明用法。

这是什么¶

「高达 · 石墨 / Gundam Graphite」由维护者 machi12 发布，在 SkillHub 插件目录 中归类为趣味换装类；仓库见 GitHub。当前包版本为 1.0.1（以 package.json 为准）。

插件是 客户端主题（platform: web）：在桌面版与 Web 版共用同一套客户端注入机制，不修改 Electron 的 app.asar，也不是预加载层注入。它内置黑灰机甲壁纸，把宿主侧栏、输入卡、设置弹窗等面板统一为半透明石墨色，并在背景层叠加银灰粒子、视差、呼吸灯与可选的鼠标弹性网络。关闭「启用石墨皮肤」即可恢复原生外观。

核心功能¶

壁纸与面板¶

• 内置 1672×941 黑灰机甲图，按窗口比例裁切；左侧压暗、右侧渐显，正文区域保持可读。
• 壁纸遮罩 0–85%、壁纸虚化 0–16px 可调，用于平衡氛围与文字对比度。
• 石墨玻璃面板：侧栏、输入框、弹窗等 不透明度 60–100% 可调（默认约 86%）。

动效（均可单独或成组关闭）¶

• 景深视差：鼠标移动时远景烟尘与近景机体反向位移，相对位移最多约 6px。
• 红光呼吸与火星：眼部与装甲灯条缓慢呼吸；流体开启时，灯附近偶尔出现少量暗红火星。
• 流体粒子：流场、涡旋、星雨三种轨迹；亮度、数量（20–240）、速度（0.15–2×）可调。
• 鼠标弹性网络：五种交互模式（排斥回弹、吸引回弹、涟漪扩散、旋涡扭转、呼吸脉冲）；影响半径 80–320px、强度 0–100%。触摸设备（pointer: coarse）自动关闭该功能。

宿主行为与性能¶

• 主题启用期间临时以深色呈现，不改写用户原有的浅色 / 深色偏好；关总开关即恢复。
• 动效帧率上限 20–60fps（默认 30）；页面隐藏、最小化或系统「减少动态效果」时暂停。
• 设置通过 DSH 宿主持久化，重启后保留，不依赖 localStorage。
• 背景图层不拦截鼠标事件，并对辅助技术标记为 aria-hidden。

环境要求¶

需要 DeepSeek Harness 0.2.0-rc.2 及以上（engines.dsh >= 0.2.0-rc.2）。

安装与启用¶

任选一种方式安装后，需完全退出并重新打开 DSH（桌面版关窗口可能只是进托盘）；Web 版刷新页面即可。装好后路径：设置 → 通用设置 → 高达 · 石墨。

方式一：插件市场（README 推荐）¶

DSH 插件市场 → 分类「主题」→「高达 · 石墨」→ 安装，然后重启应用。

方式二：Release 包（离线 / 内网）¶

从 Releases 下载 dsh-gundam-graphite-theme.tgz，在本机执行：

dsh plugin add ./dsh-gundam-graphite-theme.tgz

方式三：从 GitHub 安装¶

dsh plugin add github:machi12/dsh-gundam-graphite-theme

若使用 pnpm 且首次安装提示将 dsh-gundam-graphite-theme 加入 allowBuilds，按提示加入后重试即可；包内已带预构建的 lib/，一般无需本地编译。指定配置时可加 --profile <name>（桌面版示例路径以本机安装目录为准）：

& 'D:\dsh\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add github:machi12/dsh-gundam-graphite-theme

首次安装需要包管理器能拉取依赖 @deepseek-ai/schemastery；壁纸与动效资源内嵌在包内，不访问外部图片服务。

典型用法¶

只要壁纸、不要动效¶

在设置面板关闭 动效总开关：静态壁纸保留，粒子、弹性网络、呼吸与视差全部停止。

调节可读性¶

壁纸过亮或过暗时，调高 壁纸遮罩 或 面板不透明度；需要弱化背景细节时可增加 壁纸虚化。

临时停用皮肤¶

不必卸载：关闭 启用石墨皮肤 即恢复宿主原生外观。卸载时使用：

dsh plugin remove dsh-gundam-graphite-theme

设置项概览¶

主题面板共 16 项，改动实时生效并自动保存。下表为 README 中的默认值与范围摘要：

宿主未连接时，控件会显示为不可用。

适用场景与注意¶

适合谁：希望在 DSH 主界面获得统一黑灰机甲氛围、又能在设置里细调粒子与网格交互的开发者；需要内网离线装包时可用 Release 的 .tgz。

插件权限：客户端插件随 DSH 进程在本地 Web 界面中运行，安装前建议查看仓库源码与许可证。代码以 MIT 发布；壁纸为作者提供的图片，不包含在 MIT 范围内，对外分发或商用前需自行确认图片授权（见仓库 THIRD_PARTY_NOTICES.md）。

兼容性边界：不改动 Electron 原生窗口边框、也不保证覆盖第三方插件自绘面板；DSH 大版本若调整主题变量或会话容器，可能需要插件适配。

常见问题：装完无变化时，确认已完整重启或刷新；与浅色偏好不冲突——仅在使用皮肤期间临时深色显示。

结尾¶

「高达 · 石墨」把壁纸、石墨玻璃面板与可调 Canvas 动效收进一个客户端主题，总开关与动效分离开关让回退成本很低。目录页：https://www.skillhub.cn/plugins/machi12/dsh-gundam-graphite-theme；源码与完整说明：https://github.com/machi12/dsh-gundam-graphite-theme。SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系。