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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-workbench contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,150 +1,181 @@
-# dsh-workbench
+# @dsh-workbench/core
 
-基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 **Agent 工作台**：
-一个 dsh 插件包 —— 默认沿用 dsh 官方的左栏，中列保留 dsh 的对话，右侧加一列自研的数据面板。
-想把左栏换成工作台自己那套（项目下拉 / 我们的排序 / 跑马灯 / DIY 新会话），在
-「设置 → 工作台设置 → 会话列表」切，**切完自动刷新页面生效**（不用重启，会话不断）。
-**dsh 本体一行不改**，两个实例可以同时开着。
+工作台本体：一个 **DeepSeek Harness 插件**，给 dsh 换一层外壳 —— 左栏项目与会话、
+中间常驻对话、右侧一列实时数据面板。dsh 本体一行不改，装与不装都只影响你自己的这份实例。
+同仓的另外三个包（`shared` / `module-tools` / `module-hello`）是给**模块作者**的库与样本，
+终端用户只会直接装这一个。
 
-```
-dsh web (:3080)                       dsh workbench (:3081)
-┌ 左栏 ──────┬ 对话 ───┐             ┌ 左栏 ──────┬ 对话 ────┬ 数据面板 ──┐
-│ ◆ 品牌     │         │             │ ◆ 品牌     │          │ 看板       │
-│ [ + 新会话]│         │             │ [ + 新会话]│          │ 服务状态   │
-│ ◧ 面板     │         │             │ ▸ 项目     │          │ 缺陷分布   │
-│ 会话…      │         │             │  ▸ 会话    │ (常驻)    │ 最近缺陷   │
-└────────────┴─────────┘             └────────────┴──────────┴────────────┘
-```
+> 只想把它用起来？先看根目录的 [README](../../README.md)：三种装法、界面长什么样、
+> 适合谁。这一份讲**装好之后**的事：命令行、数据落在哪、出问题怎么查、从源码怎么跑。
 
-**所有事情都是「告诉 agent 去做」。** 工作台不是操作台，是交代任务 + 看 agent 干得怎么样的地方；
-所以界面**只读** —— 面板上没有写按钮，写操作一律由 agent 的工具完成。
+## 装
 
-## 30 秒上手
+| 装法 | 命令 | 得到什么 |
+|---|---|---|
+| 独立实例（推荐） | `npx @dsh-workbench/core create` | 自己的 profile、`:3081`、独立进程与数据 |
+| 装进现有 `dsh web` | 侧栏 Plugins → Add plugin → `@dsh-workbench/core` → Install → Enable now → 刷新 | 当前实例多一列面板，会话不变 |
+| 装进 Desktop | 同上，装完重开窗口 | Desktop 里多一列面板 |
 
-先决条件（就三条）：
+独立实例分两步：先建 profile，再起工作台。
 
-| 要有 | 为什么 | 怎么有 |
-| --- | --- | --- |
-| `dsh` | 本体。本包在 `0.2.1-rc.2` 上验过；**更旧的会被拒绝**（`engines.dsh`，旧到不认识它的 dsh 由启动器当场拒绝并给升级命令）—— DIY 模式是从那一代 dsh 的 preset 清单派生的，旧一代它会整个不出现且不报错 | `npm i -g @deepseek-ai/dsh@latest` |
-| `node` + `pnpm` | dsh 的 `plugin` 子命令是**转发给 pnpm** 的；没有 pnpm 会直接报 `dsh: pnpm was not found` | 各自装 |
-| 跑过一次 `dsh web` | `setup` 拿 `~/.dsh/profiles/web` 当模板（**bundle 清单**：这台机器上装了哪些 bundle），也是「配置同步」的默认来源。没有它会**明确报错**，不会静默建出半个 profile | `dsh web`，起来就行，然后 Ctrl-C |
+```bash
+npx @dsh-workbench/core create                    # 交互式：问来源、名字、复制什么
+npx --yes @dsh-workbench/core@latest setup        # 或非交互：建默认的 workbench，可重复跑
+npx @dsh-workbench/core                           # 起 :3081
+```
 
-然后两条命令：
+`create` 有 `dsh web` 就拿它当模板，并问要不要复制设置、本地插件、项目列表和会话；
+本机一个 profile 都没有时，用 dsh 出厂的 web 模板建一个空的。脚本 / CI 里直接给参数：
 
 ```bash
-npx --yes @dsh-workbench/core@latest setup   # ① 建 workbench profile + 把工作台装进去（幂等，可重复跑）
-npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
+npx --yes @dsh-workbench/core@latest setup --from web --profile wb2 --with-sessions
+npx @dsh-workbench/core --profile wb2
 ```
 
-打开 <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，第一次启动在后台下）。
-- **可写根不随包改**（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` 会直说
-  「工坊工具链还是上一代（…）：<原因>」并给出修法。
-- 第一次打开照旧走启动体检，自己装隔离 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` 那条路 —— 数据都还在。
+全局装过就不用 `npx`：`npm i -g @dsh-workbench/core` 之后直接 `dsh-workbench`。
 
-## 首次打开会自己做什么
-
-- **装 opencli 的隔离运行时**：启动体检自己装，落在 `~/.dsh/workbench/opencli/`，
-  **完全不碰**你本机的 `~/.opencli`（插件目录靠改 `HOME` 分开）。装不上时（没网 / 源不通）
-  失败态里有一条**能直接照抄到终端**的命令 —— 那条得在终端跑，工作台自己发起的命令带文件沙箱。
-- **要面板有数据，得登录 Coding**：卡片上点「去登录 ↗」，登完切回来按那颗「重试」
-  （刻意不做自动重试 —— 登录什么时候完成我们不知道）。
-- 没登录 / 装不上都是**明确的失败态**，不会留一块白屏让你猜。
+先决条件（就三条）：
 
-面板上的具体模块（缺陷看板、构建发布、代码分析…）**按需装**：外壳本身零业务模块，
-在 `:3081` 的「工作台模块市场」里装，也可以让 agent 去装。
+| 要有 | 为什么 |
+|---|---|
+| `dsh` ≥ 0.2.1-rc.2 | 本体。更旧的会被拒绝：`engines.dsh` 声明了下限，老到不认这个字段的 dsh 由启动器当场拒绝并给升级命令 |
+| Node + pnpm | dsh 的 `plugin` 子命令转发给 pnpm；没有 pnpm 会报 `dsh: pnpm was not found` |
+| 可选：跑过一次 `dsh web` | 想继承它的设置 / 插件 / 项目时。只建工作台不需要 |
+
+## 命令行
+
+| 命令 | 作用 |
+|---|---|
+| `dsh-workbench create` | 交互式新建一个工作台实例 |
+| `dsh-workbench setup` | 幂等建默认的 `workbench` profile；配 `--from` 建别的名字 |
+| `dsh-workbench` | 起工作台（默认端口 `:3081`，其余参数透传给 `dsh web`） |
+| `dsh-workbench --profile <名字>` | 起指定实例 |
+| `dsh-workbench setup --from <来源> --profile <新名>` | 以某个现有 profile 为模板建一个 |
+| `--with-sessions` / `--no-settings` / `--no-plugins` / `--no-projects` | 复制 / 不复制哪一类（默认复制设置、插件、项目，不复制会话） |
+| `dsh-workbench --help` | 用法；其余参数透传给 `dsh web` |
+
+环境变量：
+
+| 变量 | 默认 | 作用 |
+|---|---|---|
+| `WORKBENCH_PORT` | `3081` | 端口；`dsh web` 默认 `:3080`，两边可以同时开 |
+| `WORKBENCH_PROFILE` | `workbench` | 用哪个 profile（等价于 `--profile`） |
+| `DSH_HOME` | `~/.dsh` | dsh 的数据根 |
+| `DSH_WORKBENCH_HOME` | `$DSH_HOME/workbench` | 工作台自己的数据根（opencli 运行时、模块、截图…） |
+
+装进 `dsh web` 或 Desktop 时没有启动命令：它们用自己那一份 profile，工作台只是其中一层插件。
+
+## 包里有什么
+
+`package.json` 的 `files` 是白名单 —— 漏一项的症状是「仓库里怎么都对，装出去那台静默什么也没做」。
+
+| 路径 | 是什么 |
+|---|---|
+| `dist/host/**` | 宿主侧入口（`exports["."]`）与类型；构建产物，不进 git |
+| `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、可写根两份补丁） |
+| `skills/` | 模块 DIY 指引，装好后挂给 agent；漏了不报错，只是 agent 不知道要怎么做模块 |
+| `bin/` | `dsh-workbench` 启动器、隔离 opencli 的入口 |
+| `scripts/` | 随包出货的脚本：`seed-profile.sh` / `seed-workshop.sh` / `create-workbench.mjs` / `clone-profile.mjs` |
+
+## 数据落在哪
+
+| 内容 | 位置 |
+|---|---|
+| profile（设置、`node_modules`、`cordis.patch.yml`） | `~/.dsh/profiles/<名字>` |
+| 工作台数据（模块、面板、截图与录制、opencli 运行时） | `~/.dsh/workbench/**` |
+| API 凭据 | `~/.dsh/.credentials.yaml` —— 它与 `dsh web` **有意共用**，一台机器一把 key |
+| DIY 工坊依赖安装日志 | `~/.dsh/workbench/seed.log` |
+
+独立实例与 `dsh web` **数据分家**：各自会话、各自设置，互不影响。装进 `dsh web` / Desktop
+则沿用它们自己的会话与存储，面板与模块配置照旧落在 `~/.dsh/workbench/**`。
+
+设置只有一份，写在哪都看得见：
+
+- 独立实例：`:3081` → Settings，落进 `profiles/<名字>/cordis.patch.yml`，每一行都改得动。
+- 想用 `dsh web` 已经配好的行：`:3081` → `Meta+,` → 「工作台设置」→「配置同步」→
+  选来源 → 勾行 → 同步，即时生效。只搬显式配过的行，同 id 内容不同默认不覆盖；
+  web 后来改的不会自动过来，再打开这一页拉一次即可。
 
 ## 日常
 
 | 想做什么 | 怎么做 |
-| --- | --- |
+|---|---|
 | 起工作台 | `npx @dsh-workbench/core` |
 | 换端口 | `WORKBENCH_PORT=3091 npx @dsh-workbench/core` |
-| 升级 | 重跑一次 `npx --yes @dsh-workbench/core@latest setup`（幂等），然后**重启一次工作台**才用得上新版（市场里那条「更新」也写「重启后生效」）。工坊工具链会在**下一次启动**工作台时自动跟到同代 —— 不必手动删工坊 |
+| 升级 | 重跑一次 `npx --yes @dsh-workbench/core@latest setup`（幂等），然后重启工作台。工坊工具链会在下一次启动时自动跟到同代，不必手动删工坊 |
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak`，再跑一次 `setup` |
+| 换左栏 | 设置 → 工作台设置 → 会话列表：默认官方；切完自动刷新页面生效（从旧版升上来第一次要重启） |
+| 从 `dsh web` 搬设置 | 设置 → 工作台设置 → 配置同步 → 选来源 → 勾行 → 同步 |
+| 装模块 | `:3081` 的「工作台模块市场」，或让 agent 装 |
 | 彻底不用了 | 删 `~/.dsh/profiles/workbench` 与 `~/.dsh/workbench` 两个目录（都不影响 `dsh web`） |
-| 改设置 | 在 `:3081` 的 Settings 里改（模型供应商 / 搜索源 / MCP 也是这里） |
-| 换左栏 | 「设置 → 工作台设置 → 会话列表」：默认**官方**；切完**自动刷新页面**生效（从旧版升上来第一次要重启一次） |
-| 从 `dsh web` 搬设置过来 | 设置 → 「工作台设置」→「配置同步」→ 选来源 → 勾行 → 同步（即生效） |
-
-## 和 `dsh web` 的关系
-
-（下面说的是 `setup` 那条路；装在 web 自己的 profile 里那条见上一节。）
-
-- **另一个 profile、另一个端口、另一个进程**：`workbench` profile 在 `~/.dsh/profiles/workbench`；
-  会话 / 存储 / 附件 / 模块配置全走 `~/.dsh/workbench/**`，与 web **数据分家**。只有一样有意共享：
-  API 凭据（`~/.dsh/.credentials.yaml`，一机一把 key）。
-- **设置是工作台自己那份**：模型供应商 / 搜索源 / MCP 都在 `:3081` 的 Settings 里配，
-  落在 `profiles/workbench/cordis.patch.yml` —— 那是它唯一的一份设置文档，每一行都改得动。
-  想用 `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**（左栏回来、右侧面板消失）。
-  **数据一个都不丢**；把开关拨回来就恢复 —— 进不去设置页就按 `Meta+,`。进程已经退过的话，
-  启动器读到"bundle 没被选中"会直接拒绝启动并给一条命令：`./bin/dsh-workbench setup`（幂等，
-  把这一项补回 `dsh.profile.bundles`）。别当成故障去重建 profile。
+
+外壳本身**零业务模块**：右侧面板装什么有什么。装进 `dsh web` / Desktop 时少一条命令 ——
+没有独立端口与进程，改用它们自己的插件页装模块。
+
+⚠️ **别在 Settings → 插件里把 `@dsh-workbench/core` 关掉**：关掉 = 那份 bundle patch 整份不再
+应用，界面退化成原版 `dsh web`（左栏回来、右侧面板消失），数据一个都不丢。拨回来就恢复；
+进不去设置页按 `Meta+,`。进程已经退过的话，启动器读到「bundle 没被选中」会直接拒绝启动并给
+一条命令：`./bin/dsh-workbench setup`（幂等，把这一项补回 `dsh.profile.bundles`）。
+别当成故障去重建 profile。
+
+## 首次打开会自己做什么
+
+- **装 opencli 的隔离运行时**：落在 `~/.dsh/workbench/opencli/`，靠改 `HOME` 与插件目录分开，
+  **完全不碰**你本机的 `~/.opencli`。装不上时（没网 / 源不通）失败态里有一条能直接照抄到终端
+  的命令 —— 那条得在终端跑，工作台自己发起的命令带文件沙箱。
+- **要面板有数据，得登录对应平台**：卡片上点「去登录 ↗」，登完切回来按「重试」
+  （刻意不做自动重试 —— 登录什么时候完成我们不知道）。
+- 没登录 / 装不上都是**明确的失败态**，不留白屏让人猜。
 
 ## 常见问题
 
 | 症状 | 原因 / 怎么办 |
-| --- | --- |
-| `setup` 报 `scripts/seed-profile.sh: Permission denied` | 0.1.6 的已知缺陷（发出去的包丢了脚本的可执行位）。应急：`chmod +x ~/.npm/_npx/*/node_modules/@dsh-workbench/core/{scripts/seed-profile.sh,bin/opencli-isolated}` 后重跑；0.1.7 起已修 |
-| 页面白屏、只显示 `Failed to load plugins` | 有插件往未声明的槽注册（抛错即整个 entry 激活失败）。看控制台里我们打的 `[dsh-workbench] apply failed` |
-| 面板一直空着 | 多半是没登录 Coding（见上）；或这个工作区的 git `origin` 不指向 `e.coding.net` |
-| 打开面板 / 按刷新要等 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 模式，`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)。
-
-## 从源码跑 / 参与开发
+|---|---|
+| `setup` 报 `scripts/seed-profile.sh: Permission denied` | 0.1.6 的缺陷（发出去的包丢了脚本可执行位）。应急：`chmod +x ~/.npm/_npx/*/node_modules/@dsh-workbench/core/{scripts/seed-profile.sh,bin/opencli-isolated}` 后重跑；0.1.7 起已修 |
+| 页面白屏、只显示 `Failed to load plugins` | 有插件往未声明的槽注册，抛错即整个 entry 激活失败。看控制台里 `[dsh-workbench] apply failed` |
+| 左栏是出厂样子、右边没有面板 | 工作台插件在 Settings 里被关了（见上一节 ⚠️）。重启后启动器不会再让你拿到这种实例 |
+| 面板一直空着 | 多半是没登录平台（见上）；或这个工作区的 git `origin` 不指向它要读的平台 |
+| 打开面板 / 按刷新要等 5–8 秒 | 正常：opencli 每次调用有固定约 5 秒开销（起浏览器会话）。没有缓存，数据一律实时 |
+| 体检说「检测浏览器通道 · 没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致，daemon 被顶成对方那版；下一条浏览器命令会自动把它重启回来，复检后改回「已连接」 |
+| Desktop 里体检一直「没连上」 | 浏览器没开。预检页有「打开浏览器」，点了才开上次承载扩展的那个（没记住就用 Chrome），开完自动复检；点了会切到 Chrome 前台（冷启动抢焦点，静默做不到）。仍连不上多半是扩展没装或被禁用 |
+| 模型列表里只有出厂的几个、没有自己配的供应商 | 新 profile 不带设置。设置 → 工作台设置 → 配置同步 → 勾 `llm-` 那几行 → 同步 |
+| 配置同步里某行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），装完 dsh 会自行重组，它报 `restartReason` 时才重启 |
+| 启动被拒，说 dsh 太旧 | `npm i -g @deepseek-ai/dsh@latest`，装完重启工作台 |
+| 左栏没有「工作台DIY」，模式下拉里也没有「工作台 DIY 模式」 | 多半是 dsh 太旧：DIY preset 从 dsh 0.2.1-rc.2 的 preset 清单派生，旧一代挂不起来，而 dsh 的模式选择器只列挂得起来的 ⇒ 整个不见且不报错。启动体检会把它摆出来并给升级命令；自己核对就看 dsh 的 设置 → 「Agent presets」那一行的红标与原因 |
+| 在自己项目里开了 DIY，面板却说没找到模块 | 模块跟**这条会话的工作区**走，不跟工坊走：① 那个工作区要有一个在 `package.json` 里声明 `dsh.workbench` 的包；② 从工坊带过去的，把模块目录挪 / 拷进那个仓库；③ 旧截图不迁移（新的落在 `~/.dsh/workbench/artifacts/<工作区>/`）。细节见工作台模块指引 |
+
+## 从源码跑
 
 ```bash
-git clone git@github.com:code-farmer-i/dsh-workbench.git
-cd dsh-workbench/packages/workbench
+git clone git@github.com:novaeth/dsh-workbench.git
+cd dsh-workbench/packages/core
 pnpm install
-pnpm run dev     # 监听 src/**（重建产物）+ 起工作台 :3081；改完不用重启、不用刷新页面
-pnpm run check   # 门禁：整仓那一套（类型 / lint / 覆盖率 / 架构 / 文档 / 运行时边界 / 接线 / 模块判据）
+pnpm run dev     # 监听 src/**（重建产物）+ 起工作台 :3081；改完不用重启、不用刷新
+pnpm run check   # 门禁：整仓那一套（= pnpm -w run check）
 ./bin/dsh-workbench   # 只想起工作台、不需要监听改动时用它
 ```
 
-`pnpm run dev` 会先替你把 profile 保障成**本仓这份**（不是源上那份），等首次构建完成再起实例；
-`:3081` 已经有实例在跑时就只监听、不重复起第二个。改界面时开着它就够了：
-浏览器半侧重建 `client.js` 后由 dsh 的 HMR 热换插件（不刷新页面），宿主半侧按模块路径热重载。
+`pnpm run dev` 先替你把 profile 保障成**本仓这份**（不是源上那份），等首次构建完成再起实例；
+`:3081` 已经有实例在跑时就只监听、不重复起第二个。浏览器半侧重建立 `client.js` 后由 dsh 的
+HMR 热换插件（不刷新页面），宿主半侧按模块路径热重载。
+
+`cordis.patch.yml` 与 `package.json` 的 bundle 清单也不用重启（`dsh-hmr` 变了就重组）；
+要重启的是改 `vite.config.ts`。
+
+`pnpm run check` 与 `pnpm release` 的闸是同一条链，别在包内另串一份短的 —— 会漏 lint、
+文档与模块判据。环境、提交与门禁纪律见 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
 
-`cordis.patch.yml` 与 `package.json` 的 bundle 清单也**不用重启**（`dsh-hmr` 变了就重组）；要重启的是改 `vite.config.ts`。
+## 相关文档
 
-结构与边界（两个运行时、槽位接线、模块包的门禁）见仓库的
-[`docs/ARCHITECTURE.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/docs/ARCHITECTURE.md) ·
-[`AGENTS.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/AGENTS.md)。
+| 想了解 | 读 |
+|---|---|
+| 装法、界面、适合谁 | [根 README](../../README.md) |
+| 架构、两个运行时、槽位、数据通路、门禁 | [ARCHITECTURE.md](../../ARCHITECTURE.md) |
+| 写一个模块 | [DIY 指引](skills/workbench-module-diy/SKILL.md) |
+| 模块的构建与十三条判据 | [module-tools](../module-tools/README.md) |
+| 共享包（契约、哑组件、宿主工具） | [shared](../shared/README.md) |
+| 最小模块样本 | [module-hello](../module-hello/README.md) |
+| 环境、门禁、提交 | [CONTRIBUTING.md](../../CONTRIBUTING.md) |

package/bin/dsh-workbench

@@ -2,9 +2,13 @@
 #
 # 工作台：建 profile / 起工作台。
 #
-#   ./bin/dsh-workbench setup                 # ① 建 profile 并把工作台装进去（幂等）
-#   ./bin/dsh-workbench                       # ② 起工作台，默认 :3081
-#   WORKBENCH_PORT=3091 ./bin/dsh-workbench   #    换端口
+#   ./bin/dsh-workbench create                # ① 交互式新建工作台（推荐）
+#   ./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 --help
 #
@@ -26,8 +30,72 @@ set -euo pipefail
 PKG='@dsh-workbench/core'
 DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
 PROFILE="${WORKBENCH_PROFILE:-workbench}"
+SRC_PROFILE="${WORKBENCH_SOURCE_PROFILE:-web}"
 PORT="${WORKBENCH_PORT:-3081}"
+PROFILE_EXPLICIT=0
+[ -n "${WORKBENCH_PROFILE:-}" ] && PROFILE_EXPLICIT=1
+SETUP=0
+CREATE=0
+DSH_ARGS=()
+
+die() {
+  echo "dsh-workbench: $*" >&2
+  exit 1
+}
+
+usage() {
+  sed -n '3,13p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+}
+
+if [ "${1:-}" = "create" ]; then
+  CREATE=1
+  shift
+fi
+if [ "${1:-}" = "setup" ]; then
+  SETUP=1
+  shift
+fi
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --profile | --workbench-profile)
+      [ $# -ge 2 ] || die "$1 需要跟一个 profile 名字（例如 --profile wb2）"
+      PROFILE="$2"
+      PROFILE_EXPLICIT=1
+      shift 2
+      ;;
+    --from | --source-profile)
+      [ "$SETUP" = "1" ] || die "$1 只用于 setup（例如 setup --from web --profile wb2）"
+      [ $# -ge 2 ] || die "$1 需要跟一个来源 profile（例如 --from web）"
+      SRC_PROFILE="$2"
+      export WORKBENCH_SOURCE_PROFILE="$SRC_PROFILE"
+      WB_CLONE=1
+      shift 2
+      ;;
+    --with-sessions) WB_COPY_SESSIONS=1; shift ;;
+    --no-sessions) WB_COPY_SESSIONS=0; 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 ;;
+  esac
+done
+
+if [ "$SETUP" = "1" ] && [ ${#DSH_ARGS[@]} -gt 0 ]; then
+  die "setup 不认识这些参数：${DSH_ARGS[*]}"
+fi
+if [ "${WB_CLONE:-0}" = "1" ] && [ "$PROFILE_EXPLICIT" = "0" ]; then
+  die "用 --from 时还要指定 --profile <新名字>（例如 --from web --profile wb2）"
+fi
+
+export WORKBENCH_PROFILE="$PROFILE"
+export WB_CLONE="${WB_CLONE:-0}"
 PROFILE_DIR="$DSH_HOME/profiles/$PROFILE"
+# 每个 profile 一份自己的运行时数据根；默认 profile 仍是 <home>/workbench。
+WORKBENCH_HOME="${DSH_WORKBENCH_HOME:-$DSH_HOME/$PROFILE}"
+export DSH_WORKBENCH_HOME="$WORKBENCH_HOME"
 
 # 本包的真实位置。**不能**直接 `dirname "$0"/..`：npx 是经 `node_modules/.bin/dsh-workbench`
 # 这条软链调进来的，那样算出来会停在 `node_modules`（实测），于是下面
@@ -43,13 +111,18 @@ GIT_TOP="$(git -C "$REPO_DIR" rev-parse --show-toplevel 2>/dev/null || true)"
 # `rev-parse --show-toplevel` 只说明"**某个祖先目录**是个仓库"—— 装出来的那份完全可能刚好落在
 # 某个仓库里：最常见的是 `$HOME` 本身就是 dotfiles 仓库，而 npm 的前缀（`~/.nvm/...`、
 # `~/.npm-global`…）就在 `$HOME` 下。那会把"装出来的那份"当成仓库副本，以 link 装进 profile：
-# 市场里工作台那一行会说「这份是本仓正在开发的那一份」，而 `npm i -g …@latest` 之后 profile
+# 市场里工作台那一行会打上「本地」标，而 `npm i -g …@latest` 之后 profile
 # 指向的东西还会悄悄变。所以还得证明**这份 package.json 本身被那个仓库跟踪**（仓库副本才有的事；
-# 与 seed-workshop.sh 那条"工作树里真有 packages/workbench + packages/module-tools"同旨）。
+# 与 seed-workshop.sh 那条"工作树里真有 packages/core + packages/module-tools"同旨）。
 if [ -n "$GIT_TOP" ] && ! git -C "$REPO_DIR" ls-files --error-unmatch package.json >/dev/null 2>&1; then
   GIT_TOP=""
 fi
 
+if [ "$CREATE" = "1" ]; then
+  [ $# -eq 0 ] || die "create 不接受参数；它会在终端里问你"
+  exec node "$REPO_DIR/scripts/create-workbench.mjs"
+fi
+
 if ! command -v dsh >/dev/null 2>&1; then
   echo "dsh-workbench: PATH 上没有 dsh。先装：npm i -g @deepseek-ai/dsh" >&2
   exit 1
@@ -102,7 +175,7 @@ for (let i = 0; i < Math.max(have.pre.length, want.pre.length); i += 1) {
 process.exit(0);
 ' || DSH_FLOOR_GUARD=$?
   if [ "${DSH_FLOOR_GUARD:-0}" -eq 1 ]; then
-    echo "dsh-workbench: 这台机器上的 dsh 是 ${DSH_VERSION}，这份外壳要 ${DSH_FLOOR}。" >&2
+    echo "dsh-workbench: 这台机器上的 dsh 是 ${DSH_VERSION}，这份工作台要 ${DSH_FLOOR}。" >&2
     echo "  低于它时 DIY 模式（会话里的「工作台 DIY 模式」）挂不起来，而 dsh 的模式选择器只列挂得起来的" >&2
     echo "  —— 它会**整个不出现**，不报错。所以这里直接拒绝启动。" >&2
     echo "  升级 dsh（再重启一次工作台）: npm i -g @deepseek-ai/dsh@latest" >&2
@@ -129,6 +202,29 @@ 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
+
   if [ -n "$GIT_TOP" ]; then
     SPEC="$REPO_DIR"
     echo "→ 仓库副本：以 link 方式装本目录（${SPEC}）"
@@ -148,31 +244,36 @@ run_setup() {
   # 启动器现在拿"选中"当硬门禁（没选中就拒绝启动），这一步就是那条修复命令的落点。
   bash "$REPO_DIR/scripts/seed-profile.sh" ensure-selected
 
+  if [ -n "$GIT_TOP" ]; then
+    BASE_CMD="$REPO_DIR/bin/dsh-workbench"
+  elif command -v dsh-workbench >/dev/null 2>&1; then
+    BASE_CMD="dsh-workbench"
+  else
+    BASE_CMD="npx @dsh-workbench/core"
+  fi
+  if [ "$PROFILE" = "workbench" ]; then
+    START_CMD="$BASE_CMD"
+  else
+    START_CMD="$BASE_CMD --profile $PROFILE"
+  fi
+
   cat <<EOF
 
 装好了。起工作台：
 
-  $REPO_DIR/bin/dsh-workbench
+  $START_CMD
+
+（全局装过就用 dsh-workbench；npx 就用 npx @dsh-workbench/core；本仓开发用 ./packages/core/bin/dsh-workbench。）
 
 首次打开会走启动体检，它会自己把 opencli 的隔离运行时装好 —— 不用你动手。
 EOF
 }
 
-usage() {
-  sed -n '3,10p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
-}
 
-case "${1:-}" in
-  setup)
-    shift
-    run_setup "$@"
-    exit 0
-    ;;
-  help | --help | -h)
-    usage
-    exit 0
-    ;;
-esac
+if [ "$SETUP" = "1" ]; then
+  run_setup
+  exit 0
+fi
 
 if [ ! -f "$PROFILE_DIR/package.json" ]; then
   echo "dsh-workbench: profile '$PROFILE' 还不存在。" >&2
@@ -264,7 +365,7 @@ fi
 #
 # 现在改成：**工作台自己的 patch 是唯一真相**。想要 web 的哪几行，去
 # 设置 → 「配置同步」里勾（它读源 profile 的 cordis.patch.yml，按行搬运，
-# 见 .scratch/config-sync/spec.md 与 ADR-0044）。启动器只负责把工作台起起来。
+# 见 内部设计记录 与 ADR-0044）。启动器只负责把工作台起起来。
 PATCH_ARGS=()
 
 # ── 声明工作台运行时的**可写根**（执行缝的沙箱只放行 process.cwd()）──────────
@@ -293,9 +394,9 @@ fi
 # —— 见 bin/opencli-isolated 开头的说明。
 #
 # 建一个**稳定路径**的软链：别处（包括给用户"复制这条命令"的文案）都能用
-# $DSH_HOME/workbench/opencli/bin/opencli 引用它，不必知道本目录在哪 ——
+# $WORKBENCH_HOME/opencli/bin/opencli 引用它，不必知道本目录在哪 ——
 # 而且从那里跑出来同样是隔离的。指向 profile 里那份，别指 npx 缓存（会回收）。
-OPENCLI_ROOT="$DSH_HOME/workbench/opencli"
+OPENCLI_ROOT="$WORKBENCH_HOME/opencli"
 mkdir -p "$OPENCLI_ROOT/bin" "$OPENCLI_ROOT/home"
 
 # DIY 工坊的目录必须**每次启动都在**：`cordis.patch.yml` 的 hmr 行把它列成一个监听根
@@ -303,20 +404,20 @@ mkdir -p "$OPENCLI_ROOT/bin" "$OPENCLI_ROOT/home"
 # 所以不把它列进去，模块重建 dist/host.js 就不热换 —— 而且**不报错**）。
 # chokidar 对不存在的根收不到事件，所以这里保住它，不必等用户重跑 setup。
 # 只建目录：骨架与依赖是 seed-profile.sh 第 6 步的事。
-mkdir -p "$DSH_HOME/workbench/diy/packages"
+mkdir -p "$WORKBENCH_HOME/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"
+export PATH="$WORKBENCH_HOME/bin:$PATH"
 
 # 骨架不在就**当场建**（不是只提醒）：工坊看着"能用"，可模块的 build / check 会把
 # "不在 workspace 里"说成"声明写错了"——实测就是在这一步卡住过（干净机器上 seed 第 6 步没跑）。
 # 提醒是对人说的，而先撞上它的是 agent：它读到的报错指着别的地方，于是开始自由发挥。
-if [ ! -f "$DSH_HOME/workbench/diy/package.json" ]; then
+if [ ! -f "$WORKBENCH_HOME/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: 提醒 —— DIY 工坊的骨架没建起来（$WORKBENCH_HOME/diy/package.json）。" >&2
     echo "  跑一次 dsh-workbench setup；在那之前工坊里的模块 build / check 都会报错。" >&2
   }
 fi
@@ -351,4 +452,4 @@ fi
 # ⚠️ 顺序有讲究：`--patch` 是 **dsh 本体**的选项，必须排在 `--port`（应用参数）**之前** ——
 # 参数一旦进了应用的透传区（第一个应用自己的选项开始），后面的都直接交给应用，
 # `--patch` 会被应用当成未知选项（实测：`--port` 在前时报 `unknown option '--patch'`）。
-exec dsh "$PROFILE" ${PATCH_ARGS[@]+"${PATCH_ARGS[@]}"} --port "$PORT" "$@"
+exec dsh "$PROFILE" ${PATCH_ARGS[@]+"${PATCH_ARGS[@]}"} --port "$PORT" ${DSH_ARGS[@]+"${DSH_ARGS[@]}"}

package/bin/dsh-workbench.cmd

@@ -0,0 +1,5 @@
+@echo off
+echo dsh-workbench: Windows 上的开发启动器 / setup 还没移植。
+echo   Desktop：直接用已安装的工作台（插件页安装 @dsh-workbench/core），不要跑这个脚本。
+echo   Web：在 dsh web 的 profile 里装插件；setup 的 bash 路径暂不适用于 Windows。
+exit /b 1

package/bin/opencli-isolated

@@ -22,7 +22,8 @@
 set -euo pipefail
 
 DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
-ROOT="$DSH_HOME/workbench/opencli"
+WORKBENCH_HOME="${DSH_WORKBENCH_HOME:-$DSH_HOME/workbench}"
+ROOT="$WORKBENCH_HOME/opencli"
 REAL_HOME="$HOME"
 
 mkdir -p "$ROOT/home"
@@ -43,7 +44,7 @@ fi
 # 打出来就是它），这个值一路继承到执行缝里的每条命令。带默认值等于"外面给什么就用什么"，
 # 于是隔离形同虚设 —— opencli 自己内部还会跑 npm（`plugin install` 就要，见它 dist 里
 # `execFileSync('npm', ['install', …])`），那次会去写 `~/.npm`；而执行缝只放行
-# `$DSH_HOME/workbench`，写入被拒 → 市场装插件**报错退出 1**，报的还是 npm 那句
+# `$DSH_HOME/workbench`（或 `DSH_WORKBENCH_HOME`），写入被拒 → 市场装插件**报错退出 1**，报的还是 npm 那句
 # "cache folder contains root-owned files"（那台机器上其实一个 root 文件都没有，是假话术）。
 # 所以这里是**无条件改写**：缓存落点只有这一处说了算。
 #