@dsh-workbench/core 1.0.0-beta.1 → 1.0.1

package/README.md

@@ -12,7 +12,7 @@
 
 | 装法 | 命令 | 得到什么 |
 |---|---|---|
-| 独立实例（推荐） | `npx @dsh-workbench/core create` | 自己的 profile、`:3081`、独立进程与数据 |
+| 独立实例（推荐） | `npx @dsh-workbench/core create` | 自己的 profile、`:3081`、独立进程；会话 / 项目 / 附件跟 web 共用 |
 | 装进现有 `dsh web` | 侧栏 Plugins → Add plugin → `@dsh-workbench/core` → Install → Enable now → 刷新 | 当前实例多一列面板，会话不变 |
 | 装进 Desktop | 同上，装完重开窗口 | Desktop 里多一列面板 |
 
@@ -24,23 +24,32 @@ npx --yes @dsh-workbench/core@latest setup        # 或非交互：建默认的
 npx @dsh-workbench/core                           # 起 :3081
 ```
 
-`create` 有 `dsh web` 就拿它当模板，并问要不要复制设置、本地插件、项目列表和会话；
-本机一个 profile 都没有时，用 dsh 出厂的 web 模板建一个空的。脚本 / CI 里直接给参数：
+`create` 有 `dsh web` 就拿它当模板，并问要不要复制设置；会话、项目、附件本来就共用，
+不用复制。本机一个 profile 都没有时，用 dsh 出厂的 web 模板建一个空的。脚本 / CI 里直接给参数：
 
 ```bash
-npx --yes @dsh-workbench/core@latest setup --from web --profile wb2 --with-sessions
+npx --yes @dsh-workbench/core@latest setup --from web --profile wb2
 npx @dsh-workbench/core --profile wb2
 ```
 
 全局装过就不用 `npx`：`npm i -g @dsh-workbench/core` 之后直接 `dsh-workbench`。
 
+从 1.0.0 之前的独立实例升上来：旧数据**不会**自动并。先退出所有 dsh，再跑：
+
+```bash
+dsh-workbench migrate          # 切共用根 + 并旧会话/项目/附件
+dsh-workbench migrate --force  # 已经迁过一次、想再补并一次
+```
+
+只会补缺、不覆盖；旧目录保留。npx 用户把 `dsh-workbench` 换成 `npx @dsh-workbench/core`。
+
 先决条件（就三条）：
 
 | 要有 | 为什么 |
 |---|---|
 | `dsh` ≥ 0.2.1-rc.2 | 本体。更旧的会被拒绝：`engines.dsh` 声明了下限，老到不认这个字段的 dsh 由启动器当场拒绝并给升级命令 |
 | Node + pnpm | dsh 的 `plugin` 子命令转发给 pnpm；没有 pnpm 会报 `dsh: pnpm was not found` |
-| 可选：跑过一次 `dsh web` | 想继承它的设置 / 插件 / 项目时。只建工作台不需要 |
+| 可选：跑过一次 `dsh web` | 想继承它的设置 / 项目时。只建工作台不需要 |
 
 ## 命令行
 
@@ -48,10 +57,11 @@ npx @dsh-workbench/core --profile wb2
 |---|---|
 | `dsh-workbench create` | 交互式新建一个工作台实例 |
 | `dsh-workbench setup` | 幂等建默认的 `workbench` profile；配 `--from` 建别的名字 |
+| `dsh-workbench migrate` | 把旧实例的会话 / 项目 / 附件并到共用数据根（`--force` 可重跑） |
 | `dsh-workbench` | 起工作台（默认端口 `:3081`，其余参数透传给 `dsh web`） |
 | `dsh-workbench --profile <名字>` | 起指定实例 |
 | `dsh-workbench setup --from <来源> --profile <新名>` | 以某个现有 profile 为模板建一个 |
-| `--with-sessions` / `--no-settings` / `--no-plugins` / `--no-projects` | 复制 / 不复制哪一类（默认复制设置、插件、项目，不复制会话） |
+| `--no-settings` | 不复制来源的设置（默认复制 `--from` 那份里改已有插件的行） |
 | `dsh-workbench --help` | 用法；其余参数透传给 `dsh web` |
 
 环境变量：
@@ -60,8 +70,8 @@ npx @dsh-workbench/core --profile wb2
 |---|---|---|
 | `WORKBENCH_PORT` | `3081` | 端口；`dsh web` 默认 `:3080`，两边可以同时开 |
 | `WORKBENCH_PROFILE` | `workbench` | 用哪个 profile（等价于 `--profile`） |
-| `DSH_HOME` | `~/.dsh` | dsh 的数据根 |
-| `DSH_WORKBENCH_HOME` | `$DSH_HOME/workbench` | 工作台自己的数据根（opencli 运行时、模块、截图…） |
+| `DSH_HOME` | `~/.dsh` | dsh 的数据根；会话 / 项目 / 附件都在这里，工作台跟 web 共用 |
+| `DSH_WORKBENCH_HOME` | `$DSH_HOME/<profile>` | 工作台运行时根（opencli 隔离运行时、工坊、模块市场、自更新） |
 
 装进 `dsh web` 或 Desktop 时没有启动命令：它们用自己那一份 profile，工作台只是其中一层插件。
 
@@ -75,28 +85,31 @@ npx @dsh-workbench/core --profile wb2
 | `client.js` | 浏览器侧 bundle，dsh 客户端按 `dsh.client` 加载 |
 | `cordis.patch.yml` | 把自己插进 profile 组合图的补丁（装载） |
 | `preset/diy.patch.yml` | 「工作台 DIY 模式」的 preset；由 `scripts/gen-diy-preset.mjs` 从 dsh 出厂那份 `standard.patch.yml` 派生（生成后提交，selfcheck 盯过期） |
-| `profile/` | 出厂 profile 模板（隔离 opencli、可写根两份补丁） |
+| `profile/` | 出厂 profile 模板：可写根那一行（启动器 `--patch` 用，seed 也抄进 profile） |
 | `skills/` | 模块 DIY 指引，装好后挂给 agent；漏了不报错，只是 agent 不知道要怎么做模块 |
 | `bin/` | `dsh-workbench` 启动器、隔离 opencli 的入口 |
-| `scripts/` | 随包出货的脚本：`seed-profile.sh` / `seed-workshop.sh` / `create-workbench.mjs` / `clone-profile.mjs` |
+| `scripts/` | 随包出货的脚本：`seed-profile.sh` / `seed-workshop.sh` / `create-workbench.mjs` / `clone-profile.mjs` / `share-data-root.mjs` |
 
 ## 数据落在哪
 
 | 内容 | 位置 |
 |---|---|
 | profile（设置、`node_modules`、`cordis.patch.yml`） | `~/.dsh/profiles/<名字>` |
-| 工作台数据（模块、面板、截图与录制、opencli 运行时） | `~/.dsh/workbench/**` |
+| 会话、项目列表、附件 | `~/.dsh/{sessions,storages,attachments}` —— 跟 `dsh web` / Desktop **共用一份** |
+| 工作台运行时（opencli 隔离运行时、工坊、模块市场、自更新日志） | `~/.dsh/workbench/**`；别的 profile 是 `~/.dsh/<名字>/**` |
+| 面板与模块配置 | `~/.dsh/workbench/workspaces/**` |
 | API 凭据 | `~/.dsh/.credentials.yaml` —— 它与 `dsh web` **有意共用**，一台机器一把 key |
 | DIY 工坊依赖安装日志 | `~/.dsh/workbench/seed.log` |
 
-独立实例与 `dsh web` **数据分家**：各自会话、各自设置，互不影响。装进 `dsh web` / Desktop
-则沿用它们自己的会话与存储，面板与模块配置照旧落在 `~/.dsh/workbench/**`。
+独立实例**只分 profile，不分数据根**：会话、项目、附件跟 `dsh web` 和 Desktop 是同一份，
+只有设置与插件各一份。旧版本分过家的实例，启动时**不会**自动并；先退出所有 dsh，再跑
+`dsh-workbench migrate`（只补不覆盖，旧目录保留）。
 
 设置只有一份，写在哪都看得见：
 
 - 独立实例：`:3081` → Settings，落进 `profiles/<名字>/cordis.patch.yml`，每一行都改得动。
 - 想用 `dsh web` 已经配好的行：`:3081` → `Meta+,` → 「工作台设置」→「配置同步」→
-  选来源 → 勾行 → 同步，即时生效。只搬显式配过的行，同 id 内容不同默认不覆盖；
+  选来源 → 勾行 → 同步，即时生效。只同步显式配过的行，同 id 内容不同默认不覆盖；
   web 后来改的不会自动过来，再打开这一页拉一次即可。
 
 ## 日常
@@ -108,9 +121,9 @@ npx @dsh-workbench/core --profile wb2
 | 升级 | 重跑一次 `npx --yes @dsh-workbench/core@latest setup`（幂等），然后重启工作台。工坊工具链会在下一次启动时自动跟到同代，不必手动删工坊 |
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak`，再跑一次 `setup` |
 | 换左栏 | 设置 → 工作台设置 → 会话列表：默认官方；切完自动刷新页面生效（从旧版升上来第一次要重启） |
-| 从 `dsh web` 搬设置 | 设置 → 工作台设置 → 配置同步 → 选来源 → 勾行 → 同步 |
+| 从 `dsh web` 同步设置 | 设置 → 工作台设置 → 配置同步 → 选来源 → 勾行 → 同步 |
 | 装模块 | `:3081` 的「工作台模块市场」，或让 agent 装 |
-| 彻底不用了 | 删 `~/.dsh/profiles/workbench` 与 `~/.dsh/workbench` 两个目录（都不影响 `dsh web`） |
+| 彻底不用了 | 删 `~/.dsh/profiles/workbench` 与 `~/.dsh/workbench` 两个目录（会话 / 项目 / 附件在 `~/.dsh` 下，不跟着删） |
 
 外壳本身**零业务模块**：右侧面板装什么有什么。装进 `dsh web` / Desktop 时少一条命令 ——
 没有独立端口与进程，改用它们自己的插件页装模块。

package/bin/dsh-workbench

@@ -6,14 +6,14 @@
 #   ./bin/dsh-workbench setup                 #    建默认 workbench profile（幂等）
 #   ./bin/dsh-workbench setup --from web --profile wb2
 #                                            #    以 web 为模板建一个独立工作台
-#   ./bin/dsh-workbench setup --from web --profile wb2 --with-sessions
-#                                            #    连会话一起复制
 #   ./bin/dsh-workbench --profile wb2         # ② 起指定 profile，默认 :3081
 #   ./bin/dsh-workbench --no-open             #    其余参数透传给 dsh web
+#   ./bin/dsh-workbench migrate               #    把旧实例的会话/项目/附件并到共用数据根（--force 可重跑）
 #   ./bin/dsh-workbench --help
 #
-# 与 `dsh web` 完全独立：不同的 profile 目录、不同的 node_modules、
-# 不同的端口、独立的进程。两个可以同时开着，互不干扰。
+# 与 `dsh web` 并存：不同的 profile、不同的 node_modules、不同的端口、独立的进程。
+# 会话 / 项目 / 附件跟 `dsh web` 和 Desktop 共用一份（都在 $DSH_HOME 下），
+# 只有设置与插件分家；运行时的 opencli、工坊、模块市场仍按 profile 各一份。
 #
 # ── 这份脚本有两种身份，它自己分得清 ──────────────────────────────────────
 #   · **仓库副本**（这个包落在一个 git 工作树里）：开发用。bundle 以 link 方式装本目录，
@@ -36,6 +36,8 @@ PROFILE_EXPLICIT=0
 [ -n "${WORKBENCH_PROFILE:-}" ] && PROFILE_EXPLICIT=1
 SETUP=0
 CREATE=0
+MIGRATE=0
+FORCE=0
 DSH_ARGS=()
 
 die() {
@@ -44,7 +46,7 @@ die() {
 }
 
 usage() {
-  sed -n '3,13p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+  sed -n '3,12p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
 }
 
 if [ "${1:-}" = "create" ]; then
@@ -55,6 +57,10 @@ if [ "${1:-}" = "setup" ]; then
   SETUP=1
   shift
 fi
+if [ "${1:-}" = "migrate" ]; then
+  MIGRATE=1
+  shift
+fi
 
 while [ $# -gt 0 ]; do
   case "$1" in
@@ -72,11 +78,16 @@ while [ $# -gt 0 ]; do
       WB_CLONE=1
       shift 2
       ;;
-    --with-sessions) WB_COPY_SESSIONS=1; shift ;;
-    --no-sessions) WB_COPY_SESSIONS=0; shift ;;
+    --with-sessions | --no-sessions | --no-projects)
+      echo "dsh-workbench: 会话与项目跟 dsh web 共用一份数据根，$1 不再需要（忽略）。" >&2
+      shift
+      ;;
+    --force)
+      [ "$MIGRATE" = "1" ] || die "--force 只用于 migrate"
+      FORCE=1
+      shift
+      ;;
     --no-settings) WB_COPY_SETTINGS=0; shift ;;
-    --no-plugins) WB_COPY_PLUGINS=0; shift ;;
-    --no-projects) WB_COPY_PROJECTS=0; shift ;;
     help | --help | -h) usage; exit 0 ;;
     --) shift; DSH_ARGS+=("$@"); break ;;
     *) DSH_ARGS+=("$1"); shift ;;
@@ -86,14 +97,25 @@ done
 if [ "$SETUP" = "1" ] && [ ${#DSH_ARGS[@]} -gt 0 ]; then
   die "setup 不认识这些参数：${DSH_ARGS[*]}"
 fi
+if [ "$MIGRATE" = "1" ] && [ ${#DSH_ARGS[@]} -gt 0 ]; then
+  die "migrate 不认识这些参数：${DSH_ARGS[*]}"
+fi
 if [ "${WB_CLONE:-0}" = "1" ] && [ "$PROFILE_EXPLICIT" = "0" ]; then
   die "用 --from 时还要指定 --profile <新名字>（例如 --from web --profile wb2）"
 fi
 
+# `desktop` 只归 Desktop app 管（Electron 自己起 profile、自己决定数据根），dsh 那边也拒。
+# 更要紧的是 setup：它把隔离层**追加**进目标 profile —— 目标是 desktop 时，那个 profile
+# 就再也看不到 `$DSH_HOME/sessions` 里的历史，而且一声不响（2026-10-23 发生过一次）。
+if [ "$PROFILE" = "desktop" ]; then
+  die "'desktop' 只归 Desktop app 管（dsh 自己也拒）—— 换一个名字，例如 --profile wb2"
+fi
+
 export WORKBENCH_PROFILE="$PROFILE"
 export WB_CLONE="${WB_CLONE:-0}"
 PROFILE_DIR="$DSH_HOME/profiles/$PROFILE"
-# 每个 profile 一份自己的运行时数据根；默认 profile 仍是 <home>/workbench。
+# 每个 profile 一份自己的**运行时**根（opencli 隔离运行时、工坊、模块市场）；
+# 会话 / 项目 / 附件不在这里 —— 它们跟 `dsh web` / Desktop 共用 $DSH_HOME。
 WORKBENCH_HOME="${DSH_WORKBENCH_HOME:-$DSH_HOME/$PROFILE}"
 export DSH_WORKBENCH_HOME="$WORKBENCH_HOME"
 
@@ -203,25 +225,9 @@ run_setup() {
   bash "$REPO_DIR/scripts/seed-profile.sh"
 
   if [ "${WB_CLONE:-0}" = "1" ]; then
-    if [ -z "${WB_SOURCE_HOME:-}" ]; then
-      SRC_PATCH="$DSH_HOME/profiles/$SRC_PROFILE/cordis.patch.yml"
-      if grep -q 'id: session-persistence-jsonl' "$SRC_PATCH" 2>/dev/null; then
-        if [ "$SRC_PROFILE" != "workbench" ] && grep -q 'DSH_WORKBENCH_HOME' "$SRC_PATCH" 2>/dev/null; then
-          WB_SOURCE_HOME="$DSH_HOME/$SRC_PROFILE"
-        else
-          WB_SOURCE_HOME="$DSH_HOME/workbench"
-        fi
-      else
-        WB_SOURCE_HOME="$DSH_HOME"
-      fi
-    fi
     WB_SOURCE_PROFILE="$SRC_PROFILE" \
       WB_TARGET_PROFILE="$PROFILE" \
-      WB_SOURCE_HOME="$WB_SOURCE_HOME" \
       WB_COPY_SETTINGS="${WB_COPY_SETTINGS:-1}" \
-      WB_COPY_PLUGINS="${WB_COPY_PLUGINS:-1}" \
-      WB_COPY_PROJECTS="${WB_COPY_PROJECTS:-1}" \
-      WB_COPY_SESSIONS="${WB_COPY_SESSIONS:-0}" \
       node "$REPO_DIR/scripts/clone-profile.mjs" || die "从 $SRC_PROFILE 初始化 $PROFILE 失败"
   fi
 
@@ -281,6 +287,22 @@ if [ ! -f "$PROFILE_DIR/package.json" ]; then
   exit 1
 fi
 
+if [ "$MIGRATE" = "1" ]; then
+  MIGRATE_ARGS=(--migrate)
+  [ "$FORCE" = "1" ] && MIGRATE_ARGS+=(--force)
+  WORKBENCH_PROFILE="$PROFILE" DSH_HOME="$DSH_HOME" DSH_WORKBENCH_HOME="$WORKBENCH_HOME" \
+    node "$REPO_DIR/scripts/share-data-root.mjs" "${MIGRATE_ARGS[@]}" || exit 1
+  if [ "$PROFILE" = "workbench" ]; then
+    START_CMD="$REPO_DIR/bin/dsh-workbench"
+  else
+    START_CMD="$REPO_DIR/bin/dsh-workbench --profile $PROFILE"
+  fi
+  echo
+  echo "迁移结束。现在起工作台：$START_CMD"
+  echo "如果 dsh web 刚才也开着，先重启它，让它从共用根重新读一遍。"
+  exit 0
+fi
+
 # ── 硬门禁：工作台 bundle 必须**被选中**（在 `dsh.profile.bundles` 里）─────────
 #
 # 判据只能是 `dsh.profile.bundles`，**不能** grep 整个 package.json：依赖装着 ≠ 被选中。
@@ -316,6 +338,17 @@ if [ "$BUNDLE_GUARD" -ne 0 ]; then
   exit 1
 fi
 
+# ── 已有实例：只整理配置，旧数据不自动迁移
+#
+# 旧版本给 workbench profile 追加过隔离的三行（sessions / storages / attachment 指到
+# `$DSH_HOME/workbench/**`）。现在缺省跟 Desktop 一样「只分 profile、不分数据根」；
+# 但如果旧目录里还有数据、且没有 `.data-root-shared`，这里只打印 migrate 提示，
+# 不改 profile、不动数据 —— 由用户自己决定什么时候并。
+# 必须排在这里（exec dsh 之前）：配置要在这一代 dsh 读进去之前就定好。
+WORKBENCH_PROFILE="$PROFILE" DSH_HOME="$DSH_HOME" DSH_WORKBENCH_HOME="$WORKBENCH_HOME" \
+  node "$REPO_DIR/scripts/share-data-root.mjs" ||
+  echo "dsh-workbench: 提醒 —— 数据根配置没整理成（见上一行），这次仍按现在的 profile 起。" >&2
+
 # 清掉从父 dsh 会话继承来的身份变量。
 #
 # 它们描述的是**另一个** profile 和会话。如果你是在某个 dsh 会话的 shell 里