AgentChat — Free WebSubAgent Workflow

Claude Code 接低价/免费API做决策分工， Gemini/ChatGPT/Claude 等免费网页 AI 执行子任务。

什么是 Free WebSubAgent ？

🎭一套零成本的 Claude Code 技能套件，通过接管本地 Chrome 浏览器桥接 8 个免费网页 AI
🛡支持串行降级（单模型自动切换）与并行编排（角色分工+证据仲裁)
💸免费额度用尽后自动切换到下一个免费模型

📂 Skills 概览

Skill	类型	职责	何时用
AgentChat-OneWeb	串行降级链	1个ai，7个替补。只使用一个你最喜欢的ai，免费额度耗尽自动切换，8-Provider 自动 fallback	代码 + 多模态
AgentChat-IndependentTasks	并行编排	一次性触发8个ai。默认触发4个，可根据任务数量指定，如16个独立任务让8个Web 端分别执行两个任务	大量高独立性任务
AgentChat-WebSubAgent	串行管道	核心Skill（架构图如下），6 步 AI 管道：你的Agent规划→Kimi 搜索→Gemini 推理→Agent 合成→ChatGPT或Claude 审查	深度推理 + 质量审查

🏗️ Architecture

🚀 Quick Start（5 分钟）

1. 安装

git clone https://github.com/ziwang-Physics/AgentChat.git && cd AgentChat

# Python 依赖（Chrome daemon — 使用系统 Chrome，不需要 Playwright Chromium）
pip3 install playwright websocket-client

# Node.js 依赖（AI bridge — 根目录统一管理 + OneWeb skill）
npm install
(cd skills/AgentChat-OneWeb && npm install)

2. 配置 & 启动

cp .env.example .env           # 按需修改代理地址
bash scripts/setup.sh          # 环境检查
bash scripts/start-chrome-debug.sh  # 启动 Chrome daemon

3. 使用场景

# 单 prompt 高可用 — 自动 fallback
/AgentChat-OneWeb 帮我写Python脚本/根据文字生成视频

# 8 路并发 — 大量高独立性任务
/AgentChat-IndependentTasks 高独立性的多个任务：根据我的任务调用8个ai生成8个脚本/8个视频

# 串行深度管道 — 规划→搜索→推理→合成→审查→修复
/AgentChat-WebSubAgent 帮我设计一个高并发消息队列的架构方案

🧠 Claude Code Integration

本项目是 Claude Code 原生 skill 集合。每个 skill 目录包含：

文件	面向	职责
`SKILL.md`	🤖 AI（Claude Code）	操作指南、触发条件、执行步骤
`index.js`	⚙️ Runtime	Playwright/CDP 实现
`README.md`（本文件）	👤 人类开发者	项目介绍、安装、使用

通过 symlink 将 skills/ 目录链接到 ~/.claude/skills/，Claude Code 即可自主调度这些免费资源。

环境诊断

node skills/AgentChat-OneWeb/index.js --smoke     # 遍历 8 个 provider
node skills/AgentChat-OneWeb/index.js --doctor    # CDP 端口连通性检查
node skills/AgentChat-IndependentTasks/index.js --smoke    # 并行编排环境检查
node skills/AgentChat-WebSubAgent/index.js --doctor    # 串行管道环境检查

📁 目录结构

AgentChat/
├── .env.example                         # 配置模板
├── .gitignore
├── LICENSE                              # MIT
├── package.json                         # 根依赖（playwright-core，共享 lib 使用）
├── README.md                            # 👤 人类文档
├── 1.png                                # 架构图
├── scripts/
│   ├── setup.sh / setup.bat             # 环境一键检查
│   ├── start-chrome-debug.sh            # Chrome CDP daemon（idempotent, Linux）
│   ├── start-chrome-debug.py            # Python daemon v3 — 事件驱动 Chrome 生命周期管理
│   ├── start-chrome.ps1                 # Windows PowerShell 启动
│   └── connect-gemini.sh / .ps1         # 一键连接 Gemini
└── skills/
    ├── lib/                               # 🔗 共享库（零代码重复的核心）
    │   ├── execute.js                     #   统一子进程执行器（callProvider / runChain）
    │   ├── providerFactory.js             #   10-step config-driven pipeline
    │   ├── errors.js                      #   ProviderError + 管道阶段追踪
    │   ├── cdp.js                         #   CDP 连接 + 重试 + doctor
    │   ├── terminal.js                    #   终端 spinner + 计时器
    │   ├── telemetry.js                   #   遥测日志轮转
    │   ├── locks.js                       #   文件锁（mkdir 原子性，provider 互斥）
    │   ├── geminiModelSwitch.js           #   Gemini Pro Extended / Flash 模型切换
    │   ├── prompts.js                     #   DAG 拆解 prompt 模板
    │   └── providers/
    │       ├── chain.js                   #   Provider 优先级链（单一真相源）
    │       └── adapters/                  #   8 个 provider config（"单源真相"）
    │           ├── gemini.js              #     Pro Extended + bursty 检测 + safety 过滤
    │           ├── chatgpt.js             #     3-tier 输入 + React send-btn 验证
    │           ├── claude.js              #     ProseMirror + Thinking 占位符过滤
    │           ├── qwen.js                #     React SPA + stop-btn detached
    │           ├── kimi.js                #     新建会话 + 自适应稳定性窗口
    │           ├── minimax.js             #     TipTap 异步挂载
    │           ├── mimo.js                #     DOM 遍历 send button
    │           └── deepseek.js            #     标准管线
    ├── AgentChat-OneWeb/           # 8-Provider Fallback Chain
    │   ├── SKILL.md                     # 🤖 AI 操作指南
    │   ├── index.js                     # 编排入口（~530 行，零 provider 代码）
    │   ├── CHANGELOG.md                 # 变更日志
    │   ├── package.json
    │   └── data/                        # 遥测数据
    ├── AgentChat-IndependentTasks/          # 并行编排器（DAG + 波次调度 + 证据仲裁）
    │   ├── SKILL.md                     # 🤖 AI 操作指南 + 角色分工
    │   └── index.js                     # 薄编排器（~710 行，零 provider 代码）
    └── AgentChat-WebSubAgent/           # 串行 6 步管道
        ├── SKILL.md                     # 🤖 AI 操作指南
        └── index.js                     # 管道 helper（~160 行，零 provider 代码）

🔧 环境要求 & 配置详解

依赖

依赖	安装
Node.js 18+	nodejs.org
Python 3.8+	系统自带
Playwright (Python)	`pip3 install playwright`（daemon 用其 API 启动系统 Chrome）
websocket-client	`pip3 install websocket-client`
playwright-core (npm)	根目录 `npm install`（共享 lib 依赖）

配置变量（`.env`）

变量	默认值	说明
`CDP_PORT`	`9222`	Chrome DevTools Protocol 端口
`PROXY_SERVER`	`http://127.0.0.1:7897`	代理地址（中国大陆必须）
`CHROME_PROFILE`	`~/.chrome-debug-profile`	Chrome 持久化 Profile
`CHROMIUM_PATH`	无（必须手动设置）	系统 Chrome 可执行文件路径
`LOG_FILE`	`/tmp/chrome-debug.log`	诊断日志

🔐 AI 网页登录

首次使用前，在 Chrome 中手动登录以下 AI 网页（登录态保存在 CHROME_PROFILE，只需一次）：

AI	登录地址	账号类型
Gemini	gemini.google.com/u/0/app	Google 账号（免登录仅 Flash 模型）
ChatGPT	chatgpt.com	OpenAI 账号
Claude	claude.ai	Anthropic 账号
Qwen	www.qianwen.com	阿里云/淘宝
Kimi	kimi.moonshot.cn	微信/手机号
MiniMax	agent.minimaxi.com	手机号
MiMo	aistudio.xiaomimimo.com	小米账号
DeepSeek	chat.deepseek.com	微信/手机号

也可以将账号密码写入环境变量交给 Agent 自动登录（.env.example提供示例）。

🇨🇳 中国网络环境特别说明

GFW 会阻断 Chrome 启动时向 Google 云端发起的 SSL 请求，导致 Chrome 进入 fail-safe 模式（Gemini tab 显示 about:blank）。

必须做的：

.env 中 PROXY_SERVER 配置正确的 HTTP/SOCKS5 代理
严禁使用 VLESS Reality — TLS spoofing 与 Chrome BoringSSL 冲突

如果仍然 about:blank：

pkill -9 chrome && bash scripts/start-chrome-debug.sh

详见 skills/AgentChat-OneWeb/SKILL.md → 各 Provider 实现说明。

🛠️ 故障排查

症状	原因	修复
Gemini tab `about:blank`	Chrome 3-layer fail-safe	`pkill -9 chrome && bash scripts/start-chrome-debug.sh`
`ERR_BLOCKED_BY_CLIENT`	Safe Browsing	检查 flags 含 `--disable-features=OptimizationHints`
SSL `net_error -100`	GFW RST 或 Reality TLS 冲突	用 HTTP/SOCKS5 代理，不用 VLESS Reality
`MODULE_NOT_FOUND: playwright-core`	npm 依赖未安装	根目录 `npm install`

手动管理

# 查看 daemon 状态
curl -s http://127.0.0.1:9222/json/list | python3 -c "
import json,sys
[print(f'{p[\"title\"]} | {p[\"url\"]}') for p in json.load(sys.stdin) if p.get('type')=='page']
"

# 查看日志
cat /tmp/chrome-debug.log

# 完全重启
pkill -9 -f "start-chrome-debug.py" && pkill -9 chrome
sleep 2 && bash scripts/start-chrome-debug.sh

🤝 Contributing

欢迎提 Issue 和 PR。新增 provider 请在 lib/providers/adapters/ 中添加 adapter config（参考现有 8 个），编排层改动请保持 IndependentTasks 的零 provider 代码原则。

Name		Name	Last commit message	Last commit date
agentchat		agentchat
demo		demo
scripts		scripts
skills		skills
test		test
.env.example		.env.example
.gitignore		.gitignore
1.png		1.png
DEMO.md		DEMO.md
DEMO_PITFALLS.md		DEMO_PITFALLS.md
INTERVIEW_QA.md		INTERVIEW_QA.md
LICENSE		LICENSE
PR_v5.md		PR_v5.md
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Repository files navigation

AgentChat — Free WebSubAgent Workflow

什么是 Free WebSubAgent ？

📂 Skills 概览

🏗️ Architecture

🚀 Quick Start（5 分钟）

1. 安装

2. 配置 & 启动

3. 使用场景

🧠 Claude Code Integration

环境诊断

📁 目录结构

依赖

配置变量（`.env`）

🔐 AI 网页登录

手动管理

🤝 Contributing

📜 License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

AgentChat — Free WebSubAgent Workflow

什么是 Free WebSubAgent ？

📂 Skills 概览

🏗️ Architecture

🚀 Quick Start（5 分钟）

1. 安装

2. 配置 & 启动

3. 使用场景

🧠 Claude Code Integration

环境诊断

📁 目录结构

依赖

配置变量（.env）

🔐 AI 网页登录

手动管理

🤝 Contributing

📜 License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

配置变量（`.env`）