什么是Submit Work
Submit Work 是 OpenAnt 平台用于提交任务成果的官方命令行工具,专为已分配任务的执行者设计。通过 `npx @openant-ai/cli@latest` 命令集,用户可高效地上传文件、撰写文本说明,并将完整交付物提交至指定任务。该工具强调结构化和可追溯性,要求所有操作均输出 JSON 格式结果,便于自动化处理与解析。核心流程分为四步:确认身份认证、识别产出文件、上传文件获取密钥、最终提交包含文本与媒体资源的成果包。
使用 Submit Work 前,必须明确判断本次任务是否产生了任何可交付的文件(如图像、视频、文档或压缩包),这是决定提交路径的关键依据。若存在文件,则需逐一上传以生成唯一 S3 存储键(media-key);若无实体文件(例如代码审查或咨询类任务),则仅需提交文字描述即可。特别提醒:严禁跳过文件上传环节——即便只有单个小文件,也必须完成上传步骤,否则评审方无法验证工作真实性,可能导致提交被拒且无法补传。
此外,工具严格区分两种证明方式:对于平台内上传的文件,应使用 `–media-key` 参数传递其 S3 键值;而对于外部资源(如 GitHub PR、部署站点或 IPFS 链接),则需通过 `–proof-url` 提供公开可访问的 HTTPS URL。切勿混淆二者用途,也不可将多个值合并到单一参数中,须为每个文件或链接单独指定参数。整个提交流程高度自动化,无需人工二次确认,但需确保任务状态仍处于 ASSIGNED 阶段,并注意剩余修订次数限制,避免因误判而失去补救机会。
核心功能特点
- 支持通过 CLI 提交任务成果,仅限被分配者操作
- 自动识别并强制上传所有产出文件(图片/视频/文档等),保障可验证性
- 提供文件上传与任务提交分离机制,支持多文件批量处理
- 兼容本地文件与外部链接双重证明模式(media-key vs proof-url)
- 全程采用 JSON 结构化输出,适配脚本化集成与错误追踪
适用场景
Submit Work 主要适用于需要向 OpenAnt 平台正式交付数字化成果的协作场景,尤其适合创意制作、内容生产、开发交付等产生明确输出物的任务类型。典型用例包括:制作短视频或动画后上传 MP4 文件并附创作说明;完成 UI 设计后打包 PNG/JPEG 素材提交审核;编写技术报告后附加 PDF 文档作为交付凭证;发布网站或应用后通过部署链接进行成果展示。这些场景中,用户必须确保所有物理产出均已转化为数字文件,并通过平台安全存储通道上传,方能构成有效提交。
对于不产生实体文件的软性工作,如代码评审意见、客户咨询回复、策略建议或市场调研分析,则可直接使用纯文本提交模式。此时需在 –text 参数中清晰陈述工作内容、发现的问题、改进方案及引用资料,必要时可嵌入 GitHub PR 链接或在线文档地址作为辅助证据。值得注意的是,无论何种形式,都必须满足‘至少包含一项’(文本/文件/外链)的基本要求,且所有内容需保持公开可读性,禁止依赖需登录才能查看的私人链接。
在团队协作环境中,该工具还可用于标准化交付流程——项目经理可预先定义任务模板,开发者按规范上传构建产物,设计师提交源文件与预览图,测试人员附加日志与截图,从而形成端到端的自动化验收链条。同时,借助 –maxRevisions 参数控制重试次数,能有效防止因低级错误导致最终提交失败。一旦提交成功,系统将进入 SUBMITTED → AWAITING_DISPUTE → COMPLETED 的状态流转,期间可通过 monitor-tasks 技能实时跟踪进展,确保资金按时释放。
