From a49ef8ee4adf93cc41bf3f6dfc7e707996e9c7bc Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Sun, 6 Sep 2026 21:35:46 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E6=A8=A1=E6=9D=BF=E7=94=9F?=
 =?UTF-8?q?=E6=88=90=E8=A7=84=E5=88=99=E8=A1=A5=E6=95=B0=E5=80=BC=E5=BC=BA?=
 =?UTF-8?q?=E8=BD=AC=E2=80=94=E2=80=94=E5=AD=97=E7=AC=A6=E4=B8=B2=E6=95=B0?=
 =?UTF-8?q?=E5=AD=97=E8=A2=ABAPI=E6=8B=92InvalidParameter=E7=9A=84?=
 =?UTF-8?q?=E7=9C=9F=E5=AE=9E=E8=B0=83=E7=94=A8=E5=AE=9E=E6=8A=93=E6=95=99?=
 =?UTF-8?q?=E8=AE=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index aae6db0..3107c16 100644
--- a/README.md
+++ b/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 软链列表已含本模块