dsh-desktop

下载 · 安装器说明 · GitHub · DeepSeek Harness

DSH Desktop 把官方 DeepSeek Harness 收进桌面窗口：安装后双击即可使用，不必先配 Node 环境、也不必自己拉起 dsh web。

Windows 安装包在 ds.oykb.cn。

---

本地开发

pnpm install
pnpm start

第一次启动会检查旁边的 deepseek-harness：缺依赖就安装，缺构建产物就编译，然后在本机随机端口拉起 Web 服务，再由 Electron 打开。

---

功能

标题栏窗口按钮左侧的扳手会打开独立的工具窗口。

Codex 项目导入	扫描 Codex 工作区，把项目登记为 Harness 工作区，并把勾选的历史会话迁过来。项目文件留在原地，只引用原目录。
视觉插件	聊天里粘贴的图片会先经 Qwen-VL 转成文字，再交给当前模型；也可以针对某张图继续追问。
归档管理	侧边栏里删掉的工作区实际是归档。记录和会话都还在，这里可以恢复。
检查更新	对照发布基线检查新版本，下载安装包后覆盖安装并重启。开发模式下只检查、不自动更新。
Web 远程控制	用手机浏览器打开电脑上正在跑的 DSH。同一 Wi-Fi 可直连；也可以走 Cloudflare 隧道，4G / 5G 同样能进。

主窗口和工具窗口都支持选中文本，以及右键复制、粘贴、剪切、全选。

---

安装与打包

安装器是一个 Go 写的 Win32 程序：窗口立刻出来，安装包里的文件不经过压缩，按所选目录直接写出。界面和桌面应用用同一套海洋蓝。

流程是三步：选目录，看进度，完成后可选择立刻启动。

打 Windows 安装包：

pnpm dist:win

这一步会先构建本地的 deepseek-harness，再把它覆盖到锁定版本的 npm 内核上。装出来的应用跑的是这份源码里的 Harness，包括视觉插件和模型设置上的改动。

安装包的文件布局、界面尺寸和实现细节写在 INSTALLER.md。

---

工具说明

Codex 项目导入

选一个 Codex 工作区后，会按 package.json、Cargo.toml、pyproject.toml 这类标记找出项目，并配上目录里对得上的历史会话。同名项目、已经导入过的会话会先提示。

导入时不会把项目拷走，只是把原目录登记成工作区，再把勾选的会话写成 Harness 认识的日志。主窗口刷新后，侧边栏里就能看到迁过来的对话。

检查更新

更新面板会显示当前版本、发布基线，以及内置的 @deepseek-ai/dsh 版本。确认更新后下载安装包（带校验），由安装器写入原目录并重启。

视觉插件

默认开启。在工具区填入 DashScope API Key，并指定视觉模型和接口地址。地址需要是 OpenAI 兼容接口（以 /compatible-mode/v1 结尾），模型建议用 qwen-vl-max。

开关、模型和地址马上生效；密钥写在本机凭据里，改完不必重启。

视觉桥的设计参考了 QwenLM/Qwen-MM-Plugins（Apache-2.0）。

归档管理

工作区从侧边栏消失后，记录和会话日志都还留着。工具区可以按工作区或单条会话恢复。

Web 远程控制

电脑端的 DSH 开着时，手机浏览器可以打开同一套界面，查看和操作都跟本机同步。

两种通道，按需要打开：

• 局域网：手机和电脑连同一 Wi-Fi 或热点。面板会给出本机地址和二维码。第一次开的时候，如果 Windows 弹出防火墙提示，勾选「专用网络」并允许访问。
• 公网：走 Cloudflare 隧道，手机用流量也能进。隧道地址每次启动可能变化，面板里点「刷新链接」即可。

链接里已经带好访问令牌，请不要转发给别人。令牌可以重置，重置后旧链接立刻失效，需要重新复制或再扫一次码。端口也能改，改完重新打开开关即可。