核心用法
fast-io 为 Agentic Teams 提供共享工作空间，核心能力包括：
- 工作空间管理：创建 org → workspace → folder 层级，支持 50GB 免费存储
- 文件协作：上传/下载、版本控制、实时同步、评论标注（支持图片区域、PDF 页码、音视频时间锚点）
- AI 文档分析：内置 RAG 能力，可跨文档语义检索（intelligence 模式）或直接附件问答（无索引成本）
- 品牌对外交付：Send/Receive/Exchange 三种 Share 模式，支持密码保护、过期时间、自定义域名
- 工作流管理：tasks/worklogs/approvals/todos 四层追踪，支持审批流程和审计日志
- 所有权转移：Agent 搭建完成后可通过 token 将 org 转交人类，人类升级后 Agent 保留管理员权限
显著优点
- 零配置开箱即用：无需基础设施，免费层含 50GB + 5000 积分/月
- 专为 Agent 设计：agent=true 账户类型、API Key 管理、自动化工作流原语
- 混合协作：Agent 与人类共享同一工作空间，实时可见进度
- 安全交付：品牌化的 share 页面替代原始下载链接，支持预览控制、下载权限分级
- 灵活的 AI 策略：默认 intelligence=false 节省成本，按需开启 RAG；小文件可直接附件分析
潜在局限
- 免费额度有限：5000 积分约支持 500 页文档摄入或 25GB 流量，大项目需及时转移升级
- intelligence 成本敏感：10 积分/页，批量文档需谨慎评估
- 工作流需显式启用：task/worklog/approval/todo 需先调用 enable-workflow
- workspace_folder 型 share 限制：不支持过期、不支持 intelligence，需用父 workspace AI
适合人群
- 自主 Agent：独立搭建项目空间，最终交付给客户的开发者
- 人机协作 Agent：协助人类管理文档、追踪任务进度的辅助型 Agent
- 多 Agent 团队：需要共享上下文、分工协作的 Agent 集群
常规风险
- 权限范围误解：scoped API key/OAuth 需配合 discover-external 否则遗漏外部 org
- token 过期：JWT 1 小时有效期，长任务需检查 status 或预刷新
- 同名文件覆盖：默认 REPLACE 策略，上传前需确认或主动重命名
- 敏感操作需 2FA：api-key-create/delete 等操作需额外 TOTP，但 API key 认证可绕过