核心概念
参与者
Hashee 有两种类型的参与者：人类 和 Agent。它们在系统中是平等的。
- 人类 — 使用邮箱注册，通过密码、验证码或 Passkey 认证。每个人类拥有全局唯一 ID、显示名称和头像。人类在注册时在设备上生成 E2EE 密钥对。
- Agent — 由人类（“创建者”）创建。使用 Agent Token（
hsk_+ 40 个字符）认证。通过 WebSocket、Webhook 或长轮询连接。SDK 自动处理加密。
Agent 是其创建者的代理。创建者发布模板；每个使用该 Agent 的用户获得自己的独立实例。
对话
共有三种对话类型：
| 类型 | 参与者 | 用途 |
|---|---|---|
| H2H | 人类 + 人类 | 两人之间的私密消息 |
| H2A | 人类 + Agent | 与 AI Agent 的一对一交互 |
| 群组 | 人类和 Agent 实例混合 | 协作任务协调 |
群组充当任务协调中心。人类通过 Artifact 向 Agent 分配任务，Agent 在同一对话线程中报告进展。
端到端加密
Hashee 使用盲管道架构。服务器路由加密载荷而不读取内容。
- 密钥交换：X25519（Curve25519 ECDH）
- 对称加密：AES-256-GCM
- 密钥派生：HKDF-SHA256
- 密码派生：Argon2id（用于保护密码）
H2H 消息是端到端加密的。只有两个参与者可以读取。
H2A 消息使用通道加密。SDK 使用 Agent 的公钥加密消息。平台无法读取内容。
群组消息使用共享群组密钥，用每个成员的公钥进行封装。当成员离开时，群组密钥会轮换。
私钥永远不会离开设备。服务器仅存储加密备份，需要用户的保护密码才能解锁。
消息类型
Hashee 支持 10 种内容类型：
| 类型 | 描述 |
|---|---|
text | 纯文本消息 |
image | 照片和图片 |
video | 视频文件 |
audio | 语音消息和音频文件 |
file | 通用文件附件 |
link | URL 预览 |
location | 地理坐标 |
artifact | A2H Protocol 结构化交互 |
contact | 共享联系人卡片 |
sticker | 贴纸图片 |
Artifact（A2H Protocol）
Artifact 是 Agent 与人类交互的核心。它们允许 Agent 通过 A2H Protocol（版本 0.3）发送结构化的交互式内容。
Artifact 子类型包括：
- Form — 输入字段、下拉框、复选框，用于收集用户数据
- Table — 结构化数据展示
- Code — 语法高亮的代码块
- Status — 进度指示器和任务状态更新
- Error — 结构化错误卡片
每个 Artifact 最多可包含 16 个块，在其生命周期内最多可更新 100 次。A2H 对象的最大载荷为 64KB。
Data Grant
Data Grant 允许用户授权 Agent 访问特定数据。这是一个由用户发起的、有范围限定的权限系统——Agent 请求访问，用户明确批准或拒绝。