docs(readme): 模板生成规则补数值强转——字符串数字被API拒InvalidParameter的真实调用实抓教训

README.md

@@ -24,6 +24,14 @@ RBAC 角色），不依赖 prompt。菜单入口同样 Jinja `{% if is_admin %}`
 - 单位统一「元/千tokens」（元/百万 ÷1000）
 - 非 openai_compat 协议的模板存档但运行时不可调，如实告知
 
+## 模板生成规则（补充）
+
+- **数值强转**（2026-09-06 真实调用实抓后加固）：文档示例值为 int/float 的参数，
+  request_template 渲染表达式加 `|int`/`|float` 强转——表单/agent 传参常为字符串
+  数字（如 duration="5"），直接 tojson 出带引号字符串会被 API 拒
+  InvalidParameter。bool 是 int 子类，先行排除不加强转（保 UI 真值语义）。
+  强转改变模板内容 → 形态指纹漂移 → apply 自动弃旧建新，属预期行为。
+
 ## 宿主集成（已接入）
 
 - `pipeline-app/build.sh`：clone/pip install/wwwroot 软链列表已含本模块