Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

Merge pull request #7432 from makecindy/dash/browser-read-latency

Lizifb97ff1f9974
diff --cc packages/browser-control-runtime/upstream/MAINTAINING.md
index 8c64bc6fd4,4390d064d5..51200a63ff
--- a/packages/browser-control-runtime/upstream/MAINTAINING.md
+++ b/packages/browser-control-runtime/upstream/MAINTAINING.md
@@@ -197,9 -197,17 +197,17 @@@ pnpm --filter @cindy/browser-control-ru
> 加新 action 改了 `browser` 工具 schema → 会话启动一次性注册(`maker-core/.../claude-code/index.ts:713`),一次性失效缓存前缀、稳态不降;按规则 10 实测。新增 action 要两端同步:runtime `types.ts` 的 `BrowserControlAction` ⇄ `tools.ts` 的 `ACTIONS`(exhaustive switch 会强制对齐)。
+ ### 固定 DOM 读取的生命周期边界(2026-10-27)
+
+ - 生成提取函数时,在 JSON 引号转义之外,对 `<`、`>` 和 U+2028/U+2029 做 JavaScript 字面量转义;参数还原为原值,避免脚本分隔符混入生成源码。保持 `Runtime.evaluate` 的浏览器原生执行超时及宿主总时限。
+ - 无 guard 的配方 extract 与直接 extract 使用相同结构化读取。含 guard 的配方合并身份校验与提取后,必须删除 `domRead` 元数据,保持普通 evaluate 路径,避免 runtime 忽略合并函数而绕过 guard。
+ - 读取沿用已有弹窗中断信号,并给 CDP 命令设置总时限。弹窗期间 Chrome 可能暂停 detach:及时返回 `blockedByDialog`,原 scoped session 的 finally 在 Chrome 恢复后完成释放,不新增连接缓存或重试。
+ - 读取前后的主 frame `loaderId` 必须一致,防止同网址刷新后返回旧文档的结果;页面 URL 与导航策略检查仍保留。同网址内的动态内容没有通用“已加载”判据,调用方仍需等待真实业务文字或元素。
+ - `scripts/browser-dom-read-live-check.mjs` 包含真实弹窗、同网址刷新、慢加载与连续 500 次读取检查。资源样本在垃圾回收后读取页面 JS heap、命名隔离世界数量和 CDP session 释放情况;不等同于长时间整进程内存保证。
+
### 配方按使用维护与等待条件(2026-10-23)
-- `recipe` 支持 `site + recipeDraft` 内存试跑;`saveRecipe` 仅接受同一 MCP 会话已通过验证的相同内容。正常检查不请求模型,不定时后台刷新;失败交给当前任务模型观察、同 id 一轮修订,失败回普通操作。修复预算为会话内状态,MCP 会话重建后重新计数;暂停状态写进配方,跨重启保留。
+- `recipe` 支持 `site + recipeDraft` 内存试跑;`saveRecipe` 通常接受同一 MCP 会话已通过验证的相同内容与 profile。声明 read 且仅含 navigate、无 fn 的 wait、extract、requests、responseBody 的新流程可用 `deferValidation:true` 保存 candidate(不能覆盖已有 id)。下一次真实执行且 guard/expect 全部通过后仅返回 verified、保留会话内凭证;沿用显式 saveRecipe 启用,不重复试跑。候选执行成功或失败都不回写旧定义,避免覆盖其它任务的新修订;失败只暂停本任务,下个任务仍须验证。不新增锁或版本更新协议。交互、任意脚本和 adapter 须当次真实操作验证,不能只信 access 标签。保存、发现、执行旧 candidate 共用 `deferredRecipeIssue` 判据;不承诺远端 GET 没有业务副作用,现有逐次审批仍适用。状态写入失败保留本次执行成功,不能重放。active 不证明未测参数组合。正常检查不请求模型,不定时后台刷新;失败交给当前任务模型观察、同 id 一轮修订,失败回普通操作。修复预算为会话内状态,MCP 会话重建后重新计数;已启用或旧配方沿用原有持久暂停,跨重启保留。
- 新保存配方的交互/读取步骤须有完整 URL 和可选唯一可见 CSS 元素/文本 `guard`;末步 `expect` 检查数量、必需顶层字段与业务值。extract 将 guard 与读取合成同一次 evaluate;写动作前独立 guard,不能把它当事务或幂等保证。工具不重放步骤,后置失败须先核对写入是否已成功。
- 本地每站 `recipes/<id 的 SHA-256>.json` 支持多个流程,原子替换复用 Desktop 工具;loader 兼容 `recipe.json`、新文件优先。旧配方保留执行兼容,实际失败后暂停;新建/修订必须经过新验证。失败不把候选覆盖到正式配方。跨任务并发修改同一配方仍是最后写入优先,不新增锁/版本管理系统。
- `wait.fn` 补丁在 `sync.mjs`:host 只编译函数,页面执行;传真实 function 给 `waitForFunction`,避免函数源码被当 truthy、重复 eval 被 Trusted Types 拦截。timeout 放第三参数。异步 predicate 明确拒绝,避免 Promise 假成功;evaluate 仍支持 async。