deepseek-harness-orb

把 dsh 从「打开浏览器」变成「随手召唤」的桌面悬浮球。

解决什么问题

DeepSeek Harness 很强，但它是一个 Web UI：要切窗口、要打开浏览器，才能发一条指令。DeepSeek Orb 把 dsh 变成一个常驻屏幕边缘的悬浮球——悬停展开、点击钉住、拖拽可停靠成边缘灰色小标签，随时说话随时用。

更关键的是它用双轨代理架构解决了「简单操作」和「复杂任务」两类请求的冲突：

• 前台轨 · Computer Use：打开应用、点按钮、填表单、改设置这类可见操作，直接在当前窗口用 13 个 GUI 工具执行（click / input_text / scroll / hotkey / drag / screenshot / open_app 等），每一步都基于最新截图，模型始终看到当前屏幕状态；天气、新闻这类速查直接用 web_search / web_fetch 在球上回答。
• 后台轨 · Code Agent：翻文件、生成 Word/PPT/Excel、做网站这类复杂任务通过 code_agent 派发到后台标准会话，派发立即返回、不阻塞对话；后台结束且球空闲时，完成摘要自动回到球上，再由 Computer Use Agent 决定下一步（继续点击、再派发、或收尾）。

没有独立的运行时任务分类器——由球内的 Computer Use Agent 自行判断每条消息走哪条轨。

其他要点

• 主窗口保留完整 dsh Web UI：会话管理、插件市场、模型设置一应俱全，仍可写代码、改文件、跑命令。后台会话就出现在侧栏的 dsh_orb 目录里，可打开、继续、停止；球的 Stop 只取消球的 Computer Use 会话，不影响后台任务。
• 两条轨各自选模型与思考等级（默认 DeepSeek-V41-Flash + Max thinking），右键菜单可切坐标编码方式（Windows 毫弧度 / macOS 像素）、选区工具条开关，球头像可换成自定义 GIF/PNG/WebP。
• 选区工具条：任意应用里划词即弹出 搜索（Bing）/ 翻译（结果写入当前对话）/ 发送给代理。
• Access 权限档位：只读 / 工作区编辑 / 完全访问（默认完全），对球的命令及其派发的后台会话同时生效。
• 无遥测采集。

适合谁

• 想要「不离开当前窗口就能指挥 AI 动手」的 macOS / Windows 桌面用户；
• 已经在用 DeepSeek Harness / dsh CLI，希望获得常驻桌面入口与后台长任务派发的开发者；
• 需要 AI 帮忙跨应用完成 GUI 操作（填表、改设置、批量点击）的效率工作者。

Linux 仅主窗口可用，无悬浮球；Windows 上以管理员身份运行的窗口无法被点击或输入；macOS 首次展开面板需授予「屏幕录制」与「辅助功能」权限。运行前请先阅读 SAFETY.md 安全须知。

说明：本项目为社区非官方项目，与 DeepSeek AI 无隶属关系。

快速开始

git clone https://github.com/mini-yifan/deepseek-harness-orb.git
cd deepseek-harness-orb
pnpm install
pnpm run dev:desktop

前置条件：Node.js ^22.19.0 || >=24.0.0、pnpm 11.7.0，以及一个 DeepSeek API Key（启动后在主窗口 Settings → Models 保存，或提前 export DEEPSEEK_API_KEY=…；密钥存放在 ~/.dsh/.credentials.yaml，与 dsh CLI 共用）。打包命令与平台细节见仓库内 MAC-RELEASE-PACK.md / UNSIGNED-MAC-PACK.md / UNSIGNED-WIN-PACK.md。