@dsh-workbench/core 1.1.0 → 1.1.2

package/README.md

@@ -46,13 +46,18 @@ dsh-workbench migrate --force  # 已经迁过一次、想再补并一次
 更新后也可以直接在模块市场的「工作台」那一行点「迁移旧数据」；和命令行是同一条迁移逻辑，不需要自己敲命令。
 这条提示是非硬性的：也可以点「不再提醒」把它收起——不会删旧数据，旧项目仍然留在旧目录，以后需要时仍可跑 `dsh-workbench migrate`。
 
-先决条件（就三条）：
+先决条件：
 
 | 要有 | 为什么 |
 |---|---|
 | `dsh` ≥ 0.2.1-rc.2 | 本体。更旧的会被拒绝：`engines.dsh` 声明了下限，老到不认这个字段的 dsh 由启动器当场拒绝并给升级命令 |
 | Node + pnpm | dsh 的 `plugin` 子命令转发给 pnpm；没有 pnpm 会报 `dsh: pnpm was not found` |
-| 可选：跑过一次 `dsh web` | 想继承它的设置 / 项目时。只建工作台不需要 |
+| 可选：跑过一次 `dsh web` | 想继承它的设置 / 插件时。只建工作台不需要 |
+
+还有一个**装一次就够**的：**OpenCLI 浏览器扩展**（opencli 的浏览器插件）。工作台会自己装 opencli 的隔离运行时，但扩展得你
+在浏览器里装 —— 面板读的是你浏览器里的登录状态。Chrome / Edge / Brave / Chromium / Vivaldi 都行，
+从 [Chrome 应用商店](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk)
+装好并启用，浏览器保持开着。不装也能进工作台，只是要靠登录状态的面板取不到数据；细节见下面「首次打开会自己做什么」。
 
 ## 命令行
 
@@ -108,7 +113,7 @@ dsh-workbench migrate --force  # 已经迁过一次、想再补并一次
 只有设置与插件各一份。旧版本分过家的实例，启动时**不会**自动并；先退出所有 dsh，再跑
 `dsh-workbench migrate`（只补不覆盖，旧目录保留）。
 
-设置只有一份，写在哪都看得见：
+设置只落在 profile 里（跟会话 / 项目不同，不共用）：
 
 - 独立实例：`:3081` → Settings，落进 `profiles/<名字>/cordis.patch.yml`，每一行都改得动。
 - 想用 `dsh web` 已经配好的行：`:3081` → `Meta+,` → 「工作台设置」→「配置同步」→
@@ -142,6 +147,9 @@ dsh-workbench migrate --force  # 已经迁过一次、想再补并一次
 - **装 opencli 的隔离运行时**：落在 `~/.dsh/workbench/opencli/`，靠改 `HOME` 与插件目录分开，
   **完全不碰**你本机的 `~/.opencli`。装不上时（没网 / 源不通）失败态里有一条能直接照抄到终端
   的命令 —— 那条得在终端跑，工作台自己发起的命令带文件沙箱。
+- **浏览器扩展要你装一次**：`~/.dsh/workbench/opencli/` 里没有扩展，opencli 靠浏览器里的
+  OpenCLI 扩展把登录状态接过来。自检里「浏览器连接」没连上时会给商店链接，装完并启用、
+  保持浏览器开着，回「准备工作台」那一屏点「重试」。Desktop 里还能点「打开浏览器」。
 - **要面板有数据，得登录对应平台**：卡片上点「去登录 ↗」，登完切回来按「重试」
   （刻意不做自动重试 —— 登录什么时候完成我们不知道）。
 - 没登录 / 装不上都是**明确的失败态**，不留白屏让人猜。
@@ -155,8 +163,9 @@ dsh-workbench migrate --force  # 已经迁过一次、想再补并一次
 | 左栏是出厂样子、右边没有面板 | 工作台插件在 Settings 里被关了（见上一节 ⚠️）。重启后启动器不会再让你拿到这种实例 |
 | 面板一直空着 | 多半是没登录平台（见上）；或这个工作区的 git `origin` 不指向它要读的平台 |
 | 打开面板 / 按刷新要等 5–8 秒 | 正常：opencli 每次调用有固定约 5 秒开销（起浏览器会话）。没有缓存，数据一律实时 |
-| 体检说「检测浏览器通道 · 没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致，daemon 被顶成对方那版；下一条浏览器命令会自动把它重启回来，复检后改回「已连接」 |
-| Desktop 里体检一直「没连上」 | 浏览器没开。预检页有「打开浏览器」，点了才开上次承载扩展的那个（没记住就用 Chrome），开完自动复检；点了会切到 Chrome 前台（冷启动抢焦点，静默做不到）。仍连不上多半是扩展没装或被禁用 |
+| 自检说「浏览器连接 · 还没连上」/ 面板取不到数据 | 扩展没装或没启用：从 [Chrome 应用商店](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk)装 OpenCLI，在扩展页确认启用，保持浏览器开着，回「准备工作台」那一屏点「重试」。多个浏览器账号会要求先选默认的那个：按页面上给的那条命令做 |
+| 体检说「浏览器连接 · 还没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致，daemon 被顶成对方那版；下一条浏览器命令会自动把它重启回来，复检后改回「已连接」 |
+| Desktop 里体检一直「没连上」 | 浏览器没开。「准备工作台」那一屏有「打开浏览器」，点了才开上次承载扩展的那个（没记住就用 Chrome），开完自动复检；点了会切到 Chrome 前台（冷启动抢焦点，静默做不到）。仍连不上多半是扩展没装或被禁用 |
 | 模型列表里只有出厂的几个、没有自己配的供应商 | 新 profile 不带设置。设置 → 工作台设置 → 配置同步 → 勾 `llm-` 那几行 → 同步 |
 | 配置同步里某行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），装完 dsh 会自行重组，它报 `restartReason` 时才重启 |
 | 启动被拒，说 dsh 太旧 | `npm i -g @deepseek-ai/dsh@latest`，装完重启工作台 |

package/bin/dsh-workbench

@@ -271,7 +271,13 @@ run_setup() {
 
 （全局装过就用 dsh-workbench；npx 就用 npx @dsh-workbench/core；本仓开发用 ./packages/core/bin/dsh-workbench。）
 
-首次打开会走启动体检，它会自己把 opencli 的隔离运行时装好 —— 不用你动手。
+首次打开会走启动体检，它会自己把 opencli 的隔离运行时装好。还有一步要你动手：
+在浏览器里装一次 OpenCLI 扩展（Chrome / Edge / Brave / Chromium / Vivaldi 都行）：
+
+  https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk
+
+装完确认已启用、浏览器保持开着；启动后如果「浏览器连接」还没连上，回「准备工作台」那一屏点「重试」。
+面板读的是你浏览器里的登录状态；不装也能进工作台，只是要靠登录状态的面板取不到数据。
 EOF
 }