AgentChat — Free WebSubAgent Workflow

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

什么是 Free WebSubAgent ？

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

📂 Skills 概览

---

🏗️ 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 目录包含：

通过 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 代码）

---

---

🤝 Contributing

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

---

📜 License

MIT © ziwang-Physics