@dsh-workbench/core 0.1.15 → 0.1.17

package/README.md

@@ -36,6 +36,23 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 
 打开 <http://localhost:3081> 就是工作台。你原来那份 `dsh web` 继续用 `:3080`，两边互不影响。
 
+## 另一种装法：就在你那份 `dsh web` 里装（单 profile）
+
+不想多一个 profile、多一个端口、多一个进程？那就**在 `dsh web` 里装**——
+侧栏 **Plugins → Add plugin**，填 `@dsh-workbench/core`（包在公网 npm 上，默认源就能解析），
+**Install → Enable now**，然后**刷新一次页面**。左栏换成工作台，右侧多出面板列。
+
+- 装的是**你现在这个 profile**：会话、存储、附件接着用你原来的（**不分家**）；
+  面板与模块配置照旧落在 `~/.dsh/workbench/**`。
+- 外壳会**自己把缺的那几件补齐**（建隔离 opencli 的入口、把 `dsh-wb-module` 挂上 PATH、
+  后台把 DIY 工坊骨架建起来）—— 不需要跑 `setup`、也不需要启动器。后台脚本的输出在
+  `~/.dsh/workbench/seed.log`（DIY 工坊的依赖是几百 MB，第一次启动在后台下）。
+- 第一次打开照旧走启动体检，自己装隔离 opencli 运行时；装不上时给一条能照抄到终端的命令。
+- 与 `setup` 那条路的差别：**没有独立端口/进程**、**会话不隔离**、**改外壳源码不热重载**，
+  DIY 工坊的依赖是第一次启动在后台装的。取舍与理由见
+  [ADR-0037](https://github.com/code-farmer-i/dsh-workbench/blob/main/docs/adr/0037-workbench-installs-into-any-profile.md)。
+- 想回到"两条实例并存"，就删掉这个包（Plugins 页里卸载），再走上面的 `setup` 那条路 —— 数据都还在。
+
 ## 首次打开会自己做什么
 
 - **装 opencli 的隔离运行时**：启动体检自己装，落在 `~/.dsh/workbench/opencli/`，
@@ -61,6 +78,8 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 
 ## 和 `dsh web` 的关系
 
+（下面说的是 `setup` 那条路；装在 web 自己的 profile 里那条见上一节。）
+
 - **另一个 profile、另一个端口、另一个进程**：`workbench` profile 在 `~/.dsh/profiles/workbench`；
   会话 / 存储 / 附件 / 模块配置全走 `~/.dsh/workbench/**`，与 web **数据分家**。只有一样有意共享：
   API 凭据（`~/.dsh/.credentials.yaml`，一机一把 key）。

package/bin/dsh-workbench

@@ -258,8 +258,12 @@ fi
 # （症状：启动体检永远说"隔离运行时没装好"，而它其实是没权限跑）。
 # 所以这里写一个**我们自己拥有**的转发脚本，x 位由 chmod 当场给。
 # ⚠️ 先 rm -f：旧版本留下的软链还在时，`>` 会顺着软链把真脚本覆盖掉。
+# ⚠️ DSH_HOME 必须**钉在命令里**：执行缝不继承它，而 bin/opencli-isolated 用
+# `${DSH_HOME:-$HOME/.dsh}` 推根 —— 不钉的话，DSH_HOME 不是默认值的机器上，
+# 隔离运行时会被认成用户真家目录那一份（实测：同一条路上的 seed-workshop.sh
+# 就是这样把入口写进了 ~/.dsh，见 ADR-0037 的"执行缝不继承 DSH_HOME"）。
 rm -f "$OPENCLI_ROOT/bin/opencli"
-printf '#!/bin/sh\nexec bash %q "$@"\n' "$DSH_WORKBENCH_ROOT/bin/opencli-isolated" \
+printf '#!/bin/sh\nexec env DSH_HOME=%q bash %q "$@"\n' "$DSH_HOME" "$DSH_WORKBENCH_ROOT/bin/opencli-isolated" \
   >"$OPENCLI_ROOT/bin/opencli"
 chmod +x "$OPENCLI_ROOT/bin/opencli"
 export DSH_WORKBENCH_OPENCLI="$OPENCLI_ROOT/bin/opencli"