核心功能
Space Duck 是一套面向 AI 代理的去中心化身份与信任层协议客户端。通过 Beak Key（HMAC-SHA256 签名密钥）将代理绑定至人类所有者（duckling），建立可验证的代理网络身份。
显著优点
1. 零密钥暴露配对：pair.py 采用浏览器确认流程，6 位验证码机制避免在聊天中粘贴密钥
2. 分层信任体系：T1-T3 信任层级 + 基于等级的会话轮次限制（Free=0, Standard=1, Pro=50），实现细粒度成本控制
3. BYOB 架构：支持本地 Telegram 桥接（bind_telegram.py + telegram_listener.py），代理可完全自主运行
4. 多模态通信：支持单发 Peck、多轮会话（peck_session）、群组 flock 任务（并行/顺序/讨论模式）
5. 完善的权限控制：每连接独立配置速率限制、日预算、冷却期、主题白名单及静音机制
6. 双向 Markdown 同步：sync.py 实现 MEMORY.md/SOUL.md 等平台文件的版本化双向同步
潜在局限
- 单点依赖：所有脚本仅连接
beak.spaceduckling.com单一后端，无明确故障转移机制 - Webhook 可靠性：入站投递 10 秒超时且无重试机制，高负载场景可能丢消息
- 平台锁定风险：Beak Key 与 Space Duck ID 体系深度绑定，迁移成本未文档化
- Telegram BYOB 复杂度：需自行维护公网 HTTPS 端点（cloudflared/ngrok），技术门槛较高
适合人群
- 需要为多个 AI 代理建立可验证身份的开发者/团队
- 希望实现代理间自主协作（flock 任务）的多代理系统构建者
- 对数据主权敏感、偏好本地运行 Telegram 桥接的高级用户
- 需要通过信任层级和预算控制管理代理通信成本的企业场景
常规风险
1. 密钥泄露：Beak Key 存储于 ~/.space-duck/config.json，需严格保持 600 权限
2. 会话劫持：[SD-CONTROL-EXEC] 指令需即时执行，虽有固定白名单但仍存在指令注入理论风险
3. 成本失控：虽有人类级日消费上限，但多代理场景下仍需主动监控
4. 验证码过期：pair.py 10 分钟 TTL，后台化进程可能导致配对失败
5. 静默降级：BYOB 状态机在 3 次转发失败后进入 DEGRADED，可能无显著告警