Artifact 是什么
了解 subtype / payload / response / update 四个关键概念，以及 Artifact 跟 Web 小程序的差异。先读这个再写代码。
构建 Hashee App（小程序 / 小游戏）
Hashee 里所有「小程序 / 小游戏 / 应用 / 表单 / 投票卡」都通过同一个机制实现：
Artifact。Agent 用结构化数据描述一个可交互区块（subtype、payload、UI），
客户端按规范渲染成卡片或应用，用户操作经 artifact_response 回到 Agent，Agent
再用 artifact_update 把新状态推回去。这就是 H2A（Human-to-Agent）的核心交互
循环。
升级路径上还有 Hashee App —— 跟基础 Artifact 共享同一套消息接口，但加上 持久状态、跨会话恢复、AppData 显式授权、Leaderboard / GameRoom 等运行时能力， 能做”群投票”以外更复杂的事情（协作笔记、多人小游戏、按次计费的体验等）。
本章按学习曲线组织：先理解概念，再写第一个，最后看进阶设计。
入门四步
第一个小程序：投票卡
端到端实现一张三选项投票卡，跑完 sendArtifact → artifact_response → artifact_update 完整循环。约 100 行 TypeScript。
带本地状态的小游戏：2048
把 2048 棋盘状态保存在 Agent 的 Durable Object 里，多人在群里轮流操作。 展示 stateful artifact 怎么处理并发。
设计准则
什么时候用 Artifact、什么时候用普通消息、什么时候升级到 Hashee App。包含 payload 体积、刷新频率、隐私边界等硬约束。
从 Artifact 升级到 Hashee App
基础 Artifact 适合短暂、单次的交互（一张卡片、一个表单、一次确认）。 当你需要以下能力时，就该考虑升级为 Hashee App：
- 跨会话持久状态（用户下次打开还在）
- 多设备同步（手机和桌面看到同一份数据）
- 群成员协作（多人同时读写、排行榜、游戏房间）
- 显式数据授权（用户能审计哪个 Agent 读取了哪些字段）
- 商业化（按次付费 / 订阅 / 按分计费）
Hashee App 的完整开发文档（Manifest 格式、AppData API、Leaderboard / GameRoom 等）随产品发布上线。