dsh-workflow-studio

LIMITATIONS

Known limitations

1. **装完必须重启 DSH。** 宿主半边是宿主启动时加载的一部分。运行中的宿主**不会**热启动 一个新插入的插件行 —— 它的配置重载明确要求「不引入新的 inactive 条目」， 而新插入的条目必然先是 inactive。实测：往 profile patch 里插入后条目出现在 `listConfigs` 里但状态是 `inactive`，`/info` 一直 404；移除再插入也一样。 （另有一个坑：**Node 会缓存失败的 import**。第一次尝试时模块里有个写错的 import， 修好之后同一个宿主进程内无论怎么重试都还是「failed to import」，只有重启才清掉。） 顺带：改完宿主半边也要重启。官方 `hmr` 只热重载**模块**，不会重新执行 `apply()`。 客户端半边刷新页面即可（bundle 是按需从磁盘取的）。 2. **一次运行里，逻辑节点与实例的绑定按 `label` 匹配。** 两个不同的逻辑节点用同一个 `label` 且同一个 `phase` 时会被判成同一个。这是刻意的取舍：并发下按声明顺序绑定会 随机错配，那比不绑更糟。 3. **只画声明的阶段依赖，不画推断的。** 宿主仍然会按时序推断节点级的边，但板面只画 **阶段之间**的声明边（实线）与「相邻 / 推断」（淡虚线）。理由：一枚 pill 就是一个实例， 在同一列里画实例之间的箭头会立刻变成一团乱麻，而读者真正要判断的「是不是真并行」 由「时间线」那一页回答得更准。声明不全时，未声明的实例之间不再有任何线。 4. **常驻条只显示本会话最近的一次运行。** 更早的、别的会话的运行在侧栏面板里看。 本会话没有任何运行时，整条不出现。 5. **点 pill 会离开当前视图。** 跳去子智能体会话后，工作台面板不再处于前台； 要回来重新点侧栏图标。之所以这么设计而不是就地展开，是因为官方会话窗口 在完整性、流式、冷恢复上都比插件能给的强，没有理由再镜像一份。 6. **正文有上限。** 每个节点最多保留 500 条内容、单个文本块最多 6000 字； 超限时丢弃最早的并在流里留一条提示（不静默截断）。 7. **运行记录只保留最近 60 次**，且只在内存里 —— 宿主重启后工作台是空的。 真相在会话日志里（`tool-workflow/*` 记录仍然写入了发起会话，官方会话内卡片照常显示）。 8. **`uiWorkspace` 取不到时点 pill 不会有反应**，只会在条上提示一句。 客户端半边只 inject `slots`，`uiWorkspace` 是软取的 —— 这样它在别的组合里缺席时， 整个面板不会跟着一起不出现。 9. **本机 pnpm 装不动**（见[安装](#安装)）—— 与插件无关，是 profile 里一条指向已删除目录的 `file:` 依赖导致的。