每一层按应用顺序排开,右边写清它对插件树做了什么——`插入 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,你却看不见也删不掉。
## 为什么它宁可说不知道
这个插件的大部分功夫,花在了「诚实的答案是不知道」的那些情形上——说不知道,而不是给一个看着挺像的数字:
- **短 id 撞名就不归因。** 同一个短 id 可能在两个 realm 里各有一份(`include:tool-bash` 与 `include:agent-presets:tool-bash`)。只要它在任一侧不唯一,来源层就留空,不猜。
- **算不出的表达式不当成 `false`。** 配置里的 `!!js` 表达式在重放时原样保留成一个不透明标记,并从对账报告里排除,而不是强转成布尔值。强转过一次,代价是 22 条假的「这个插件被禁用了」。
- **多个候选 provider 就保持多个。** 两个插件提供同名服务时,两个都列出来,而不是自信地连一条边到其中一个。
- **推测出来的数据会标出来。** 从构建产物里抠出的工具名标「源码推测」;注册时旁听到的不标。
- **挂不上插件的设置就直说。** 找不到归属插件的设置命名空间,标成「设置命名空间」,而不是显示成一个没有包名的插件。
- **版本错位只降级,不崩。** host 进程比浏览器产物旧时(改完没重启),摘要退回浏览器自己算并明说;host 还不认识的端点,对应那一轴空着并说明原因,而不是把整个面板染红。
## 只读边界
- 面板**只有一条写路径**:在「按插件」那一列点禁用 / 启用。除此之外没有任何编辑入口。这一条写路径本身也是有边界的:
- **只写 profile 补丁层那一个文件**(`$DSH_HOME/profiles/