如何为ego-lite贡献第一个新站点Learnings首个PR实战指南【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-liteego-lite是为 AI Agent 打造的最快浏览器自动化运行环境让 Codex、Claude Code 等 AI 助手直接复用你已登录的浏览器状态。它的Learnings站点知识包机制允许每个网站沉淀一份可复用的地图——页面结构、稳定选择器和现成工具函数。想给项目提第一个 PR新增一个站点 Learnings 就是门槛最低、收益最高的切入点。本文带你走完整条实战流程 为什么从 Learnings 入手Learnings 目录完全独立于核心源码改它不需要理解整个 TypeScript 运行时也不会影响其他站点的行为。对新手而言改动范围小一个站点就是一个文件夹包含 4 类文件价值直观你写的工具函数会被 AI Agent 直接调用让它在对应站点上更快、更准✅有自动校验兜底内置校验脚本会在你提交前拦住所有格式错误上图是官方基准测试在真实 Web 任务中ego-lite 不仅更快成本也更低。而你贡献的 Learnings正是让 AI 在这些任务上表现更好的秘密武器。Learnings 目录结构速览每个站点的知识包位于 skills/ego-browser/learnings/ 下结构固定learnings/站点名/ ├── manifest.json # 元数据域名匹配、工具清单与参数模式 ├── notes/*.md # 人类可读的站点笔记页面结构、导航方式、边界情况 ├── tools/*.js # Node 侧工具在 CLI 进程中运行 └── browser-tools/*.js # 浏览器侧工具注入页面内运行可以直接对照两个成熟示例学习Google 示例manifest.json、notes/overview.md、tools/search-extract.jsX (Twitter) 示例manifest.json、notes/overview.md官方贡献指南的 Site Learnings 章节 也对此有权威说明。实操5 步新增一个站点 Learnings第 1 步克隆仓库并准备环境git clone https://gitcode.com/GitHub_Trending/eg/ego-lite cd ego-lite/package/ego-browser npm ci第 2 步仿照现有站点搭建目录在skills/ego-browser/learnings/下新建你的站点目录例如learnings/my-site/。目录名将成为站点的id——manifest 中的id字段必须与目录名完全一致否则校验直接失败。第 3 步编写 manifest.jsonmanifest 是说明书告诉运行时应匹配哪些域名、有哪些工具。核心字段字段作用id/name站点标识须等于目录名与展示名domains[]域名匹配列表支持*.example.com通配notes[]指向notes/*.md的笔记路径nodeTools{}Node 侧工具路径必须是tools/*.js并声明callable导出函数名browserTools{}浏览器侧工具路径必须是browser-tools/*.js每个工具还需声明description、args参数名 类型 是否必填和returns。类型仅限string / number / integer / boolean / array / object。第 4 步写笔记与工具函数notes 是地图不是日记只记录页面结构、稳定选择器CSS / ARIA / 文本、导航方式和边界情况。参考 x-com 的 overview.md它清晰列出了data-testid选择器与防误点模式。硬性红线校验器会扫描你的所有文件❌ 禁止出现像素坐标、密钥/token、任务流水账❌ 禁止临时快照引用如12或ref12这类编号必须用稳定选择器✅ 只捕获站点的形状而非你某次任务的经过第 5 步本地校验cd package/ego-browser npm run validate:site-skills校验规则全部实现在 validate-learning-format.ts会逐一检查manifest 合法性、域名格式、notes 路径、工具文件是否存在、callable函数是否真实导出、是否混入临时引用。校验逻辑本身可参考 src/learning/index.ts 中工具如何被加载与调用。提交 PR 前的自检清单按照 CONTRIBUTING.md 的流程你的 PR 需要满足分支与提交从main拉分支提交信息遵循 Conventional Commitsscope 用站点名如feat(learnings/my-site): add search tool最小验证门槛npm test全绿涉及 Learnings 改动时npm run validate:site-skills通过PR 描述三件套改了什么一句话、为什么改、如何验证附运行示例或截图加上 release-note 标签如feat方便自动生成分组发布说明注意CI 会在每次 PR 上自动执行npm testvalidate:site-skills本地先跑过可避免往返 常见踩坑一览报错原因manifest id must match directory nameid字段与文件夹名不一致path must be a relative tools/*.js pathNode 工具没放在tools/下或路径写了绝对路径missing Node callable工具文件的导出函数名与 manifest 中callable不匹配contains temporary snapshot ref代码或笔记里写了12这类临时引用请换稳定选择器结语一个站点 Learnings 通常只有几个文件、百来行代码却是让 ego-lite 变得更聪明的真实贡献。挑一个你天天用的网站把地图画出来——你的第一个 PR就从这里开始 【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何为ego-lite贡献第一个新站点Learnings？首个PR实战指南
如何为ego-lite贡献第一个新站点Learnings首个PR实战指南【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-liteego-lite是为 AI Agent 打造的最快浏览器自动化运行环境让 Codex、Claude Code 等 AI 助手直接复用你已登录的浏览器状态。它的Learnings站点知识包机制允许每个网站沉淀一份可复用的地图——页面结构、稳定选择器和现成工具函数。想给项目提第一个 PR新增一个站点 Learnings 就是门槛最低、收益最高的切入点。本文带你走完整条实战流程 为什么从 Learnings 入手Learnings 目录完全独立于核心源码改它不需要理解整个 TypeScript 运行时也不会影响其他站点的行为。对新手而言改动范围小一个站点就是一个文件夹包含 4 类文件价值直观你写的工具函数会被 AI Agent 直接调用让它在对应站点上更快、更准✅有自动校验兜底内置校验脚本会在你提交前拦住所有格式错误上图是官方基准测试在真实 Web 任务中ego-lite 不仅更快成本也更低。而你贡献的 Learnings正是让 AI 在这些任务上表现更好的秘密武器。Learnings 目录结构速览每个站点的知识包位于 skills/ego-browser/learnings/ 下结构固定learnings/站点名/ ├── manifest.json # 元数据域名匹配、工具清单与参数模式 ├── notes/*.md # 人类可读的站点笔记页面结构、导航方式、边界情况 ├── tools/*.js # Node 侧工具在 CLI 进程中运行 └── browser-tools/*.js # 浏览器侧工具注入页面内运行可以直接对照两个成熟示例学习Google 示例manifest.json、notes/overview.md、tools/search-extract.jsX (Twitter) 示例manifest.json、notes/overview.md官方贡献指南的 Site Learnings 章节 也对此有权威说明。实操5 步新增一个站点 Learnings第 1 步克隆仓库并准备环境git clone https://gitcode.com/GitHub_Trending/eg/ego-lite cd ego-lite/package/ego-browser npm ci第 2 步仿照现有站点搭建目录在skills/ego-browser/learnings/下新建你的站点目录例如learnings/my-site/。目录名将成为站点的id——manifest 中的id字段必须与目录名完全一致否则校验直接失败。第 3 步编写 manifest.jsonmanifest 是说明书告诉运行时应匹配哪些域名、有哪些工具。核心字段字段作用id/name站点标识须等于目录名与展示名domains[]域名匹配列表支持*.example.com通配notes[]指向notes/*.md的笔记路径nodeTools{}Node 侧工具路径必须是tools/*.js并声明callable导出函数名browserTools{}浏览器侧工具路径必须是browser-tools/*.js每个工具还需声明description、args参数名 类型 是否必填和returns。类型仅限string / number / integer / boolean / array / object。第 4 步写笔记与工具函数notes 是地图不是日记只记录页面结构、稳定选择器CSS / ARIA / 文本、导航方式和边界情况。参考 x-com 的 overview.md它清晰列出了data-testid选择器与防误点模式。硬性红线校验器会扫描你的所有文件❌ 禁止出现像素坐标、密钥/token、任务流水账❌ 禁止临时快照引用如12或ref12这类编号必须用稳定选择器✅ 只捕获站点的形状而非你某次任务的经过第 5 步本地校验cd package/ego-browser npm run validate:site-skills校验规则全部实现在 validate-learning-format.ts会逐一检查manifest 合法性、域名格式、notes 路径、工具文件是否存在、callable函数是否真实导出、是否混入临时引用。校验逻辑本身可参考 src/learning/index.ts 中工具如何被加载与调用。提交 PR 前的自检清单按照 CONTRIBUTING.md 的流程你的 PR 需要满足分支与提交从main拉分支提交信息遵循 Conventional Commitsscope 用站点名如feat(learnings/my-site): add search tool最小验证门槛npm test全绿涉及 Learnings 改动时npm run validate:site-skills通过PR 描述三件套改了什么一句话、为什么改、如何验证附运行示例或截图加上 release-note 标签如feat方便自动生成分组发布说明注意CI 会在每次 PR 上自动执行npm testvalidate:site-skills本地先跑过可避免往返 常见踩坑一览报错原因manifest id must match directory nameid字段与文件夹名不一致path must be a relative tools/*.js pathNode 工具没放在tools/下或路径写了绝对路径missing Node callable工具文件的导出函数名与 manifest 中callable不匹配contains temporary snapshot ref代码或笔记里写了12这类临时引用请换稳定选择器结语一个站点 Learnings 通常只有几个文件、百来行代码却是让 ego-lite 变得更聪明的真实贡献。挑一个你天天用的网站把地图画出来——你的第一个 PR就从这里开始 【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
