DeepSeek Harness 的插件生态允许用户扩展功能。对于习惯于深度定制界面的用户，HelloAI Theme 插件提供了现成的配色方案与编辑工具。
插件简介¶
HelloAI Theme 是 DeepSeek Harness 的主题插件，旨在解决默认界面无法满足个性化需求的问题。它由开发者 hello-heyongping 维护，采用 MIT 许可证。插件提供十款内置配色，并内置一个自建主题编辑器，支持创建、引用、编辑、改名和删除主题。
核心功能¶
该插件主要包含以下能力：
- 十款内置配色：包含两套浅色主题（清晨、森绿）与八套低对比度深色主题，全部按照护眼低对比度设计。
- 自建主题编辑器：支持新建、引用、编辑、改名、删除主题。交互采用就地展开模式，不弹出新窗口。
- 丰富的槽位调节：提供 13 个可调槽位，包括 6 项底色、3 项文字色、4 项强调与状态色。支持系统取色器或直接输入 Hex 值，不做颜色限制。
- 色彩传导机制：修改强调色时，整族颜色（按钮、悬停、派生档）会一起重算，避免出现主色变了但按钮颜色未变的情况。
- 升级传导：用户自建的主题仅存储差异。当内置主题更新修正配色时，用户主题也会自动受益。
- 样式覆盖：可选玻璃质感、代码高亮风格、逐 token 覆盖等能力。
- 首页动效：可选首页动效（whale / dragon / leap / cat / school），独立开关。
安装与启用¶
安装前请确认环境满足以下条件：
- DeepSeek Harness 版本 ≥ 0.1.5-rc.1
- 使用
webprofile（桌面版与网页版均属于 web profile）
执行以下命令安装插件：
dsh plugin --profile desktop add github:hello-heyongping/dsh-helloai-theme
安装完成后，刷新页面即可在「设置 → 通用」中看到「HelloAITheme 主题」选项。
使用步骤¶
- 打开 设置 → 通用，找到 HelloAITheme 主题。
- 点击任意内置主题按钮，立即切换并自动保存。
- 点击 ＋ 添加主题，编辑器会在下方展开。
- 输入主题名称（最多 4 个字）、选择基点主题、调整色板、保存。
- 若需编辑已有主题，点击主题按钮右上角的 ✎。
注意事项¶
- 命名限制：主题按钮固定尺寸，名称限 4 个字，输入时会实时截断。
- 数量限制：用户主题上限为 24 个。
- 数据存储：数据存储在设置文档的
customThemes字段里，同时镜像一份到localStorage以支持多标签页同步。 - TUI 独立性：插件提供的 TUI 主题文件位于
themes/*.json，由dsh-tui/themes目录半块同步到~/.dsh-tui/themes/，与本编辑器相互独立。
总结¶
HelloAI Theme 插件为 DeepSeek Harness 提供了一套完整的主题管理方案。它既可以通过内置主题快速换肤，也可以通过编辑器深度定制，且保证了配色的一致性与可维护性。
