开源项目（MIT 协议），源码公开可审计。
一、这是什么？
DeepWhale Desktop（深鲸桌面）是一个把DeepSeek Harness（DSH）的 Web UI 装进原生桌面窗口的跨平台桌面壳。
- 不用开浏览器、不用记命令行——双击图标就能用上 DSH
- 自带背景皮肤、桌面宠物、用量/额度面板等增强功能
- 支持macOS / Windows / Linux三平台
- 永久免费、开源、无任何收费功能（MIT 协议，源码完全公开可审计）
二、核心特性
🎨 背景皮肤（皮肤 = 背景图）
选一张喜欢的图片，一键覆盖整个界面：
- 深浅色模式都生效（浅色提亮、深色压暗，不改变 DSH 基础主题）
- 背景可见度可调（30%~100%），自动延伸到左侧工作区栏并做渐变过渡
- 换图即时生效，无需重启
🐾 桌面宠物
- 内置帧动画精灵"AI小助理"（192×208 精灵图）：空闲呼吸、挥手、跳跃、拖拽走路/快走/慢跑/快跑、周期"电脑前工作"
- 支持自制宠物：宠物工坊（SVG 实时编辑、导入图片自动去白底），或直接丢 GIF/SVG/PNG/JPG 进宠物目录
- 动画帧率、大小可调，可设置点击穿透
💰 用量与额度面板
- 右下角可折叠面板 + DSH 设置页"用量"栏：总余额 / 赠送 / 充值 / 今日请求 / 累计 tokens
- 绿色进度条展示余额充足度与额度构成，低余额自动提醒
- 面板可拖动，收起后是小药丸，不挡内容
🔒 API Key 安全
- 系统钥匙串（
safeStorage）加密存储，绝不落明文、绝不上传 - 配置入口：设置 → 用量 栏输入
sk-...保存；或在 DSH 设置页任意位置填入sk-开头的 Key 自动同步 - ⚠️用量监测需要先配置 API Key：不配置则余额面板不可用，但DSH 本身正常使用不受影响
- 🔍为什么需要 Key：余额/用量来自 DeepSeek官方接口
api.deepseek.com，官方接口要求用你自己的 Key认证——不是应用收集密钥。Key 用系统钥匙串加密存储在本机、只直连 DeepSeek 官方接口，源码完全公开可审计
🖥️ 原生窗口体验
- 启动即拉起/复用本地 DSH 服务，退出干净回收进程树（无孤儿进程）
- 关窗口最小化到托盘常驻，macOS 规范应用菜单
- 可选"退出时保留 DSH 服务"，下次启动秒开
三、快速上手
1. 下载安装
| 平台 | 安装包 |
|---|---|
| macOS（Apple Silicon） | DeepWhale-Desktop-xxx-arm64.dmg |
| macOS（Intel） | DeepWhale-Desktop-xxx-x64.dmg |
| Windows x64 | DeepWhale-Desktop-xxx-x64-Setup.exe |
| Linux | DeepWhale-Desktop-xxx-x86_64.AppImage/.deb |
下载地址：https://feely0208.github.io/deepwhale-desktop
2. 启动
首次启动会自动拉起 DSH 服务（窗口会显示"正在启动 DSH…"，约 10~60 秒），之后每次启动秒开（默认保留 DSH 服务）。
3. 配置 API Key（可选，用于用量监测）
设置 → 用量 → 输入sk-...→ 点"保存 Key" → 余额面板立即刷新。
四、常见问题
收费吗？永久免费、开源（MIT），无内购、无订阅、无广告。
需要注册登录吗？不需要。
用量面板没余额？在"设置 → 用量"里保存 API Key 后才会拉取余额。
为什么应用要我的 API Key？会不会有猫腻？余额数据来自 DeepSeek 官方接口，必须用你自己的 Key 认证；Key 由系统钥匙串加密存储在本机、只发给 DeepSeek 官方接口，源码全部公开（MIT），任何人都可以审计代码验证——绝无收集密钥行为。
和 DeepSeek Harness 什么关系？社区桌面壳，基于 DSH 构建，并非 DeepSeek 官方产品。
五、获取与交流
- 🏠 主页：https://feely0208.github.io/deepwhale-desktop
- 📦 GitHub 仓库：https://github.com/feely0208/deepwhale-desktop
本项目是基于 DeepSeek Harness 构建的社区桌面版本，并非 DeepSeek 官方产品，也不代表 DeepSeek 官方立场。
本项目完全开源免费。如果有人向您以任何形式出售此软件，请拒绝交易。
