From d6fc02b1739b4b8ba563b6b2dbcc5638fcce2996 Mon Sep 17 00:00:00 2001 From: Shigma Date: Wed, 28 Oct 2026 17:56:32 +0800 Subject: [PATCH] docs(cordis): name EntryTree.commit in tree consumers --- packages/host/directory-picker-auto/README.i18n.yaml | 4 ++-- packages/host/directory-picker-auto/README.md | 2 +- packages/host/directory-picker-auto/README.zh.md | 2 +- .../tests/fixtures/plugins/self-dispose.js | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/packages/host/directory-picker-auto/README.i18n.yaml b/packages/host/directory-picker-auto/README.i18n.yaml index 8d47ba212a..5a69888f50 100644 --- a/packages/host/directory-picker-auto/README.i18n.yaml +++ b/packages/host/directory-picker-auto/README.i18n.yaml @@ -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 diff --git a/packages/host/directory-picker-auto/README.md b/packages/host/directory-picker-auto/README.md index 53058f761e..518916028a 100644 --- a/packages/host/directory-picker-auto/README.md +++ b/packages/host/directory-picker-auto/README.md @@ -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 diff --git a/packages/host/directory-picker-auto/README.zh.md b/packages/host/directory-picker-auto/README.zh.md index b4dc0b4dce..7fba47e345 100644 --- a/packages/host/directory-picker-auto/README.zh.md +++ b/packages/host/directory-picker-auto/README.zh.md @@ -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 的拆除,因此卸载只在所挂载交互的两面完全停稳后返回。 ### 判定表 diff --git a/packages/preset/agent-preset-registry/tests/fixtures/plugins/self-dispose.js b/packages/preset/agent-preset-registry/tests/fixtures/plugins/self-dispose.js index 97c01f95a4..d9c209deea 100644 --- a/packages/preset/agent-preset-registry/tests/fixtures/plugins/self-dispose.js +++ b/packages/preset/agent-preset-registry/tests/fixtures/plugins/self-dispose.js @@ -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) {