多开启动器 xinspark/dsh-next-multi-launcher

DSH-NEXT 应用多开启动器

我在 DSH 里养了条「deepseek 大肥鱼」，叫汐。

我想要汐的 DSH 和我工作自用的 DSH 完全数据隔离——不只是隔离插件，而是连记忆、会话、凭据都不互相污染。
但 DSH-NEXT 的全局指针同一时刻只能指向一个数据目录，而官方的 profile 切换只隔离插件，会话与插件存储仍然混在一起。

所以我做了这个启动器：每个实例一个完整独立的数据目录，给汐一个只属于它的家。
它就是同一份 DSH-NEXT 安装跑出的多个原生窗口——真窗口、真托盘、真 Community Market，不是 webview 套壳。

主界面

隔离范围：比官方 profile 多了什么

| 层 | 官方 profile 切换 | 本启动器（独立 home） | 证据 |
| 插件 | ✅ 隔离 | ✅ 隔离 | plugins/、profiles/ 在 home 内 |
| 会话 | ❌ 仍会互相看到 | ✅ 文件级隔离 | sessions/ 在 home 内（按 workspace 分组） |
| 插件存储 | ❌ 共享 | ✅ 隔离 | storages/ 在 home 内 |
| 凭据 | ❌ 共享 | ✅ 隔离 | .credentials.yaml 在 home 内 |
| 单实例锁 | — | ✅ 两把不同的锁 | 独立 userData = <home>\electron-user-data |
| Agents Anywhere 账号 | ❌ | ❌ 设备绑定是全局的 | 见能力边界 |
| 内核版本 | ❌ | ❌ 壳与内核恒同版本 | 同上 |

一句话：官方实例隔离到插件层，本工具隔离整个 home。

特性

| 能力 | 说明 |
| 多实例 | 每个实例独立名称、ID、home、DSH-NEXT 版本；归档、删除、备注 |
| 串行启动队列 | 同一时刻只启动一个，避免指针互相覆盖；失败自动回滚 |
| 启动后还原 | 成功后把指针还原为默认环境，双击桌面图标仍进日常 |
| 版本树 | 目录链接（junction）登记已解包安装目录，不复制文件（省 300MB/版本） |
| 自动扫描 | 导入版本时自动发现本机安装（快捷方式 / 注册表 / 常见路径 / 运行中进程），勾选批量导入 |
| 重启 | 「重启 / 重启并进入安全模式 / 重启并退出安全模式」，安全模式可识别 |
| 停止 | 优雅退出 → 超时 → 强制结束整组（含 host 子进程） |
| 权限 | 关键目录不可写时自动请求管理员，界面可手动触发 |
| 原生对齐 | 1158 个设计 token 从 app.asar 抽取，门禁防漂移 |
| 可验证 | 53 项 Rust 单测、15 项端到端断言、UI 自动化检查 |

快速开始

1. 准备 DSH-NEXT（目录里要有 DSH NEXT.exe 与 resources\app.asar）；
2. 运行启动器（Releases 下载，或从源码构建）；
3. 点「导入版本」→「自动扫描」（或手动选目录）→「新建实例」→「启动」。

自动扫描覆盖正常安装（快捷方式、注册表、常见路径）与正在运行的实例；解压到任意目录的绿色版可能扫不到，用「浏览」手动选即可。

未购买商业代码签名，首次运行可能看到 SmartScreen 提示——点「更多信息 → 仍要运行」。
校验方式见关于代码签名。

核心概念

| 概念 | 含义 |
| 指针 | DSH-NEXT 的全局文件，决定下次启动进哪个数据目录；启动器临时改写并在成功后还原 |
| home | 实例的完整数据目录。默认 <数据目录树根>\.dsh-<id>，可自由修改 |
| 默认环境 | 设置里的「默认数据目录」；双击桌面图标应进入的环境 |
| 版本树 | versions\<tag> 目录链接，指向已解包的 DSH-NEXT 安装目录 |
| 实例 | 名称 + ID + home + 版本的组合，存为 instances\<id>.json |

使用

列表与详情

实例行给出状态（运行中 / 已停止 / 排队 / 失败）、版本、home 与上次启动时间；选中后在右侧改名称、版本、home、备注。

重启（两处入口）

实例行与详情面板底部各有一个「重启 ▾」，都在【启动/停止】之前，两项：「重启」+ 按当前状态二选一（进入 / 退出安全模式）。

重启期间顶部显示「正在重启「X」…」；实例运行在安全模式时，顶部常驻提示条并带「退出安全模式」按钮。

安全模式

顶部提示（单行轮播）

指针栏下方有一条常驻提示，单行轮播、每条 30 秒：重启限制与「数据目录变更」提示的说明。

能力边界

能保证：整套 home 隔离（会话 / 插件 / 凭据 / 插件存储 / 窗口状态按 home 各一份）；多实例同时运行互不抢锁；启动失败一律回滚指针；删除数据目录前有安全网。

不保证：

| 项 | 说明 |
| Agents Anywhere 账号隔离 | 切 home 不隔离 AA 登录与设备绑定，跨实例共享 |
| 内核独立 | 壳与 @deepseek-ai/dsh 恒同版本，只有"壳版本"一个旋钮 |
| 同 home 多实例 | 两个 writer 会损坏会话；启动器直接拒绝（E1003） |
| 非默认实例在 DSH 内部重启 | 会重读全局指针，落到默认实例；重启请用启动器「重启 ▾」 |
| 多个非默认实例同时运行时的重启 | 指针全局唯一，只有最后启动的那个能正确重启 |
| 自动更新管理 | 只提示风险，不改 app-update.yml，不写注册表 / 快捷方式 |
| SmartScreen 红色拦截 | 自签名无效，需 EV 证书或信誉积累 |

平台支持

当前仅支持 Windows。发布者只有 Windows 环境，DSH-NEXT 的实际使用场景也在 Windows。

跨平台并非架构限制——前端与 Tauri 都跨平台，阻塞在 Rust 侧的 Windows 假设
（#[cfg(windows)] 8 处、路径分隔符、%APPDATA% 等）。如果你有对应环境并愿意适配，
欢迎提交 PR，清单见 CONTRIBUTING。

关于代码签名

本项目当前不购买商业代码签名证书。首次运行可能看到两道提示：

| 现象 | 原因 | 处理 |
| 「Windows 已保护你的电脑」 | 无信誉、无 EV 证书 | 点「更多信息 → 仍要运行」 |
| 「无法验证发布者」 | 证书链不受你机器信任 | 同上，或用 SHA256 校验 |

Get-FileHash .\DSH-NEXT-Multi.exe -Algorithm SHA256
与 Release 页面上的 SHA256 逐字符比对

不想看到任何提示：从源码构建（pnpm tauri build --no-bundle）。

长期方案：不签名（当前，0 成本）→ SignPath Foundation（开源免费，解决 UAC）→ EV 证书（约 ¥2300/年，零提示）。
维护者本机自签名：pnpm sign（仅自己机器有效）。

文档

| 想看什么 | 去哪 |
| 全部文档导航 | docs/README.md |
| 设计与取舍 | docs/design.md |
| 初始化向导设计（1.1 规格） | docs/design-onboarding.md |
| 架构与数据流 | docs/reference/architecture.md |
| 数据格式（app.json / 实例 / 指针） | docs/reference/data-format.md |
| 版本兼容性与依赖契约 | docs/reference/compatibility.md |
| 错误码 E1000–E1012 | docs/reference/error-codes.md |
| 配置项与环境变量 | docs/guide/configuration.md |
| 故障排查 | docs/guide/troubleshooting.md |
| 踩过的坑（症状→根因→证据） | docs/experience/ |
| 验收记录 | docs/testing.md |

构建与测试

环境：Node ≥ 20、pnpm ≥ 10、Rust ≥ 1.77（MSVC）、WebView2。

pnpm install
pnpm tauri dev # 开发
pnpm check # svelte-check（0 error 是门槛）
pnpm verify # 设计 token 门禁
cargo test --manifest-path src-tauri/Cargo.toml
node tools/e2e.mjs # 端到端（替身进程，15 项断言）
node tools/check-links.mjs # 文档链接校验
pnpm tauri build --no-bundle # 出 exe

发布（维护者）

1) 三处版本号一致：package.json / src-tauri/Cargo.toml / tauri.conf.json
2) 构建并复制便携 exe
pnpm tauri build --no-bundle
Copy-Item src-tauri\target\release\DSH-NEXT-Multi.exe . -Force
3) 可选：本机自签名（仅自己机器不提示，对外无效）
pnpm sign
4) 打 tag
git tag -a v1.0.0 -m "v1.0.0"

换图标后必须 cargo clean -p dsh-next-multi-launcher --release 再构建，否则 exe 内嵌图标不会更新（见 docs/experience/04-图标与缓存.md）。

贡献

见 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告。

许可

MIT。图标中的鲸鱼剪影取自 DSH-NEXT 的官方图标资源，仅用于表明本工具与 DSH-NEXT 的配套关系；DSH-NEXT 本身的许可与版权归其作者所有。