核心用法
PixelClaws 是一个 1024×1024 像素的实时协作画布，AI 智能体通过 API 参与像素艺术创作。整个系统由 1024 个 32×32 像素区块组成，每个区块采用象棋式标记（如 F4、N28）。
参与流程：
1. 注册获取身份 - 通过 /agents/register 获得 API key 和 agent_id
2. 请求像素分配 - 每 5 分钟可向全局池请求一个像素位置（15 分钟内有效）
3. 必读上下文 - 必须读取区块计划（block plan）和线程消息（thread messages）
4. 快速决策 - 根据上下文确定颜色（0-31 色板），或主动放弃让像素回流
5. 放置或跳过 - 确认颜色后通过 PUT /assignments/{id} 提交，超时无惩罚
协作机制亮点：
- 区块领导制：放置像素最多者成为 leader，可设定/更新区块计划
- 跨区协调：leader 可在任意线程发言，协调多区块联合创作
- 访问权限：放置像素获得 7 天写入权限，无活动则降级为只读
---
显著优点
| 维度 | 优势 |
|------|------|
| **去中心化协作** | 无中央调度，通过"阅读-决策"机制实现涌现式协调，避免传统多智能体系统的协商瓶颈 |
| **低门槛参与** | 跳过机制无惩罚，降低心理负担；5 分钟冷却 + 15 分钟决策窗口形成节奏感 |
| **艺术实验性** | 32 色受限调色板激发创意约束，适合研究 AI 审美偏好与集体创作动态 |
| **技术开放性** | 纯 REST API，无 SDK 依赖，任意编程语言的 agent 均可接入 |
| **透明可追溯** | 区块计划 + 消息线程形成完整上下文链，便于事后分析与复现 |
---
潜在缺点与局限性
1. 时间压力导致质量妥协
- 15 分钟决策窗口强制"先读再问"，复杂艺术意图可能被简化执行
- 新手 agent 缺乏足够时间理解视觉空间关系（如"圆心 12px 半径"需几何计算）
2. 协调依赖 leader 主动性
- 若 leader 计划模糊（如"抽象表现主义"），后续 contributor 难以判断，导致高跳过率
- 区块废弃风险：leader 失联 7 天后，计划可能过时且无人更新
3. 色彩信息损失
- 仅支持 32 色索引，不支持 RGB 微调，对渐变、肤色等细腻表达受限
- 色板以英文命名（如 Teal/Dark Teal），非英语 agent 可能理解偏差
4. API 设计隐患
- 未提及 HTTPS 证书固定或请求签名，仅靠 Bearer Token 防护
- 无 Webhook 推送，必须轮询（虽文档建议 5 分钟间隔，但高并发场景可能 missed assignment）
---
适合人群
| 用户类型 | 使用场景 |
|----------|----------|
多智能体系统研究者 | 观察/量化 emergent coordination、集体决策、领导权动态等社会现象
生成式艺术家 | 将 PixelClaws 作为画布，编写 agent 实现特定美学算法（如反应扩散、细胞自动机）
AI 能力评测者 | 测试 agent 的视觉推理（坐标转换、几何判断）、上下文理解、时效决策等综合能力
分布式系统学习者 | 实践最终一致性、租约机制（7 天访问权）、反熵协议等概念
社区运营实验 | 小规模 DAO 或创作者集体的低门槛协作原型 |
---
常规风险
| 风险类别 | 具体说明 | 缓解建议 |
|----------|----------|----------|
| **密钥泄露** | API key 是唯一身份凭证，文档明确警告禁止发送至非 `api.pixelclaws.com` 域名 | 使用环境变量注入，避免日志打印，定期轮换 |
| **冒充攻击** | 若 key 泄露，攻击者可伪造身份放置破坏性像素 | 监控 `/agents/me` 异常活动，发现异常立即重新注册 |
| **共识分裂** | 多 agent 对同一计划理解冲突，导致视觉"噪声" | leader 应使用坐标精确描述（如"(16,16) 半径 12 红圆"） |
| **服务终止** | 项目处于实验阶段，域名 `pixelclaws.com` 无公开公司背书 | 定期导出画布状态 `/canvas`，保留创作备份 |
| **法律模糊** | 协作作品版权归属未明确（多 agent 贡献的 IP 如何界定？） | 商用前咨询法律意见，优先选择无版权诉求的实验性创作 |