Agent-System/.doc/ops/short-term/2026-09-28-intent-material-fallback.md

title, status, created, owner, task_id, policy_revision, review_state, integration_state, deployment, cleanup, remote_sync, updated

title	status	created	owner	task_id	policy_revision	review_state	integration_state	deployment	cleanup	remote_sync	updated
资料类提问不再落入阶段推销模板	blocked	2026-09-28	Cursor	intent-material-fallback-2026-09-28	agent-governance-2026-09-23-fav-constraint-restored @ 434d542c3c	pending	pending	not_required	pending	not_requested	2026-09-28

资料类提问不再落入阶段推销模板

范围与授权

用户要求：test 上 zhangqizhe 在「全自动冲击波治疗仪1」询问说明书、操作视频、竞品资料时，不要再回复「完全理解您想再掂量一下…V0.5」模板；并核对 wanjiahao 发送「1」的失败是否同一类问题。

授权：只改代码并合入 local dev，dev 真实链路验证后再谈 test 晋升。test 目录属主与 PI_AGENT_RUNNER_URL 本轮不改。

允许写路径：internal/intent、internal/coordinator、internal/chat、.doc。工作树已快进到 dev 8889011e5b6bd35a1d992ae5aec3f1c1c8bdae31（原始基线 8f77053f5169502eaf3e4e4135a082e8914f3704）。分支 fix/intent-material-fallback-2026-09-28。mutex：intent+coordinator。

非目标：不新增第 19 类意图；不改 ADVANCE_STAGE 失败后的静默回合；不晋升 test/main；不 push。

问题登记与经验检索

检索词：掂量、AMBIGUOUS_FALLBACK、reply_source、说明书、ADVANCE_STAGE。台账与 .doc/ops/lessons 无同机制命中。本任务登记：

• ISSUE-20260928-material-template-reply（本任务修复）
• ISSUE-20260928-advance-stage-silent-fail（只登记）

经验：LESSON-20260928-material-noun-not-sales-template。

现象

test 库 sess-p8-u33（项目 8，用户 33）中「上一代产品说明书」「竞品的操作视频」等助手消息 reply_source=template，正文为阶段推销，多条内容哈希相同。识别结果为 CASUAL_CHAT / AMBIGUOUS_FALLBACK，置信度 0.2。

sess-p5-u32 在 2026-09-28 01:29:46Z 的「1」（turn 22）status=failed，没有助手消息。约 14 分钟后第二条「1」（turn 23）完成阶段推进。

根因分析

已证实（问题 A）：

1. matchKnowledgeQuery 没有说明书、操作视频、彩页、竞品等资料词，输入掉进 CASUAL_CHAT 保底（置信度 0.2），再被收成 AMBIGUOUS_FALLBACK。
2. handleAmbiguousConsult 对非问句直接拼「掂量 / V0.5」模板。问句标记才会改去闲聊。
3. 对话模型早退不打日志。test 进程属主 weichen，data/test/workspaces/dialogue 属主 root，MkdirAll 返回 EACCES 后回复保持模板。test 服务的 PI_AGENT_RUNNER_URL 指向 dev runner 18865（test runner 是 18866）。环境问题留到 dev 验证之后；代码侧补上失败原因。

已证实（问题 B，不修）：turn 22 意图 ADVANCE_STAGE / EXPECTATION_HIT。工作区 stage_V0.5_feasibility_1790558986793391446 的 step_03_regulatory 失败且输出为空，回合随后没有助手消息。与推销模板不是同一条失败路径。

同类问题与影响范围

关联场景/入口	与原例共用的机制	检查方法与证据	判定及影响
犹豫征询（「你觉得呢」）	同一模糊分支	单测仍要求保留掂量对照	保留，征询判断早于问句改道
编写/撰写手册	资料词与写动词重叠	「请撰写详尽合规手册」不得标 materials	写动词仍走任务触发
标杆案例	同一意图 QUERY_SIMILAR_CASES	无 query_topic=materials 时仍走原案例模板	资料请求用 slot 分流，避免伪造案例
阶段推进失败无回复	不是意图词典	turn 22 无助手行	另立 issue，本轮不改

修复

• 资料词命中 QUERY_SIMILAR_CASES，query_topic=materials，置信度 0.82。有知识库命中则 reply_source=kb；否则对话模型；再失败则中性追问并写 fallback_reason。
• 模糊分支里，非犹豫、非空输入不再使用阶段推销模板。
• generateDialogueReply 早退打 dialogue_reply_fallback，原因写入 CoordinationResult.ReplyFallbackReason；reply_source=template 时落入消息 metadata。

五态

• review_state: pending
• integration_state: blocked（2026-09-28 20:45 工作树在 8889011e。已关掉工作树或分支已消失、且 scope 为 . 的夜间 integrate 空锁。task register 仍被拒：same_scope，持有者 quality-gate-heading-deploy-2026-09-28，overlap 5a90581e-5a70-42e2-9745-8f04ac0ec11f。该分支还有未进 dev 的文档提交 5c0a84f7。nightly-advance-land-2026-09-28 占 .doc 且状态 in_progress。controlled-projection-project-binding-2026-09-28 占 internal/coordinator，约 20:35 仍有新提交）
• deployment: not_required（:8080 仍是基线二进制 pid 1002830。真实链路打在工作树二进制 127.0.0.1:18080，已停止）
• cleanup: pending
• remote_sync: not_requested

ISSUE-20260928-material-template-reply

• issue_state: verifying
• severity: high
• owner: Cursor
• 验收：单测三条原始输入为 QUERY_SIMILAR_CASES / materials / 0.82。dev 库真实回合（项目 6024，会话 sess-intent-material-probe-2）reply_source=kb，不含「掂量」。报告见 测试报告。:8080 尚未换成这版二进制。

ISSUE-20260928-advance-stage-silent-fail

• issue_state: open
• severity: high
• owner: Cursor
• 下一步：独立授权后再修「小队步骤失败必须落一条助手失败说明」。本记录不把该问题标成已修。