dsh-profile-bridge

酒馆启动器（官方 DeepSeek Harness）

基于 2NF/dsh-profile-bridge 的 MIT 版本 0.2.0，来源提交 6917177806fcff7d9def83a881c47f8936a70278；保留原作者 LICENSE。

从仓库 README 的「快速开始」安装此标准插件，然后在原版桌面打开「设置 → 酒馆启动器 → 安装酒馆」。安装完成后点「重启并切换到 DSH 酒馆」。如果需要桌面快捷方式，可在同一页点「添加桌面快捷方式」。原版和独立酒馆配置均提供此页面。已有酒馆可通过旧版侧栏更新一次，获得新版启动器。

官方桌面仍从 profiles/desktop 启动，通过目录链接使用 profiles/tavern。这不是官方原生 profile 选择器；配置是独立目录，会话、凭据等仍遵循 DSH 的共享数据规则。

各配置安装此插件后，从「设置 → 酒馆启动器」在原版 DSH 和酒馆之间切换。macOS/Linux 向桌面主进程发 SIGTERM，等同菜单退出（有任务时先确认）；Windows 自动调用官方托盘的退出动作，保留官方任务确认；无法调用时提示手动从托盘退出。助手等待 GUI 和宿主全部退出再切换，然后自动重新打开应用。原版 desktop 保存为 desktop.fresh-*，可从此设置页还原。

兼容修正：不再修改目标 YAML；不强杀进程；无备份不删除入口；失败恢复原入口；并发请求被 pending 锁拒绝。异常终止遗留的 profile-bridge/pending 会记录助手 pid；确认助手已退出后，下一次切换会自动把陈旧记录归档到 profile-bridge/stale/ 再重试。

使用与验证范围

2026-10-17 已在 macOS 官方桌面 0.2.1-rc.2 验证 tavern → 原版 desktop → tavern 往返：两边设置页都能打开“配置档案”（现名“Profile 切换”），正常退出后切换，重新启动后正确加载。2026-10-18 社区贡献者 141HR 在 Windows 11（build 26200）官方桌面 0.2.1-rc.2 验证同样的往返：profiles/desktop 在独立目录与指向 profiles/tavern 的 junction 之间切换，存档与配置不受影响。

• 返回原版：设置 → 酒馆启动器 → 重启并切换到原版 DSH。
• 进入酒馆时，在酒馆启动器页点「重启并切换到 DSH 酒馆」。
• 宿主名称可能仍显示 desktop。实际使用的配置见切换页的「当前配置」。
• 切换前结束生成任务，不要同时从命令行启动相关 profile。切换只改变配置目录入口，不复制或迁移存档；各配置的数据位置由其自身设置决定。
• 保留 desktop.fresh-*，它是还原原版配置所必需的目录；完整备份应同时包含 profiles、profile-data 及其他自定义数据目录。

桌面安装器准备独立 tavern 和两边的切换入口，首次安装保留原版默认配置；只有用户主动选择才建立目录链接。更新保留已有默认选择。安装和更新始终写入 tavern，保留原版配置。

此功能已纳入桌面版安装流程。不要直接将原版插件覆盖到此兼容版上；安装与备份说明见仓库 README.md 的「快速开始」。

2026-10-21 已在 Windows 官方桌面 0.2.1-rc.2 验证按钮自动退出、切换配置并重新打开的双向流程。Windows 退出助手先取得托盘窗口焦点，再调用其退出菜单；仅操作已核对可执行路径的桌面主进程，不强制结束进程。

酒馆安装管理

在「设置 → 酒馆启动器 → 酒馆版本与更新」可查看当前和最新发布的版本与提交号。同一个版本号的新构建也能检测到。两边都能检查更新；在酒馆配置里可以直接更新，等安装完成后重启应用。

同一个设置页提供程序、配置、酒馆数据与共享 DSH 目录的实际位置，以及「切换安装目录」「删除 DSH Tavern」。仅支持可核对安装归属的官方桌面安装；源码运行、未知链接、缺失安装记录或未完成恢复时会拒绝操作。

• 迁移整个酒馆程序、独立 profiles/tavern 和完整 profile-data/tavern（包括会话、存储及 data），不迁移整个 DSH_HOME，不修改原版 DSH 的凭据和共享数据。目标必须是现有父目录下的空文件夹，不能与当前目录重叠。
• 迁移先复制并校验，再切换入口；旧路径保留兼容链接，安装器与应用内更新使用登记的新位置。原目录备份仍占用原磁盘空间，迁移不会自动清空 C 盘，也不会自动删除备份。
• 删除操作先还原原版桌面，然后把酒馆程序和配置移入可恢复隔离目录；酒馆数据、共享数据和备份保留，不卸载官方 DSH。现有酒馆快捷方式不再启动已移除的代码。
• 操作前退出其他 DSH/酒馆窗口、服务和编辑器，结束生成任务；复制期间不要重新启动它们。助手不为迁移/删除强制结束进程。检测到仍在使用的目录或不确定状态时停止，保留原文件和诊断。
• profile-bridge/installation-operation.json 记录操作与保留目录；installation.json 记录已迁移位置或已移除状态。出现需要人工恢复的提示时保留这些文件和日志，不要删除锁或反复安装。已移除状态允许直接重新运行安装器：安装器按首次安装重建 profiles/tavern 与切换入口，成功后清除该标记；若数据仍在迁移磁盘上，则改为仅登记外部数据链接的记录，继续校验实际链接目标，后续仍可更新、再次迁移或删除。数据不搬回原磁盘，被隔离的旧程序目录仍保留在磁盘上；记录损坏或事务未恢复时仍会拒绝安装并提示人工恢复。

安装管理的自动化覆盖为临时目录、故障注入、独立助手进程及设置页交互；新增迁移/删除流程尚未在真实 Windows 桌面、跨盘 junction 和杀毒软件占用环境中验收。上面的历史切换验证不代表安装管理已完成原生桌面验证。