feat(AI 建任务): 直接创建 + 草稿沉淀 + MCP de_snapshot;修「建任务页收不到 done」

用户报的"探索完无法点击创建任务"真因:一个 run 的事件原先只有**一条** queue.Queue,
聊天页与建任务页同时开着时两个 EventSource 会**瓜分**它——建任务页的回放卡在中间、
`done` 被聊天页取走 → 永远等不到草稿,页面上自然没有可点的"创建"。

一、修(根因 + 表现)
- `web/agent_api.py` 新增 `_Fanout`:**每个订阅者一个专属队列**,多开页面各看各的,
  还带单轮事件缓冲(晚订阅/刷新重连也能补齐回放,终止事件一定送达)。
  实测两路订阅者收到完全一致的 1039 条事件(含 done)。
- `static/admin/agent.js`:断线重连的兜底订阅也按 `mode` 让开(此前漏了这一处)。

二、补齐上一批的三项
- **「直接创建」**:`POST /api/agent/task_draft/create`(草稿体只在服务端、创建前再校验一次、
  成功后清草稿避免重复建)+ 草稿预览里的「✓ 直接创建任务」按钮 + 「探索完直接创建任务」勾选框。
- **草稿沉淀经验/动作**:designer 轮次也走 `_distill_experience/_distill_actions`,
  但**只在草稿通过校验时**(没走通的试错不入库,免得把误点当经验)。
- **MCP `de_snapshot`**(第 20 个工具):截图+元素树一次取齐(省一次来回、不会因界面在动而错位),
  附带 `screen_state`/`unstable`;两套提示词都改为优先用它。
  平台侧 `/api/uiauto/snapshot` 随之多返回 `screen_state`。

三、文档
- AI_TASK_GEN §10:§10.3 记两个 bug 的真因与修法、§10.4 三项标完成、§10.5 剩余项。
- AI_CONSOLE(扇出语义、多页面同时看一轮)、API(task_draft/create、snapshot 字段)、
  MCP/MCP_DESIGN/staffdeck/README/ARCHITECTURE:工具数 19→20 + de_snapshot 条目。
- backlog:记一条新发现的缺陷——`mcp_server/platform_client._login()` 会把"登录页 200"
  当成登录成功(现场进程缺 `MCP_PLATFORM_PASS` 时表现为含糊的 platform_unavailable)。

自测:真机浏览器端到端(勾上"探索完直接创建")→ 探索 12 步 → 草稿 → 自动建任务成功;
`de_snapshot` 直连真机校验;校验器 21 条用例、扇出单元用例、本地工具契约用例全绿。
自测产生的任务/草稿已全部清理(未碰用户既有数据)。
This commit is contained in:
2026-09-14 08:14:11 +08:00
parent 46e6ea1f37
commit ed9e8bacb1
18 changed files with 384 additions and 67 deletions
+68 -2
View File
@@ -207,6 +207,13 @@ function listenTaskGenStream(runId){
if(d.draft){
_tgDraft = d.draft; _tgWarnings = d.warnings || [];
tgRenderDraft();
if(tgAutoCreateOn()){
// 用户勾了「探索完直接创建」:不再等确认,直接建(服务端仍会再校验一次)
tgStatus('探索完成,正在直接创建任务…');
createDraft(true);
endTaskGenStream();
return;
}
tgStatus('探索完成,共 ' + steps + ' 步。请核对草稿后创建任务。');
}else{
tgStatus(steps ? ('探索结束(' + steps + ' 步),但没有产出草稿。')
@@ -328,8 +335,11 @@ function tgRenderDraft(){
+ '</details>');
}
html.push('<div class="tg-btns">'
+ '<button class="btn btn-primary" onclick="openDraftInEditor()">在步骤编辑器中打开</button>'
+ '<button class="btn" onclick="discardDraft()">丢弃草稿</button>'
+ '<button class="btn btn-primary" onclick="createDraft(false)" title="按草稿直接建成任务(可在任务页继续改);不需要人工核对时用它">'
+ '✓ 直接创建任务</button>'
+ '<button class="btn" onclick="openDraftInEditor()" title="打开步骤编辑器预填,核对/试跑后再保存">'
+ '在步骤编辑器中核对</button>'
+ '<button class="btn" onclick="discardDraft()">丢弃</button>'
+ '</div>');
box.innerHTML = '<div class="tg-draft">' + html.join('') + '</div>';
}
@@ -379,6 +389,62 @@ async function openDraftInEditor(){
warnings: _tgWarnings});
}
// 勾了「探索完直接创建」就用它
function tgAutoCreateOn(){
const c = document.getElementById('tg-auto-create');
return !!(c && c.checked);
}
// 把草稿直接建成任务(服务端取暂存草稿 → 再校验 → add_job → 清草稿)
// auto=true 表示是勾了开关后的自动创建(不再弹确认)
function createDraft(auto){
if(!_tgDraft){ showToast('还没有草稿','error'); return; }
const name = ((_tgDraft.task||{}).name) || '这条任务';
if(!auto && !confirm('直接创建任务「' + name + '」?\n\n'
+ '创建后就是一条正式的可调度任务(可在任务页编辑/停用),'
+ '不再经过步骤编辑器的核对。')) return;
const cfg = tgCollectSettings();
tgStatus('正在创建任务…');
apiPost('/api/agent/task_draft/create', {
serial: ((document.getElementById('tg-serial')||{}).value||''),
overrides: cfg ? cfg.settings : {}
}).then(r=>{
if(!r || !r.ok){
const errs = (r && r.errors && r.errors.length)
? ':' + r.errors.slice(0,3).join(';') : '';
showToast(((r&&r.error)||'创建失败') + errs, 'error');
tgStatus('创建失败 —— 可以「在步骤编辑器中核对」后手工保存');
return;
}
const job = r.job || {};
_tgDraft = null; _tgWarnings = [];
const box = document.getElementById('tg-draft');
if(box){
box.innerHTML = '<div class="tg-draft"><h4>✅ 任务已创建:' + esc(job.name||'') + '</h4>'
+ '<div class="tg-hint">下次运行:' + esc(job.next_run || '手动触发')
+ ' | 调度:' + esc(tgScheduleText(job.schedule))
+ ' | id ' + esc(job.id||'') + '</div>'
+ ((r.warnings||[]).length
? '<div class="tg-warn">' + r.warnings.map(w=>'· ' + esc(w)).join('<br>') + '</div>'
: '')
+ '<div class="tg-btns">'
+ '<button class="btn btn-primary" onclick="showTab(\'tasks\')">去任务页看</button>'
+ '<button class="btn" onclick="tgResetDraftView()">再探索一条</button>'
+ '</div></div>';
}
tgStatus('任务已创建:' + (job.name||''));
showToast('任务「' + (job.name||'') + '」已创建', 'success');
if(typeof loadTasks === 'function') loadTasks();
});
}
function tgResetDraftView(){
_tgDraft = null; _tgWarnings = [];
const box = document.getElementById('tg-draft');
if(box) box.innerHTML = '';
tgStatus('');
}
function discardDraft(){
if(!confirm('丢弃这份草稿?')) return;
apiPost('/api/agent/task_draft/clear', {}).then(r=>{