dsh-portable

DeepSeek Harness 免安装便携版（Windows）构建工程

DeepSeek Harness 的 Windows 免安装便携版：内置官方 Node.js 与全部程序包，解压后双击启动器即可使用，无需安装任何软件。

本仓库提供启动器源码（C#）、一键构建脚本与使用文档。 快速使用

从 Releases 下载最新压缩包，解压后双击「启动 DeepSeek Harness.exe」即可使用（默认端口 3081）。 仓库内容

从源码构建 环境要求 64 位 Windows 10 / 11（构建与运行均需） 网络连接（下载 Node.js 与 npm 依赖）

无需安装任何开发工具：Node.js 由脚本自动下载，C# 编译器使用 Windows 自带的 csc。 一键构建

国内网络加速：

脚本执行：

1. 下载官方 Node.js（默认 v24.19.0）并取出 node.exe； 2. 用 npm 扁平安装官方发布包 @deepseek-ai/dsh@0.2.0-rc.2（--ignore-scripts，产物为纯真实目录、零链接）； 想用 alpha 标签的预览版本可传 -DshVersion "0.2.1-alpha.1"； 3. 用系统自带 csc 编译 launcher.cs 生成 启动 DeepSeek Harness.exe； 4. 复制文档，组装出 dist\ 便携目录（可选 -Zip 打包）。 手动构建（等价步骤）

使用方法

1. 把构建产物（或 Releases 下载的压缩包）解压到任意位置（路径可含中文）； 2. 双击 启动 DeepSeek Harness.exe； 3. 浏览器自动打开 http://127.0.0.1:3081，按页面提示配置模型服务（如 DeepSeek API Key）后即可使用； 4. 关闭弹出的黑色命令行窗口即停止服务。 自定义端口：目录下新建 port.txt 写入端口号即可（默认 3081）； 命令行启动：node.exe node_modules\@deepseek-ai\dsh\lib\bin.js web。 工作原理 启动器（launcher.cs）通过 DSH_HOME 环境变量把用户数据根指向自身 data\ 目录，实现数据完全隔离（不读写系统用户目录）； 0.1.2-alpha 起 Web 界面启用一次性 token 鉴权，直接访问 http://127.0.0.1:3081 会返回 401；启动器捕获 node 输出的 dsh web: http://.../?token=... 并打开该地址，浏览器换取 30 天会话 cookie 后后续启动照常（node 输出同步写入 dsh-console.log）； 首次启动由官方 dsh web 自动初始化配置（data\profiles\web）并重建内部链接，全程无需联网； node_modules 采用 npm 扁平安装（零 junction/symlink），因此 git clone、ZIP 解压、文件夹拷贝三种方式均不会产生损坏链接，这是"拷贝即用"的关键（pnpm 默认布局含数万个链接，分发后必然失效）。 注意事项 官方标注 DeepSeek Harness 为开发者预览版，迭代快，可能存在破坏性变更； Agent 可能修改文件、执行命令，请从测试目录开始使用； 模型 API 与联网搜索需要网络；离线时可启动程序但无法调用模型； 仅支持 64 位 Windows 10 / 11； 本工程为官方 npm 发布包的 Windows 分发封装，非官方制品；许可证 MIT（见 LICENSE 与 THIRD_PARTY_NOTICES.md），版权归 DeepSeek AI 及其贡献者所有。 相关链接 官方项目：deepseek-ai/deepseek-harness 官方 npm 包：@deepseek-ai/dsh