Server API — Development skill for Claude Code

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

A2S server-api

中文

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

`server-api` 是 A2S 的统一服务器端：接收本机 Claude Code、Codex、DeepSeek Harness 桥接器的主动连接，为浏览器或其他设备提供同一套控制 API，并附带多 Agent Web 控制台。

默认统一基路径是 `/a2s-api`。为了兼容已有 dsh2server 部署，`/dsh-api` 仍作为完整别名工作。

架构

cc2server ───┐
codex2server ├── WSS 或 HTTPS 长轮询 ──► server-api ──► Web 控制台
dsh2server ──┘                               │
                                            └──► REST / SSE 客户端

• Agent 始终主动连出，服务器不反向访问本机。
• WebSocket 是首选载体；/events + /inbox 提供功能等价的 HTTP 回退。
• 一个 a2sk_ key 可以绑定同设备的多个 Agent 实例。
• 每个实例仍有独立方法目录、能力位、会话、事件序号和订阅。
• 服务器不持久化会话正文，只持久化 key 白名单、服务器配置和控制台归档索引。

快速启动

要求 Node.js 20+：

cd server-api
npm install

本机明文测试

PowerShell：

$env:A2S_SERVER_NO_TLS = '1'
$env:A2S_SERVER_HOST = '127.0.0.1'
$env:A2S_SERVER_PORT = '50443'
$env:A2S_SERVER_DATA_DIR = "$PWD\.runtime-local"
npm start

Bash：

A2S_SERVER_NO_TLS=1 \
A2S_SERVER_HOST=127.0.0.1 \
A2S_SERVER_PORT=50443 \
A2S_SERVER_DATA_DIR="$PWD/.runtime-local" \
npm start

启动后：

用途	地址