迁移到 dsh-browser-plus

如果你的 DSH profile 仍装着旧版浏览器插件（package name 为 dsh-builtin-browser），按本指南切换到 dsh-browser-plus 并迁移登录态。

步骤

1. 导出当前浏览器登录态(可选但推荐)

在旧包仍生效的 DSH 会话中:

browser_auth action="flush"      # 把返回的 cookies JSON 保存到文件

2. 安装新包(正式名 dsh-browser-plus)

# 从 GitHub 安装(推荐;或使用 release tarball 或源码目录)
dsh plugin --profile web add github:ParticleLight/dsh-browser-plus

3. 移除已替换的旧包(可选)

dsh plugin --profile web remove dsh-builtin-browser   # 如实际安装名如此

4. 恢复登录态

新包会话中:

browser_auth action="restore" cookies=<步骤1保存的JSON>

说明:宿主 userData 目录已从 dsh-builtin-browser-host 改为 dsh-browser-plus-host (host-main.ts app.setPath('userData', ...)),因此 cookie 不会自动迁移,必须走一遍 export/import。

变更对使用者可见的部分

• 当前共 35 个 browser_* 工具；除输入、文件和任务工具外，新增语义导航、滚动、快照引用、任务状态与显式人机交接。
• 一个共享可见浏览器窗口，每个 DSH 任务保持隔离视图、标签与历史；页面任务管理器切换任务，后台任务操作不会抢走当前页面。browser_space label="..." 命名浏览器任务，空参列出任务。
• JS 对话框自动 accept,记录见 browser_history(action dialog)。
• Electron 锁定 42.9.3(43.4.1 组合器故障,勿升)。

重启要求

迁移 profile bundle 后请重启 DSH Web，确保旧 loader entry 完整卸载、新包以 dsh-browser-plus 身份加载（见 docs/SOAK-CHECKLIST.md）。