前言¶
DeepSeek Harness（DSH）基于插件架构运行。whale-desktop-kit 是一套由 z-time-007 维护的自用增强插件与原生桌面应用，旨在将 DSH 转化为一个具备桌面软件特性的工作环境。
核心功能¶
该插件集提供以下核心能力：
* 桌面体验：支持本地壁纸导入、透明度调节、玻璃质感与模糊效果，提供顶部快捷栏（dock）与黑鲸鱼桌宠。
* 数据源：提供 DeepSeek 余额与当前会话的 Token 用量数据接口。
* 文档处理：支持 Word、PowerPoint、Excel 文档的安全读取。
* 个人助理：提供本地秘书功能（清单、便签、摘要）及文档生成工具。
* 安全策略：对只读类工具调用提供安全自动批准，减少打断。
* 原生应用：构建为原生 Electron 桌面应用，支持系统托盘与贴边隐藏。
安装与配置¶
安装前需确保环境已安装 Node.js（≥ 22）、pnpm 和 git。
一键安装：
执行以下命令即可完成依赖安装、插件打包、安全扫描及原生应用构建。
git clone https://github.com/z-time-007/whale-desktop-kit.git
cd whale-desktop-kit
powershell -ExecutionPolicy Bypass -File install.ps1
前置依赖：
* 壁纸功能需要安装 sharp 图像库。
* 个人助理功能需要配置固定工作区（workspaceRoot）或设置环境变量 DSH_ASSISTANT_WORKSPACE。
使用方法¶
安装完成后，可通过以下方式使用：
- 启动应用：双击桌面快捷方式
DeepSeekHarness.exe启动，应用会自动检查并启动本地 DSH 后端。 - 更换壁纸：进入设置 -> 壁纸，选择「从本地导入壁纸」或从收件箱扫描；拖动滑块调整模糊、玻璃质感或透明度。
- 调整透明度：在设置 -> 壁纸中，拖动「对话框不透明度」和「工作区不透明度」滑块（0 = 完全透明，100 = 完全不透明）。
- 桌宠交互：点击顶部 dock 的鲸鱼图标打开桌宠；拖动鲸鱼到桌面任意位置；点击鲸鱼查看余额与 Token 数据；右键菜单可刷新或关闭。
- 快捷栏：鼠标移动到屏幕顶部唤起 dock，点击图标切换侧边栏、详情栏或壁纸开关。
- 系统托盘：右键系统托盘的鲸鱼图标，可控制显示/隐藏、设置开机自启或退出。
注意事项¶
- 兼容性：适配 DeepSeek Harness 0.1.0-rc.6。
- 授权范围：代码遵循 MIT 协议，但 DeepSeek 鲸鱼 Logo 不在授权范围内，不可用于商业用途。
- 构建路径：原生桌面应用构建需在
desktop/目录下运行 Build 脚本，产物位于desktop\dist\DeepSeekHarness\DeepSeekHarness.exe。
