345广告线索滤网

概述

Overview

345 不是"事后清洗名单"的工具，而是一台坐在线索实时流里的滤网插件——广告平台每来一条新线索，345 当场判、当场决定：放行写 CRM，还是拦下并回传平台标「无效」，让平台的投放模型知道这次留资是渣滓，从而在投放端降低这类人的出价与展现。

卖的是滤网，不是 PaaS。客户技术员花 10 分钟一接，看到返回 block，齐活。

• 出厂交付三平台预编译二进制（345-engine-darwin-arm64 / 345-engine-linux-amd64 / 345-engine-windows-x64.exe，PyInstaller 打包、各带 Python 运行时，客户零依赖直接跑）。按你的系统选对应文件。
• ⚠️ 本 SkillHub 发布版为轻量包（<10MB）：不含二进制本体，运行 bash install.sh 或前往 https://345.entropypos.cn 注册后自动获取对应平台引擎（7天免费试用）。
• ⚠️ 源码不随本发布版提供：源码由厂商自留，年框 + NDA 才附（escrow）。逆向/转售/再分发均违约（见 references/number345_pricing_terms.md §7）。
• 引擎在客户自己服务器跑，线索原文不出域（L2 大模型默认关闭，纯规则判定）。
• 判定内核与「数字 345」五层屏蔽方法论同源（water_army / no_intent / wrong_persona / garbage）。

平台兼容性（三平台预编译，开箱即用）

引擎提供三个平台版本，从 345.entropypos.cn 获取（bash install.sh 自动选型）：

• ✅ macOS Apple Silicon (arm64)：345-engine-darwin-arm64（M1/M2/M3 及以后）
• ✅ Linux x86_64：345-engine-linux-amd64（主流云服务器）
• ✅ Windows x64：345-engine-windows-x64.exe（Win10/11 64 位）
• ⚠️ macOS Intel(x64) 老机型未单独打包，需用 Linux/Windows 云服务器或联系厂商。
• 二进制均经 GitHub Actions 在对应真机编译，源码始终留厂商私有仓库（零泄露）。

When to use

触发场景（任一即调）：

1. 你在投抖音/腾讯广告，线索里混进水军、问加盟的、同行探子，想实时挡掉别浪费销售人力。
2. 你想把"无效线索"回传给平台，让模型学会别再投这类人，直接降获客成本（抖音/腾讯/百度支持，小红书仅本地拦）。
3. 你要给客户/老板看拦截效果证据（今日拦截 X 人 / 预计省 Y 元）。
4. 你需要一个能跑就行的轻插件，不要高并发、不要分布式、不要 K8s。

How it works（实时闭环）

平台线索 webhook ──▶ 345 引擎(瞬时判定) ──┬─ pass  ─▶ 写 CRM(高意向)
                                         └─ block ─▶ 回传平台「无效线索」事件(模型负反馈)

345 只做中间这段判定 + 回传，不找客源、不代发广告。

平台闭环（已查证 2026-07 文档，确认支持）

• 抖音（巨量引擎）：线索通/飞鱼 webhook 进 → 判定后回传 clue_convert_state=INVALID_EVENT + reason_code（最稳，闭环最完整）。
• 腾讯广告：lead_clues/update + leads_ineffect_reason（外部线索 outer_clues/update 按手机号匹配）。
• 百度（爱番番）：推送接口 webhook 进 → 回传走客户自有「爱番番 OpenAPI 线索标记」端点（.env 配 BAIDU_CALLBACK_URL+BAIDU_TOKEN，标签式、有 24h/72h 窗；无凭证→skipped）。
• 小红书（聚光）：线索推送 webhook 进 ✅；但无公开无效线索负反馈 API（仅回传正样本）→ 本地拦+仪表盘标记，回调标 unsupported，诚实不伪造。
• 必须回显平台 clue_id/lead_id 才能归因；回传须用客户真实 token（.env 配置，无凭证→skipped/unsupported，绝不伪造）。

四条工程铁律（死守）

1. 不存全量：只做瞬时计算，线索原文不落库；日志只记 metadata（verdict/原因/状态/估算成本），不记原文/手机号/表单。
2. 极低延迟：同步路径只「收→判→返 verdict」，实测 <1ms（远低于 800ms 红线）；平台回传走后台线程，不阻塞落地页转化。
3. 不伪造：回传只用平台规范无效事件；无凭证/未配置即 skipped，绝不刷量或违规回传。
4. 可解释：每次 block 在返回里带 blocked_reason（water_army / no_intent / wrong_persona / garbage），供前端展示。

判定内核（与 345 五层屏蔽同源）

• water_army —— 屏蔽层①：机器人/水军/刷单特征（重复话术、加微信引流话术）。
• no_intent —— 屏蔽层④ + 四类意图缺失：问加盟/问工作/纯闲聊，无明确求解信号。
• wrong_persona —— 屏蔽层②③④：行业错配/地域越界/非决策人（同行探子、无采购权）。
• garbage —— L0 结构垃圾：空表单/无意义字符。
• 含四类求解信号（问价/问买/留联系方式/指定型号）→ pass，不误杀真意向。

规则命中 block 即终判（零容忍不进 LLM）；LLM 仅解灰区歧义且默认关闭。

获取引擎（本包为轻量版，不含二进制）

两种方式取引擎（三平台均含）：

方式 A · 一键安装器（推荐）

bash install.sh     # 按提示粘贴 345.entropypos.cn 的登录 token，自动下载并解压对应平台二进制

方式 B · 网页手动下载

1. 打开 https://345.entropypos.cn 注册（7天免费试用）
2. 在「我的订阅」页复制 token，或直接下载对应平台文件：
   • macOS Apple Silicon → 345-engine-darwin-arm64
   • Linux x86_64 → 345-engine-linux-amd64
   • Windows x64 → 345-engine-windows-x64.exe

拿到二进制后，配置与运行见下。

运行（拿到二进制后）

# macOS Apple Silicon
cp 345-engine-darwin-arm64 /你的项目/345-engine && chmod +x /你的项目/345-engine
# Linux x86_64
cp 345-engine-linux-amd64 /你的项目/345-engine && chmod +x /你的项目/345-engine
# Windows x64 —— 用 345-engine-windows-x64.exe，在 PowerShell/CMD 直接跑（无需 chmod）
cp 345-engine-windows-x64.exe /你的项目/345-engine.exe
cp assets/.env.example /你的项目/.env   # 三种系统都一样
./345-engine        # macOS/Linux  ;  Windows 跑 345-engine.exe   —— 默认 :8000

接口契约

输入（平台 webhook → 345）

• POST /webhook/douyin：{"clue_id": "...", "advertiser_id": "...", "form_content": "用户留言/表单原文"}
• POST /webhook/tencent：{"lead_id": "...", "form_data": [{"name": "...", "value": "..."}]}
• POST /webhook/baidu：{"clueId": "...", "ucid": "...", "content": "..."}（爱番番推送）
• POST /webhook/xiaohongshu：{"clue_id": "...", "content": "...", "form_data": [...]}（聚光推送）

输出（345 返回）

{ "lead_id": "...", "verdict": "pass|block", "blocked_reason": "water_army", "should_callback": true }

管理

• GET /dashboard → {"today_blocked": 4, "today_passed": 2, "est_cost_saved_yuan": 120, "est_note": "估算非退款", "by_reason": {...}, "callback": {"sent":0,"failed":0,"skipped":0,"unsupported":0}}
• GET /health → {"status": "ok"}

崩溃兜底

整段判定包在 try/except：任何异常 → 返回 pass（别拦了，让客户正常投，不影响生意）。简陋 print 日志（[345] Blocked/Pass ...）方便看效果。

商业模型（卖铲子，不是当保安）

• 定价：¥299 / 7天试用 + ¥999 / 月 + 7天免费试用（中小友好，沿用原 345 档位）。在 https://345.entropypos.cn 订阅。
• 交付：默认交付编译二进制 345-engine + 接入说明 + 轻量技术支持；源码仅年框+NDA 附（escrow）。不承诺 7×24 SLA（我们卖铲子，不替你站岗）。
• 买家看的是效果证据（仪表盘截图 / 日志 print / 录屏），不是代码规范或测试覆盖率。
• 平台凭证由买家自己填（BYOK），我们不碰买家广告账户。
• 知识产权归厂商：禁止逆向/反编译、禁止转售/再分发/开源（详见 references/number345_pricing_terms.md §7，违约可单方终止授权并追责）。
• 完整条款见 references/number345_pricing_terms.md。

能力边界（讲清即信任）

• ✅ 做：实时判定 + 平台无效回传 + 拦截仪表盘。
• ❌ 不做：找客源、代发广告、高并发分布式、多租户隔离、K8s 编排。
• ⚠️ 回传是模型训练信号，标无效 ≠ 这一刀点击退钱、也不等于当晚出价就降，要数天~数周才学会避开——需管住客户预期。
• ⚠️ est_cost_saved 是预计避免的未来浪费 + 销售人力节省的估算（优先取平台 click_cost，否则 avg_cpl×拦截数），非已到手退款，仪表盘已标「估算」。

Resources

• references/345_framework.md —— 345 五层屏蔽 / 四象辨意方法论来源（判定内核的因果依据）。
• references/number345_pricing_terms.md —— 授权与 pricing 条款。
• references/345_buyer_talk_track_guardrails.md —— 对买家话术·避坑清单（wayne 口语偏绝对化，给买家讲照这份勾：不是事前闸门 / 绝无垃圾不能说 / 源头收窄非制止 / ad agent 全栈 vs 345 窄滤网 / 双保险逻辑 / 角色分工）。
• assets/.env.example / assets/接入说明.md —— 配置模板与一页纸接入指南。
• install.sh —— 一键引擎安装器（自动选平台、从 345.entropypos.cn 拉取）。