把整个 DeepSeek Harness 工作环境带走。
会话、设置、插件和工作区放在一起,复制一个文件夹就能继续工作。
官网 · 下载 · 开始使用 · 迁移 · 插件 · 帮助 · 简体中文 · English
最新版本 GitHub 下载量 跨平台构建状态 Apache-2.0 许可证
Note
DSH-Portable 是独立社区发行版,不是 DeepSeek 官方桌面应用。它内置经过适配和成品测试的官方 DeepSeek Harness 预览版本。
| 一个文件夹 | 换位置继续 | 更新不动数据 |
|---|---|---|
| 会话、设置、插件、桌面数据和默认工作区放在一起。 | 退出后复制到另一块硬盘、U 盘或相同平台的电脑,重新打开即可。 | 更新替换可再生的程序组件,保留你的会话、凭据、插件和工作区。 |
运行环境和插件工具随产品放在自己的目录内,目标电脑无需预装 Node.js 或 pnpm,系统 PATH 也不会被修改。Portable 仍提供独立窗口、系统托盘、最近会话、任务通知、窗口位置恢复和更新流程。
Windows 开启"任务通知"后,后台任务完成或需要回答、批准时会显示系统通知。完成通知可回复原任务;审批通知提供"拒绝"和"允许一次",简单单选问题可直接回答,复杂问题会打开对应任务。通知展开由 Windows 控制;任务栏图标统计尚未查看的完成任务,打开或回复后清除。
| 从哪里开始 | Portable 为你处理什么 |
|---|---|
| 联网使用 | 下载约 60 KB 的启动器,把它放到希望保存的位置后运行;它会在旁边自动准备并校验完整工作目录。 |
| 离线使用 | 完整 ZIP 自带官方 DSH、运行环境、插件市场和插件管理工具。 |
| 同平台换电脑或 U 盘 | 复制文件夹即可;启动时修正由 Portable 管理的旧路径。 |
| 只迁移个人数据 | 导出同一份迁移内容,可选择普通包或密码加密的私密包。 |
| 长期更新 | DSH-Portable 与官方 DSH 内核分开更新,均保留 data 和 workspace。 |
| 出现异常 | 内置只读检查、保留数据的精准修复和脱敏支持报告。 |
0.5 系列的 Windows 离线包约 58 MB,解压后约 44 个外层文件。官方 DSH 运行环境以一个经过校验的紧凑包随附,首次在本机准备,之后复用;会话、设置、插件和工作区仍在 Portable 文件夹中。这样保留完整插件运行时,也减少复制和更新要处理的小文件。发布门会检查压缩包体积、落地体积、文件数量和启动性能。
DSH-Portable 的桌面壳、便携目录、更新、修复和迁移流程由本项目维护;官方 DSH 是随包锁定并单独验证的上游内核。两者使用独立版本和发布节奏,Portable 功能版本不等于官方内核版本,任一方的新版本都应以对应 Release 说明为准。
聊天工作台、模型配置和通用设置沿用官方 DSH。Portable 的改动聚焦窗口与托盘、运行环境、更新、迁移和恢复;上游页面仅在 Portable 集成确有兼容问题时做必要适配。
插件市场和两个默认插件属于 Portable 集成组件;市场目录主要收录社区插件,收录不代表官方认可或安全审计。只有默认插件按锁定版本经过本项目的成品验证,其他插件请自行评估并按需安装。对应 Release 说明或验收范围没有列出的兼容性,不视为 Portable 的承诺。
- 下载 Windows 便携启动器。
- 把启动器放到希望保存的位置并双击运行,它会在旁边准备一个完整的
DSH-Portable文件夹。 - 在界面中连接模型。以后直接运行文件夹里的
DeepSeek-Herness.exe。
右上角关闭按钮默认把应用收进系统托盘,运行中的任务会继续。需要完全退出时,右键托盘图标并选择 退出 DeepSeek Harness。
| 适合你,如果... | 下载 |
|---|---|
| 想要可移动、自动准备的工作文件夹 | 便携启动器(推荐,约 60 KB) |
| 目标电脑无法联网,或需要手动解压 | 完整离线 ZIP |
| 电脑 | 便携 ZIP |
|---|---|
| Apple Silicon(arm64) | 下载 |
| Intel Mac | 下载 |
macOS 包采用临时签名,尚未经过 Apple 公证。首次打开若被阻止,请按住 Control 点按应用,再选择 打开。
| 电脑 | AppImage(推荐) | 完整便携目录 |
|---|---|---|
| Intel / AMD(x64) | 下载 | 下载 |
| ARM64 | 下载 | 下载 |
chmod +x DeepSeek-Herness-linux-x64.AppImage ./DeepSeek-Herness-linux-x64.AppImage
AppImage 的会话、设置、插件和工作区保存在旁边的 DSH-Portable-data 文件夹;移动或备份时把两者一起复制。
完整步骤、数据包迁移和无需第二台电脑的验证方法见跨电脑迁移指南。
- 从托盘选择 退出 DeepSeek Harness,等窗口和托盘图标消失。
- 在相同平台的新位置复制整个
DSH-Portable文件夹。 - 在新位置运行
DeepSeek-Herness.exe(Windows)或对应平台入口。
启动器会修正它管理的旧路径;你主动打开的外部项目仍保留原位置。两台电脑同步同一目录前,请先在两边完全退出,避免同时写入会话文件。
完整目录复制只适用于相同操作系统和 CPU 架构;更换操作系统或架构时,请下载对应目标包,再用数据归档迁移会话、设置和插件配置。原生插件依赖需在目标平台重建,外部 workspace 需自行搬迁或重新连接;跨操作系统恢复尚未通过成品验收。
打开 设置 → 插件 → 插件市场,可以搜索、筛选、查看项目主页,并安装、更新、停用或卸载社区插件。市场跟随 DSH 的中文/英文和明暗外观,不会为了安装插件静默中断正在运行的任务。
可选 Provider:Codex Subscription 可通过现有插件市场或标准 DSH 命令连接 ChatGPT/Codex 订阅;不会默认安装。
全新安装仅预装两个经过审核、可自行卸载的插件:Image Viewer 用于查看任务中的图片;已有的 Chat Manager 当前只补充官方界面暂未提供的归档会话恢复入口。其他社区插件仍按需从插件市场或通过标准 DSH 命令安装。普通升级会完整保留现有 Profile 及其中已安装或已移除的插件;如果你卸载了任一默认插件,后续启动或升级不会自动装回。
Windows 可双击 dsh.exe,或从托盘的 更多 → DSH 终端 打开;macOS 可从应用菜单打开 DSH 终端;Linux 可从托盘打开 DSH 终端。在这个专用终端里,按插件文档提供的标准 DSH 命令可以原样粘贴:
dsh plugin --profile web add <插件> dsh plugin --profile web list --depth 0 dsh plugin --profile web update <插件包名> dsh plugin --profile web remove <插件包名> dsh --profile web --dump-config
便携版的 DSH 终端只在当前窗口临时识别 dsh,不会修改系统 PATH。移动整个 Portable 文件夹后,新开的 DSH 终端会自动使用新位置,不需要修复环境变量。
能安全热加载的插件会立即生效,纯界面插件只需刷新;已经载入宿主代码的插件更新会标记为待重启。市场不会在任务运行时更新、卸载或偷偷重启 DSH。只安装你信任的插件。
- DSH-Portable 会先打开本地工作台;只有对应的"启动时检查更新"已开启时,才会在后台检查更新。产品更新与官方 DeepSeek Harness 内核更新各自独立,两个启动检查默认关闭;可在设置 → 通用设置 → 便携版分别开启或手动检查。
- 更新通道可选稳定版或候选版。稳定版适合日常使用;候选通道按实际成熟度提供 Alpha、Beta 或 RC,并且都必须先通过对应的 Portable 成品验证。切换通道不会自动降级当前版本。各阶段含义见发布阶段规则。
- 托盘菜单也提供两种手动检查;检查完成、等待选择和实际更新是不同状态,不会一直停在"正在检查"。
- 更新提示会明确写出正在更新 DSH-Portable 还是 DeepSeek Harness,并显示对应的当前版本和目标版本。
- 一般更新只下载变化的 DSH 应用组件,并显示真实下载百分比;会话、设置、凭据和工作区全部保留。
- 运行环境兼容性变化时,会直接下载经过验证的完整版本并原地更新,仍然保留用户数据。
- 可以选择稍后或跳过此版本;安装前会确认没有任务运行。替换内核前会先用新内核检查现有 Profile 和插件能否组合启动;不兼容时保持当前版本不变。更新后只有工作台真正就绪才会提交新版本,启动失败或超时会自动恢复更新前的程序,同时保留会话、设置、插件和工作区。
- 设置 → 通用设置 → 便携版 提供检查、修复和脱敏支持报告。报告包含最近两次从启动器进程创建到工作台可交互的完整分段轨迹,反馈启动慢或启动失败时请优先附上该报告,不要直接发送可能含登录令牌的原始日志。修复保留用户数据,只重建可再生组件。
官方 DSH 更新不必等待 DSH-Portable 功能版本,但也不会直接替换正在使用的工作环境。新版会先经过 Windows、macOS、Linux x64/ARM64 的完整成品测试;全部通过后才进入独立内核通道,失败则不发布。两条发布线的版本号和时间可以不同。
发布说明的写法和证据要求见 Release 写作规范。
正常更新会原地保留 data 和 workspace。需要迁入新的 Portable 环境时,可在设置 → 通用设置 → 便携版 → 数据与迁移选择「导出迁移包」或「导出加密私密包」。两者内容相同,都包含会话、设置、插件配置和 API 凭据;只有后者需要密码才能读取。未加密包只应保存在信任的设备上,它仍是带完整性校验的压缩容器而不是文本文件。运行时、缓存、日志和工作区文件不会被塞进迁移包。导入会恢复插件依赖并验证 Profile;任何失败都会自动恢复导入前的数据。
成品根目录的 DATA-MIGRATION.zh-CN.txt 提供中文检查和恢复命令;DATA-MIGRATION.en.txt 提供独立英文说明。恢复默认只补入缺失数据;明确选择覆盖时,先在 data/backups/ 生成回滚副本。
| 路径 | 内容 |
|---|---|
data/dsh-home/ |
设置、模型凭据、会话和插件 |
data/webview2/ |
Windows 桌面窗口数据 |
workspace/ |
默认工作区 |
data/logs/ |
本地服务与启动日志 |
DSH 具备本地代码执行能力,请只使用可信模型、插件和项目。本地服务只绑定 127.0.0.1,便携外壳默认关闭 DSH 遥测。data 可能包含 API 凭据和私人会话;请妥善保管,Windows 移动盘优先使用 NTFS。
查看完整的隐私说明、安全策略和代码签名策略。当前 Windows Release 尚未签名;SignPath Foundation 的开源签名申请正在进行中。
内置 DSH 0.1.2-rc.1 存在已知网络兼容限制:Clash/Mihomo 的 Fake-IP DNS 可能使 web_fetch 返回 WEB_BLOCKED_URL。相关进展见上游说明。
请勿在 Issue 中粘贴 API Key、登录凭据或私人会话。
DSH-Portable 使用标准 Apache-2.0 许可证。你可以使用、修改和再分发,但需要保留许可证、版权与变更声明。源码和每个平台的成品还会携带 NOTICE.md,明确标出本项目的规范来源与第三方组件边界。
修复和改进欢迎直接提交 Pull Request。开始前请阅读 CONTRIBUTING.md,避免重复实现官方 DSH 已有的能力。
从源码构建
./scripts/build-windows.ps1
bash scripts/build-macos.sh arm64 # 或 x64 bash scripts/build-linux.sh x64 # 或 arm64
依赖、发布内容和成品测试均由仓库固定。普通用户无需手动比较校验值;需要时可从 Release 下载 checksums.txt。新构建还会生成绑定源码提交和验收工作流的 GitHub/Sigstore 证明,高级用户可运行 gh attestation verify <下载文件> -R WSL043/DSH-Portable 验证来源。
如果 DSH-Portable 对你有帮助,欢迎点一个 Star。它会帮助更多需要便携 DSH 的用户找到这个项目。
DeepSeek Harness、DeepSeek 名称与标志归 DeepSeek 所有。DSH-Portable 由 WSL043 独立维护,未获 DeepSeek 背书。