Eric Task Master

English | 简体中文

一个为 AI 智能体打造的持久化浏览器自动化任务系统。

版本：2.1.1

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

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

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 进行无需登录的干净任务；

• 并行的可信本地智能体共享一个受管理的 Profile 目录，而不同的实时 Profile 独立运行；同一 Profile 的工作队列安全，任务记录保持可归属；

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

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

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

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

Related MCP server: CloakBrowser MCP

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

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

三层模型

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

2. Owner Console — 一个固定的本地 Web 地址，用于管理共享 Profile、已连接的智能体、实时任务、进度、命令和人类可读的报告。用户直接在隔离的持久化 Playwright Profile 中登录。

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

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

对于 AI 智能体：一个固定的引导协议

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

完整仓库是运行时的唯一事实来源。在 GitHub Release 上，eric-task-master-vX.Y.Z.zip 是完整的可运行项目；eric-task-master-skill-vX.Y.Z.zip 仅是可选智能体指令适配器，不能独立运行。SHA256SUMS 验证两个归档。克隆匹配的标签或下载完整的项目归档——不要用仅 Skill 的归档替代运行时。

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. 打开返回的 Owner Console 链接一次。它会静默建立持久的本地会话；无需输入代码或进行智能体绑定流程。将 http://127.0.0.1:19946/dashboard 加入书签以备后用。

8. 如果主机报告 registered_pending_restart，请要求用户重新加载该智能体主机一次。如果本次运行中无法重新加载，请使用作用域 CLI 并仅为此任务使用一个稳定的智能体 ID，然后在下次重启后使用 MCP 处理新任务。

9. 选择一条操作路径并保持用于该任务：

   • 如果主机加载了已注册的 MCP 服务器，请调用 taskmaster_status，然后调用 taskmaster_profiles_list；

   • 如果主机报告 needs_adapter，或本次运行中无法重新加载待处理的注册，请使用仓库根目录的固定 CLI。在每个作用域命令上保持一个稳定、不同的智能体 ID：

     node scripts/taskmaster.mjs status --agent-id STABLE_ID --agent-name AGENT_NAME --json
     node scripts/taskmaster.mjs profiles list --agent-id STABLE_ID --agent-name AGENT_NAME --json

10. 当状态和 Profile 发现成功时，询问用户要运行什么浏览器任务。在一个任务中不要混合 MCP 和 CLI 身份。

可复制的新智能体请求：

安装并启动 https://github.com/npcworkspace-cmyk/eric-task-master。克隆完整仓库，阅读或安装 skills/eric-task-master，并且只运行 node scripts/taskmaster.mjs connect --json。不要发明其他控制器或端口。在支持时使用已加载的 MCP 路径；在 needs_adapter 时，遵循 Skill 的固定 CLI 路径，并使用一个稳定、不同的智能体 ID。返回 Owner Console 链接；在状态和 Profile 发现成功后，询问我想运行什么任务。

日常使用

首次引导后，用户应该能够自然地提出请求：

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

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

每次任务启动都会返回一个聚焦于该任务的可点击 Owner Console 链接。第一个链接会静默建立本地 Owner cookie；后续访问可以使用固定的书签地址。如果用户说“启动任务面板”，请使用 MCP taskmaster_dashboard_open 或 CLI node scripts/taskmaster.mjs dashboard-open [TASK_ID] --agent-id STABLE_ID --agent-name AGENT_NAME --json，然后返回链接。Task Master 不会自动打开操作系统浏览器。

Profiles

• 持久化 — 为登录和重复性工作提供隔离的可复用状态；从 Dashboard 打开它，并直接在其 Playwright 窗口中登录；

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

新的持久化 Profile 默认使用本地稳定的 Chrome 频道和固定的 human 行为。新的临时 Profile 默认使用项目固定的 Chromium 和 adaptive 行为，Profile 上可选择 fast、adaptive 或 human。引擎是不可变的，永远不会自动回退。手动持久化 Profile 窗口始终可见；headless 仅影响任务运行。

行为

• fast — 可选的优先速度策略，适用于临时 Profile 和确定性、数据密集型工作；

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

• adaptive — 以快速开始，在动态页面信号、遮挡、超时、不确定导航、操作失败或速率限制后，暂时变得谨慎或采用人类节奏。

人类节奏是一种可靠性策略，并非绕过网站控制或保护账户免受平台执法的承诺。 行为在 Profile 上选择；任务启动不接受行为覆盖。

多智能体工作台

• Profiles 由所有可信本地智能体共享；没有无意义的“Profile 创建者”字段。一个 Profile 仍然有一个实时租约，因此两个智能体不能破坏相同的登录状态。

• Owner Console 显示哪些智能体已注册、在线、离线、工作中或已撤销，以及它们的活动任务、Profiles 和队列深度。

• 任务工作台显示 Playwright 当前正在做什么、进度、限制、恢复状态和时间线。Owner 可以暂停、恢复、终止、修改排队的输入，或发送询问/修改指令。

• 命令是持久的并经过修订检查。活动智能体通过其等待/收件箱循环立即收到命令；离线智能体在重新连接后收到命令。Task Master 不会假装它可以唤醒完全关闭的主机进程。

• 完成的工作在智能体的人类可读报告中打开。代码、日志、截图、工件和诊断信息作为次要证据保留，而不是成为“结果”。

构建专门的生产工作器

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

node scripts/taskmaster.mjs task-packs scaffold ./my-pack --name my-pack --recipe paginated-list --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 使用。每个作用域 CLI 命令都需要为每个独立智能体提供一个稳定、不同的 --agent-id；所有智能体共享 Profile 目录，而重用 ID 会故意共享该身份的任务账本和 Owner 收件箱。有关完整的非 MCP 命令路径及其可信本地边界，请参阅 docs/MCP-HOSTS.md。

验证与关闭

运行完整的本地门禁：

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 使用、修改、分发并构建开源或专有 Skills 和 Task Packs。