docs: apply hierarchy across the corpus

2026-08-04 00:54:19 +08:00
parent f07f8f15ed
commit dd8d446286
112 changed files with 705 additions and 1057 deletions
@@ -1,12 +1,10 @@
-# settings/ — 用户设置能力族
+# settings/：用户设置能力族

 [English](README.md) | 中文

-用户设置 seam 及其 provider。接口包拥有抽象 `Settings` 服务——namespace 注册、分层解析与变更提交；provider 实现原始文档存储并把外部修改推入 seam。全部为**产品**包。
+该包族通过注册的命名空间与可替换存储 provider 解析用户可编辑配置。

-| 包 | 角色 | ctx key |
+| 包 | 职责 | ctx key |
 |---|---|---|
-| `settings/` | 设置 seam：namespace 注册表、分层解析、提交事件 | `ctx.settings` |
-| `settings-local/` | 文件 provider（`settings.yaml`/`.json`），热重载与保留注释的写回 | （注册 `ctx.settings`） |
-
-接口位于 `settings/settings/`；provider 平级并列。网络配置中心 provider（例如 nacos 类后端）加入本组并注册到 `ctx.settings`。组合配置仍留在 `cordis.yml`：settings namespace 只承载用户可编辑子集，解析顺序为 schema 默认值、注册方的组合 `base`、用户文档。
+| [`settings/`](settings/README.md) | 定义命名空间注册、分层解析与提交 | `ctx.settings` |
+| [`settings-local/`](settings-local/README.md) | 在本地文件中存储设置并观察外部编辑 | 注册到 `ctx.settings` |