dsh-aoci-panel

LIMITATIONS

已知限制

- **Windows 桌面版专属**：路径探测、安装脚本与文档都按 Windows 桌面版设计；未验证 macOS / Linux。 - **写路径只有三类**：安装向导（aoci init/scan 产物与可选 DSH 补丁行）、修复绑定（补丁行归一）、 索引文件保存/恢复（三个受管索引 + `.aoci/` 时间戳备份，见「索引文件管控」）。除此之外面板只读： 不写业务文件、不改 `.aoci/baseline.json`；「校验 / 快捷动作 verify」会让 aoci 自己追加 `.aoci/verify_history` 审计记录（该目录已被 `.aoci/.gitignore` 忽略）。 - DSH 补丁行追加/归一后需**重启 DSH** 才生效（组合在启动时装配）；面板各处会提醒。**面板绝不自行重启 DSH。** - 「修复绑定」只归一同一补丁文件里 `--repo` 指向该仓库的行的 command / `--repo`； serverName 冲突的**改名**不自动做（会改变会话里的工具命名空间），需人工裁决。 - 多工作区总览按工作区逐个调 CLI（轻量 `status --json`），工作区很多时首屏会慢一些； 面板端有防抖（切换仓库不重复取数）与失败重试（「刷新」按钮），CLI 不可用时自动降级离线只读。 - 面板是宿主进程内的会话期缓存；重启后首屏需要重新取数（可用 `cacheTtlMs` 让它按时间过期）。 - **桌面版宿主半没有模块热重载**：`lib/index.js` 的改动必须重启 DSH（原因见「开发」一节）。 - 本地链接安装（`dsh plugin add <目录>`）是开发便利：`pnpm install`、插件市场装卸等操作可能把它换回 真实目录，重跑一次 `dsh plugin add <目录>` 即可。正式使用请安装 registry 版本。 - 更新检查依赖 npm registry 可达；企业镜像或离线环境可用 `registryUrl` / `updateCheck` 调整。 - **接入工具依赖宿主 `tools` 服务**：Web 宿主默认具备；没有该服务时四条工具不注册，面板其余部分照常工作。 工具修复 / 新增的 MCP 绑定行仍需重启 DSH 才在会话工具表出现。