前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的理念，允许用户通过社区插件扩展功能。默认界面相对固定，若需要定制视觉风格、调整配色或更换壁纸，只能通过修改源码或等待官方迭代。

yogemow/dsh-custom-theme 是一个自定义主题插件，允许为 DSH 创建多套主题，每套可独立配置配色、壁纸、背景音乐、首屏立绘与多条文案，并与 Agent 预设联动。

安装与启用¶

该插件当前版本为 0.9.0。

安装方式有两种：

# 方式一：从 GitHub 安装（DSH 支持 github: spec）
plugin_manager install_bundle    # target: github:YOGEMOW/dsh-custom-theme

# 方式二：克隆后按本地目录安装
git clone https://github.com/YOGEMOW/dsh-custom-theme.git
plugin_manager install_bundle    # target: <克隆目录>

0.9.0 起宿主提供多个只读路由（assets、agent-presets、preset）。从旧版本升级后需重启 DSH；之后主题、文案、音乐、预设的日常迭代只需刷新页面。

卸载：plugin_manager remove_bundle。

启用后，进入 设置 → 自定义主题 即可开始配置。

主题管理¶

设置页「自定义主题」中，每行代表一套主题。左侧显示双色迷你预览图标（浅色一半 + 深色一半，取该主题的底色/强调色/前景色）。

• 行内操作：改名、「使用」切换、删除（至少保留一套）。
• 底部操作：新建主题、复制当前主题。
• 「预设主题」一行可追加内置预设：Everforest、德谬歌、德谬歌·完整。

主题列表与配置修改即时生效（本地推导 token，约 160ms 防抖后写入配置目录），页脚会显示保存状态。配色改动不会被保存回包。

配色与视觉风格¶

主题支持三种视觉模式：

• 浅色
• 深色
• 跟随系统（写回 DSH 内置偏好）

配色项包括：

• 强调色
• 背景
• 前景
• 侧栏背景（留空则自动推导）
• 对比度 0–100

「分别设置深色配色」开关打开后，可单独编辑深色配色；关闭时按浅色色相自动生成。

语义色包括：成功 / 错误 / 警告 / 次要。

背景图与文字可读性¶

支持本地图片或图片地址。可调节项包括：

• 主界面可见度 0–100%（页面底色和侧栏透出壁纸的程度，最多透出 82%）
• 子界面不透明度 0–100%（设置面板、弹窗、卡片、输入框等浮层）
• 模糊 0–40px
• 亮度 30–200%
• 文字遮罩 0–150%（壁纸上方叠一层与主题同色的纱，解决浅白色段落看不清的问题）
• 铺满 / 适应

默认情况下，子界面不透明度为 100%，避免浮层文字和背后内容重叠。

首屏立绘¶

首屏立绘替换首屏标题前的品牌图形（conversation.hero.brand.mark），支持本地图片或地址，显示宽度 16–200px。

文案¶

主题包含 4 个文案字段：

• 首屏标题
• 角标
• 首屏输入框提示
• 会话输入框提示

每个字段可存放多条文案，支持两种轮换模式：

• 顺序：每次页面加载显示当前游标那一条，然后游标 +1 存回文档 → 下次加载显示下一条，循环。
• 随机：每次页面加载随机挑一条（游标不动）。

设置页提供「换一条」、「回到第一条」、「添加一条」等操作。列表中高亮的一行为当前显示的那条，预览行显示「当前显示（第 n 条）」。

背景音乐¶

每套主题可配置一首背景音乐：

• 本地音乐（mp3/wav/ogg/m4a/flac）或链接
• 启用 / 禁用
• 音量
• 循环
• 最小化暂停（窗口最小化或切到后台时自动暂停，回到界面继续）

切主题时自动切歌。本地文件点击「选择本地音乐」上传到宿主 assets 目录；也可直接填写 https 链接。

浏览器要求先与页面交互一次（点击/按键）才会响，之后切换主题、重新启用会继续播放。

与 Agent 预设联动¶

Agent 预设（Session 的 agentPreset 投影）决定一个会话使用的工具与提示词。主题可以绑定预设：

• 设置页「Agent 预设联动」每套主题一行：点「选择预设」展开勾选列表（多选，勾选即保存）。
• 列表来自宿主 agentPresets.list()（名称 + id，加载失败的预设会标注）。
• 客户端占用两个无害的会话槽位，通过 useProjection("agentPreset") 读取当前会话预设，一变就切主题。
• 没有任何主题绑定该预设时，保持用户当前主题不动。
• 设置页底部显示「当前会话的 Agent 预设」，用于核对是否命中。

预设与同步¶

德谬歌是昔涟的完整形态，插件随包提供两套德谬歌预设：

• 德谬歌（基础）：配色、光环立绘、文案；壁纸沿用当前主题，没有壁纸时才用内置星空兜底。
• 德谬歌·完整：包含配色、光环立绘、文案、壁纸、立绘、Agent 预设联动（预绑定 chat、cyrene-work、wonderland-lua-builder），用于一键还原整套观感。

「德谬歌·完整」点击后会在主题列表中新建一套独立主题（可改名、可继续编辑），不覆盖现有主题。

素材与授权：壁纸与立绘为使用者提供的同人素材，仅供个人非商业使用；含角色 IP 的内容禁止商业使用。

从预设创建的主题会记录 preset、presetVersion、presetBase（上一次预设的设计快照）。预设设计随插件版本更新（PRESET_VERSION 提升）时，已创建的主题会自动同步；同步按字段比较，只有仍等于旧预设值的字段会被替换，手动改过的颜色/立绘/文案/音乐保持原样；壁纸始终保留。

数据与存储¶

配置存储在：

<DSH_HOME>/theme-studio/theme.json      # 默认 ~/.dsh/theme-studio/theme.json
<DSH_HOME>/theme-studio/assets/         # 上传的图片 / 音频

旧版单主题文档会在加载时自动迁移到 themes 数组。旧的 ~/.dsh/theme-studio/state.json 可删除（新文件是 theme.json）。

适用场景与注意¶

该插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。

适合需要为不同 Agent 预设配置不同视觉风格、希望自定义界面配色与壁纸、或喜欢为会话添加背景音乐与多条文案的用户。

总结¶

yogemow/dsh-custom-theme 为 DeepSeek Harness 提供了一套完整的主题定制方案，从配色、壁纸、背景音乐到首屏立绘与多条文案，再到与 Agent 预设的联动，都可在设置页中即时预览与调整。插件维护者 YOGEMOW 在 GitHub 上维护该仓库，当前版本为 0.9.0。

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