# 🔄 dsh-auto-update
### 🚀 DeepSeek Harness 自更新守护插件 · 跨平台/容器环境自适应
[](https://dsh-plugin.org/plugins/a1113622001/dsh-auto-update)
[](https://nodejs.org/)
[](https://github.com/a1113622001/dsh-auto-update)
[](LICENSE)
[English](./README.en.md) · [简体中文](./README.md) · [更新日志](./CHANGELOG.md)
---
## 📖 项目简介
**dsh-auto-update** 是已收录于 **[dsh-plugin.org](https://dsh-plugin.org/plugins/a1113622001/dsh-auto-update)**（DeepSeek Harness 社区插件市场）的自更新守护插件。
在 Windows 及 POSIX 平台上，运行中的 Node 原生插件（sharp/koffi/node-pty）会被操作系统加锁，直接热覆盖必报 `EBUSY`；而在容器中，主进程退出又会直接导致容器销毁。
本项目通过 **Stage（暂存） + Post-Exit Detached Apply（退出后脱离子进程替换） + 容器智能感知保护** 三阶段设计，完美解决了 Harness 在各类环境下的自动升级难题。
---
## 🛒 插件市场与安装方式
### 方式 1：通过插件市场安装（推荐）
Harness 自身不内置市场界面；市场 UI 由社区插件 [`dsh-plugin`](https://dsh-plugin.org/plugins/dshplugin/dsh-plugin-hub) 提供，需先安装它：
```bash
dsh plugin --profile web add dsh-plugin
```
1. 重启 `dsh web`（默认 `http://127.0.0.1:3080`）；
2. 打开 **`设置 (Settings)`** -> **`插件市场`**；
3. 搜索 **`dsh-auto-update`**，点击 **`安装`** 即可完成热加载。
### 方式 2：通过 Harness CLI 命令行安装
```bash
# 从 GitHub 仓库安装（推荐）
dsh plugin --profile web add github:a1113622001/dsh-auto-update
```
> 本插件目前仅通过 GitHub 仓库分发，**尚未发布到 npm registry**，
> 因此 `dsh plugin add dsh-auto-update`（不带 `github:` 前缀）会因包不存在而失败。
---
## 🏗️ 架构与生命周期
```mermaid
sequenceDiagram
autonumber
participant H as Harness 主进程
participant C as 客户端 UI 面板
participant NPM as npm 官方源 / 镜像
participant F as 磁盘暂存区 (DSH_HOME/updates)
participant D as 脱离执行器 (apply-update.js)
Note over H,C: 阶段 1: 探测与暂存 (Stage)
H->>NPM: 检查 dist-tag 远端最新版本
H->>F: 下载精确 tarball 并写入 pending-update.json
H-->>C: 前端显示可更新状态 (胶囊徽标)
Note over H,D: 阶段 2: 退出与句柄释放
C->>H: 用户点击 "更新并重启" (或正常退出)
H->>D: 派生独立脱离子进程 (detached child)
H->>H: process.exit(0) 释放原生模块文件句柄
Note over D: 阶段 3: 执行替换与自动拉起 (Apply)
D->>D: 等待父进程 PID 彻底终止
D->>NPM: 执行 npm install -g tarball
D->>D: 写入 update-history.jsonl
D->>H: 按原启动参数重启 dsh web
```
---
## ✨ 核心特性
- 🛡️ **突破 Windows EBUSY 文件锁**：两阶段更新设计，运行期仅做暂存，主进程退出释放原生 DLL 句柄后再执行原子替换。
- 🐳 **容器智能感知（Container-Aware）**：自动检测 Docker / K8s / Podman 容器环境，禁止触发 `process.exit(0)`，并在 UI 友好提示“请拉取最新镜像更新”。
- 🌐 **全平台软链适配**：支持 Windows (`/dsh.cmd`) 与 Linux/macOS POSIX (`/bin/dsh`) 重启寻址。
- 💊 **极简胶囊交互**：Web 界面右下角默认折叠为轻量胶囊，点击展开查看版本差异、手动检查或一键重启。
- 🔄 **原子并发锁保护**：内置 `apply.lock`，防止多个更新进程并发冲突损坏全局环境。
---
## ⚙️ 配置文件说明 (`cordis.patch.yml`)
插件安装后会自动注入配置。如需自定义参数，可在 `%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml` 中调整：
```yaml
# dsh-auto-update 配置项
- insert:
- id: auto-update
name: 'dsh-auto-update'
config:
distTag: latest # 跟踪的 npm dist-tag (如 latest, next)
checkOnStart: true # 启动时立即执行一次版本检查
checkIntervalMinutes: 240 # 定期检查间隔 (分钟)
autoStage: true # 发现新版本后自动下载暂存
applyOnExit: true # Harness 退出时自动应用更新
relaunch: false # 应用更新后是否自动重启 harness
```
---
## 📄 开源许可证
本项目采用 [MIT License](LICENSE) 授权开源。