36 KiB
description, kind
| description | kind |
|---|---|
| 从 Web 侧栏管理 profile 的插件组合包、它们的行，以及插件的配置。 | package-reference |
@deepseek-ai/dsh-client-ui-plugin-manager
English | 中文
桌面端产品事件使用可选的产品埋点服务，不包含普通 Web 交互。
概述
使用 Web 侧栏的插件入口管理 profile 已安装的组合包，以及安装随附、默认关闭的官方组合包。可以启停组合包及其行、在 Host 读出 spec 指向什么之后安装组合包、查看 pnpm 输出、停止一次运行，并启用它新增的包。卸载会要求确认。注册了配置页的插件在这里、在它自己的页面上编辑；设置里只保留只读的插件列表。
目录
使用本包
宽度小于 768px 时，页面使用 20px 的左右内边距，与会话页头对齐。
Ralph 循环和会话搜索仍随包提供，但默认不在两个插件列表中展示，只有 profile 启用或另行安装后才显示。已有的启用状态仍可管理；关闭随安装提供的版本后，它会再次隐藏。在添加插件中输入准确包名，再选择立即启用，即可使用随包提供的版本，无需再次下载。侧栏会话搜索独立于此功能。LiveShare 在其 bundle manifest 中声明相同的默认隐藏意图（dsh.bundle.listedByDefault: false），因此在自身声明的行开始运行或被启用前，它不会出现在两个列表（含更多页）中。页面的 manifest 规则是通用的：未声明 listedByDefault: false 的组合包会列出；声明了的，只有在 profile 启用、安装随附版本被选中，或它声明的某一行开始运行时才列出；隐藏的组合包也不能通过 ID 打开详情。
在侧栏选择插件。信息按钮使用 11px 的 caption 色图标和 20px 方形悬停区域，与副标题间隔 4px。它说明当前页用于配置官方插件、安装和管理其他插件，设置 → 内置插件则展示内置插件列表及运行状态。悬停或聚焦显示共享 tooltip；点击后保持展开，直至再次点击、Escape、Tab 或外部点击。页面首次打开时通过 api-remotes 读取清单与组合包；没有受管 profile 的 Host 上页面显示为不可用。内置插件配置按配置的顺序列出官方配置页：子智能体、网页搜索、Agent 循环、终端。实验性插件展示主要的可选组合包，标题旁的更多打开同名的独立页面。该页列出符合展示条件的官方组合包，也包含主列表已有的条目，Codex 和 Claude Code 子智能体排在最后。返回按钮回到主列表，已安装插件保持在实验性插件下方。组合包详情返回打开它的列表。目录条目在安装或移除后保持原位置。已安装插件列出其他 profile 组合包。安装随附的可选组合包没有卸载操作。实验性包在两个列表中均保留实验性标签。开启仅在该页列出的组合包会按该页中的位置把它加入主列表，关闭后它只留在该页，但 manifest 声明默认隐藏的组合包会从该页消失；其他组合包在两个列表中均保持原位。没有组合包 patch 的依赖不是插件，除非 profile 选中了它才会带异常标签列出。全局配置仍在设置的内置插件分区中编辑。
页头可用宽度缩小时，“刷新”和“添加插件”先变为保留可访问名称与 tooltip 的图标按钮；标签再从常规最小宽度收紧为文案所需宽度，仍不足时操作组才换行。信息按钮紧随副标题文字。主页面的页头和列表共用一个滚动容器。页头控件随滚动位置移动，到达紧凑态位置后停住；反向滚动沿同样的坐标返回。页头保留静止态的布局高度，因此控件移动不会改变列表的滚动范围。只能滚动少量距离的列表可能在页头完全收拢前到达底部。“更多”列表的返回与标题行固定，详情页的页头随内容滚动。“已安装/发现”标签使用总高 34px 的紧凑控件，选中指示块与外框之间留 2px。副标题随滚动离开视口；有标签时标题也随之滚出，标签在空间足够时停靠到“刷新”“添加插件”旁边。窄页面中，标签与图标操作优先在标题下方共用一行；放不下时，标签始终在操作组上方。滚动过程中两组控件的相对顺序保持不变。静止态与紧凑态分别保留 28px 和 16px 的页面顶部留白，紧凑态控件下方保留 16px。macOS 静止态保留框架的标题栏安全区；折叠态在侧栏展开时上下各留 16px，侧栏收起时再避让框架顶部安全区，使控件位于原生窗口控件下方。仅在 macOS 侧栏收起时，紧凑态控件在原有框架安全区之外的顶部留白统一由 16px 减为 8px，不受窗口宽度影响；静止态布局与紧凑态底部留白均不变。Windows 使用框架已有的标题栏偏移，不重复叠加。分隔线在紧凑页头底部横跨页面，列表初始的顶部留白随内容滚动。悬停样式只在可悬停的指针下生效，点按不会让卡片、行或菜单项停留在悬停态；卡片与图标操作改以按下填充回馈触摸。安装、注册表与筛选输入框在粗指针下使用 16px 字号，iOS Safari 不会因聚焦而放大页面。
已安装的组合包及其插件行在卡片和详情页中，按当前界面语言显示各自的标题与描述。每个字段先读取导出的 locale meta，缺失时回退到包根插件可访问的 package.json，子路径插件从不读取；标题最终使用完整包名或模块名，两处都没有描述时不提供包描述。作者格式见插件展示元信息。组合包卡片、详情和组件行显示包根的清单 icon 或导出的 ./icon，或子路径插件导出的 <子路径>/icon；未声明或无法解码时保留默认插画。安装预览仍使用注册表或 manifest 信息。
组合包页面在其各部分中首先显示该组合包的详细介绍文档，不带单独的标题：以当前界面语言、带图片的 Markdown 显示该组合包的详细介绍。该文档是组合包 locale/<language>.json 中 meta.detail 指定的 Markdown 文件，没有时为组合包的 README，由 pluginManager.readBundleDetail 按 dsh-plugin-detail 的文档顺序读取；不读取组合包声明的仓库。已安装组合包的文档来自其自身文件，不访问网络；按需官方组合包的文档按其提供的版本从 npm 文件 CDN 读取。文档加载期间，该部分显示三行骨架屏；没有文档的组合包不显示该部分；读取失败时说明原因，并提供重试。原始 HTML 会被省略，相对路径的图片从 Host 上该文档旁的位置加载，相对链接保持为文本，文档高度超过该部分的高度上限时在该部分内滚动。文件未安装的组合包（例如按需官方组合包）从 npm 文件 CDN 读取：读取前先询问 Host 的注册表比较，npmmirror 响应最快时，先从 npmmirror 读取该文档及其图片。已安装组合包的读取不等待该比较。任何 profile 变化和连接重置都会重新读取已显示的文档。
官方按需卡片遵循包的显示声明，在安装前即可离线读取。在“添加插件”中输入不带版本的官方包名时，使用 Host 提供的匹配版本或源码 checkout 目标，保留用户选择的安装源，并在安装后提供“立即启用”。开启会打开已有的安装进度对话框，安装当前 Host 提供的目标并选择配置层。安装源回退、取消和脚本审批继续使用同一组控件。关闭保留依赖；移除是独立操作。版本或开发链接来源不同会提供更新；详情显示当前及所提供的来源和版本。更新先删除已安装的包，再以相同的选择状态安装所提供的包，并报告是否需要重启；删除之后安装失败时，该包保持未安装。文件缺失或不可读的包在诊断旁保留记录的依赖来源。已启用的 bundle 在 checkout 目标不可用时仍可关闭。
首次读取列表时，页面显示一条较短的分组标题占位和四行骨架卡片，沿用真实卡片的行、图标和文字间距，操作区域留白。骨架使用与 Session 搜索相同的透明度呼吸动效，在减少动态效果模式下保持静止。无障碍加载文案和读取时机不变；刷新时保留已有列表，安装及组件加载仍使用各自的状态提示。
组合包不支持 DSH Host 的操作系统时，卡片和详情页会显示原因，关闭状态的开关不可启用；已选中的组合包仍可关闭。插件管理器对直接请求执行同一限制。
刷新按钮在悬停或键盘聚焦 500 毫秒后显示提示。它重新读取列表，再依次检查每个可更新组合包的新版本；读取失败时不做检查。手动刷新期间，按钮显示旋转加载指示并保持禁用，直到所有待处理读取和这些检查结束且至少经过 400 毫秒，避免加载指示一闪而过；重复刷新请求会被忽略，已有列表保持可见。成功不显示 toast。已有列表时，手动刷新失败保留缓存内容并显示失败 toast，即使已离开插件页也能看到；再次选择该按钮即可重试。在首次成功读取列表之前，失败仍原位显示提示与重试。后台读取不显示刷新按钮的加载指示。
安装一个组合包
添加插件控件包含主按钮和独立箭头，箭头用于选择添加方式。
| 按钮或菜单项 | 结果 |
|---|---|
| 添加插件 | 打开安装对话框并聚焦包名输入框。 |
| 箭头：选择添加插件方式 | 打开包含安装及插件贡献动作的菜单。 |
| 安装第三方插件 | 关闭菜单，打开同一对话框，从包名、Git 仓库或本地目录安装。 |
| 让 Agent 创建插件 | 由 ui-agent-preset 提供此项时，关闭菜单并进入创造模式，制作 DSH 插件。 |
首次使用时，如果未显式配置安装源、pnpm 使用官方 npm 源，且列表提供 npmmirror，Host 会并发探测这两个源，选择最先成功响应 HTTPS ping 的源。已记住的选择、用户手选、管理器显式配置，以及自定义或未知的 pnpm 源均保留。在初次探测期间点击安装会等待这次有时限的操作；迟到结果不会覆盖手选或重新打开已关闭的对话框。
Host 通过普通 fetch 代理向 https://registry.npmjs.org/-/ping 和 https://registry.npmmirror.com/-/ping 发送 GET 请求，以最先返回 2xx 的源为结果；重定向和失败不参与选择。随后取消另一条请求、丢弃两个响应体，并在清理完成后返回。默认时限为 1500 毫秒，包括不可用结果在内的探测结果均缓存五分钟。在 ui-plugin-manager 上配置 registryProbeTimeoutMs 和 registryProbeCacheTtlMs；registryProbeEnabled: false 关闭探测。两条请求都失败或超时时保留现有默认源。不使用 IP 地区服务，也不发送 Session 内容。
添加插件接受包名（可带版本）、Git 地址、压缩包或本地绝对路径；对话框说明包名就是 README 里 dsh plugin add 后面的那一段。在包名或自定义安装源输入框中按 Enter 会提交安装请求，但用于确认输入法候选词的 Enter 不会触发安装。输入框下方的插件安装引导和示例展开一段引导，给出包名示例；填入示例把它填进输入框。输入框中若原样保留 Git 地址或本地路径的模板文本，仍会显示要求替换为实际值的提醒。安装按钮上方的提示框在引导收起后也可见，并说明官方按需插件提供显式更新；其他插件通过卸载后重新安装升级。旁边的安装源写着安装首先询问的注册表，展开后可选：pnpm 自身的注册表，按它实际指向的源命名——npm 官方源、中国大陆镜像源，其余以主机名显示——Host 读不到时保留中性的默认名称，只列一次，选项标题带上主机名（主机名即名称时不重复显示）；Host 配置的每个镜像（pluginManager.registries），npmmirror 显示为中国大陆镜像源；以及手动输入的 http(s) 地址。选项使用不透明选择面板，仅悬停行使用底色，主机名不加括号并使用三级文字色。自定义地址区域在悬停时高亮；点击其中任意位置会选中自定义源并聚焦输入框，焦点样式与包名输入框一致。仅通过键盘聚焦不会改变已选安装源；激活自定义单选项或编辑地址才会选中自定义源。Tab 从已选单选项移到地址框，Shift+Tab 反向返回；从任一端移出时关闭选择器，并将焦点交还安装源按钮。切到预设源时保留自定义地址草稿，切回后继续使用。提交无效的自定义地址时会阻止安装，展开安装源选择器并聚焦地址框。包名和自定义地址输入框无效时保留红色错误边框，聚焦时加上共享的蓝色内嵌焦点环。选项从控件上浮在对话框之上，展开不会拉长卡片；引导使卡片高过视口时，卡片内容可以滚动。初始选择遵循上文的响应比较规则；之后选择记在本浏览器（localStorage）里，下次打开对话框从它开始，Host 不再提供的已记住地址保留为手动输入的地址；在安装源列表返回前开始安装，也仍请求该地址。安装先让 Host 在所选注册表读出 spec 指向什么（pluginManager.inspect）：列表中已有的名字、所有注册表都没有的名字、没有包的路径、没有组合包 patch 的包，或 pnpm 会拒绝的 spec，都以一句话回到输入框下方，spec 保留可继续编辑；所有注册表都连不上时，这句话列出问过的每一个。随后安装从作答的那个注册表开始。通过检查的 spec 打开安装中界面，展示 Host 读到的包名、一句话简介和版本，pnpm 的命令与输出折叠在查看安装详情之后。每条命令行保持单行并可横向滚动；选择文本时可包含屏幕外的参数。安装完成的画面显示 pnpm 实际安装的版本；只问过一个注册表的运行装入的版本与检查读到的不同时，会写明两个版本，说明差异来自 pnpm 供应链安全策略（minimumReleaseAge），提示新发布版本的风险，并给出卸载后应安装的精确 name@version。安装完成后提供立即启用：启用新组合包、关闭对话框，并在当前页面有对应卡片时滚动定位；直接关闭则让它保持已安装但关闭。Host 改问另一个注册表时，安装中界面会说明哪个源没能提供这个包、现在改问哪个，详情里每次 pnpm 运行都带一个写明所用源的标记。安装失败时按 Host 的归因用一行话说明原因——所有安装源都连不上，并列出问过的每一个；GitHub 地址或压缩包链接自身的主机连不上，换源无济于事；包不存在、磁盘已满、profile 不可写、pnpm 拦下了构建脚本——当这次安装要求启用新增的组合包时，还会注明安装本身已完成、失败发生在启用时。详情里有 pnpm 输出和结束这次对话框的那次运行的完整 Host 日志路径，安装详情没有收到终端输出时也会直接说明；重试就在手边，Host 把失败归于所问注册表时还在旁边提供更换安装源，回到 spec 输入界面并展开安装源选项；Host 已经把 profile 文件放回原样。pnpm 拦下依赖的安装脚本时，失败界面列出等待允许的包，并以允许这些脚本并重试取代重试；Host 把授权写进 profile 的 pnpm-workspace.yaml（失败的运行保留 pnpm 写入的这个文件）再运行 pnpm，安装完成界面会说明允许了哪些脚本。安装成功不代表模块一定能够激活。
准备和下载期间，取消安装会请求 Host 停止运行并等待确认。加载组合包的阶段不可取消。点击 ×、按 Escape 或点击遮罩会立即隐藏对话框，并在可以取消时请求取消。查看安装任务会重新打开同一任务并保留输出；结果待定或尚未确认时不能发起另一项安装。确认取消后回到 spec 输入界面并显示 toast；manifest 与 lockfile 已恢复，已下载文件可能保留。安装响应丢失后会请求恢复结果；核对安装状态和重连会重试该请求。Host 已无活动请求时，未能获取安装结果允许检查插件列表后返回编辑。早于接收确认的取消请求会等待并自动重试；取消失败可手动重试。隐藏的任务通过 toast 通知结果，不会重新弹出对话框。
Host 将网络失败或超时归因于 GitHub 地址，且提供 npmmirror 时，对话框显示无法访问 GitHub，超时时显示连接 GitHub 超时，提供改用国内镜像和取消。选择镜像后回到空的包名输入框，记住所选安装源，不自动开始下一次安装。安装已在使用 npmmirror 时（无论是选中、手动输入，还是 pnpm 自身配置指向它），按钮改为试试其他方式，同样回到空的包名输入框并展开插件安装引导和示例，安装源保持不变。其他失败保留原有诊断和操作。镜像提供注册表中的包及依赖，不代替 GitHub 仓库下载。
更新注册表组合包
从注册表安装、Host 标为 updatable 的第三方组合包，在其页面的行列表下方有 版本 区块。打开页面时向 Host 询问一次它的新版本；重新检查 再问一次。区块显示一行摘要：正在检查；已是最新及上次检查时间；可更新到声明组合包、接受当前 DSH、未弃用且非预发布的最新版本；新版本需要更新 DSH 及其所需的 DSH peer；或检查失败、最后失败的注册表及 重试。有新版本的摘要可展开为每个版本一行，从新到旧，带 dist-tag、预发布与已弃用标签、无法安装的原因、发布日期，以及可安装版本的 更新；列表以已安装版本结尾。其下显示作答的注册表，前面的注册表失败时标为 备选源，旁边是检查时间和 显示预发布版本。检查失败时可通过 详情 展开问过的每个注册表、其角色、失败类型和 pnpm 的原文。从链接、路径、git 或压缩包安装的组合包以及官方组合包不显示版本区块。不会提供更旧的版本。
检查结束后，列表工具栏说明有几个插件可更新、全部已是最新，或部分检查失败，有更新的卡片显示 可更新。详情页头部增加带目标版本的 更新到。
更新 打开确认框，显示已安装版本与目标版本、安装来源，以及安装失败时会保留或重新安装已安装版本。Host 运行更新期间，对话框列出它通告的步骤并保持打开。结果说明新版本已开始运行、需要重启才生效及 Host 给出的原因、目标版本在任何改动前被拒绝、移除已安装版本失败、目标版本未能安装而已安装版本保持不变、更新失败且已重新安装原版本，或重新安装也失败、插件未安装；失败的运行可展开 pnpm 输出。答复丢失时说明结果未知，并重新读取列表。
切换一个组合包
组合包页面在标题下方显示完整包名。组件列表之后的「来源信息」给出在别处安装它所需的 spec（pnpm add 接受的形式），安装随附的官方组合包显示「内置」，随后是当前版本。组合包开关改变其层选择。profile 变更触发重新读取时，已显示的详情文档保持可见，直到新结果返回。Host 应用更改期间，开关保持禁用，旁边显示旋转指示器；操作区在开关左侧固定预留 22px。常驻状态区域向屏幕阅读器播报进行中的更改。启用了 HMR 的 profile 在操作完成前重组；没有 HMR 的 profile，以及被更高层覆盖的组合包，会以 toast 说明。Host 读不了的组合包带异常标签，其页面给出原因，且不能打开；提供管理组件的组合包保持锁定。Host 以错误码作答，由页面字典措辞；pnpm 与 Loader 自己的诊断原样显示。页面从卡片和详情页中排除内置 profile 组合包和持久终端组合包，无论其启用状态、依赖声明或 Host 异常如何。隐藏组合包保留其在 Host 中的可用性和启用状态。Host 清单仍保留完整数据；设置中「插件」分区的「插件列表」标签页负责查看它们的插件。
切换组合包里的一行
组合包页面上行的开关调用 pluginManager.setPluginEnabled，按开关规则在 profile 的 cordis.patch.yml 中记录该行的启用状态。启用了 HMR 的 profile 的树随即重组，该行的宿主半区卸下或挂上，组合包其余部分照常运行，页面无需重载即跟随客户端模块图。行使用共享状态标记表示 Host fiber 阶段：pending 与 disabled 为 idle，loading 与 unloading 为 ongoing，active 为 done，failed 为 error。开关只出现在已打开的组合包上；没有存活条目的行，以及 Host 不通过 profile patch 寻址的行，带着 Host 的原因锁定。超过十行的列表带一个按本地化标题、描述、行 id 和模块名筛选的输入框。
配置页
自带配置的插件把配置渲染在本页而不是设置里，通过本页声明的三个 slot：plugins.item（list）用于官方插件，按其 label 列在内置插件配置分组里；plugins.bundle.config（以组合包的包名为键）用于组合包自己的配置，显示在组合包页面的描述与行之间；plugins.row.config（以 <包名>#<行 id> 为键）用于某一行的配置，这一行由此多出一个配置控件，打开该行自己的页面。页面用 view: 'page' 渲染带自己保存控件的表单。官方插件卡片还在标题下渲染 view: 'summary'；行详情页只在缺少包描述时使用该视图。只有保存才写入：页面负责画标题、图标与面包屑，条目的表单在离开页面时丢弃暂存的修改。安装随附的四个宿主平面配置页——shell 执行器、agent loop、子智能体、DeepSeek 搜索提供方——各来自一个伴生包：ui-settings-shell、ui-settings-agent-loop、ui-settings-subagent 与 ui-settings-web-search，在 Host 服务其命名空间期间注册。组合包的浏览器半侧用同样的方式注册：
ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
name: 'plugins.row.config',
key: '@acme/dsh-sidebar#sidebar',
locale: 'acmeSidebar',
}, ({ t, view }) => view === 'summary' ? t('summary') : <SidebarForm t={t} />))
组合包的 patch 必须以该 id 声明这一行；注册只在组合包开启期间存在，因此关闭的组合包不显示配置控件。
详情页扩展点
对某个不属于自己的组合包、行或官方插件有话要说的插件，通过本页声明的三个 list slot 向该对象的页面贡献内容：plugins.detail.actions 在页头放一个控件，位于页面自己的开关和卸载之前；plugins.detail.badge 在标题旁放一个标签，位于版本、实验性和异常标签之后；plugins.detail.section 在页面自身内容之下放一个区块——组合包页在来源信息之后，行页和官方插件页在配置之后。每个条目都以页面的 subject 渲染：{ kind: 'bundle', pkg }、{ kind: 'row', pkg, row } 或 { kind: 'item', id }，其中 pkg 与 row 携带包名、版本、是否已安装、是否启用以及行列表这些供贡献者判断的事实。条目对无话可说的 subject 返回 null，自绘区块外观；页面按 order 排列条目。
ctx.slots.inject('plugins.detail.section', () => ctx.slots.register({
name: 'plugins.detail.section',
id: 'acme-health',
locale: 'acmeHealth',
}, ({ t, subject }) => subject.kind === 'bundle' ? <HealthSection pkg={subject.pkg} t={t} /> : null))
行页只在某个 plugins.row.config 条目点名这一行时存在，因此给行的贡献渲染在该配置打开的页面上。
组件列表和详情页显示 Host 清单中的当前启动诊断。重新打开页面后仍能看到原因，组件恢复后诊断消失。组件列表与来源信息默认使用 l2 分割线，Computer Use 详情页使用 l3。
页面标签页
其他插件向 plugins.tab 列表 slot 注册条目，即可在页面自带的已安装标签页之后添加一个标签页；条目的 label 为标签页命名，order 决定其位置。至少存在一个条目时，标签页显示在页头下方；在组合包、行或官方插件的页面上隐藏。离开插件后，所选标签页保持不变；所选标签页的条目被移除时，回到已安装。页面渲染所选条目以代替自身的分组，并在此时隐藏自身的刷新和添加按钮。owner props 提供 install({ spec, registry?, title, version }) 和 openPackage(name)。install 用于用户已在标签页中确认的版本：安装对话框在检查界面打开，不显示 spec 表单，在以较小等宽字显示的 spec 上方用 title 和 version 标明插件，并在进度和结果界面保持该名称，完成后显示已安装的版本；只在这一次安装中首先使用 registry，且从不记住它；被拒绝后提供重试；如果有隐藏中的安装任务，则改为重新打开该任务。openPackage 切换到已安装，并在该标签页列出该组合包时打开其页面，该页面的返回按钮回到打开它的标签页；页面不列出的组合包（例如内置 profile 组合包）只打开「已安装」列表。已确认的安装不提供 GitHub 镜像恢复，因为该恢复会重新打开 spec 表单；其返回按钮用于取消正在进行的安装。ui-plugin-market 在这里贡献发现标签页。
访问控制：插件入口、页面、刷新提示、Host 变更订阅与 pluginNavigation 只在当前 Peer 可以调用 pluginManager/listBundles 时存在；之后每次授权都会重读已加载过的列表，撤权期间 pluginChanges 不更新。owner 始终有权限。
理解实现
插件管理依据 profile 的依赖记录：已安装组合包可启停、可移除，随安装提供的组合包保持锁定。profile 与安装都不持有的已选组合包同样提供卸载，卸载只把它从 profile 的组合包列表中移除。这一区分不决定启动失败策略。
实现细节——点击展开
注册
Host 入口通过生成的 Remote 接口暴露 pluginRegistryProbe.fastest()，共享进行中的比较、让缓存按时过期，并在卸载时中止和等待未完成探测。卸载后调用会返回拒绝的 Promise。
浏览器插件通过 ctx.slots.inject() 注册 plugins 侧栏入口与它的 main 面板，使两者跟随 slot 延迟声明、本地化变化与销毁。页面为全局页面，不属于任何 Session。显示文本来自包元信息与页面字典。
添加控件复用 Button、Menu 和 MenuItemButton。两个安装入口调用同一个 openInstall 回调，使用 InstallDialog 与 PluginManagerController。root 作用域的 list slot plugins.add.actions 接受贡献的 MenuItemButton 行，放在安装项之后；每个贡献者接收 onDismiss() 回调，在开始动作前关闭菜单。
插件页有权限时，其他 Client 插件可读取 pluginNavigation 并调用 openList()，选中插件主列表，已打开详情页时也如此。此浏览操作保留当前 Session，不打开安装对话框。安装仍需在插件页显式发起。
store
PluginManagerController 拥有组合包视图、忙碌键、提示、安装进度和卸载确认。每次读取先问清单 Host 是否管理着 profile，再把 listBundles 与 listPlugins 合成每个组合包一份视图，其行携带存活条目的启停状态与 fiber 阶段。它合并重叠读取，在操作后、收到 plugin-manager/changed 时以及重连后刷新，并在销毁后忽略晚到结果。安装输出按 job id 分组，对话框还保留失败步骤与这次运行的完整 Host 日志路径。安装对话框沿 idle → checking → starting → running → done | failed 推进，cancelling 与 applying 按 Host 的报告呈现，安装或取消响应丢失时进入 unconfirmed；已确认的 applying 阶段不会倒退。通过 waitForInstall 恢复结果，无活动请求时结束为 unknown；checking 与所有活动阶段使用 ongoing，最终页面使用 done 或 error。检查在一个 AbortController 下运行，返回编辑或关闭会中止它并丢弃其结果；运行只能通过 pluginManager.cancelInstall 停止。关闭会隐藏任务而保留其状态。如果取消请求先于安装到达，在进度或输出确认该请求后会再次请求取消。Host 无法应用的变更、要等重启的变更、被更高层覆盖的变更，都是会自行消失的 toast。
配置 slot
自定义条目页以 Host 条目 id 作为注册 id；行页面使用 bundle 包名和行 id。当条目提供可编辑 Config 字段时，页面宿主传入 form.state 和 form.mutate(operations, expectedRevision)。自定义页面负责草稿和校验提示，并可复用 ui-primitives 的 ConfigField。整个 bundle 的页面可以包含多个条目，因此没有单一表单。
页面的 main 注册把 plugins.item、plugins.bundle.config 与 plugins.row.config 声明为子 slot，因此它们与页面同生，注册方的 ctx.slots.inject 会等到它们出现。configLedgerSource 把三份账本投影成一个可观察对象——按账本顺序排列、标签按当前语言解析的官方条目，以及组合包与行的键——在账本或语言变化前保持缓存；页面把它作为 useConfigLedger 绑在 store 旁边，自身从不点名任何可配置插件。注册拥有的导航 store 选择主列表、完整的实验性插件列表、某个组合包、某个官方插件或组合包的某一行；切换离开插件面板时重置为列表，React 重新挂载则保留所选目标。新的注册从主列表开始。安装后的高亮仅在当前页面有对应卡片时滚动定位，不改变所选页面。其他 Client 插件经 ctx.get 或 ctx.inject 以可选方式读取 pluginNavigation，调用其 openBundle(packageName) 即可打开组合包详情，不改变当前 Session；把它写进插件的 inject 会让该插件在无权限的页面上一直等待。首次读取清单期间保留导航目标；组合包不存在时显示列表。注册与做出它的浏览器半侧同生共死。dsh-client-modules 只把一个包的浏览器半侧挂在说明符恰为包名的那一行 Loader 行上，所以组合包为自己或任一行注册的页面，都会在那一行被关闭时一起消失；需要在其他行关闭时仍保留页面的子插件，应作为独立的包发布。 卡片和详情页仅为 dsh-official-bundles 中 EXPERIMENTAL_BUNDLES 名单内的包显示实验性标签，包名前缀不决定标签。
plugins.bundle.config 以 npm 包名为 key，提供 Bundle 详情配置。Client 插件可订阅只读的 ctx.pluginChanges.bundle(packageName)，在组合包或其组件行变更期间暂停查询。通知先于管理请求发出，页面关闭后仍会更新；订阅方在卸载时释放观察。plugins.bundle.activation 在用户从列表或详情页显式启用后提供 Bundle 自有引导，并传入关闭引导和打开详情的回调。仅列出已启用的 Bundle 不会触发引导。
进一步探索
这些页面覆盖侧栏、Remote 调用与 Host 侧管理器。
- ui-sidebar——插件入口注册进的面板列表；ui-layout——页面占用的主 slot。
- api-remotes——
pluginManager.*与pluginInventory.*背后的 Remote BFF 面。 - plugin-manager——本页驱动的 Host 侧管理器。
- ui-settings-shell、ui-settings-agent-loop、ui-settings-subagent、ui-settings-web-search——注册进本页
plugins.itemslot 的官方配置页。
模型体验
无，本包是浏览器侧的管理界面，不注册任何面向模型的内容。
KV Cache 影响
无；本包既不组装也不发送 provider 请求。
已知限制与延期工作
- Ping 响应时间不代表包下载吞吐量。探测使用 Host fetch 的网络路径，pnpm 专用代理设置可能使用不同路径；用户始终可以手动选择安装源，安装仍遵循现有回退规则。
这些限制界定了管理视图的范围；它们是当前包的约束。
- 只给出结束对话框那次运行的日志路径——详情给出的是该运行的完整 Host 日志，位于 Host 文件系统；更早的换源尝试没有入口，连接远端 Host 的浏览器也可能打不开该路径。
- 页面生命周期——刷新浏览器会丢失跟踪的请求与输出。同一页面内重连可以恢复活动请求；Host 不保留已完成的结果。profile 文件锁串行化安装写入。
- 只管理组合包——没有组合包 patch 的依赖在安装前就被拒绝；profile 里已有的这类依赖不上页面，除非 profile 选中了它；加载普通插件模块仍是文件操作。
- 行只显示阶段，不显示原因——失败的行只显示为失败，没有 Host 的错误文本；Host 日志里有。
- 一次只能安装一个——对话框一次运行一个 pnpm 命令；第二个 spec 要等前一个完成。
- 没有版本选择器——spec 按 pnpm 接受的写法输入；页面不列出注册表版本。官方按需条目提供当前安装对应的目标。其他 profile 插件通过卸载后重新安装更改版本；安装随附的组合包随 DSH 升级。
- 安装源选择只属于本浏览器——它存在
localStorage里，所以另一个浏览器会独立计算初始推荐；dsh plugin命令和 agent 工具使用 Host 配置的注册表。 - 每次读注册表都要运行 pnpm——打开对话框、检查、安装各问一次 pnpm 自身配置指向哪里；没有 pnpm 的机器读作未知，不提供备选。
开发备注
维护者的工作上下文——点击展开
无。