dsh-self-updater

Readme

# DSH Self Updater

为 DeepSeek Harness Web profile 提供本机同源的一键版本检查、更新与重启界面。

## 功能

- 显示当前 DSH 版本和 npm `latest` 版本。
- 一键安装 registry 返回且经过 SemVer 校验的精确 `@deepseek-ai/dsh` 版本。
- 更新完成后自动重启当前 DSH 启动命令。
- 显示进度和裁剪后的 npm 日志；阻止并发更新。
- 保留 `$DSH_HOME` 下的会话、配置、profile 和插件。
- HTTP 路由只接受回环地址和同源浏览器请求。

## 安装

从 GitHub 安装：

```powershell
dsh plugin --profile web add github:jijiz1/dsh-self-updater
```

从本地目录安装：

```powershell
dsh plugin --profile web add D:\DSH\dsh-self-updater
```

重启 `dsh web` 后，页面右上角会出现版本胶囊。点击即可检查更新。

## 安全边界

- 更新包名固定为 `@deepseek-ai/dsh`，版本只能来自 npm registry 的 `latest` dist-tag。
- npm 完成后会重新读取已安装 manifest；版本不一致则不会进入重启阶段。
- npm 缓存放在 `$DSH_HOME/self-updater/npm-cache`，不依赖系统 npm cache 权限。
- 更新失败不会触发重启，错误日志可在面板中查看。

## 开发验证

```powershell
npm test
npm run check
```