任务
暂无任务
（选择一个任务后在这里查看实时输出）
复查与二次处置（执行后 72h 自动回流）
每次「按策略执行 / 冲突让位 / 二次处置」都会记录执行前 7/30 天指标，到期后在这里复查：
未改善或恶化 → 生成升级方案（再降一档 / 加否定词 / 直接暂停）。升级上限
escalation_max_level，到顶只允许暂停，不会无限降价。
执行方式看设置里的 escalation_auto： off=每次都要人工点确认（默认）； stop_loss=到期自动降价/收预算/加否定，**暂停仍要人工**； all=全部自动（含暂停）。
执行方式看设置里的 escalation_auto： off=每次都要人工点确认（默认）； stop_loss=到期自动降价/收预算/加否定，**暂停仍要人工**； all=全部自动（含暂停）。
点「刷新执行记录」加载…
店铺（按各自市场时区结算）
筛选
跨类型抢流量处置（数据判定：谁是主力、谁让位）
让位规则：组内**有订单且订单最多、ACOS 最低**的当主力；其余在跑量的成员让位 ——
有订单的降价/降预算，0 订单且花费 ≥$10 的直接暂停。整组 0 订单则全部止损。
怎么执行：点「预演让位处置」→ 下方出现「确认执行这 N 条」→ 点它才真写领星。 被拦大多是冷却期（同一实体 6h 内不重复动），按每条提示的「最快 MM-DD HH:mm 可执行」到点再来。
怎么执行：点「预演让位处置」→ 下方出现「确认执行这 N 条」→ 点它才真写领星。 被拦大多是冷却期（同一实体 6h 内不重复动），按每条提示的「最快 MM-DD HH:mm 可执行」到点再来。
SP / SD / SB 跨类型抢流量
加载中…
增长机会（怎么拿更多订单）
规则（确定性，不是 AI 猜）：① 低 ACOS 有单 → 还有多少加价空间到目标 ACOS；② 预算打满且 ACOS 达标 → 加预算才拿得到量（打满时加价无效）；
③ 暂停但近 7 天仍有流量 → 重新开启；④ 已经在为你出单、但还没投成关键词的搜索词 → 固化成精准词。
前三条可以「预演 → 确认执行」，执行时照样过全套硬规则（幅度上限、样本、冲突闸门、熔断、单轮写入上限）。
第 ④ 条默认只给建议（人工去广告后台建）；在设置里把 growth_auto_new_keyword 改成
confirm（预演确认后系统建）或 auto（优化轮自动建）后，
只有过了全部闸门的词（归属唯一 / 样本达标 / 词形安全 / 预算未打满）才会自动建，没过的一律退回人工。
点「刷新增长机会」开始分析…
按商品的广告组合（AI 的实际分析单元）
每个商品一块：商品详情（标题/五点/主图）+ 该商品在 SP/SD/SB 的全部广告 + 近 30 天 / 7 天实测样本。
AI 先看商品卖点与整体投放结构，再逐条给动作；商品花费按 ASIN 层去重（不会把关键词和活动重复相加）。
投放前冲突预检（计划新增的词 / ASIN / 类目）
打广告之前先查一下：这些词或商品是不是已经有人在投了？跨 SP/SD/SB 重复投同一目标会互相抬价抢流量。
每行一个（支持换行、逗号分隔）。
亚马逊商品详情（AI 制定策略的商品上下文）
采集链路：curl 直连（chrome 反爬）→ 本机浏览器 --dump-dom 兜底；解析标题、五点描述、主图（最多 7 张，自动还原原图）。
缓存有效期 product_context.cacheTtlHours 小时，AI 每轮会自动带上关联商品的标题/五点/主图信息。
选择左侧报告查看
告警（最近 200 条）
操作日志（AI 决策 / 校验 / 执行）
AI（DeepSeek）
把 key 粘贴进上面输入框就会自动保存并验证，无需再点保存；也可以手输后点「测试 AI 连接」。
留空 = 不修改已存的 key，填一个减号 - = 清除。
模型要填 DeepSeek API 的模型 id（deepseek-chat / deepseek-reasoner），不要填网页版显示名（如 deepseek-flash(v4)），否则会报 model not exist。
留空 = 不修改已存的 key，填一个减号 - = 清除。
模型要填 DeepSeek API 的模型 id（deepseek-chat / deepseek-reasoner），不要填网页版显示名（如 deepseek-flash(v4)），否则会报 model not exist。
领星登录态
点按钮后会在这台机器上弹出一个浏览器：账号密码 / 验证码由你在弹窗里输入，系统只负责自动抓取完整 Cookie（含 httpOnly）并写入本地，密码不经过看板服务。
纯网页表单登录会被领星的滑块安全验证拦下，所以用这种更可靠的方式。
本机也可执行：npm run login
服务器端网页登录（Linux 无桌面可用）
在服务器上启动无头 Chromium，画面直接推到本页面：你在这里点、在这里输账号密码，系统自动抓取完整 Cookie（含 httpOnly）。
密码只输入到服务器自己的浏览器进程，不经过本服务的任何接口日志。
未启动
在画面上点击定位输入框，再用上方键盘输入；拖拽请按住鼠标拖动（滑块验证）。
数据库（MySQL，留空则用本地 JSON）
阈值 / 花费控制
硬 ACOS 兜底 / 变化检测
变化检测开启后：稳定且健康的实体跳过 AI（省 token）；ACOS 超上限 / 低于下限、样本不足、冲突、冷却、7 天指标明显偏离的实体依旧必查。
告警与看板
执行流程：所有执行都是两段式（先预演，再确认）
- 预演：把方案翻译成标准动作 → 过一遍优化轮同一套候选与硬规则 → 只显示「通过 N / 拦截 M（附原因）/ 跳过 K」，不写领星。
- 确认执行：点「确认执行这 N 条」才真实写入领星广告后台，写完生成 reports/*-apply-*.md|json（可在「报告」页查看）。
- 复查：执行时记录每个实体执行前的 7 天 / 30 天指标 + 复查时间（strategy_review_h，默认 72h）。到期在「概览 → 复查与二次处置」看 改善 / 未改善 / 恶化 / 待观察。
- 升级：未改善或恶化 → 「复查 + 生成升级方案」（再降一档 / 加否定词 / 直接暂停），最多 escalation_max_level 级，到顶后只允许暂停，不会无限降价。
只读不写：任何「预演」都不碰领星；想看自动优化轮会做什么又不写领星，用「优化轮（预演）」。
| 要做什么 | 去哪 | 点哪些按钮 | 结果写到哪 |
|---|---|---|---|
| 跨类型内耗「让位」处置 | 冲突 | 刷新处置方案 → 🔍 预演让位处置 → 确认执行这 N 条 | reports/conflict-apply-*.md|json |
| 按商品策略调整 | 产品 | 点商品行 → 🧠 生成商品策略 → ⚡ 按策略执行 → 确认执行这 N 条 | reports/strategy-apply-<ASIN>-*.md|json |
| 增长机会（低 ACOS 加价 / 预算打满加预算 / 暂停词复活） | 产品 | 刷新增长机会 → 🔍 预演执行（可自动的那部分） → 确认执行这 N 条 | reports/growth-apply-*.md|json |
| 成交搜索词固化成精准词（新增投放，会花钱） | 产品 | 设置里 growth_auto_new_keyword = confirm → 刷新增长机会 → 🔍 预演 → 确认执行这 N 条；= auto 时优化轮自己建 | reports/growth-new-keyword-*.md|json |
| 执行后没改善，加码处置 | 概览 | 复查与二次处置 → 复查 + 生成升级方案 → 确认执行这 N 条 | reports/escalation-*.md|json |
| 全自动调价（不用手点） | 概览 → 任务 | 优化轮（真实执行）；常驻定时任务到点也会自己跑 | reports/optimize-*.md|json |
写领星的前提：设置里 web.enableRun=true；否则所有任务与执行按钮都会被拒（只读模式）。
优化轮的定时任务与「真实执行」写入都会受到冷却 + 硬规则 + 熔断 + 单轮写入上限约束，和手动执行完全相同。
「增长机会」里低 ACOS 加价 / 预算打满加预算 / 暂停有流量复活总是可以自动执行；
成交搜索词固化成精准词默认只给建议，需人工去广告后台建（改设置里的 growth_auto_new_keyword 才能自动建）。
执行不了 / 提示拦截，怎么读
| 看到的现象 | 含义 | 怎么办 |
|---|---|---|
| 按钮是灰的「暂无可执行」 | 这次预演一条都没过硬规则（多数是冷却期），点确认也是空跑 | 看提示里的「最快 MM-DD HH:mm 可执行」，到点再预演一次 |
| 拦截原因带「冷却期内（24h）」 | 该实体最近刚被改过。止血方向（降价 / 降预算 / 加否定 / 暂停）要等 strategy_apply_min_gap_h（默认 6h）；加价 / 开启要等满 cooling_h（默认 24h） | 等；或把 strategy_apply_min_gap_h 调小（会更快反复动同一批词，谨慎） |
| 拦截原因带「冲突闸门」 | 该实体处于跨类型活冲突组（SP/SD/SB 都在跑），此时不许加价 / 提预算 / 开启，否则会加剧内耗、互相抬价 | 先去「冲突」页做一次让位处置，把流量让给主力 |
| 拦截原因带「样本不足」 | 主窗口订单没到门槛：只允许止血方向，且幅度自动减半（避免长尾一刀切） | 正常，无需处理；想强推要改 min_sample_* 门槛 |
| 拦截原因带「超过单轮写入上限」 | 一批最多改 max_writes_per_run 条；被截断的会排到下一批（按「止血优先 + 30 天花费降序」排序） | 点「分批执行（最多 3 批）」或再跑一轮 |
| 拦截原因带「花费熔断」 | 当日花费达 total_daily_spend_fuse / profile_daily_spend_fuse；spend_fuse_mode=block_increase 时只禁加价，仍允许降价回收 | 等次日或调高熔断阈值；熔断只防加价，不影响止血 |
| 出现在「跳过（需人工处理）」里 | 动作不在系统可自动范围（新增定向 / 新建活动 / 改素材 / 改匹配方式 / 改竞价策略 / 广告位溢价），或实体已不在自动优化范围 | 按「报告」页里的方案，去广告后台手动做 |
| 建词机会显示「需人工建词」 | 没过自动建词闸门（归属不唯一 / 样本不足 / 词形不安全 / 预算打满），或设置里 growth_auto_new_keyword=off | 看悬停提示里的具体原因：词形不安全的按建议人工判断，开关没开就去设置里打开 |
| 出现在「跳过」里但原因是「花费低于门槛 $3」 | 30 天花费太小，不值得动（省调用、避免无意义抖动） | 无需处理 |
硬规则速查（预演和执行都会过一遍）
| 规则 | 内容（可在「设置」页调整的参数写在括号里） |
|---|---|
| 幅度上限 | 单次出价 ±15%、单次预算 ±20%（max_adjust_bid_pct / max_adjust_budget_pct），超了会被裁剪到上限并注明 |
| 止血通道 | 样本不足时只放行止血方向（降价 / 回收预算 / 加否定 / 暂停），且幅度减半 |
| 冲突闸门 | 活冲突组里禁止加价 / 提预算 / 开启；止血方向永远放行 |
| 单轮写入上限 | 一批最多 max_writes_per_run 条（默认 40），截断前按止血优先 + 花费降序排序 |
| 预算增量封顶 | 单轮某店铺预算增量 ≤ 该店日预算合计 × max_budget_increase_pct_per_profile（默认 10%） |
| 硬 ACOS 兜底 | 可选：主窗口 ACOS 超 guards.hardAcosCeiling 的实体禁止一切加价 / 提预算 / 开启 |
| 黑名单 / 归档 | 归档投放完全跳过；黑名单实体不参与调价 |
| 冷却 | 每次写入后进入冷却，优化轮 cooling_h（默认 24h）内不再动它 |
数据口径（“为什么数字长这样”）
| 口径 | 说明 |
|---|---|
| 按店铺市场时区结算 | 「今日 / 昨日花费」「窗口结束日」「拉取日期」都按店铺市场时区算：美区用美国东部时间（America/New_York）、英国用英国时间（Europe/London）。北京时间上午，美区还停在昨天，两个店铺窗口差一天是正常的 |
| 窗口结束日 | 默认 window_end_offset_days=1：30/7/3 天窗口只统计完整过的当地日，不含进行中的当天；改成 0 则含当天 |
| 花费口径 | 账户级汇总（30 天花费 / 今日花费 / 熔断）只统计活动层行。同一笔钱在 活动/广告组/关键词/商品/搜索词 五个口径各出现一次，全部相加会虚高约 5 倍 |
| 商品花费 | 商品分组只统计 ASIN 层（adProduct） 行去重，同样是为了避免多口径重复相加 |
| 领星当日滞后 | 领星当天数据会随美国/英国当天推进逐步回灌，所以「今日花费」白天偏低，「昨日花费」更接近当日全貌；拉取任务每轮会重拉最近 3 天，自动补全 |
| 英文店铺全 0 | 若某店铺 30 天曝光/花费都是 0，说明领星侧就没有投放数据（不是我们算错）。用 node tools/deploy/store-probe.mjs <profileId> <日期> 可以直接核验 |
指标与「流量分诊」怎么看
ACOS = 花费 ÷ 销售额（无销售额时显示「无销售额」而不是 0）；RoAS = 销售额 ÷ 花费；
CPC = 花费 ÷ 点击；CTR = 点击 ÷ 曝光；CVR = 订单 ÷ 点击。
窗口：成熟广告看滚动 30 天为主、7 天识别异动；成长广告以 7 天为主；新建广告（<7 天）以 3 天为主且调价幅度减半。
| 流量分诊 | 判定（近 7 天） | 该怎么做 |
|---|---|---|
| 流量正常 | 有曝光、有点击、有转化 | ACOS 高说明「出价 / 广告位买贵了」→ 降价或把流量让给 ACOS 更好的类型 |
| 几乎无曝光 | 曝光 < 100 且点击 = 0 | 依次查：出价被挤出 / 匹配·定向过窄 / 预算打满 / Buy Box·库存。只有「出价被挤出」提价才有用 |
| 有曝光没点击 | 点击 = 0 或 CTR < 0.2% | 词不相关 / 位置差 / 主图价格弱 → 否定或换更精准的词、换素材；加价没用 |
| 有点击没转化 | 点击 ≥ 5 且订单 = 0 | 详情页 / 价格 / 评论 / 词意图问题 → 收窄 + 否定，再用降价止血；换投放方式也救不了 |
| 预算打满 | 有曝光且近 3 天日均花费 ≥ 日预算 × 85% | 加价只会让预算更早花完；要拿量必须先加预算（同时压 CPC） |
| 止血后静默（预期） | 近 7 天无花费，且最近一次动作是我们自己的降价 / 降预算 / 加否定 | 什么都不用做 —— 这是我们自己造成的；禁止加价，等复查窗口看效果 |
设置页里最该认识的几个开关
| 配置项 | 作用 |
|---|---|
| web.enableRun | 是否允许从看板触发任务 / 写领星。false = 只读模式 |
| escalation_auto | 二次处置的执行方式：off（只生成方案，人工点确认）/ stop_loss（到期自动执行降价、收预算、加否定；暂停仍要人工）/ all（全部自动，含暂停） |
| growth_auto_new_keyword | 成交搜索词自动固化成精准词（新增投放，会花钱）：off（默认，只出建议）/ confirm（过闸门的词进入「预演 → 确认执行」）/ auto（优化轮结束无人值守自动建）。无论哪档都要先过闸门：归属唯一、样本达标、词形安全、预算未打满；没过的一律退回人工 |
| window_end_offset_days | 1（默认）= 30/7/3 天窗口只算到「店铺当地昨天」；0 = 含进行中的当天 |
| strategy_apply_min_gap_h | 人工确认的执行对止血方向放宽冷却的最小间隔（默认 6h） |
| strategy_review_h / escalation_max_level | 多久后复查（默认 72h）/ 最多升级几次（默认 2 级） |
| max_writes_per_run / optimize_batches | 单轮写入上限（默认 40 条）/ 一次任务最多连跑几批（默认 1 批，可设 3） |
| total_daily_spend_fuse / spend_fuse_mode | 账户日花费熔断上限 / 熔断行为（只禁加价 或 全部停止） |
改完设置点「保存设置」；优化轮每轮会重新读配置，不用重启进程。任务类设置（拉取/优化间隔）由常驻任务在下一轮生效。