Eric Task Master

English | 简体中文

面向 AI 智能体的持久化浏览器自动化任务系统。

版本：1.0.4

AI 智能体可以推理、规划和编写代码，但浏览器执行往往是它们最薄弱的环节。内置的智能体浏览器适合短会话，但通常会丢失登录状态、任务连续性和恢复上下文。轻量级 CDP 控制器提供快速的底层访问，但让每个智能体都要为每个任务重新构建编排、进度跟踪、清理和错误恢复。

Eric Task Master 填补了这一空白。它是一个以 Playwright 为核心的浏览器自动化运行时，将网页工作转化为持久化、隔离、可观测的任务。智能体可以启动一个任务，让它运行数小时，稍后重新连接，检查证据，从检查点恢复，并验证浏览器已关闭——无需占用用户的日常浏览器，也无需反复消耗令牌重新发现相同的执行机制。

AI agent · browser automation · Playwright · MCP server · web automation · computer use · workflow automation · browser agent · headless browser · multi-agent automation

智能体可以用它构建什么？

Task Master 是一个通用执行基础，而非针对特定站点的机器人。结合智能体、专用 Skill 或 Task Pack，它可以支持：

• 无人值守的研究、监控和基于来源的网页采集；

• 跨数百个页面的长时间批量工作，无需保持智能体回合开启；

• 通过隔离的持久化 Profile 进行需要认证的后台、门户、CMS、CRM 和账户工作流；

• 通过一次性临时 Profile 进行无需登录的干净任务；

• 并行多智能体操作，不会发生标签页、登录状态或任务记录冲突；

• 由智能体、调度器或业务系统触发的周期性运营工作流；

• 浏览器 QA、内容验证、表单处理、文件上传/下载和证据捕获；

• 面向线索运营、电商运营、媒体研究、供应商研究、客户支持、合规检查或内部 RPA 的生产级 Task Pack。

这些是可组合的可能性，而非捆绑的权限或对每个网站都受支持的声明。Task Master 提供可靠的浏览器运行时；专门的 Skill 或 Task Pack 提供业务逻辑、站点策略、解析、检查点、输出和完成证据。

为什么不直接使用智能体浏览器或 CDP 脚本？

Task Master 不会取代智能体的推理能力。它赋予推理一双可靠的浏览器之手。

三层模型

1. Task Master 运行时 — 纯 Playwright 执行、持久化和临时 Profile、队列、持久化任务、进度、恢复、证据和清理。

2. 真实浏览器控制面板 — Chromium 扩展管理 Profile、打开 Dashboard，并且仅在用户明确点击后才转移当前站点的登录状态。它永远不会成为页面自动化引擎。

3. MCP + Skills + Task Packs — 智能体获得紧凑、高级的任务接口，而可复用的领域能力保持独立于核心运行时。

这种分离保持了基础的通用性：改进一个执行引擎，然后在其之上定义许多专门的自动化工作器。

面向 AI 智能体：一个固定的引导协议

如果用户给你这个 GitHub URL，请按顺序执行以下步骤。不要发明另一个守护进程、端口、浏览器启动器、控制器或重试循环。

完整仓库是运行时的唯一事实来源。仅 Skill 的归档是一个指令适配器，没有克隆的 eric-task-master 仓库就无法运行。

1. 如果仓库是私有的，先向 GitHub 认证，然后克隆完整仓库。

2. 要求 Node.js 20 或更高版本。

3. 阅读 skills/eric-task-master/SKILL.md。当宿主支持 Skills 时，将该文件夹安装到宿主的 Skill 目录中；否则就地遵循它。

4. 从仓库根目录精确运行：

node scripts/taskmaster.mjs connect --json

5. connect 安装锁定版本的运行时和匹配的 Playwright Chromium，安全迁移空闲的旧版 Manager，启动回环 Manager，运行真实浏览器验收测试，并注册支持的本地 MCP 宿主。如果旧版 Manager 仍有工作，迁移将停止而不中断它。

6. 遵循返回的 nextAction。在纠正指定的前置条件后，最多重试一次相同的命令；不要分支到推测性的替代控制器。

7. 如果 Chromium 扩展已从此检出安装，请在版本更新后重新加载它。否则将 extension/ 作为未打包扩展加载。

8. 要求用户将返回的一次性 ETM1... 代码粘贴到扩展中并点击 配对。这是正常引导中唯一需要的人工授权。

9. 如果宿主报告 registered_pending_restart，要求用户重新加载该智能体宿主一次。

10. 调用 taskmaster_status，然后调用 taskmaster_profiles_list。当两者都成功时，询问用户要运行什么浏览器任务。

可复制的新智能体请求：

安装并启动 https://github.com/npcworkspace-cmyk/eric-task-master。Chromium 扩展已安装。克隆完整仓库，阅读或安装 skills/eric-task-master，并且只运行 node scripts/taskmaster.mjs connect --json。不要发明其他控制器或端口。仅在扩展配对代码准备好时询问我；在状态和 Profile 发现成功后，询问我想运行什么任务。

日常使用

首次引导后，用户应该能够自然地询问：

使用 Eric Task Master 配合临时 Profile 和自适应行为来研究这些网站，报告进度，保存证据，并在完成时关闭每个任务窗口。

然后智能体使用一个持久化循环：发现任务类型，使用幂等键启动一次，保留任务 ID，等待或重新连接到该 ID，在需要关注时检查诊断信息，并且仅在验证证据和清理后才接受完成。

Profiles

• persistent（持久化） — 用于登录和重复性工作的隔离可复用状态；

• ephemeral / 隐身临时 — 为每个无需登录的任务提供干净的非持久化浏览器，清理后销毁。

行为

• fast（快速） — 对确定性、数据密集型工作采用最小必要等待；

• human（拟人） — 有界的鼠标、打字、滚动和阅读节奏；

• adaptive（自适应） — 以快速模式启动，在动态页面信号、遮挡、超时、不确定导航、操作失败或速率限制后临时变为谨慎或拟人节奏。

拟人节奏是一种可靠性策略，而非绕过网站控制或保护账户免受平台执法的承诺。

构建专门的生产工作器

将站点和业务逻辑保持在核心之外：

node scripts/taskmaster.mjs task-packs scaffold ./my-pack --name my-pack --json
node scripts/taskmaster.mjs task-packs validate ./my-pack --json
node scripts/taskmaster.mjs task-packs install ./my-pack --json

Task Pack 定义可复用的任务类型。专门的 Skill 教智能体何时使用它们、如何解释结果以及适用哪些平台规则。两者都不应重建 Manager 启动、浏览器生命周期、任务跟踪、诊断或清理。

宿主集成

即使特定宿主的 MCP 适配器尚不可用，浏览器运行时仍可通过其固定 CLI 使用。

验证与关闭

运行完整的本地门禁：

npm run check

它涵盖静态边界、单元/集成/安全测试、真实 Chromium 验收测试以及并发/故障/重启工作负载。GitHub CI 在 Node.js 20 和 22 上验证 Windows、macOS 和 Linux。发布版本经过人工授权、校验和保护且不可变。

安全停止 Manager：

node scripts/taskmaster.mjs manager stop --json

从 skills/eric-task-master/SKILL.md 开始。技术细节位于 ARCHITECTURE.md、docs/MCP.md 和 docs/RELEASE-GATE.md。

许可证

MIT。在 Task Master 之上使用、修改、分发并构建开源或专有的 Skill 和 Task Pack。