Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "ego-decision-layer",
"version": "0.10.0",
"version": "0.11.0",
"owner": {
"name": "liuyuchen",
"url": "https://github.com/jiangkoumo"
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,25 @@
每个版本按 **新增 / 修复 / 更正 / 未验证** 分组。「更正」记的是被实测推翻的旧结论,
不是新功能;「未验证」如实列出还没测过的边界。

## 0.11.0 — 2026-10-26

### 新增

- `--cdp-endpoint <http(s)/ws(s) URL>`(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

### 新增
Expand Down
6 changes: 3 additions & 3 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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 与资源清理。
Expand Down Expand Up @@ -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
Expand All @@ -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 和已安装插件,再核对其实际代码 |
Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)` 工具 | 返回任务标识、确定性验证结果、停止原因与已执行动作;明确取消、重试、连接释放和页面所有权;调用方重试不盲目重复已有副作用 |
Expand Down
6 changes: 3 additions & 3 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down Expand Up @@ -36,9 +36,9 @@ ZIP / 插件安装无匹配记录时需走原渠道。旧版本先按原渠道

默认 ego lite 路径的基础用法、Space/Page/选择器/收尾纪律仍以 `ego-browser` 技能为准。

开发分支增加 `--cdp-endpoint <http(s)/ws(s) URL>`:普通 Node 22+ 连接外部 Chrome,创建专属页面,
0.11.0 起提供 `--cdp-endpoint <http(s)/ws(s) URL>`:普通 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 与凭证);
共同任务集用注入判定器,不能据此宣称模型成功率。

Expand Down
Loading