DeepSeek Harness Desktop

基于 Electron 的 DeepSeek Harness 微信风格桌面客户端。

将 dsh 封装为本地桌面应用：左侧为「项目-会话」列表，右侧为完全自绘的微信风格对话窗口，完整接入 dsh 的官方 API（历史、流式回复、审批、计划、附件、模型切换等）。

⚠️ Vibe Coding 项目声明：本项目使用 ZCode + DeepSeek 进行 Vibe Coding 开发（AI 辅助迭代开发），可能存在 Bug 或设计不完善之处。欢迎提交 Issue / PR 一起改进。

界面预览

功能特性

• 微信风格三区界面：图标栏 + 项目-会话树 + 对话窗口（支持折叠列表）
• 完全自绘对话界面：气泡消息、Markdown 渲染（代码高亮/表格/引用）、乐观渲染（发送立即上屏）、流式打字、思考中 Loading
• 连接管理：自动发现本机 dsh 实例（3080 起扫描）、启动新实例（全局安装版 / 仓库克隆版 / 自定义命令）、记住上次连接
• Agent 交互面板：权限审批（允许一次/拒绝）、提问面板、计划审批面板（plan-review）
• 执行模式：工作 / 计划 / 无审查（延迟生效，切换后下一次发送时携带模式命令）
• 对话操作：右键编辑（steer 重试）/ 删除 / 引用回复，被操作消息折叠展示
• 基础能力：图片附件、模型切换、会话统计（轮/步/耗时/Token/缓存命中）、停止生成（保留已输出内容）、智能滚动
• 中文应用菜单、全链路日志（%APPDATA%\deepseek-herness-desktop\dsh-desktop.log）

安装与运行

前置要求

• Node.js（开发）
• 一个可用的 DeepSeek Harness 实例（dsh web，或使用应用内「启动新实例」）

直接使用

从 Releases 下载：

• DeepSeek Harness Desktop-<version>-setup.exe：NSIS 安装包
• DeepSeek Harness Desktop-<version>-portable.exe：免安装便携版

从源码开发

pnpm install
pnpm run dev        # 开发模式
pnpm run build:win  # 打包 Windows 安装包 + 便携版

技术架构

Electron 主进程
├── dsh-service.ts      实例管理（端口发现 / spawn / 就绪信号解析）
├── session-stream.ts   /api/events.mux WebSocket 事件流 + RPC 封装
├── menu.ts             中文应用菜单
└── window.ts           主窗口（微信风格壳）
渲染进程（自绘 UI）
├── 左侧：项目-会话树（workspace.list + session.list 轮询）
└── 右侧：对话窗口（session.history 折叠 + 事件流渲染 + prompt 发送 + respond 应答）

数据链路完全走 dsh 官方 HTTP/WS 协议：/api/* unary RPC + /api/events.mux 下行事件流。

相关

• DeepSeek Harness

License

MIT