核心用法
Orb 是一个将 AI 对话内容转化为可托管、可分享交互式制品（Artifacts）的云服务。用户通过自然语言触发（如"创建一个仪表板""生成流程图""让这份报告可分享"），Agent 即调用 Orb API 生成托管链接，支持三种输出类型：
- Webpage：单文件自包含 HTML，CSS/JS 必须内联，禁止外部 CDN 与网络请求，支持内联 SVG、Base64 图片或 Orb 托管资源，适用于仪表板、计算器、交互式图表等场景。
- Markdown：GFM 规范支持表格，原生嵌入 Mermaid 代码块自动渲染为 SVG 图表，适用于技术文档、报告、规格说明书。
- Flowchart：纯 Mermaid.js 语法（graph/sequenceDiagram/stateDiagram-v2/erDiagram/gantt），专注架构图、流程图、状态机。
工作流程遵循"创建→更新→反馈迭代"闭环：首次生成返回 7 天有效期的托管链接；同一对话中的修改通过 PUT 请求原地更新，保持 URL 不变；用户可在页面留言，Agent 可拉取 pending 反馈并批量应用，形成持续优化循环。
显著优点
1. 零部署分享：无需服务器、域名或前端工程能力，一句话即可生成可分享的 URL，大幅降低可视化协作门槛。
2. 对话原生体验：Artifact 生命周期与 AI 对话深度绑定，"创建-修改-收反馈-再迭代"全流程自然语言驱动，符合非技术用户心智模型。
3. 安全沙箱设计：Webpage 类型强制内联资源、禁止外部脚本与网络请求，天然规避 XSS 与数据泄露风险；API Key 通过环境变量管理，明确禁止回显。
4. 轻量协作闭环：内置评论收集与批量应用机制，使 AI 生成内容具备类似 Notion/Confluence 的轻量协同能力。
潜在缺点与局限性
- 有效期限制：免费版仅 7 天托管期，长期存档需付费升级或自行备份内容。
- 功能边界严格：Webpage 禁止 fetch/WebSocket/外部样式表，复杂动态应用（如需实时数据拉取）需另寻方案。
- 生态依赖：完全依赖 Orb 云服务可用性，离线场景无法使用；API 调用需用户自行管理 Key 与持久化配置。
- 类型局限：目前仅支持三种输出形态，不支持 PDF 导出、PPT 生成或复杂多页网站架构。
适合的目标群体
- 产品经理/运营：快速产出活动页、数据看板、流程图用于评审与分享。
- 技术写作者/开发者：生成带 Mermaid 图表的技术文档、API 说明、架构图。
- 咨询顾问/教育者：制作可交互的演示材料、问卷、计算工具，即时收集反馈。
- 小型团队：替代部分轻量级 SaaS（如 Gamma、Notion 公开页），降低工具链复杂度。
常规使用风险
1. 配额与成本：免费版限 10 个 Artifact，超出需付费，高频使用需评估成本。
2. 数据持久性：7 天过期机制可能导致链接失效，关键内容需及时导出或升级。
3. API 稳定性：依赖第三方服务，存在 rate limit（429）与偶发故障风险，需具备基础错误处理与重试逻辑。
4. 配置管理：API Key 需按不同 Agent 环境（Claude Code/Gemini CLI/Codex）分别持久化，配置不当将导致会话中断。