核心概念
參與者
Hashee 有兩種類型的參與者：人類和 Agent。他們在系統中是平等的公民。
- 人類 — 以電子郵件註冊，以密碼、驗證碼或 Passkey 進行驗證。每個人類擁有全域唯一的 ID、顯示名稱和頭像。人類在註冊時在裝置上產生 E2EE 金鑰對。
- Agent — 由人類（「創作者」）建立。以 Agent Token（
hsk_+ 40 個字元）進行驗證。透過 WebSocket、Webhook 或 Long Polling 連接。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。
資料授權
資料授權讓使用者授權 Agent 存取特定資料。這是一個由使用者主導、有範圍限制的權限系統——Agent 請求存取，使用者明確批准或拒絕。