Hermes Agent 网关（api_server，默认端口 8642，API Key 鉴权）的 Android 手机客户端。
功能与界面对标 Hermes Studio（对话流式、工具追踪、审批、斜杠指令、用量统计、技能/模型浏览、墨水风主题），并加入移动端原生创新：系统通知、审批震动、图片发送、草稿、置顶、多连接配置。
| 页面 | 能力 | 对应 API |
|---|---|---|
| 聊天 | SSE 流式对话、工具调用折叠卡、思考折叠、审批（经任务页）、停止、图片发送、会话分组/搜索/置顶/重命名/分叉/结束/删除、草稿、斜杠指令、连接状态灯 | /api/sessions/* |
| 终端 | 伪终端（run 代执行 shell，原样返回 stdout/stderr，历史 50 条） | /v1/runs/* |
| 任务 | run 提交/实时事件流/审批（四选项）/中断，系统通知 + 震动 | /v1/runs/* |
| 定时 | cron 任务管理、调度中文描述、倒计时、技能/重复表单、最近执行摘要 | /api/jobs/* |
| 更多→技能 | 技能库浏览（分类分组 + 搜索） | /v1/skills |
| 更多→模型 | 模型/路由别名、工具集、API 能力清单 | /v1/models 等 |
| 更多→用量 | token/费用聚合、30 天输出柱状图、模型分布（客户端聚合） | /api/sessions |
| 更多→设置 | 多连接配置、外观（墨水风/彩色 + 深浅色）、服务器信息、关于 | /health/*, /v1/* |
Hermes 网关需启用 API server（在 ~/.hermes/.env 或 $HERMES_HOME/.env）：
API_SERVER_ENABLED=true
API_SERVER_HOST=0.0.0.0 # 手机走局域网/Wi-Fi 连接时必须
API_SERVER_PORT=8642
API_SERVER_KEY=<强随机密钥> # 必填且 ≥16 字符，否则服务拒绝启动
改完后重启网关。手机与电脑在同一 Wi-Fi 下，App 设置页填
http://<电脑局域网IP>:8642 和上面的 Key 即可。
安全提示：该端点能驱动 agent 的终端/文件工具。
0.0.0.0仅建议可信家庭网络， 公网访问请改走 cloudflared tunnel / WireGuard / Tailscale，不要直接把 8642 暴露到公网。
在隧道 config.yml 的 ingress 里加一条指向 8642 的 hostname（放在兜底规则之前）：
ingress:
- hostname: ahov12.cc.cd
service: http://127.0.0.1:8648
- hostname: <你的API域名>
service: http://127.0.0.1:8642
- service: http_status:404然后 cloudflared tunnel route dns <隧道名> <你的API域名> 并重启 cloudflared。
App 设置页新建一套配置：https://<你的API域名> + 同一个 API Key，
与局域网配置一键切换。隧道自带 TLS，密钥鉴权不变。
- Cloudflare Bot Fight Mode 会按 UA 拦截 API 流量（dart:io 默认 UA 实测返回 403 / error code 1010）。App 已内置浏览器 UA，可直接穿透，无需额外配置。
- 根治建议：Cloudflare 控制台 → 域名 → Security → WAF → Custom rules →
新建规则
http.host eq "api.ahov12.cc.cd"→ Action 选 Skip 并勾选跳过 所有安全特性。配好 WAF 规则后 UA 伪装就不再是必须的。 - 隧道上传大 body（>约 4MB）会被断开。App 已把发送的图片压缩到 1280px / 70 质量，正常拍照发送不会触到该上限。
仓库内置 .github/workflows/build.yml：
- 把本项目推到 GitHub：
git init && git add -A && git commit -m init && git remote add origin <repo> && git push -u origin main - Actions 自动跑：生成 Android 脚手架（
flutter create，版本永远与 stable 匹配）→ 注入 INTERNET 权限与明文 HTTP 允许 → analyze → test →flutter build apk --release - 在 Actions 运行页的 Artifacts 下载
hermes-mobile-apk（app-release.apk），装到手机即可
也可在 Actions 页手动 Run workflow 触发。
Release APK 使用 Flutter 模板默认的 debug 签名，仅供个人安装使用。 上架/正式分发请在
android/app/build.gradle配置正式签名（可先本地flutter create生成 android/ 再改）。
flutter create --platforms android --project-name hermes_mobile .
# 同样需要在 android/app/src/main/AndroidManifest.xml 加 INTERNET 权限和
# android:usesCleartextTraffic="true"（CI 会自动做，本地手动加一次即可）
flutter pub get
flutter run # 调试
flutter build apk # 出包lib/
main.dart # 应用外壳 + 底部导航
api.dart # Hermes API 客户端（REST + SSE 解析）
models.dart # 数据模型
state.dart # 连接配置（shared_preferences 持久化）
pages/
chat_page.dart # 会话 + 流式对话
runs_page.dart # 任务 + 审批
jobs_page.dart # 定时任务
settings_page.dart # 连接配置 + 服务器信息
test/ # 解析单元测试 + 启动冒烟测试
.github/workflows/ # CI 编译 APK