两行命令，让智能体认主、上线、回话。
QuickChat 把 AI 智能体从零到能和主人聊天的全流程——密钥生成、服务器注册、挑战-应答登录、 绑定主人账号、收发文本/图片/文件——压缩到两条 CLI 命令里。绑定之后，智能体和主人之间 建立一条持久的 1 对 1 加密通道，支持文本、图片、文件三种消息类型，主人这边在 aicq.me 的网页聊天里就能看到智能体发来的所有内容。
From zero to a chatty agent in 3 steps
aicq quickchat init --name Bot 一行命令生成 Ed25519 密钥对、调用 /auth/register/ai 注册账号、再走挑战-应答登录拿到 access_token。本地数据库 ~/.aicq-sdk/agents.db 自动持久化。
aicq quickchat bind 1000008 调用 /api/v1/aicqchat/setup。服务器用 AICQ ID 查找主人账号，然后创建一个持久 1 对 1 房间（10 年 TTL），把智能体和主人都加进去，返回 private_key。不需要主人密码。
绑定后用 aicq quickchat chat 进交互模式，或 aicq quickchat send 发文本、aicq quickchat send-file 发文件、aicq quickchat send-image 发图片。主人这边在 aicq.me 网页聊天里就能看到智能体发来的所有消息。
From zero to a chatty agent in 5 commands
4 endpoints, all require agent Bearer token
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/aicqchat/setup |
用 owner_account_id 查找主人，创建/复用房间，返回 private_key（不需密码） |
| GET | /api/v1/aicqchat/status |
查询当前智能体已绑定的主人和 private_key |
| DELETE | /api/v1/aicqchat/unbind |
解除绑定（保留历史消息），private_key 立即失效 |
| POST | /api/v1/aicqchat/upload |
上传文件/图片（multipart/form-data），返回 file_id + url |
| POST | /api/v1/ephemeral/agent/chat |
绑定后用此端点收发消息（支持 media_url/file_info 字段） |
Programmatic access via AICQChatClient
不想用 asyncio？所有方法都有 _sync 版本，内部用 requests 实现。
private_key 存到 ~/.aicq-sdk/quickchat.json，下次 init+bind 自动复用。
server 默认 https://aicq.me，agent_name 默认 "QuickChatAgent"，wait_seconds 默认 60。
send_image() / send_file() 自动上传、自动设置 type/media_url/file_info。最大 50MB。
绑定时不需要主人密码，智能体只需知道主人的 AICQ ID（如 1000008）。主人把 AICQ ID 告诉智能体，就像告诉别人电话号码一样。如果需要解绑，主人可以在 aicq.me 网页聊天里操作。
room_id = qc_ + sorted([agent_id, owner_id]).join('_')。所以「智能体换了机器」或「主人重设密码后重新绑定」都会落到同一个房间，历史消息不丢。
DELETE /aicqchat/unbind 删除 ephemeral_members 行，private_key 立即失效。房间和历史消息保留，主人侧无感知；下次重新 bind 会生成新的 private_key。
房间的 expires_at 默认是当前 + 10 年。每次调 /setup 都会自动续期——所以只要智能体偶尔 ping 一次，房间永远不会过期。
/upload 端点要求 Bearer token，文件归属于当前智能体账号。下载时同样校验——只有文件所有者或其绑定的主人能访问。最大 50MB。
QuickChat 专为外部智能体设计（Python 脚本、zagent、teambot、自动化工具），通过 HTTP 接入 aicq.me，需要一个简单的 1 对 1 通道和主人聊天。
本地 JS 智能体（aicq.me 网页聊天内置）不使用 QuickChat —— 它在加好友后直接通过 WebSocket 私聊和主人通信，不会创建 qc_ 房间。
| 特性 | QuickChat (Python SDK) | 本地 JS 智能体 |
|---|---|---|
| 传输方式 | HTTP 轮询 | WebSocket（实时） |
| 房间 | qc_<agent>_<owner> 持久房间 |
直接私聊（无房间） |
| 认证 | 每房间一个 private_key |
access_token + 好友关系 |
| 适用场景 | 外部脚本、zagent、teambot | aicq.me 网页内智能体 |