张胜宇
9dcfa64bc5
feat(W29): NL2SQL 接线与只读边界守卫（会签项 18）
## 接线
发布 agent_tools/financial_nl2sql:financial_query -> [query_financial_data]
（tools/publish_financial_nl2sql_config.py --apply，治理动作）。
结果：新 release 260（financial-nl2sql-f1be6be8063f）生效、旧 244 转 superseded、
活跃配置 8 -> 9 条；**客服侧那 8 条逐字未变**（回读核对：缺失 0 / 被改动 0）。
在此之前该能力「代码全在、工具调不通」—— 按「工具 = 代码上限 ∩ 发布白名单，
缺配置失败关闭」，缺的就是这一条配置。
## 接线后实测量出的缺口（本次修复对象）
RuleBasedFinancialPlanner 不识别写意图动词：「删除所有客户的持仓记录」被判成
「查持仓」，返回 status="ready" 并生成一段 SELECT —— 8 条写意图问句 8/8 复现。
数据安全当时**并未破**（SQL 仍是 SELECT，被 _safe_sql_check 的 SELECT-only +
BANNED_SQL 兜住），故定性为「答复与诉求不符」而非「越权写库」；但一旦将来给该
工具加写能力，这里即成为起点。
## 会签（先补签、后改动）
该文件原本不在 docs/48 白名单任何一档（等于「白名单之外一律不动」）⇒ 先补
docs/49（A-10）组 5 · 会签 18 并登记为类 3，获批后才实施。同步更新
docs/48 类 3 表与 客服agent/D2.1 §1.6（镜像已同步）。
## 改法（守住会签单的「最小化边界」）
- plan() 入口增写意图预检 -> 返回带 unsupported_reason 的不可执行计划
- _validate_plan() 增「不可执行计划优先」判据
- query() 走**现成**的 status="rejected" 分支，未新增代码路径，审计照旧留痕
判据分两级以控制误杀：一级强拦（删除/清空/撤销/改成/写入/导入…）；
二级歧义写动词（修改/更新/变更/导出…）须**无查询语境词**才拦 ——
否则会误杀「费率变更历史」这类真实续问。
## 验证
- 只读护栏回归锁 8 条（与判据互为独立防线，判据退化时仍须绿）
- 写意图 8 条由 xfail 转为正式断言（全通过）
- 误杀边界 7 条（查询语境的歧义写动词不得被拦）
- NL2SQL 相关测试 84 passed
- 全量 pytest 2540 passed / 3 skipped / 0 failed（xfailed 归零）
- 金标 55 条与 W27 基线判分**逐项零差异**（M-1 55/55、M-4 55/55、四项零容忍全 0）
- ruff：改动文件 0 告警
2026-09-22 10:12:06 +08:00
..
2026-09-21 22:32:39 +08:00
2026-09-21 22:32:39 +08:00
2026-09-20 14:33:30 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 14:46:40 +08:00
2026-09-14 00:30:06 +08:00
2026-09-22 10:12:06 +08:00
2026-09-21 22:32:39 +08:00
2026-09-21 22:32:39 +08:00
2026-09-20 14:52:35 +08:00