前言¶
DSH 的插件生态强调「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对于需要在 DeepSeek Harness Web 中调整外观、品牌词、Logo 和新会话标题，而不想改 Harness 仓库源码的场景，dsh-yizi-themes 是一个可用的第三方插件。
它由 laoduu 维护，许可证为 MIT。旧版 install.sh / install.ps1 / MANIFEST.json / patch/ 是早期“源码覆盖”方案遗留，已废弃，仅保留作参考，请勿使用。
这是什么¶
dsh-yizi-themes 是第三方 DeepSeek Harness 主题扩展，主题设计语言移植自 YiziMarkdown。它提供 19 个精品风格主题，每个主题同时支持亮色 / 深色两套配色，并跟随「浅色 / 深色 / 跟随系统」设置。
它按标准 Cordis 插件安装，通过 dsh plugin 安装/卸载，不修改 Harness 仓库任何源码。
核心功能¶
主题与明暗¶
- 提供 19 个精品风格主题。
- 明暗模式与风格主题完全独立，可自由组合。
- 可在会话头部右上角切换主题 / 明暗；新会话（无对话）时，切换入口以浮动按钮显示。
自定义品牌¶
- Logo SVG、品牌字样、徽章字样、新会话标题可自定义。
- 品牌颜色自动跟随主题与明暗。
- 品牌设置持久化在
$DSH_HOME/settings.yaml的ui-theme.customBrand分节。
如果 SVG 中使用了硬编码颜色，颜色不会自动跟随主题。可改为：
fill="var(--dsw-alias-brand-primary)"
fill="currentColor"
前者随主题与明暗切换，后者继承容器颜色。
品牌映射（实验性）¶
- 默认关闭。
- 可替换界面 / 输出中的
DeepSeek/深度求索/Harness品牌词。 - 开启后不改写输入内容。
安装与启用¶
前置条件¶
需要一个能运行 pnpm dsh web 的 DeepSeek Harness 仓库（含 profile）。
web 与桌面版是两个独立 profile，互不相通。桌面版（DSH Desktop App）使用 --profile desktop。
从 GitHub Release 安装¶
下载 0.4.0 tgz：
curl -L -o dsh-yizi-themes-0.4.0.tgz https://github.com/laoduu/DeepSeek-Harness-yizi-themes/releases/download/v0.4.0/dsh-yizi-themes-0.4.0.tgz
然后在 Harness 仓库目录执行安装：
pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-0.4.0.tgz
重新启动 Web 端：
pnpm dsh web
如果是桌面版，把命令中的 --profile web 换成 --profile desktop。
从源码构建¶
克隆插件仓库：
git clone https://github.com/laoduu/DeepSeek-Harness-yizi-themes.git
进入插件目录后构建并打包：
node prepare.mjs
npm pack
生成的 dsh-yizi-themes-<version>.tgz 按上面的 add 命令安装。
典型用法¶
切换主题与明暗¶
在会话头部右上角点击主题 / 明暗按钮；新会话没有对话内容时，使用同位置的浮动按钮。
自定义品牌¶
进入“设置 → 外观 → 自定义”，填写 Logo SVG、品牌字样、徽章字样、新会话标题，并可开启品牌映射。
覆盖插件默认配置¶
在 profile 的 cordis.patch.yml 中可覆盖以下字段：
wordmark:
wordmarkBadge:
headline:
mappingEnabled:
mappingDeepSeek:
mappingDeepSeekChinese:
mappingHarness:
mappingDeepSeekHarness:
这些字段分别用于品牌字样、徽章字样、新会话标题、品牌映射开关，以及各品牌词的替换目标。设置页的修改优先级高于 cordis.patch.yml；配置作为 base 层，用户层覆盖之。
更新、卸载与注意¶
更新¶
如果版本号变化，可直接 add 新版本。
如果版本号没变但 tgz 内容变了，直接 add 不会更新，pnpm 可能报 Already up to date。需要先卸载再安装：
pnpm dsh plugin --profile web remove dsh-yizi-themes
pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-<version>.tgz
更新后需完全重启 pnpm dsh web，并浏览器强刷 Ctrl+Shift+R。
卸载¶
pnpm dsh plugin --profile web remove dsh-yizi-themes
重启后恢复默认外观。$DSH_HOME/settings.yaml 中的 ui-theme.customBrand 分节卸载后仍保留，可手工删除。
兼容与配置¶
- 适配 Harness
v0.1.2-alpha.1+；0.4.0起迁移到@deepseek-ai/dsh-client-store/@deepseek-ai/cordis。 - Harness
v0.1.2-alpha.1移除了@deepseek-ai/dsh-client-runtime；旧版0.3.x需升级到0.4.0。 - 插件数据走核心
ui-theme命名空间（api-proxy 白名单），不要改成自定义命名空间。 - 侧边栏折叠后重新展开空白是老版本 bug，升级到
0.2.2+。
安全与许可证¶
dsh-yizi-themes 是第三方插件，许可证为 MIT。安装前建议检查源码与许可证。插件安装后以当前 dsh 进程权限运行，不要从不可信来源直接执行。
结尾¶
dsh-yizi-themes 的价值在于用插件方式改 DeepSeek Harness Web UI 的外观与品牌，不直接修改 Harness 仓库源码。
仓库地址：
https://github.com/laoduu/DeepSeek-Harness-yizi-themes
社区目录 URL 未确认，本文不列出；如目录站点有该插件条目，请以该站点实际页面为准。
