概览
dsh-mycordis
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **会话级动态插件是进程级状态**: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 验证**,跨平台路径已做适配但未全面实测。 - **工作区外输出 / 安装需要沙箱提升**:建议给插件创作单独建一个工作区。 ---
