# dsh-plugin-remote

DeepSeek Harness (DSH) Web GUI 的远程访问网关：登录认证 + HTTP/WebSocket 反向代理到本机 DSH 服务。

[English](README.md) · MIT

## 安装

```sh
dsh plugin --profile web add dsh-plugin-remote && dsh web
```

> 注意：这是 DSH（DeepSeek Harness）插件，需要通过 `dsh plugin`（或 profile 依赖）安装到 profile 中才会激活网关；单独 `npm i` 不会生效。

## 截图

| 登录页 | 主界面（对话 / 轨迹 / 远程访问 页签） |
|---|---|
| ![登录页](https://raw.githubusercontent.com/siberiah2o/dsh-plugin-remote/main/docs/screenshot-login.png) | ![主界面](https://raw.githubusercontent.com/siberiah2o/dsh-plugin-remote/main/docs/screenshot-main.png) |

| 远程桌面页签 | 设置 → 远程访问 |
|---|---|
| ![远程桌面](https://raw.githubusercontent.com/siberiah2o/dsh-plugin-remote/main/docs/screenshot-desktop.png) | ![设置](https://raw.githubusercontent.com/siberiah2o/dsh-plugin-remote/main/docs/screenshot-settings.png) |

## 功能

- **登录后远程访问**：scrypt 凭据 + HttpOnly 会话 Cookie；HTTP/WebSocket 反向代理并重写 Host/Origin，无需 `--trusted-host`
- **白色主题登录页**（shadcn/ui，移动端适配）带 DeepSeek Harness 品牌
- **网关管理接口**（`/admin/*`，需登录会话），在 设置 → 远程访问 分区中管理：
  - 远程访问白名单（IP / CIDR；127.0.0.1 始终放行；热加载）
  - 账号密码修改（改后旧会话立即失效）
  - 来源请求记录：全部请求按天 JSONL 分片存储，支持下载与 1/3/7 天保留规则
- **中英文双语**，跟随 GUI 语言
- **Windows 桌面零安装投影**：插件自动启动随包携带的 x64 原生 Helper，
  用户无需安装 .NET、FFmpeg、驱动或独立 Agent
- **可交互远程桌面**：作为对话视图页签环中的“远程访问”页签
  （位于 轨迹 旁），全宽投影 Windows 桌面；支持鼠标、键盘以及
  弱网/平衡/文字清晰三档画质
- 网关的 HTTP/WebSocket 核心仍使用 Node 内置模块；可选的原生 `node-datachannel` 提供 WebRTC 快速链路，Next.js 登录应用在 `gateway/` 内

## 使用

- 打开 `http://<服务器IP>:4080` —— 首次访问创建唯一账号
- 管理账号：`node lib/remote-passwd.mjs add|set-password|list|del <用户名>`
- 数据位于 `$DSH_HOME/plugin-data/dsh-plugin-remote/`（`users.json`、`whitelist.json`、`logs/`）

## Windows 桌面

在 Windows 10/11 x64 上，网关就绪后插件会自动启动
`native/windows-x64/dsh-remote-host.exe`。Helper 使用每次启动时随机生成且不落盘的
令牌回连网关；只有已登录网关的用户才能查看和控制桌面。

当前源码提供两级画面链路。执行 `native:build` 后，Windows Helper 会通过
Media Foundation 将 BGRA 画面编码为 H.264，并把每个访问单元送入真正的
WebRTC H.264/RTP 视频轨道，由媒体层负责节流、拥塞反馈、NACK 和关键帧请求；
这避免把完整 JPEG 帧持续堆进 TCP 队列。启动阶段、H.264 解码不可用或视频
轨道卡顿时，网关会自动保留并切换到 JPEG DataChannel；ICE 建链失败时再回退
到已认证的 WebSocket。包内会优先使用 `dsh-remote-host-h264.exe`，旧 exe
保留作兼容回退；执行 `npm run native:build` 会同时刷新两份 Helper。

鼠标移动和滚轮使用可丢弃的低延迟通道，键盘、点击、ACK 与输入复位使用可靠
有序通道，避免弱网下旧画面阻塞新输入；受限网络建议在插件配置中填写 TURN。

`rtcIceServers` 使用浏览器 `RTCConfiguration` 格式，例如：

```js
{
  rtcIceServers: [
    'stun:stun.example.net:3478',
    { urls: 'turns:turn.example.net:5349', username: 'user', credential: 'secret' },
  ],
}
```

Windows 安全桌面（UAC、登录界面及锁屏）不能被捕获或控制。设置
`config.desktop: false` 可以禁用桌面投影。

### 开发验证

```powershell
npm run native:build
npm run gateway:build
npm run test:desktop
```

## License

MIT