context bind

src/api/API_INTERFACE_TABLE.md

@@ -78,7 +78,57 @@
 | `GET` | `/v1/status` | 透传 `get_status` 的状态响应 |
 | `POST` | `/v1/command` | 统一命令入口（请求体为 executeCommand JSON） |
 
-### 5.2 Discovery 路由
+### 5.2 设备树 / 设备路由
+
+| 方法 | 路径 | 请求参数 | 说明 |
+|---|---|---|---|
+| `GET` | `/api/v1/device-tree` | 无 | 返回当前设备树快照 |
+| `GET` | `/api/v1/devices` | 无 | 返回当前运行态设备列表 |
+| `GET` | `/api/v1/devices/{id}` | path: `id(int)` | 返回指定运行态设备详情 |
+| `PATCH` | `/api/v1/device-tree/nodes/{id}` | body: 任意可变节点字段子集 | 部分更新设备树节点；当前至少保护 `id`、`params.stableKey`、`params.online`、`params.lastSeenTs` |
+
+### 5.3 规则管理路由
+
+| 方法 | 路径 | 请求参数 | 说明 |
+|---|---|---|---|
+| `GET` | `/api/v1/rules/status` | 无 | 返回动态规则计数状态 |
+| `POST` | `/api/v1/rules/filter` | body: `id`, `endpointHash?`, `deviceId?`, `stableKey?`, `condition?` | 新增过滤规则 |
+| `DELETE` | `/api/v1/rules/filter/{id}` | path: `id` | 删除过滤规则 |
+| `POST` | `/api/v1/rules/transform` | body: `id`, `endpointHash?`, `deviceId?`, `stableKey?`, `scale?`, `offset?`, `unit?` | 新增转换规则 |
+| `DELETE` | `/api/v1/rules/transform/{id}` | path: `id` | 删除转换规则 |
+
+- 说明：
+  - `transform` 规则已经在 `PipelineEngine::applyTransformAndEnrich(...)` 中生效。
+  - `filter` 路由当前主要提供“注册表管理”能力；动态 filter 规则尚未真正接入 `PipelineEngine::stage3Filter(...)` 的执行链路。
+
+### 5.4 Pipeline 路由
+
+| 方法 | 路径 | 请求参数 | 说明 |
+|---|---|---|---|
+| `GET` | `/api/v1/pipeline/status` | 无 | 返回 pipeline 运行状态、session 数量、队列容量、插件摘要与 counters |
+| `GET` | `/api/v1/pipeline/counters` | 无 | 返回 `in/out/drop/error/mergeDrop` 计数器快照 |
+| `GET` | `/api/v1/pipeline/config` | 无 | 返回当前运行时配置快照 |
+
+- 说明：`/v1/status` 仍然是 control-plane 摘要（规则 + discovery + mapping），不等同于 `/api/v1/pipeline/status`。
+
+### 5.5 插件 / 协议能力路由
+
+| 方法 | 路径 | 请求参数 | 说明 |
+|---|---|---|---|
+| `GET` | `/api/v1/plugins` | 无 | 返回 parser / framer / mapper 三类逻辑插件的统一列表 |
+| `GET` | `/api/v1/plugins/protocols` | 无 | 返回按协议聚合后的能力快照（parser/framer/mapper pluginId） |
+| `GET` | `/api/v1/plugins/mappers` | 无 | 返回 mapper 插件列表 |
+
+### 5.6 Metadata / Profile 路由
+
+| 方法 | 路径 | 请求参数 | 说明 |
+|---|---|---|---|
+| `GET` | `/api/v1/metadata` | 无 | 返回 metadata 字典全量快照 |
+| `GET` | `/api/v1/metadata/{metadataId}` | path: `metadataId` | 返回指定 metadata 详情 |
+| `GET` | `/api/v1/profiles` | 无 | 返回全部设备 profile 快照 |
+| `GET` | `/api/v1/profiles/{deviceId}` | path: `deviceId` | 返回指定 `deviceId` 关联的全部 profile |
+
+### 5.7 Discovery 路由
 
 | 方法 | 路径 | 请求参数 | 说明 |
 |---|---|---|---|
@@ -88,7 +138,7 @@
 | `POST` | `/api/v1/discovery/clear` | 无 | 清空发现池样本 |
 | `GET` | `/api/v1/discovery/samples` | query: `offset?`, `limit?`, `endpointHash?`, `protocol?` | 拉取样本（按更新时间倒序，且过滤已映射 key） |
 
-### 5.3 Mapping 路由
+### 5.8 Mapping 路由
 
 | 方法 | 路径 | 请求参数 | 说明 |
 |---|---|---|---|