中文社媒热点调研

概述

网络热点调研系统 Skill

把用户的自然语言需求转换为可复测的社媒调研任务：先规划平台和 TikHub 动作，再披露费用，获得必要确认后抓取原始证据，最后生成零编造报告。

首次使用：初始化内置 Runtime

本 Skill 是单包分发物：assets/runtime-template/ 已内置可执行 Runtime。不要要求用户再下载第二个包。

1. 选择用户自己的工作目录，例如 ~/network-hotspot-runtime。
2. 从本 Skill 根目录执行：

   python3 scripts/bootstrap_runtime.py ~/network-hotspot-runtime --install-deps

1. 用户在 Runtime 根目录设置自己的 TIKHUB_API_KEY、DEEPSEEK_API_KEY 环境变量，或创建 gitignored 的 .tikhub_key、.deepseek_key。
2. 进入该 Runtime 目录，运行 ./scripts/verify-template.sh。该检查不联网、不读密钥、不产生付费请求。
3. 后续所有调研命令都在 Runtime 根目录执行；不要在 Skill 安装目录写客户数据、报告或密钥。

每次任务前

1. 在 Runtime 根目录读取 docs/接力手册.md 和 AGENTS.md。
2. 运行 ./scripts/verify-template.sh。
3. 需要快速检查时执行 <Skill 根目录>/scripts/check_workspace.py <Runtime 根目录>。

任务路由

• 热点、舆情、选题、竞品、评论：使用 工具/research.py。
• 单个平台补抓或接口审计：先读 references/tikhub-endpoints.md，再使用 工具/tikhub_fetch.py。
• GEO 可见度实测：使用 工具/ai_visibility_test.py，问题集必须可追溯。
• 报告、复盘、测算：遵循 references/report-spec.md（若项目内存在），调研类 Markdown 完成后转 PDF。
• 跨专题可复用结论：遵循 知识库/编译规则.md 并运行 wiki 健康检查。

TikHub 需求规划

优先使用自然语言需求，不要凭经验固定平台：

python3 工具/research.py "主题" --track "专题" --kw "关键词" 
  --requirement "国内美妆品牌热点和评论监测" --dry-run

规划器维护在 工具/tikhub_catalog.py，当前覆盖 16 个平台族：TikTok、抖音、西瓜视频、小红书、Instagram、X/Twitter、YouTube、Threads、LinkedIn、Reddit、B站、微博、快手、微信生态、Lemon8、知乎。需要核对动作和路由时直接读取目录，不在调用处复制路由表。

全平台强制二次确认

当需求包含“全平台”“所有平台”“全网平台”，或手动选择恰好 16 个平台时：

1. 先输出完整 16 平台清单、每个平台动作、验证状态和预计 TikHub 调用数。
2. --dry-run 只做展示，不需要确认。
3. 真实命令必须由用户在审阅后追加 --confirm-all-platforms；界面必须勾选对应确认框。
4. 如果计划含未经过本地 fixture 回归的路由，还要显式加 --allow-unverified。
5. 没有确认不得读取密钥、不得发起任何 TikHub 请求。

付费与证据纪律

• 调用前披露估算；估算是审计信息，不是 20、170 等固定硬上限。
• 同一轮重复相同路由和参数，或有限重试后连续 5 次失败，才按异常熔断。
• 搜索结果需要评论时，先提取内容 ID，再二跳评论；没有 ID 就记录缺口，不发无效请求。
• 每个数字必须来自本次抓取、证据包或用户提供的可标注来源；查不到写“查证不到”，隐藏字段写“平台不公开”。
• 只使用环境变量或 gitignored 密钥文件；绝不把密钥、Cookie、内部权重写入报告或 Skill。
• 禁止自动发布小红书、抖音、视频号及其他社媒内容；发布永远由用户手动完成。

交付收尾

1. 证据包落在 专题/<track>/来源/证据包/，报告落在 专题/<track>/调研/。
2. 调研、复盘、测算 Markdown 生成 PDF 后再交付 PDF 路径。
3. 运行 bash scripts/verify-all.sh 和 git diff --check。
4. 里程碑完成后更新 docs/接力手册.md，只提交本任务改动；不要推送远端。

详细流程、接口、隐私和内置 Runtime 结构见：

• references/workflow.md
• references/tikhub-endpoints.md
• references/security.md
• references/runtime-map.md