From ca291b010012145dea566e2340292bc70af78cb1 Mon Sep 17 00:00:00 2001 From: Yichen Jiang Date: Tue, 8 Sep 2026 16:55:27 +0800 Subject: [PATCH] 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. --- docs/config-catalog.i18n.yaml | 2 +- docs/config-catalog.zh.md | 2 ++ packages/boot/README.i18n.yaml | 4 ++-- packages/boot/README.md | 2 +- packages/boot/README.zh.md | 2 +- packages/boot/plugin-manager/README.i18n.yaml | 4 ++-- packages/boot/plugin-manager/README.md | 2 +- packages/boot/plugin-manager/README.zh.md | 2 +- packages/host/plugin-manager/README.i18n.yaml | 4 ++-- packages/host/plugin-manager/README.md | 2 +- packages/host/plugin-manager/README.zh.md | 2 +- 11 files changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/config-catalog.i18n.yaml b/docs/config-catalog.i18n.yaml index 0d8adf6a1e..c593deccd2 100644 --- a/docs/config-catalog.i18n.yaml +++ b/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 diff --git a/docs/config-catalog.zh.md b/docs/config-catalog.zh.md index 526107f0f4..2313262fbd 100644 --- a/docs/config-catalog.zh.md +++ b/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) + + ## `@deepseek-ai/dsh-host-webserver` diff --git a/packages/boot/README.i18n.yaml b/packages/boot/README.i18n.yaml index 86ea94a117..99e88116f8 100644 --- a/packages/boot/README.i18n.yaml +++ b/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 diff --git a/packages/boot/README.md b/packages/boot/README.md index 497b8159ee..4fde0d1581 100644 --- a/packages/boot/README.md +++ b/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 diff --git a/packages/boot/README.zh.md b/packages/boot/README.zh.md index 7e8f43955e..6c3bab2bb6 100644 --- a/packages/boot/README.zh.md +++ b/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 拥有自己的契约。 ## 目录 diff --git a/packages/boot/plugin-manager/README.i18n.yaml b/packages/boot/plugin-manager/README.i18n.yaml index 35e5fb6d7f..3c4899ad7e 100644 --- a/packages/boot/plugin-manager/README.i18n.yaml +++ b/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 diff --git a/packages/boot/plugin-manager/README.md b/packages/boot/plugin-manager/README.md index 4580e5b045..39fc1f9a10 100644 --- a/packages/boot/plugin-manager/README.md +++ b/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 diff --git a/packages/boot/plugin-manager/README.zh.md b/packages/boot/plugin-manager/README.zh.md index 8f0320f5c5..4da79eed6b 100644 --- a/packages/boot/plugin-manager/README.zh.md +++ b/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。 ## 目录 diff --git a/packages/host/plugin-manager/README.i18n.yaml b/packages/host/plugin-manager/README.i18n.yaml index 3d07363786..3aa44062fa 100644 --- a/packages/host/plugin-manager/README.i18n.yaml +++ b/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 diff --git a/packages/host/plugin-manager/README.md b/packages/host/plugin-manager/README.md index e6e966ae7d..da884551d1 100644 --- a/packages/host/plugin-manager/README.md +++ b/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 diff --git a/packages/host/plugin-manager/README.zh.md b/packages/host/plugin-manager/README.zh.md index c8530361bb..45d33ae40f 100644 --- a/packages/host/plugin-manager/README.zh.md +++ b/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。 ## 目录