dsh-harbor 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-harbor 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-harbor 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-harbor 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/8/18。

桌面港 zoec21331311/dsh-harbor

DeepSeek Harness

zoec2133131174 天前有提交已提供中文文档扫描：高危

在 GitHub 查看 ↗

双击即用的桌面客户端，免装环境自动拉起服务

26/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/7 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add zoec21331311/dsh-harbor

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · security

装得上吗

本站尚未做安装检查

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 74 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

🔴 安全扫描发现高危能力自动 · 静态分析源码

v2.7.0

🔴 扫描：高危尚无人工评估

静态扫描发现安装期即执行代码，或命令参数由运行时变量拼接（参数来源无法静态判定，从严处理）。

安装时即执行脚本可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 22 处，展示前 22 条）

写入本地文件
src/main.js:23
try { fs.mkdirSync(app.getPath('userData'), { recursive: true }); } catch { }
写入本地文件
src/main.js:24
const fsLog = fs.createWriteStream(path.join(app.getPath('userData'), 'dsh-harbor.log'), { flags: 'a' });
发起网络请求
src/main.js:41
const req = http.get(url, { timeout: 2000 }, (res) => {
读取本地文件
src/main.js:70
if (fs.existsSync(unpacked)) return unpacked;
读取本地文件
src/main.js:73
return fs.existsSync(p) ? p : null;
读取本地文件
src/main.js:82
if (fs.existsSync(bundled)) return bundled;
执行外部命令来自配置/变量
src/main.js:96
const child = spawn(command, cmdArgs, {
执行外部命令固定命令
src/main.js:131
try { execFile('taskkill', ['/pid', String(child.pid), '/T', '/F']); } catch { }
读取本地文件
scripts/patch-native-picker.js:25
const source = fs.readFileSync(target, 'utf8');
写入本地文件
scripts/patch-native-picker.js:34
fs.writeFileSync(target, source.replace(BUGGY, FIXED), 'utf8');
读取本地文件
scripts/download-node.js:18
if (fs.existsSync(path.join(runtimeDir, 'node.exe'))) {
发起网络请求
scripts/download-node.js:23
const res = await fetch(zipUrl);
写入本地文件
scripts/download-node.js:26
fs.writeFileSync(zipPath, buf);
读取本地文件
scripts/install-electron.js:18
if (fs.existsSync(exe)) {
发起网络请求
scripts/install-electron.js:23
const res = await fetch(url);
写入本地文件
scripts/install-electron.js:26
fs.writeFileSync(zip, buf);
写入本地文件
scripts/install-electron.js:30
fs.mkdirSync(dist, { recursive: true });
写入本地文件
scripts/install-electron.js:33
fs.writeFileSync(path.join(root, 'node_modules', 'electron', 'path.txt'), 'electron.exe');
读取本地文件
scripts/install-electron.js:34
console.log('完成:', exe, fs.existsSync(exe) ? 'OK' : '缺失!');
发起网络请求
scripts/test-dsh-host.js:21
const req = http.get(url, { timeout: 2000 }, (res) => {
读取本地文件
scripts/test-dsh-host.js:41
console.log('[test] dsh bin exists:', fs.existsSync(bin));
执行外部命令固定命令
scripts/test-dsh-host.js:46
const child = spawn('node', [bin, 'web', '--port', String(PORT)], {

扫描于 2026/11/1（0 天前） · 范围入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh@deepseek-ai/cordis-plugin-group@deepseek-ai/dsh-anonymous-user-id@deepseek-ai/dsh-atomic-write@deepseek-ai/dsh-bash-local@deepseek-ai/dsh-code-runtime@deepseek-ai/dsh-compaction@deepseek-ai/dsh-fs@deepseek-ai/dsh-invariants@deepseek-ai/dsh-output-retention@deepseek-ai/dsh-sandbox@deepseek-ai/dsh-scope

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

双击启动桌面客户端
免装环境
自动拉起服务

README

由 DeepSeek 最新模型翻译生成

DSH Harbor 零依赖、开箱即用的 DeepSeek Harness（dsh）Windows 桌面版（非官方项目）。用 Electron 把 DeepSeek Harness 官方 Web UI（dsh web）封装成原生桌面应用：安装包自带 Electron + Node（内置）+ dsh 全家桶，目标机器无需预装任何环境，下载即用。 ⚠️ 非官方项目：基于 deepseek-ai/deepseek-harness（MIT）的社区封装，不隶属于 DeepSeek 官方。项目解决什么问题 DeepSeek Harness（dsh）本身是命令行驱动的智能体框架：官方提供的交互方式是 - 在终端里敲 dsh web 启动本地服务； - 然后手动打开浏览器访问 http://127.0.0.1:3080。这对想直接使用的普通用户有几道门槛： | 痛点 | 说明 | | 需要自己装 Node.js 环境 | 官方依赖 npm/pnpm，安装配置有一定学习成本 | | 没有原生桌面应用 | 只能在浏览器标签页里使用，没有独立窗口、没有桌面集成 | | 启动步骤繁琐 | 每次都要先开终端跑命令，再找 URL 开浏览器 | | 缺少后台常驻能力 | 关掉浏览器标签页，会话状态和进程管理都不直观 | DSH Harbor 把这一切打包成一个文件：双击即用。

展开完整文档（README 剩余 1 节）

DSH Harbor

零依赖、开箱即用的 DeepSeek Harness（dsh）Windows 桌面版（非官方项目）。

用 Electron 把 DeepSeek Harness 官方 Web UI（dsh web）封装成原生桌面应用：安装包自带 Electron + Node（内置）+ dsh 全家桶，目标机器无需预装任何环境，下载即用。

⚠️ 非官方项目：基于 deepseek-ai/deepseek-harness（MIT）的社区封装，不隶属于 DeepSeek 官方。

项目解决什么问题

DeepSeek Harness（dsh）本身是命令行驱动的智能体框架：官方提供的交互方式是

- 在终端里敲 dsh web 启动本地服务；
- 然后手动打开浏览器访问 http://127.0.0.1:3080。

这对想直接使用的普通用户有几道门槛：

| 痛点 | 说明 |
| 需要自己装 Node.js 环境 | 官方依赖 npm/pnpm，安装配置有一定学习成本 |
| 没有原生桌面应用 | 只能在浏览器标签页里使用，没有独立窗口、没有桌面集成 |
| 启动步骤繁琐 | 每次都要先开终端跑命令，再找 URL 开浏览器 |
| 缺少后台常驻能力 | 关掉浏览器标签页，会话状态和进程管理都不直观 |

DSH Harbor 把这一切打包成一个文件：双击即用。 它内置了 dsh 的全部运行时，自动在后台拉起服务、自动打开原生窗口，并提供托盘、通知、开机自启等桌面级体验——让不懂命令行的人也能用上 DSH。

主要功能

| 功能 | 说明 |
| 🖥️ 原生桌面窗口 | 独立窗口加载官方 Web UI，无浏览器地址栏/标签页干扰 |
| 📦 零依赖安装 | 安装包自带 Electron + Node + dsh，目标机器无需预装任何环境 |
| 🚀 一键启动 | 双击即用：自动拉起 dsh web 服务并打开窗口，无需手动敲命令 |
| 🔁 智能复用已有服务 | 检测到 3080 端口已有 dsh 在跑（如浏览器版正在使用）则直接复用，与浏览器版共存、共用同一份 ~/.dsh 数据 |
| 💪 自愈能力 | 页面加载失败（如被复用的服务被关闭）时，自动重新拉起 dsh 并重载页面 |
| 🖱️ 系统托盘 | 关闭窗口最小化到托盘；托盘菜单：显示主窗口 / 在浏览器中打开 / 开机自启开关 / 退出 |
| 🔔 系统通知 | 服务就绪时弹出原生通知 |
| 🔒 单实例 | 重复启动只会聚焦已有窗口，不会开多个 |
| 🚦 优雅退出 | 托盘「退出」时自动关闭 dsh 子进程，不留后台残留 |
| 🚪 外部链接隔离 | 页面中的外部链接一律交给系统默认浏览器打开 |
| ⚙️ 开机自启（可选） | 托盘菜单一键开关，随系统登录自动启动 |

安装方法

以下三种方式任选其一：安装包（推荐普通用户）、绿色版（免安装便携）、源码安装（开发者）。

系统要求

- Windows 10 / 11（x64）
- 安装包 / 绿色版：无需安装 Node.js、npm、dsh 或任何其他依赖
- 从源码安装：需要 Git 与 Node.js（见方式三）

方式一：安装包（推荐）

1. 前往 Releases 下载 dsh-harbor-<version>-setup.exe；
2. 双击运行，按向导选择安装目录（默认即可）；
3. 安装完成后自动创建桌面快捷方式，双击 DSH Harbor 启动；
4. 首次启动会自动初始化 ~/.dsh/profiles/web（官方模板），随后在界面设置中填入模型 API Key 即可开始使用。

🛡️ 关于 SmartScreen 提示：安装包未做商业代码签名，Windows 可能提示"已保护你的电脑"。
点击 更多信息 → 仍要运行 即可。建议在 Release 页面核对文件 SHA256 校验值后再安装。

方式二：绿色版（免安装）

1. 下载 win-unpacked.zip（绿色版）；
2. 解压到任意目录（可放在 U 盘/移动硬盘随身携带）；
3. 双击 DSH Harbor.exe 直接运行，无需安装、不写注册表。

方式三：从源码安装（开发者）

适合想自己构建、二次开发或审查代码的用户。需要先安装 Git 与 Node.js（≥ 20，推荐 22 LTS）。

1. 克隆仓库
git clone https://github.com/Jade7/dsh-harbor.git
cd dsh-harbor

2. 安装依赖国内网络建议加镜像：--registry https://registry.npmmirror.com
npm install

3. 启动开发版（自动拉起 dsh web + 打开窗口）
npm start

构建正式安装包 / 绿色版：

生成 NSIS 安装包（dist\dsh-harbor-<version>-setup.exe）
npm run dist

或仅生成绿色版目录（dist\win-unpacked\，可直接运行）
npm run dist:dir

构建说明详见下文「打包」章节；无代码签名证书时先执行 $env:CSC_IDENTITY_AUTO_DISCOVERY = "false" 跳过签名。

卸载

- 安装版：控制面板 → 程序和功能 → 卸载 DSH Harbor；
- 绿色版：直接删除解压文件夹即可。

工作原理

双击 DSH Harbor │ ├─ 检查 http://127.0.0.1:3080 是否已有 dsh 服务在跑 │ ├─ 有 → 直接复用（比如浏览器版正在使用），不重复启动 │ └─ 无 → 后台启动: node <dsh>/lib/bin.js web --port 3080 │ ├─ 轮询等待服务就绪（探测 window.__DSH_BOOT__ 标记） │ └─ 打开原生窗口加载 http://127.0.0.1:3080
+ 系统托盘（显示/隐藏、浏览器打开、开机自启、退出）
+ 退出时优雅关闭 dsh 子进程
+ 页面加载失败自动拉起 dsh 重载（自愈）

说明：dsh web 本质是绑定 127.0.0.1:3080 的本地服务（官方刻意禁止 0.0.0.0，保证只在本机访问）。Harbor 只是它的原生外壳，浏览器版与桌面版可共存、共用同一份 profile 数据（%USERPROFILE%\.dsh）。

开发运行

1. 安装依赖（国内网络建议用镜像，见下）
cd dsh-harbor
npm install

2. 启动（自动拉起 dsh web + 窗口）
npm start

- 工作目录（agent 的 workspace 根）默认是用户主目录；可用环境变量 DSH_WORKSPACE 覆盖。
- 端口默认 3080，可用 DSH_DESKTOP_PORT 覆盖；DSH_DESKTOP_USER_DATA 可覆盖数据目录。
- 开发阶段 node 必须在 PATH 中；打包后不再依赖系统 Node。

打包

$env:CSC_IDENTITY_AUTO_DISCOVERY = "false" # 无代码签名证书时跳过签名
npm run dist # 生成 dist\dsh-harbor-<version>-setup.exe（NSIS 安装包）
npm run dist:dir # 仅解包目录（绿色版，dist\win-unpacked\ 可直接运行）

- 打包会把 @deepseek-ai/dsh 及其依赖一并带入（asar: false，纯文件运行，无 asar 兼容问题），运行时用 Electron 内置 Node（ELECTRON_RUN_AS_NODE=1）执行 dsh，目标机器无需预装 Node。
- npmRebuild: false：dsh 以独立 Node 进程运行（系统 Node ABI），无需为 Electron 重建原生模块。
- electronDist: node_modules/electron/dist：打包直接复用本地已下载的 Electron，避免二次下载。
- 开机自启功能仅对打包后的应用生效（Electron 限制）。

国内网络镜像

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR = "https://npmmirror.com/mirrors/electron-builder-binaries/"
npm install --registry https://registry.npmmirror.com

若 npm install 因网络问题失败，可加 --ignore-scripts 安装，再手动执行
node scripts/install-electron.js 下载 Electron 二进制（内置 npmmirror 镜像）。

常见问题（FAQ）

Q：为什么 Windows 提示"未知发布者/已保护你的电脑"？ A：项目未购买商业代码签名证书，属正常提示。点 更多信息 → 仍要运行 即可，安装前建议核对 SHA256。

Q：我已经在用浏览器版 dsh，会不会冲突？ A：不会。Harbor 检测到 3080 已有服务会直接复用，与浏览器版共用同一份数据；退出 Harbor 不会关闭浏览器版的服务。

Q：点窗口的 × 为什么应用还在？ A：关闭按钮默认最小化到托盘（类似 QQ/微信），应用继续后台运行；托盘菜单「退出」才是真正退出。

Q：杀毒软件报毒？ A：未签名的 Electron 应用偶发误报（Electron 二进制与常见木马框架同源导致）。请从官方 Releases 下载并核对 SHA256；如不放心可将应用加入白名单。

Q：如何升级到新版本？ A：安装版直接运行新版 setup.exe 覆盖安装；绿色版替换整个文件夹即可（数据在 ~/.dsh，不受影响）。

目录结构

dsh-harbor/
├─ package.json # Electron 工程 + electron-builder 打包配置 ├─ src/main.js # 主进程：dsh 托管 / 窗口 / 托盘 / 生命周期 ├─ assets/ # 图标 ├─ scripts/ # 辅助脚本（install-electron / build-icon / test-dsh-host） └─ dist/ # 打包输出（不入库）

License

MIT

致谢：基于 deepseek-ai/deepseek-harness（MIT）构建。