外观
本地开发
先启动服务端，再启动或编译目标平台宿主。开发环境与线上使用同一套身份和 HTTP / WebSocket 协议。
服务端
准备 PHP、Composer 与配置好 ngram 的 MySQL，进入 web：
bash
composer install
php start.php start打开 http://127.0.0.1:8787/install 完成安装，后台地址为 http://127.0.0.1:8787/admin/。前台启动会监听文件变化，适合开发；生产使用进程管理。
Windows 使用：
powershell
php windows.php只运行一个聚合入口。终止时在原控制台按 Ctrl+C；修改需要手动重启的进程配置后，等旧进程结束再重新运行。Windows 入口不接受 Linux 的 reload、stop、status 子命令。
客户端地址
| 客户端 | 访问开发机 |
|---|---|
| 本机浏览器 | http://127.0.0.1:8787 |
| Android 标准模拟器 | http://10.0.2.2:8787 |
| 真机 | 同一局域网中开发机的 IP 或可访问的 HTTPS 域名 |
WebSocket 使用对应的 /ws 地址，经 Nginx 代理时与 HTTP 同域。直接访问开发进程时，实时端口为 6060，例如 ws://127.0.0.1:6060。HTTPS 网页必须使用 WSS。
Web SDK 构建需要 Node.js 22.12 或以上和相邻的 uniapp 共享包；各移动端环境见平台接入页。浏览器麦克风和摄像头需安全上下文，真实域名下用 HTTPS 验证。
排查顺序
先确认 /install 或 /admin/ 能打开，再确认宿主登录与换票，最后检查 SDK 首次同步和 WebSocket。SDK Secret 不进入客户端配置；临时将 Secret 写入 App 也不能替代宿主后端。