[Docs] 核验 Ego Lite / ego-browser 的产品定位与文档落点（EN + ZH） #120

本 Issue 自包含：没有历史上下文的 Agent 也应能据此完成。调研日期：2026-09-04；learn-ai 默认分支快照：ce2324990d2500b442bcc40f4623bbfd56b36d03。

相关规范与先例：#116（Tech 按问题域组织）、#107（Other tools 目录）；执行前阅读 .claude/skills/doc-research/SKILL.md 及其文档架构、家族完备性引用。

目标

结论先行：Ego (lite) 当前应先归入 Products → Other tools，而不是新增 Tech / MCP / Skills 顶级章节。

本 Issue 要完成三件事：

1. 核清 Ego (lite) 浏览器、ego-browser harness 与 Agent Skill 的边界。
2. 收口当前 Other tools 的双 canonical 路由，再把 Ego Lite 作为中英目录项落到真实可达入口。
3. 只有在安全、隐私、License、平台与实测证据足够时，才决定是否另开 Issue 升级为独立产品家族。

已核验的产品定位

官方入口：

• 官网：https://www.egolite.app/
• 文档：https://www.egolite.app/document/en/docs/quick-start
• 仓库：https://github.com/citrolabs/ego-lite
• 仓库边界：https://github.com/citrolabs/ego-lite/blob/main/AGENTS.md
• Changelog：https://www.egolite.app/changelog
• Privacy：https://www.egolite.app/privacy

文档落点

Phase 0：先修正 Other tools 的 canonical route

仓库同时存在：

• docs/{zh/,}products/othertools.md：旧“工具箱 / 收件箱”
• docs/{zh/,}products/othertools/index.md：新“目录一行”地图

当前线上也能观察到两个不同页面：

• /products/othertools 与 /products/othertools.html → 旧页面
• /products/othertools/ → 新目录

而 sidebar / product gallery 仍主要指向旧 flat route。必须先选定一个 canonical，合并内容、更新导航，并让旧入口 redirect；不能只改 nested index 后就声称线上用户可见。

建议目标态：以 products/othertools/index.md 为 canonical，flat 页面迁移后 redirect；中英一致。

Phase 1：目录一行

在中英 canonical Other tools 目录各增加一行，至少包含：

• 官方名：Ego (lite)
• 官方 URL
• 一句话边界：面向外部 AI Agent 的 Chromium 浏览器；通过 ego-browser Skill / CDP 自动化网页
• 平台：macOS（核验日期 2026-09-04）
• 本站去向：目录一行；不写安装推荐

首轮不要直接新增 docs/{zh/,}products/ego-lite/。

Phase 2：Tech 只做概念交叉链接

如果需要解释技术边界，可在 docs/{zh/,}tech/06-agent-systems/computer-use.md 的资源或对比部分加入 Ego Lite，但不要复制产品教程。

需要讲清：

• 稳定 API 优先于 UI 自动化。
• 稳定 DOM / CDP 自动化与视觉 Computer Use 不同。
• Ego Lite 是具体产品 / 环境适配器；ego-browser 是连接与能力包装层，不是新协议。

Phase 3：独立产品家族的晋级门

只有同时满足以下条件，才另开 Issue 建 docs/{zh/,}products/ego-lite/：

• 官方文档和安装路径稳定，可确定版本坐标。
• 使用独立、无敏感账号的测试 Profile 完成真实最小闭环。
• 安全 / 隐私口径已裁决，风险与不适用场景可写清。
• 内容密度足够支撑学习地图、Tutorial、Reference；不是为了凑目录结构。
• 中英文可保持同构。

P0 安全与事实门禁

• 不得用个人 Chrome Profile、真实 Cookie、密码、客户数据或工作账号做文档实测。
• 官方 Quick Start 会建议迁移浏览器 Profile，并建议 Agent 使用 Full access；文档必须解释权限边界，不能把该设置写成无条件最佳实践。
• 官网称浏览数据留在本机；同站 Privacy Policy 对更广的 ego Services 描述了浏览活动、页面内容与云端任务日志处理。当前尚未核清该政策对 Ego (lite) 本地浏览器的精确适用范围，因此不得把“数据绝不离开本机”写成已验证事实。
• 以下是上游仍开放的社区报告，只作为待核验风险，不得写成已确认漏洞：
  • [Security]: Raw browser credential access is exposed to model-generated scripts citrolabs/ego-lite#315
  • [Security]: Official macOS builds since at least 0.4.1.7 fail signature verification while installer removes quarantine citrolabs/ego-lite#292
  • [Bug]: Storage.getCookies/setCookies from a Task Space leak across browser profiles citrolabs/ego-lite#319
• 性能、token 与“最快”等比较均来自厂商材料；无独立复现时只能写“厂商声称”。

执行步骤

1. 用官方仓库、文档、Changelog、Privacy 重新核验名称、平台、版本、安装与数据边界，记录 retrievedAt。
2. 明确区分浏览器 App、ego-browser runtime、Skill 三层，并列出不是 MCP / Agent / 测试框架的理由。
3. 收口 Other tools 的 flat / nested canonical 路由与中英入口。
4. 先只加入中英文目录行；不安装、不迁移真实浏览器数据。
5. 评估是否值得独立产品家族；若值得，另开 Issue，不在本 Issue 顺手扩写。
6. 如增加 Tech 交叉链接，只写通用边界与去向，不写厂商点击步骤。

验收

• 官方身份、URL、owner、平台、开源 / 闭源边界均有 L0 来源和核验日期
• 明确选择 directory-row，并记录暂不选择 first-class-family / tech-canonical 的理由
• Other tools 只剩一个 canonical 内容源；旧 URL 有 redirect
• sidebar、product gallery、中英文入口都到达同一类目录页
• Ego Lite 中英目录行语义一致，且不包含未经验证的安装 / 性能 / 隐私承诺
• 无凭据、Cookie、账号、个人资料或敏感截图进入仓库 / Issue / CI
• pnpm docs:audit、pnpm docs:order、pnpm docs:build 结果分别记录；不能只用 build 代替内容门禁
• 线上分别回读英文与中文 canonical URL，确认实际展示新增行

非目标

• 本 Issue 不安装 Ego Lite。
• 不把厂商 benchmark 当独立事实。
• 不把仓库 MIT License 扩大解释为浏览器 App 开源。
• 不在 MCP、Skills 或 Computer Use 下新建一套重复产品手册。
• 不在本 Issue 扩写 Ego Lite 完整教程。

Git commit scope

docs(ego-lite): classify product and add bilingual directory entry