@dsh-workbench/core 0.2.5 → 0.2.6

package/dist/types/shared/api/config-sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/config-sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/config-sync.d.ts

@@ -0,0 +1,46 @@
+import type { RouteHandler } from '@dsh-workbench/shared/host';
+import type { ConfigSyncRow, ConfigSyncSnapshot } from '../config-sync.js';
+export interface PatchBlock {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly body: string;
+    readonly names: readonly string[];
+}
+export declare function patchBlocks(text: string): PatchBlock[];
+export declare function normalizeBlock(body: string): string;
+export declare function syncRows(source: readonly PatchBlock[], own: readonly PatchBlock[], missing: (block: PatchBlock) => readonly string[]): ConfigSyncRow[];
+export declare function mergeBlocks(ownText: string, incoming: readonly PatchBlock[], overwrite: ReadonlySet<string>): {
+    ok: true;
+    text: string;
+    written: string[];
+    skipped: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function readPatchBlocks(path: string): {
+    ok: true;
+    text: string;
+    blocks: PatchBlock[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function writePatchFile(path: string, text: string): void;
+export interface ConfigSyncDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly profileDir: string | null;
+}
+export declare function configSyncHandler(deps: ConfigSyncDeps): RouteHandler;
+export declare function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot;
+export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown): {
+    ok: true;
+    written: string[];
+    skipped: string[];
+    restart: true;
+} | {
+    ok: false;
+    text: string;
+};

package/docs/HANDOFF.md

@@ -58,16 +58,19 @@ npx @dsh-workbench/core
 > `chmod +x ~/.npm/_npx/*/node_modules/@dsh-workbench/core/{scripts/seed-profile.sh,bin/opencli-isolated}`。
 > 0.1.7 起启动器已不吃 x 位，重装那个版本即可根治。
 
-### 设置从哪来：**两边都要的在 `dsh web` 里配**（单向、实时）
+### 设置从哪来：**工作台自己那份说了算**，想要 web 的行就同步一次（ADR-0044）
 
-工作台启动时会用 `--patch` 把 `profiles/web/cordis.patch.yml` 叠在自己的差异层之上
-（`bin/dsh-workbench` 里就在做这件事）。所以：
+工作台**不再**把 `profiles/web/cordis.patch.yml` 叠在自己上面 —— 叠层是最高层，
+它盖住的行在 `:3081` 的 Settings 里**改不动**（dsh 的 config-editor 会被那句
+`overridden by a home patch or command-line overlay` 挡在写文件之前）。
+现在的工作方式：
 
-- **模型供应商 / API key / 搜索源 / MCP** 这类"机器级、两边都要"的设置 ⇒ **在 `:3080` 的 Settings 里配一次**，工作台自动同源；
-- **只有工作台要的**（面板显示哪些模块、会话隔离）⇒ 在 `:3081` 里配，落在它自己的 profile patch，web 看不到；
-- 被 web 声明过的行，在工作台的 Settings 页里会显示 `overridden by a home patch or command-line overlay` —— 那是"这行由 web 管"的**提示**，不是故障。
-
-（这是 `--patch` 单向叠加，不是双向同步：工作台里配的**不会**流回 web。）
+- **要配什么就在 `:3081` 配**，落在 `profiles/workbench/cordis.patch.yml` —— 那是它唯一的那份设置文档；
+- **想用 web 那边已经配好的行**（模型供应商 / API key 引用 / 搜索源 / MCP）⇒ `:3081` →
+  `Meta+,` → 「配置同步」→ 选来源 `web` → 勾行 → 同步 → **重启工作台**。
+  它读的是那个 profile 的 `cordis.patch.yml`，按行搬，只搬**显式配过**的行；
+  同 id 两边内容不同时**默认不覆盖**，要覆盖得自己勾；行点名的包没装会当场说出来。
+- **web 后来改了不会自动过来** —— 再打开这一页，那几行会重新以「差异」标签出现在这一页，拉一次即可。
 
 ### 一条"看起来坏了、其实没坏"的情况
 
@@ -85,14 +88,16 @@ Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化
 ### `setup` 到底做了什么（幂等，可以重复跑）
 
 1. 拿 `~/.dsh/profiles/web` 当模板建 `workbench` profile；
-2. 继承 web 的 bundle 清单 + 设置快照 + patch 点名的依赖；
+2. 继承 web 的 **bundle 清单**（装没装东西 —— 安装范畴，走 `dsh plugin` 通路）；
 3. 追加**数据隔离层**（会话 / 存储 / 附件各走 `~/.dsh/workbench/**`）；
 4. `dsh plugin --profile workbench add @dsh-workbench/core` —— 走 **dsh 自己的**
    安装通路（兼容性预检、profile 写锁、装完自动把 bundle 登记进 profile 清单）。
 
-继承是**一次性快照**，不是订阅：web 之后改设置不会流过来（这正是"互不影响"的实现方式），
-要重新同步得重跑 `setup`。有意共享的只有两样：**API 凭据**（`~/.dsh/.credentials.yaml`，
-一机一把 key）和 `$DSH_HOME/cordis.patch.yml`（机器公共层，对所有 profile 实时生效）。
+**设置不在这一步继承**（这里以前快照 web 的 patch、并继承被它点名的依赖）：新机器上
+`setup` 完的工作台**没有模型供应商**，第一次打开去 设置 → 「配置同步」拉一次即可 ——
+这样每一行都归工作台自己，改得动。有意共享的只有两样：**API 凭据**
+（`~/.dsh/.credentials.yaml`，一机一把 key）和 `$DSH_HOME/cordis.patch.yml`（机器公共层，
+对所有 profile 实时生效）。
 
 ## 四、不想用 npx？仓库副本也可以
 

package/docs/OPERATIONS.md

@@ -26,7 +26,8 @@
 `OPENCLI_PIN` 锁），但它连的 **daemon 是整机一个** —— 见下面「隔离边界」。
 
 前提：`dsh` 和 `pnpm` 在 PATH 上（`dsh plugin` 是转发给 pnpm 的），
-且 `~/.dsh/profiles/web` 已存在（跑过一次 `dsh web` 即可）。
+且 `~/.dsh/profiles/web` 已存在（跑过一次 `dsh web` 即可）—— seed 拿它当**模板**
+（bundle 清单），之后也是「配置同步」的默认来源。
 
 **给别人用**（两条路：插件页装进他自己的 web / 独立实例 `setup`；包在公网 npm 上）见 [`HANDOFF.md`](HANDOFF.md)。
 
@@ -58,9 +59,9 @@
 | 开工作台 | `./bin/dsh-workbench` |
 | 开发（监听改动 + 起工作台） | `pnpm run dev` —— profile 不对会先 `setup`；`:3081` 已在跑就只监听 |
 | 换端口 | `WORKBENCH_PORT=3091 ./bin/dsh-workbench` |
-| 改工作台设置 | 在 `:3081` 的 Settings 页改，落在 `profiles/workbench/cordis.patch.yml` |
-| 改 web 设置 | 在 `:3080` 改，落在 `profiles/web/cordis.patch.yml`。**两边都要的设置（模型供应商、搜索源、MCP）就在这一份里配** —— 工作台启动时会用 `--patch` 把它叠上来（web → 工作台，单向、实时），所以不必配两遍 |
-| 改只有工作台用的设置 | 在 `:3081` 改，落在 `profiles/workbench/cordis.patch.yml`。这个文件**只剩工作台自己的差异**（会话/存储/附件隔离 + 沙箱）；被 web 覆盖过的行在这里改不动（编辑器会写 `overridden`，那就是"这行由 web 管"的提示） |
+| 改工作台设置 | 在 `:3081` 的 Settings 页改，落在 `profiles/workbench/cordis.patch.yml`。**这是工作台唯一的那份设置文档**（没有别处叠在它上面），所以模型供应商 / 搜索源 / MCP 每一行都改得动 |
+| 用 web 那边已经配好的行 | `:3081` → `Meta+,` → 「配置同步」→ 选来源（默认 `web`）→ 勾行 → 同步 → **重启工作台**。只搬你在那个 profile 里**显式配过**的行；行点名的包没装时页面会说出来（ADR-0044） |
+| 改 web 设置 | 在 `:3080` 改，落在 `profiles/web/cordis.patch.yml`。工作台**不会**再自动跟着变 —— 要就跟上面那条同步一次；不想跟就不动 |
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak` 后重跑 seed |
 | **别在设置里关掉工作台** | Settings → 插件里 `@dsh-workbench/core` 那个开关**不要关**。关掉=把它从 profile 的 `bundles` 里移除 → 我们那份 bundle patch（含"禁用出厂左栏"）**整份不再应用** → 页面退化成**原版 dsh web**（左栏回来、右侧面板消失），**数据一个都不丢**。恢复：插件页把开关打开（左栏的「插件」入口也在；进不去设置就按 `Meta+,`）。实测过这条降级路径，不是推断 |
 
@@ -102,8 +103,9 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 
 0. **代码接线** —— 槽位名 / key / id / locale 是否对得上（语法检查抓不到这类错）
 1. **web 是否被动过** —— 与 `--record` 的哈希逐一比对
-2. **组合树差异** —— `dsh web --dump-config` vs `dsh workbench --dump-config`，
-   差异应恰好是隔离行 + 工作台行 + `ui-sidebar` 被禁用
+2. **组合树** —— `dsh workbench --dump-config`：工作台行在位、出厂 `ui-sidebar` 被禁用、
+   启动器里没有 web 设置的叠层（脚本直接判，见 ADR-0044）。两棵树**本来就不该相同**
+   （工作台不再继承 web 的设置），差异只打出来给人看
 3. **数据是否分家** —— `~/.dsh/sessions` 与 `~/.dsh/workbench/sessions` 各自独立
 4. **隔离行是否在位** —— 三个根行都在 `profiles/workbench/cordis.patch.yml` 里
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.2.5"
+    "@dsh-workbench/shared": "0.2.6"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",

package/scripts/seed-profile.sh

@@ -1,11 +1,14 @@
 #!/usr/bin/env bash
 #
 # 一次性引导：从 shipped 的 web 模板创建 workbench profile，
-# 继承 web 的配置（bundle 清单 + 设置快照 + 设置引用到的依赖），
+# 继承 web 的 **bundle 清单**（这台机器上装了哪些 bundle），
 # 再加上会话 / 存储 / 附件的隔离层。
 #
-# 幂等 / 可续跑：profile 已存在就跳过创建，patch 已非空就跳过继承，
-# 隔离层已存在就跳过追加，依赖已在 node_modules 就跳过安装
+# **设置不在这里继承**（这里曾经把 web 的 cordis.patch.yml 快照一份过来）：
+# 工作台自己的 patch 是唯一真相，想搬 web 的哪几行由用户走「设置 → 配置同步」。
+# 为什么这么分（安装 vs 设置）、为什么不再是自动的：.scratch/config-sync/spec.md
+#
+# 幂等 / 可续跑：profile 已存在就跳过创建，隔离层已存在就跳过追加
 # —— 重复运行不会覆盖任何东西。
 # 安全：全程只**读** web 的 profile 目录，只**写** workbench 自己的目录。
 #
@@ -39,11 +42,6 @@ die() {
 
 DST_PATCH="$DST_PROFILE/cordis.patch.yml"
 
-# dsh 生成的 patch 文件带一段注释头，所以"是否还是空层"不能直接和 [] 比。
-is_pristine_patch() {
-  [ "$(grep -v '^[[:space:]]*#' "$1" | tr -d '[:space:]')" = "[]" ]
-}
-
 # ── 第 1 步：创建 profile ────────────────────────────────────────────────
 # --from-default-profile web 只复制 web 模板的 bundle 列表
 # （dsh-base + dsh-web-app），**不**复制 web 的 cordis.patch.yml。
@@ -85,18 +83,7 @@ fs.writeFileSync(process.env.WB_MANIFEST, JSON.stringify(wb, null, 2) + "\n");
 console.log("→ 已继承 web 的 bundle 列表: " + merged.join(", "));
 '
 
-# ── 第 3 步：把 web 的设置文档复制过来，作为「继承」的起点 ──────────────
-# profiles/<name>/cordis.patch.yml 就是 Settings 页的活文档
-# （config-editor.documentPath === profileContext.patchPath）。
-# 复制一份快照，两边之后各自独立演进 —— 这正是「互不干扰」的实现方式。
-if is_pristine_patch "$DST_PATCH"; then
-  cp "$SRC_PROFILE/cordis.patch.yml" "$DST_PATCH"
-  echo "→ 已继承 web 的配置快照"
-else
-  echo "→ profile 的 patch 已非空，跳过继承（避免覆盖你自己的改动）"
-fi
-
-# ── 第 4 步：追加会话 / 存储 / 附件隔离层 ───────────────────────────────
+# ── 第 3 步：追加会话 / 存储 / 附件隔离层 ───────────────────────────────
 if grep -q 'id: session-persistence-jsonl' "$DST_PATCH"; then
   echo "→ 隔离层已存在，跳过"
 else
@@ -105,70 +92,7 @@ else
   echo "→ 已追加隔离层（sessions / storages / attachments 分家）"
 fi
 
-# ── 第 5 步：继承「被 patch 点名」的依赖 ────────────────────────────────
-# 第 3 步把 web 的设置文档整份复制了过来，而那份文档是**按 name: 点名**插件的。
-# 出厂 @deepseek-ai/* 由 dsh 安装本体解析，不必装；但自己装的第三方包
-# （例如 @deepseek-ai/dsh-web-search-exa）只住在 profile 的 node_modules 里
-# —— 不跟着继承的话，那一行会以 "failed to import" 静默不激活，功能凭空少一块。
-#
-# 只继承**被 patch 引用**的那些：web 的 dependencies 里可能有装了却没有任何行
-# 引用的包（本机就有 @aipanel/dsh-client 与 @aipanel/dsh-plugin），整份搬过来
-# 只是死重量。反过来说，**不能只写进 package.json** —— node_modules 得跟上，
-# 否则症状一模一样。
-WANTED="$(
-  WB_MANIFEST="$DST_PROFILE/package.json" \
-    WEB_MANIFEST="$SRC_PROFILE/package.json" \
-    PATCH="$DST_PATCH" \
-    node -e '
-const fs = require("node:fs");
-const read = (p) => JSON.parse(fs.readFileSync(p, "utf8"));
-const wb = read(process.env.WB_MANIFEST);
-const web = read(process.env.WEB_MANIFEST);
-
-// patch 里非注释行的 `name:` —— 注释掉的条目（# 开头）不算引用。
-const referenced = new Set();
-for (const line of fs.readFileSync(process.env.PATCH, "utf8").split("\n")) {
-  if (/^\s*#/.test(line)) continue;
-  const m = /^\s*-?\s*name:\s*"?([^"\s#]+)/.exec(line);
-  if (m) referenced.add(m[1]);
-}
-
-// workbench 自己已有的声明优先 —— 重复 seed 不会覆盖你钉住的版本。
-const own = wb.dependencies || {};
-const missing = {};
-for (const [name, version] of Object.entries(web.dependencies || {})) {
-  if (referenced.has(name) && !(name in own)) missing[name] = version;
-}
-if (Object.keys(missing).length > 0) {
-  wb.dependencies = Object.assign({}, missing, own);
-  fs.writeFileSync(process.env.WB_MANIFEST, JSON.stringify(wb, null, 2) + "\n");
-}
-
-// 报出全部「被点名」的依赖（不只是这次新加的）：node_modules 也可能被清过。
-console.log(
-  Object.keys(web.dependencies || {})
-    .filter((name) => referenced.has(name))
-    .join(" "),
-);
-'
-)"
-
-WANTED_MISSING=0
-if [ -n "$WANTED" ]; then
-  echo "→ patch 引用的依赖（须在 profile 内可解析）: $WANTED"
-  for dep in $WANTED; do
-    [ -d "$DST_PROFILE/node_modules/$dep" ] || WANTED_MISSING=1
-  done
-fi
-
-if [ "$WANTED_MISSING" = "1" ]; then
-  echo "→ node_modules 缺这些依赖，装进 profile（走 dsh 的包管理器）"
-  dsh plugin --profile "$(basename "$DST_PROFILE")" install
-else
-  echo "→ 依赖已齐备，跳过安装"
-fi
-
-# ── 第 6 步：建 DIY 工坊 ────────────────────────────────────────────────
+# ── 第 4 步：建 DIY 工坊 ────────────────────────────────────────────────
 #
 # 工坊是 DIY 模式的落点：agent 在那里造模块（一个模块一个目录），而 **DIY 会话的 cwd 就是它**。
 # 骨架 + 依赖 + 稳定入口都交给 `scripts/seed-workshop.sh` —— 启动器（bin/dsh-workbench）
@@ -186,7 +110,10 @@ fi
 
 cat <<EOF
 
-profile '$DST_PROFILE' 的骨架好了（bundle 清单 + 设置快照 + 隔离层）。
+profile '$DST_PROFILE' 的骨架好了（bundle 清单 + 会话/存储/附件隔离层）。
+
+设置**不在**这里继承：想要 web 那边的模型供应商 / 搜索源 / MCP，起工作台后去
+「设置 → 配置同步」按行勾（读的是那个 profile 的 cordis.patch.yml；搬完重启生效）。
 
 装 bundle —— 两条**等价**的路，任选一条（都走 dsh 的 runPluginCommand，装完会
 把 bundle 登记进 profile 清单）：