效果回传#

将此前 Listing / SEO / 广告等技能返回的 run_id 与卖家反馈的销量、点击、曝光等登记到 Yufluent 效果闭环，用于后续模型优化和效果归因。

注意：本技能不走 POST /v1/skills/*/run，仅走 POST /v1/agent/outcomes（与 OpenClaw 对话共用同一 tk-*）。不调用 Harness 生成内容。

快速开始（3 步，60 秒）#

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）#

OpenClaw 对话与本技能 共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

层走哪里干什么OpenClaw 对话Yufluent /v1/chat/completions（同一 tk-*）识别 run_id、收集效果数据、调 run.py效果登记POST /v1/agent/outcomes（同一 tk-*）登记效果到 Yufluent

Agent 硬性规则：

• 禁止 用对话模型自行构造 POST /v1/agent/outcomes 请求或编造效果数据。
• 必须 通过 python scripts/run.py ... 登记效果。
• 只需 TOKENAPI_KEY，不要另配 Key

Instructions（Agent 工作流）#

1. 触发时机：用户说「Listing 上架了」「这周卖了 20 单」且对话里出现过 run_id=hr_xxx。

2. 收集参数：

   • --run-id（必填）：之前技能输出中的 run_id
   • --event：事件类型（默认 published，可选 sale）
   • --orders / --impressions / --clicks：效果数据
   • --notes：备注如 "Amazon US 首周"

3. 调用： bash

   python scripts/run.py \
     --run-id "hr_abc123" \
     --event sale \
     --orders 20 \
     --notes "Amazon US 首周"
   
   

4. 无需计费：仅登记，不消耗 Harness Token。

参数说明#

参数必填说明--run-id是技能返回的 run_id（如 hr_abc123）--event否事件类型： published / sale / promoted，默认 published``--orders否订单数--impressions否曝光量--clicks否点击量--revenue-cny否收入（元）--external-id否平台 ASIN / SKU--notes否备注说明

环境变量#

变量必填说明TOKENAPI_KEY是tk-*， Yufluent 控制台 获取TOKENAPI_BASE_URL否默认 http://localhost:8080/v1

触发词#

• "帮我记录效果"
• "上架后有销量了"
• "run_id 回传"
• "效果登记"
• "Listing 出单了"
• "登记一下"

Examples#

商品上架回传

bash

python scripts/run.py \
  --run-id "hr_abc123" \
  --event published \
  --external-id "B0XXXXXXX" \
  --notes "Amazon US 上架"

销量回传

bash

python scripts/run.py \
  --run-id "hr_abc123" \
  --event sale \
  --orders 20 \
  --revenue-cny 15000 \
  --impressions 5000 \
  --clicks 320 \
  --notes "首周数据"

工作原理#

text

跑 Listing/SEO 技能 → 输出 run_id → 过段时间有销量 → 调 record-outcome 回传
                                                    ↓
                                            Yufluent 累计效果数据
                                                    ↓
                                        后续模型优化 / 归因分析

合规声明#

• 仅登记用户主动提供的数据，不抓取平台后台
• 不自动获取 ASIN、订单号或任何卖家敏感数据

版本记录#

版本日期变更v1.1.02026-06-14SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register linksv1.0.02026-06-13规范 SKILL.md：补充 Agent 规则、Instructions、触发词、示例、环境变量、合规、版本记录v0.1.0—初始效果回传辅助包