← 返回列表
⚠ 装前注意
dsh-desktop — DeepSeek Harness 桌面壳
基本兼容但装前注意：npm 同名包「dsh-desktop」归属 snowcrescenter-tech/dsh-desktop，装到的可能不是本插件 · 最近上游提交 2026/9/7 · 已提供中文文档
Desktop shell for DeepSeek Harness (dsh): a thin Electron wrapper that launches `npx @deepseek-ai/dsh web` and loads http://127.0.0.1:3080 in a native window — zero modification to dsh itself. | DeepSeek Harness 桌面壳
综合分
29.2
GitHub 分
29.2
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add alanzhao0128/dsh-desktopnpm 同名包「dsh-desktop」归属 snowcrescenter-tech/dsh-desktop，装到的可能不是本插件，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · desktop
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 18 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/22（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-desktop @ 0.2.0
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
npm 同名包「dsh-desktop」归属 snowcrescenter-tech/dsh-desktop，装到的可能不是本插件
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/23 02:25:06
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-desktop — DeepSeek Harness 桌面壳 一个极薄的 Electron 壳：打开后自动执行 dsh web（已全局安装时直接用 dsh，否则回退 npx @deepseek-ai/dsh web），然后用窗口内嵌的 Chromium 内核加载 http://127.0.0.1:3080。完全不修改 dsh 本身的任何东西——dsh 仍然以原生命令运行，只是多了一个原生窗口。 特性 - 优先全局 dsh，否则 npx：若已全局安装 dsh（npm i -g @deepseek-ai/dsh），直接用 dsh web --no-open 启动；未安装时回退 npx --yes --prefer-online @deepseek-ai/dsh web --no-open（--yes 避免交互卡住，--prefer-online 强制每次联网校验 registry 取最新发布版）。--no-open 让 dsh 不额外弹出系统浏览器——UI 由壳内嵌窗口渲染。 - 智能复用：如果 3080 端口已经有 dsh web 在跑（比如浏览器里已经开着一个），壳直接复用，不会重复启动；只有端口空闲时才自己拉起一个。 - 自动适配 dsh ≥ 0.1.2 浏览器鉴权：新版 dsh web 用「启动令牌 → 签名 cookie」保护页面。壳从 dsh 的输出中捕获带 token 的启动地址并用它加载窗口，自动完成令牌换 cookie，无需手动操作。对外部已运行的新版 dsh（非本壳启动，拿不到令牌），壳会提示先退出它再让本壳启动。 - macOS 惯例的窗口行为：点窗口的 ✕ 只关窗口，app 进程和 dsh web 服务都继续运行（Dock 里还在，点图标重新开窗会直接复用仍在跑的服务）；Cmd+Q（或菜单退出）才真正退出 app，并只杀掉自己拉起的 dsh 进程树；复用的外部实例保持不动。Windows/Linux 上保持"关窗口即退出"的惯例。 - 启动过程可见：npx 首次下载可能较慢，窗口内显示进度；失败时显示原因和日志路径，可一键重试。 - 日志：写到 ~/Library/Application Support/dsh-desktop/logs/（shell.log + dsh.log），帮助菜单可直接打开日志目录。 - 外链走系统浏览器：窗口内只允许访问本机 dsh 服务，其他链接交给默认浏览器。 运行（开发模式） npm install npm start 打包为 macOS App npm run pack:mac # 产出 dist/.zip npm run pack:mac:dir # 仅产出 dist/mac-arm64/.app（最快） npm run pack:mac:dmg # 用系统 hdiutil 产出 dist/*.dmg（需先跑 pack:mac:dir） 未签名的本地构建首次打开若被 Gatekeeper 拦截，执行： xattr -cr dist/mac-arm64/DeepSeek\ Harness.app 配置 | 环境变量 | 作用 | 默认 | |---|---|---| | DSH_DESKTOP_PORT | 壳探测/加载/启动 dsh 用的端口 | 3080 | | DSH_NPM_CACHE | 透传给 npx 的 npm 缓存目录（一般不需要） | 无（用 npm 默认缓存） | 例：DSH_DESKTOP_PORT=3090 npm start 会用 --port 3090 启动 dsh 并加载该端口。 项目结构 src/ main.js Electron 主进程：窗口、生命周期、菜单、启动编排 server-manager.js 纯 Node 模块：选择启动方式（全局 dsh / npx）/ 端口探活 / 复用检测 / 进程树清理 preload.js 壳本地页面的最小桥（loading/error 页用） logger.js 文件日志 pages/shell.html 启动中/错误/重试 页 scripts/ smoke.js 无窗口全链路测试：node scripts/smoke.js 测试 npm run smoke smoke 会真实执行一次「启动 dsh web（全局 dsh 或 npx 拉包）→ 探活就绪 → 关闭并确认端口释放」的完整链路（使用独立端口 3090 和独立的 DSH_HOME，不影响你的真实环境），并检查默认端口 3080 上已有实例的复用检测。 平台支持 当前面向 macOS（已发布）。Windows 支持已做好代码与图标预留，详细见 Windows 构建与运行说明： - server-manager.js 的进程启动/清理按平台分支（Windows 走 cmd.exe /c + taskkill /T /F）； - 已生成 build/icon.ico（16–256 多尺寸，与 mac 版同一设计）； - electron-builder 已配置 win.nsis 目标（在 Windows 机器上执行 npx electron-builder --win 即可出包，macOS 上无法交叉打包 Windows 安装包）。 已知限制 - dsh 与壳是两个进程：关掉壳的窗口（不退出 app）时服务继续运行，浏览器里已打开的 dsh 页面不受影响（那只影响 UI，不影响服务）；只有 Cmd+Q 退出 app 才会停掉由壳拉起的服务。 - 打包后的 .app 双击启动时没有终端，npx 的输出只进日志文件；出错时窗口会显示日志路径。