fpt-cli：为AI智能体设计的ShotGrid命令行工具

一款用Rust编写的CLI工具，为Autodesk Flow Production Tracking（ShotGrid/FPT）提供完整的API覆盖，专为OpenClaw和AI智能体自动化工作流优化。

在AI智能体与外部系统交互的架构设计中，Model Context Protocol（MCP）一直是热门话题。然而，随着实践中对上下文窗口消耗和交互稳定性的深入理解，越来越多的开发者开始重新审视纯MCP方案的局限性。

Justin Poehnelt在其文章《You Need to Rewrite Your CLI for AI Agents》中提出了Agent DX（Developer Experience）原则，强调为AI智能体设计CLI时需要考虑的特殊需求。fpt-cli项目正是这一理念的具体实践，它同时呼应了Eric Holmes在《MCP Is Dead, Long Live the CLI》中提出的观点：有时候，一个设计良好的CLI比复杂的MCP协议更适合自动化场景。

fpt-cli是一款专为Autodesk Flow Production Tracking（前身为ShotGrid）设计的Rust命令行工具。它提供了对ShotGrid REST和RPC API的近乎完整覆盖，包含76个已实现的命令，旨在为AI智能体提供稳定、可预测的命令契约。

fpt-cli采用CLI优先的设计理念，核心目标包括：

• 为ShotGrid/FPT操作提供稳定的命令契约
• 简化智能体编排流程
• 通过将可重复交互封装为显式CLI命令，减少不必要的MCP Token消耗
• 默认输出结构化JSON，便于自动化处理

fpt-cli提供了对ShotGrid API的全面支持：

实体操作：

• 完整的CRUD操作（创建、读取、更新、删除、恢复）
• 批量操作支持（批量获取、查找、创建、更新、删除）
• 实体关系管理
• 文本搜索和聚合查询

模式管理：

• 实体类型和字段的完整生命周期管理
• 动态模式发现和查询

高级功能：

• 关注者管理（关注/取消关注/列表）
• 备注线程管理
• 层级导航和扩展
• 活动流和事件日志
• 上传/下载URL生成
• 缩略图和胶片条URL获取

1. 运行时模式内省

智能体无需猜测命令参数，可以通过内省API获取准确的命令契约：

# 列出所有命令（低成本）
fpt inspect list --output json

# 获取特定命令的详细契约
fpt inspect command entity.batch.count --output json

2. 输入加固

为防止智能体幻觉导致的错误，CLI对输入进行严格验证：

• 实体类型名称验证
• 拒绝包含?或#的输入（防止查询参数注入）
• 拒绝包含控制字符的输入

3. 上下文窗口优化

• 使用entity batch count一次性统计多种实体类型，避免循环调用
• 通过fields参数只请求需要的字段
• 批量操作支持可控并发（默认8个并发）

4. 写入安全

• 所有变更操作支持--dry-run预览
• 删除操作需要显式--yes确认

fpt-cli支持三种认证模式：

1. Script模式：使用script_name和script_key进行客户端凭证流认证
2. User Password模式：使用用户名和密码进行密码授权流
3. Session Token模式：使用已有会话令牌进行会话令牌流

CLI会根据可用输入自动推断认证模式，简化配置过程。

项目采用Rust工作空间设计，分为三个核心Crate：

• fpt-cli：命令行界面和参数解析
• fpt-core：核心业务逻辑和API客户端
• fpt-domain：领域模型和数据结构

这种分层架构确保了关注点分离，便于测试和维护。