TradeMax AI System 使用指南
面向工业 B2B 独立站运营的 AI 协作平台 · 你的角色:{{roleLabel(currentUser?.role||'viewer')}}
{{v.label}}
快速开始 · 这套系统能做什么
三句话定位
被动收线索 :网站表单 / Gmail 收件服务器 / WordPress 询盘 → 自动入库 + AI 启发式打分 + 起草回复 → 自动派给业务员。主动找客户 :上传公司资料 → AI 出 客户画像 → Google Maps 找海外经销商 → 抽取邮箱 / 决策人 → 生成 3 步本地化邮件序列 → admin 审批。把这两条流水线串成团队作战 :Kanban 看板 + 发件服务器 一键回信 + 跟进任务 + 自动分配规则 + 业绩榜 + 老板团队看板 + 周报量化。
第一次进系统 · 5 步
登录 :用户名 admin,密码 = 服务器 ADMIN_API_TOKEN 的值。右上角点 改密 换强密码 ≥ 12 位。
按角色读完自己那份 SOP (下方目录里第一个就是你的)。每天动作 / 必做 / 不做 / 求助路径都列清楚了。配 API 密钥 :看「环境准备 / API 密钥」章 — 至少配 LLM(Claude / OpenAI / DeepSeek 选一) + 发件服务器(Gmail App Password)。客户拓展加 SERPER + JINA。不会用某个模块 → 切到 → AI 对话 直接问;业务员版本仅开放本人邮件与 客户管理 安全操作。
6 种角色 · 一图看懂
按"能不能造成不可逆后果 / 会不会烧钱(API credits + LLM token)"分层。越往下权限越大。
角色 能做什么 典型用户
viewer 看所有只读数据(仪表盘 / 文章 / 产品 / 询盘 / prospect / 邮件序列 / LinkedIn 潜在客户) 老板、合伙人、顾问 sales viewer + 只看自己被分配的询盘 + 改自己询盘 stage / 加 note / 加跟进任务 / 发件服务器 回信;LinkedIn 潜在客户:看 + 记触达 + 转成自己的 lead 。AI 对话 仅开放本人 客户管理 / 邮件安全工具,写操作需在当前会话确认。看不到未分配池、别人 lead 和系统配置 业务员 team_lead sales + 团队看板 / 业绩榜 / 销售负载 + 全部 AI 助手身份。按 team_id 自动过滤 — 只看本队员工 / 本队询盘 / 本队预警。可改本队成员显示名 销售小组主管 operator team_lead + 全量/批量分配询盘 + Hunter/Apollo 建批次·开始获客·解锁邮箱·序列入队发送 + 起草邮件序列 + 邮箱采集 + 数据源健康 + 跨队调度。凡是烧 credits/token 的动作都从这一级起 运营经理 admin operator 全部 + 用户管理 + 销售小组建/删 + 自动分配规则 + LLM 月度预算可见 + 批准邮件序列 + 删批次/数据 + 发布到 WordPress + GA4/Ads OAuth 1-2 个核心人员(客户侧) tech admin 全部 + API 密钥/系统设置 + 模型配置(各 provider key)+ 运维端点 。只能由 tech 创建/管理 tech 账号;引导走 env(TECH_USERNAME/TECH_PASSWORD) 厂商技术人员(TradeMax)
关键约束: 业务员可确认自己当前会话 内的 客户管理 / 邮件安全操作;内容发布、删数据、删获客批次、改权限与密钥仍必须 admin。确认卡 + 后端归属校验是 prompt injection 的第二道防线。
模块 × 角色 权限矩阵
✓=能用 · 看=只读/受限 · —=看不到。空白格默认继承下方更高角色。
模块 / 动作 sales team_lead operator admin
我的询盘 / 看板(改自己 stage、发回信) ✓ ✓(全队) ✓(全量) ✓ 分配 / 批量分配询盘 — 本队 ✓ ✓ LinkedIn 潜在客户 · 看潜在客户表 看 看 ✓ ✓ LinkedIn 潜在客户 · 转成 lead ✓ ✓ ✓ ✓ LinkedIn/Hunter · 建批次 / 开始获客(烧 credits) — — ✓ ✓ LinkedIn · 解锁邮箱/电话(名下潜在客户,每人 20 次/天) ✓ ✓ ✓ ✓ Hunter 序列入队 / 发送 · 邮箱采集配置 — — ✓ ✓ AI 对话 / 客户背调 / persona 本人 客户管理+邮件 ✓ ✓ ✓ 删批次 / 删数据 / 批准序列 / 发布 WP — — — ✓ 用户 / 小组 / 分配规则 / API key / 预算上限 — — — ✓
LinkedIn 获客分工: 运营配 Apollo key → 跑批次拉人 + AI 精筛 → 业务员进「LinkedIn 潜在客户」复核、按优先分打、记触达、把合适的一键转成自己的 lead。credits/token 只由运营控制,业务员烧不了。
日常账号操作
新员工入职 :admin → → 用户管理 加账号,按工作类型选角色,临时密码立即让本人改。业务员选 sales,主管 team_lead,运营 operator,顾问 viewer。员工离职 :「停用」立即吊销所有 session;别直接删 — 已分给他的询盘 owner 关联会丢。先到询盘线索页选他的 chip → 批量改派给别人,再停用。怀疑账号被盗 :admin 点「踢下线」立刻断 session,告诉本人换密码。机器调用 / Webhook :用 Authorization: Bearer $ADMIN_API_TOKEN,等同 admin 但不占用户名额。改自己显示名 (任何角色):右上头像 → NM 修改显示名,走 PATCH /api/me/profile,只能改 display_name。
最近新增 · 你现在可以做什么
这一轮把「AI 对话 → 业务动作 → 人工确认」、LinkedIn 多账号执行器、双通道获客和媒体报道获客接到了同一套权限与审计链路。
新增能力 谁来用 正确用法
AI 对话操作业务 sales 及以上 先说目标和边界;AI 只调用当前角色有权限的工具。写操作出现确认卡,看完参数再点「确认执行」。 业务员 AI 安全区 sales 可查自己的线索、起草回复、预览/发送单封邮件、看/取消本人排期;不能看别人线索,不能改用户、密钥或发布内容。 LinkedIn 多账号执行器 admin 配置 · operator 调度 · sales 跟进 每个账号有独立 token、日限额、心跳和冻结状态。执行器领任务并回传结果;出现 captcha / warning / 异常登出就冻结,不自动重试。 Email + LinkedIn 双通道 operator / admin 进入独立的「Email + LinkedIn 触达」页面配规则并查看漏斗。先小额度跑通 Email,再开 LinkedIn,不同时放量。 媒体报道获客 / Qwoted operator / admin 账号绑定执行器后队列化抓取记者需求,人工复核截止时间与匹配度,再生成媒体回复草稿和可引用资产。系统不会绕过站点登录直接投递。 页面数据缓存与刷新 所有人 进入模块会自动加载,返回时先显示最近成功数据并后台刷新。需要立刻拉最新时点右上「刷新」,不用先切换到其他模块。
确认卡怎么判断
先看动作名 :是起草、改状态、取消排期,还是真实发送。
再看对象与参数 :线索、收件人、主题、金额/额度是否正确。不对就点「取消」并重新说清。
业务员只能确认自己会话里的 客户管理 / 邮件动作;确认过的邮件草稿也只能发一次,重复点击不会重发。
LinkedIn 现状: 当前真实 connect / message 主要由外部执行器完成;官方 OAuth/API 需应用审批与对应产品权限,不等于授权后就能自动邀请或私信。
业务员操作指南
你是公司最前线 — 把询盘变订单。天职:接得快、回得准、跟得紧、关得稳 。
登录第一眼看到的
左侧显示:我的询盘 / 询盘列表 / 我的任务 / AI 对话 / LinkedIn 潜在客户 / 操作指南。首屏自动停在 → 我的询盘 。看不到未分配池、别人 lead 和会烧钱的系统模块 —— 这是权限设计,不是数据丢了。
AI 对话 · 用一句话处理自己的客户
进入 → AI 对话 ,可以直接说「列出我今天必须回复的询盘」、「为 Active PLV 只生成一封英文草稿,不要发送」。
直接执行的只读动作 :列自己线索、看询盘详情、看邮件排期、预览草稿。需确认的动作 :AI 分析询盘、生成回复草稿、改状态、取消排期、发送单封邮件。确认卡出现后先看参数,再点「确认执行」。权限边界 :只能操作自己的 lead 和自己会话的确认卡。就算知道别人的 lead ID 或 action ID,后端也会拒绝。说清边界 :用「只」、「不要」、「停在确认」说清范围。看到 AI 多排了不需要的卡,直接取消。
早上 8 分钟 · 看板巡检
点 → 客户看板 看自己名下 6 列卡片(new → contacted → qualified → quoted → negotiating → won/lost)。
重点看 new 列 (夜里分配进来的) + 标红卡片 (逾期跟进)。
点开任意卡片 → 抽屉打开。
主战场 · 每条询盘 10-15 分钟
顺序 在哪 做什么
① 读原文 「客户原文」灰色卡片 确认对方想要什么 ② 看背调 「AI 客户背调」紫边卡片 国家/规模/决策人/买信号 —— 你自己点「AI 背调」就能跑 (见下方专节) ③ 推阶段 顶部「销售阶段」按钮条 点 contacted / qualified / quoted 改状态 ④ 发邮件 「邮件回复」蓝边卡片右上 有草稿点 回信 (打开窗口可改后再发,非直发),没草稿点 撰写邮件 ⑤ 写正文 弹出的发送窗口 To/CC/BCC/主题/正文都能改,确认「发送后改为已触达」勾上 ⑥ 点发送 底部蓝色按钮 发件服务器 真实发出,有 5 秒「撤销」窗口 ;可带附件(datasheet/报价) ⑦ 设跟进 抽屉下半「跟进任务」 加「3 天后 follow up 看 datasheet 反馈」
客户回信会自动归到同一条询盘下,在抽屉「📨 邮件往来」Tab 成串显示(已去 emoji,实际是纯文字标签),直接在里面回复即可。
AI 客户背调 · 你自己就能跑(不用等运营)
回信前先摸底:这家值不值得你花半天认真报价。两个入口一键出卡:
入口 A · 询盘抽屉 :打开任意 lead → 顶部紫色卡片「AI 背调」按钮,自动用公司 / 网址去查。入口 B · LinkedIn 潜在客户 :潜在客户列表每行有「背调」小按钮,冷开发前先查一下。
系统按线索价值自动分档(你不用选) ,把力气花在刀刃上:
档位 什么线索走这档 查多深
快筛 C 级 / 明显垃圾 2 个工具,只做真假 + 规模的快速排雷 标准 B 级常规询盘 3 个工具:官网 + 域名年龄 + 一次搜索 深挖 A 级 / 高匹配大单 4 个工具 + 海关提单证据
跑的时候弹窗会显示「已用 N 秒 + 当前在查什么」,慢的目标站要 30-90 秒,别以为卡死。每人每天有背调次数上限 ,别乱花。
看懂卡上的记号 :✓ 已查证 = 工具原文直接看到的硬事实,可信;◌ 推断 = AI 猜的,要二次核实 ,别当凭据报价。
海关数据的诚实边界(重要) 只覆盖美国买家、只覆盖海运 。欧盟 / 英国 / 中东 / 多数东南亚买家查不到。而且 「查不到」≠「没进口 / 不合格」 (试单常走空运快递,不进提单)。海关只用来加分 (查到 = 强证据),绝不能因为查不到就放弃一个真实询盘 。
LinkedIn 潜在客户 · 主动找客户
运营会用 Apollo 按 客户画像 拉一批 LinkedIn 联系人并 AI 精筛好。你在 → LinkedIn 潜在客户 里:
选一个运营跑好的批次 → 潜在客户按优先分 (合适度 × 购买信号)排序,先打分高、有「▲ 触发信号」(融资/在招/意向)的。
红标「已成交/客户公司/已在库」的别碰 —— 已经是客户或库里已有,冷开发会掉价/撞单。
有「✎ 开场白」的可一键复制,直接用于 LinkedIn 私信或邮件。
用「触达」下拉记状态(已联系 / 已回复 / 不合适)。
合适的点 转询盘 → 进你自己的询盘池,之后走上面那套流程。
你不能建批次/开始获客(归运营);但名下潜在客户的邮箱/电话可以自己解锁 。
自助解锁邮箱 / 电话(每人每天 20 次配额)
「我的 LinkedIn 潜在客户」每行有 🔓 邮箱 / ✆ 电话 按钮;表头还有批量解锁 (一键把队列里没解锁的都解了)。
电话解锁只对 匹配度 ≥ 65 的潜在客户开放,且是异步的——点完显示「解锁中…」,几分钟后自动回填。
已转询盘 的询盘缺邮箱/电话?打开 lead 抽屉,联系方式旁直接有解锁按钮 ,解锁后自动补进 lead。
配额纪律:每天 20 次(邮箱+电话共用),匹配度≥80 或有购买信号的才值得烧 — 解了不触达等于白烧,主管看得到转化率。
强烈推荐:配自己的 Gmail 发件邮箱 邮件设置 → 填 Gmail 用户名 + App Password → 点「测试 + 保存」。配好之后:所有邮件从你账号 xxx@gmail.com 发出,客户回信回你,主管看 leaderboard 能算到你头上。
必须做的事
每天结束前清掉 new 列 — 改状态到 contacted/quoted,不要让卡片停留。看到「已改」黄字 — 提示你 To 改过,跟原始邮箱不一样,别发错。配自己的 发件服务器 — 没配按钮会变灰显示「发件服务器 未配置」。改 won 必须留证据 — 主管会调 timeline 看 outbound_emails。
不要做的事
不要直接发 AI 草稿 — 永远人工读一遍(可能含错的产品规格 / 错的报价)。不要删 spam 询盘 — 改状态为 spam,主管批量清。不要替别人发邮件 — 用自己 发件服务器,归属链才对。
求助路径
没 AI 草稿 → 找运营 跑「批量启发式 + LLM」。
客户信息填错 → 找主管 改。
看不到「撰写邮件」按钮 → 99% 发件服务器 没配,自己去头像菜单配;配了还不行找管理员 。
运营操作指南
销售引擎的工程师 — 给业务员造合格的子弹(线索 + AI 草稿 + 背调 + 内容)。关键指标:线索质量 × 业务员工时占比 。
角色定位 · 你负责校准、调度、放大
系统已经把「找客户 → 打分 → 起草 → 背调 → 内容 → 流量」做成流水线。运营不是亲自做完每件事,而是让系统持续产出,再把合格结果派给业务员。
系统产出 运营把关 交给谁
Hunter / LinkedIn 合格线索 画像、评分、去重与审批 业务员跟进 AI 回复草稿 / 客户背调 事实、语气与风险标记 业务员修改后发送 文章、流量与竞品机会 选题、真实性与优先级 运营执行或转任务 日报 / 周报 / 决策建议 异常口径与行动项 主管 / 老板
杠杆原则: 同样一小时,优先花在校准 ICP / persona、清审批队列、调整筛选和配置自动化上。一次校准会改善后续整条流水线。
登录第一眼看到的
运营权限按管理员在权限中心的配置显示 ,左侧只出现当前账号已开放的业务模块。首屏停在 → 工作台 ;某个入口看不到时先确认是否被关闭,不要把它当成数据丢失。
早上 8:30-9:30 · 收尾昨夜
→ 工作台 — 看 6 张 关键指标 卡 + Hunter 抓取轮次 + 待审批序列徽章数字。→ 主动获客 — 审批夜里的 prospect:质量分 ≥ 70 批准;审批后点「加入队列」→ 序列按 day0/3/7 定时发(自动发送默认关,可手动「立即发送到期」)。客户一回信自动停发后续。→ LinkedIn 潜在客户 — 配好 Apollo key 后:AI 生成筛选(或手动填)→ 确认 → 开始获客,进度条跑完出潜在客户。全局去重(跨批次永不重复)。合格的分配给业务员,他们复核转询盘。建批次/开始获客归运营;解锁邮箱/电话业务员也能自助(每人 20 次/天配额,运营不占配额)。 → 询盘 → 「工作台/数据」切换:工作台看列表,数据看漏斗/赢率/批量管道。给夜里新进 lead 跑「批量启发式 + LLM」分级 + 起草;「待确认」chip 里是低置信 lead,人工复核。(admin) 设置页顶部「数据源健康」一眼看哪些接了/暗了(GA4/GSC/Serper/Jina/Apollo/发件服务器…);Apollo 未接就先去配 key。
新增获客工作台 · LinkedIn / Email / 媒体报道
LinkedIn 账号池 :运营负责看账号是否 online、今日 connect 余额和冻结原因;不要把一个 executor token 复制给多个账号共用。双通道编排 :进入 → Email + LinkedIn 触达 ,明确哪类 prospect 先 Email、哪类再 connect。跑完到「通道漏斗」看到达、接受、回复和转询盘。媒体报道获客 :进 → 媒体报道获客 导入或由 Qwoted 执行器拉取记者需求;先复核截止时间、媒体和专家匹配,再生成媒体回复草稿与数据资产。AI 统一操作 :在 AI 对话可查获客概览、批次状态、账号健康,也可创建 Hunter/Apollo/Qwoted 任务;写操作仍以确认卡为准。
中午前 · 任务调度
→ 任务队列 — AI 自动生成的「机会任务」,自己执行或派给业务员。→ 自动分配规则 — 检查规则命中数,疲软的调整。
内容生产管线 · 从机会词到发布
选题 → 大纲 → 正文 → SEO → 发布与 Schema 是一条连续流程。AI 做重活,运营负责搜索需求、真实规格和最终质量。
选题 :从 GSC「有曝光、低点击」的机会词或真实客户问题开始,不要凭感觉写。生成大纲 :在 → AI 写文章 检查搜索意图、SERP 结构、FAQ 和内链方向,方向不对先改大纲。生成正文 :让 AI 基于产品资料和大纲成文;型号、规格、认证、价格、交期必须回查知识库或原始资料。SEO 打磨 :完善标题、描述、关键词、内链与询盘 CTA,避免只堆关键词却不回答买家问题。发布与 Schema :人工读完后再发布;发布后用 → Schema 注入 补 Article / FAQPage 等结构化数据,再用 AEO / SERP 验证效果。
内容红线: AI 可能编造规格、认证和案例。所有正文与封面都要人工检查,不能把「已生成」当成「可发布」。
下午 · 内容生产 + 流量
Tab 做什么
→ SEO 体检 跑体检 → 看 GSC/GA4 下滑信号 → 一键转任务 → AEO 引擎 看 ChatGPT/Claude/Perplexity 引用率,加新 query 监控对手 → Schema 注入 给批量文章注入 Article schema,Google 抓取更准 → 内容腐烂 跑腐烂扫描 → 一键转「refresh 这篇」任务 → SERP 排名 跌出 top10 的关键词提醒主管 → AI 周报 周五下午跑一次,转给主管 / 老板
AI 工具箱 · 6 个专家身份
AI 对话不是闲聊窗口。先选与任务匹配的专家身份,再写清目标、对象、证据范围和「不要做什么」;写操作出现确认卡时逐项核对参数。
专家身份 什么时候用 交付前检查
客户背调 回信或冷开发前核验公司、决策人和购买信号 区分「已查证」与「推断」,查不到不等于没有 投流策略 规划 Google Ads 结构、预算与出价边界 预算、地区和转化追踪是否真实可用 RSA 起草 生成响应式搜索广告标题与描述 字数、落地页、禁用承诺与品牌语气 审计巡查 查找 Ads 浪费词、异常花费与转化缺口 日期口径、样本量和真实转化事件 内容转化 把技术资料改写成买家能理解、愿意询盘的内容 型号、规格、认证和 CTA AEO 架构 规划 llms.txt、FAQ、引用来源与 AI 可见度 可验证引用、Schema 和页面是否真实上线
账号没有对应模块权限时,相关专家身份和工具会自动隐藏;即使前端入口存在,后端也会再次校验权限。
自动化提效 · 把重复工作交给系统
定时任务 让 Hunter 模板获客、AEO 巡检、日报/周报按计划运行。动作类任务遵守权限;AI 写操作仍进入确认队列。
机会任务 + 自动分配 让规则按国家、产品和轮询派单;运营只处理未命中和负载不均的例外。
知识库 RAG 持续补产品手册、案例和政策资料。资料越完整,背调、回复和文章越少编造。
决策台 + 增长雷达 把 GA4、询盘、内容和外部信号汇成行动项,决定今天最值得先做什么。
每周自检: 「这周还有哪件重复活在手动做?」能配置成定时任务、分配规则或批量操作的,就不要继续靠人记。
周维度
→ 竞品监控 + → 反向链接 — 看对手新发的内容 + 外链 gap。→ 知识库 — 上传新的产品手册 / 案例 PDF,RAG 索引让 AI 对话调用。
必须做的事
每天审批 Hunter 序列 — 不要让 needs_review 超过 50 条,触达节奏会断。抽查 AI 背调质量 — 每天 2 条手动看输出对不对,差的反馈给管理员调 persona。清「机会任务」 — 清不完的改到期日或转业务员。先启发式再 LLM — 日常先用免费规则分级,只把低置信、高价值询盘升级给 LLM。把重复活自动化 — 用定时任务、批量操作和分配规则减少漏项。
不要做的事
没确认就跑全量 LLM 分级 — 烧 token,先看管理员的预算。改用户 / 团队 / 发件服务器 / 模型 — 那是管理员。删 lead 不留 spam 标记 — 业务员要看历史是不是同个客户重发。直接发送 AI 内容或邮件 — 规格、报价和承诺可能错,永远人工读一遍。
求助路径
AI 草稿质量差 → 管理员 调模型 / persona / prompt。
Hunter 不跑 → 管理员 查 API key / 配额。
数据源(GSC/GA4/SEMRush)失效 → 管理员 重连 OAuth。
模块入口突然消失 / 操作提示无权限 → 管理员 在权限中心核对角色与个人开关。
线索派给谁、团队负载或业绩口径不清 → 找主管 确认,不要自行改规则口径。
主管操作指南
管 3-8 个业务员,让他们不漏单、回得快、闭得稳 。关键指标:团队 首次回复、转化率、月收单数 。
登录第一眼看到的
推荐首屏设为 → 团队看板 — 你团队的 响应达标 仪表盘。
早上 9:00 站会前 · 看 4 个数
→ 团队看板 (7 天窗口):
首次回复 中位数/九成分位 (首次响应时间)— 红色就找业务员问响应达标率 (24h 回复占比)— 低于 80% 站会点名在手询盘数 / 已成交 / ACV — 看分配是否均衡
下方成员对比表 — 点列头排序,谁慢谁多一目了然。
打开 Leaderboard (同页面按钮)— 看本月排名,鼓后进追先进。
上午 · 分配 + 跟单
→ 询盘 (team_lead 视图能看全团队):顶部勾选要分配的多条 → 选「批量分配给业务员 X 」一键派单。看 sales workload 列表,给负载轻的多分。→ 客户看板 切「按 owner 看」,挨个业务员检查:有没有卡在 contacted 超 5 天没动的(系统染红);有没有 quoted 一周没回访。
中午 · 跟进辅导
打开业务员的抽屉看 timeline:
AI 草稿被改了多少 / 直接发的(0 改 = 没动脑 )
邮件来回轮次(超 5 轮还没下单要催收尾)
「跟进任务」是否填(没填的提醒补)
下午
→ AI 对话 切到「客户背调」persona,问「分析 X 这家公司的决策人 + 议价空间」,结果发给业务员当弹药。改团队成员显示名 — 头像菜单 → 团队设置,改自己团队成员的展示名。
→ 任务队列 — 看自己被指派的任务(运营推上来、业务员推上来)。
新增 · 管好业务员的 AI 与 LinkedIn 队列
AI 权限闭环 :业务员只能用自己 客户管理 / 邮件工具,确认卡也只能确认自己的会话。出现「权限不足」先让他开新对话,不要升 admin。看成员容量 :在 LinkedIn 获客看成员容量/负载,优先把高 fit、有购买信号的潜在客户分给当前在手较少的业务员。看闭环而非动作数 :每周抽查「潜在客户 → 转询盘 → 首次回复 → 跟进任务」,别只看解锁数和 connect 数。
周维度
周五下午 — 看运营生成的 → AI 周报 ,标「本周亮点 + 卡点」转给老板。复盘趋势 — boss 视图切 30 天,首次回复 / 转化率拐头跟运营开短会。
必须做的事
每天清 响应达标 报警 — boss 视图最上方有 响应达标 超时列表,挨个分给值班业务员。指导业务员配自己 发件服务器 — 每个都该用自己 Gmail,你帮他配「邮件设置」。月底末位 1on1 — 不是开除,是看 timeline 找问题(回复慢?草稿不改?跟进断?)。
不要做的事
改用户角色 / 加用户 — 找管理员。看全公司看板 — 你只看自己团队(operator+ 才能切全公司)。替业务员发邮件 — 你的工作是辅导,不是顶替。
求助路径
负载严重不均 → 让运营 改自动分配规则。
全团队都说 AI 草稿不好用 → 运营 / 管理员 调模型。
客户投诉某业务员 → 调 timeline + outbound_emails 看记录。
只读观察员操作指南
你的角色是看数据、发现异常、提出建议。viewer 只能读取管理员开放的模块,不能发送邮件、改客户状态、分配任务或修改系统设置。
登录第一眼看到的
左侧只显示当前账号已获授权且允许只读访问的模块。入口比同事少是正常的权限边界;需要新增观察范围时找管理员开权限,不要借用高权限账号。
每天 10-15 分钟
先看总览 :关注本周询盘、24 小时未回复、流量与待办是否异常。再看趋势 :对比 7 天 / 30 天数据,记录变化方向,不要只根据单日波动下结论。最后提建议 :把「看到的事实、可能原因、建议负责人」写清楚后交给主管或运营执行。
你可以做什么
可以 正确方式
查看获授权的数据与报表 按时间、来源和负责人核对口径 阅读询盘和业务进度 只做观察,不替业务员改阶段或发邮件 发现异常并反馈 记录页面、时间范围、指标和截图位置 提出策略建议 交由主管、运营或管理员确认并执行
不要做的事
不要借用 admin / operator 账号 — 会破坏审计归属和权限边界。不要把只读数据外发 — 询盘、客户邮箱和业绩数据都属于内部信息。不要把短期波动直接当结论 — 至少对比 7 天 / 30 天并核对数据源状态。
求助路径
看不到需要的模块 → 找管理员 核对 viewer 的角色和个人权限。
指标口径不清 → 找主管 / 运营 确认。
数据长时间不更新 → 把模块、时间和异常现象发给管理员 / 技术 。
管理员操作指南
你拥有系统全部钥匙。责任:让系统活着、让数据干净、让员工有权限边界 。
登录第一眼看到的
26 个 tab 全可见。推荐首屏设为 → 工作台 或 → Token 监控 。
健康巡检(早 10 分钟)
→ Token 监控 — 昨日 LLM 花费 + 谁烧的。异常 spike 立刻找当事人;接近月度预算 80% 提醒主管收敛。→ 运行复盘 — 夜跑的 Hunter / 周报 / SEO 体检 / decay scan 是否成功,失败看 step 详情。浏览器开 http://127.0.0.1:8010/api/health/db 看 SQLite WAL + FTS + 冷库迁移正常。
用户与权限
→ 用户管理 :入职 — 加用户 → 选角色 → 设初始密码 → 分团队;离职 — 降为 viewer 或停用(不要直接删,保留历史 owner 关联 )。团队管理(同页) — 改团队名 / 挪人 / 解散空团队。
系统配置
Tab 做什么 注意
→ 模型配置 接新模型(Claude / DeepSeek / Qwen),测试连通后设默认 改默认模型前发公告 → API 密钥 Hunter / SEMRush / GSC / GA4 / Google Ads / 发件服务器 过期前 7 天预警;绝不 复制给业务员 → 邮箱采集 收件服务器 拉公邮询盘 → 自动建 lead 失败到 runs 看错误(常见:App Password 过期)
新增执行器与外部账号配置
对象 在哪设置 上线验收
LinkedIn 多账号 LinkedIn 获客 → 账号池 → 新建账号 / 限额 / 执行器配置 每号单独 token;「测试配置」通过;心跳时间持续更新;告警时会冻结 Qwoted 媒体报道获客 → Qwoted 账号 → 生成/轮换 token 执行器已登录 Qwoted;队列任务能变为 running / completed;机会不重复入库 Apollo / 联系方式 provider 第三方连接 + LinkedIn 获客的 provider 选择 先查 provider status;解锁前确认日限额;没配或多个 provider 含糊时系统应拒绝,不猜测扣费
出问题时
→ 运行复盘 — Agent 流程失败时第一站,看哪一步炸 + error 原因。冷库迁移 — Chat 历史超 60 天 → 自动迁到 wp_agent.cold.db,可一键 restore。冷库占盘大,定期清。
周维度
Token 月账 — Token 监控看月度曲线,跟老板汇报「这周烧多少 + 上周对比」。审计抽查 — runs 看哪个用户做了批量删除 / 改 owner 等敏感操作。secrets 轮换 — Gmail App Password 每 90 天换。
必须做的事
机密备份 — secrets 目录 + .env + wp_agent.db + wp_agent.cold.db 每周本地备份。不直接改 DB — 用 UI,不要 docker exec 进容器 sqlite3 直接 SQL(出过事)。改全局 发件服务器 前发公告 — 业务员可能正在发邮件,中断会丢。
不要做的事
不要把自己降级测试 — 没人能升回来,只能进 docker 改 DB。不要 --no-verify 推任何东西 — 系统就你一个 admin,出事没救火队。不要把 admin 给业务员/主管 — 他们能改全局 发件服务器 把全公司邮件搞炸。
求助路径
DB 损坏 → 停容器 → 备份 zip 还原 → runs 反查根因。
Hunter 报 429 → 改全局节流 secrets,临时调小。
老板要新数据 → 周报 / Token 截图发,别给老板开 admin 账号 。
技术运维操作指南
你的职责是系统可靠性、安全和可恢复性。业务流程由对应角色负责;技术账号只用于配置、诊断、发布和应急处置。
每天的健康巡检
先看 /api/health、容器健康状态和最近一次部署结果。
检查运行复盘、定时任务失败、数据源暗灯、磁盘和数据库备份年龄。
关注 LLM / Apollo / 邮件异常用量;发现突增先限流,再查账号和审计记录。
配置与发布纪律
动作 操作要求
密钥 / OAuth 只在设置或服务器 secrets 中维护,不发到聊天、截图或 Git 模型与预算 先测试连通和成本,再切默认;变更前通知管理员 权限问题 先核对角色、个人覆盖和审计记录,不要直接改数据库 生产发布 预检变更面、健康门部署、验证线上标记,保留自动回滚能力 故障恢复 先保全日志和数据库快照,确认根因后再修复
必须做的事
每周验证数据库、secrets 和配置备份确实可恢复。
所有敏感操作保留审计链;账号停用、权限变更和密钥轮换可追溯。
部署只同步本次授权的变更,避免覆盖服务器或其他人的未提交工作。
不要做的事
不要用 tech 账号代替运营、主管或业务员完成日常业务。
不要绕过健康门直接重启、覆盖数据库或删除生产数据。
不要把密钥、客户 PII 或生产日志提交到仓库或发到外部渠道。
故障升级顺序
确认影响范围 → 保存证据与快照 → 降级 / 限流 / 回滚 → 恢复服务 → 查根因 → 补监控和测试。涉及客户数据、邮件误发或账号风控时立即通知管理员。
运营 0→1 上手 SOP(新人专用)
这一章写给完全没接触过这套系统的人。站点处于早期、还没固定运营节奏 ,看完你应该知道:每天该坐下来做什么、看什么数据、什么状态算正常、出问题找谁。
读法建议 :从上往下,逐节做。每节里有「动作 」和「验收 」 — 做完动作后,看到验收里描述的现象就算过关。不要跳节。
第 0 步 · 这套系统能帮我做什么
本质是一个独立站的运营驾驶舱,把"流量→询盘→订单"全链路串在一个后台:
环节 系统里对应的模块 你每天会做的事
流量来源 网站数据看板(GA4) · SERP 排名 · AEO 引擎 看昨日访客、看哪个关键词进来的 访客转线索 询盘线索 · 客户看板 每来一封询盘 AI 自动评分 + 起草回复 线索成单 客户看板(Kanban) · 发件服务器 回信 拖卡片 / 写回复 / 加跟进任务 主动获客 客户拓展(Hunter) 上传公司资料 → AI 找海外经销商 团队管理 团队看板(老板视角) · 销售业绩榜 看谁手里有多少单、谁停滞、谁第一时间响应 内容生产 文章管理 · SEO 体检 · 内容腐烂检测 关键词 → 大纲 → 全文 → 发到 WordPress 对外沟通 AI 对话(身份切换) 用专家身份让 AI 出方案(投流 / RSA / 审计)
站点处于早期 = 询盘量少、内容稀疏、还没建立稳定的进客户节奏 。所以你的第一个月主要不是处理"业务洪流",而是搭起这几条流水线让它能跑起来。
第 1 步 · 第一天(开账号 + 巡一遍)
耗时:30 分钟。目标:把账号开通,记得每个页面长什么样。
动作 :让 admin 在 → 用户管理 给你建账号。角色按工作类型选(跑业务的 sales / 做调度的 operator )。验收 :你能用新账号 + 一次性密码登录;顶部右上角看到你的名字。动作 :登录后立即点右上角 → 改密码 。换一个长 ≥ 12 位的密码。验收 :退出再登录,新密码可用。动作 :左侧菜单从上到下点一遍。在每个页面停 2 分钟,只看不动。需要重点认识的:→ 工作台 总览,有几个 关键指标 卡片→ 客户看板 6 列 Kanban,你每天主战场→ 询盘线索 列表视图,带筛选/搜索→ 团队看板 老板视角,看团队进度(operator+ 才有)→ AI 对话 中间是 AI 聊天框,顶部有 5 个身份按钮→ 使用指南 这本指南本身验收 :闭着眼能说出"客户看板"和"团队看板"区别(前者操作线索,后者监控团队)。动作 :在 → 询盘线索 顶部点 + 录入,手动建一条测试询盘 。姓名填"测试客户",公司填"Test Co",国家填"US",留言写"Need 100 industrial tablets"。点保存。验收 :列表顶部出现你新建的一条,状态是 new。这条数据后面练手用,练完手动删掉。动作 :点开这条测试询盘的右侧抽屉,看到上面有 AI 评分块(可能要等 5-10 秒),底部有"加 note / 加跟进任务"区。试着加一条 note "first contact" 和一个明天到期的任务。验收 :抽屉左侧时间线出现这两条活动记录。动作 :把这条卡片从 new 拖到 contacted (在 → 客户看板 里)。再从 contacted 拖到 won,会弹出输入框让你填成交金额,随便填 5000。验收 :卡片落在 won 列;数字 5000 USD 写到了卡片上;团队看板里"成交金额"会包含这笔。动作 :回来删掉这条测试询盘(询盘线索页 → 点这条 → 抽屉里删除)。验收 :列表里没了。第一天结束。
第 2 步 · 第一周(每天的固定动作 SOP)
每天总耗时约 45-60 分钟 ,拆成早班 / 全天响应 / 收工三段。早期没人盯的时候你就是唯一的人,所以严格按节奏走 — 形成肌肉记忆后能扩展给更多人。
早班(到岗后 15 分钟内)
→ 工作台 — 扫一眼"昨日访客 / 询盘 / 成交"。问自己 :跟前天比,数据是涨还是跌?如果跌超过 30%,记下来,回头找原因。→ 客户看板 顶部"停滞 "红字数 — 这是你今天必须处理的优先级。点红色 badge 直接筛出停滞卡片(7 天没和客户接触)。看是否有 响应达标 告警 (卡片右下角红 / 黄标记):红 = 7 天没碰,黄 = 3-7 天。优先级:红 > 黄 > 灰。
→ 询盘线索 顶部 24h 需回复 chip — 这是 24 小时内来的未回复询盘。响应达标 是 4 小时内首次回复 ,过 4 小时已经在丢单率上掉一个台阶。
收到新询盘 — 标准处理流程
分钟 动作
0-2 分钟 看 AI 评分(0-100),看 AI 标的 red_flags 和 keywords 2-5 分钟 评分 ≥ 60 → 进入核心流程;评分 < 40 → 标 spam 或丢 lost;40-60 → 看公司域名是否是企业邮箱,真实公司就升级处理 5-10 分钟 点 "AI 草稿"块 — 系统已经按询盘内容起草好英文回复了。读一遍,改两三处个性化的细节(比如对方公司名 / 提到的具体产品型号 / 报价区间)。 10-15 分钟 点"发送 "(需要先配好 发件服务器)。系统会自动:① 发件服务器 真实发出 ② 写一条 email_out 到 timeline ③ 把状态改为 replied。 15-20 分钟 加一条跟进任务 (due_at 设 +3 天)。任务内容写"还没回复就再 follow up 一次"。 20-25 分钟 把卡片从 new 拖到 contacted。
全天响应(收到通知就处理)
客户回信 → 收件服务器 自动入库(配好后)→ 你在 → 客户看板 抽屉里能看到。原则 :对方一回,你 1 小时内必回。响应越快胜率越高。
客户报价、谈合同 → 拖卡片到 quoted 或 negotiating。每次重要互动加一条 note。
成交 / 流失 → 拖到 won / lost。won 一定要填金额(用于后续业绩榜和老板看板)。
收工(下班前 5 分钟)
看 → 客户看板 自己今天新增/移动了多少卡 。早期目标:每天至少处理 3 条(响应、跟进、状态变更都算)。
看明天到期的跟进任务 — 抽屉里"跟进任务"块。心里有数明天先打谁。
如果有运营经理/老板,在 → AI 对话 让 AI 帮你写一条简短日报:"今天处理 X 条 · 新增 Y 条 · won Z 条"。
第 3 步 · 第一周(每周做一次的动作)
什么时候 做什么 怎么做
周一早 规划本周重点 → 团队看板 切到 7 天 — 看上周的成交、转化、首次回复时间。差的指标是本周改进点。周三午 中段健康检查 看"报价转成交率 ":quoted/negotiating 列的卡片有多少滞留 > 7 天?滞留多 = 报价后没在 follow,需要找出来逐个 push。 周五午 清理无效线索 + 生成周报 列表视图筛 status=new 但 created > 14 天的 → 全部标 spam 或 lost(早期不要养无效池)。然后 → AI 周报 一键生成。 周五晚 给老板汇报 → 业绩榜 切到 7 天 — 复制截图;然后从 AI 周报里抠出 3 句话发钉钉/微信。
第 4 步 · 第一个月(让流水线跑起来)
前 30 天的目标:从"被动等询盘"过渡到"主动找客户 + 内容引流"。下面按周展开。
周 主任务 预期产出
W1 每天按 SOP 处理已有询盘SERPER_API_KEY + JINA_API_KEY+ 发件服务器 配齐 询盘 4 小时内首次回复率 100% W2 → 客户拓展 跑一轮 Hunter:上传公司资料 → AI 出 客户画像 → 启动自动运行(单轮 5-10 分钟,出 80-120 个 prospect)→ AI 对话 的"投流总监"身份模拟 Google Ads 预算分配Hunter 池里有 80+ 真实公司 W3 → 文章管理 让 AI 写 3 篇产品场景长文(关键词→大纲→全文)→ 发到 WordPress→ SERP 排名 加 10-20 个目标关键词监控WordPress 上多 3 篇 1500+ 字英文文章 W4 → SEO 体检 跑全站→ 内容腐烂 看哪些老文章流量在掉→ AEO 引擎 给主页和 3 篇主推产品页评 AI 友好度得到一份 30+ 条改造清单
第 5 步 · 关键指标 + 健康线(看到这些数字心里要有数)
指标 在哪里看 健康(早期) 警戒线
首次回复时间(4h 响应达标) 团队看板 < 4 小时 > 8 小时 → 必须自查 询盘 7 天回复率 团队看板 > 80% < 60% → 看是否漏了通知 停滞卡片占比 客户看板顶部红 chip < 15% > 30% → 系统化清理 报价→成交转化率 团队看板 15-25%(B2B 工业品) < 10% → 报价话术或定价有问题 本月新询盘量 工作台 / 询盘漏斗 稳步月环比 +10% 连续 2 月下降 → 流量入口出问题 WP 新发文章 团队看板"产品供给侧" 每周 ≥ 2 篇 = 0 → 内容引擎停了 AI Token 月成本 右上角"用量" < $50 / 月 > $200 / 月 → 看是不是自动任务跑飞了
注 :站点处于早期阶段,绝对值不重要,趋势 才重要。每周拍一次截图存档,3 个月后回头看哪些在涨。
第 6 步 · 常见场景手册(对照执行)
A. 客户 3 天没回信怎么办?
看抽屉时间线:对方最后一次互动是几号、说了什么?
用 → AI 对话 ,身份选"通用",粘贴上下文,让 AI 写一封 followup。语气要"轻提醒、不催"。
发出去,加一条新的跟进任务(due +3 天)。状态保持不变。
第二次仍不回 → 这次的 followup 加点价值(比如发个 spec PDF、视频链接、案例研究)。第三次仍不回 → 拖到 lost,加 note 写"客户三次未响应,搁置"。诚实关单比假装在跟更专业。
B. 询盘是垃圾消息(链接交换 / 网站建设推销)怎么办?
展开询盘看"启发式信号"块 — 系统自动标出是哪个垃圾词触发的。
右上角点"标 spam "。这条不会再占看板和列表的空间。
如果一周内同来源连续多条 spam → 用 spam 聚类发现工具批量处理。
C. 老板临时要看数据怎么办?
"这周成单几个" → → 业绩榜 切 7 天 → 截图。"团队哪个业务员最忙" → → 团队看板 下半部的对比表 → 看"开放线索"列。"上个月转化率多少" → 团队看板切 30 天 → 看"成交转化率"卡。"客户都来自哪些国家" → → 询盘线索 滚动到底部的"国家分布"。"产能跟得上吗" → 团队看板"产品供给侧"看 WP 总产品 / 本期新发数。
D. 怎么提升首次回复时间(4 小时内回所有询盘)?
配 发件服务器 — 这是前提,否则你要切到 Gmail 多走一步。
装 PWA(手机 Safari/Chrome 加到主屏)— 这样在外面也能 1 分钟回复。
跟踪 24h 需回复 chip,定 ±30 分钟提醒。
训练自己用"AI 草稿 → 改 2 处 → 发"的快速流程,目标 5 分钟一封。
长期:在 .env 里把 收件服务器 配好,客户回信也能进 timeline。
E. 我没流量、没询盘,空着是不是不用上系统?
恰恰相反 — 早期没流量,是建立 SOP 和数据基线的最佳窗口 。前 30 天的重点不是处理询盘量,是:① 把工具链跑通(发件服务器 / 收件服务器 / Hunter / SERP)② 用 AI 对话快速产出 3-5 篇文章 ③ 跑一次 Hunter 主动找 100 个海外经销商。等流量起来了再补这些,代价 10 倍。
F. AI 起草的回复不好怎么办?
不好的回复直接改 — 改完发出去就行,不要纠结。
如果某种询盘类型(比如经销商合作)AI 总是不到位 → 在 → 知识库 上传一份"经销商合作话术 SOP",AI 后续会引用。
跨语言询盘(法语 / 德语 / 日语) → 抽屉里点"AI 草稿"重新生成时会用询盘语言。
G. 系统报错了 / 页面打不开?
先 Cmd+Shift+R 强刷一次。多数白屏是浏览器缓存了旧 JS。
右上角"用量"看 token 是否撞限额(超 200k 当月会被限流)。
"AI 对话"里发不出消息 → admin 去模型配置看连接状态。
客户看板 / 列表空了 → 先看顶部筛选条件是不是把范围卡死了。
都不是 → 报给技术,带 ① 浏览器 console 截图 ② 哪个页面 ③ 哪一步触发。
第 7 步 · 7 个不要做的事(避雷)
不要 把同一封询盘放着不动超过 24 小时 — 系统会进 响应达标 告警,老板看得到。不要 看到评分低就直接删 — 标 spam,或者拖到 lost,留个痕迹。不要 用 admin 账号日常工作 — admin 操作不可逆。专门给一个运营账号 operator 权限就够。不要 在客户面前直接复制 AI 草稿不改 — 起码改两处细节,人味儿是关键。不要 同一时段开两个浏览器分别操作客户看板 — 拖动可能错位。不要 跳过"加 note" — 三个月后你不记得为什么这个客户当时拖到 lost 的。不要 把客户邮箱、电话往外发 — 这套系统所有数据都是公司机密。
读完这章你应该 :已经开了账号、跑通过一条假询盘的全流程、知道每天该做什么、知道关键 关键指标 在哪里看、遇到 7 种常见场景知道怎么办。下一步 :看「环境准备 / API 密钥」装齐 发件服务器 + Serper + Jina + 收件服务器,然后看「客户拓展核心流程」跑第一次 Hunter。
环境准备 / API 密钥
权限变更(2026-07): 「第三方连接(API 密钥)」「模型配置」两个面板已收归 tech(技术运维) 账号,admin 不再可见。tech 账号引导:服务器 .env 配 TECH_USERNAME + TECH_PASSWORD 后重启一次,登录后建议立刻改密。日常运营不需要 tech;只有配 key / 换模型 / 运维时用。
必须配的
变量 用途 怎么拿
ADMIN_API_TOKEN初始登录密码 + Bearer 机器令牌 启动时由你设置，长度 ≥ 24 随机串 DEEPSEEK_API_KEY 或 ANTHROPIC_API_KEY 或 OPENAI_API_KEY所有 AI 推理 选一个 LLM 服务商注册
客户拓展模块需要的
变量 用途 申请地址 免费额度
SERPER_API_KEYGoogle Maps 搜索(Hunter 模块找经销商) + SERP 排名追踪(AI 可见度的下游验证) serper.dev 免费 2500 次/月 JINA_API_KEY抓取目标公司官网（绕过反爬） jina.ai 免费 1M 次/月 TAVILY_API_KEY通用 Web 搜索备用 tavily.com 免费 1k 次/月
影响： 只配 SERPER → 能找到公司但抓不到邮箱（成功率 30%）。加上 JINA → 抓取成功率 85%+。这是 投入产出 最高的两个 key。
AI 可见度模块需要的（可选）
变量 用途 申请地址 免费额度
CLARITY_API_TOKEN + CLARITY_PROJECT_IDMicrosoft Clarity 体验数据（死点击 / 怒点击 / 快退） clarity.microsoft.com 完全免费，10 次/天/项目 TAVILY_API_KEYAEO 引用率检查（Tavily 真实搜索通道） tavily.com 免费 1k 次/月（与 Hunter 共用）
说明： 这些 key 全部可选 —— 不配也能用，模块会显示"未配置"提示。Schema + 内容腐烂检测 + AEO 单页评分 + llms.txt 生成只用站内 WP/GA4/GSC 数据，无需额外 key。
怎么写进 .env
docker exec -u root wp-ai-agent sh -c '
检查配好了没
→ 模型配置 看每个模型的连接状态 · → 检查 hunter keys
客户拓展（核心模块）
从 0 个客户到 100 个带评分 + 邮箱 + 决策人的 prospect 池，全自动跑完。
Step 1 · 生成 客户画像（理想客户画像）
填公司官网（必须）+ 产品种子关键词（可选）+ 目标市场（如 Germany, USA, Japan）
上传公司资料：产品手册、报价单、案例集、Datasheet（PDF / DOCX / XLSX / CSV / MD / TXT，每文件 ≤ 25MB）
点「分析公司并生成 客户画像」，约 5-10 秒出结果
真实性提示 ：客户画像 卡片上每条「价值主张 / 行业 / 决策人角色」如果是 黄色 ，说明 AI 没在你的资料里找到原文佐证 —— 它在编。这种条目 hover 看 quote 是空的；发邮件前必须人工核实，或补全资料重跑。
Step 2 · 一键自动跑（推荐）
点绿色「启动自动运行」。系统自动循环：扩展关键词 → 搜索 → 抽取 → 反馈 → 下一轮。
4 个自动终止条件 ：
达到目标线索数 → target_reached
跑满 5 轮 → max_rounds_reached
连续 2 轮新增少于 5 个 qualified → diminishing_returns（自动收手不烧 token）
你按「取消」→ cancelled
实时事件 timeline 每 3 秒刷新；不用守着屏幕，回来看就行。
Step 3 · 看 prospect 池
表格按 fit_score 倒序：
S/A/B/C tier ：综合优先级，S 最高匹配 fit_score ：和你 客户画像 的匹配度（0-100）可触达 contactability ：抓到的邮箱+电话越多越高邮箱颜色 ：personal 个人邮箱（最值钱） · role 角色信箱（sales@） · generic（noreply）同域 ：邮箱域名匹配公司官网 = 真的是该公司员工风险标 ：empty_page 抓不到内容 · likely_competitor 看起来是竞品 · b2c_only 个人零售商
不要相信 ：fit_score 很高但 contactability ≤ 35 的 → 系统抓不到联系方式，AI 是凭训练数据猜的，请人工去对方官网核实。
Step 4 · 生成 3 步邮件序列
点紫色「为 qualified prospect 生成序列」。AI 给每个 prospect 写 3 封：
Day 0 · 公司介绍 （100-150 词）：建立关联，亮一个价值点Day 3 · 产品案例 （120-180 词）：放一个具体产品 + 量化证据Day 7 · 合作邀约 （80-150 词）：低门槛 ask（试用 / 目录 / 电话）
支持 8 种 locale ：en_US / en_GB / de_DE / fr_FR / es_ES / it_IT / nl_NL / zh_CN，每种语言都套了 formal 形式（德语 Sie / 法语 vous / 中文您）。
每条序列有：
评分 0-100 ：≥70 进 draft，否则 needs_review种子 / 复用 ：同行业+同语种的第一个 prospect 是种子，后面是 cheap personalize（成本低）规则校验 ：标题不重 / 字数对 / 提到公司名 / 不泄露邮箱电话 / 不夸张承诺locale 校验 ：另一个 LLM 当母语审稿人查语法 + 文化适配
Step 5 · admin 审批
admin 在表格右侧点「批准」或「拒绝」。批准前必看 ：
预览每封邮件正文，确认没有 hallucination
locale 校验里如果列出 ≥ 2 条 issue，建议先「拒绝」让运营改
评分 < 70 的强制人工看，70-85 可快速过，85+ 几乎都能直接批
团队管理与老板看板
这一组让你从"运营 1 个人 + 自己跟单"扩到"老板看数据 + 多个业务员协作":Kanban 看板 / 发件服务器 一键回信 / 跟进任务 / 自动分配规则 / 业绩榜 / 老板团队看板。**销售员只看自己的;运营+/admin 看全部**。
客户看板(Kanban 拖拽 + 详情抽屉)
每条 lead 一张卡,横向 6 列:new → contacted → quoted → negotiating → won → lost。拖动改阶段就行。
拖到 won/lost :系统自动同步 status 字段 + 填 won_at/lost_at 时间戳。拖到 won 会弹小框收"成交金额(USD)" — 跳过也行(老板看板的"订单金额"列就显示 —)。点卡片打开抽屉 :左侧时间线(所有分配 / 改阶段 / 通话 / 笔记 / 邮件外发记录),右上 AI 起草英文回复,中部 发件服务器 "一键发送"(需配 MAIL_发件服务器_*,见下方),底部跟进任务 + note 输入。超时警示 :卡片右下角自动标 红/黄/灰 - 上次接触时间 < 3 天 / 3-7 天 / > 7 天 。提醒业务员谁该跟了。视角切换 (operator+):顶栏"视角:全部 / 张三 / 李四" - 老板想看张三今天做了啥,选他名字就行。
发件服务器 一键发送邮件
不用打开 Gmail,在 wp-ai-agent 里把 AI 起草的回复直接发出去。配好 发件服务器 后,抽屉里 AI 草稿块下方多个"发送"按钮。
配置(.env) :MAIL_发件服务器_ENABLED=true + MAIL_发件服务器_HOST(默认 smtp.gmail.com)+ MAIL_发件服务器_USERNAME+MAIL_发件服务器_APP_PASSWORD。Gmail 用户用 App Password 不是真密码,在 Google 账户 → 安全 → 两步验证 → App Passwords 创建。留空就复用 收件服务器 凭证 :如果你 收件服务器 邮箱采集已经配过,发件服务器 字段留空会自动复用同一个账户。头部注入防护 :to / subject / in-reply-to 字段会拒掉带 \r\n 的内容,防止有人通过 subject 偷塞 Bcc:。发送后 :写 outbound_emails + 写一条 email_out 活动到 timeline + 可选自动把 status 改为 replied。
跟进任务(每个 lead 自己的待办)
抽屉底部"+ 加跟进任务":填标题 + 截止日(可选,YYYY-MM-DD 或 ISO 时间)→ 落入 lead_tasks 表。
逾期任务在老板团队看板 会按业务员汇总告警(每人 ≥ 3 条逾期 → 进"任务积压"预警)。
业务员看自己的:→ 询盘线索 顶部"我的任务" chip(进 P3 后单独 view)。
销售小组(队 · P10)
把业务员按"队"分组(布茨队 / 飞虎队 / 女神队…),让老板视角能按队对比、规则按队动态轮询。队是组织分组,不影响询盘分配规则的 RR 池语义 — 但提供"team:xxx"语法让你能写"分给某队"而不必维护具体 user_id 列表。
建队 / 删队 :admin 在 → 用户管理 顶部点"销售小组管理"折叠展开 — 填名字 + 颜色 + 排序就建 · 删队不删用户,成员自动回到"未归队"。归队 / 调队 :用户表格新加"队"列 — 直接下拉切换,即时落库。建用户时也可以一步带队。负载条着色 :询盘线索页顶部业务员 chip 左侧 4px 色条 = 所在队的颜色 — 老板扫一眼就知道哪队压单。按队筛选 :询盘线索页加 chip 行 "全部队 / 布茨队 / 飞虎队 / 女神队" — 点了立刻只显示该队成员的询盘。团队看板按队聚合 :老板看板新增 "销售小组对比" 表 — 每队的 人数 / 派单 / 报价 / 成交 / 胜率 / 转化率 / 订单金额 / 首次回复中位数 / 极速回复 / 在手。色块取自队配置。规则的 team: 语法 :在 → 自动分配规则 新增 "整队轮询" 模式 — 选某个队,target_user_id 自动写成 team:{team_id}。队成员变化即时生效 (踢人 / 招新人不用改规则)· 自动跳过 status='disabled' 的成员(请假不漏单)。
典型混打配置(20+ 业务员 / 3 队) :p100 VIP 战略客户 → 老板;p95 政府/招标 → 主管;p80 中国大陆 → 主管;p1 兜底 → 全员 RR(自然按人数权重)。每队不绑国家,所有人都接所有客户 — 公平 + 队作为团队管理标签使用。
自动分配规则(P5 + P10)
新询盘进来不用运营手动分。→ 自动分配规则 (admin only):按条件自动路由到指定业务员。
匹配条件 (子串 OR 任一命中即算):国家 / 产品兴趣 / 来源(逗号分隔多个值,大小写不敏感)。3 种目标模式 :① 单人(固定 user_id) · ② RR 轮询多人(填 rr:u1,u2,u3) · ③ 整队轮询(选某队,后端写 team:{team_id},运行时解析为该队所有 active 成员)RR 原子推进 :轮询计数器在 SQLite 用 UPDATE...RETURNING 原子推进,并发也不会派到同一个。优先级 :数字大的先匹配。第一条命中即派,不继续后续规则。预览(dry-run) :页面下方有"试一条"输入框 — 填国家/产品/来源,实时看会被哪条规则抓到 + 派给谁。上线规则前必跑一次。 命中数 :每条规则有 match_count,长期跑能看出"哪些规则真在用、哪些可以删"。
销售业绩榜(快速版)
在客户看板顶部点"业绩榜"打开 modal — 7/30/90/全期切换。每个业务员一行:派单数 / 已触达 / 成单 / 流失 / 胜率 / 首次回复平均时长。轻量榜单,排序简单。看深的去下一项:团队看板。
老板团队看板(P6.1 + P9.1)
从左侧栏 → 团队看板 进。operator+ 可见。一屏看完全队进度:
分层 内容
销售面 关键指标 4 卡 首次回复中位数 / 响应达标率 (<4h) / 全团队在手询盘 / 本周成交 阿里框架 关键指标 4 卡(P9.1) 询盘(派单数)/ 极速回复率 (<1h) / 订单金额(USD)/ 订单转化率 产品供给侧 3 卡(P9.1) 从 WordPress 拉:产品数 / 有效产品(已发布)/ 本期新发数 6 类预警 高分滞留(score≥80 + 24h 没接触)· 阶段卡死(quoted/negotiating > 14 天)· 无下一步安排(>7 天没联系且没挂待办)· 沉默业务员(本周 0 外发)· 任务积压(逾期 ≥ 3 条)· 派单不均(在手 > 2× 团队均值) 业务员对比表(双层) 蓝列(销售面) :首次回复 / 响应达标 / 派单 / 本周发 / 成交 / 在手 / 跟进率 / 硬跟进 · 绿列(阿里口径) :报价量 / 极速回复% / 订单金额$ / 转化率%
关于"报价量" :统计业务员在客户看板里把 lead 推到 quoted 阶段 的次数(读 stage_change 活动日志)。没用看板直接打电话报价 的不会被记上 — 想准就用看板拖。
跟进率 vs 硬跟进 :跟进率算所有人工记录(备注/通话/邮件都算,靠业务员自觉记);硬跟进只认两种客观证据 — 系统真实发出的邮件、客户已回复 — 刷备注刷不高。两个数差距大 = 记录多但真实触达少,值得当面问一句。
窗口切换 :右上 7/30/90 天按钮。关键指标 和业务员对比按窗口算,预警 和"在手"永远是实时不受窗口影响。
周报量化看板(P10 · 取代 AI 文字周报顶位)
→ AI 周报 进去就是。纯 SQL,零 LLM 成本,毫秒级出 。AI 文字版降到下方,需要叙述时再点。
区块 内容
同期对比表 6 指标(新询盘 / 派单 / 报价 / 成交 / 成交金额 / 平均首次回复) × 3 周(本周 / 上周 / 上上周)+ WoW%。首次回复 行的 WoW 颜色反转(降是绿,涨是红 — 首次回复 越低越好) 柱状图(3 张) 过去 N 周 周询盘量(蓝) / 周成交单(绿) / 周成交金额(黄)。最新一周柱不透明突出,历史半透明。柱顶标数字,hover 看 ISO 周号 饼图(3 张) 近 4 周分布:① 询盘来源(webhook/email/hunter/manual/...)② 成交占比按销售小组(队色取自队配置)③ 国家分布 TOP 5 + 其他
窗口切换 :4 / 8 / 12 周一键切。再大窗口后端 clamp 在 [3, 26]。周锚定 :周一 00:00 中国时间（UTC+8）为周边界 — 不同时段刷新数据仍稳定。SVG 手写,零依赖 :没引入 chart.js / d3 / echarts,单文件构建更稳。典型用法 :老板每天早上来看一眼柱顶数字;周一切到 12 周看趋势是不是抬头;同期对比表里红色行 = 这周下滑要去排查。
AI 对话能力升级
→ AI 对话 比通用聊天工具多了三层:身份切换 (让 LLM 以特定角色回答)、历史对话持久化 (刷新页面不丢)、RAG 知识库引用 (把你上传的 SOP/FAQ 当外部脑)。
专业身份（按权限显示）
输入框上方一栏,点了之后下一条消息会把对应"知识包"塞进系统提示。**身份切换不影响对话历史**,可以一边问着切换,LLM 立刻换皮。
身份 用来问什么
通用 不加 persona,通用助手 — 默认 投流总监 "我月预算 $3000 卖工业平板该怎么搭账户" → 给你具体 campaign 数 + 关键词主题 + 出价范围。B2B 工业品长决策周期思维,不会拿电商 ROAS 来套。 RSA 文案 "给 'industrial tablet wall mount'写 RSA" → 出 15 标题 + 4 描述,严格 30/90 字符限制,pin 位置标好,带自检列表。 账户审计 "我账户 5 个 campaign 8 个 ad group 月花 $4K 0 转化怎么救" → 按 80 项检查打分,出 A-F 等级 + CRITICAL/HIGH/MED 行动清单 + 估损。 搜索词分类 "这 200 个搜索词分类打否" → 输出可直接复制到 Google Ads 后台的 EXACT/PHRASE 否词块 + 应加入清单。 SEO 与 AI 搜索总监 "做一次全站 SEO + GEO 体检" → 联动 GSC、文章收录、SERP、内容腐烂、Schema 和 AI 引用数据，给 P0/P1/P2 路线、负责人、领先指标与失败判据。 客户背调(P10) "背调 acme.com" → 30-60 秒输出可视化背调卡:国家 / 公司年龄 / 员工规模 / 年营业额 / 决策人 LinkedIn / 买信号 / 风险标记 / 下一步建议。详细见下方独立小节 。
知识包来源 :身份提示词提炼自可信官方资料与公开 MIT 项目，并已改写成本站真实工具、权限、确认队列和 B2B 询盘目标。SEO 与 AI 搜索总监参考 claude-seo 与 geo-seo-claude，但不会把外部统计、诊断分数或 llms.txt 描述成排名保证。
客户 AI 背调(P10 · 核心模块)
业务员回询盘前花 30 秒摸清客户底,代替花 1 小时翻 LinkedIn + Google + 海关数据。
两个入口
入口 1 · chat 主入口 :AI 对话身份选"客户背调",直接发 背调 advantech.com 或 查一下 ACME Industrial 这家德国公司入口 2 · 客户看板抽屉快捷 :打开任意 lead 抽屉,顶部紫色卡片"AI 客户背调"按钮 — 自动从 lead.website / email 抽域名(过滤 gmail/yahoo 等免费邮箱),关抽屉 → 切 chat → 激活身份 → 自动发指令
3 个 agent 工具
fetch_page(url) — 抓任意 URL 正文(Jina Reader → httpx 降级)web_search(query) — Web 搜索(Tavily 优先 → Serper 降级)。需要 SERPER_API_KEY 或 TAVILY_API_KEY(serper.dev 免费 2500 次/月)whois_lookup(domain) — RDAP 注册年份 / 注册国(免费,不需 key)
输出 = 结构化"背调卡片"
LLM 用中文写 3-6 段叙述 + 末尾 fenced JSON 块。前端识别 schema 自动渲染成可视化卡片:
顶部头 :公司名 + 域名 + 国旗 + 行业 + 年龄 + 整体置信百分比三块 tile :员工规模(LinkedIn) / 年营业额(USD) / 海关数据(P2 占位)决策人 :LinkedIn 公开高管,带 ↗ 跳真实 LinkedIn URL · 无 URL 的整行隐藏(C 项防护)买信号 vs 风险标记 :并列两列,每条尾部三态角标(见下方真实性章节)下一步建议 :开场语言 / 首报价区间 / 主推产品 / 决策周期数据源 + 工具调用次数 :卡片底部显示所有 source URL + 工具调了几次(诚实)
5 道真实性防线(P10 强化)
为什么要这么多防线? LLM 容易"补完"信息以让结果看起来完整 — 编造 LinkedIn 名字、瞎拍营收区间、空想买信号。这 5 道防线把可信度从 65% 拉到约 95%。
第 1 道 · 强制调工具 :persona 提示词明令"不要靠脑子里的记忆瞎编",必须调 3 个工具中至少 3 次。第 2 道 · 工具调用数 < 3 红条警告 :卡片顶部 验证不充分 — sources < 2 也触发。告诉业务员"不能直接用,自己重核"。第 3 道 · 字段 verified / inferred :每个估算字段标"✓ 已查证"(绿) vs "◌ 推断"(黄)。员工规模 / 营收 / 决策人 / 买信号 / 风险标记都标。第 4 道 · LinkedIn URL 强制 + 无 URL 隐藏 :决策人姓名必须配对真实 LinkedIn URL — 没 URL 的整行隐藏并显示"已隐藏 N 位未验证决策人"。第 5 道 · server-side URL 反查 :LLM 给的 source_url / linkedin URL 是否在工具调用结果里真出现过?不在 → 标 ✓ (LLM 可能编 URL)。这是核心防护,抓"听着合理但其实是编的"URL。
业务员看角标的方式
角标 含义 怎么用
✓✓ 绿 LLM 标 verified + URL 真在工具结果里 直接用 ✓ 红 LLM 标 verified 但 URL 不在工具结果里 可能是编的 · 自己重核◌ 黄 LLM 自己标 inferred(推断) 二次确认
运营 SOP(顶级运营写给业务员)
国家 / 公司年龄 → 大多 ✓ 直接信员工规模 / 年营业额 → 报价时按区间宽开,谈过 1 轮后修决策人姓名 + LinkedIn URL → 不管角标是什么,**写邮件 To 字段时仍用 lead.email**,不直接抄 AI 给的顶部 红条 → 工具没调够,这条背调当 0 分,从 chat 内继续追问"再搜一下 LinkedIn"让 LLM 补查记一句口诀 :国家 / 年龄能信 · 规模 / 营收看看 · 人名一律自己核
未来 P2 / P3 加固方向
P2 · 海关数据接入 (52WMB / ImportYeti / Panjiva)— 银弹,直接证伪假公司,卡片"海关数据"占位字段会启用。¥200-600/月。P3 · 决策人邮箱(Hunter.io / Apollo) — 不只姓名,直接给采购经理邮箱。$49+/月。
9 个模型该选哪个(实战派)
右上角的模型下拉,9 个备选不是花式罗列。每个有强项也有死穴。按任务挑,不按"听起来最强"挑 。default 是 claude-sonnet,够用 80% 场景。
3 个等级 + 3 个 family + 1 个 custom
顶配 (贵但强):Claude Opus 4 · OpenAI o3主力 (性价比之王):Claude 4 Sonnet · GPT-4.1 · DeepSeek R1跑量 (便宜量大):Claude Haiku 4.5 · GPT-4o · DeepSeek V4 Flash自定义 :接 OpenAI 兼容端点(Together / Groq / 本地 Ollama 等)
Anthropic Claude 家族 — 综合最稳
模型 擅长什么 什么时候用 / 不用
Claude 4 Sonnet claude-sonnet-4-20250514 平衡王。中文 / 英文都顺,工具调用稳定,长上下文记得住,代码 / 推理 / 写作全 8 分 用 :默认就它,不用想太多。客户背调、AI 回复草稿、AI 周报、内容生成全靠它。不用 :简单分类 / 抽取 → 用 Haiku 省钱Claude Opus 4 claude-opus-4-20250514 Claude 顶配。复杂多步推理、深度技术分析、上下文极长(200K)的总结综合,几乎不打哆嗦 用 :网站数据看板跑全栈分析 / 长文章 outline / 难翻译。价格是 Sonnet 5 倍 ,别用来聊天Claude Haiku 4.5 claude-haiku-4-5-20251001 极快、极便宜(Sonnet 1/12),分类、抽取、简单回答力还行 用 :邮件分类(spam / inquiry / newsletter)、SERP 词意向分类、Hunter 批量打分。不用 :开放性创作 / 复杂背调 → 容易简陋
OpenAI 家族 — 工具调用王 + 推理王
模型 擅长什么 什么时候用 / 不用
GPT-4o gpt-4o 函数调用 / agent 工具链最稳定,响应快,多模态(图片输入)是 Claude 没有的 用 :工具循环(Hunter 自动获客的 keyword 扩展 / extract),需要 image 输入的视觉任务。不用 :深度推理 → 比 Opus / o3 弱GPT-4.1 gpt-4.1 2025 年 4 月发布,代码生成 + 复杂指令服从是这一档最强,1M 上下文 用 :Schema.org 注入 / RAG 引文章节复杂引用、生成结构化产品上架 JSON。不用 :闲聊 → 太严谨,反而不灵活OpenAI o3 o3 推理怪兽。数学 / 因果分析 / 多步规划碾压一切。响应慢(10-30 秒)+ 贵 + 不太用工具 用 :做 投入产出 测算、复杂 attribution 归因、deep dive 一个营销策略。不用 :任何需要工具调用的(它会偷懒)
DeepSeek 家族 — 中文 + 便宜的中国选项
模型 擅长什么 什么时候用 / 不用
DeepSeek V4 Flash deepseek-chat 性价比天花板。**中文比 GPT/Claude 自然**,英文也够用。便宜到几乎免费(¥0.001/k tokens) 用 :中文 SOP / FAQ 起草、内部周报、AI 摘要、客服回复 draft。不用 :agent 工具调用(协议没那么稳)、跨语言精细翻译DeepSeek R1 deepseek-reasoner DeepSeek 推理版。中文推理强,价格比 o3 便宜 50 倍。开放权重,合规可控 用 :中文复杂分析、对外不愿用美国模型时的兜底。不用 :实时性要求高(响应慢)
Custom — OpenAI 兼容端点
填 custom_api_key + custom_base_url + custom_model_id(→ API 密钥 )。可以接:Together AI(开源模型托管)、Groq(超快)、本地 Ollama(自己显卡)、SiliconFlow / 阿里通义千问 兼容端点等。
按任务选(直接抄)
任务 首推 备用 / 省钱版
客户背调(调 3 个工具 + 综合判断) Claude 4 Sonnet GPT-4o(工具最稳) AI 起草英文回复邮件 Claude 4 Sonnet GPT-4.1(更严谨) 邮件 / 询盘 spam 分类 Claude Haiku 4.5 DeepSeek V4(更便宜) Hunter 自动获客(多轮工具循环) GPT-4o Claude 4 Sonnet AI 周报(中文长文生成) DeepSeek V4 Flash Claude 4 Sonnet 网站数据看板深度分析(全栈复盘) Claude Opus 4 OpenAI o3(更推理) RSA 文案 / 标题生成(精准字符限制) GPT-4.1 Claude 4 Sonnet SEO 体检建议(结构化分析) Claude 4 Sonnet GPT-4.1 对话摘要压缩(归档长对话) DeepSeek V4 Flash Claude Haiku 4.5 内部 SOP / FAQ 起草(中文) DeepSeek V4 Flash Claude 4 Sonnet 翻译(中→英,产品文案) Claude 4 Sonnet GPT-4.1 产品上架 JSON 结构生成 GPT-4.1 Claude 4 Sonnet
成本建议 :不缺钱默认 Claude 4 Sonnet ;算钱:背调 + Hunter 用 Sonnet,SOP/周报/分类用 DeepSeek V4,深度分析临时切 Opus。把"按任务选"那表搬到 → 运营任务 自己跑两周做 A/B 真实数据,再固化最优搭配 — 比看任何外网评测都靠谱。
历史对话持久化(P7.1-K-2)
对话顶部多了一栏: 历史 · + 新对话 · 右侧显示当前会话 ID + 消息数。
刷新页面自动续接 :conversation_id 存在 localStorage,刷新后自动从 SQLite 把上次对话拉回来 — 不再丢上下文。 历史抽屉 :右侧滑出列表,显示所有过往对话(模型 + 创建时间 + 消息数)。点任一条 → 加载。+ 新对话 :清空当前 + 清 localStorage,下次发消息后端生成新 ID。抽屉删除 :每行 ,二次确认 → 永久删除该对话。已知小坑 :对话表没有 user_id 列,operator + admin 互相能看到对方的对话(sales 看不到 chat 标签所以无影响)。隔离要等后续表迁移。
RAG 知识库(把内部资料挂上 chat)
→ 知识库 上传 PDF/DOCX/XLSX/CSV/MD/TXT(≤25MB),向量化进 Qdrant。chat 里如果 message 含"根据知识库/资料/文档",runtime 会先调 rag_answer_context 检索,再让 LLM 引用 [1][2] 答。
典型上传内容 :产品手册 / 报价规则 / 客服 SOP / 公司 FAQ / 合同模板。混合检索 :vector(语义相似)+ keyword(精确词)+ phrase(短语匹配)三路打分加权,效果比纯 vector 稳。知识库分组 :每个集合一个 knowledge_base(默认 default),问的时候可指定从哪个库找,避免业务员问 SOP 时翻到产品手册。
Google Ads OAuth 接入向导(P7.1-A,进行中)
→ Google Ads (admin only)。三盏状态灯页:
OAuth 应用凭证 :Google Cloud Console 建 OAuth Client(Web app),redirect URI 写 http://127.0.0.1:8010/api/ads/oauth/callback,下载 JSON 重命名为 ads-oauth-client.json 放 secrets/。Developer Token :Google Ads MCC → API Center 申请 Basic Access(免费,1-3 天审批),拿到后写 .env 的 GOOGLE_ADS_DEVELOPER_TOKEN。账户主人授权 :前两盏绿了,点"连接 Google Ads" → 跳 Google 同意页 → 自动落 token。
P7.1-B 待开 :三盏灯全绿后,数据接口(GAQL 查询 / 关键指标 卡 / 浪费词预警 / AI 投流建议)就上线。知识包 persona 不依赖 dev token,现在就能用 — 哪怕没接账户,问 chat "我该怎么搭账户"也照样答得精准。
定时任务 · 让系统按节奏自己跑
operator 配一次 cron,到点自动执行。安全底线:所有对外动作(发信/发布)仍走待确认队列,绝不自动发出 。
两种任务类型
类型 行为 目前可选
动作 自包含分析类,到点全自动跑完出结果 生成周报 / AEO 引用巡检 / 关键词获客(按模板) / Apollo 获客(按模板) agent 指令 自由自然语言,到点让 AI 执行;任何写操作自动落待确认队列等人审 例:「每周五汇总本周 GSC 掉排名的页面并给建议」
怎么配(3 步)
→ 定时任务 点「新建」:选类型 → 频率(间隔 / 每天 HH:MM / 每周 周几@HH:MM)。时间统一按中国时间（UTC+8）填写,不受当前电脑时区影响。获客模板 :先在 Hunter / Apollo 把一次筛选调满意,点「⏱ 另存为定时模板」→ 回到定时任务选该模板,到点自动建新批次并开跑。缺 key 或模板会跳过并记摘要,不会报错卡死。每张任务卡:启停开关 / 立即运行 / 执行历史 。改完排程下次触发自动按新时间。
推荐基线(与运营 SOP 手册一致)
任务 排程 为什么
生成周报 每周一 08:00 开工前报告已就绪,晨会直接用 AEO 引用巡检 每天 07:00 AI 引擎引用变化第一时间进增长雷达 Apollo 获客(按模板) 每周二 09:00 批次跑完等运营筛,当天分配给业务 关键词获客(按模板) 每周四 09:00 与 Apollo 交替,两条获客线不打架
总开关 SCHEDULED_TASKS_ENABLED(默认开)。执行历史里每次运行都有摘要,跑失败会写原因。
其他业务模块
→ 询盘线索 入站表单 / 邮箱采集 / Hunter 三源询盘统一池 · AI 评分 · 起草英文回复 · 运营分配给业务员 + 业务员只看自己的 → 产品管理 WordPress 产品 CPT 列表，分页 + 搜索→ 文章管理 WP 博客文章列表 + AI 内容工厂（关键词 → 大纲 → 全文 → 存草稿）→ 数据看板 GA4 流量 + GSC 关键词 + 综合机会推荐→ SEO 体检 抓真实页面查标题/描述/H1/图片 alt/重定向→ AI 周报 一键生成本周流量 + 关键词 + 线索 + 任务进度报告→ 知识库 上传 SOP / FAQ / 产品手册，对话时 AI 会引用→ 增长雷达 竞品 / GEO 提问 / 外链机会跟踪→ 运营任务 跨模块任务汇总→ Google Ads 投流账户对接 + 周报 CSV 上传 + AI 对比浪费分析 · 下面有完整 投流指引 ↓ → AI 对话 通用对话，可调用上面所有工具（含 RAG 检索）
AI 可见度（5 个模块）
这一组解决"AI 引擎 / 搜索引擎 / 真实用户分别怎么看你的站"——配合用就是发现问题 → 注入信号 → 监控引用 → 找出该改的内容 → 验证排名变化 的闭环。
→ Clarity 体验 接 Microsoft Clarity 看死点击 / 怒点击 / 快退，找出"用户在哪儿挫败"。需配置 CLARITY_API_TOKEN + CLARITY_PROJECT_ID。每天每项目 10 次配额。→ Schema 注入 给文章注入 Article / FAQPage / BreadcrumbList 等 JSON-LD，提升 Google 富文本片段 + AI Overview 引用率。注入 / 移除带 marker 边界，幂等可回滚。→ AEO 引擎 三件套：（1）单页 AI 友好度评分 0-100（H1/Meta/Schema/语义结构/FAQ/引用…）；（2）监控问句引用率（Tavily 真实搜索 + LLM 模拟回答）；（3）生成 llms.txt 让 AI 爬虫识别你站点结构。需要 TAVILY_API_KEY 走 Tavily 通道。→ 内容腐烂检测 把文章按 GA4 (近 28d vs 前 28d) + GSC + 年龄分成 Rising / Evergreen / Decaying / Dead 四类，输出按优先级排序的 refresh 队列。每条一键转任务。扫描需要 1 次 GA4 调用 + 1 次 GSC 调用。→ SERP 排名追踪 主动查 Google 给目标关键词的真实排名(top 100),记录历史趋势 + 7/30 天涨跌幅 + TOP 1 竞品。这是 AEO/Schema/Decay 工作的下游验证信号 — "我们做了那么多 AI 可见度工作,Google 排名真的动了吗?"。需要 SERPER_API_KEY(免费 2500 次/月)。
推荐工作节奏
周一 :跑 内容腐烂检测 → 取 TOP 5 decaying 转任务到运营任务;同时跑 SERP 批量检查 看本周排名快照周二-周四 :执行任务(改文章、补 Schema、加内链)周五 :跑 AEO 引擎 的"检查"看本周引用率变化;按需 Schema 批量注入新发的文章下周一 :看 SERP 排名追踪 的"7 天涨幅 TOP" — 上周的改动有没有把目标关键词往上推每月 :看 Clarity TOP 死点击 / 怒点击页面,处理交互体验问题
竞品监控（数据洞察组,左侧导航 → 竞品监控)
5-20 个核心竞品的 sitemap + RSS 自动追踪 — 谁刚发了什么新产品 / 新博客 / 新 Landing 页 。零 API 费用,礼貌爬取(标识 UA + 频率限制 + 不爬全站只用对方公开的 sitemap)。配合 SERP 排名追踪闭环:看到竞品新发产品页 → 建议加进 SERP 监控,半个月后看它有没有冲上 TOP10。
添加竞品 :填名字 + 域名(裸域名,如 advantech.com) + 优先级(高 / 普通 / 观望);高优先级在所有列表顶部。单条扫描 :点"立即扫描" — 抓 6 个常见 sitemap 路径 + 8 个 RSS 路径,首个命中即返回;最多入库 500 个新页面(避免 5 万页大 sitemap 撑爆数据库)。批量扫描 :全部竞品轮询扫一遍,每个竞品之间停 0.5s 看起来更礼貌。预算:10 个竞品 ≈ 1 分钟。"最近发现"feed :跨所有竞品的最新 30 条新页面流 — 这是每周一最该看的视图 ,告诉你"上周谁发了什么"。页面分类 :product / blog / pricing / docs / landing / unknown(基于 URL 路径启发式,如 /products/ → product,/2024/05/ 日期路径 → blog);单条页面查看时可按类型筛选。页面历史 :每条 URL 记录 first_seen(首次发现时间) + last_seen(最近还在 sitemap) + last_changed(内容 hash 变化);删竞品 cascade 删历史。
推荐工作流(B2B 工业平板视角)
首次设置 :加 5-10 个核心直接竞品(Advantech/Winmate/Touch International/Crystal Group...) + 3-5 个国内同业作 watch — 共 ~15 个,够覆盖直接竞争面。周一早会 :打开"最近发现"feed → 谁发了 product 类页面?这是新型号信号,5 秒抓住情报。新产品上线 :看到竞品发了 "/products/rugged-tablet-12-inch/" → 立刻把这关键词加到 SERP 监控,看半个月后它有没有冲上 Google TOP10。SEO 内容情报 :看 blog 列表,知道竞品在主攻什么话题。冷启动:复制他们的标题去你的 AEO 单页评分,反向工程对方的关键词卡位。季度复盘 :对比同一竞品两个季度的 product 数 — 涨多少,涨什么?能粗略推断他们的研发节奏。
询盘智能中枢（转化层升级）
在原有「→ 询盘线索」基础上,补了 AI 智能管道 :启发式富化 + 批量分级 + 聚合洞察,让你不用挨条点 AI 评分,也能在打开 tab 的瞬间看到询盘的全局画面。
富化（单条 / 批量） :零 LLM 成本,毫秒级从邮箱域名 / 电话区号 / TLD 推断 国家 + 企业 vs 免费邮箱 ;扫描消息抓 产品词 / 采购意向词 / 垃圾词 / URL 数 ;自动回填空的国家字段。启发式分级 :不调 LLM 就能给出 A/B/C/spam 初判 + 0-100 分数 + 置信度。Spam 阈值置信度 ≥ 0.85 直接跳过 LLM 省 token。批量启发式 + LLM :先启发式过滤再升级 LLM,垃圾自动绕开。100 条询盘里如果 30 条是垃圾,实际只烧 70 条的 LLM 调用。聚合洞察 :近 90 天询盘按国家 / 级别 / 来源 / 产品 / 关键词 6 个维度切片,告诉你「企业邮箱占比 % · T1 市场占比 % · 待 LLM 分析 N 条」。启发式信号面板 :每条 lead 展开后单独显示一个绿色边框的「 启发式信号」块,把推理过程透明化(域名 / 国家 / 命中关键词 / 判定理由)。
建议工作流
每天早上 :打开「→ 询盘线索」→ 看顶部 关键指标 「待处理」数,>5 条点「批量启发式分级」(免费)看聚合洞察 :展开洞察卡片,如果"垃圾"列突然涨 → 检查站点是否被 spammer 盯上,要不要加 reCAPTCHA高价值询盘 :A 级 + 企业邮箱 + T1 市场 → 点单条「AI 评分」让 LLM 出 summary 和 followup,再点「生成回复」起草英文邮件批处理高峰 :展会回来一次涌入 50+ 询盘,点「批量启发式 + LLM」一次性处理完,垃圾自动绕开
询盘分配 + 客户管理 看板（团队协作层）
运营拿到询盘后必须能分配给具体业务员,每个业务员只看到自己的池子,系统才能跑团队。这一组解决:谁应该跟这条 · 跟到哪步了 · 多久没动了 。基于已有的 lead 表扩展,不破坏原有 AI 评分管道。
业务员负载条 (顶部,operator+ 可见):每个业务员显示 开放 N · 停滞 N 。开放 = 未 won/lost 的总数;停滞 = 超过 7 天没和客户接触的(基于 last_contact_at)。某个人开放 > 20 标红,提醒运营:这人压太多了,该匀给别人。归属筛选 chip :全部归属 / 未分配 / 每个业务员一个 chip。点「 未分配」就是你的工作池 — 这是运营每天上班的起点。批量分配 :在未分配视图里勾选若干询盘 → 顶部浮出条 →「分配给 [业务员]」→ 执行。一次最多 500 条。每条会写一条 assignment 活动到 timeline,业务员能看到"X 月 X 日被 admin 分给我"。单条改派 :每条 lead 行尾有「分配给…」下拉,即点即换;业务员有事请假可以临时把他的 lead 整批转给替补。业务员视图 :sales 角色登录后,看到的就是同一个「→ 询盘线索」页,但后端强制 owner_id pin 到自己 — 他看不到 未分配池,看不到 别人手上的 lead,看不到 负载条和分配 chip。如果他试图改 URL 看别人的 lead,后端 403。Kanban stage (数据已经在记,UI 看板在 P3 上):每条 lead 有一个 stage 字段 — new / contacted / quoted / negotiating / won / lost。和 status 解耦 — status 是漏斗状态,stage 是销售自定义阶段。后续 P3 加可拖拽看板视图。活动 timeline (底层已经在记):每次分配 / 改 stage / 加 note / 加跟进任务都进 lead_activities 表;P3 看板里点开一条 lead 就能看到时间线。当前后端 API 已经支持 POST /api/leads/{id}/activities,前端抽屉 UI 在 P3 上。
每日运营工作流
上班第一件事 :进询盘线索 → 看负载条。谁开放 > 20 (红色) 谁停滞 > 5 (黄色 ) — 这是今天的运营警报。分配新询盘 :点「 未分配」chip → 多选 → 选业务员 → 执行。简单规则:德语客户给会德语的、北美询盘给夜班、A 级询盘只给金牌 。压力均衡 :看到 A 同学 27 单 / B 同学 6 单 → 点 A 的 chip → 多选挑 10 条 → 批量改派给 B。停滞排雷 :某业务员 8 → 点他 chip → 看到这 8 条 → 当面对齐"这些怎么处理"。
业务员视角(sales 角色登录)
登录后只看自己 :进「→ 询盘线索」直接是自己的池;搜索 / 排序 / 分页都只在自己范围里。跟进顺序 :按评分排序 → 先打 A 级 + 高分。对接客户 :用「AI 评分」+「生成回复」造英文邮件草稿,人工微调后发出。(P3 上线后) :点 lead 进抽屉 → 写 note "客户说要等月底预算" → 设跟进任务 "6 月 30 日提醒" → 拖卡片到 negotiating 列。
新员工入职 SOP
admin 在「用户管理」加账号,角色 sales ,密码强一点
把账号密码当面给业务员,让他立刻改密(顶栏头像 → 改密)
运营进询盘线索 → 看到负载条多了这个人 (开放 0) → 把试用期的几条简单询盘分给他
业务员离职:用户管理「停用」→ 询盘线索点他 chip → 批量改派 → 然后删账号
Google Ads 账户接入(OAuth 授权)
把系统连到你的 Google Ads,走的是 OAuth 委托授权 + 只读 API (和 GA4 同一套 Google 身份)。
它不是"用 Google 登录本系统" —— 是你一次性点"同意",让系统以你的名义读你的 Ads 数据;之后系统拿 refresh token 自动拉数,你不用重复登录。登进后台仍是你自己的账号密码。
三样东西必须凑齐,缺一不通:
凭证 回答什么 谁给 / 放哪
① OAuth 客户端 JSON "这个 App 是谁" Google Cloud Console → 放 prod secrets/ads-oauth-client.json ② 回调 URL "授权完跳回哪" Google 里填 + .env.production 的 ADS_OAUTH_REDIRECT_URI,两边必须一字不差 ③ developer token "凭啥读 Ads API" Google Ads 经理账号(MCC)→ 设置里填 ads_developer_token
Part A · 去 Google 拿凭证(只有你能申请)
启用 API :Google Cloud Console → 建/选项目 → API 和服务 → 库 → 搜 Google Ads API → 启用。OAuth 同意屏幕 :类型 External;填应用名 + 邮箱;加隐私政策 URL + 授权域名 agent.trademaxtech.com ;scope 加 .../auth/adwords;把自己的 Google 账号加进测试用户 (否则授权被拒)。建 OAuth 客户端 :凭据 → 创建凭据 → OAuth 客户端 ID → 类型「Web 应用」;已获授权的重定向 URI 填 https://agent.trademaxtech.com/api/ads/oauth/callback(一字不差)→ 下载 JSON。申请 developer token :用 Google Ads 经理账号(MCC) 登录 → 工具 → API 中心 → 取 developer token。新令牌默认「测试」权限,读真实账号数据需向 Google 申请基础访问,审批可能几天。
Part B · 放进系统
上传客户端 JSON :重命名 ads-oauth-client.json,放到 prod /srv/wp-agent/secrets/(和已有的 ga4-oauth-client.json 并排)。scp your-client.json trademax-sg:/srv/wp-agent/secrets/ads-oauth-client.json填 developer token :后台 → → 设置 → ads_developer_token 粘贴保存(热生效)。有经理账号再填 ads_login_customer_id(纯数字,去横杠)。设回调环境变量 (唯一 UI 改不了、必须动 env 的一步):往 .env.production 加 ADS_OAUTH_REDIRECT_URI=https://agent.trademaxtech.com/api/ads/oauth/callback → 重建容器。不设会默认 localhost,授权必然 redirect_uri_mismatch。找运维/管理员做。
Part C · 点一次授权
后台 → → 付费投流 → 点连接 Google Ads → 跳 Google 同意页,用你的 Google 账号登录并"同意" → 自动跳回、令牌落盘。状态变「已授权 + dev token」= 成功(数据源健康面板同步 dark→live)。
三选一排错 :缺 ① → 连授权页都弹不出;② 两边对不上 → redirect_uri_mismatch 卡死;缺 ③ → 授权能过但拉数据被 Ads API 拒。不想搞 OAuth? 「Google Ads 投流指引」那套 CSV 上传对比 完全离线,dev token 没下来也能用 —— 见下一节。
Google Ads 投流指引
这套系统不替你出价 (出价、关键词、CPC 这些 Google 自己做),它替你诊断 — 把账户当前周和上周的数据对比,找出在烧钱不出单的关键词、广告组、地区。Google Ads 后台导出 CSV → 上传 → AI 对比上一份 → 给出"砍这几个,加预算给那几个"的建议 。完全离线分析,不依赖实时 OAuth 接口,即使你的开发者 token 还没下来也能用。
① 准备工作(一次性,15 分钟)
有 Google Ads 账号 :登 ads.google.com → 顶部齿轮 → 账号设置 → 拿到 客户 ID (格式 123-456-7890)。配 Conversion Tracking (最关键的一步,不做这步后面所有 ROAS 都是空):
Google Ads → 工具 → 转化 → 新建 → 网站 → 转化名 "询盘提交" → 类别 潜在客户 → 价值方法选"每次相同 $50"(B2B 询盘默认值,后面看实际成交价回调)。
装 Google Tag Manager,在感谢页 /thank-you 触发上面新建的转化 tag。或者直接在 WP 主题感谢页 footer 加 GA gtag 代码段。
24 小时后回 Google Ads → 转化 → 状态应该从「未记录到转化」→「正在记录」。状态不绿之前不要开广告 — 没有转化数据,Smart Bidding 全瞎。
(可选)开 OAuth 连接 :左侧导航 → Google Ads → 「连接 Google Ads」按钮 → 用 Google Workspace 邮箱授权。这一步让系统能直接拉 账户数据,不用每周导 CSV。需要先有 developer token (Google 审核 1-3 周)。没做这步也能用 CSV 模式 ,功能 90% 一致。账户结构基线 (强烈建议先做对):
1 个 Campaign = 1 个产品大类(例:Rugged Tablet / Kids Tablet / Industrial Panel PC 各一个,不要塞在同一个 Campaign 里)
每 Campaign 下 3-5 个 Ad Group,每 Ad Group ≤ 15 个关键词 ,主题不能混(industrial-tablet 和 rugged-tablet 不能同 group)
语言全部用 英文 + 当地语言 (德国想做就加德语 Campaign,别只投英文)
地理定位选 "使用以下方式定位:在场或感兴趣" ,不要选默认的"在场或最近搜索过",误中率高
② 每周工作流(20 分钟搞定)
每周一上午固定动作。前提是 Conversion Tracking 已经在跑。
导出本周 CSV :Google Ads 后台 → 报告 → 预定义报告 → 选「关键词 - 详细搜索字词 」→ 时段选「过去 7 天」→ 列保留:Campaign / Ad Group / Keyword / Impressions / Clicks / CTR / Avg. CPC / Cost / Conversions / Conv. value / Conv. rate / All conv. value/cost(ROAS)→ 下载 CSV。上传到本系统 :Google Ads tab → 「上传 CSV 快照」→ 选刚下载的文件 → 标记本周日期。系统会按日期入库到 ads_csv_snapshots 表。跑「对比上一份」 :勾选本周快照 + 上周快照 → 点「AI 对比」→ 等 30 秒。系统调用 ads_compare_snapshots 工具,产出:
烧钱大户榜 Top 5(花费高但 0 转化):候选枪毙名单新明星关键词 :本周才出转化、CPC 又低 → 候选加预算持续浪费的关键词 :两周都有花费 0 转化 → 必砍ROAS 显著上升 / 下降的 Ad Group :跟趋势
跑「找浪费」 :点「AI 浪费分析」(调 ads_top_waste)→ 给出本周「花了 $X 出了 0 转化」的关键词 / 搜索词 / 地区 Top 10。
搜索词浪费 = 用户实际搜的词。看一遍 → 把不相关的加进否定关键词 (Google Ads → Ad Group → 否定关键词)地区浪费 = 哪些国家点击多但 0 转化。考虑这些地区降出价 50% 或排除
执行 + 记录 :基于上面建议,去 Google Ads 后台改动 — 砍 1 个 Campaign / 暂停 5 个关键词 / 加 10 个否定关键词 。回本系统的「运营任务」建一条任务「本周 Ads 优化 - 砍了 X 加了 Y」记录下来,下周对比时能看出动作有没有效果。
③ 关键 关键指标 是哪几个(B2B 工业品视角)
指标
B2B 工业品健康区
在哪看
CTR (点击率) ≥ 3%(搜索)/ ≥ 0.5%(展示) Ads 后台 + 本系统快照 Avg. CPC $1-$5 工业类正常,> $10 要警惕烧钱 本系统 CSV 对比 Conversion Rate ≥ 2%(询盘表单提交) 必须先配 conversion tracking Cost per Conversion ≤ $50/询盘(B2B 工业品基线) 本系统「对比」+「浪费分析」 ROAS (假设客单 $1000 * 20% 成交率) ≥ 4(即每花 $1 带回 $4 营收) 需 Smart Bidding + 转化价值 Search Impression Share ≥ 60%(否则被竞品压制) Google Ads → 修饰列 → 加这一列 Quality Score 关键词 ≥ 7/10,<5 立刻整改 LP + Ad Copy Google Ads → 关键词 → Quality Score 列
④ 启动一个新 Campaign 的 SOP
定目标 :这个 Campaign 卖什么型号 / 解决什么问题?例:WT707 工业平板 → 目标受众是工厂采购 / 系统集成商。挖词 :用本系统「SERP 排名追踪」+「Google Keyword Planner」(Ads 后台 → 工具 → 关键词规划师)→ 列出 30-50 个相关词。再分组 → 每个 Ad Group 一个 intent("rugged tablet" 信息型 / "buy industrial tablet" 交易型 / "wt707 price" 长尾)。否定词清单 (开播前必填):
通用否定:cheap free diy amazon review second hand used refurbished
消费类干扰:kids game tablet pc gaming(除非你就卖儿童平板)
竞品名(只投自己 ≠ 投竞品名,后者效果一般)
Ad Copy :每 Ad Group 至少 3 个 Responsive Search Ads ,15 个 headline / 4 个 description。Headline 必须出现:关键词原文 + 一个利益点 + 一个差异化 。例:
H1: Rugged 7" Industrial Tablet — IP54
H2: WT707: Built for Factory Floors
H3: 3-Year Warranty · 起订量 50pcs
D1: Custom logo + Android 13. Free engineering sample for verified buyers.
Landing Page 必备 :H1 含关键词 / 上方一屏内有填表入口 / 3 秒说清"这是给谁用的什么产品" / 信任徽标(ISO / RoHS / 客户 logo)/ Mobile 速度 < 3s。LP 烂 = 钱白烧,Google 还给你低 Quality Score。预算 + 出价 :
启动期 2 周 :用 Max Clicks (最大化点击),日预算 $30-50,先积累转化数据(至少 15-30 次转化)数据足后 :切换到 Max Conversions 或 Target CPA (目标单次转化成本 $50 = 你定的 conversion value 的 50% 左右)稳态后 :切到 Target ROAS (目标 400% 起步,逐步上调)
上线后 7 天观察期 :每天看一次,有明显烧钱的关键词当天就暂停。第 8 天开始走「② 每周工作流」。
⑤ AI 工具会怎么帮你
你可以在 → AI 对话 里直接说人话,AI 会调下面这些工具:
ads_list_snapshots — 列我上传过哪些 CSV 快照ads_get_snapshot — 取某一份的详细数据ads_compare_snapshots — 对比两份快照,出"涨了哪些跌了哪些"ads_top_waste — 找烧钱 0 转化的关键词 / 地区 / 时段generate_ad_plan — 让 AI 基于你的网站 + GA4 + GSC 数据 反推:"以现在 wintouch 站的流量结构,如果给我 $1500/月 预算,你建议怎么分到 Campaign + Ad Group?"
实战例句:
"对比本周和上周的 Google Ads 数据,告诉我有什么需要砍的"
"看一下本周 wt707 这个 Campaign 的转化率,跟上周比怎么样"
"基于我网站近 30 天 GA4 + GSC 数据,给我做一个 $2000/月 的 Google Ads 投放方案"
"找一下花了钱没出转化的关键词 Top 10"
⑥ 常见坑(踩过就记得)
没装 Conversion Tracking 就开广告 :你看到 1000 次点击 0 转化,以为是关键词差,其实是没记数据。装了之后所有 ROAS 才能算 。否定词清单不更新 :每周「浪费分析」找出的烂搜索词,如果不加进否定词,下周还会再来烧一遍。批量加,每周加 10-20 个 。Broad Match 关键词放飞自我 :Broad Match(广泛匹配)在 Smart Bidding + 没装 conversion 的组合下会乱花钱。新账户先用 Phrase Match 或 Exact Match ,Broad 留到有 100+ 转化数据后再开。预算用 Campaign 级而不是账户级 :不要给整账户设 $50/天 — 一个 Campaign 烧光后另一个根本没机会跑。每 Campaign 独立预算 。过早 Target ROAS :没有 30+ 转化数据就切 Target ROAS = Smart Bidding 没样本可学,会把展示压到几乎 0。先 Max Conversions 跑到 ~30 转化再切。登陆页和广告文案不一致 :广告说 "WT707 - $99",落地页根本找不到 $99 → Quality Score 暴跌 + 用户立刻退出。广告里说什么,LP 第一屏就要看到什么 。追每天波动 :Google Ads 不是炒股,单日 ±30% 转化波动很正常。用 7 天滚动平均看趋势 ,本系统的"对比上周"就是这个用途。
开播第一个月 关键指标 节奏
第 1 周 :目标只有一个 — 有 5 次转化进系统 。验证整个链路。第 2 周 :转化达 15 次,Cost per Conv. < $80 算正常起步。否定词第一轮清理。第 3 周 :Conversion Rate 应该爬到 1.5%+,LP 太差就开始改。第 4 周 :30+ 转化数据后切 Max Conversions,开始固化"哪个 Campaign 是赢家"。第 2 个月 :赢家 Campaign 加 50% 预算,烂的暂停。第 3 个月 :稳态后切 Target ROAS,瞄准 ROAS ≥ 4。
不要做的事 :不要相信「Google Ads 客服」打电话给你的"优化建议" — 他们 关键指标 是让你花更多钱,不是帮你赚钱。所有调整决策走本系统的对比 + 浪费分析 双重验证,再动手。
常见问题
Q: 上传 PDF 文件后没解析出文字？
如果 PDF 是扫描件（图片版），当前解析器抓不到文字。临时方案：用 macOS Preview 或 Adobe 把 PDF 重新导出为"可搜索"版本（OCR 转文字层）。
Q: 客户画像 出来后觉得不准？
检查 客户画像 卡片右上角 footer：语料 XXXX 字符 · 价值主张佐证率 X/Y。语料 < 2000 字符就太薄 → 补充上传更全的产品手册重跑；佐证率 < 50% → AI 在编 → 同样需要更多原文。
Q: 自动运行启动失败提示 SERPER_API_KEY 未配置？
去 serper.dev 注册（免费 2500 次/月），到 设置 → API 密钥 面板填入 SERPER_API_KEY,保存即生效(无需改 .env / 重启)。
Q: prospect 池一直显示 0？
看 timeline 里的 search_done 事件：
raw=0 → 关键词没结果，可能太窄太长 / 目标市场没买家。换更宽的关键词种子。raw > 10 但 deduped=0 → 全是同一公司不同页面的 dup。正常。errors > 0 → Serper API 失败，查 extract_done 详情。
Q: 邮件序列评分都偏低？
查 review.locale_check.issues：
"formality inconsistent" → 客户画像 里写的目标国家可能和 prospect 实际语种不匹配（比如把比利时归到了 fr_FR 但官网是德语）
"awkward translation" → 用更强的 LLM 重跑（在「模型配置」切到 Claude Opus / DeepSeek R1）
Q: 怎么知道 AI 对话用了哪个工具？
每个 AI 回复上方会显示橙色"工具调用"小卡片，点击展开能看见输入输出。"思考过程"折叠在「▸ 思考过程」按钮里（只有推理模型如 DeepSeek R1 才有）。
Q: WordPress 文章只显示 20 篇？
已修复。文章 / 产品 tab 现在带翻页器，默认 50 条/页，可切到 100。看不到完整数据时翻末页或调每页数量。
— AI 可见度模块 FAQ —
Q: 内容腐烂检测把所有文章都标成 dead，我的站完蛋了？
几乎都是数据问题，不是内容问题。看快照顶部"数据质量提示"：
GA4 历史数据不足 28 天 → GA4 刚接入，没有上一个 28 天周期的对比基线。系统只能按当前流量绝对值判断，等数据攒够 8 周再扫一次。GSC 未连接 → 缺搜索曝光信号，分类会偏严。配置 GSC 后准确率会上来。GA4 路径与 WP 链接对不上 → 多语言前缀（/en/、/de/）可能让 GA4 数据落到不同 bucket。需要做 path 别名映射（v2 加）。
Q: AEO 引用率检查显示 0%？
三种可能：（1）问句太宽 → 改成更具体的长尾问句，比如把 "best tablet"换成 "best rugged tablet for construction Germany"；（2）品牌名/域名 LLM 不认识 → 在 .env 设 GROWTH_BRAND_NAME=Wintouch；（3）真的没被引用 → 这就是你要解决的问题 — 看竞品被引用的内容，跟着补 llms.txt + Schema + 高质量长内容。
Q: Schema 注入会动 WP 文章正文吗？怎么撤回？
会，把 JSON-LD 包在 HTML 注释 marker 里追加到正文末尾：<!-- aiagent-schema:start type=Article post=162 --> ... <!-- aiagent-schema:end -->。撤回：到 Schema tab 点"体检"那篇文章，按"移除"按钮，或直接调 POST /api/schema/remove?post_id=X&schema_type=Y。marker 是精确边界，移除不会误伤 RankMath / Yoast 的 Schema。
Q: llms.txt 怎么部署到站点？
AEO tab 点"生成 llms.txt" → 复制文本 → 在 WordPress 安装 "Code Snippets"或类似插件，加一个 PHP snippet：
add_action('init', function(){
或者更简单 — 上传到站点根目录的静态文件（用 FTP / cPanel 的文件管理器），路径 /llms.txt。注意：每次新发文章后建议重新生成 + 上传。
Q: Clarity tab 一直显示"未配置"？
这是预期行为。到 clarity.microsoft.com 注册项目，把 tracking script 装到 wintouchcn.com，然后到 Settings → Data Export 拿 token 和 project ID，写进 .env 重启容器。
Q: 一篇文章同时被注入 Article + FAQPage 会冲突吗？
不会。Google + AI 引擎都支持单页多个 JSON-LD block，marker 系统按 type + post_id 双重去重，每个类型只保留最新一份。
— 询盘智能中枢 FAQ —
Q: 启发式分级 vs LLM 分级,哪个准?
两个互补,不是替代。启发式是 毫秒级、零成本、信号透明 (能看到为什么这条被判 A),适合过滤垃圾 + 给出初判 ;LLM 看完整语境(语气、潜台词、买家阶段),适合给出 followup 建议 + summary 摘要 。最佳实践:批量启发式过一遍(免费) → 高价值的再单条 LLM 评分。
Q: 启发式把高价值询盘判成 spam 怎么办?
展开询盘看启发式信号面板,看是哪个 spam 关键词触发的。如果是误伤,把那条 lead 状态手动改回 "new"然后点 "AI 评分"让 LLM 重判。如果发现某个关键词频繁误伤,告诉我可以从 spam 词库里删掉。
Q: 批量 LLM 会不会一次性烧爆 token?
不会,有三层保护:(1) 限制 limit=200/次;(2) Spam 自动跳过(置信度 ≥ 0.85 不走 LLM);(3) 每条之间 sleep 150ms 避免 rate limit。100 条询盘里如果 30 条垃圾,实际 LLM 调用 70 次。后续如果想严格控成本,在 .env 里把 model_key 锁定到便宜模型(比如 deepseek-chat),整体成本 ≈ 70 × ¥0.001 = ¥0.07。
Q: 国家是怎么推断的?
三层优先级:(1) 表单填的 country 字段 → 直接用;(2) 邮箱域名 ccTLD(如 .de → Germany、.uk → UK、.jp → Japan)→ 覆盖 60 多个国家;(3) 电话区号(如 +49 → Germany、+1 → US)。三层都没命中就留空。
Q: T1 市场是什么?
在国际 B2B 工业品语境下,T1 = 一线发达市场,采购预算稳定、付款可靠、合规要求高。我们的 T1 名单:北美(US/CA)、西欧(DE/UK/FR/IT/ES/NL/BE/CH/AT)、北欧(SE/NO/DK/FI)、大洋洲(AU/NZ)、东亚发达(JP/KR/SG/HK)、中东富(IL/UAE)。从 T1 来的询盘启发式打分会 +10。聚合洞察的"T1 占比"是询盘质量的领先指标 — 占比涨说明品牌正打动正确市场。
— SERP 排名追踪 FAQ —
Q: 和 GSC 有什么区别?为什么不直接用 GSC?
GSC 是 Google 报告给你 :延迟 2-3 天、基于真实用户搜索点击、有曝光量数据。SERP 追踪是 你主动去查 :实时、不需要真实用户点击就能看到排名、能看到 top 3 竞品是谁。两个互补:GSC 告诉你什么关键词带来流量 ,SERP 追踪告诉你具体关键词排在第几位 + 跟谁打架 。最佳实践:GSC 找关键词,SERP 追踪重点监控其中 50-100 个核心词。
Q: SERPER_API_KEY 怎么开?贵吗?
去 serper.dev 注册,免费送 2500 次/月,够监控 80 个关键词每周扫一次(80 × 4 = 320 次)。$50/月 是 50,000 次,足够监控大几百个关键词每天扫。Key 拿到后到 设置 → API 密钥 面板填入 SERPER_API_KEY,保存即生效(无需改 .env / 重启)。Hunter 获客和 SERP 追踪共享同一个 Serper 额度。
Q: 关键词加多少合适?
B2B 工业平板典型组合(共 ~60 个):
品牌词 (2-5 个):wintouch / wintouch tablet / wintouch industrial pc — 看品牌排名稳定性产品大词 (8-12 个):industrial tablet / rugged tablet / panel pc android — 难度高但 投入产出 高产品长尾 (20-30 个):rugged industrial tablet RK3588 / 15 inch panel pc Android 13 — 实际订单来源问题型 (10-15 个):best rugged tablet for warehouse / industrial panel pc 24/7 — AI Overview 引用源市场区分 :同一关键词在 us / de / uk 三地各加一遍,看不同市场表现差异
Q: 排名突然掉很多怎么诊断?
查 4 件事:(1) 看"7 天跌幅 TOP"列表锁定受影响关键词;(2) 点"趋势"看是骤跌还是缓跌(骤跌可能是 Google 算法更新,缓跌通常是竞品超车);(3) 看竞品列 — 是同一个竞品在所有词上爬升吗?那就是它的整体 SEO 在打你;(4) 跟 内容腐烂检测 交叉看 — 跌位的关键词页面是不是同时也在 decaying?那就先 refresh 内容。
Q: TOP 1 显示的竞品 URL 能干嘛?
这是竞品研究的免费入口 。点开看他们的标题怎么写、内容结构怎么搭、Schema 用了什么、有没有 FAQ 块、文章多长。然后:(1) 用 AEO 引擎单页评分对比你的同主题页面 vs 竞品页面;(2) 找到你们的 gap,在运营任务 里建任务补齐;(3) 一个月后再扫 SERP 看排名有没有动。这就是用 SERP 数据闭环驱动内容优化的核心打法 。
— 竞品监控 FAQ —
Q: 跟 Growth 雷达模块的"竞品"有啥区别?
Growth 雷达是用 AI 询问 + 公开网络搜索 给竞品打概述性的画像(品牌定位、关键卖点、SEO 关键词覆盖);竞品监控是结构化、可追踪、有时间维度的实操工具 。两个互补:Growth 帮你识别"谁是竞品",竞品监控帮你"日常盯着这些竞品"。
Q: 不爬全站是不是会漏掉重要页面?
B2B 工业站 99% 的产品页和博客都在自家 sitemap 里(因为他们也想被 Google 收录)。漏掉的通常是 (a) 没放进 sitemap 的内部测试页 — 你也不需要看;(b) 故意排除的旧产品 — 价值也低。如果某个核心竞品压根没 sitemap(罕见),我们后面可以补 "manually add URLs"功能补救,但这种情况下你可能整个监控思路要变(用 changelog 监控之类)。
Q: 用什么 User-Agent?会被 WAF 误杀吗?
UA 显式标识:WintouchAgent/1.0 (+https://wintouchcn.com; competitive-watch-bot; contact: kenwintouch@gmail.com)。这是"我是谁、来干嘛、不爽给我发邮件" 的正派写法 — 大多数 WAF(Cloudflare、Akamai)看到结构化的合规 UA 不会乱拦;遇到拦截会显示 403,扫描结果的 error 字段里能看到。如果发生你想用某竞品的扫描,告诉我可以加 per-竞品 UA 覆盖。
Q: 多久扫一次合适?
B2B 工业品上新节奏慢(产品 3-6 个月一波,博客 1-2 周一篇),所以每周扫一次足够 。强烈不建议每天扫:(1) 浪费(每天扫 10 个站等于每周浪费 60 次请求);(2) 不礼貌(频率太高对 sitemap 服务器有压力 — 虽然轻,但累积下来对方运维会注意到)。建议:每周一固定时间跑批量扫描。
Q: 拿来的竞品数据法律上有问题吗?
没问题。我们只读对方主动公开发布 的 sitemap.xml 和 RSS feed — 这两类文件存在的目的本来就是"让爬虫和别人读";UA 公开标识,频率克制,不模拟人类操作,不规避反爬,不抓登录后内容,不抓商业接口。这是典型的合规竞争情报 。和市场上的 Ahrefs/SEMrush/SimilarWeb 做的事 100% 同等级别。
Q: 扫描完竞品 pages_total=0 是不是坏了?
大概率不是 bug,是这家公司的 sitemap 放在非标准路径。常见情况:
多语言企业站 (Advantech、SIEMENS 这种):sitemap 在 /en-us/sitemap.xml 而不是 /sitemap.xml。这种站当前版本没法自动找到。Workaround:加他们某一个语言子域名(如 en.advantech.com)。Cloudflare/Akamai 反爬严格的站 :直接给你 403。看扫描日志里的 error 字段。SPA 单页应用 (罕见的现代 B2B):压根没 sitemap.xml,内容全靠 JS 渲染。Workaround:暂时只能放弃监控,或者用别的渠道(看 LinkedIn 公告、行业新闻)。
实测案例:Winmate 一扫 500 页 OK,Advantech 0 页(/sitemap.xml 跳到 404 页),Touch International 视服务器配置而定。
Q: 500 页是不是被截了?
是。_MAX_PAGES_PER_SCAN=500 是硬上限,防止 5 万页大 sitemap 一次性把 SQLite 撑爆。500 页足够看出"新发了什么"(B2B 工业品就算最大厂一年也发不了 500 个产品)。如果某个竞品确实需要全量,告诉我可以调整上限或者改成多次增量扫描。
生产运维
备份
每日凌晨自动备份到 /data/backups/wp_agent_YYYYMMDD.db，保留 30 天
每周日自动 VACUUM 回收空间
状态查询：curl http://127.0.0.1:8010/api/health/db 看 latest_backup 和 last_vacuum_at
恢复：把要恢复的 .db 文件覆盖到 /data/wp_agent.db 然后重启容器（会丢 in-flight 的 hunter run 进度）
查日志
docker logs -f wp-ai-agent # 实时
重启 / 升级注意
重启会杀掉 in-flight 客户拓展 ：被中断的 hunt 会自动标 failed: auto-run interrupted by restart，前端不会卡 spinner会话不会丢 ：登录 session 存在 DB，重启后用户不用重新登录不能加 worker 副本 ：内存里有状态（pending_actions / hunt task / 模型 client），单 worker 是硬约束
数据库会爆吗
SQLite + WAL 模式，5-10 用户 + 1GB 文件以下完全够用。瓶颈出现的临界点：
DB > 5GB → 考虑 hunt_prospects 归档（90 天前的搬到 *.archive.db）
DB > 20GB → VACUUM 会卡几分钟，建议夜间手动跑
用户 > 50 → 整体迁 PostgreSQL（大工程）
机器调用 API
curl -H "Authorization: Bearer $ADMIN_API_TOKEN" \\
Bearer 令牌 = ADMIN_API_TOKEN，机器身份等同 admin，绕过用户名密码、绕过 session。
给别的企业部署 · 镜像交付规范(productize · 仅 tech 可见)
给客户企业部署走 productize 分支 + 只交付 Docker 镜像 ,不给源码仓库。四条铁律 + 交付要点:
① 镜像只放程序 :配置(.env.production)、数据(/data volume:SQLite / RAG / workspace)全部挂宿主机 — 升级换镜像,数据配置永远不动。本系统 compose 已按此设计,照抄即可。② 有状态服务独立部署 :Qdrant 单独容器;主库 SQLite 是嵌入式(文件在 volume 里即正确姿势,不要 误拆);客户要多实例/高并发才迁 PostgreSQL(大工程,单 worker 是现架构硬约束)。③ 环境变量区分环境 :ENVIRONMENT=production + 全部密钥走 env,运行时可改的进设置面板(EDITABLE_SETTING_KEYS)。每客户一份 .env.production,镜像通用。④ 私有仓库分发,不传 tar :推 GHCR(GitHub 私有 registry,发只读 pull token)或阿里云 ACR(国内客户拉取快)。好处:升级只拉增量层(不是每次 2GB)、tag 即版本、回滚=换 tag。客户机无外网时才用 docker save | gzip tar 包兜底。
源码保密要单独做 :镜像里 .py / index.html 是明文,docker export 就能读走。交付前用 delivery 专用 Dockerfile:compileall 编译后删全部 .py 只留 .pyc + 剔除 tests / docs / deploy 脚本 / README。挡住 95% 场景;要 100% 不泄码只有托管模式(客户只拿账号,实例跑在自己 VPS)。授权控制是空白 :镜像交出去客户可永久跑、可复制给第三方,目前无 license 机制 — 签约时靠合同约束,重要客户上量前补 license key 校验。构建平台 :客户服务器基本是 x86,Mac(ARM)上要 docker buildx --platform linux/amd64,或直接在 x86 服务器上构建。交付清单 :镜像(registry 地址+tag 或 tar)+ docker-compose.production.yml(改 image: 不留 build:)+ .env.production.template + nginx.conf + tech 引导账号 env(TECH_USERNAME/TECH_PASSWORD)+ FERNET_KEY(业务员邮箱密码加密,必配)。
多客户托管 · 机群运维方案(单客户独立服务器 · 仅 tech 可见)
商业模式:你托管、客户买使用权、年费订阅、每客户一台独立服务器 。隔离拉到物理服务器级(比容器隔离硬,企业采购强卖点)。要解决的不是容器编排(K8s 杀鸡用牛刀),是机群编排 :把「对一台服务器做的事」可靠、批量、幂等地对 N 台做。反直觉的好消息 :比"一台机多实例"更容易——每台跑的就是现有单实例,compose / deploy.sh / 容器名端口全部原样,只需新增「站在外面同时操作 N 台」的控制层,compose 参数化整个不用做。
拓扑 :一台控制机 (专用小机,持代码仓库 + fleet.yaml 机群清单 + 密钥保险库 + 机群脚本,不跑业务)→ SSH → N 台客户机(各自 app+qdrant+nginx+autoheal 四容器、独立域名证书、专属 .env 与 tenants/{客户}.json)。一台被黑/宕机,爆炸半径 = 一个客户,物理封死 。fleet.yaml 是单一事实源:每客户记 host / ssh / tenant / tier / status / llm_cap / seats / region,所有脚本遍历它。
机群控制层 5 个能力:
① provision.sh (裸机→可运行,开客户的大头):装 Docker+加固(防火墙 22/80/443、fail2ban)→ 拉码 → 密钥全自动强随机 (FERNET_KEY/ADMIN_TOKEN/密码 openssl rand 生成,永不手填,加密备份进保险库)→ 渲染 tenant json → certbot 证书 → up -d 健康门控 → 登记 fleet.yaml。安全焊进流程,每台天生安全不靠记性。② deploy-fleet.sh (一次改码滚动升全群):遍历 active 客户逐台 rsync + 远程跑现有 deploy.sh。铁律三件套:灰度 (--canary 先升一台观察)+ 失败隔离 (一台失败自动回滚不阻断其余)+ 自动回滚 。"一次坏更新打翻所有客户"是机群头号事故源。③ status.sh (机群总台):并行拉每台 /api/health/db + 磁盘/内存/本月 LLM/版本/证书到期,一屏看全。客户过 5 台后控制机架 Uptime Kuma 集中探活推手机/飞书 — 出事你先于客户知道。④ backup-fleet.sh (异地备份):每台本地热备(现有 db_maintenance)+ 控制机归集或各自推 S3/R2,按客户分目录带保留策略含 secrets。托管模式下数据丢了是你赔 ,每台独立异地备份是底线。⑤ ssh-config 生成 :从 fleet.yaml 生成别名,ssh acme 直达。
工具选型 :Bash + SSH 循环起步(≤5 台,零依赖复用现有 deploy.sh)→ 客户过 5 家迁 Ansible (幂等/并行/声明式,fleet.yaml 第一天就按 inventory 兼容格式设计,过渡零摩擦)。不要一上来就 Ansible — 先用脚本把逻辑跑通踩完坑。
生命周期与计费护栏 (fleet.yaml 的 status 驱动):
suspended(欠费) :直接关机 而非仅停容器 — 云厂商停机只收存储费,欠费几个月成本近零,续费一键开机恢复。这是独立服务器独有的省钱红利。archived(注销) :先导出全量数据交付客户 + 归集末次备份,再销毁整机(零残留),移出 fleet.yaml。档位封顶 (provision 时写进该台 .env,复用 llm_monthly_budget_usd / apollo_daily_*_cap / 席位):Starter $30/月 LLM · 50 Apollo/天 · 2 席 · 2核4G;Pro $100 · 200 · 5 席 · 4核8G;Enterprise 自定义 · 4核16G+。必修硬伤 :LLM 月度熔断目前不覆盖 AI 对话主路径 (chat/autonomous 绕过预算闸)— 托管收费下档位上限形同虚设,重度对话客户能烧穿毛利,必须在 P2 修掉,这是计费模式的地基。
成本模型 :4核8G 约 ¥200–400/月;单客户年成本上限(服务器+LLM 封顶)≈ ¥1–1.3 万/年 ,对数万年费毛利结构健康,物理隔离与数据主权是溢价卖点。机房就近客户市场(欧美→SG/HK/日本),兼顾 LLM API 延迟。
路线图(全程不碰现有生产;P1 在全新测试机验证) :
P1 能开 (~3–4 天):provision.sh + fleet.yaml — 一条命令裸机变客户实例,密钥全自动。P2 能管 (~4–5 天):deploy-fleet + status + backup-fleet + 修预算熔断 。P3 能收 (~2–3 天):suspend/resume/offboard + Uptime Kuma 主动告警。P4 加固 (~4–6 天):Ansible 化 + 审计收口(CSP 头 / 行级越权 / SSRF 黑名单 / 审计日志导出 — 企业客户会要)。
已定推荐 :控制机=专用小机(密钥别和客户机混)· 域名先给 客户.trademaxtech.com 子域 · 云厂商统一一家 · Qdrant 每台独立 · 密钥保险库起步用 age/gpg 加密文件 · Bash 起步过 5 台迁 Ansible · 现有生产先并存后纳管。完整方案存档:~/Desktop/TradeMax-多实例托管运维方案.html(v2.0 · 2026-07)。
路线图 · 已上线与在路上
已上线(到 2026-07)
询盘漏斗(启发式 + LLM 双段分级 · spam 聚类 · 自动分配 RR / 整队轮询 · 客户管理 看板拖拽 · 跟进任务 · 发件服务器 一对一回信 · per-user 发件服务器)、团队管理(销售小组 / 老板团队看板 / 周报量化看板)、AI 对话(多专业 persona，含SEO 与 AI 搜索总监、客户背调 + 5 道真实性防线 · 历史持久化 · 多模型可切)、客户拓展 Hunter(客户画像 → 自动搜索 → 抽取 → 3 步序列 · admin 审批)、AI 可见度(Schema 注入 · AEO 引用追踪 + 自动 cron · SERP 排名 · 内容腐烂检测 · llms.txt 生成 + WP 反代缓存 · 竞品监控 · 反向链接 gap 分析)、运维(Token 监控 · 运行复盘 · 冷归档维护 · 用户自助改名)。
2026-07 新增 :定时任务(cron 让系统自己跑:周报 / AEO 巡检 / 按模板获客,agent 指令类写操作自动落确认队列)、外呼激活层(序列审批 → 入队 → day0/3/7 滴灌 · 30 封/天上限 · 退订行 · 客户一回信自动停发 ,默认关)、LinkedIn/Apollo 第二获客链路(全局去重 · 购买信号优先分 · 业务员自助/批量解锁,每人 20 次/天 )、产品 SEO 字段后台化(SEO tab 四字段 + 模板回退)、tech 技术运维角色 (API 密钥/模型配置收归厂商)、Google Ads CSV 分析闭环(总结/对比/否词导出/建议转任务)、对话隔离(按用户归属)。
在路上
方向 内容 状态
Google Ads 数据接口 OAuth 已上,等 dev token 审批后接 GAQL 拉 campaigns / keywords / search_terms + AI 投流建议。CSV 路径已能跑分析 (→ Google Ads ) 等审批 外呼滴灌开闸 发送队列/滴灌/回信自停/退订行都已上线但默认关 。打开前必须完成下方红框 4 项安全准备(发件域声誉是一次性资产) 等开闸决策 合规 footer 补全 退订行已有;还差强制物理地址 + EU prospect 人工确认 待做 背调升级 海关数据接入(52WMB / ImportYeti / Panjiva,¥200-600/月)+ 决策人邮箱(Hunter.io / Apollo,$49+/月)— 等运营拍板付费 观察(付费) 异地备份 SQLite + Qdrant + secrets 自动 S3 异地备份 观察
外呼滴灌(outreach_auto_send_enabled)开闸前必须做的安全准备
独立子域(如 out.wintouchcn.com)配 SPF / DKIM / DMARC,跟主站隔离
2 周 IP warm-up:从 20 封/天慢慢提到 200 封/天,新 IP 直接群发会被列入黑名单
发件服务器_DRY_RUN=true 默认开,admin 在 staging 把每一步链路跑通后才打开真发邮件 footer 强制物理地址 + 退订链接(法律硬性要求,CAN-SPAM / GDPR 都有)
指南最后更新：基于 commit {{guideCommitHint}}