dsh-minecraft-ui

配置

Bundle 自带安全默认值，用户可以在该 profile 的后置 patch 中覆盖稳定行 minecraft-ui：

- id: minecraft-ui
  config:
    dataDirectory: dshcraft
    catalogUrl: https://awesome-dsh-plugin.com/plugins.json
    catalogCacheTtlMs: 21600000
    catalogLimit: 2000
    confirmationTtlMs: 60000

字段	默认值	说明
dataDirectory	dshcraft	$DSH_HOME 内的安全相对目录
catalogUrl	社区目录 URL	仅允许 HTTP(S)
catalogCacheTtlMs	21600000	社区目录缓存时长
catalogLimit	2000	最多保留的目录条目数，范围 1–5000
confirmationTtlMs	60000	社区插件确认 token 有效期

Cordis 会用 Schemastery 校验配置并填充默认值；非法路径、协议和数值范围会在插件激活时直接报错。

为什么使用 shell.overlay

官方 DSH Root 和 AppFrame 继续拥有 Sidebar、Conversation、Details 与 Composer。DSHcraft 只注册一层可逆的世界 Overlay，并在进入工作台时露出、换肤原生界面。

这种方式避免在第二个 React Root 中重复挂载 Session/Conversation，从而保护草稿、附件、流式状态和 Session 生命周期的一致性。