工作手机 Android React UI
Vite + React + TypeScript 实现的工作手机 APK 前端。生产构建输出到 dist/,所有业务图标均为 src/components/Icon.tsx 内联 SVG,运行时不请求外部字体、图片或图标服务。
页面
- 工作台:系统稳定性、平台连接、扫码绑定、绑定信息、微信简要状态、最近事件。
- Agent:连接链路、自动发现、自动选线、断线重连、心跳、自愈、服务器配置和日志。
- 设备:健康度、加密 IMEI、设备指纹、权限、服务连接、扫码绑定和版本维护。
底部菜单固定为:工作台 / Agent / 设备。
原生桥接
前端只读取真实原生数据。桥接缺失、字段缺失或动作失败时显示“不可用”,不生成模拟在线状态。
window.NativeAgent.getSnapshot(): string | object
window.NativeAgent.performAction(action: string): string | object
getSnapshot() 返回 JSON 字符串或对象。支持 camelCase、snake_case 及部分旧字段别名,推荐结构以 src/types/native.ts 的 WorkphoneSnapshot 为准。
performAction() 推荐返回:
{
"success": true,
"code": 200,
"message": "操作已提交",
"data": {}
}
动作清单
| 页面 | action |
|---|---|
| 通用 | refresh_snapshot、open_settings |
| 工作台 | scan_bind、reconnect_wechat |
| Agent | open_agent_settings、toggle_auto_discovery、toggle_auto_route、toggle_auto_reconnect、toggle_heartbeat、toggle_self_healing、toggle_boot_start、open_server_settings、open_token_settings、test_connection |
| 设备 | open_device_settings、copy_fingerprint、open_permission:root、open_permission:hook、open_permission:accessibility、open_permission:notifications、open_permission:boot、open_permission:battery、reconnect_platform、reconnect_agent、test_sdk_connection、restart_frida、open_logs、check_update |
构建
npm install
npm run typecheck
npm run build
本地预览:
npm run preview -- --host 127.0.0.1
可通过 ?tab=workbench、?tab=agent、?tab=device 直接打开指定页面,便于 Android WebView 和视觉回归测试。