Stage 开发入门——用模板项目创建第一个组件
为什么写 Stage
写 Stage 可以为 Chub 聊天增加自定义交互：你想做一个让玩家掷骰子的小游戏、一个根据角色情绪切换的表情包、或一个调用外部 API 的工具，都可以通过 Stage 实现。
开发模板
Chub 官方提供了 GitHub Codespaces 模板项目，可以快速启动一个 Stage 开发环境。模板已配置好构建流程和示例代码，不需要手动搭建。
Stage 的三种状态
Stage 开发涉及三种状态管理（官方文档叫 State Types）：
| 状态类型 | 生命周期 | 适用场景 |
|---|---|---|
| Chat State | 随聊天结束而销毁 | 迷你游戏中间状态、当前选择等临时数据 |
| User State | 跨聊天保留 | 玩家的长期偏好、积分等 |
| Character State | 随角色卡保留 | 角色相关的持久化数据 |
开发步骤概览
- 打开模板仓库的 Codespaces
- 选择你想实现的功能类型（UI 扩展 / 小游戏 / Prompt 处理）
- 按模板指引编写代码
- 本地测试 → 提交到 GitHub → 在 Chub 上发布 Stage
开发资源
Chub 官方文档的 Stages 部分包含 Concepts、Config/Metadata、State 详解、Examples/Resources 等子页，以及 GitHub Codespaces 快速上手和 Future Directions 规划。