# dsh-web-desktop

[English](README.md)

`dsh-web-desktop` 为现有 Web profile 提供 Electron 启动器。

它不创建或复制 profile。启动器自动找到包内 overlay，以同一份 Web profile、插件清单和配置启动 Electron，且不修改 DSH 核心。

![使用同一 Web profile 启动的 Electron 窗口](assets/web-profile-electron.png)

## 优势

- **多一种使用方式**：保留 `pnpm dsh web` 的浏览器入口，同时提供独立 Electron 窗口。
- **Web 与客户端一致**：两种入口使用同一份 Web profile、已安装插件、会话、模型设置和 `cordis.patch.yml`。
- **无侵入扩展**：只作为 profile bundle 与启动器安装，不修改 DeepSeek Harness 核心、agent loop 或 Web UI。
- **持续跟随 DSH**：启动时仍由当前本地 `pnpm dsh` 运行 Web profile；更新 DeepSeek Harness 后，桌面启动器会复用更新后的 Web 实现和已安装插件。

## 安装

安装到已有 Web profile：

```sh
pnpm dsh plugin --profile web add dsh-web-desktop
```

DSH 会自动把该 bundle 加入 Web profile；普通 `dsh web` 启动时它保持停用。

## 启动

```sh
pnpm dsh plugin --profile web exec dsh-web-desktop
```

`pnpm dsh web` 仍使用浏览器；启动器命令使用 Electron。两者使用同一个 Web profile。

```sh
pnpm dsh plugin --profile web exec dsh-web-desktop -- --port 8080
```

`--` 之后的参数转发给 Web profile；启动器始终追加自身 overlay 与 `--no-open`。

## 范围

首版是桌面模式组合包，不是原生 IPC 客户端。DSH Web Host 继续使用现有 HTTP 与 WebSocket 传输；关闭 Electron 后 Host 会继续运行，与关闭普通浏览器标签页一致。它要求 Electron 与当前 DeepSeek Harness 安装保持兼容。

## 开发

```sh
pnpm install
pnpm test
pnpm build
pnpm pack:check
```

## 许可

MIT