Spaces:
Paused
Paused
|
Download src/android/AGENTS.md from bolikoto/zcode-daili: direct link, hf CLI and curl.
- Browser
- Download file 1.48 kB
-
https://huggingface.co/spaces/bolikoto/zcode-daili/resolve/main/src/android/AGENTS.md
- Command line
-
hf download hf://spaces/bolikoto/zcode-daili/src/android/AGENTS.md
-
curl -L -o AGENTS.md https://huggingface.co/spaces/bolikoto/zcode-daili/resolve/main/src/android/AGENTS.md
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) |