# 安装与升级

## 前置条件

- Node.js 24；
- 已能正常启动的 DeepSeek Harness；
- DSH Web Profile 中至少有一个可用模型来源。

Workforce 不读取或保存模型 API Key。Provider 与凭据继续由 DSH 管理。

## 从 GitHub 安装

```bash
dsh plugin --profile web add github:esonx/dsh-workforce#v0.1.1
dsh web
```

Workforce 发布的是可直接运行的 JavaScript，不需要安装期构建脚本或 pnpm `allowBuilds` 授权。

## 从 Release tarball 安装

下载 `dsh-workforce-0.1.1.tgz` 后：

```bash
dsh plugin --profile web add ./dsh-workforce-0.1.1.tgz
dsh web
```

可先检查 Profile 组合层：

```bash
dsh --profile web --dump-config
```

输出中应包含 `dsh-workforce` bundle 和 `workforceFederation` entry。

## 升级

1. 停止当前 DSH Web 进程。
2. 备份每个 Workforce Project 的 `.workforce/`。
3. 备份用户 DSH Home 下的 `workforce-center/center.sqlite`。
4. 安装明确的新版 tag 或 tarball。
5. 先运行 `--dump-config`，再启动 DSH Web。
6. 验证 WorkforceCenter、一个管理会话、一个 Work 会话和一个 Meeting。

不要同时运行多个会写入同一 WorkforceCenter 或同一 Project 数据库的 DSH 实例。

## 卸载

```bash
dsh plugin --profile web remove dsh-workforce
```

该命令只移除 Profile 中的插件和 bundle 层，不删除 Workforce 数据。