用途:Refine Live 是 Timeline Inspector 的 Refine 代理在聊天内的回退模式。当持久化中继已启动但没有配置 REFINE_AGENT_CMD 时,用户运行 /refine live,由当前聊天充当轮询器,通过本地中继(默认 http://localhost:7331)领取并回答 Refine 任务,使面板的 LLM 标签保持“可用”。
主要能力:轮询 GET /jobs/next 领取任务;对 refineType 为 small 的任务给出动效 token 微调建议,对 replace 的任务给出整段过渡配方替换建议;处理 kind 为 scan 的任务,按源码把 DOM 过渡分组为组件与阶段;处理 kind 为 apply 的任务,直接编辑源码;通过 POST /jobs/:id/result 提交结果,或 POST /jobs/:id/error 报告错误。
使用方式:启动时先执行一次 curl -s -X POST http://localhost:7331/poller/start 清除停止闩锁,然后循环调用 curl -s http://localhost:7331/jobs/next。返回 204 表示暂无任务;返回 {"stop": true} 必须立即停止;返回任务 JSON 则处理并提交结果。空闲时逐步退避,约 10 分钟无任务后自动停止。
适用场景:无法为持久化代理 CLI 接线时,临时在 Cursor/Claude/Codex 等聊天中充当 Refine 的 LLM 后端。
限制:该循环即使空闲也消耗聊天轮次/额度,并非真正的“运行后不管”;中继在最后一次轮询后约 120 秒内报告代理可用;停止后 LLM 标签会变为不可用,需重新运行 /refine live 恢复。持久化模式建议改用 npx transitions-refine live,停止用 Ctrl-C 或 npx transitions-refine stop。