dsh-desktop

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# DSH Desktop（DeepSeek Harness 桌面版）

一句话介绍：把 `dsh web` 装成一个正经的 Windows 桌面应用。双击图标就能用，不用开浏览器，不用装 Node，目标机器上什么都不用准备。

做这个项目时想得最多的一件事是：**软件得总能装得上、打得开**。所有设计都围绕这个来。

## 它能帮你做什么

- **独立窗口**：Electron 窗口直接加载本地的 DSH Web 界面，和浏览器说再见。
- **自带全套环境**：安装包里带了独立 Node v24、npm 和完整的 dsh 后端，装完就能跑。
- **数据完全隔离**：桌面版用自己的数据目录（`DSH_HOME`），和你命令行里的 `~/.dsh` 互不打扰、互不抢锁。
- **默认保活**：点右上角 X 只是缩到系统托盘，真想退出走托盘菜单。开机自启也能在托盘里开关。
- **出问题自己先修**：junction 坏了自动重建、profile 出问题自动隔离备份重试、Node 出问题自动修复，实在修不好才弹窗告诉你。
- **鲸鱼娘图标**。

## 更新是怎么运作的（和早期版本不一样，务必看一眼）

一句话：**只通知，不偷跑。你不点头，更新不会发生。**

具体流程：

1. 程序会定期看一眼有没有新版本（启动后 5 秒第一次，之后每 6 小时一次），只看，不下。
2. 发现新版本，托盘冒个气泡通知你，菜单里显示"有新版本，点击此处确认"。
3. 你点托盘里的版本号那几行，弹窗列出更新内容和上游最近的改动，点"下载并更新"才真正开始下载。
4. 下载完问你要不要立刻重启；选"稍后"就下次启动时自动生效。
5. 版本判断会**两头核对**：GitHub（`deepseek-ai/deepseek-harness` 的 master）上有、npm 镜像上也发布了，两边都在的版本才提示。GitHub 比 npm 快的时候（很常见），只提示两边都有的那个，不会让你去下一个根本下不下来的版本。

桌面外壳自己的更新默认是关的。想开的话配环境变量 `DSH_SHELL_UPDATE_URL`（真实的 https 地址），同样是通知制，确认后才下载。

## 安装时可以选后端版本

第一次安装会多出一个选择页：

- 随安装包提供的版本（推荐）
- 在线最新版本（首次启动时联网下载）
- 指定的某个版本

覆盖安装和升级不会重复问。选择只在首次启动生效一次，之后一切走上面说的托盘确认流程。

## 大更新后的插件安全启动

后端真的换了新版本之后，第一次启动会这么走：

1. 先把所有第三方插件注释掉，确认 DSH 本体起得来；
2. 再一个一个放回来试，启动页上能看到进度（"正在逐个检查插件 3/8"）；
3. 有问题的插件保持禁用，启动后弹窗告诉你哪些不兼容；
4. 插件源码和原始配置都完整保留，修好了随时能重新启用。

平时普通启动不走这套流程，不会浪费你的时间。

## 出问题了怎么办

看桌面上的 `DSH-Desktop-日志.txt`。启动、更新、插件检查的每一步和所有错误都实时写在里面，程序崩溃前也会先把堆栈写进去。文件超过 10MB 会自动转成 `DSH-Desktop-日志-旧.txt`，不会无限膨胀。

遇到问题提反馈时，把这个文件一起发过来，基本一眼就能定位。

## 你的数据安全吗

安全，这几条是硬规矩：

- 会话、配置、凭据都在 `%APPDATA%\DSH Desktop\dsh-home\` 里，卸载、升级、覆盖安装**都不会动**；
- 老版本的会话缓存升级时自动无损迁移（补齐新版本要求的新字段），改之前先备份到 `migration-backup-时间戳` 目录；
- 启动自愈最坏的情况也只是把 profiles 隔离备份成 `profiles.broken-时间戳`（保留最近 2 份），不删任何数据。

## 仓库里有什么

| 目录/文件 | 说明 |
|---|---|
| `main.js` / `preload.js` / `updater-backend.js` / `diag-log.js` / `splash.html` | Electron 外壳本体（主进程、后端管理、桌面诊断日志） |
| `build/installer.nsh` | 安装器定制：结束进程、版本选择页 |
| `scripts/` | 安装/打包/运行时准备脚本 |
| `assets/` | 图标等资源 |

运行期目录（自动创建）：

```
%APPDATA%\DSH Desktop\
├─ backend\        # 活跃的 Node、npm、dsh 后端 + 更新暂存区
└─ dsh-home\       # 你的数据：profiles、会话、设置、凭据
```

## 启动顺序（简单说）

每次启动按固定顺序走，每一步失败都有兜底：把出厂环境铺到用户目录（第一次）→ 应用上次下载好的更新（此时后端还没跑，没有文件占用）→ 检查 Node 版本够不够 → 修一遍插件链接 → 启动后端 → 开窗口。整个过程都写着桌面日志。

## 开发 / 打包

```bat
npm install        # 自动准备 vendor 后端与 Node 运行时
npm start          # 开发模式
npm run dist       # 生成 release\DSH Desktop Setup x.x.x.exe
```

## 常见问题

- **安装时提示"无法关闭"**：不会的。安装器会先按路径精确结束 DSH 相关进程（绝不误杀你机器上其他的 node），再卸旧装新。
- **`is not a symlink` 报错**：启动时自动修复，一般见不到。数据目录和命令行是隔离的，正常不会再撞。
- **更新下了却没生效**：重启一次。更新都是重启时应用的；如果还不行，看桌面日志，里面写得很清楚。
- **想固定 Node 主版本**：环境变量 `DSH_NODE_MAJOR`（默认 24）。
- **换镜像**：`DSH_NPM_REGISTRY`、`DSH_NODE_DIST_BASE`。