核心用法
ragtop-planner 是一款面向外部 OpenClaw 服务的达人推广方案制定 Skill，通过标准化工具接口将复杂的推广策划流程改造为可编排、可复用的自动化工作流。该 Skill 核心依赖三个 RAGTOP 工具接口——list_kb（知识库列表）、list_doc（文档列表）和 retrieval（向量召回），按四阶段顺序执行：
1. RULES_SUMMARY：从"方案"知识库召回行业规则与平台政策，提炼可执行清单
2. CASE_SUMMARY：从"案例"知识库分析历史成功案例，总结可复用的内容模式与投放策略
3. KOL_SELECTOR：从"价格"知识库召回达人报价数据，生成结构化 HTML 筛选表
4. PLAN_GENERATION：融合前三阶段产出与用户需求，生成包含预算合规检查的最终推广方案
用户仅需配置 RAGTOP_API_TOKEN 环境变量即可调用，API 地址可自定义（默认内网地址 10.71.10.71:9380），支持多路召回（queries 数组）、文档范围限定（doc_ids）及阈值调优。
显著优点
- 零后端改造：外部 OpenClaw 服务无需改动现有架构即可集成完整的达人推广能力
- 流程标准化：将经验驱动的策划工作转化为确定性四阶段流水线，降低人为遗漏风险
- 多源融合决策：规则、案例、价格三类知识库交叉验证，避免单一数据源的决策偏差
- 预算硬约束：最终方案强制执行总价校验，超预算时自动触发降级机制（剔除低优先级达人）
- 结果可溯源：所有关键结论必须标注召回来源（文档名/记录来源），满足合规审计要求
潜在缺点与局限性
- 知识库依赖重：若"方案/案例/价格"任一知识库缺失或数据陈旧，输出质量将显著下降
- 召回阈值敏感：默认参数（规则 top_k=24、案例 top_k=8）需根据实际数据密度调优，阈值过高易漏检，过低引入噪声
- 内网地址默认：默认 API 地址
10.71.10.71:9380为内网 IP，公网部署需显式配置RAGTOP_API_URL - 无实时数据：依赖预置知识库，不支持实时抓取达人最新报价或平台政策变更
- 单 Token 认证：仅支持 Bearer Token 一种认证方式，缺乏细粒度权限控制
适合人群
- MCN 机构运营团队：需批量输出标准化达人推广方案，降低初级策划人员培训成本
- 品牌方市场部：希望快速评估多达人组合投放的预算可行性与预期效果
- 外部 OpenClaw 服务商：需要为多个客户快速搭建达人推广能力模块，避免重复开发
常规风险
| 风险类型 | 说明 | 应对建议 |
|---------|------|---------|
| 数据泄露 | Token 泄露可能导致知识库内容被批量拉取 | 定期轮换 `RAGTOP_API_TOKEN`，避免硬编码 |
| 预算超支 | 阈值调优不当或知识库报价未更新可能导致方案超限 | 严格执行最终校验环节，超预算时阻断生成 |
| 决策偏差 | 案例库样本偏差或规则库滞后可能输出过时策略 | 建立知识库定期更新机制，关键结论人工复核 |
| 服务中断 | 内网地址或 Token 过期导致流程中断 | 前置 `list_kb` 健康检查，失败时明确提示用户 |