zoushiyang/page-agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'main' into feat/ext

Browse Source
This commit is contained in:
Simon
2026-01-21 01:26:56 +08:00
parent 4200c78327 897b919044
commit 5210a6edff
16 changed files with 84 additions and 64 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
.vscode/settings.json vendored
View File

@@ -6,6 +6,7 @@
"HITL",
"innerhtml",
"llms",
"npmmirror",
"onwarn",
"opensource",
"qwen",

18
AGENTS.md
View File

@@ -74,28 +74,14 @@ const pageInfo = await this.pageController.getPageInfo()
3. **LLM Processing**: AI returns action plans (page-agent)
4. **Indexed Operations**: PageAgent calls PageController by element index
### IIFE Builds (`packages/page-agent/dist/iife/`)
Two IIFE builds for script tag usage:
| Build | File | Description |
| ----- | -------------------- | -------------------------------- |
| Demo | `page-agent.demo.js` | Auto-init with built-in test API |
| Full | `page-agent.js` | Exposes `PageAgent` class only |
Demo build supports query params (e.g., `?model=gpt-4&lang=en-US`).
Build with `npm run build:iife --workspace=page-agent`.
## Key Files Reference
### Page Agent (`packages/page-agent/`)
| File | Description |
| ------------------------ | -------------------------------------------- |
| ------------------ | -------------------------------------------- |
| `src/PageAgent.ts` | ⭐ Main class with UI, extends PageAgentCore |
| `src/entry-iife.ts` | IIFE entry (exposes PageAgent class) |
| `src/entry-iife-demo.ts` | IIFE demo entry (auto-init with demo API) |
| `src/demo.ts` | IIFE demo entry (auto-init with demo API) |
### Core (`packages/core/`)

4
CONTRIBUTING.md
View File

@@ -122,13 +122,13 @@ npm start
- Start and serve a local `iife` script
```bash
npm run dev:iife # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.js
npm run dev:demo # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.demo.js
```
- Add a new bookmark
```javascript
javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5174/page-agent.js?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5174/page-agent.demo.js?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
```
- Click the bookmark on any page to load Page-Agent

8
README-zh.md
View File

@@ -37,7 +37,7 @@
```html
<script
src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js"
src="https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js"
crossorigin="true"
></script>
```
@@ -45,9 +45,9 @@
> ⚠️ **仅用于技术评估。** Demo 模型有速率限制和使用限制，生产环境请使用 NPM 方式。
| 镜像 | URL |
| ------ | ----------------------------------------------------------------------------------- |
| Global | https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js |
| China | https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js |
| ------ | ----------------------------------------------------------------------------------------- |
| Global | https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js |
| China | https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js |
### NPM 安装

8
README.md
View File

@@ -37,7 +37,7 @@ Fastest way to try PageAgent:
```html
<script
src="https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js"
src="https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js"
crossorigin="true"
></script>
```
@@ -45,9 +45,9 @@ Fastest way to try PageAgent:
> ⚠️ **For technical evaluation only.** Demo model has rate limits and usage restrictions. Use NPM for production.
| Mirrors | URL |
| ------- | ----------------------------------------------------------------------------------- |
| Global | https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js |
| China | https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js |
| ------- | ----------------------------------------------------------------------------------------- |
| Global | https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js |
| China | https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js |
### NPM Installation

28
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{
"name": "root",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "root",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT",
"workspaces": [
"packages/page-controller",
@@ -11628,11 +11628,11 @@
},
"packages/core": {
"name": "@page-agent/core",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT",
"dependencies": {
"@page-agent/llms": "1.0.0-beta.1",
"@page-agent/page-controller": "1.0.0-beta.1",
"@page-agent/llms": "1.0.0-beta.2",
"@page-agent/page-controller": "1.0.0-beta.2",
"chalk": "^5.6.2",
"zod": "^4.3.5"
}
@@ -11684,7 +11684,7 @@
},
"packages/llms": {
"name": "@page-agent/llms",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT",
"dependencies": {
"chalk": "^5.6.2",
@@ -11692,20 +11692,20 @@
}
},
"packages/page-agent": {
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT",
"dependencies": {
"@page-agent/core": "1.0.0-beta.1",
"@page-agent/llms": "1.0.0-beta.1",
"@page-agent/page-controller": "1.0.0-beta.1",
"@page-agent/ui": "1.0.0-beta.1",
"@page-agent/core": "1.0.0-beta.2",
"@page-agent/llms": "1.0.0-beta.2",
"@page-agent/page-controller": "1.0.0-beta.2",
"@page-agent/ui": "1.0.0-beta.2",
"chalk": "^5.6.2",
"zod": "^4.3.5"
}
},
"packages/page-controller": {
"name": "@page-agent/page-controller",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT",
"dependencies": {
"ai-motion": "^0.4.8"
@@ -11713,12 +11713,12 @@
},
"packages/ui": {
"name": "@page-agent/ui",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"license": "MIT"
},
"packages/website": {
"name": "@page-agent/website",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"dependencies": {
"@radix-ui/react-icons": "^1.3.2",
"@radix-ui/react-separator": "^1.1.8",

4
package.json
View File

@@ -1,7 +1,7 @@
{
"name": "root",
"private": true,
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"workspaces": [
"packages/page-controller",
@@ -30,7 +30,7 @@
"build:website": "npm run build:website --workspace=@page-agent/website",
"build:libs": "npm run build --workspaces --if-present",
"build": "npm run build:libs && npm run build:website",
"dev:iife": "npm run dev:iife --workspace=page-agent",
"dev:demo": "npm run dev:demo --workspace=page-agent",
"version": "node scripts/sync-version.js",
"lint": "eslint .",
"prepare": "husky"

6
packages/core/package.json
View File

@@ -1,7 +1,7 @@
{
"name": "@page-agent/core",
"private": false,
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"main": "./dist/esm/page-agent-core.js",
"module": "./dist/esm/page-agent-core.js",
@@ -45,7 +45,7 @@
"dependencies": {
"chalk": "^5.6.2",
"zod": "^4.3.5",
"@page-agent/llms": "1.0.0-beta.1",
"@page-agent/page-controller": "1.0.0-beta.1"
"@page-agent/llms": "1.0.0-beta.2",
"@page-agent/page-controller": "1.0.0-beta.2"
}
}

2
packages/llms/package.json
View File

@@ -1,6 +1,6 @@
{
"name": "@page-agent/llms",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"main": "./dist/lib/page-agent-llms.js",
"module": "./dist/lib/page-agent-llms.js",

10
packages/page-agent/package.json
View File

@@ -1,7 +1,7 @@
{
"name": "page-agent",
"private": false,
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"main": "./dist/esm/page-agent.js",
"module": "./dist/esm/page-agent.js",
@@ -46,9 +46,9 @@
"dependencies": {
"chalk": "^5.6.2",
"zod": "^4.3.5",
"@page-agent/llms": "1.0.0-beta.1",
"@page-agent/page-controller": "1.0.0-beta.1",
"@page-agent/core": "1.0.0-beta.1",
"@page-agent/ui": "1.0.0-beta.1"
"@page-agent/llms": "1.0.0-beta.2",
"@page-agent/page-controller": "1.0.0-beta.2",
"@page-agent/core": "1.0.0-beta.2",
"@page-agent/ui": "1.0.0-beta.2"
}
}

1
packages/page-agent/src/demo.ts
View File

@@ -41,6 +41,7 @@ setTimeout(() => {
// Create agent
window.pageAgent = new PageAgent(config)
window.pageAgent.panel.show()
console.log('🚀 page-agent.js initialized with config:', window.pageAgent.config)
})

2
packages/page-controller/package.json
View File

@@ -1,6 +1,6 @@
{
"name": "@page-agent/page-controller",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"main": "./dist/lib/page-controller.js",
"module": "./dist/lib/page-controller.js",

2
packages/ui/package.json
View File

@@ -1,6 +1,6 @@
{
"name": "@page-agent/ui",
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"main": "./dist/lib/page-agent-ui.js",
"module": "./dist/lib/page-agent-ui.js",

2
packages/website/package.json
View File

@@ -1,7 +1,7 @@
{
"name": "@page-agent/website",
"private": true,
"version": "1.0.0-beta.1",
"version": "1.0.0-beta.2",
"type": "module",
"scripts": {
"dev": "vite --host 0.0.0.0",

5
packages/website/src/constants.ts
View File

@@ -1,7 +1,8 @@
// Demo build (auto-init with demo LLM, for quick testing)
export const CDN_DEMO_URL = 'https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js'
export const CDN_DEMO_URL =
'https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js'
export const CDN_DEMO_CN_URL =
'https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js'
'https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js'
// Demo LLM for website testing
export const DEMO_MODEL = 'PAGE-AGENT-FREE-TESTING-RANDOM'

39
scripts/sync-version.js
View File

@@ -9,6 +9,7 @@
import chalk from 'chalk'
import { existsSync, readFileSync, readdirSync, writeFileSync } from 'fs'
import { dirname, join } from 'path'
import { exit } from 'process'
import { fileURLToPath } from 'url'
const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -17,17 +18,23 @@ const rootDir = join(__dirname, '..')
// Parse arguments
const versionArg = process.argv[2]
if (!versionArg) {
console.log(chalk.yellow('⚠️ No version specified.\n'))
exit(1)
}
// Read root package.json
const rootPkgPath = join(rootDir, 'package.json')
const rootPkg = JSON.parse(readFileSync(rootPkgPath, 'utf-8'))
const newVersion = versionArg || rootPkg.version
const oldVersion = rootPkg.version
const newVersion = versionArg
console.log(chalk.cyan.bold('\n📦 Syncing version\n'))
// Update root package.json if new version specified
if (versionArg) {
rootPkg.version = newVersion
writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, '\t') + '\n')
writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, ' ') + '\n')
console.log(chalk.green('✓') + ` ${chalk.bold('root')} → ${chalk.yellow(newVersion)}`)
} else {
console.log(chalk.dim(' root:') + ` ${chalk.yellow(newVersion)} ${chalk.dim('(source)')}`)
@@ -69,7 +76,6 @@ for (const pkg of packages) {
if (!existsSync(pkgPath)) continue
const pkgJson = JSON.parse(readFileSync(pkgPath, 'utf-8'))
const oldVersion = pkgJson.version
let pkgChanged = false
// Update package version
@@ -88,7 +94,7 @@ for (const pkg of packages) {
continue
}
writeFileSync(pkgPath, JSON.stringify(pkgJson, null, '\t') + '\n')
writeFileSync(pkgPath, JSON.stringify(pkgJson, null, ' ') + '\n')
console.log(
chalk.green('✓') +
` ${chalk.bold(pkgJson.name)}: ${chalk.dim(oldVersion)} → ${chalk.yellow(newVersion)}`
@@ -96,6 +102,31 @@ for (const pkg of packages) {
hasChanges = true
}
// Update CDN URLs in documentation and source files
const CDN_DEMO_URL_OLD = `https://cdn.jsdelivr.net/npm/page-agent@${oldVersion}/dist/iife/page-agent.demo.js`
const CDN_DEMO_URL_NEW = `https://cdn.jsdelivr.net/npm/page-agent@${newVersion}/dist/iife/page-agent.demo.js`
const CDN_DEMO_CN_URL_OLD = `https://registry.npmmirror.com/page-agent/${oldVersion}/files/dist/iife/page-agent.demo.js`
const CDN_DEMO_CN_URL_NEW = `https://registry.npmmirror.com/page-agent/${newVersion}/files/dist/iife/page-agent.demo.js`
const filesToUpdateCdn = ['README.md', 'README-zh.md', 'packages/website/src/constants.ts']
for (const relPath of filesToUpdateCdn) {
const filePath = join(rootDir, relPath)
if (!existsSync(filePath)) continue
let content = readFileSync(filePath, 'utf-8')
const original = content
content = content.replaceAll(CDN_DEMO_URL_OLD, CDN_DEMO_URL_NEW)
content = content.replaceAll(CDN_DEMO_CN_URL_OLD, CDN_DEMO_CN_URL_NEW)
if (content !== original) {
writeFileSync(filePath, content)
console.log(chalk.green('✓') + ` ${chalk.bold(relPath)}: CDN URLs updated`)
hasChanges = true
}
}
console.log(chalk.green.bold(`\n✓ Version synced: ${newVersion}\n`))
// Show git commands hint