dsh-desktop-ball

dsh-desktop-ball

给 DeepSeek Harness 加一颗可自定义 图标和背景 的桌面悬浮球：点一下，在独立窗口里对话。

安装 ·

使用 ·

外观 ·

原理 ·

排查 ·

设置 ·

架构

| 桌面悬浮球 | 点开就是完整对话 |

| :--: | :--: |

| | |

这是什么

桌面悬浮球（Desktop Floating Ball / dsh-desktop-ball）是一个 DeepSeek Harness 插件。它在 Windows 桌面上放一颗可自定义的、置顶的小球，点一下就在独立窗口里打开 DSH 对话，不用切回主窗口。

如果你常常只是「想问一句就走」，它省掉的就是找窗口、还原窗口、再关掉窗口的那几步。

三个关键取舍：

• 不是主窗口的最小化版：小球是独立的系统级窗口，DSH 最小化、甚至主窗口在后台，它都还在。
• 不是浏览器窗口：聊天窗口内嵌 WebView2，没有地址栏、标签页、Edge 图标和翻译提示条。
• 不碰 DSH 本体：不修改 app.asar、不注入 Electron 主进程，升级 DSH 后插件可以独立保留。

特性

• 🖱️ 单击开窗，双击隐藏：隐藏只收起窗口，WebView 和当前对话都保留，再点一下立即恢复，不会重新初始化。
• 🎨 外观全可换：图标（图片 / GIF / 视频 / 纯色）、裁剪、形状、大小、聊天背景区域、消息颜色、助手名称。
• ⚡ 预热：鼠标移到球上，窗口已在屏幕外开始加载；点击时通常已经加载完成。
• 💰 余额速览：鼠标在球上停留 2 秒，实时查询并显示 DeepSeek 账户余额与赠送余额。
• 🧠 输入区与主界面一致：模型、权限、推理等级、关闭思考，图片 / 附件上传、拖拽与剪贴板粘贴截图，流式回复与停止。细节见 [输入区](docs/composer.md)。
• 🌐 界面语言：跟随 DSH / 中文 / English，只影响插件页面与快捷窗口文案。
• ✅ 提问和审批不出窗：ask_user_question 卡片与 approval/request 都能在小窗内处理，主窗口和快捷窗口谁先响应谁生效。
• 🪟 自动回退：缺少 WebView2 时退回 Edge / Chrome --app 窗口；macOS / Linux / 浏览器用 Alt + Q 打开应用内面板。

安装

要求：Windows 10/11 + DSH Desktop（dsh >= 0.2.1-rc.2 < 0.3.0）。

方式 A：从插件页安装（推荐）

1. 打开 DSH Desktop，侧边栏进入 Plugins / 插件。

2. 选择从本地路径安装，填入本目录的绝对路径。

3. 启用 dsh-desktop-ball 组合包，按提示重启应用。

4. 重启后桌面右下角出现悬浮球，DSH 侧边栏不会再添加旧入口。

方式 B：用 CLI 安装

在包目录下执行：

dsh plugin --profile desktop add .

desktop 是桌面版占用的 profile 名。命令会把本目录以 link: 方式写入 profile，并把 dsh-desktop-ball 追加到 dsh.profile.bundles。

只检查配置层、不启动：

dsh --profile desktop --dump-config

输出中应出现 id: quick-chat 与 name: dsh-desktop-ball。

方式 C：手动加入 profile（进阶）

插件页安装不可用时：

1. 完全退出 DSH Desktop。

2. 用 DSH 自带的 pnpm 把目录链接进 profile：

   $node = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"
   $pnpm = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\pnpm\bin\pnpm.cjs"
   & $node $pnpm add "link:<本目录绝对路径>" --dir "$env:USERPROFILE\.dsh\profiles\desktop"

3. 打开 %USERPROFILE%\.dsh\profiles\desktop\package.json，在 dsh.profile.bundles 数组末尾加入 "dsh-desktop-ball"。

4. 重新打开 DSH Desktop。

改 profile 前先备份 package.json；不确定时优先用方式 A。

使用

| 操作 | 效果 |

| --- | --- |

| 点悬浮球 | 打开 / 置顶桌面聊天窗口 |

| 双击悬浮球 | 隐藏聊天窗口（保留 WebView 与对话） |

| 拖动悬浮球 | 移动并记忆位置；距屏幕边缘 26px 内松手会吸附，留 4px 缝隙 |

| 拖动窗口任意边 / 四角 | 缩放聊天窗口，最小 360×480，尺寸自动记忆 |

| 窗口顶栏 — / 图钉 / 新建 / ⋯ / ✕ | 最小化到球 / 切换置顶 / 打开新对话 / 更多菜单 / 关闭窗口 |

| Alt + Q | 在主界面内展开 / 收起应用内面板 |

| Enter / Shift + Enter | 发送 / 换行 |

| 运行中的方块按钮 | 停止当前生成 |