直播口播稿生成器
把任意商品链接，批量变成可上播的主播口播稿，并逐商品导出为独立 Word 文档。
适用输入
- 1688 商品链接，尤其是
qr.1688.com/s/XXXX这类微信/二维码短链（需先解析）。 - 直接商品详情页 URL（1688
/offer/、detail.1688.com；淘宝/京东等详情页）。 - 一次可接收多个链接，为每个链接各生成一篇独立口播稿、独立 Word 文件。
必含模块（每份口播稿都必须有，详见 references/template.md）
- 开场引流（黄金 3 秒抓人）
- 产品 FAB 介绍（Feature 特性 / Advantage 优势 / Benefit 利益，分三段写）
- 价格优势（锚定对比 + 价值换算话术；价格未知时用〔〕占位并给框架）
- 使用场景与人群
- 顾客常见提问 Q&A（至少 5 条，覆盖材质安全 / 声音 / 掉渣 / 与同类区别 / 价格 / 发货售后）
- 逼单促单 + 结尾
- 备播 Checklist
标准作业流程（SOP）
第 1 步：收集与解析链接
- 收集用户发来的所有商品链接。
- 对 1688 短链（
qr.1688.com/s/...）调用scripts/resolve_links.py解析为真实商品页 URL 并提取offerId：
bash PY="<python路径>" "$PY" scripts/resolve_links.py "https://qr.1688.com/s/FFqwADS7" --json - 非短链（已是详情页）直接保留。
第 2 步：抓取商品属性
- 对每个解析后的商品页 URL，使用 WebFetch 提取：商品标题、价格/起批量、规格型号、材质、产地、品牌、颜色/尺寸、卖点、销量/口碑、质保、买家评价、是否定制等。
- 1688 价格多为动态加载（需登录签名），WebFetch 常拿不到精确数字——这是正常情况，按第 4 步规则处理。
- 若 WebFetch 抓不到，可退回用 Bash
curl拉页面源码再grep/正则提取可见文本。
第 3 步：逐商品撰写口播稿
- 严格按
references/template.md的结构与写作规范，每个商品独立成稿。 - 用提取到的真实属性填充 FAB（不要编造材质认证、检测报告等无依据信息）。
- 主播口吻、口语化、有情绪；用
【】标镜头/动作提示，用〔〕标需主播替换的占位（尤其价格）。 - 输出为 Markdown 文件，建议放在
outputs/目录，命名如口播稿_01_商品名.md。
第 4 步：价格缺失处理（重要）
当拿不到精确价格时：
- 用 〔￥X.XX〕 占位，明确提醒主播填入实际上架价。
- 仍要写“价格优势”段落：提供锚定对比话术（先报线下/网红店价，再报直播间源头价）和价值换算话术（如“一杯奶茶钱换一个月解压”）。
- 文末附诚信提示：材质、认证、精确价格、运费、售后时效以实际上架信息为准，不对消费者做无依据承诺。
第 5 步：渲染为独立 Word 文档
- 对每个 Markdown 口播稿调用
scripts/build_docx.py生成.docx：
bash "$PY" scripts/build_docx.py outputs/口播稿_01_商品名.md -o outputs/口播稿_01_商品名.docx - 脚本会自动确保
python-docx可用（首次运行自动安装到本地 vendor 目录），并将中文设为宋体、分级标题与项目符号正确渲染。 - 每个商品一个独立
.docx，文件名与商品对应。
第 6 步：交付
- 向用户汇总：生成了几篇、各自的 Word 路径、哪些商品价格需补填。
- 用
present_files把生成的.docx一并展示。
约束与红线
- 不编造商品未公开的信息（检测认证、专利号、精确销量等）。
- 价格、运费、售后时效等动态信息一律以“占位 + 主播填写”处理，不臆测。
- 批量处理时务必一商品一文档，不要把所有商品混在一篇里。
依赖
- Python 3（脚本通过
sys.executable自动pip install python-docx到本地vendor/，无需用户手动装）。 - 网络（解析与抓取商品页需要联网）。
