🐋 dsh-cyberwhale

让 DeepSeek Harness 更融入你的 macOS 和 Windows

双端视觉本地化 · 主题配色 · 壁纸与字体 · 可选蓝鲸桌宠

界面预览 · 为什么需要它 · 功能介绍 · 快速上手 · 蓝鲸桌宠 · 常见问题

界面预览

同一套功能，两种熟悉的系统风格。下面是 macOS 与 Windows 上的实机截图，点击图片可查看大图。

macOS · 系统设置风格	Windows · WinUI 3 风格

磨砂侧栏、圆角分组、小型开关	导航指示条、设置卡片、小圆角控件

主题轮播预览

看看不同主题切换时的实际效果，找到适合自己工作环境的配色。

喜欢这种外观？几步安装并启用，再搭配自己的主题、壁纸和字体。

为什么需要 CyberWhale？

DeepSeek Harness 提供了一个好用的 AI 工作环境，但它的界面与 macOS、Windows 各自的系统风格仍有一些距离：设置面板、导航和开关，和你每天使用的系统界面不太协调。

CyberWhale 为 Harness 做了一套双端视觉本地化，参考两套系统各自熟悉的界面样式，让软件在视觉上更融入你的桌面：

在 macOS 上，设置页采用系统设置风格的圆角分组、小型开关和磨砂侧栏。
在 Windows 上，设置页参考 WinUI 3 的导航、设置卡片、圆形开关滑块和材质层次。
🎨 在两端都能个性化，选择主题、更换壁纸、调整字体，搭配自己的工作环境。

插件会自动识别客户端系统，使用对应的设置界面。配色、字体和背景功能在两端共享，蓝鲸桌宠可以单独开启或关闭。

这里的“视觉本地化”指系统风格适配。设置界面通过 CSS 模拟 macOS 与 WinUI 3 的视觉效果；磨砂侧栏和输入框是 Web 效果。macOS 上可选的桌宠气泡 Liquid Glass 使用原生材质。

能做什么？

功能	你能得到什么
macOS 风格设置界面	圆角分组、细分隔线、小型开关、磨砂侧栏，以及随当前分区变化的标题
Windows WinUI 3 风格设置界面	带强调色指示条的导航、设置卡片、小圆角控件与 Mica 风格的底色层次
🎨 27 个浅深色主题选项	浅色 10 个、深色 17 个，包含 Catppuccin、Nord、Dracula、Tokyo Night 等配色与蓝鲸原创主题；查看主题轮播
🖌️ 自定义配色	分别调整浅色和深色模式的强调色、背景色、文字色，自动派生界面表面和边界颜色
🖼️ 纯色、渐变与图片背景	三套渐变或自己的 PNG、JPEG、WebP 图片；可调整图片布局、背景遮罩和图片模糊
🌈 从壁纸生成配色	提取图片中的候选主色，选择后生成配套的浅色与深色方案
🔤 界面与代码字体	读取本机字体，分别选择界面字体和代码字体；正文字号沿用 Harness 的设置
磨砂与阅读设置	可开启输入框磨砂，或减少透明效果、使用实色表面
💾 立即生效与自动保存	调整后直接看到变化，设置自动保存，重新打开后继续使用
🐋 可选蓝鲸桌宠	随任务切换动作、显示进度气泡，也能拖动、打招呼和跟随鼠标注视

浅色、深色或跟随系统均可选择，两种模式分别保留自己的配色。配色来源和许可见主题预设说明。

使用前你可能想知道

	说明
免费开源	MIT 许可，可以查看源码、修改和贡献
外观和桌宠分别控制	可以只使用外观美化，也可以单独保留桌宠
本机保存	插件主题配置和导入的壁纸保存在本机；图片导入后会复制到插件数据目录
使用现有 Harness	无需修改 Harness 安装包，保留原有设置操作和控件交互
随时恢复外观	关闭“启用外观美化”，撤销插件的设置样式、主题配色、字体和背景覆盖

快速上手

需要安装并启动过一次 DeepSeek Harness 官方 Desktop。当前基于 Harness Desktop 0.2.0-rc.2 验证。

1. 安装并启用插件

打开 Harness：侧栏 → 插件 → 添加插件，选择一种安装方式：

安装方式	填入内容
npm 包名	`dsh-cyberwhale`
仓库地址	`https://github.com/CyberWei922/dsh-cyberwhale`
Release 压缩包	Releases 中 `.tgz` 的下载直链或本地路径

插件卡片名称为 Harness 美化与桌宠。安装完成后点击立即启用。如果没有出现新增的设置页，完全退出并重新打开 Harness。

1.0 正式版包含双端视觉本地化、主题、壁纸与字体功能。当前修正版为 1.0.2，改进 Windows 设置样式与下拉框交互，修复下拉滚动和背景切换问题；从旧版升级时，请指定 dsh-cyberwhale@1.0.2，升级方法见下方常见问题。

应用内安装无需额外安装 Node.js。只有命令行安装或开发才需要 Node.js 22+；从仓库安装还需要可用的 git。

2. 打开主题设置

进入 设置 → 主题，开启“启用外观美化”：

选择浅色、深色或跟随系统。
分别选择浅色、深色主题，也可以自定义三种基础色。
根据喜好选择界面字体和代码字体。
在“背景”中选择纯色、渐变或图片。
按需要开启输入框磨砂，或减少透明效果。

修改立即生效并自动保存。 macOS 和 Windows 会自动使用各自的设置界面，无需手动选择平台样式。

3. 按喜好搭配

想要的效果	可以这样设置
接近系统界面的简洁外观	使用纯色背景和系统默认字体，开启平台设置样式
熟悉的编辑器配色	选择 Catppuccin、Nord、Tokyo Night 等主题，并搭配自己的代码字体
壁纸与界面颜色协调	上传图片，展开“从图片生成配色”，选择一个主色应用配套方案
更清楚的阅读表面	提高背景遮罩，或开启“减少透明效果”
有任务状态陪伴	到“设置 → 桌宠”开启蓝鲸和气泡提示

命令行或本地开发安装

先完全退出 Harness，再安装本地目录。以下命令使用官方默认安装位置，自定义安装请替换路径。

git clone https://github.com/CyberWei922/dsh-cyberwhale.git
cd dsh-cyberwhale
npm ci
npm run build:client

macOS：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add "$PWD"

Windows PowerShell：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add "$($PWD.Path)"

这种方式用 link: 指向工作目录，适合开发。客户端源码修改后重新构建，再刷新或重启 Harness。

支持的平台

平台	设置界面	主题、壁纸与字体	蓝鲸桌宠
macOS	macOS 系统设置风格	支持	支持；macOS 26+ 可选原生气泡 Liquid Glass
Windows 11 x64	WinUI 3 风格	支持	支持，使用普通气泡

新版已在 macOS 和 Windows 11 x64 上确认日常使用正常。其他 Windows 版本、Windows ARM64 和 Linux 尚未完成验证；桌宠的混合 DPI 跨屏拖拽、显示器热插拔等边界场景见 Windows 验证范围。

可选的蓝鲸桌宠

一只随 Harness 工作状态变化的蓝色大肥鱼：任务开始时工作，等待确认时停下来，完成后跳跃庆祝。气泡显示会话标题和当前任务进度，待机时安静陪伴。

蓝鲸招手动画

透明桌面窗口中的招手动作。

操作	效果
设置 → 桌宠 → 启用桌宠	显示或隐藏蓝鲸
按住身体拖动	移动桌宠，记住位置
右键 → 打个招呼	播放招手动画
设置 → 桌宠 → 显示大小	调整桌宠大小
设置 → 桌宠 → 气泡提示	显示或隐藏任务气泡
设置 → 桌宠 → 眼睛跟随鼠标	控制待机时的鼠标注视
设置 → 桌宠 → 重置位置	找回移到边缘的桌宠

眼睛跟随仅在待机、鼠标停在身体上时生效，最多持续 10 秒。退出 Harness 时桌宠一起退出。多个会话共用桌宠状态。

桌宠运行环境

外观美化在 Harness 内运行；桌宠需要额外的独立 Electron 运行时。本机已有可用缓存时自动复用，没有时到 设置 → 桌宠 → 准备运行时 下载，压缩包约 100–150 MB。

下载源可选国内镜像（默认，npmmirror）或官方源。准备完成后开启桌宠即可；只使用外观美化时，可以关闭桌宠并跳过运行时准备。

在 macOS 26 及以上，可单独开启“气泡液态玻璃”。Windows、旧版 macOS 及系统减少透明等不支持条件下使用普通气泡。

设计理念

首先贴近系统，再留出个性化的空间。

两端采用各自熟悉的导航、控件比例和材质层次，共用主题、壁纸和字体设置。用户不必迁就一套与桌面风格差异很大的界面，也可以按个人习惯调整配色和阅读环境。

保留操作习惯：沿用 Harness 的设置入口和控件行为，保持键盘操作与焦点反馈。
把内容看清楚：为文字和控件调整颜色对比度，提供背景遮罩与减少透明设置。
功能各取所需：外观美化与桌宠分别控制，配置在本机保存。
保留退出方式：关闭外观美化撤销视觉覆盖，关闭桌宠结束它的独立窗口。

常见问题

可以只美化界面，不使用桌宠吗？

可以。在“设置 → 主题”开启外观美化，在“设置 → 桌宠”关闭桌宠即可。桌宠运行时只用于桌宠功能。

设置里没有“主题”或“桌宠”？

确认插件已安装并启用，然后完全退出、重新打开 Harness。只关闭主窗口可能没有结束后台进程。

开启后效果不明显，或者新版功能没有出现？

检查“启用外观美化”是否打开，以及当前安装的插件版本是否包含新版功能。其他主题插件也可能覆盖配色，排查时先单独启用 CyberWhale。客户端更新后需要刷新或重启 Harness。

磨砂和 Liquid Glass 都是原生效果吗？

设置侧栏、聊天背景和输入框的磨砂使用 Web CSS 实现；Windows 的 Mica 风格底色也是视觉模拟。macOS 26+ 的桌宠气泡 Liquid Glass 使用 Apple 原生材质，可独立开启。

如何更新或恢复官方外观？

在插件页卸载后重新安装新版，再完全重开 Harness。刚发布的版本可按更新说明指定版本安装。

关闭“设置 → 主题 → 启用外观美化”会撤销插件的视觉覆盖；Harness 自己的外观模式和正文字号继续保留。桌宠有独立开关。

设置和壁纸保存在哪里？

默认位于 macOS 的 ~/.dsh/dsh-cyberwhale/，或 Windows 的 %USERPROFILE%\.dsh\dsh-cyberwhale\。如果设置了 DSH_HOME，则使用该目录下的 dsh-cyberwhale/。

主题设置保存在 appearance.json，桌宠设置保存在 settings.json，导入的图片保存在 wallpapers/。图片导入后不依赖原文件位置，浅深模式共用一张壁纸。

桌宠没有出现，或准备运行时失败？

查看“设置 → 桌宠”的运行状态和错误提示。缺少运行环境时点击“准备运行时”，下载失败时尝试更换下载源；位置异常时点击“重置位置”。详见使用与排障和 Windows 安装指南。

反馈与贡献

遇到问题，欢迎提交 Issue，附上系统版本、Harness 版本、插件版本、复现步骤和截图。

欢迎贡献主题、平台样式和问题修复。开发资料见开发指南、Windows UI 开发说明和分发与发布。

如果这个插件让你的 Harness 用起来更舒服，欢迎给项目一个 Star 🐋

许可与致谢

本项目采用 MIT License。配色预设、图片取色等第三方内容见第三方声明和许可文件。

感谢 DeepSeek Harness 提供的插件与主题接口，以及各开源主题作者提供的配色。

dsh-cyberwhale

Installer

README