GuitarBao/deepseek-harness-portable

DeepSeek Harness 便携版 · Windows x64

无需安装 Node.js 的 DeepSeek Harness 浏览器界面绿色版（zip 解压即用）。

下载：到本仓库右侧 Releases 页面下载
DeepSeekHarness-Portable-win-x64-v0.1.0-rc.6.zip（约 111 MB），解压后双击 Start.cmd 即可。
仓库本身只放文档与脚本，不包含二进制文件（体积太大）。

这是什么

DeepSeek Harness 是 DeepSeek 官方开源的智能体编程环境（
deepseek-ai/deepseek-harness）。
本仓库把它与 Node.js 运行时一起打包成免安装便携版：

- 引擎 @deepseek-ai/dsh 0.1.0-rc.6
- Node.js v24.18.0（x64）
- 官方 DeepSeek API（api.deepseek.com），默认模型 deepseek-v4-flash

快速开始（给使用者）

1. 在 Releases 下载 zip 并解压到任意目录（建议英文路径）。
2. 双击 Start.cmd —— 服务最小化启动，浏览器自动打开 http://127.0.0.1:3080。
3. 首次使用需要 DeepSeek API Key（platform.deepseek.com 获取）：
在网页 Models 设置页填入，或手动在 home\.credentials.yaml 写入
DEEPSEEK_API_KEY: sk-xxxx。
4. 所有数据都在解压目录内：删目录 = 卸载；升级时把旧 home 目录覆盖到新版即可。

详细说明（目录结构 / 常见问题 / 隐私）见压缩包内的 README.md / README.en.md。

维护：如何重新打包（给仓库主人）

便携版 = node.exe + dsh 引擎全量 + 干净的 home 种子配置。在装有 dsh 的机器上
（npm 全局安装过 @deepseek-ai/dsh 且有 node.exe）运行：

powershell -ExecutionPolicy Bypass -File repackage.ps1

脚本会读取本机安装的 dsh 与 node.exe，重新生成暂存目录与 zip。之后把 zip 上传到
Releases（仓库页 → Releases → Draft a new release → 附加 zip）。

⚠️ 永远不要：把 home\.credentials.yaml、.anonymous-user-id、sessions、
storages 之类个人运行时文件打进包或传进仓库；本脚本已自动排除，但若你手工
复制 home 目录请务必注意。也可以给 GitHub 仓库建 Action 自动出包（见下）。

（可选）GitHub Actions 自动打包

把 repackage.ps1 的逻辑搬进 Actions 需要一台装有 dsh 的 runner；官方包发布渠道是
npm 与上游 GitHub Releases，本便携版适合在上游发布新版本后手动跑一次脚本更新。

目录结构（zip 内）

DeepSeekHarness-Portable/
├─ Start.cmd             启动入口
├─ node.exe              内置 Node 运行时
├─ dsh\                  Harness 引擎（lib + config + node_modules）
├─ home\                 用户数据：settings.yaml / .credentials.yaml / profiles / sessions
├─ workspace\            智能体工作目录
├─ README.md README.en.md LICENSE THIRD-PARTY-NOTICES.txt deepseek-harness.ico

许可

MIT License（见 LICENSE）。DeepSeek Harness © 2026 DeepSeek；Node.js © OpenJS Foundation
（MIT）。图标为 DeepSeek 官方图标，仅用于标识。