@dsh-workbench/core 0.3.10 → 0.3.11

package/README.md

@@ -1,7 +1,9 @@
 # dsh-workbench
 
 基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 **Agent 工作台**：
-一个 dsh 插件包 —— 换掉 dsh 的左栏，中列保留 dsh 的对话，右侧加一列自研的数据面板。
+一个 dsh 插件包 —— 默认沿用 dsh 官方的左栏，中列保留 dsh 的对话，右侧加一列自研的数据面板。
+想把左栏换成工作台自己那套（项目下拉 / 我们的排序 / 跑马灯 / DIY 新会话），在
+「设置 → 工作台设置 → 会话列表」切，**切完自动刷新页面生效**（不用重启，会话不断）。
 **dsh 本体一行不改**，两个实例可以同时开着。
 
 ```
@@ -47,6 +49,14 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 - 外壳会**自己把缺的那几件补齐**（建隔离 opencli 的入口、把 `dsh-wb-module` 挂上 PATH、
   后台把 DIY 工坊骨架建起来）—— 不需要跑 `setup`、也不需要启动器。后台脚本的输出在
   `~/.dsh/workbench/seed.log`（DIY 工坊的依赖是几百 MB，第一次启动在后台下）。
+- **可写根不随包改**（2026-10-22 起）：启用**不会**再动 `sandbox-policy` —— 在线改那一行会把
+  dsh 的 session-controller 撞成 failed（症状：新建会话报 `gateway/service-unavailable`，
+  **退出重开**即恢复）。要用市场装模块这类走执行缝的命令时，把
+  [`profile/sandbox.patch.yml`](profile/sandbox.patch.yml) 那一行写进这个 profile 的
+  `cordis.patch.yml`，再退出启动一次；宿主启动时若发现可写根盖不住 `~/.dsh/workbench` 会打一条 warn。
+- **DIY 模式在任意工作区都能开**：开了它，工具就在**这条会话的工作区**里造 / 装 / 上板
+  （模块 = 那个工作区里声明了 `dsh.workbench` 的包）。`setup` 建的那个工坊只是「造一个模块」
+  那个入口的落脚点（脚手架），不是 DIY 的落点 —— 详见下面「常见问题」。
 - **工坊工具链跟着外壳走**：外壳升级后不用管工坊 —— 每次启动都会把工坊里那三个
   `@dsh-workbench/*` 与**正在跑的那份外壳**比一次，不同代就在后台增量同步到同代（所以升级后
   **下一次启动**就对上了）。离线时停在旧一代，但 `workbench_diy_status` 会直说
@@ -79,7 +89,8 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak`，再跑一次 `setup` |
 | 彻底不用了 | 删 `~/.dsh/profiles/workbench` 与 `~/.dsh/workbench` 两个目录（都不影响 `dsh web`） |
 | 改设置 | 在 `:3081` 的 Settings 里改（模型供应商 / 搜索源 / MCP 也是这里） |
-| 从 `dsh web` 搬设置过来 | 设置 → 「配置同步」→ 选来源 → 勾行 → 同步（即生效） |
+| 换左栏 | 「设置 → 工作台设置 → 会话列表」：默认**官方**；切完**自动刷新页面**生效（从旧版升上来第一次要重启一次） |
+| 从 `dsh web` 搬设置过来 | 设置 → 「工作台设置」→「配置同步」→ 选来源 → 勾行 → 同步（即生效） |
 
 ## 和 `dsh web` 的关系
 
@@ -90,11 +101,11 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
   API 凭据（`~/.dsh/.credentials.yaml`，一机一把 key）。
 - **设置是工作台自己那份**：模型供应商 / 搜索源 / MCP 都在 `:3081` 的 Settings 里配，
   落在 `profiles/workbench/cordis.patch.yml` —— 那是它唯一的一份设置文档，每一行都改得动。
-  想用 `dsh web` 那边已经配好的行：`:3081` → `Meta+,` → 「配置同步」→ 选来源 → 勾行 → 同步 →
+  想用 `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**（左栏回来、右侧面板消失）。
+  （插入工作台插件那几行），界面会**退化成原版 dsh web**（左栏回来、右侧面板消失）。
   **数据一个都不丢**；把开关拨回来就恢复 —— 进不去设置页就按 `Meta+,`。进程已经退过的话，
   启动器读到"bundle 没被选中"会直接拒绝启动并给一条命令：`./bin/dsh-workbench setup`（幂等，
   把这一项补回 `dsh.profile.bundles`）。别当成故障去重建 profile。
@@ -109,9 +120,10 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 | 打开面板 / 按刷新要等 5–8 秒 | 正常：opencli 每次调用有**固定约 5 秒**开销（起浏览器会话）。**没有缓存**，数据一律实时 |
 | 体检那屏说「检测浏览器通道 · 没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致，daemon 被顶成对方那版；下一条浏览器命令会自动把它重启回来，体检复检后改回「已连接」 |
 | 一切正常，但左栏是出厂样子、右边没有面板 | 工作台插件在 Settings 里被关了（见上一条 ⚠️）。**重启之后**启动器不会再让你拿到这种实例：它读到 `dsh.profile.bundles` 里没有它就直接拒绝启动，并打印 `./bin/dsh-workbench setup` |
-| 模型列表里只有出厂的几个、没有自己配的供应商 | 新装的 profile 不带设置（ADR-0044）：设置 → 「配置同步」→ 选来源 → 勾 `llm-` 那几行 → 同步（即生效）|
-| 「配置同步」里某一行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），（装完 dsh 会自行重组；它报 `restartReason` 时才重启）|
-| 左栏没有「工作台DIY」那一项、模式下拉里也没有「工作台 DIY」 | 多半是 dsh 太旧（DIY 模式是从 **dsh 0.2.1-rc.2** 的 preset 清单派生的；旧一代那个 preset 挂不起来，而 dsh 的模式选择器**只列挂得起来的** ⇒ 整个不见且不报错）。**启动体检会把它摆出来并停在那一页**（「检查 DIY 模式 · 挂不起来」+ 缺哪几行 + 升级命令 + 一颗「先进入工作台」）；启动器更早一步：dsh 太旧就直接拒绝启动/安装并打印 `npm i -g @deepseek-ai/dsh@latest`，装完**重启工作台**即可。想自己核对是哪一行挂不起来：`dsh` 的 设置 → 「Agent presets」里那一行会带红标与原因 |
+| 模型列表里只有出厂的几个、没有自己配的供应商 | 新装的 profile 不带设置（ADR-0044）：设置 → 「工作台设置」→「配置同步」→ 选来源 → 勾 `llm-` 那几行 → 同步（即生效）|
+| 「工作台设置」→「配置同步」里某一行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），（装完 dsh 会自行重组；它报 `restartReason` 时才重启）|
+| 在自己项目里开了 DIY 模式，`workbench_diy_list` 却说「没有找到 DIY 模块」/ 看不到工坊里造过的那些 | **看/调面板不需要模块**（空项目、单包、monorepo 都一样）：`workbench_diy_panel` / `_status` 直接看装过的。只有「造」才需要源码：模块跟**这条会话的工作区**走，不跟工坊走（ADR-0077）。① 那个工作区里要有一个在 `package.json` 里声明了 `dsh.workbench` 的包（`packages/*` 由它自己的 `pnpm-workspace.yaml` 或 `workspaces` 说）；② 从工坊带过去的，把模块目录挪/拷到那个仓库里；③ 旧 `shots/` 下的截图与录制不迁移（新的落在 `~/.dsh/workbench/artifacts/<工作区>/`） |
+| 左栏没有「工作台DIY」那一项、模式下拉里也没有「工作台 DIY 模式」 | 多半是 dsh 太旧（DIY 模式是从 **dsh 0.2.1-rc.2** 的 preset 清单派生的；旧一代那个 preset 挂不起来，而 dsh 的模式选择器**只列挂得起来的** ⇒ 整个不见且不报错）。**启动体检会把它摆出来并停在那一页**（「检查 DIY 模式 · 挂不起来」+ 缺哪几行 + 升级命令 + 一颗「先进入工作台」）；启动器更早一步：dsh 太旧就直接拒绝启动/安装并打印 `npm i -g @deepseek-ai/dsh@latest`，装完**重启工作台**即可。想自己核对是哪一行挂不起来：`dsh` 的 设置 → 「Agent presets」里那一行会带红标与原因 |
 
 排障全表在仓库的 [`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

@@ -61,7 +61,7 @@ fi
 # `standard.patch.yml` 派生的**（scripts/gen-diy-preset.mjs）—— 所以它跟的是**派生那一刻的
 # dsh**。dsh 旧到那份清单里有几个包它根本没有时（实测 0.2.0-rc.2 缺
 # `@deepseek-ai/dsh-tool-schedule`），preset 挂不起来；dsh 的模式选择器**只列挂得起来的**
-# （healthy presets only），于是「工作台 DIY」在用户面前整个消失，界面与终端都不吭声。
+# （healthy presets only），于是「工作台 DIY 模式」在用户面前整个消失，界面与终端都不吭声。
 # 同一代 dsh 0.2.0 的 `uiWorkspace.startSession()` 也**不收** `agentPreset`（0.2.1-alpha.3 才收），
 # 所以就算 preset 挂上了，「造一个模块」也落不到 DIY 模式 —— 这一档没有"少一把工具"的降级空间。
 #
@@ -103,7 +103,7 @@ process.exit(0);
 ' || DSH_FLOOR_GUARD=$?
   if [ "${DSH_FLOOR_GUARD:-0}" -eq 1 ]; then
     echo "dsh-workbench: 这台机器上的 dsh 是 ${DSH_VERSION}，这份外壳要 ${DSH_FLOOR}。" >&2
-    echo "  低于它时 DIY 模式（会话里的「工作台 DIY」）挂不起来，而 dsh 的模式选择器只列挂得起来的" >&2
+    echo "  低于它时 DIY 模式（会话里的「工作台 DIY 模式」）挂不起来，而 dsh 的模式选择器只列挂得起来的" >&2
     echo "  —— 它会**整个不出现**，不报错。所以这里直接拒绝启动。" >&2
     echo "  升级 dsh（再重启一次工作台）: npm i -g @deepseek-ai/dsh@latest" >&2
     exit 1