# 安装、更新与恢复 · 0.6.0 预发布

兼容依据：Windows DSH Desktop 0.2.1-rc.2，默认应用安装位置。其他位置、平台和版本未验证。最新 master 文档不等于本轮旧版接口已实测。

## 下载与安装

从本仓库 v0.6.0 Release 下载命名 zip 和 SHA256SUMS，用 `Get-FileHash -Algorithm SHA256` 比对后解压到长期可写目录，例如 `D:/Plugins/dsh-reply-beautify`。进入含 package.json、lib/client.js、tools/desktop-cli.mjs 和 install.ps1 的内层目录。不要在压缩包中运行。

先启动 DSH 一次初始化 desktop profile，再从“应用 → 退出”完全退出。在插件目录 PowerShell 执行：

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ./install.ps1 -Check
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ./install.ps1
```

重启 DSH，画笔应显示 0.6.0。安装器使用安装内官方 CLI 与 pnpm，添加绝对路径 link: 并使用 --offline --ignore-scripts；不下载依赖，不改应用文件。检测到运行进程会拒绝变更。插件从解压目录持续加载，请勿移动或删除。

应用路径固定为 `%LOCALAPPDATA%/Programs/DeepSeek Harness/DeepSeek Harness.exe`。默认 profile 为 `%USERPROFILE%/.dsh/profiles/desktop`，若设置 DSH_HOME，改用其下 profiles/desktop。安装、自检、更新、回退时保持相同环境，不要换 Windows 用户或管理员账号运行。

-Check 只读取文件、链接、bundle 注册和进程，不调用安装 CLI、不创建备份。新装前 Linked/BundleRegistered 为 false 可以正常；安装后应为 true，且 PluginRoot 应是当前解压目录。分享输出前隐去个人路径。

运行 tgz 使用 npm 标准 package/ 结构并含构建产物，供高级用户或标准插件命令使用；普通用户首选命名 zip。官方底层插件命令为 `dsh plugin --profile <name> add <spec>` / `remove <name>`，变更后重启。桌面 profile 需要安装内 CLI 的桌面管理模式，不要用另装的 npm dsh 代替桥接脚本。本次未在真实桌面 profile 重装 tgz，未发布 npm 或自定义市场索引。

官方依据：[CLI 参考](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.zh.md#插件管理)、[桌面 CLI 入口](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/cli/dsh.cmd)。

## 更新、关闭与卸载

更新：保留旧版完整目录，新版解压到新目录；完全退出 DSH 后在新目录运行安装，再重启。回退：退出后在保留的旧目录重新安装。公开包不含开发者私人回退快照，旧版需要自行保留。不要混用不同版本的 client.js、manifest 和 Host 文件。

- 画笔关闭：恢复原文、移除显示与交互视图、停止作品；Host 模型格式指南仍在。
- 原生插件管理停用：框架停用客户端与 Host 能力；必要时完全退出重启后判断。
- 卸载：完全退出后在安装目录执行 `powershell.exe -NoProfile -ExecutionPolicy Bypass -File ./install.ps1 -Uninstall`，然后重启。

变更前原样备份 profile 中存在的 package.json、pnpm-lock.yaml、cordis.patch.yml 和 pnpm-workspace.yaml 到插件目录 backups/时间与随机标识。失败会报告错误码和备份位置，并恢复 ELECTRON_RUN_AS_NODE。不会自动覆盖回 profile，以免混合包管理器状态。备份可能含私人配置，请勿上传。停用/卸载不主动删除聊天、工作区、偏好或浏览器记录；配置备份不是完整聊天或状态备份。

本轮仅用隔离 profile 与模拟执行器验证安装逻辑。真实安装、启停和卸载重装由用户按 [TESTING.md](TESTING.md) 验收。开发检查命令见 README。