每一层按应用顺序排开，右边写清它对插件树做了什么——`插入 78`、`覆盖 2`、`禁用 24`。首尾两层各有标记，因为光有编号说不清方向。不参与合并的那几个配置文件（profile 的 `cordis.yml`、`settings.yaml`、`.credentials.yaml`）也列在同一张表里并注明——你多半是为了它们的路径才找过来的。
选中一层，右栏列出这一层碰过的每一条 entry，每条都能直接跳到插件轴。
### 按插件——一行一份档案
实时的 loader 树——容器、嵌套的 realm、被禁用的条目压在它所属那一层的末尾折叠起来。选中一条，右栏是它的完整档案：
- **哪来的**——哪一层把它插进来的、完整 entry id、包名与磁盘路径
- **接线**——它提供和依赖哪些服务，各自的对端是谁；宿主内置的服务会明说是内置，而不是显示成「缺提供者」
- **影响面**——有哪些插件（传递地）依赖它，于是「关掉它会炸什么」是一个数字加一份名单，不是猜
- **它的设置**——当前生效值、插件默认值、你的覆盖，并排摆着
- **配置怎么叠出来的**——按顺序列出碰过这条 entry 的每一层，以及每层做了什么
上面的筛选 chip 收窄同一份列表：需要注意、你改过、已禁用、运行时注册、非官方。
### 按服务——插件之间真正的连线
服务才是插件之间真正的边，所以它单独占一根轴：每个服务谁提供、多少人在用，枢纽服务还给出完整影响面。这里是表不是画布，是有意的：真实 profile 的依赖图是星形的，枢纽的边无论用什么布局算法都会横穿整张画布。
### 按工具——agent 真正能调到的东西
一行一个**工具名**——`bash`、`read`、`exit_plan_mode`——不是一行一个插件。每行带上注册它的包、它的说明，以及关掉它会连带消失几个同源工具：因为关掉一个工具的实际落点是禁掉注册它的那个插件。
上游的工具定义里不带注册者，而且工具要等 agent 构造出来才注册。所以这一轴有两条数据来源，并且**会告诉你用的是哪条**：**运行时观察**（在注册发生的那一刻旁听，靠调用栈反查是哪个包）或**源码推测**（扫插件构建产物里的字面量，明确标注——运行时才算出来的名字它抠不到）。让第二条路变得多余的那个字段[已经向上游提了需求](docs/upstream/tool-provenance.md)。
### 按模型——每个模型是怎么进来的
一行一个模型，带上它所属的 provider 路由，以及把这条路由接进来的插件。右栏给出它的配置落在设置的哪个路径上，以及这条路由**靠什么激活——环境变量里的 API key、存起来的 API key，还是 OAuth 授权**。上游声明了可配、但你还没配的 provider 收在末尾折叠起来。
这一轴不碰网络：读的是 llm 服务自己的只读面，不会去调那个会真的敲你各家 provider 的模型发现接口。
### 按预设——会话手里那套东西是谁给的
一个预设 = 一份 agent 面的插件组合。会话开起来的时候挑一个，它决定这个会话手里有哪些工具、看到哪些提示词。一行一个预设，回答四件事：
- **有几个、谁是默认、此刻有几个会话在用它。** 「在用」按上游 `resolveSessionPreset` 的规则算：创建时选的记在 header 里，之后每换一次记一条事件，**最后一次赢**——只读 header 会把中途换过预设的会话算回它创建时那个。读不到会话实况时说「不知道」，不说「没人用」。
- **内置 / 三方 / 本地。** 上游只记 `system`（发行带的）与 `user`（本地写的），分不出「三方插件带进来的那一批」。这里按 root 目录的磁盘位置再判一次，和其他各轴共用同一条规则，并连带说出是**哪个包**带进来的。本地写的预设和 shell 权限同级——它直接决定模型手里有哪些工具。
- **配置是什么。** composition（`agent.cordis.yml`）按行列出：容器行的私有 realm、被显式关掉的行、以及开关写成 `!!js` 表达式的行都标出来。**表达式不求值**：静态侧只知道「有个表达式」，不声称它开着还是关着。两个文件都能点开看原文。
- **它们跟宿主面的插件树不是同一批。** 预设只在会话开起来时挂上去，所以「按插件」那一轴里找不到它们——这一点右栏会明说，免得你以为哪里漏了。
坏掉的预设仍然留在名单上并标出原因：藏起来的话它照样占着那个 id，你却看不见也删不掉。
## 点界面查插件
开关在设置页的洞察区。开了之后按住修饰键（默认 ⌥，可改成任意组合）：
- **悬停**——高亮鼠标下那块 UI，说出它是哪个插件插进来的，以及插在哪个位置（slot 名加那一格的键）。外面还有一圈虚线框，是这条 entry 的整块地盘。
- **点击**——直接开到工作台的「按插件」轴，选中那一条，右栏就是它的完整档案：哪来的、接线、影响面、设置、配置怎么叠出来的。
- **按住不放点右键**——展开「当前 → 根」的整条层级，从最里面那块 UI 一层层数到壳；点任意一层，跳那一层的插件。
按住的同一刻，**这一屏所有非官方插件插进来的界面会被琥珀色框出来**——三方的和本地的（`link:` 进来的自研包）都算。判据就是「按插件」那一轴在用的同一份：磁盘路径不在 `node_modules` 里 = 本地，`@deepseek-ai` scope = 官方，其余三方，不靠任何名单。于是「这一屏哪些东西不是 dsh 自带的」是一眼的事，不用一块块去指。
只标真的看得见的：屏外的、自己藏起来的（`visibility: hidden`、透明）、被别的东西整块盖住的（设置面板背后那些、滚出滚动容器的行）都不画，否则满屏是凭空的框。两种颜色分工固定——**琥珀 = 这不是 dsh 自带的，蓝色 = 你正指着这个**，混成同色就白标了。
它凭什么知道：dsh 的 web 客户端每一块 UI 都是插件注册进 slot 的。渲染时每个 slot 出口在 DOM 里留了一个锚点（`data-slot`），React 树上每条 entry 外面包着它的注册记录。归因就是从命中的元素沿着这条链往上收一遍。
**认不出来的时候会照实说。** 注册记录里自带的注册者名在生产构建里是压缩后的类名，而且会在包之间撞车——实测 `dsh-api-gateway`、`ui-open-in-app`、`api-workspace-files`、`client-modules` 的注册名全都是 `Z8`。所以包名不是从它反查的，而是在注册发生的那一刻从注册方身上取的：洞察装上之前就注册完的那些拿不到，那种情况只告诉你它插在哪个位置，不拿压缩名去猜。实际用起来页面上绝大多数 UI 都认得出——slot 注册大多要等父级先把位置声明出来，真正落账发生在首次渲染时，晚于所有插件的装载。
## 为什么它宁可说不知道
这个插件的大部分功夫，花在了「诚实的答案是不知道」的那些情形上——说不知道，而不是给一个看着挺像的数字：
- **短 id 撞名就不归因。** 同一个短 id 可能在两个 realm 里各有一份（`include:tool-bash` 与 `include:agent-presets:tool-bash`）。只要它在任一侧不唯一，来源层就留空，不猜。
- **算不出的表达式不当成 `false`。** 配置里的 `!!js` 表达式在重放时原样保留成一个不透明标记，并从对账报告里排除，而不是强转成布尔值。强转过一次，代价是 22 条假的「这个插件被禁用了」。
- **多个候选 provider 就保持多个。** 两个插件提供同名服务时，两个都列出来，而不是自信地连一条边到其中一个。
- **推测出来的数据会标出来。** 从构建产物里抠出的工具名标「源码推测」；注册时旁听到的不标。
- **挂不上插件的设置就直说。** 找不到归属插件的设置命名空间，标成「设置命名空间」，而不是显示成一个没有包名的插件。
- **版本错位只降级，不崩。** host 进程比浏览器产物旧时（改完没重启），摘要退回浏览器自己算并明说；host 还不认识的端点，对应那一轴空着并说明原因，而不是把整个面板染红。
## 只读边界
- 面板**只有一条写路径**：在「按插件」那一列点禁用 / 启用。除此之外没有任何编辑入口。这一条写路径本身也是有边界的：
- **只写 profile 补丁层那一个文件**（`$DSH_HOME/profiles/