# Tihao SOP

Claude Code 技能包：按提号 SOP 读取客户 Brief，生成商务可复核的博主/达人推荐名单，并提供 Fmode/Doubao 图片识别补充能力。

Published npm package:

```text
@vocmarket/tihao
```

Latest version:

```text
1.0.10
```

Recommended workspace install:

```powershell
npx --yes @vocmarket/tihao@latest workspace --smoke
```

Full installation guide:

```text
docs/install-guide.md
```

Installed Claude Code skill name:

```text
tihao
fmode-image-analysis
```

Real-provider integration runbook:

```text
docs/live-provider-integration-runbook.md
```

Tihao experience optimization plan:

```text
docs/tihao-experience-optimization-plan.md
```

Current task handoff entry:

```text
docs/tihao-handoff-index.md
```

## What It Does

- 第一版报告默认走 `live` 高质量首版：`collectionMode=live` + `resultFirstMode=true`，扩大参考感知召回、批量分析候选并按证据重排，直接产出商务可发客户的强名单。
- 普通“读取 brief 出博主名单/提号/找博主/选号/可直接发客户的名单”都按上面的 live 高质量首版处理；只有用户明确要小规模/省额度时才缩到 `keywordLimit=1`。
- `live` 模式调用公司 `voc-e-commerce` 代理接口，使用真实电商数据；缺 token 时返回友好的开通/充值提示并主动要 sessionToken，而不是退回 sample。
- `sample` 模式仅在用户明确要求演示、无消耗、不用真实数据或“先跑通 SOP”时使用，无 token 跑通 brief -> 博主名单流程。
- 输出 Markdown、JSON、CSV 三份结果。
- 无 token、401、403、额度不足时返回友好的开通/充值提示，不暴露原始错误或 token。
- 支持偏好记忆，把客户反馈沉淀到下次选号。
- 支持 Fmode 图片分析：用平台用户 token 调用 `doubao-seed-2-0-pro-260215`，识别截图、产品图、海报、UI 图和图片文字。
- 支持参考博主链接、参考账号补证接口和 ffmpeg/ASR/Vision-ready 证据卡接口；真实 provider 通过 `docs/live-provider-integration-runbook.md` 单独验收。
- 已沉淀商务提号经验优化计划：硬指标、隐性规则、参考账号、主页最近 10/20 篇内容证据、平台相似推荐和客户选中率验收。
- 支持 overnight 策略矩阵：`baseline-live`、`reference-account`、`homepage-evidence`、`video-enhanced`、`result-first`、`result-first-risk`、`result-first-broad`。
- 支持人工复核指标统计：商务可用率、负样本率、负样本归因覆盖率、客户选中率、重复键和每个 brief 内排名连续性。
- 支持真实历史数据集审计：检查真实 Brief、人工最终名单、客户选中/拒绝记录和拒绝原因是否足够做长期优化。

## Local Development

```powershell
npm install
npm run sample
npm run smoke:package
npm run fmode:image:smoke
npm run acceptance
```

Fmode image analysis:

```powershell
$env:TIHAO_SESSION_TOKEN="<your-platform-token>"
tihao image --image-path E:\workspace\example\screenshot.png --prompt "识别截图里的文字、主体和风险点"
```

Workspace install from local source:

```powershell
node install.js --workspace --smoke
```

Live small run:

```powershell
$env:TIHAO_SESSION_TOKEN="<your-session-token>"
$env:TIHAO_COMPANY="<your-company-object-id>"
npm run live
npm run live:preflight
npm run live:acceptance
```

Business review metrics:

```powershell
npm run review:metrics -- --input <已标注CSV> --output <输出目录>
```

Historical dataset readiness:

```powershell
npm run history:audit -- --input <history-dataset目录> --output <输出目录> --strict
```

Optimization plan status:

```powershell
npm run optimization:status
```

## MCP Tools

- `fmode_image_analysis`
- `tihao_brief_sourcing_run`
- `tihao_token_check`
- `tihao_preference_update`