跳转到内容
Hashee Docs

我能用 Hashee 做什么

Hashee 是端到端加密的即时通讯平台 + 把 Agent 当作一等公民 的开发者平台。 后端永远看不到消息内容；Agent 拥有自己的密钥、会话、权限边界， 和真人一样作为对话的另一方参与进来。

选你的路径

我想…第一步估计时间
🚀 从零写一个 Agent（聊天、客服、工作流）5 分钟跑通 Hello World5 min
🔌 把已有 runtime 接到 Hashee（Claude Code / Codex / OpenClaw）三个 Plugin 怎么选10 min
📦 复制一个 starter 项目Starter Templates10 min
🧩 做小程序 / 小游戏（artifact app）Artifact 是什么30 min
📨 接现成系统的事件（GitHub / Sentry / Grafana → 群通知）工作流通知 bot tutorial30 min
🧠 做 RAG 知识助理RAG 教程1 h
🔍 浏览短代码配方Examples 区自选
📚 看完整教程合集Tutorials 区自选
🍳 看 Cookbook patterns（架构 / 成本 / GDPR）Cookbook 区自选

三类典型受众

🛠 我是后端工程师 / SRE

最关心的：SDK 全字段 + 部署形态 + 错误处理 + 合规。

入口
1. SDK 章节首页SDK 全章节地图
2. 三种部署模式WebSocket vs Webhook vs Polling
3. 能力矩阵一张表看完所有 capability
4. 部署 Cloudflare Workers / 自托管 VPS完整 PaaS 配置
5. Production Checklist35 项上线前必过

🤖 我是 AI / LLM 开发者

最关心的：SDK + Tool Call + Artifact + 多 LLM provider + 成本优化。

入口
1. Hello World — WebSocketOpenAI / Anthropic 集成范例
2. Tool CallCapability Manifest 驱动的工具调用
3. Artifact 高级 — 双向交互小程序 / 小游戏 / 复杂 UI
4. 切换 LLM ProviderOpenAI / Anthropic / Ollama 抽象
5. 成本优化6 个降本套路

🔐 我是合规 / 安全负责人

最关心的：端到端加密 / 数据主权 / GDPR / 子处理方 / 审计。

入口
1. 信任中心公司、子处理方、数据保留
2. E2EE 规范6 层加密栈技术细节
3. 安全披露Responsible Disclosure + Bug Bounty
4. GDPR 合规清单22 项 Agent 开发者必过
5. Capability Manifest 规范权限敏感度三级

概念速读

这一页帮你判断 Hashee 能解决你正在想的问题。

Agent 是什么

在 Hashee 里，Agent 不是”发到聊天里的机器人”，它是：

  • 一个独立身份（拥有自己的 X25519 + Ed25519 双密钥对）
  • 一个独立的对话参与者（H2A 关系，等价于 H2H 好友关系）
  • 一个独立的权限主体（用户授予的”读取数据 / 调用工具”是分离的、可审计的、可撤销的）

也就是说：Agent 收到的是端到端加密管道里的明文，不是后端转交给它的； Agent 给用户的回复也是端到端加密的，后端不持有 CEK（Content Encryption Key）。

详见 E2EE 规范。

4 类典型用法

1. 聊天助手（H2A 一对一对话）

最常见的场景。用户把 Agent 加为联系人 → 在 Hashee 里像和真人聊天一样发消息 → 你的 Agent 进程收到解密后的明文 → 调用大模型 / 执行业务逻辑 → 回复一条加密消息。

  • 适合：客服、知识答疑、个人助理、行业专家。
  • 技术栈：@hasheeai/agent-sdk-ts + 任意 LLM。

2. 工作流自动化（被动响应 + 主动推送）

Agent 不只能”回消息”，还能在外部事件触发时主动给授权用户推送：编译完成、订单状态、 监控告警、日报。被动 + 主动结合，把 Hashee 的对话当作一条可审计、可加密、可撤销 的”工作流通道”。

  • 适合：DevOps 工具、CI/CD 状态、内部服务通知。
  • 关键能力：Agent 主动 agent.send(conversationId, ...)、群组路由、artifact 进度卡。

3. 小程序（Artifact App）

Hashee 的”小程序”叫 Artifact：Agent 把一段结构化的数据（subtype = app） 作为消息推到聊天里，客户端用对应的 renderer 把它渲染成可交互的卡片。 用户的点击、输入、提交会通过 artifact_response 返回给 Agent，Agent 可以 用 artifact_update 乐观地更新已发出的卡片。

  • 适合：表单收集、投票、报告卡、订单详情、预约面板。
  • 技术参考：Capability Manifest §supports_artifacts，详见 Capability Manifest 规范。

4. 小游戏（状态化 Artifact）

游戏 = “Artifact 持续被 Agent 端的状态机驱动”。 Agent 维护游戏状态（棋盘、得分、轮次），客户端只负责渲染当前帧 + 把用户操作 回传。每一次操作就是一次 artifact_response，每一次状态变更就是一次 artifact_update(based_on_revision)。

3 种集成方式

方式适合关键文档
写一个原生 Agent你想完全掌控 Agent 行为、模型选型、状态存储SDK Hello World
用 Plugin 把现成 runtime 接进来你已经在用 Claude Code / Codex CLI / OpenClaw，想让它和 Hashee 用户互通三个 Plugin 怎么选
用 CLI 做临时探索你只想从命令行调几个 API 试用一下CLI 速查

与传统 Chatbot 的关键区别

维度传统 Chatbot 平台Hashee Agent
消息内容平台明文存储 + 可读取端到端加密，平台只看密文 + 元数据
身份模型”应用的一部分”第一类参与者（自己的密钥、可被搜索、可被举报）
多设备与平台账户耦合用户多设备同步、Agent 多实例并发（上限 3）
工具调用自定义协议 + 黑箱Capability Manifest 机制；用户可见 + 可审计 + 三级敏感度
协议公开私有开源 SDK + 开放 wire format（hashee-envelope-v1.x）
撤销 / 退出用户卸载 = 单端清除用户撤销 H2A 关系 → Agent 失去访问 + grant ledger 留证

我应该读哪里