pig1et7/DeepSeek-Harness-Desktop

README 摘要

DeepSeek Harness Desktop 把 DeepSeek Harness 的 Web GUI（ dsh web ）打包成 Windows 桌面应用： 双击即用 ，无需在终端输入 npx @deepseek-ai/dsh web 。 当前版本：1.0.3 —— 新增文件上传插件（📎 上传图片/Word/PDF，Agent 可读取）。 完整版本历史见 CHANGELOG.md。 特性 - 🚀 双击启动：自动查找/启动 dsh web 服务，并在原生窗口打开界面 - 🔄 智能端口处理： - 若 127.0.0.1:3080 已有 DSH 实例在运行 → 直接复用，不重复启动 - 否则在 3080 起依次找空闲端口自行启动服务 - 🧹 生命周期自管理：关闭窗口即退出应用并停止 自己启动 的服务（复用别人的服务时不会误杀） - 📄 服务日志写入 %APPDATA%\DeepSeek Harness Desktop\logs\server.log - 🔍 启动失败时给出错误页 + 日志 + 重试按钮 - 📦 可打包为免安装的单文件 portable exe - 📎 文件上传插件 （1.0.3 新增）：输入框左侧上传图片 / Word / PDF / 文本， Agent 通过 uploaded files / read uploaded file 工具读取内容（见下文专章） 版本日志 版本 说明 1.0.3 文件上传插件（📎 上传 + docx/pdf 文本提取 + Agent 工具 + 一键安装脚本） 1.0.2 图标更新（DeepSeek 卡通娘 v2） 1.0.1 图标更新（DeepSeek 卡通娘） 1.0.0 初始版本：桌面套壳应用 详细变更见 CHANGELOG.md。 工作原理 DeepSeek Harness（DSH）本身是命令行工具： dsh web 会在本机启动一个 Web 服务器（默认 http://127.0.0.1:3080 ），托管整个 GUI（前端页面 + 后端 API + Agent 会话）。平时你需要手动执行命令、再开浏览器访问。本应用是一个 Electron 壳 ，把整个过程自动化： 1. 查找 dsh CLI ：按优先级查找（见下文「dsh 的查找顺序」），找不到时自动 回退 npx --yes @deepseek-ai/dsh 下载； 2. 端口探测 ：从 3080 起逐个检查，若已有 DSH 实例在运行则 复用 ，否则在 空闲端口 自行启动 服务（ node web --port ）； 3. 等待就绪 ：轮询页面，直到出现 DSH 的启动标记（ DSH BOOT ）； 4. 打开原生窗口 ：先显示加载页，就绪后加载真实 GUI； 5. 退出清理 ：关闭窗口即退出应用，并只停掉「自己启动」的服务，复用…

分类