DeepSeek Harness 提供了 AI 工作环境，但界面风格通常与本地操作系统（macOS 或 Windows）存在差异，这可能影响沉浸感。dsh-cyberwhale 插件通过双端视觉本地化，让软件的设置界面更贴近系统原生样式，并提供主题、壁纸与字体设置，以及可选的蓝鲸桌宠。
该插件由 CyberWei922 维护，采用 MIT 许可证。它主要解决视觉统一性问题，提供主题、壁纸、字体设置以及可选的蓝鲸桌宠。
核心功能¶
双端界面本地化¶
插件会自动识别客户端系统，使用对应的设置界面样式：
* macOS 风格：模拟系统设置界面的圆角分组、磨砂侧栏、小型开关与随分区变化的标题。
* Windows 风格：模拟 WinUI 3 界面，包含导航指示条、设置卡片、圆形开关滑块与 Mica 风格底色层次。
主题与配色¶
- 主题选项：提供 27 个浅深色主题选项（浅色 10 个、深色 17 个），涵盖 Catppuccin、Nord、Tokyo Night 等流行配色。
- 自定义配色：分别调整浅色和深色模式的强调色、背景色与文字色，自动派生界面颜色。
- 背景设置：支持纯色、渐变或图片背景，可调整布局、遮罩与模糊度。
- 壁纸取色：支持从上传的壁纸中提取主色，生成配套的浅色与深色方案。
字体与阅读¶
- 字体设置：读取本机字体，分别选择界面字体和代码字体。
- 阅读设置：支持输入框磨砂，或减少透明效果以提升对比度。
蓝鲸桌宠¶
- 独立运行：外观美化与桌宠功能可分别控制。
- 交互功能：支持拖动、右键打招呼、眼睛跟随鼠标（待机时）。
- 状态反馈：随任务切换动作，显示进度气泡。
安装与启用¶
在安装前，请确保已安装并启动过 DeepSeek Harness 官方 Desktop。
界面安装¶
- 打开 Harness，进入侧栏的 插件 选项。
- 点击 添加插件，填入插件名称
dsh-cyberwhale或仓库地址。 - 安装完成后点击 启用。
命令行安装（本地开发）¶
如果需要本地开发或调试，可以通过命令行安装：
git clone https://github.com/CyberWei922/dsh-cyberwhale.git
cd dsh-cyberwhale
npm ci
npm run build:client
安装完成后，在 Harness 中添加指向该目录的插件即可。
典型用法¶
启用插件后，通过设置页面进行配置：
- 外观美化：进入 设置 → 主题，开启“启用外观美化”。选择浅色、深色或跟随系统，并从预设主题中选择一个，或自定义配色与背景。
- 桌宠设置：进入 设置 → 桌宠，开启桌宠功能。此时桌宠窗口将出现，支持拖动位置和调整大小。
- 气泡提示：在桌宠设置中开启“气泡提示”，蓝鲸会在任务切换时显示进度信息。
适用场景与注意事项¶
- 适用场景：希望 DeepSeek Harness 界面更符合个人系统习惯的开发者与用户。
- 运行环境：基于 Harness Desktop 0.2.0-rc.2 验证。在 macOS 26+ 上，桌宠气泡支持原生的 Liquid Glass 效果。
- 资源占用：桌宠功能需要额外的独立 Electron 运行时（约 100–150 MB），仅使用外观美化时可关闭桌宠以节省资源。
- 配置保存：主题配置与壁纸保存在本地。macOS 路径为
~/.dsh/dsh-cyberwhale/，Windows 路径为%USERPROFILE%\.dsh\dsh-cyberwhale\。
该插件通过本地化设计，让 DeepSeek Harness 更好地融入桌面环境，提升使用体验。
