Legion Loan Outreach Insight

目标

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

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

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

禁止只跑 fetch-asr-recordings.mjs 而不先意图解析（fetch 内置相同解析，若需反问会直接 ok:false 且不拉数）。

脚本调用

# 步骤 1：意图（不拉数）
echo '{"userId":"u","orgId":"o","userMessage":"帮我总结录音"}' | \
  node "{baseDir}/scripts/parse-user-intent.mjs"

# 步骤 2：确认后拉数（token 仅来自 Header / LEGION_AUTH_TOKEN）
export LEGION_AUTH_TOKEN="<JWT>"
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 | 用户要求导出/邮件等，从其要求 |

十维拓客（默认维度）

拓客场景 2. 触达人群 3. 开口获客话术 4. 客户需求 5. 客户拒绝原因
有效意向分类 7. 产品匹配 8. 成交阻碍痛点 9. 跟进动作 10. 拓客成效数据

每维：关键发现 / 典型摘录 / 量化指标 / 优化建议。

错误与安全

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

检查清单

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

Legion Loan Outreach Insight

Legion Loan Outreach Insight

目标

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

脚本调用

默认值（反问后仍不明确，或用户说「按默认」）

反问沟通

多轮合并 userMessage

网关确认字段（可选）

触发词速查

完整口令

入站参数

时间规则（parse-time-range.mjs）

维度与报告分支

样本量

数据拉取与部署

交付形态（outputFormat）

十维拓客（默认维度）

错误与安全

检查清单

多轮合并 `userMessage`

时间规则（`parse-time-range.mjs`）

交付形态（`outputFormat`）