Overview
dsh-aoci-panel
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known 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 才在会话工具表出现。