# Windows 新机试装

适用于首次在另一台电脑安装 Runtime Map 0.5.0-rc.1。这个 RC 已通过隔离检查，完整新机体验还需要实测；已有安装不要按首次安装流程覆盖。

## 1. 取得插件

在 [GitHub Releases](https://github.com/jueduihouqi-GG/dsh-runtime-map/releases) 下载 `dsh-runtime-map-0.5.0-rc.1.tgz` 和 `SHA256SUMS.txt`。前者是 DSH 插件包，不需要下载源码才能使用。

在 PowerShell 对照校验值：

```powershell
Get-FileHash "$env:USERPROFILE\Downloads\dsh-runtime-map-0.5.0-rc.1.tgz" -Algorithm SHA256
```

安装前确认 DSH Desktop 为 **0.2.0-rc.2**。在 DSH 插件管理器选择安装这个本地包；如果使用官方 `dsh` 命令，则执行：

```powershell
dsh plugin --profile desktop add "$env:USERPROFILE\Downloads\dsh-runtime-map-0.5.0-rc.1.tgz"
```

这里只给默认 desktop profile 示例；如果你的安装使用别的 profile 或目录，以安装回执为准。`dsh` 命令不存在时使用插件管理器，不必为此改系统配置。

## 2. 一次后台配置

RC 首次安装需要一次配置。先退出 DSH，打开 PowerShell。以下路径适用于默认的 Windows 桌面端安装，会先核验文件是否存在：

```powershell
$rmNode = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\primary-runtime\dependencies\node\bin\node.exe'
$rmPlugin = Join-Path $env:USERPROFILE '.dsh\profiles\desktop\node_modules\dsh-runtime-map'
$rmService = Join-Path $env:USERPROFILE '.dsh\runtime-map\service'
if (!(Test-Path -LiteralPath $rmNode)) { throw '未找到 DSH 自带 Node，请核对安装位置，或使用 Node 24.2+。' }
if (!(Test-Path -LiteralPath (Join-Path $rmPlugin 'scripts\setup-backend.mjs'))) { throw '未找到插件，请先确认安装成功及 profile 路径。' }
& $rmNode (Join-Path $rmPlugin 'scripts\setup-backend.mjs') --plugin $rmPlugin --service $rmService
```

这一段只显示计划。核对它指向本机的插件与新后台目录后，在同一个窗口运行：

```powershell
& $rmNode (Join-Path $rmPlugin 'scripts\setup-backend.mjs') --plugin $rmPlugin --service $rmService --apply
```

看到 `changed: true` 后重新打开 DSH。已有配置/后台目录会被拒绝覆盖；遇到 `EXISTING_CONFIGURATION_KEEP` 或 `EXISTING_SERVICE_KEEP` 时先检查旧安装，不删除目录来强行重装。

以后打开 Runtime Map 会自动启动后台，**不用再运行配置命令或 start.cmd，也不依赖 Codex 保持打开**。编辑画布、目录同步不需要重启 DSH。

## 3. 同步本机目录

进入 Runtime Map，点“同步目录”。Codex / WorkBuddy 需要在这台电脑上已安装并有本机目录资料；云端 ChatGPT / Work 实时状态目前未接入。

首次画布是空的，这是正常现象。公开包不会带入开发者的聊天、画布或历史，也不会自动把另一台电脑的布局同步过来。从左侧目录选择本机入口加入画布即可。

WorkBuddy 状态需另装附属观察器，见 `integrations/workbuddy/README.md`；没有观察器时显示未接入，不会用最近更新时间假装工作中。

## 4. 试装后记录这几项

- Runtime Map 入口是否出现；后台是否自动启动。
- 本机来源的标题和项目是否同步正确。
- 在原生应用正常聊天时，地图是否出现工作中与结束后的新结果。
- 新建测试画布后重新打开，成员、位置和连线是否保留。

若有问题，提供 DSH / Node 版本、错误码和已脱敏的截图即可；不要上传连接令牌、原生聊天记录或数据库。更详细的来源设置、诊断和保留数据说明见 [安装说明](INSTALL.md)。