docs(cordis): name EntryTree.commit in tree consumers

This commit is contained in:
Shigma committed 2026-10-28 17:56:32 +08:00
1 parent c1dbb40ced
commit d6fc02b173
4 files changed
+5 -5

No files matched your search

@@ -33,8 +33,8 @@
en: 42b15ac6321706aa
zh: 4ed0861911abaf5d
/deepseek-ai-dsh-host-directory-picker-auto/understand-the-implementation/design-concept:
en: abc8d3962e4580c3
zh: 4442dde69faf680f
en: 232e9be2165fae9e
zh: 6305799128399971
/deepseek-ai-dsh-host-directory-picker-auto/understand-the-implementation/the-resolution-table:
en: 0edb097d5df327e8
zh: e9b59fc2070dfc42
@@ -53,7 +53,7 @@ A wrong `native` choice degrades to the backend's existing retryable failure dia
### Design concept
The chooser is a pure decision plus a mount: `resolveDirectoryPickerBackend` samples host facts once at boot and returns a backend kind, and `apply` mounts the matching backend and surface packages as real Loader entries in the in-memory root tree — never persisted to a config file, because the root tree's `write()` is a no-op. The effect's disposer removes both entries and joins their fibers' teardown, so unloading returns only after both faces of the mounted interaction quiesced.
The chooser is a pure decision plus a mount: `resolveDirectoryPickerBackend` samples host facts once at boot and returns a backend kind, and `apply` mounts the matching backend and surface packages as real Loader entries in the in-memory root tree — never persisted to a config file, because the root tree's `commit(change)` is a no-op. The effect's disposer removes both entries and joins their fibers' teardown, so unloading returns only after both faces of the mounted interaction quiesced.
### The resolution table
@@ -53,7 +53,7 @@ kind: "package-reference"
### 设计理念
选择器是一次纯决策加一次挂载:`resolveDirectoryPickerBackend` 在启动时采样宿主事实并返回一个后端类型,`apply` 把匹配的后端与界面包作为真实 Loader 条目挂进内存根树——绝不持久化到配置文件,因为根树的 `write()` 是 no-op。该 effect 的 disposer 会移除两个条目并汇合其 fiber 的拆除,因此卸载只在所挂载交互的两面完全停稳后返回。
选择器是一次纯决策加一次挂载:`resolveDirectoryPickerBackend` 在启动时采样宿主事实并返回一个后端类型,`apply` 把匹配的后端与界面包作为真实 Loader 条目挂进内存根树——绝不持久化到配置文件,因为根树的 `commit(change)` 是 no-op。该 effect 的 disposer 会移除两个条目并汇合其 fiber 的拆除,因此卸载只在所挂载交互的两面完全停稳后返回。
### 判定表
@@ -1,5 +1,5 @@
// Disposes itself once active. The Loader treats a self-disposing entry as a
// config change and writes the tree back through `EntryTree.write()`, which is
// config change and reports it through `EntryTree.commit(change)`, which is
// the exact path that once truncated a preset file to `[]`.
export const name = 'self-dispose'
export function apply(ctx) {