zcode-daili / src /android /AGENTS.md
bolikoto's picture
chore(zcode): 升级上游至 v4.8.5 并保留多账号兼容
488aedf verified
|
Raw History Blame Contribute Delete
1.48 kB
# src/android/ — loopback 控制协议(Kotlin 对端)
> 维护基线:2026-10-20,工作区基于 e025baa(4.8.2)。Kotlin 侧见 Android-APP/AGENTS.md。
## FILES
| 文件 | 角色 |
|---|---|
| control.ts | `dispatch` 10 命令表 + `createControlDispatcher` 状态机 + `startControlListener` node:http 监听 + `LogBuffer` |
| control.test.ts | 协议回归 |
## 契约
- 双消费者:index.ts `android` 模式起监听(`ZCODE_CONTROL_PORT`);server/panel.ts **进程内**复用 `createControlDispatcher`(浏览器对 loopback POST `/api/control`——无第二控制端口)。
- 命令面:start/stop/status/logs(since 游标增量)/quota(双平面快照)/login/logout/provider/plan/update——**无 shutdown**(Kotlin ControlClient 不发;面板 shutdown 走自身命令链,先应答再 50ms grace)。
- 错误语义:HTTP 200 带内 `{ok:false, error}`(Kotlin 端不检非 200 状态码)。
- **监听永不绑非回环**:bind 恒 127.0.0.1 + 每请求 remoteAddress 复查(双保险,根 ANTI-PATTERNS)。
- quota 命令直连 routes-quota 双平面;上游 billing 限频——仅手动/进屏触发,永不定时轮询。
## WHERE TO LOOK
| 任务 | 位置 |
|---|---|
| 加/改命令 | control.ts `dispatch` 表 + Android-APP ControlClient.kt **同步改**(跨仓契约) |
| 面板命令接线 | server/panel.ts(token 门控先于 dispatcher) |
| 日志游标 | control.ts `LogBuffer`(环形 + since cursor) |