Legion Loan Outreach Insight

录音转写洞察：先 parse-user-intent 反问确认时间与维度，再 fetch 拉数；默认近 1 个月 + 十维；默认报告页面。 触发：对象词（含教练/coach）+ 动作词，或完整口令，或显式 intent。

目标

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

---

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

text

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 且不拉数）。

脚本调用

bash

# 步骤 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：

json

{
  "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）。

---

入站参数

json

{
  "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	用户要求导出/邮件等，从其要求

---

十维拓客（默认维度）

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

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

---

错误与安全

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

检查清单

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