军团贷款外联洞察（Legion Loan Outreach Insight）

Legion Loan Outreach Insight 目标 拉取 legion-hardware 的 ASR 转写并生成报告。仅依据 asrText，禁止使用 aiJiaolianResultJson / aiSummaryContent 作为结论依据。

工作流程（必须按序，禁止跳步）

• parse-user-intent.mjs → 解析时间 / 维度 / 交付形态
• needClarification=true → 反问用户，结束（禁止执行 fetch）
• 用户补充或 skipClarification / confirmed* → 再执行 fetch-asr-recordings.mjs
• 按 reportPlan + themeRelated + outputFormat 生成报告

脚本调用 # 步骤 1：意图（不拉数） echo '{"userId":"u","orgId":"o","userMessage":"帮我总结录音"}' | node "{baseDir}/scripts/parse-user-intent.mjs" # 步骤 2：确认后拉数（token 仅来自 Header / LEGION_AUTH_TOKEN） export LEGION_AUTH_TOKEN="" echo '{"userId":"u","orgId":"o","userMessage":"总结最近 5 天录音","skipClarification":true}' | node "{baseDir}/scripts/fetch-asr-recordings.mjs"

默认值（反问后仍不明确，或用户说「按默认」） 项 默认 报告说明 时间 近 1 个月 「未确认具体时间，已按默认最近 1 个月统计」 维度 十维拓客 「因未提取到明确的分析维度信息，已使用默认十维拓客统计框架处理」

反问沟通 parse-user-intent / fetch 在以下情况 needClarification: true： 信号 反问要点 timeRange.confidence = ambiguous 几天 / 几周 / 几个月 timeRange.confidence = missing 统计窗口；不答则默认 1 个月 analysisFocus.confidence = ambiguous 拓客 / 话术 / 教练 / 客户需求 / 或默认十维 analysisFocus.confidence = missing 分析方向；不答则默认十维 跳过反问： 用户话术中「就按默认 / 你看着办 / 用默认」 body：skipClarification: true（网关在用户回复后设置） body：confirmedTime / confirmedDimension（见下）

多轮合并 userMessage 网关将 首轮 + 追问回复 写入同一 body： { "userMessage": "帮我总结录音", "followUpMessage": "最近 5 天，按拓客复盘", "skipClarification": true } 或拼接为单字段 userMessage。脚本会合并 userMessage + query + followUpMessage。

网关确认字段（可选） 字段 示例 作用 skipClarification true 不再反问，按解析结果或默认拉数 confirmedTime "default" 或 { "startTime":"...","endTime":"..." } 锁定时间窗 confirmedDimension "default_ten" / "ten" / "AI 教练" / "股票趋势" 锁定维度或专题

触发词速查 激活（其一）： 对象词 + 动作词；完整口令；intent=legion-loan-outreach-insight。 动作词： 总结、汇总、归纳、梳理、概括、小结、复盘、盘点、整合、整理、摘要、报告、结论（及英文同义，须配对象词）。 对象词： 类别 中文 英文 录音 / 转写 录音、转写、ASR recording, transcript, ASR 拓客 拓客、走访、地推 outreach, field sales 话术 / 客户 话术、客户拜访 pitch, script, customer visit 教练 教练、AI 教练、教练反馈、教练点评 coach, coaching, AI coach, coach feedback 系统 legion-hardware legion, hardware 完整口令 总结最近 5 天录音 十维拓客报告 总结一下教练反馈 AI coach recap for last month 不触发： 仅「总结一下」无对象词； 仅调用 POST /api/recordings/ai-jiaolian 且无话术总结类动作词（走 AI 教练单次能力，不走本 skill）。

入站参数 { "userId": "...", "orgId": "...", "userMessage": "用户原话（必填）", "followUpMessage": "可选，第二轮补充", "skipClarification": false, "confirmedTime": "default", "confirmedDimension": "default_ten" } Header：Authorization: Bearer {JWT}（禁止 body.token）

时间规则（parse-time-range.mjs） 表述 confidence 行为 最近 5 天 / 近 2 个月 explicit 按解析查询 最近 / 近期（无数字） ambiguous 先反问 无时间 missing 先反问 反问后仍无 default 近 1 个月 时区 Asia/Shanghai；上限：月 ≤12，天 ≤366。

维度与报告分支 条件 输出 无显式专题（走十维） 十维拓客报告 + 默认维度说明（若适用） 用户明确「十维 / 默认十维」 十维（无需「未提取维度」说明） 显式专题且 themeRelated=true 仅 ## 用户关注：{主题} 显式专题且 themeRelated=false 仅：## 分析结果 → 无相关内容（禁止十维、禁止编造） themeRelated 由脚本用 主题核心词 匹配 asrText（已避免单独「KYC」「趋势」误命中）。

样本量 recordCount 处理 0 十维骨架或专题内写明「样本为空」 < 5 标注「小样本，结论仅供参考」

80（默认） 见 stdout recordsHint，分析时优先近期并抽样

数据拉取与部署 项 说明 默认 baseUrl http://192.168.109.50:8900（LEGION_HARDWARE_BASE_URL 可覆盖） 接口 GET 或 POST /api/recordings/asr-completed + startTime/endTime 部署 须 新 jar（POST 支持 body 内时间）；旧版 POST 仅 3 个月固定窗，自定义时间会失效 fetch 成功时 stdout 含：query、analysisFocus、themeRelated、reportPlan、outputFormat、records[]。

交付形态（outputFormat） mode 行为 page（默认） 按 templates/insight-report-page.md 生成完整报告页（Markdown/HTML） text 用户要求「只要文字/不要页面」 custom 用户要求导出/邮件等，从其要求

十维拓客（默认维度） 拓客场景

• 触达人群
• 开口获客话术
• 客户需求
• 客户拒绝原因

• 产品匹配
• 成交阻碍痛点
• 跟进动作
• 拓客成效数据

错误与安全 缺 userId / orgId / Authorization → 不调 hardware needClarification 时禁止编造数据 勿暴露 token、内网 IP/端口 body userId/orgId 宜与 JWT 一致（建议网关校验）

检查清单 已跑 parse-user-intent； needClarification 时已反问且未 fetch 默认时间/维度说明已写入报告（若适用） themeUnrelated 时仅输出「无相关内容」 交付形态符合 outputFormat 未使用 body.token