Desktop 客户端发送带附件的消息失败(附件添加无反应/报错) #14

已关闭
由 fourbroad 于 2026-11-10 09:46:33 +08:00创建 · 7 评论
所有者

桌面版客户端(Linux)对话窗口添加附件后,附件显示为fail,如下截图。复现率:持续。环境:octopus 桌面版,Linux。

期望:附件随消息发送成功。(另:附件发送成功后,主模型 vision 通道也曾 401——image-interpret 子代理 opencode 认证失败,若同源请一并排查。)
image.png

桌面版客户端(Linux)对话窗口添加附件后,附件显示为fail,如下截图。复现率:持续。环境:octopus 桌面版,Linux。 期望:附件随消息发送成功。(另:附件发送成功后,主模型 vision 通道也曾 401——image-interpret 子代理 opencode 认证失败,若同源请一并排查。) ![image.png](/attachments/cea8b5ec-2385-4284-90ed-18f73b978916)
fourbroad 于 2026-11-10 09:53:16 +08:00 指派给自己
作者
所有者

claim — session unspecified-session · branch workflow/session/desktop-attach-fail-14 · account fourbroad (atomic claim via script/claim.sh, #3327)

**claim** — session `unspecified-session` · branch `workflow/session/desktop-attach-fail-14` · account `fourbroad` (atomic claim via script/claim.sh, #3327)
作者
所有者

根因已定位并修复

截图文案 OCR: "Failed to create storage directory" —— 来自服务端 ImageStore 存储目录创建失败。

根因链:

  1. 非 git 目录打开工作区 → 项目发现返回 worktree 哨兵值 "/"(project.ts:276-282)
  2. 附件上传存储根 = path.join(worktree, ".octopus", "uploads") → /.octopus/uploads(image-store.ts,修复前)
  3. Linux 普通用户无权在 / 下建目录 → EACCES → HTTP 500 → 附件 chip 持续显示 fail

修复(分支 workflow/session/desktop-attach-fail-14,commit ce8652473 + cf3e06020):

  • 非 git 项目存储根回落到数据目录 {dataRoot}/uploads/{projectID}-{hash(directory)}(仿 snapshot 先例);git 项目维持 {worktree}/.octopus/uploads 不变
  • 三条链路统一接线:上传写盘 / 发送时读取(prompt-intake)/ 模型消息 rehydrate(message)
  • 回归测试先红后绿(红证据: mkdir '/.octopus' EROFS);image-store 27 + message 78 用例全绿,oxlint/tsgo/prettier 干净;review-code r1 PASS(2 MINOR 已修)

关于 vision 401(image-interpret 子代理 opencode 认证失败): 与本 bug 非同源。附件失败是本地文件系统权限问题;vision 401 走的是 opencode Zen 网关凭据解析路径(provider.ts 的 apiKey/env 解析),不经过附件存储。建议单独排查 opencode 凭据配置(本次排查会话的 vision 解读同样降级,印证该通道独立故障)。

PR 稍后附上。

## 根因已定位并修复 **截图文案 OCR**: "Failed to create storage directory" —— 来自服务端 `ImageStore` 存储目录创建失败。 **根因链**: 1. 非 git 目录打开工作区 → 项目发现返回 worktree 哨兵值 `"/"`(project.ts:276-282) 2. 附件上传存储根 = `path.join(worktree, ".octopus", "uploads")` → `/.octopus/uploads`(image-store.ts,修复前) 3. Linux 普通用户无权在 `/` 下建目录 → EACCES → HTTP 500 → 附件 chip 持续显示 fail **修复**(分支 `workflow/session/desktop-attach-fail-14`,commit ce8652473 + cf3e06020): - 非 git 项目存储根回落到数据目录 `{dataRoot}/uploads/{projectID}-{hash(directory)}`(仿 snapshot 先例);git 项目维持 `{worktree}/.octopus/uploads` 不变 - 三条链路统一接线:上传写盘 / 发送时读取(prompt-intake)/ 模型消息 rehydrate(message) - 回归测试先红后绿(红证据: `mkdir '/.octopus'` EROFS);image-store 27 + message 78 用例全绿,oxlint/tsgo/prettier 干净;review-code r1 PASS(2 MINOR 已修) **关于 vision 401(image-interpret 子代理 opencode 认证失败)**: 与本 bug **非同源**。附件失败是本地文件系统权限问题;vision 401 走的是 opencode Zen 网关凭据解析路径(provider.ts 的 apiKey/env 解析),不经过附件存储。建议单独排查 opencode 凭据配置(本次排查会话的 vision 解读同样降级,印证该通道独立故障)。 PR 稍后附上。
作者
所有者

PR 已建: Octopus/octopus#7044 (fix(server): 非 git 项目附件上传失败——uploads 存储根不再落到 /)。合并发版后请在 Linux 桌面版用非 git 目录复测附件发送;vision 401(opencode)建议另开工单单独排查。

PR 已建: https://eightarms.net/Octopus/octopus/pulls/7044 (fix(server): 非 git 项目附件上传失败——uploads 存储根不再落到 /)。合并发版后请在 Linux 桌面版用非 git 目录复测附件发送;vision 401(opencode)建议另开工单单独排查。
作者
所有者

修复已合并进 main:PR #7044(merge commit 52d8d3f61d,2026-11-10 12:28)。待下个版本发布后,请在 Linux 桌面版用非 git 目录复测附件发送;vision 401(opencode)如仍复现请另开工单。

修复已合并进 main:PR #7044(merge commit 52d8d3f61d,2026-11-10 12:28)。待下个版本发布后,请在 Linux 桌面版用**非 git 目录**复测附件发送;vision 401(opencode)如仍复现请另开工单。
作者
所有者

修复已进 main(PR #7044, 2026-11-10)且 CLI v1.1.0 已于 2026-11-12 发布——请在 Linux 桌面版用非 git 目录复测附件发送;vision 401 若复现请附会话号。复测通过后可关票。

修复已进 main(PR #7044, 2026-11-10)且 CLI v1.1.0 已于 2026-11-12 发布——请在 Linux 桌面版用非 git 目录复测附件发送;vision 401 若复现请附会话号。复测通过后可关票。

状态更新(2026-11-17):修复(PR #7044,merge commit 52d8d3f61d)已随以下正式版本发布:CLI v1.1.0(2026-11-12)、桌面稳定版 desktop-v1.3.2(2026-11-16,源 d0bd957 已含修复)、v1.3.3 / v1.4.0。请更新到 ≥1.3.2 的 Linux 桌面版,用非 git 目录工作区复测附件添加与发送;复测通过请关票,若仍失败请附新截图与会话日志。vision 401(image-interpret/opencode)与本根因不同源,如复现请另开工单。

**状态更新(2026-11-17)**:修复(PR #7044,merge commit 52d8d3f61d)已随以下正式版本发布:CLI v1.1.0(2026-11-12)、桌面稳定版 desktop-v1.3.2(2026-11-16,源 d0bd957 已含修复)、v1.3.3 / v1.4.0。请更新到 ≥1.3.2 的 Linux 桌面版,用**非 git 目录**工作区复测附件添加与发送;复测通过请关票,若仍失败请附新截图与会话日志。vision 401(image-interpret/opencode)与本根因不同源,如复现请另开工单。
作者
所有者

生命周期清扫(2026-11-22):修复(PR octopus#7044,merge 2026-11-10)已随 desktop-v1.3.2(2026-11-16)起发布,至当前 v1.8.0 已跨越 6 个正式版,发布已 6 天且无复发报告。按「修复已广泛发布+无复发」关闭;请在 ≥v1.3.2 Linux 桌面版用非 git 目录复测附件发送,若仍失败请复开并附新截图与会话日志。vision 401(opencode)如复现请另开票。

生命周期清扫(2026-11-22):修复(PR octopus#7044,merge 2026-11-10)已随 desktop-v1.3.2(2026-11-16)起发布,至当前 v1.8.0 已跨越 6 个正式版,发布已 6 天且无复发报告。按「修复已广泛发布+无复发」关闭;请在 ≥v1.3.2 Linux 桌面版用非 git 目录复测附件发送,若仍失败请复开并附新截图与会话日志。vision 401(opencode)如复现请另开票。
登录 并参与到对话中。
未选择标签
2 名参与者
通知
截止日期
未设置截止日期。
依赖工单

未设置依赖工单。

引用:Octopus/release#14