外观
13 · HTTP API 面
Client ↔ Host 的唯一通道
没有 RPC：客户端是静态 bundle（非动态 Cordis Package），无法用 host.call，全部走同源 fetch（注册在 connection 的载波中立 Fetch 注册表，见下表脚注）。统一 json() 响应（no-store + nosniff），body 强制 application/json ≤64KB；并发校验不在这张表上——配置写入的 expectedRevision 由宿主 form 承担（见下段），表内的写路由各自落到自己那层的所有者。全站共 16 条 /api/auto-approval-llm/* 路由（host 常量 route-table.ts:LFEEDBACK_ROUTE；client 引用 client/index.ts:LSETTINGS_ROUTE、client/approvals/shared.ts:LFEEDBACK_ROUTE），每条入口第一行都过 isTrustedFetchRequest 闸门，不存在无设防的「普通」路由。
删除动作走 POST + x-auto-approval-op: delete：路由注册在 connection 的载波中立 Fetch 注册表（connection.fetch.register），该注册表只承载 GET/HEAD/POST；Web 载体把它挂到 web server 的 /api 前缀，shell 载体直接分派同一个 handler，因此同一套路径在两种载体下都可达。表中方法列为 GET/POST 且用途含「清空/吊销」的行，其删除语义由该请求头触发。
配置写入不在本插件路由表里：设置页的写由宿主完成——Plugins 面板把该行命名空间的 form 交给页面，页面提交路径 op，宿主落 profile patch；脚本要写配置时走宿主自己的平面 POST /api/settings/mutate（只读为 POST /api/settings/describe，需浏览器会话），scripts/verify-runtime.mjs 的设置轮即走该通道。本插件的 /settings 因此只剩只读一途。
/settings 只认 GET：该路由按「非 GET 一律 405」处理，HEAD 探测同样落在那条拒绝上——拿到 405 + Allow: GET，而不是 GET 的响应头。这是 fail-closed 方向的取舍（该路由已无任何写路径可被绕开，拒绝不会放宽任何语义），以 HEAD 探测该端点可用性的操作者工具应改用 GET。
| 路由 | 方法 | 用途 | 信任平面 |
|---|---|---|---|
/feedback | POST | 客户端上报 outcome（auto:true）+ approval 完成 ACK | 特权 [ ] 仅回环 |
/settings | GET | 配置快照 {value,revision,writable,applies,configError}（只读；非 GET → 405 + Allow: GET + {"ok":false,"error":"method-not-allowed"}） | 特权 [ ] 仅回环 |
/reviewer-credential | GET/POST | 端点密钥 {configured,writable}，永不回显 value | 特权 [ ] 仅回环 |
/test | POST | 在线端点连通性探针（https 外网放行 + 公网地址强制 + fake-ip 豁免，8s 超时 max_tokens:1，非 2xx 带回错误摘要；仅当探针目标与已配置端点同址时才回退已存密钥）；模型库校验 modelFound | 特权 [ ] 仅回环 |
/providers | GET | provider 目录 {id,name}（模型来源 picker 下拉） | 特权 [ ] 仅回环 |
/llm-models | GET | ?provider= 列某 provider 的模型 | 特权 [ ] 仅回环 |
/reasoning-efforts | GET | ?provider=&model= 列该模型的 reasoning efforts + defaultEffort（无 resolveModel 支持返回空列表） | 特权 [ ] 仅回环 |
/history | GET/POST | 记录查询（逆序）/ 清空（仅清内存+history，审计留墓碑） | trustedHosts |
/llm-latency | POST | 清空 LLM 延迟遥测窗口 + 文件（不动审批历史；与 history DELETE 互不清） | trustedHosts |
/tool-stats | GET | 精确名单页签的候选工具统计（最近工具 chips） | trustedHosts |
/learning-store | GET/POST | 已学习条目列表（键哈希+脱敏骨架+计数）/ 吊销单条（即时生效，落 learning-revoked 审计） | trustedHosts |
/review-status | GET | 单审批 countdown/follow 状态；callId 走 x-auto-approval-call-id 头（防 URL/devtools 泄漏）。可选 x-auto-approval-wait-ms 进入长轮询：held 至该 ask 的 revision 变化或预算（上限 20s）用尽，客户端断开即释放。状态对象带单调 revision、expiresAt（宿主时钟）与 remainingMs（按宿主时钟算出的剩余），可选带 category?（类别层闭集标签，供该 ask 的终局审计记录署名） | trustedHosts |
/session-review-status | GET | 会话级发现：列出该会话当前全部待审（{callId, phase, action, seconds, remainingMs, revision, source?}[]）；sessionId 走 x-auto-approval-session-id 头，缺失返 400。官方面板被 panelDelayMs 推迟期间，客户端靠它渲染芯片/胶囊 | trustedHosts |
/reveal-approval | POST | 提前放行被推迟的官方面板（「现在查看」）；callId 走 x-auto-approval-call-id 头。未知或已结算的 ask 返 {ok:true,value:{revealed:false}}，不伪造面板 | trustedHosts |
/session-mode | GET | 查会话权限 preset（mode）；本进程无该会话 live agent 时同样返 200 + mode: null（会话在历史里但 agent 尚未实例化属正常状态，不以错误状态表达——与 /stats 同口径，也避免浏览器对失败请求的不可抑制记录） | trustedHosts |
/stats | GET | 会话统计 {mode, reviewMode, counts{total,allow,deny,timeout,breaker}, breaker{…tripped}}；sessionId 走 x-auto-approval-session-id 头 | trustedHosts |
「特权平面」是什么意思
settings / reviewer-credential / feedback / test 与模型目录三路由（providers / llm-models / reasoning-efforts）传 []（空白名单）→ 强制仅回环同源（权威取自 Host 头且须为回环；Fetch handler 不读 socket，缺失 Host 时退回请求 URL）。前四者是「能改状态或驱动 host 发请求」的配置域——LAN 用户即使进了白名单也不能改配置、读密钥或把 host 当 SSRF 探针；后三者与消费它们的设置卡同处回环平面，LAN 设备不可读取模型目录。其余 9 条查询路由走 trustedHosts（webRuntime 配置快照 → --trusted-host；两者皆无时保持仅回环，fail-closed）。早前文档列过的 /models 已退役（代码注释 route-table.ts:LLLM_MODELS_ROUTE「Named llm-models (not /models) so the retired /models route…」→ 拆为 providers + llm-models）、/history/export 从未实现，均不在上表。