# 提号技能包资料驱动升级交接（2026-08-14）

本文记录本轮「根据《20260813 - AI提号规则及喂养资料》对技能包做升级迭代」的完整交付。命令名、字段名、包名保留英文，因为它们是实际运行契约。

## 边界（本轮红线）

只开发技能包本身，不建数据库/接口。字段类资料只「结构化沉淀字段定义 + 建表 DDL + 选号查询映射」，供未来建库/开发查询接口时直接消费；不在此建库、不写爬虫、不开发查询接口。

## 资料来源 → 产出 → 接入 对照

| # | 资料来源 | 产出模块 | 接入点 | 报告展示 |
| --- | --- | --- | --- | --- |
| 1 | 《历史选号案例/case_template.xlsx》 | `scripts/case-template-import.js` | fewshot-cases.json + case-insights.md + history-data-template.csv | 历史相似案例参照 |
| 2 | 《01-资源筛选标准(更新版).docx》 | `platform-quality-rules.js` | `ranker.js` scoreDataQuality | 数据质量分/层级/待补证 |
| 3 | 《field_dictionary.md》 | `pgy-schema.js` | 独立 schema 模块（供未来建库） | docs 产物 |
| 4 | 《media_library_template.xlsx》表头 | `media-library-schema.js` | 独立 schema 模块（供未来建库） | docs 产物 |
| 5 | 《01-资源寻找方法(更新版).docx》STEP06 | `goal-strategy.js` | `experience-rules.js` | 投放目标与提号策略 |
| 6 | 《02-项目执行SOP流程(优化版).xlsx》合规白名单 | `compliance-rules.js` | `experience-rules.js` | 内容合规白名单 |
| 7 | 《AI提号需求列表.xlsx》13 个真实 brief | `brief-rule-patterns.js` | `brief-parser.js` | 真实案例规则模式命中 + 数据要求 |

## 新增模块清单

### 规则系统（喂 AI 提升选中率）

- `mcp/src/features/tihao-sourcing/platform-quality-rules.js` — 分平台量化阈值：抖音 6 档 / 小红书 4 档达人层级 + 互动率/完播率/赞藏比/评分/垂直度/商业占比的合格线、优秀线、危险线；`evaluateCreatorDataQuality` 返回 tier/score/checks/missingMetrics。已接入 ranker 的 `scoreDataQuality`。
- `mcp/src/features/tihao-sourcing/goal-strategy.js` — 4 类投放目标（种草转化/品牌曝光/搜索引流/活动冲量）→ 账号类型映射；3 条提号规则（默认提号数量 = 需求数量 3 倍以上、前 10 篇 80% 风格匹配、优先响应明确数量）。
- `mcp/src/features/tihao-sourcing/compliance-rules.js` — 内容合规白名单：8 组高危词替换（美白→提亮肤色、祛痘→舒缓痘痘、平替→高性价比、特效/神器→体验感、第一/最好→领先/专研、根治→有助于）+ 3 平台特规（小红书/抖音/B站）+ 9 个安全词 + 审核流程。
- `mcp/src/features/tihao-sourcing/brief-rule-patterns.js` — 13 个真实 brief 案例的结构化规则 + 8 个可复用正则模式（CPC/CPV/近3条播放/年龄占比/低龄占比/兴趣标签/达人IP/同省不跨区）。已增强 `brief-parser.js` 的 `resolvePerformanceRequirements`。

### 案例系统（案例 → 可复用知识）

- `scripts/case-template-import.js` — 零依赖 xlsx 读取 + 案例映射 + 归因洞察 + 规则建议（信号 ≥2 次才建议固化）。
- `mcp/src/features/tihao-sourcing/few-shot-cases.js` — 运行时加载 `fewshot-cases.json`，按品类/平台/投放目标匹配历史正/负样本，附加到 criteria。

### 数据库字段沉淀（供未来建库，不建库）

- `mcp/src/features/tihao-sourcing/pgy-schema.js` — 蒲公英博主字段：9 采集接口 + 14 选号维度 + 45 核心字段 + 9 索引 + DDL + 查询映射。
- `mcp/src/features/tihao-sourcing/media-library-schema.js` — 公司媒体资源库字段：35 字段 + 8 必填 + 10 商单交付侧人工补录字段 + 12 个与蒲公英对账别名 + 7 索引 + DDL + 查询映射。

## 新增 npm scripts

| 命令 | 作用 |
| --- | --- |
| `npm run case:import` | 案例模板 → few-shot + 归因 + 历史数据模板 |
| `npm run case:import:smoke` | 案例导入器 smoke |
| `npm run platform:quality-rules:smoke` | 分平台阈值 smoke |
| `npm run goal:compliance:smoke` | 投放目标策略 + 合规白名单 smoke |
| `npm run brief:patterns` | 生成 brief 规则模式 JSON |
| `npm run brief:patterns:smoke` | 规则模式库 smoke |
| `npm run fewshot:smoke` | few-shot 运行时接入 smoke |
| `npm run pgy:schema` / `pgy:schema:smoke` | 蒲公英 schema 生成 / smoke |
| `npm run media:schema` / `media:schema:smoke` | 媒体资源库 schema 生成 / smoke |

## 生成的 docs 产物

- `docs/pgy-field-schema.json` / `docs/pgy-collection-ddl.txt` / `docs/pgy-sourcing-query-map.md`
- `docs/media-library-field-schema.json` / `docs/media-library-collection-ddl.txt` / `docs/media-library-query-map.md`
- `docs/brief-rule-patterns.json`（13 案例 + 8 模式）
- `docs/20260813 - AI提号规则及喂养资料/历史选号案例/case-import/fewshot-cases.json`（当前 2 条真实案例，随 `case:import` 每次刷新）

## 验证结果

- 8 个 smoke 全部通过：`media-library-schema`、`goal-compliance-rules`、`brief-rule-patterns`、`few-shot-cases`、`platform-quality-rules`、`pgy-schema`、`case-template-import`、`candidate-pool`。
- `npm run mcp:smoke` 通过。
- sample 端到端报告新增 4 个 section 正常渲染：`投放目标与提号策略`、`历史相似案例参照`、`内容合规白名单`、`真实案例规则模式命中`（命中条件渲染）。

## Review 后修复（2026-08-14 二轮）

1. **提号数量口径统一为 1.5 倍**：`report.js` 的 `getReviewPoolTarget` 维持 `ceil(targetCount*1.5)`（无目标默认 10）；`goal-strategy.js` 的提号规则从「3 倍」调整为「1.5 倍」，报告「提号数量」提示与候选池口径一致（暂不启用 3 倍）。
2. **达人 IP 正则收窄**：`brief-rule-patterns.js` 的 `ipMustBe` 加负向前瞻排除「授权/联名/形象/周边/运营」，避免「品牌 IP 授权/联名」误报；「达人 IP 必须为宁夏」「IP 要求山东」仍正常命中。
3. **few-shot 案例库打包闭环**：案例库固化到技能包内 `docs/case-library/fewshot-cases.json`（`docs/` 已在 package.json `files` 里，随 npm 包分发）；`case:import` 双写（资料目录留档 + 包内打包位置）；`few-shot-cases.js` 的 `DEFAULT_PATHS` 优先读包内路径。npx 安装后运行时能稳定加载历史案例，不再依赖开发者本地工作区路径。

## 后续可做（仍在技能包边界内）

1. 按模板持续补充《历史选号案例》，每次补完跑 `npm run case:import`，few-shot 正/负样本会同步增长并提升相似案例参照命中率。
2. 规则模式库 `brief-rule-patterns.js` 的 `PATTERN_LIBRARY` 可持续追加新表达；新案例里的数据要求表达式人工复核后可回填。
3. `goal-strategy.js` 的投放目标 signals、`compliance-rules.js` 的高危词表可随客户反馈迭代。
4. 未来要建库时，直接消费 `pgy-schema.js` / `media-library-schema.js` 的 `CORE_FIELDS` / `INDEXES` / `buildDdl()` / `buildQueryMap()`。