[Feature] AI 提工单时应支持直接上传截图附件 #7

Closed
opened 2026-10-07 11:22:18 +08:00 by chenjieping · 2 comments

背景

通过 Gitea API(POST /repos/{owner}/{repo}/issues)以 AI 代理方式创建工单时,只能提交纯文本(title/body),用户提供的截图无法一并上传,只能在网页端手动补充附件。

期望

支持 AI 创建工单时直接上传截图作为工单附件,例如:

  • 提供 issues 附件上传接口的可用性说明/凭据权限(POST /repos/{owner}/{repo}/issues/{index}/assets);
  • 或在创建工单的同一流程中允许以 multipart 方式随单上传本地图片文件。

场景

用户向 AI 提交 UI bug 截图并要求提工单;AI 建单成功但截图需人工到网页端手动补传,增加额外操作成本。

## 背景 通过 Gitea API(POST /repos/{owner}/{repo}/issues)以 AI 代理方式创建工单时,只能提交纯文本(title/body),用户提供的截图无法一并上传,只能在网页端手动补充附件。 ## 期望 支持 AI 创建工单时直接上传截图作为工单附件,例如: - 提供 issues 附件上传接口的可用性说明/凭据权限(POST /repos/{owner}/{repo}/issues/{index}/assets); - 或在创建工单的同一流程中允许以 multipart 方式随单上传本地图片文件。 ## 场景 用户向 AI 提交 UI bug 截图并要求提工单;AI 建单成功但截图需人工到网页端手动补传,增加额外操作成本。
fourbroad self-assigned this 2026-10-07 14:57:18 +08:00
Owner

claim — session unspecified-session · branch workflow/session/issue-7-screenshot-attach · account fourbroad (atomic claim via script/claim.sh, #3327)

**claim** — session `unspecified-session` · branch `workflow/session/issue-7-screenshot-attach` · account `fourbroad` (atomic claim via script/claim.sh, #3327)
Owner

已处理完毕(PR Octopus/octopus#5716,已合并)。

结论:POST /repos/{owner}/{repo}/issues/{index}/assets 端点在本实例一直可用,无需服务端改动——缺的是 agent 侧文档。本次已在 octopus 的 gitea-rest skill 中补齐附件上传配方:

  1. 建单带图完整回路:POST 建单取 index → multipart 上传截图(字段名 attachment,?name= 可改存储文件名)→ 把返回的 browser_download_url 贴回正文内联展示;
  2. 全套管理操作:GET 列表 / PATCH 改名 / DELETE 删除(实测全回路通过,issue 与 PR index 均可);
  3. 实例限额说明:GET /api/v1/settings/attachment 查实时值(当前:启用、单文件 100MB、每请求 5 文件、png/jpg/webp/gif/pdf/zip 等均允许),文档明确要求查实时值而非硬编码。

AI 后续提工单时按此配方即可直接携带截图,无需网页端手动补传。

已处理完毕(PR Octopus/octopus#5716,已合并)。 **结论**:`POST /repos/{owner}/{repo}/issues/{index}/assets` 端点在本实例一直可用,无需服务端改动——缺的是 agent 侧文档。本次已在 octopus 的 gitea-rest skill 中补齐附件上传配方: 1. **建单带图完整回路**:POST 建单取 index → multipart 上传截图(字段名 `attachment`,`?name=` 可改存储文件名)→ 把返回的 `browser_download_url` 贴回正文内联展示; 2. **全套管理操作**:GET 列表 / PATCH 改名 / DELETE 删除(实测全回路通过,issue 与 PR index 均可); 3. **实例限额说明**:`GET /api/v1/settings/attachment` 查实时值(当前:启用、单文件 100MB、每请求 5 文件、png/jpg/webp/gif/pdf/zip 等均允许),文档明确要求查实时值而非硬编码。 AI 后续提工单时按此配方即可直接携带截图,无需网页端手动补传。
Sign in to join this conversation.
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Octopus/octopus-release#7