用途:bird-pp-cli 是面向 Bird 工作区的终端命令行工具,供 AI 智能体或运维人员在终端中发送事务性短信、批量发送提醒并对账、处理会话、审计消息投递,以及维护工作区允许/阻止名单。相比直接使用 curl,它提供离线搜索、面向智能体的 JSON 输出,并能把多个 Bird 端点合并为一条命令。
主要能力:本地状态可累积,包括 messages audit(把消息及其交互折叠为按时间排序的投递时间线,终态失败时返回非零退出码)、messages failures(按原因码聚合近期失败)、sms search(对消息正文做全文搜索,可按发件人或收件人号码过滤)。发送与对账方面有 sms send-batch(从 CSV 批量发送,每行带幂等键并持久化批次)和 sms reconcile(重新拉取批次内每条消息的投递交互,按原因分组失败并可选重试)。会话处理有 conversations timeline 和 messages from。合规与开通方面有 tenant doctor(对渠道、渠道配置、反垃圾、合规关键词和可消息性做就绪检查)和 compliance auto-block(扫描本地入站消息中的 STOP 关键词,输出可批量添加的 CSV 或直接应用)。
使用方式:先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install bird --cli-only,或用 go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/bird/cmd/bird-pp-cli@latest(需 Go 1.26.6 或更新版本),并用 bird-pp-cli --version 验证。认证使用 Bird 的 Authorization: AccessKey <key> 头,需设置 BIRD_API_KEY 与 BIRD_WORKSPACE_ID,可选 BIRD_CHANNEL_ID 作为短信命令默认渠道。任意命令可加 --agent,等价于 --json --compact --no-input --no-color --yes。可用 bird-pp-cli which "<能力描述>" 查找命令,用 bird-pp-cli doctor 验证配置。
适用场景:一次性事务短信、批量提醒与对账、会话分诊、投递审计、工作区名单维护、新租户开通检查。
限制:需先安装并验证 CLI,否则不要执行技能命令;安装目录需在 PATH 中。输出包裹在 meta/results 信封中,需解析 .results 与 .meta.source。反馈默认仅本地存储于 ~/.bird-pp-cli/feedback.jsonl,除非设置 BIRD_FEEDBACK_ENDPOINT 并显式发送。退出码有明确含义(0 成功、2 用法错误、3 未找到、4 需认证、5 API 错误、7 限流、10 配置错误)。其余细节暂未提供。