# 通过 DSH 官方入口安装

1. 安装并启动 DSH 0.2.x，确认配置的模型可用。
2. 打开「插件 → 添加插件」，输入 `@jyddwy/dsh-companion@1.9.8`。
3. 选择安装源；国内用户可选「中国大陆镜像源」，镜像需已同步此版本。
4. 点击安装，完成后按提示刷新或重启 DSH。
5. 在右侧「陪玩」点「看一眼」，验证截图、回复和系统语音。

更新与卸载通过 DSH 插件管理页执行。npm 包由 DSH 管理，基础功能无需另行运行安装脚本。

用户配置、历史和世界书保存在 DSH 数据目录的 `dsh-companion/`。截图会发送给 DSH 中配置的模型服务商；语音链路中，edge-tts 会把台词发送到微软在线服务，SAPI 在本机合成，RVC 在本机变声。已知问题与免责声明见 README 和 [DISCLAIMER.md](DISCLAIMER.md)。

可选 RVC 增强：打开「陪玩 → 设置 → 声音」，点击「下载并安装语音增强（CPU）」。无需访问 GitHub，无需手动下载增强 ZIP。安装完成后按 [模型指南](docs/RVC-声线下载指南.md) 自行下载模型，再选择相应声线并重启语音。

环境与模型保存在 DSH 数据目录的 `dsh-companion/voice/`，不放在 npm 插件目录中，更新主插件会保留它们。取消或安装失败不会替换已启用的旧环境。安装器只操作自己的独立 Python，不修改系统 Python。

安装日志可在设置面板展开查看，状态保存于 `dsh-companion/voice/install-status.json`。如果退出 DSH 导致中断，重新打开设置可重试。国内镜像也可能暂时不可用，错误会显示在面板中。

GitHub 源码/旧 ZIP 中的 junction 安装方式适用于原独立目录版本；不要与本 npm 安装方式重复登记。