Browse Source

docs(plugin-manager): keep the package summaries within the summary budget

master now bounds a README Summary at 100 words; the boot group, the plugin
manager, and its host face say the same in fewer. The zh config catalog gains
the paragraph break the merge dropped.
Yichen Jiang 1 month ago
parent
commit
ca291b0100

+ 1 - 1
docs/config-catalog.i18n.yaml

@@ -3,4 +3,4 @@
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/config-catalog.md
 config-catalog.md: 2032b54b9d97067f58f23bd96584f068c599290f
-config-catalog.zh.md: 526107f0f40e964a80def6944eed6ee7ad024950
+config-catalog.zh.md: 2313262fbd188d79ac0beccc7b6b85f3fe31ab8b

+ 2 - 0
docs/config-catalog.zh.md

@@ -973,6 +973,8 @@ export interface Config {
 ```
 
 来源:[`packages/host/plugin-manager/src/index.ts:42`](../packages/host/plugin-manager/src/index.ts)
+
+
 <a id="deepseek-aidsh-host-webserver"></a>
 
 ## `@deepseek-ai/dsh-host-webserver`

+ 2 - 2
packages/boot/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/boot/README.md
-README.md: 497b8159ee099d2442cc022b905c3bdcea8e8d6b
-README.zh.md: 7e8f43955e048a5f9769e40a68a7ebfaca6a296d
+README.md: 4fde0d1581212f2891882120f902545eb821fefc
+README.zh.md: 6c3bab2bb6e5791af56aed8a452cc7d673fc0573

+ 1 - 1
packages/boot/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-The boot group provides what every dsh app bin needs to start and to manage what it starts: `app-boot` turns a `cordis.yml` plus your environment and patch layers into a running app with clear failure messages, `cmdline` lets the app own its command-line flags and `--help`, and `plugin-manager` installs, enables, and edits a profile's plugins for the `dsh plugin` command and the Web host alike. With these packages you can run `dsh` or write a new application or test fixture that boots the same way. All three are libraries imported by `apps/cli`, host packages, and test-only Loader fixtures, never plugins a composition loads. This page maps the group; each package README owns its per-package contract.
+The boot group provides what every dsh app bin needs to start and to manage what it starts: `app-boot` turns a `cordis.yml` plus your environment and patch layers into a running app with clear failure messages, `cmdline` lets the app own its command-line flags and `--help`, and `plugin-manager` installs, enables, and edits a profile's plugins for the `dsh plugin` command and the Web host alike. All three are libraries imported by `apps/cli`, host packages, and test-only Loader fixtures, never plugins a composition loads; each package README owns its contract.
 
 ## Table of Contents
 

+ 1 - 1
packages/boot/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-group"
 
 ## 概述
 
-boot 组提供每个 dsh app bin 启动以及管理所启动之物所需的全部能力:`app-boot` 把 `cordis.yml` 连同你的环境与 patch 层变成运行中的应用,并给出清晰的失败信息;`cmdline` 让应用持有自己的命令行 flag 与 `--help`;`plugin-manager` 为 `dsh plugin` 命令与 Web 宿主安装、启用与编辑 profile 的插件。借助这些包,你可以运行 `dsh`,也可以编写以同样方式启动的新应用或测试 fixture。三者都是 `apps/cli`、宿主包与测试专用 Loader fixture 导入的库,绝不是组合加载的插件。本页是组的映射;各包 README 负责各自的包级约定。
+boot 组提供每个 dsh 应用 bin 启动、并管理所启动内容所需的东西:`app-boot` 把 `cordis.yml` 连同环境与补丁层变成一个带清晰失败信息的运行中应用,`cmdline` 让应用自己拥有命令行参数与 `--help`,`plugin-manager` 为 `dsh plugin` 命令与 Web 宿主安装、启用与编辑 profile 的插件。三者都是被 `apps/cli`、宿主包与仅测试用的 Loader fixture 导入的库,从不是组合加载的插件;各包 README 拥有自己的契约。
 
 ## 目录
 

+ 2 - 2
packages/boot/plugin-manager/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/boot/plugin-manager/README.md
-README.md: 4580e5b0454759143de38564fe5ed6041be0d856
-README.zh.md: 8f0320f5c5d1550f7c5b7892fee35a185fbe70dd
+README.md: 39fc1f9a10e1359ce4806f214a91a6bce08e8126
+README.zh.md: 4da79eed6bdd3c1274afe9a475614e8f17fac07b

+ 1 - 1
packages/boot/plugin-manager/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-plugin-manager` is what changes a profile's plugins, with no Remote protocol attached. `PluginInstaller` needs only the profile on disk: it runs pnpm in the profile directory, probes every package a run added in a child process, and removes again what has no place in a profile — the `dsh plugin add` command uses it before any plugin starts. `PluginManager` needs the booted tree: it moves a bundle in and out of the profile's layer list and recomposes the tree through `profileRuntime`, composes a bundle again when its rows failed, adds and removes rows in the profile's global user layer or one agent preset's, says what disabling a package would strand, and folds the manifest, the probe record, and the live tree into one view per package. Every refusal or failure is a `PluginOperationError` carrying a `plugins/*` code; the Web host's [`dsh-host-plugin-manager`](../../host/plugin-manager/README.md) exposes the manager as the `plugins` Remote and turns each failure into a Remote error of the same code.
+`dsh-plugin-manager` changes a profile's plugins. `PluginInstaller` needs the profile on disk: it runs pnpm there, probes every package a run added in a child process, and removes what has no place in a profile — `dsh plugin add` uses it before any plugin starts. `PluginManager` needs the booted tree: it enables and disables bundles through `profileRuntime`, retries failed ones, adds and removes rows in the global or a preset's user layer, reports dependents, and folds manifest, probe record, and live tree into one view per package. Failures carry `plugins/*` codes; [`dsh-host-plugin-manager`](../../host/plugin-manager/README.md) exposes the manager as the `plugins` Remote.
 
 ## Table of Contents
 

+ 1 - 1
packages/boot/plugin-manager/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-plugin-manager` 是改变一个 profile 的插件的地方,不带任何 Remote 协议。`PluginInstaller` 只需要磁盘上的 profile:在 profile 目录运行 pnpm,在子进程里探测一次运行新增的每个包,并把在 profile 里没有位置的包再移除——`dsh plugin add` 命令在任何插件启动之前就用它。`PluginManager` 需要已启动的树:把组合包移入或移出 profile 的层列表并经 `profileRuntime` 重新组合树,在组合包的行失败时重新组合它,向 profile 的全局用户层或某个 agent preset 的用户层添加与移除行,说明停用一个包会搁浅什么,并把 manifest、探针记录与在线树折叠成每个包一份视图。每次拒绝或失败都是一个带 `plugins/*` 码的 `PluginOperationError`;Web 宿主的 [`dsh-host-plugin-manager`](../../host/plugin-manager/README.zh.md) 把管理器暴露为 `plugins` Remote,并把每个失败转成同码的 Remote 错误。
+`dsh-plugin-manager` 负责改动 profile 的插件。`PluginInstaller` 只需要磁盘上的 profile:在那里运行 pnpm,在子进程里探测本次新增的每个包,并把在 profile 里没有位置的包再移除——`dsh plugin add` 在任何插件启动之前就用它。`PluginManager` 需要启动好的树:经 `profileRuntime` 启用与停用组合包、重试失败的组合包、在全局或某个预设的用户层里增删行、报告依赖方,并把 manifest、探针记录与实时树折叠成每个包的一份视图。失败带 `plugins/*` 代码;[`dsh-host-plugin-manager`](../../host/plugin-manager/README.zh.md) 把管理器暴露为 `plugins` Remote。
 
 ## 目录
 

+ 2 - 2
packages/host/plugin-manager/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/host/plugin-manager/README.md
-README.md: e6e966ae7d970e2c9d498b52c4938e4cd333976a
-README.zh.md: c8530361bb20b421fa54cf87f9e26ea14d62f97b
+README.md: da884551d16ea64c1ac16e54a5400f757f28b3da
+README.zh.md: 45d33ae40f318df3ceb908841011766d25893828

+ 1 - 1
packages/host/plugin-manager/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-host-plugin-manager` is the Web host's face of plugin management. It mounts `pluginManager` as a Typert service and exposes the `plugins` Remote — `list`, `add`, `uninstall`, `enable`, `disable`, `retry`, `addRow`, `removeRow`, `setRowDisabled`, `dependents` — each method relaying to the [`dsh-plugin-manager`](../../boot/plugin-manager/README.md) `PluginManager` built over this context, and each `plugins/*` failure crossing the wire as a `RemoteError` of the same code. What the operations do, and the `plugins/changed` and `plugins/install-log` events that follow them, belong to that package; this one reads the profile runtime, the preset roster, and the agent registry off the context and hands them over. Client packages consume the Remote through the [`api-remotes`](../../api/remotes/README.md) assembly.
+`dsh-host-plugin-manager` mounts `pluginManager` as a Typert service and exposes the `plugins` Remote — `list`, `add`, `uninstall`, `enable`, `disable`, `retry`, `addRow`, `removeRow`, `setRowDisabled`, `dependents` — each relaying to the [`dsh-plugin-manager`](../../boot/plugin-manager/README.md) `PluginManager` built over this context, with every `plugins/*` failure crossing the wire as a `RemoteError` of the same code. What the operations do, and the `plugins/changed` and `plugins/install-log` events that follow them, belong to that package; this one reads the profile runtime, the preset roster, and the agent registry off the context and hands them over. Clients consume the Remote through the [`api-remotes`](../../api/remotes/README.md) assembly.
 
 ## Table of Contents
 

+ 1 - 1
packages/host/plugin-manager/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-host-plugin-manager` 是插件管理在 Web 宿主上的那一面。它把 `pluginManager` 挂为 Typert 服务并暴露 `plugins` Remote——`list`、`add`、`uninstall`、`enable`、`disable`、`retry`、`addRow`、`removeRow`、`setRowDisabled`、`dependents`——每个方法转接给在本上下文之上构造的 [`dsh-plugin-manager`](../../boot/plugin-manager/README.zh.md) `PluginManager`,每个 `plugins/*` 失败以同码的 `RemoteError` 过线。操作做什么、以及跟随操作的 `plugins/changed` 与 `plugins/install-log` 事件,都属于那个包;本包只从上下文读出 profile runtime、preset roster 与 agent 注册表并交过去。客户端包通过 [`api-remotes`](../../api/remotes/README.zh.md) 装配消费该 Remote。
+`dsh-host-plugin-manager` 把 `pluginManager` 挂载为 Typert 服务并暴露 `plugins` Remote——`list`、`add`、`uninstall`、`enable`、`disable`、`retry`、`addRow`、`removeRow`、`setRowDisabled`、`dependents`——每个方法都转给建立在本上下文之上的 [`dsh-plugin-manager`](../../boot/plugin-manager/README.zh.md) `PluginManager`,每个 `plugins/*` 失败以同码的 `RemoteError` 过线。操作做什么、以及随之而来的 `plugins/changed` 与 `plugins/install-log` 事件属于那个包;本包只是从上下文读取 profile runtime、预设名册与 agent 注册表并交给它。客户端经 [`api-remotes`](../../api/remotes/README.zh.md) 装配消费该 Remote。
 
 ## 目录