mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-09-20 17:08:01 +00:00
生产事故(v1.3.0 部署后 agent 完全不应答)的根因之一就是这个约束没写清: 远程设备通道名 `device/<id>` 里的 `/` 让 `output_send__device/<id>` 无法通过上游的 函数名校验,上游对**整条请求**回 400(`Invalid 'tools[N].function.name'`), 网关 auto tier 全链条失败,内核只能报"所有 provider 都失败"。 这不是"某个工具不可用",而是**整个 agent 哑掉** —— 所以这条约束必须出现在 插件作者会看的地方(`RegisterOutputChannel` 文档 + README 的通道一节): - 通道名只允许 `[A-Za-z0-9_-]`,且总长要留出 `output_send__`(13) 的余量; - 名字若来自外部输入(设备自报 id 等),请在插件侧派生合规且唯一的名字。 内核侧**不做**净化/反解:通道名是插件自己的声明,就该由插件遵守契约。