✨ 特色

• 🎭 19 个主题：从极光流光到赛博朋克霓虹，从莫兰迪高级灰到故宫朱砂，总有一款配得上你的审美
• 🌗 双模式：每个主题都有精心调配的亮色 / 深色两套 token，跟随系统自动切换
• 🧩 标准插件：标准 Cordis 插件（dsh plugin 安装/卸载），不修改 Harness 仓库任何源码
• ✅ 干净 Harness 开箱即用：风格主题由插件自实现（含持久化与 body.theme-<id> 应用），官方源码 / npm 发布的 rc.5 无需打任何补丁
• 🧩 升级免疫（rc.8+）：品牌（左上角 Logo / 字样 / 徽章 / 新会话标题）改用 Harness 官方的品牌槽位渲染（sidebar.brand.mark / sidebar.brand.name / conversation.hero.brand.mark），不依赖内部 DOM，Harness 后续升级只要保留槽位契约即可继续工作；旧版核心（无槽位）自动回退到原 viewBox 注入路径
• 🎚️ 正交双维度：明暗模式与风格主题完全独立，可自由组合
• 🖌️ 自定义品牌：左上角 Logo / 品牌字样 / 徽章 / 新会话标题全部可自定义，颜色自动跟随主题与明暗
• 🔤 品牌映射（实验性，默认关闭）：把界面/输出中出现的 "DeepSeek / 深度求索 / Harness" 替换为你设定的品牌词（开启后也绝不改写你正在输入的内容）
• 📍 随处可切换：会话头部右上角 + 新会话（无对话）时的浮动按钮

🖼️ 主题预览

📦 安装教程

前置条件：一个能运行 pnpm dsh web 的 DeepSeek Harness 仓库（含 profile）。

方式一：从 GitHub Release 下载 tgz（推荐）

1. 下载 dsh-yizi-themes-0.3.1.tgz —— 在 Releases 页面 点击下载，或直接命令行拉取：

curl -L -o dsh-yizi-themes-0.3.1.tgz https://github.com/laoduu/DeepSeek-Harness-yizi-themes/releases/download/v0.3.1/dsh-yizi-themes-0.3.1.tgz

2. 停掉正在运行的 dsh web（Ctrl+C）；
3. 安装：

cd <你的 deepseek-harness 路径>
pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-0.3.1.tgz

💡 桌面版（DSH Desktop App）用户：把 --profile web 换成 --profile desktop， 安装到桌面版自己的 profile（$DSH_HOME/profiles/desktop）——web 与桌面版是两个独立 profile，互不相通。

4. 重启：

pnpm dsh web

方式二：从源码构建

# 克隆插件源码
git clone https://github.com/laoduu/DeepSeek-Harness-yizi-themes.git
cd DeepSeek-Harness-yizi-themes

# 构建并打包（prepare.mjs 从 Harness 仓库的 node_modules 解析 tsdown）
node prepare.mjs
npm pack          # 产出 dsh-yizi-themes-<version>.tgz

然后按方式一的 2-4 步安装、重启。

⚠️ 更新已有安装（同版本陷阱）

同版本 tgz 内容变了，直接 add 不会更新（pnpm 报 Already up to date）。

• 版本号变了：直接 add 即可；
• 版本号没变：必须先卸载再安装：

pnpm dsh plugin --profile web remove dsh-yizi-themes
pnpm dsh plugin --profile web add  /path/to/dsh-yizi-themes-<version>.tgz

使用

• 切换主题 / 明暗：右上角调色板按钮 + 明暗切换按钮（会话头部）；新会话（无对话内容）时以浮动按钮显示在同一位置；
• 自定义品牌：设置 → 外观 → 自定义（见下节）。

🖌️ 自定义品牌

设置 → 外观 → 自定义 板块：

颜色自动跟随主题：品牌字样、徽章背景、Logo 容器颜色统一使用 --dsw-alias-brand-primary， 切换任意风格主题或明暗模式时自动变化。

想让自己的 SVG 也跟随主题？ 把 SVG 里的硬编码颜色替换为：

• fill="var(--dsw-alias-brand-primary)" —— 随主题与明暗自动切换；
• fill="currentColor" —— 继承容器颜色（容器已设为主题色）。

其他可用变量：主文字 --dsw-alias-label-primary、次要文字 --dsw-alias-label-secondary / --dsw-alias-label-caption、反色文字 --dsw-alias-label-primary-inverted、 背景 --dsw-alias-bg-layer-1、边框 --dsw-alias-border-l1 等。

持久化：所有品牌设置保存在 $DSH_HOME/settings.yaml 的 ui-theme.customBrand 分节， 与主题偏好一起持久化，重启不丢失。

⚙️ 配置（cordis.patch.yml）

插件行的默认配置（可在 profile 的 cordis.patch.yml 里覆盖）：

设置页的修改优先级高于此配置（配置作为 base 层，用户层覆盖之）。

🗑️ 卸载

cd <你的 deepseek-harness 路径>
pnpm dsh plugin --profile web remove dsh-yizi-themes

重启 dsh web 即恢复默认外观。settings.yaml 里的 ui-theme.customBrand 属于核心命名空间， 卸载后仍保留（无副作用，可手工删除）。

❓ 常见问题

Q: 更新后界面没变化？ 版本号没变则必须 remove → add（见上）；并完全重启 dsh web（Ctrl+C 后重启）+ 浏览器强刷 Ctrl+Shift+R。

Q: 设置能输入但刷新后丢失？ 检查 $DSH_HOME/settings.yaml 是否出现 ui-theme.customBrand。若没有，看浏览器 F12 → Network → settings.mutate 是否返回 settings-not-exposed（说明写入被拒）。插件数据走核心 ui-theme 命名空间（api-proxy 白名单），不要改成自定义命名空间。

Q: 切换主题后左上角品牌颜色不变？ 确认 Logo/品牌字样已设置且为 currentColor 或 var(--dsw-alias-brand-primary)；硬编码颜色不会跟随主题。

Q: 侧边栏折叠后重新展开空白？ 老版本 bug，升级到 0.2.2+。

Q: 干净 Harness（官方源码 / npm 发布的 rc.5）能用吗？ 可以。0.2.1+ 由插件自实现风格主题（持久化到 localStorage + 自行切换 body.theme-<id>），无需给核心打任何补丁；明暗切换仍走核心。若核心本身带风格主题 API（打过旧 patch 或含该特性的构建），则自动走核心路径（持久化到 settings.yaml）。

Q: Harness 升级到 v0.1.0-rc.8 后，自定义品牌失效了？ 0.3.x 已适配（0.3.0 起）。rc.8 把侧边栏品牌从单个 BrandWordmark（viewBox="0 0 182 24"）改成了官方品牌槽位（sidebar.brand.mark / sidebar.brand.name / conversation.hero.brand.mark）。插件改为注册这些槽位来渲染自定义 Logo / 字样 / 徽章 / 新会话标题——槽位是官方扩展面，后续 Harness 升级只要保留槽位契约即可继续工作；无槽位的旧核心自动回退到原 viewBox 注入路径。升级后若仍显示旧版，请先 remove 再 add（同版本内容变了 pnpm 会报 "Already up to date"）。

Q: 想让 agent 帮我装插件？ 把 Agent 安装指引 交给 agent 即可。

🤝 贡献

欢迎提交 Pull Request：

• 新主题：见 开发日志 与 scripts/gen-themes.mjs（CSS → TS 生成器）；
• Bug 修复：Harness 版本更新导致的适配问题；
• 文档改进：安装教程、常见问题。

📄 文档

• 版本日志
• 开发日志
• Agent 安装指引

⚖️ 许可

MIT © 老独

本项目是对 DeepSeek Harness（MIT）的第三方主题扩展； 主题设计语言移植自 YiziMarkdown。

旧版 install.sh / install.ps1 / MANIFEST.json / patch/ 为早期"源码覆盖"方案遗留， 已废弃，仅保留作参考，请勿使用。