Files
workphone-sdk/sdk/android-ui

工作手机 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.tsWorkphoneSnapshot 为准。

performAction() 推荐返回:

{
  "success": true,
  "code": 200,
  "message": "操作已提交",
  "data": {}
}

动作清单

页面 action
通用 refresh_snapshotopen_settings
工作台 scan_bindreconnect_wechat
Agent open_agent_settingstoggle_auto_discoverytoggle_auto_routetoggle_auto_reconnecttoggle_heartbeattoggle_self_healingtoggle_boot_startopen_server_settingsopen_token_settingstest_connection
设备 open_device_settingscopy_fingerprintopen_permission:rootopen_permission:hookopen_permission:accessibilityopen_permission:notificationsopen_permission:bootopen_permission:batteryreconnect_platformreconnect_agenttest_sdk_connectionrestart_fridaopen_logscheck_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 和视觉回归测试。