H2O-MERO/DeepSeek-Harness-GUI

README 摘要

DeepSeek Harness 便携版（Electron 封装） 把 DeepSeek Harness 的 Web UI （即 npx @deepseek-ai/dsh web 提供的浏览器界面）封装为 免安装的 Electron 桌面应用 ： - 免安装、免环境 ：内置便携版 Node.js 运行时与全部 @deepseek-ai/dsh 依赖， 目标机器无需安装 Node.js / npm，解压后双击即可使用； - 数据留在应用目录 ：对话记录、设置、API 密钥、配置等全部保存在应用目录下的 data\ 中，随应用文件夹一起移动/备份； - 自包含离线 ：Web 前端资源与全部依赖随包分发，除调用大模型 API 外不需要联网。 一、直接使用（已构建产物） 1. 打开 dist\DeepSeek-Harness\ 目录（或解压 dist\DeepSeek-Harness-portable-win-x64.zip ）； 2. 双击 DeepSeek-Harness.exe ； 3. 首次启动会初始化配置（十几秒），随后进入 Web 界面； 4. 在界面“设置 → Models”中配置模型与 API 密钥即可开始对话。 整个 DeepSeek-Harness\ 文件夹就是应用本体：拷到 U 盘 / 移动硬盘 / 其他电脑均可直接运行。 提示：未签名的便携 exe 在陌生电脑上可能触发 SmartScreen，选“更多信息 → 仍要运行”即可。 二、数据目录（全部在应用目录内） 数据根固定为 data\dsh （不继承外部 DSH HOME ，保证便携性一致）；如需放到其他位置，可设置环境变量 DSH PORTABLE DATA 。 三、工作原理 四、从源码构建 开发调试： npm start （需先执行一次 npm run prepare-runtime ）。 自动冒烟测试：设 DSH ELECTRON SMOKE= 后启动，应用加载成功会截图并自动退出。 五、升级内置 dsh 版本 脚本会更新 runtime\server\package.json 依赖版本、重新安装依赖并重新打包。 六、常见问题 - 端口被占用 ：应用会自动尝试 3080–3099；仍失败会显示错误页，可打开日志排查。 - 界面打不开/报错 ：查看 data\logs\server.log 与 data\logs\electron.log 。 - exFAT U 盘 ：dsh 需要在数据目录创建目录联接（junction），exFAT 不支持； 请放在 NTFS 分区，或用 DSH PORTABLE DATA 指向 NTFS 目录。 - 移动应用文件夹后 ：junction 会在下次启动自动重新指向新位置，无需处理。 - 残留服务进程 ：异常退出后 3080 被占用时应用自动使用下一端…

分类