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) | | |