diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index e01a85d..a25cebf 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,6 +1,6 @@ { "name": "ego-decision-layer", - "version": "0.10.0", + "version": "0.11.0", "owner": { "name": "liuyuchen", "url": "https://github.com/jiangkoumo" diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 29d8bcd..1742e8b 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "ego-decision-layer", - "version": "0.10.0", + "version": "0.11.0", "description": "给 ego lite 的可插拔决策层:默认 System One(Jev),可换本地 / 其他 OpenAI 兼容后端;执行层带 fail-closed 护栏。", "author": { "name": "liuyuchen", diff --git a/CHANGELOG.md b/CHANGELOG.md index 2e176d5..aeb1a5f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,25 @@ 每个版本按 **新增 / 修复 / 更正 / 未验证** 分组。「更正」记的是被实测推翻的旧结论, 不是新功能;「未验证」如实列出还没测过的边界。 +## 0.11.0 — 2026-10-26 + +### 新增 + +- `--cdp-endpoint `(P1,PR #11):普通 Node 22+ 连接外部 Chrome,创建专属页面,不要求 ego lite,也不刷新官方技能路由;`--keep-space` 保留新页面。独立运行入口 `scripts/run-cdp-task.mjs`;两个宿主共用 12 项受控验收任务,任务自建目标、保留无关页面、取消即停并复核最终 URL。 +- 双宿主共同基准第一批(P2,`bench/common-benchmark/`):复用 P1 的 10 项任务,统一任务格式与预算、统一 runner 和报告口径(成功率、错误成功率、延迟、请求数、花费、护栏拒绝率、人工接管率、失败消耗);宿主缺失记 SKIP 并写明原因。离线自测 `bench/test-common-benchmark.mjs`。 +- MCP 入口最小版(P3,`mcp/`、`docs/MCP.md`):stdio MCP server 提供 `browser_task`,只包装 P1 独立运行入口,观测、决策、执行、护栏全部仍在 P1;配置只由服务端启动者提供,依赖(固定版本 `@modelcontextprotocol/sdk`)只装在 `mcp/` 下,不属于核心运行时。 + +### 验证 + +- P1 集成树:CDP 宿主 167/167、runner 104/104、CLI 15/15、ego lite 12/12、外部 Chrome 12/12,无错误成功;`test-host-integration-live.mjs --suite` 用真实 `jev-1.14.0` 通过 HN 导航与表单提交。 +- P2/P3 合并后(macOS):`test-common-benchmark` 通过;`test-cdp-runner` 104 通过 / 1 跳过;`mcp/test-stdio` 41/41(先 `npm --prefix mcp ci`)。 + +### 未验证 + +- 真实 CDP 与 MCP 只在 macOS 上测过,未在 Windows / Linux 验证;MCP 为实验性入口。 +- 共同基准使用注入判定器,不能据此宣称模型成功率;P1 的 `no-text-source`、`batch-two-fields` 两项留到第二批。 +- Wikipedia 搜索在五步预算内时成时败,仍为可选项。 + ## 0.10.0 — 2026-10-25 ### 新增 diff --git a/README.en.md b/README.en.md index 2a5291d..3deb172 100644 --- a/README.en.md +++ b/README.en.md @@ -6,7 +6,7 @@ English · [简体中文](README.md) A pluggable decision layer for ego lite browser automation. By default, TypeSafe's System One model **Jev** reads an indexed element table and selects an operation and its target in one request. Code handles observation, execution, guards and completion checks. OpenAI-compatible decision backends are also supported. -**Latest release: v0.10.0.** This release adds installation-aware `update` and `--version` commands, this English guide and a prioritized [roadmap](ROADMAP.md). It retains the existing execution engine and Windows path fixes. Download source from the [release page](https://github.com/jiangkoumo/ego-decision-layer/releases/latest). +**Latest release: v0.11.0.** This release adds the `--cdp-endpoint` external Chrome entry (plain Node, no ego lite required), the first batch of the shared two-host benchmark and an experimental MCP tool, `browser_task`. It retains the existing execution engine, `update` / `--version` and Windows path fixes. Download source from the [release page](https://github.com/jiangkoumo/ego-decision-layer/releases/latest). ## Requirements and installation @@ -73,11 +73,11 @@ The development branch adds `--cdp-endpoint` to connect from ordinary Node to an "type Jev into the search box and submit" ``` -CDP mode creates its own page and leaves the external browser and existing tabs open. Use `--keep-space` to retain the new page for inspection. Ego TaskSpace options `--space` and `--keep` cannot be combined with CDP mode. This path does not require ego lite or refresh agent routing. Jev credentials or an OpenAI-compatible decision backend are still required. Controlled tasks have passed on both hosts; this entry is not part of the v0.10.0 release. Run `node bench/test-host-integration-live.mjs --suite` with Node 22+, Chrome and Jev credentials to reproduce controlled acceptance, live HN navigation, form submission and shared CLI integration. Set `EGO_CDP_CHROME` to override the Chrome executable. Optional `--wiki` adds Wikipedia search, which has both succeeded and failed within a five-step budget. +CDP mode creates its own page and leaves the external browser and existing tabs open. Use `--keep-space` to retain the new page for inspection. Ego TaskSpace options `--space` and `--keep` cannot be combined with CDP mode. This path does not require ego lite or refresh agent routing. Jev credentials or an OpenAI-compatible decision backend are still required. Controlled tasks have passed on both hosts; this entry ships with v0.11.0 (real CDP verified on macOS only). Run `node bench/test-host-integration-live.mjs --suite` with Node 22+, Chrome and Jev credentials to reproduce controlled acceptance, live HN navigation, form submission and shared CLI integration. Set `EGO_CDP_CHROME` to override the Chrome executable. Optional `--wiki` adds Wikipedia search, which has both succeeded and failed within a five-step budget. ## Update an installation -Version 0.10.0 introduces: +Since version 0.10.0: ```bash ego-decision-layer --version diff --git a/README.md b/README.md index 10c5bd2..34b0887 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ > **当前能力**:线性操作闭环、结构化抽取、动作缓存、批处理和 Canvas/SVG 图形区域兜底。 > 各能力都有对应测试,见[功能验证](#功能验证);历史性能数据的条件与复跑脚本见[测量与复跑基准](#测量与复跑基准)。 > [`CHANGELOG.md`](CHANGELOG.md) 保留修复记录和被实测推翻的旧结论,代码级溯源见 [`THIRD-PARTY.md`](THIRD-PARTY.md)。 -> **最新版 `v0.10.0`**:新增安装感知的 `update` / `--version` 命令、独立英文 README,并记录下一阶段规划;[发布页](https://github.com/jiangkoumo/ego-decision-layer/releases/latest)提供对应源码下载。不同安装方式的更新规则见[下载与更新渠道](#下载与更新渠道)。 +> **最新版 `v0.11.0`**:新增 `--cdp-endpoint` 外部 Chrome 入口(普通 Node,无需 ego lite)、双宿主共同基准第一批,以及实验性 MCP 工具 `browser_task`;[发布页](https://github.com/jiangkoumo/ego-decision-layer/releases/latest)提供对应源码下载。不同安装方式的更新规则见[下载与更新渠道](#下载与更新渠道)。 > English summary: `ego-decision-layer` replaces the per-step LLM round trip in browser automation with > [TypeSafe](https://docs.typesafe.ai)'s System One model **Jev**. Jev reads one *indexed element @@ -139,7 +139,7 @@ CDP 连接创建自己的页面,保留外部浏览器及其原有标签页。`--space` / `--keep` 属于 ego TaskSpace,不能与 `--cdp-endpoint` 混用;需要保留新页面供检查时使用 `--keep-space`。默认 Jev 仍需 TypeSafe 凭证, -也可使用已有的 OpenAI 兼容决策配置。此入口已完成双宿主受控任务验收,未包含在 `v0.10.0` 发布中。 +也可使用已有的 OpenAI 兼容决策配置。此入口已完成双宿主受控任务验收,自 `v0.11.0` 起随版本发布。 开发验证入口为 `node bench/test-host-integration-live.mjs --suite`(Node 22+、Chrome、Jev 凭证)。 它创建临时 Chrome 与受控表单,跑共同任务集、真实 Jev 的 HN 导航和表单提交,再验证共享 CLI 与资源清理。 @@ -188,12 +188,12 @@ cd ego-decision-layer ### 下载与更新渠道 -`metadata.version` 当前为 `0.10.0`。本版新增 `ego-decision-layer update [--test]` 与 `--version`。 +`metadata.version` 当前为 `0.11.0`。`ego-decision-layer update [--test]` 与 `--version` 自 0.10.0 起提供。 Git 安装按当前分支上游 fast-forward,skills 拷贝按安装记录定向更新并保留原作用域; ZIP / 插件安装没有匹配记录时需走原渠道。旧版本先按原渠道更新一次,才能获得新子命令。 已跟踪文件有未提交改动时更新停止并非零退出,普通未跟踪文件保留,冲突由 Git 拒绝覆盖。 -Windows 路径修复来自 PR #2(合并提交 `76ee335`),已包含在 `v0.9.1` 和 `v0.10.0`。 +Windows 路径修复来自 PR #2(合并提交 `76ee335`),已包含在 `v0.9.1` 及之后的版本。 标签对应固定提交;`main` 会继续演进,后续修复合并后可能先于下一个标签提供。 ```bash @@ -207,7 +207,7 @@ ego-decision-layer update --test # 更新后运行真实浏览器冒烟 | 新 `git clone`,默认分支 `main` | 是 | | 跟踪 `main` 的克隆执行 `git pull --ff-only` / `ego-decision-layer update` | 更新成功后包含;已跟踪文件有未提交改动时更新会停止并非零退出 | | GitHub 下载 `main` 的 ZIP | 是,内容以下载时的 `main` 为准 | -| 下载 `v0.10.0` 或 `v0.9.1` 发布页或标签的 ZIP/tar.gz | 是 | +| 下载 `v0.11.0`、`v0.10.0` 或 `v0.9.1` 发布页或标签的 ZIP/tar.gz | 是 | | 下载 `v0.9.0` 标签的 ZIP/tar.gz,或固定该标签/更早提交 | 否,需要更新到 `v0.9.1` 或含修复的提交 | | `npx skills add jiangkoumo/ego-decision-layer` | 未固定 ref 时获取仓库默认分支;已有拷贝需要重新安装更新,不会随合并自动变化 | | Claude Code 插件市场安装 | 已安装的插件可能仍使用缓存;需更新 marketplace 和已安装插件,再核对其实际代码 | diff --git a/ROADMAP.md b/ROADMAP.md index d64adf2..f07dbf3 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -7,7 +7,7 @@ | 优先级 | 工作 | 验收标准与依赖 | | --- | --- | --- | -| P0:当前发布 | v0.10.0 交付已合入的 `update` / `--version`,补独立英文 README | 更新集成、版本一致性与真实浏览器冒烟通过;版本元数据、标签和 Release 对齐 | +| P0:当前发布 | v0.11.0 交付 P1 外部 CDP 入口、P2 共同基准第一批与 P3 MCP 最小入口;v0.10.0 已交付 `update` / `--version` 与英文 README | 更新集成、版本一致性与真实浏览器冒烟通过;版本元数据、标签和 Release 对齐 | | P1:去宿主化 | 明确最小 Host Adapter 契约,新增普通 Node + 外部 Chrome CDP endpoint 入口,保留 ego lite 体验 | 同一组搜索、点击、输入任务在两个宿主通过;遮挡、陈旧目标、危险动作与控制停止仍按原语义处理;连接与页面归属、清理可验证 | | P2:共同基准 | 先建立 10–15 个可复跑任务,作为双宿主适配与重构的验收集,再扩到 30–50 个真实任务 | 相同目标、输入、验证器与预算;报告成功率、错误成功率、延迟、请求数、花费、护栏拒绝率、人工接管率及失败消耗;登录、验证码、地域与站点变化单独记录 | | P3:MCP 入口 | 在独立运行入口稳定后提供 `browser_task(url, goal, until, text)` 工具 | 返回任务标识、确定性验证结果、停止原因与已执行动作;明确取消、重试、连接释放和页面所有权;调用方重试不盲目重复已有副作用 | diff --git a/SKILL.md b/SKILL.md index ad23e7e..ab15a70 100644 --- a/SKILL.md +++ b/SKILL.md @@ -2,7 +2,7 @@ name: ego-decision-layer description: 多步线性浏览器任务(连续点击、翻页、搜索表单提交、导航跳转)的默认入口:用 `ego-decision-layer` 一条命令让决策层在单个 ego-browser 进程内闭环决策(默认 System One / Jev,可换本地 OpenAI 兼容后端;browser automation / multi-step click chain / form submit / navigation),不再每步退回大模型思考。单步动作、精确 DOM/选择器、批量抓取仍走 ego-browser 原生 API;也可把官方 ego-browser 技能入口接管成路由层。当任务涉及浏览器多步操作、要写 ego-browser nodejs 脚本(await import / fetch / 凭证落盘)时读它。 metadata: - version: "0.10.0" + version: "0.11.0" date: "2026-10-25" requires: ego-browser --- @@ -36,9 +36,9 @@ ZIP / 插件安装无匹配记录时需走原渠道。旧版本先按原渠道 默认 ego lite 路径的基础用法、Space/Page/选择器/收尾纪律仍以 `ego-browser` 技能为准。 -开发分支增加 `--cdp-endpoint `:普通 Node 22+ 连接外部 Chrome,创建专属页面, +0.11.0 起提供 `--cdp-endpoint `:普通 Node 22+ 连接外部 Chrome,创建专属页面, 不要求 ego lite,也不刷新官方技能路由。`--space` / `--keep` 不适用;`--keep-space` 保留新页面。 -此入口已通过双宿主受控任务验收,不属于 `v0.10.0` 已发布能力。真实 Jev 的 HN 导航与表单任务可用 +此入口已通过双宿主受控任务验收,自 `v0.11.0` 起随版本发布(真实 CDP 只在 macOS 上验证)。真实 Jev 的 HN 导航与表单任务可用 `node scripts/../bench/test-host-integration-live.mjs --suite` 复验(需 Node 22+、Chrome 与凭证); 共同任务集用注入判定器,不能据此宣称模型成功率。