安装前准备
- macOS 推荐 Apple Silicon；Windows 使用 64 位版本。
- 准备一个可用的模型服务 API Key。密钥只在应用的本地 DSH 设置中配置。
- 正式安装包不要求额外安装 Node.js；从源码运行才需要 Node.js 24+。
四步完成安装
下载对应平台的安装包
打开 下载页面 或 GitHub Release，macOS 选择 DMG，Windows 选择 EXE。请以最新 Release 页面中的文件名和版本为准。
按系统提示安装
macOS 将应用拖入 Applications；Windows 运行 NSIS 安装器并选择安装位置。macOS 安装包带 Developer ID 签名和 Apple 公证，Windows 安装器执行签名校验。
配置模型 API Key
首次打开后进入 DSH 设置，粘贴模型服务提供的 API Key。不要把密钥写进项目源码、插件清单、Session 内容或截图。
创建或选择 Profile
选择工作目录，创建一个新的 Profile 或继续使用已有 Profile。应用默认使用
~/.dsh保存本地数据，启动时不会重写已有配置。
第一次使用建议
Profile
先确认数据位置
Profile、Session 和本地运行数据默认在 ~/.dsh。如果你已经使用官方 npx dsh，应用默认与它使用同一个数据目录。
Plugins
再检查插件状态
打开设置中的插件市场，查看 16 个固定 Bundle 的来源、版本、权限和兼容性。插件可以按需停用或卸载。
常见安装问题
macOS 提示无法验证开发者
先确认下载来源是本站链接的 GitHub Release。若仍有提示，在 Applications 中右键应用选择“打开”，或到“系统设置 → 隐私与安全性”允许打开。
Windows SmartScreen 拦截
确认文件来自 GitHub Release 且文件名正确。SmartScreen 仍提示时，点击“更多信息”再选择“仍要运行”。
GitHub 下载速度很慢
在 Release 页面复制资产直链，使用下载工具完成下载。不要从不明镜像安装未核对来源的文件。
需要从源码运行
macOS Intel 与 Linux 暂无正式安装包，可以参考 GitHub 仓库的 从源码运行说明，需要 Node.js 24+。