@dsh-workbench/core 0.1.14 → 0.1.16

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

@@ -222,6 +222,22 @@ mkdir -p "$OPENCLI_ROOT/bin" "$OPENCLI_ROOT/home"
 # 只建目录：骨架与依赖是 seed-profile.sh 第 6 步的事。
 mkdir -p "$DSH_HOME/workbench/diy/packages"
 
+# 工坊的**稳定入口**：每次启动都重写一遍（幂等、几乎不花时间），挂进 PATH。
+# 于是 agent 在工坊里（或任何目录里）都能直接叫 `dsh-wb-module`，不必记着 `pnpm exec` 前缀 ——
+# 指令里那句"工坊里没有全局 dsh-wb-module"是**旧**状态，现在有一个我们自己的转发脚本。
+bash "$REPO_DIR/scripts/seed-workshop.sh" entry || true
+export PATH="$DSH_HOME/workbench/bin:$PATH"
+
+# 骨架不在就**当场建**（不是只提醒）：工坊看着"能用"，可模块的 build / check 会把
+# "不在 workspace 里"说成"声明写错了"——实测就是在这一步卡住过（干净机器上 seed 第 6 步没跑）。
+# 提醒是对人说的，而先撞上它的是 agent：它读到的报错指着别的地方，于是开始自由发挥。
+if [ ! -f "$DSH_HOME/workbench/diy/package.json" ]; then
+  bash "$REPO_DIR/scripts/seed-workshop.sh" || {
+    echo "dsh-workbench: 提醒 —— DIY 工坊的骨架没建起来（$DSH_HOME/workbench/diy/package.json）。" >&2
+    echo "  跑一次 dsh-workbench setup；在那之前工坊里的模块 build / check 都会报错。" >&2
+  }
+fi
+
 # 工坊**自己带着** DIY 的指引：软链到随包出货的那一份（本包的 `skills/workbench-module-diy/`）。
 # 为什么放在这里、而不是靠 agent preset 的 `customSkillDirs`：DIY 会话的 cwd 就是工坊
 # （会话 cwd 即沙箱边界），而 dsh 的 skill-filesystem 是从 **cwd 下的 `.agents/skills/`**
@@ -242,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"