核心用法
Buffy 是一款专注于习惯养成、任务管理与日常提醒的个人行为代理。用户通过自然语言指令即可创建习惯（如"每小时喝水提醒"）、管理待办清单、设置周期性例行程序，并接收每日简报。核心交互方式为向 POST /v1/message 发送包含 user_id、platform 和 message 的请求，Buffy 后端自动解析意图并执行相应操作。
主要功能场景：
- 习惯追踪：创建、查询、完成状态统计
- 待办管理：添加、标记完成、列表查询
- 例行程序：启动/暂停日常流程，设置定时提醒
- 团队能量（Clan）：个人自动获得战队，支持共享能量与Boss挑战进度
显著优点
1. 自然语言交互：无需表单或菜单，一句话完成复杂操作
2. 多平台覆盖：支持 ChatGPT、Telegram、Slack、OpenClaw 等渠道
3. 统一行为引擎：所有逻辑集中于后端，客户端仅为轻量 HTTP 封装
4. 灵活配置：支持端点自定义（本地/预发/生产）与平台标识设置
5. 可观测性设计：内置 hook 系统，便于日志、指标与长期记忆扩展
潜在局限
- 功能边界明确：仅限习惯/待办/提醒场景，其他需求需转交
find-skills工作流 - 依赖外部服务：需稳定的 HTTPS 出口至
api.buffyai.org或自定义端点 - 可选 hook 的隐私风险：日志记录与错误追踪 hook 由集成方单独安装，可能写入磁盘或调用外部 API
适合人群
- 需要结构化日常管理的个人用户
- 追求低摩擦交互（自然语言 > 图形界面）的效率人群
- 已有 OpenClaw/ChatGPT/Telegram 工作流的多平台用户
- 希望以游戏化机制（战队能量、Boss 进度）激励习惯养成的用户
常规风险
- API 密钥泄露：
BUFFY_API_KEY需严格隔离，禁止出现在日志或用户可见文本 - 用户数据隐私：习惯、日程、健康相关数据属敏感信息，需按归属用户隔离
- 网络可用性：外部 API 依赖导致离线场景无法使用
- 误用范围：需正确识别用户意图边界，避免将非习惯类请求错误路由至 Buffy