A2s App — Development skill for Claude Code

[中文](#中文) | [English](#english)

A2S 手机端

中文

A2S 生态（同系列开源仓库）

A2S 按组件拆分为以下同系列仓库，所有者均为 `23J1633`。/ A2S is split into the following sibling repositories, all owned by `23J1633`.

仓库 / Repository	作用 / Role	GitHub
A2Switch	Windows 桌面控制中心 / Windows desktop control center	23J1633/A2Switch
cc2server	Claude Code 桥接器 / Claude Code bridge	23J1633/cc2server
codex2server	Codex 桥接器 / Codex bridge	23J1633/codex2server
dsh2server	DeepSeek Harness 插件 / DeepSeek Harness plugin	23J1633/dsh2server
server-api	中转服务与 Web 控制台 / relay server and Web console	23J1633/server-api
a2s_app	Flutter Android 客户端 / Flutter Android client	23J1633/a2s_app

`a2s_app` 是 A2S 的 Flutter Android 控制端，Android application ID 为 `io.a2s.mobile`。它沿用服务器网页端的工作流：先选择设备，再单独选择设备上的智能体，进入聊天；左侧抽屉集中管理历史会话、统计、设置和扫码配对。界面使用 Material 3，支持浅色、深色、系统主题、动态取色、减少动画和真实品牌图标。

已实现能力

• 服务器地址和管理员 key 手动登录；管理员 key 只用于登录和查看设备摘要。
• 设备 key 二次解锁；未解锁设备不能读取会话、工作区、文件、任务、终端或下发命令。
• 一次性二维码配对：支持相机扫描和相册图片识别，二维码刷新、过期、重复兑换和撤销均有明确提示。
• 设备与智能体分离选择，内置 Claude、OpenAI Codex、DeepSeek Harness 的真实 SVG 品牌图标。
• 聊天、流式事件、停止/中断、历史搜索、重命名、分叉、归档/恢复、附件、Markdown、工具调用、审批和结构化提问。
• 工作区目录和文本预览、运行轨迹、任务/目标、模型/权限/审批设置、插件配置、统计、日志和高级方法调试。
• 真实远程终端：xterm 显示、命令发送、Ctrl/Esc/Tab、方向键、尺寸同步、保活、回放和断线重连。
• 服务器管理页：管理员 key 只在内存中使用，可查看/重命名/撤销移动设备，登记/吊销设备 key，生成或作废配对二维码并读取服务日志。
• SSE 事件序号去重、断线回拉、请求幂等、手机心跳、草稿按服务器/设备/智能体/会话隔离保存。

连接地址

在 App 中填写服务器的完整插件端点，例如：

http://127.0.0.1:50443/a2s-api

App 会在该地址后使用 `/mobile/v1` 手机协议；`/dsh-api` 别名同样支持。Pixel 9 Pro 模拟器本地联调使用：

adb reverse tcp:50443 tcp:50443

然后在 App 中填写 `http://127.0.0.1:50443/a2s-api`。生产环境应使用 HTTPS，系统证书校验保持开启。

手动连接与扫码配对

手动连接需要管理员 key；登录后只能看到设备摘要。点击设备并输入 A2Switc