Files
page-agent/README-zh.md
2025-09-29 19:34:37 +08:00

3.0 KiB
Raw Blame History

PageAgent 🤖🪄

banner

npm version License: MIT TypeScript Downloads Bundle Size GitHub stars

一行脚本,让任何网页支持 AI 自动化。

运行在页面内的 UI agent. 使用自然语言操作 Web 应用。

🌐 English | 中文

👉 🚀 Demo | 📖 Documentation


Features

  • 🎯 轻松集成
  • 🔐 端侧运行
  • 🧠 HTML 脱水
  • 💬 自然语言接口
  • 🎨 HITL 交互界面

🗺️ Roadmap

👉 Roadmap

🚀 快速开始

CDN 集成

TODO: CDN 地址待确定。

<!-- CDN 脚本标签 - URL 待更新 -->
<script src="TODO-CDN-URL"></script>

NPM 安装

npm install page-agent
import { PageAgent } from 'page-agent'

const agent = new PageAgent({
  modelName: 'gpt-4.1-mini'
  baseURL: 'xxxx',
  apiKey: 'xxxx'
})

await agent.execute("点击登录按钮")

🏗️ 架构设计

PageAgent 采用清晰的模块化架构:

src/
├── PageAgent.ts          # Agent 主流程
├── dom/                  # DOM 理解
├── tools/                # 代理交互工具
├── ui/                   # UI 组件和面板
├── llms/                 # LLM 集成层
└── utils/                # 事件总线和工具

🤝 贡献

欢迎社区贡献!以下是参与方式:

开发环境

  1. Fork 项目仓库
  2. Clone or fork: git clone https://github.com/alibaba/page-agent.git && cd page-agent
  3. 安装依赖: npm install
  4. 启动开发: npm start

贡献指南

请在贡献前阅读我们的行为准则贡献指南

👏 致谢

本项目基于以下优秀项目构建:

PageAgent 专为客户端网页增强设计,不是服务端自动化工具。

📄 许可证

MIT 许可证 - 详见 LICENSE 文件。

DOM 处理与提示词参考了 browser-useMIT 许可证)。完整归属请见 NOTICE


如果觉得 PageAgent 有用或有趣,请给项目点个星!