dsh-mycordis

LIMITATIONS

Known limitations

- **会话级动态插件是进程级状态**：DSH 重启后需重新导入 / 恢复；便携定义文件（`.dshplugin.json`）与 `.tgz` 包才是持久产物 （`.tgz` 走便携导入同样只在当前进程生效，要跨重启请收藏 / 常驻，或走 `dsh plugin add` 真实安装）。 - **装到 `desktop` profile 需完全退出桌面版**（官方 `requireDesktopProfile` 约束），装 `web` profile 则重启对应进程即可。 - **index 注入行表在启动时收集一次**：运行时新导入的动态插件不会立刻长出悬浮按钮，需要重启 DSH。 - **多会话并存时工作区可能退回部署兜底**：HTTP 请求没有 agent 上下文，`workspaceRoot` 解析链通常拿不到 `currentInitiator()`，且要求**恰好一个 root 会话**；多会话并存时会退回 `sandboxPolicy.workspaceRoot` （桌面版进程 cwd = profile 目录），产物 / 收藏可能落到 `<profile>/`。这是「插件是全局 webServer 路由、 工作区是 per-session 概念」的固有张力；会话归属已通过 `GET /api/sessions` + 面板会话下拉缓解。 - **`lib/client.js` 是唯一的 client 半区**，默认不安装；它的自动装入会让 `client-pending` 的包在本页执行 client 代码， 信任边界与「导入」一致——只导入可信来源。装 client 半区前请先确保能回滚（保留一份不含 `lib/client.js` 的包）。 - **便携包目前主要在 Windows 验证**，跨平台路径已做适配但未全面实测。 - **工作区外输出 / 安装需要沙箱提升**：建议给插件创作单独建一个工作区。 ---