page-agent-claw 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +64 -5
  2. package/dist/cli/index.js +2 -2
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/client/assets/{index-a72dTDn8.js → index-CqVTXjNz.js} +1 -1
  5. package/dist/client/assets/index-jFEgLbyt.css +1 -0
  6. package/dist/client/index.html +2 -2
  7. package/dist/server/index.d.ts.map +1 -1
  8. package/dist/server/index.js +13 -164
  9. package/dist/server/index.js.map +1 -1
  10. package/dist/server/middleware/proxy.d.ts +3 -0
  11. package/dist/server/middleware/proxy.d.ts.map +1 -0
  12. package/dist/server/middleware/proxy.js +42 -0
  13. package/dist/server/middleware/proxy.js.map +1 -0
  14. package/dist/server/proxy.d.ts +3 -0
  15. package/dist/server/proxy.d.ts.map +1 -0
  16. package/dist/server/proxy.js +42 -0
  17. package/dist/server/proxy.js.map +1 -0
  18. package/dist/server/routes/task.d.ts +3 -0
  19. package/dist/server/routes/task.d.ts.map +1 -0
  20. package/dist/server/routes/task.js +100 -0
  21. package/dist/server/routes/task.js.map +1 -0
  22. package/dist/server/routes.d.ts +3 -0
  23. package/dist/server/routes.d.ts.map +1 -0
  24. package/dist/server/routes.js +73 -0
  25. package/dist/server/routes.js.map +1 -0
  26. package/dist/server/types.d.ts +23 -0
  27. package/dist/server/types.d.ts.map +1 -0
  28. package/dist/server/types.js +2 -0
  29. package/dist/server/types.js.map +1 -0
  30. package/dist/server/websocket/index.d.ts +11 -0
  31. package/dist/server/websocket/index.d.ts.map +1 -0
  32. package/dist/server/websocket/index.js +110 -0
  33. package/dist/server/websocket/index.js.map +1 -0
  34. package/dist/server/websocket/types.d.ts +10 -0
  35. package/dist/server/websocket/types.d.ts.map +1 -0
  36. package/dist/server/websocket/types.js +2 -0
  37. package/dist/server/websocket/types.js.map +1 -0
  38. package/dist/server/websocket.d.ts +10 -0
  39. package/dist/server/websocket.d.ts.map +1 -0
  40. package/dist/server/websocket.js +95 -0
  41. package/dist/server/websocket.js.map +1 -0
  42. package/package.json +1 -1
  43. package/dist/client/assets/index-CeXFQJ9K.css +0 -1
package/README.md CHANGED
@@ -48,18 +48,77 @@ PORT=8080 page-agent-claw
48
48
  |------|------|------|
49
49
  | `/health` | GET | 健康检查 |
50
50
  | `/api/task` | POST | 提交任务 |
51
- | `/api/clients` | GET | 查看连接的客户端 |
51
+ | `/api/clients` | GET | 查看连接的客户端数 |
52
+ | `/api/status` | GET | 状态监测 |
53
+ | `/proxy/:target` | ALL | 代理请求(解决跨域) |
52
54
  | WebSocket | WS | 实时通信(端口 4222) |
53
55
 
56
+ ### POST /api/task
57
+
58
+ 提交任务到已连接的客户端执行。
59
+
60
+ **请求体:**
61
+
62
+ ```json
63
+ {
64
+ "task": "在当前页面执行某个操作",
65
+ "metadata": { }
66
+ }
67
+ ```
68
+
69
+ **响应:**
70
+
71
+ ```json
72
+ {
73
+ "success": true,
74
+ "taskId": "task_1234567890_abc",
75
+ "result": {
76
+ "success": true,
77
+ "data": "执行结果",
78
+ "history": []
79
+ }
80
+ }
81
+ ```
82
+
83
+ ### /api/status 状态码
84
+
85
+ | 状态码 | 含义 |
86
+ |--------|------|
87
+ | 100 | 仅 node 服务启动,无 WebSocket 连接(页面未打开) |
88
+ | 105 | 有 WebSocket 连接,但 page-agent(扩展)未连接 |
89
+ | 200 | 正常(WebSocket + page-agent 已连接) |
90
+
91
+ **响应示例:**
92
+
93
+ ```json
94
+ // 100 无连接
95
+ {"code":100,"message":"请打开 localhost:4222 页面","connectedNumber":0}
96
+
97
+ // 105 有连接但无 page-agent
98
+ {"code":105,"message":"page-agent 未连接","connectedNumber":1}
99
+
100
+ // 200 正常
101
+ {"code":200,"message":"正常","connectedNumber":1,"pageAgentCount":1}
102
+ ```
103
+
54
104
  ## 项目结构
55
105
 
56
106
  ```
57
107
  page-agent-claw/
58
108
  ├── src/
59
- │ ├── server/index.ts # 服务器(Express + WebSocket)
60
- └── cli/index.ts # CLI 入口
61
- ├── client/ # 前端页面源码
62
- ├── dist/ # 构建输出
109
+ │ ├── server/
110
+ │ ├── index.ts # 服务器入口
111
+ │ │ ├── types.ts # 共享类型定义
112
+ │ │ ├── middleware/
113
+ │ │ │ └── proxy.ts # 代理中间件
114
+ │ │ ├── routes/
115
+ │ │ │ └── task.ts # API 路由
116
+ │ │ └── websocket/
117
+ │ │ ├── index.ts # WebSocket 服务
118
+ │ │ └── types.ts # WebSocket 类型
119
+ │ └── cli/index.ts # CLI 入口
120
+ ├── client/ # 前端页面源码(React)
121
+ ├── dist/ # 构建输出
63
122
  └── package.json
64
123
  ```
65
124
 
package/dist/cli/index.js CHANGED
@@ -3,6 +3,7 @@ import { spawn } from 'child_process';
3
3
  import { fileURLToPath } from 'url';
4
4
  import path from 'path';
5
5
  import { createServer } from 'http';
6
+ import { readFileSync } from 'fs';
6
7
  const __filename = fileURLToPath(import.meta.url);
7
8
  const __dirname = path.dirname(__filename);
8
9
  const projectRoot = path.join(__dirname, '../..');
@@ -55,8 +56,7 @@ async function main() {
55
56
  // Check for version flag
56
57
  const args = process.argv.slice(2);
57
58
  if (args.includes('-v') || args.includes('--version')) {
58
- // eslint-disable-next-line @typescript-eslint/no-require-imports
59
- const packageJson = require('../package.json');
59
+ const packageJson = JSON.parse(readFileSync(path.join(projectRoot, 'package.json'), 'utf-8'));
60
60
  console.log(`page-agent-claw v${packageJson.version}`);
61
61
  return;
62
62
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}