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)