小红书商品差评分析报告
Purpose
读取飞书多维表格里的商品评价数据，筛出有效差评，生成一份小红书商品经营视角的 HTML 分析报告。
报告重点不是简单统计差评数量，而是把用户负反馈拆成商品质量、信息表达、履约物流、使用体验、客服售后、退款风险、种草转化阻力和产品改进优先级。
Required tool policy
- 优先使用当前环境中已安装并认证的
lark-cli读取飞书多维表格。脚本会依次检查LARK_CLI环境变量、PATH、~/.local/bin/lark-cli和~/.codex/lark-cli/bin/lark-cli。 - 只读取 Base 数据并在本地生成 HTML；不要修改、删除或回写飞书表格。
- 先检查字段列表，再读取记录。
- 优先读取
评价内容字段；没有时依次尝试评论内容、内容。 - 如果字段无法识别，停止并说明缺少哪个字段，不要猜字段。
- 如果用户只给了 Base URL，先从 URL 解析
base-token和table-id；URL 不能解析时再让用户提供--base-token和--table-id。
Expected table fields
脚本会自动识别以下字段。只有评价内容字段是必需项，其余字段缺失时降级处理。
| 数据 | 优先字段名 |
|---|---|
| 评价 ID | 评价ID、评论ID、review_id |
| 评价内容 | 评价内容、评论内容、内容 |
| SKU / 规格 | SKU规格、商品规格、规格 |
| 评价日期 | 评价日期、评论时间、评论日期 |
| 商品评分 | 评分-商品、商品评分、评分 |
| 物流评分 | 评分-物流、物流评分 |
| 服务评分 | 评分-服务、服务评分、客服评分 |
Workflow
- 确认用户提供飞书多维表格链接，或提供
base-token和table-id。 - 用
lark-cli base +field-list检查字段。 - 运行同目录脚本
scripts/generate_xhs_review_report.py。 - 如果表里混有测试行或只需要分析某一批差评，用
--id-prefix限定评价 ID 前缀。 - 生成 HTML 后，用 Python
HTMLParser验证文件可解析。 - 向用户报告输出路径、原始行数、有效差评数和使用的字段。
Script
从用户当前工作区运行：
SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/xhs-review-analysis-report"
python3 "$SKILL_DIR/scripts/generate_xhs_review_report.py" \
--url 'https://example.feishu.cn/base/BASE_TOKEN?table=TABLE_ID&view=VIEW_ID' \
--out outputs/xhs-review-analysis-report.html
如果表格混有真实评价和生成测试行，并且用户只要其中一批，传入 ID 前缀：
SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/xhs-review-analysis-report"
python3 "$SKILL_DIR/scripts/generate_xhs_review_report.py" \
--url 'FEISHU_BASE_URL' \
--id-prefix bad-review- \
--out outputs/xhs-review-analysis-report.html
当链接无法解析时，改用显式参数：
SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/xhs-review-analysis-report"
python3 "$SKILL_DIR/scripts/generate_xhs_review_report.py" \
--base-token 'BASE_TOKEN' \
--table-id 'TABLE_ID' \
--out outputs/xhs-review-analysis-report.html
Filtering rules
- 如果传入
--id-prefix，只保留评价 ID 以该前缀开头的记录。 - 如果没有传入
--id-prefix，脚本会根据低评分或负向词筛选有效差评。 - 纯正向评价会被排除，避免把“满意、喜欢、回购”类内容算进差评。
- 空评价内容会被跳过。
Report contents
HTML 报告包含：
- 商品评价结论
- 差评总体洞察
- 高频问题分类
- 用户负反馈原声
- 爆雷 SKU / 规格下钻
- 退款风险与种草转化阻力
- 责任归因
- 证据强度
- 12 个产品改进机会
- 商品页 / 种草承接优化建议
- 客服 FAQ 建议
- 产品迭代优先级
Validation
生成后运行：
python3 - <<'PY'
from html.parser import HTMLParser
from pathlib import Path
p = Path('outputs/xhs-review-analysis-report.html')
s = p.read_text(encoding='utf-8')
HTMLParser().feed(s)
print({'exists': p.exists(), 'bytes': p.stat().st_size})
PY
最后回复用户时必须包含：
- HTML 报告路径
- 原始读取行数
- 有效差评数量
- 实际使用的评价内容字段
