概览
@oneinitai/dsh-settings-plus
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
如实陈述： - **defer 到 v2**（计划约定）：聚合配置页、per-namespace 拒绝名单、导出/导入、required secret 保存修复。 - **宿主 wire 面处于诚实降级状态**：T16 分发冒烟验证了插件安装/加载与服务挂载；宿主 wire 面（浏览器 catalog 数据通道、真实 `ctx.fs` 适配器、Fabric patch 端到端）待宿主升级后补验证。当前为诚实降级状态：catalog 空源、Fabric no-op、文件写走本地 `FsLike` 通道。 - **Fabric 依赖姿态**：`cordis-fabric` 在绑定时从宿主上下文可选加载。未挂载 facade → 安全 no-op（桩行保持禁用，gateway 保持默认白名单）；facade 挂载但畸形 → 响亮报错。 - **`updateComposition` 的写范围**：只有已注册 settings namespace 的 id 可经服务写入；普通 `cordis.yml` 组合行响亮失败，须经文件编辑面或 `cordis.patch.yml` 修改。 ### 后续计划（Roadmap） - **L2 浏览器 RPC 接入**：把客户端 catalog 从空本地源接到真实宿主数据通道。 - **L3 外部 HTTP API**：按需将 settings 服务暴露为外部 HTTP 接口。 - **宿主版本兼容范围锁定**：维持宿主版本范围锁定（见 `peerDependencies`），宿主升级后补验证 wire 面。