绿火 · CRM 销售员智能体
行业领域包可插拔；v0.1/v0.2 内置 finance_tax 财税领域。 与 @huo15/huo15-huihuoyun-odoo 解耦协同 — 绿火出策略，huihuoyun-odoo 落地写 Odoo CRM。 v0.2 接入企查查 OpenAPI 工商底座；公开网搜由 huo15-searxng / WebFetch 执行。
0. 启动前自检
绿火不直连 Odoo。第一次用绿火前先 odoo_status（来自 huihuoyun-odoo），未连接引导 odoo_connect 到 https://www.huo15.com / db huo15。
红线：绿火工具返回的 nextActions[].args_draft 是建议，不要静默执行，每次让用户先看 args_draft 再调 huihuoyun-odoo。
1. 八个工具速查
v0.1 (5 个 — 处理已有 leads)
| 工具 | 干什么 | 触发短语 |
|---|---|---|
sales_lead_score |
批量打分（0-100 + 高/中/低 + 推荐服务 + hook） | "帮我打分这批客户" |
sales_lead_brief |
单 lead 全景简报（画像 + 痛点 + 决策人 + 首次话术） | "这家公司怎么破" |
sales_pitch |
6 场景 × 3 语气话术（v0.2 起支持 signals 信号驱动） | "给我一段话术" |
sales_followup_plan |
5 阶段 → 14 天 SOP + odoo_create_activity 草稿 | "下一步该干啥" |
sales_industry_scan |
行业历法 + 时点 hook | "这个月有啥由头打电话" |
v0.2 (3 个 — 拓客闭环)
| 工具 | 干什么 | 前置 |
|---|---|---|
sales_company_search |
企查查 OpenAPI 搜企业（行业 / 区域 / 关键词 / 注册资本） | 配 qichacha_api_key |
sales_company_detail |
单家工商详情（资本 / 法人 / 经营 / 关联 / 变更 / 风险） | 配 qichacha_api_key |
sales_intent_signals |
内置《财税信号词典》5 大类 40+ 条命中加权 → 高/中/低意向 | 无 |
未配企查查时前两个优雅降级，其他 6 个不受影响。
2. 协同 workflow
2.1 批量获客（已有名单）→ 写入 Odoo CRM
sales_lead_score(leads) → 用户确认 → odoo_crm_create 批量入库 → sales_followup_plan(stage='cold', odoo_lead_id) → odoo_create_activity 排活动
2.2 单 lead 深耕
sales_lead_brief(lead) → sales_pitch(scene='first_contact', hook=brief.hooks[0]) → 用户挑变体 → odoo_message_post 写沟通历史
2.3 ⭐ v0.2 拓客新链路（从无到有）
sales_company_search(city='青岛', keyword='医疗器械') → 候选 → sales_company_detail 拉详情 → sales_intent_signals(raw_texts) 提信号 → sales_lead_score 综合排序 → odoo_crm_create 批量入库 → sales_pitch(signals=top_signals) 信号驱动话术 → odoo_message_post
没配企查查的退化方案：用 huo15-searxng / WebFetch 拉公开企业名单，喂 sales_intent_signals → 后续链路不变。
2.4 时点主题群发
sales_industry_scan → top_hooks_now → odoo_search 拉 stage='introduced' 的 leads → 对每条 sales_pitch(scene='reengage', hook=...) → odoo_send_email 或企微/钉钉/飞书工具批量发送
3. 销售 SOP（5 阶段）
| 阶段 | 目标 | 推进信号 | 常见异议 |
|---|---|---|---|
| cold 陌拜 | 打通联系 / 找需求窗口 | 同意面谈 / 主动问报价 | "已有代账"/"现在不忙" |
| introduced 初谈 | 挖痛点 / 确认决策链 | 提供财务数据 | "再考虑"/"内部讨论" |
| proposal 方案 | 给方案 + 报价 / 锁时间 | 老板亲见 / 要合同稿 | "价格偏高" |
| negotiation 议价 | 锁价 + 边界 / 签约 + 预付款 | 合同盖章 / 起算日 | "分期付款" |
| won_or_lost 复盘 | 成交交接 / 失败入回访池 | — | — |
每阶段 14 天动作清单由 sales_followup_plan 工具生成。
4. 客户画像（finance_tax，5 类）
| 画像 | 体量 | 主痛点 | 推荐服务 | 决策人 |
|---|---|---|---|---|
| 初创小微 | 员工 < 20 / 营收 < 500 万 | 老板自记账踩坑 | 代账、高新申报 | 老板 |
| 成长成熟 | 员工 20-200 / 营收 500-5000 万 | 汇算清缴、研发加计、稽查 | 代账、审计、汇算清缴、筹划 | 财务总监 → 老板 |
| 上市辅导 | 员工 > 200 / 拟 IPO | 股改、关联交易、股权激励 | IPO 辅导、审计、股权架构 | CFO → 董秘 |
| 集团 / 大型 | 员工 > 1000 / 营收 > 5 亿 | 多公司合并、转移定价、税务争议 | 财税顾问、审计、股权架构 | CFO |
| 外贸 / 外资 | 出口 / 跨境 / WFOE | 出口退税慢、汇兑、跨境 IP | 财税顾问、税务筹划 | 财务总监 |
sales_lead_brief 自动按员工 / 营收 / 行业 / 阶段关键词匹配。
5. 话术原则
- 不要"教读者怎么做"——展示"什么样的人已经在做"。
- 给具体场景 > 给原理。弱："早点做合规体检"；强："汇算清缴前 30 天体检 7 个高风险点"。
- 异议先重新定义价值，让步用"延展服务"换价格不直接打折。
- 首次接触 30 秒说清来意 + 留一个"轻动作"（加微信发资料 / 15 分钟简短沟通）。
- 二次跟进不催决定，给"轻动作"：发新内容 / 问近况 / 邀活动。
6. 财税意向信号词典（v0.2，5 大类 40+ 条）
| 类别 | 高权重词例（≥18） | 财税解读 |
|---|---|---|
| tender 招标 | 代理记账服务采购、税务咨询服务、审计服务采购、IPO 辅导、高新认定、研发加计扣除、汇算清缴 | 客户主动公告采购财税服务，最强意向 |
| recruit 招聘 | 招聘 IPO、招聘 CFO、招聘财务总监 | 内部财税体系变动，外包窗口 |
| finance 融资 | Pre-IPO、挂牌、A/B/C 轮 | 资本动作驱动财税升级 |
| change 变更 | 注册资本变更、股东变更、新设子公司 | 工商动作触发财税审视 |
| risk 风险 | 税务行政处罚、欠税公告、行政处罚 | 已踩坑或即将踩坑，合规救火 |
完整词条 / 权重 / 解读见 src/domain/signal_dictionary.ts。
sales_intent_signals 接受用户喂入的 raw_texts（招聘 JD / 招标公告 / 工商变更 / 新闻 / 风险通告），逐条 substring 匹配，重复 term 跨文本权重递减（100% / 50% / 25%）。
7. 行业历法（finance_tax，按月 hook）
| 月 | 主 hook |
|---|---|
| 1 | 上一年的账还没关好的，这周再不收口，汇算清缴会被动 |
| 2 | 研发归集这个月不动手，加计扣除就跟不上汇算清缴 |
| 3 | 汇算清缴开启 — 7 个高风险点趁早体检 |
| 4 | 汇算清缴高峰 — 没体检完，剩 30 天会很被动 |
| 5 | 汇算清缴截止 5.31 — 不补的所得税，6 月就是滞纳金 |
| 6 | 高新申报截止 — 研发占比、销售占比 6 月不调出不了认定 |
| 7 | 二季度所得税预缴别用上半年口径，年中重新算能省一笔 |
| 8 | 稽查批次正在排，主动自查 vs 被动应付 |
| 9 | 研发加计自查最便宜 — 比汇算清缴时被打回轻松十倍 |
| 10 | 年终奖单独 vs 合并计税，10 月不算清楚 12 月发的时候多缴 |
| 11 | 年度财税体检 11 月做最划算 — 12 月发现问题还来得及调 |
| 12 | 最后两周决定下一年的财税地图 — 现在不规划，1 月手忙脚乱 |
sales_industry_scan 的 top_hooks_now 直接拿来作为 sales_pitch 的 hook 参数。
8. 合规红线
- 客户敏感数据不进 prompt：身份证 / 银行账户 / 密码 / 税号正本不写工具调用 args。绿火只处理"能放 CRM description 的"信息。
- 群发 target 必须用户当前会话明确指定——绿火不输出
@all/*/tag:*一类 broadcast 字面量；调用方传入也由 wecom / huihuoyun-odoo 端 sanitizer 拦截。 - 任何 nextActions 都要用户确认后才让 huihuoyun-odoo 执行，绿火不静默写库。
- 不在话术中承诺具体节税金额 — 用比例（"省 25% 所得税"），不写绝对值（"保证省 100 万"）。
9. 配置项
| key | 说明 | 默认 |
|---|---|---|
industry_domain |
行业领域包，仅 finance_tax |
finance_tax |
services |
服务方向，影响打分权重 | ["代账","审计","税务筹划","财税顾问"] |
region |
默认服务区域 | 青岛 |
tone |
话术语气 | warm |
company_brand |
对外品牌名 | 青岛火一五信息科技有限公司 |
odoo_team_hint |
可选，Odoo 销售团队名 | — |
qichacha_api_key |
v0.2 企查查 Key（申请） | — |
qichacha_secret_key |
v0.2 企查查 Secret | — |
qichacha_base_url |
v0.2 可选，默认 https://api.qichacha.net |
— |
10. 错误处理
| 情况 | 处理 |
|---|---|
| huihuoyun-odoo 未装 / 未连 | 工具仍能返回打分 / 画像 / 话术，但 nextActions 无落地点 — 引导用户先装 / 调 odoo_connect |
| 企查查 API 未配 | sales_company_* 优雅降级，返回引导信息 + 建议走 huo15-searxng 兜底链路；其他 6 个工具不受影响 |
| 企查查 API 调用失败 | 返回 fallback: 'qichacha_api_error' + reason；常见原因：Key 错 / QPS 超 / 套餐余额 / 接口路径变（可在 config 覆盖 paths） |
| lead 字段缺失太多 | sales_lead_score 仍打分但置信度低，hint 提示用户至少补 industry / employees / notes 一项 |
| pitch 占位符没传 | 用合理默认填充（{decision_maker} → "您"，{client_name} → "贵司"），不报错中断 |
11. 路线图
- ✅ v0.2 已完成：企查查工商底座 + 财税意向信号识别 + sales_pitch 信号驱动 + 信号词典 KB
- ⏳ v0.3+ 候选：抽
src/domain/finance_tax/pack；新增 education / healthcare / it_services 领域包；与 huo15-xiaohongshu / huo15-wecom-plugin 联动；信号词典扩展；天眼查 / 启信宝 备选数据源 - ⏸ 暂搁：自建联系人 / 邮件库（绿火不做数据公司）；自动外呼 / AI 通话（合规风险）
绿火不替你拍板，只把"销售 1.5 个月学到的事"塞进每次工具调用。打不打、怎么打、要不要降价 — 你说了算。