@dsh-workbench/core 0.2.4 → 0.2.6

package/README.md

@@ -25,7 +25,7 @@ dsh web (:3080)                       dsh workbench (:3081)
 | --- | --- | --- |
 | `dsh` | 本体。本包在 `0.1.7-rc.2` 上验过 | `npm i -g @deepseek-ai/dsh` |
 | `node` + `pnpm` | dsh 的 `plugin` 子命令是**转发给 pnpm** 的；没有 pnpm 会直接报 `dsh: pnpm was not found` | 各自装 |
-| 跑过一次 `dsh web` | `setup` 拿 `~/.dsh/profiles/web` 当模板（bundle 清单 + 设置快照 + patch 点名的依赖）。没有它会**明确报错**，不会静默建出半个 profile | `dsh web`，起来就行，然后 Ctrl-C |
+| 跑过一次 `dsh web` | `setup` 拿 `~/.dsh/profiles/web` 当模板（**bundle 清单**：这台机器上装了哪些 bundle），也是「配置同步」的默认来源。没有它会**明确报错**，不会静默建出半个 profile | `dsh web`，起来就行，然后 Ctrl-C |
 
 然后两条命令：
 
@@ -74,7 +74,8 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 | 升级 | 重跑一次 `npx --yes @dsh-workbench/core@latest setup`（幂等），再重启工作台进程 |
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak`，再跑一次 `setup` |
 | 彻底不用了 | 删 `~/.dsh/profiles/workbench` 与 `~/.dsh/workbench` 两个目录（都不影响 `dsh web`） |
-| 改设置 | 只有工作台要的（面板显示哪些模块、会话隔离）在 `:3081` 的 Settings 里改 |
+| 改设置 | 在 `:3081` 的 Settings 里改（模型供应商 / 搜索源 / MCP 也是这里） |
+| 从 `dsh web` 搬设置过来 | 设置 → 「配置同步」→ 选来源 → 勾行 → 同步 → 重启工作台 |
 
 ## 和 `dsh web` 的关系
 
@@ -83,10 +84,11 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 - **另一个 profile、另一个端口、另一个进程**：`workbench` profile 在 `~/.dsh/profiles/workbench`；
   会话 / 存储 / 附件 / 模块配置全走 `~/.dsh/workbench/**`，与 web **数据分家**。只有一样有意共享：
   API 凭据（`~/.dsh/.credentials.yaml`，一机一把 key）。
-- **两边都要的设置只在 `dsh web` 里配一次**（模型供应商 / API key / 搜索源 / MCP）：工作台启动时
-  把 web 的 profile patch 叠在自己上面（`--patch`，**单向、实时**）。被 web 管的行在工作台的
-  Settings 页里会显示 `overridden by a home patch or command-line overlay` —— 那是**提示**，不是故障。
-  反向不成立：工作台里配的不会流回 web。
+- **设置是工作台自己那份**：模型供应商 / 搜索源 / MCP 都在 `:3081` 的 Settings 里配，
+  落在 `profiles/workbench/cordis.patch.yml` —— 那是它唯一的一份设置文档，每一行都改得动。
+  想用 `dsh web` 那边已经配好的行：`:3081` → `Meta+,` → 「配置同步」→ 选来源 → 勾行 → 同步 →
+  **重启工作台**（只搬显式配过的行；同 id 内容不同默认不覆盖）。web 后来改的不会自动过来，
+  再打开这一页拉一次即可。见 [ADR-0044](../../docs/adr/0044-config-sync-replaces-the-web-patch-overlay.md)。
 - ⚠️ **别在 Settings → 插件里把 `@dsh-workbench/core` 关掉**：关掉 = 它那份 bundle patch 整份不再应用
   （包括里面的"禁用出厂左栏"），界面会**退化成原版 dsh web**（左栏回来、右侧面板消失）。
   **数据一个都不丢**；把开关拨回来就恢复 —— 进不去设置页就按 `Meta+,`。别当成故障去重建 profile。
@@ -101,6 +103,8 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 | 打开面板 / 按刷新要等 5–8 秒 | 正常：opencli 每次调用有**固定约 5 秒**开销（起浏览器会话）。**没有缓存**，数据一律实时 |
 | 体检那屏说「检测浏览器通道 · 没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致，daemon 被顶成对方那版；下一条浏览器命令会自动把它重启回来，体检复检后改回「已连接」 |
 | 一切正常，但左栏是出厂样子、右边没有面板 | 工作台插件在 Settings 里被关了（见上一条 ⚠️） |
+| 模型列表里只有出厂的几个、没有自己配的供应商 | 新装的 profile 不带设置（ADR-0044）：设置 → 「配置同步」→ 选来源 → 勾 `llm-` 那几行 → 同步 → 重启 |
+| 「配置同步」里某一行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），再重启 |
 
 排障全表在仓库的 [`docs/OPERATIONS.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/packages/workbench/docs/OPERATIONS.md)；
 把工作台装到别人机器上的前置清单见 [`docs/HANDOFF.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/packages/workbench/docs/HANDOFF.md)。

package/bin/dsh-workbench

@@ -138,51 +138,18 @@ else
   export DSH_WORKBENCH_ROOT="$REPO_DIR"
 fi
 
-# ── 把 web 的设置**叠加**上来（web → 工作台，单向、实时）────────────────────
+# ── 设置从哪来：工作台自己的 profile patch（不再叠 web 那一份）──────────────
 #
-# 为什么叠而不是复制：`seed-profile.sh` 是把 web 的设置**快照一份**过来，之后两边各自
-# 演进 —— 于是"在 web 里加了个模型供应商，工作台却少一个"这种漂移迟早发生（实测撞过）。
-# 叠加则是**同一个来源**：供应商 / 搜索源 / MCP 这类机器级设置只在 `dsh web` 里配一次。
+# 以前每次启动都用 `--patch` 把 `profiles/web/cordis.patch.yml` 叠成**最高层**。
+# 代价是那一层盖住的行在 :3081 的 Settings 里**改不动**：dsh 的 config-editor 写文件
+# **之前**会拿组合后的值跟你写的值对，不等就抛
+# `overridden by a home patch or command-line overlay` —— 文件根本没写。
+# 症状就是"模型供应商这类设置只能去 :3080 改，工作台这边看着能点、点了没用"。
 #
-# 为什么是这一层（`--patch`）而不是机器公共层 `$DSH_HOME/cordis.patch.yml`：
-# 公共层对所有 profile 生效且**没有 UI 写入路径**（配置编辑器只写当前 profile 的 patch）
-# —— 把设置放进去等于要求用户手编。而 `--patch` 叠的是 web 的 profile patch，
-# 用户在 web 的 Settings 页里配的就是它，配完即生效。
-#
-# 副作用（刻意的）：被这一层覆盖的行，在工作台的 Settings 页里会显示
-# `overridden by a home patch or command-line overlay` —— 那正是"这行由 web 管"的提示。
-# 反向不成立：工作台里配的只落在自己的 profile patch（差异层），web 看不到。
-# ⚠️ 叠之前先剥掉「每个界面自己的偏好」那一类。
-#
-# `--patch` 是最高层，被它覆盖的行在工作台的 Settings 页里会显示
-# "overridden by a home patch or command-line overlay"、**改了也会跳回去**。
-# 供应商 / 搜索源 / MCP 那类机器级设置这样管是对的；但 `ui-theme.preference`
-# 是**每个界面自己的**偏好（有人要 web 深色、工作台浅色），叠上来等于把工作台的
-# 主题锁成 web 的 —— 实测就是"切到浅色自动跳回深色"。
-#
-# 剥的方式：按顶层列表项过滤，命中 id 的那一项整块不要（缩进到下一个 `- ` 为止）。
-WEB_PATCH="$DSH_HOME/profiles/web/cordis.patch.yml"
-WORKBENCH_PATCH_STRIP="${DSH_WORKBENCH_PATCH_STRIP:-ui-theme}"
+# 现在改成：**工作台自己的 patch 是唯一真相**。想要 web 的哪几行，去
+# 设置 → 「配置同步」里勾（它读源 profile 的 cordis.patch.yml，按行搬运，
+# 见 .scratch/config-sync/spec.md 与 ADR-0044）。启动器只负责把工作台起起来。
 PATCH_ARGS=()
-WEB_PATCH_LAYER="$WEB_PATCH"
-if [ -f "$WEB_PATCH" ]; then
-  if [ -n "$WORKBENCH_PATCH_STRIP" ]; then
-    WEB_PATCH_LAYER="$(mktemp -t dsh-workbench-web-patch)"
-    trap 'rm -f "$WEB_PATCH_LAYER"' EXIT INT TERM
-    awk -v strip="$WORKBENCH_PATCH_STRIP" '
-      /^- / {
-        id = $0
-        sub(/^- id:[[:space:]]*/, "", id)
-        sub(/[[:space:]]*$/, "", id)
-        skip = (id == strip)
-      }
-      !skip { print }
-    ' "$WEB_PATCH" > "$WEB_PATCH_LAYER"
-  fi
-  PATCH_ARGS=(--patch "$WEB_PATCH_LAYER")
-else
-  echo "dsh-workbench: 提醒 —— 找不到 ${WEB_PATCH}，这次不叠加 web 的设置（供应商等可能不全）。" >&2
-fi
 
 # ── 声明工作台运行时的**可写根**（执行缝的沙箱只放行 process.cwd()）──────────
 #
@@ -195,7 +162,7 @@ fi
 #
 # 为什么是 `--patch` 叠加而不是改 profile 的 cordis.patch.yml：profile 可能是旧的
 # （交接出去的机器尤其如此），没人会回头重跑 seed；叠加层每次启动都生效。
-# ⚠️ 必须排在 web 的 patch **之后**：工作台的可写根要赢。
+# ⚠️ 必须排在 profile 自己那一层**之后**：工作台的可写根要赢。
 SANDBOX_PATCH="$REPO_DIR/profile/sandbox.patch.yml"
 if [ -f "$SANDBOX_PATCH" ]; then
   PATCH_ARGS+=(--patch "$SANDBOX_PATCH")