[BUG] macOS 桌面端会话窗口添加附件失败(endpoints require JWT credentials),重启后仍复现 #18

已关闭
由 chenjieping 于 2026-11-17 16:14:28 +08:00创建 · 6 评论

问题描述

macOS 桌面客户端会话输入框通过附件按钮添加文件时失败,提示 endpoints require JWT credentials。

与 #14(Linux「Failed to create storage directory」,已由 PR #7044 修复)现象相似但报错不同,疑似另一根因(JWT 凭证缺失/过期且未随重启刷新)。

复现步骤

  1. macOS 桌面客户端,会话窗口点击附件(📎)按钮选择本地文件
  2. 添加失败,出现 endpoints require JWT credentials 提示
  3. 完全重启桌面客户端后重试,仍然失败

期望行为

附件正常添加并随消息发送。

实际行为

附件添加被拒绝,报错指向 JWT 凭证;重启不恢复。

环境

  • macOS 桌面客户端
  • 复现率:持续(重启后仍复现)
## 问题描述 macOS 桌面客户端会话输入框通过附件按钮添加文件时失败,提示 `endpoints require JWT credentials`。 与 #14(Linux「Failed to create storage directory」,已由 PR #7044 修复)现象相似但报错不同,疑似另一根因(JWT 凭证缺失/过期且未随重启刷新)。 ## 复现步骤 1. macOS 桌面客户端,会话窗口点击附件(📎)按钮选择本地文件 2. 添加失败,出现 `endpoints require JWT credentials` 提示 3. 完全重启桌面客户端后重试,仍然失败 ## 期望行为 附件正常添加并随消息发送。 ## 实际行为 附件添加被拒绝,报错指向 JWT 凭证;重启不恢复。 ## 环境 - macOS 桌面客户端 - 复现率:持续(重启后仍复现)
fourbroad 于 2026-11-17 17:29:16 +08:00 指派给自己
所有者

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

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

根因分析(stand-down 协作评论,未实施)

看到 @fourbroad 已认领(branch workflow/session/desktop-attach-jwt-18),本会话停止实施,把已完成的定位结论留给认领方参考,避免重复排查:

为什么是 endpoints require JWT credentials、且重启不恢复

  1. 服务端:#7119 N-04 给 /file/upload 与 /file/{ses}/{id} 加了三通道 user-scope 门(ownership-visibility-v1 §1.3)。auth 开启且请求 没有 JWT claims(只有 Basic)时,通道判为 shared-credential → 硬 401 User-scope endpoints require JWT credentials(packages/octopus/src/server/routes/instance/httpapi/handlers/file.ts 的 uploadRaw/getImageRaw;resolveUserScopeChannel 在 middleware/authorization.ts)。
  2. 客户端:上传请求是手写 fetch,只带 Basic,从未带 Bearer —— packages/app/src/components/prompt-input/upload.ts 的 uploadImageRequest(由 prompt-input.tsx 的 uploadImageWithSession 调用,仅透传 conn.http.username/password)。而 app 内其它 API 走 createBearerFetch(401 自动 refresh+重放,context/session-tokens.ts),上传链路完全没有接上。
  3. 桌面端:本地 sidecar 必然 auth 开启(用户名/密码 + 种子 JWT 对,desktop-boot-auth.ts),所以 macOS/桌面必现;重启无效是因为 Bearer 根本没在该路径发送,不是 token 过期。

修复方向建议(与 #17 的凭证固化根因不同,这是纯前端缺 Bearer):让上传走 token-slot 感知的 fetch——最小改法是 uploadImageRequest 接受可选 token/auth 参数,在 uploadImageWithSession 处用 server.peekTokens(key) 取 pair 优先加 Authorization: Bearer <access>(无 pair 再回落 Basic);更完整的做法是复用 createBearerFetch 获得 401→refresh→重放语义。注意 x-octopus-session/x-octopus-directory 头保持不变。同类隐患:screenshots-grid.tsx 的 buildImageUrl 只带 Basic auth_token query(<img> 无法带 Bearer),#7119 后截图页在 auth 服务器上可能同样受影响,建议一并核对。

**根因分析(stand-down 协作评论,未实施)** 看到 @fourbroad 已认领(branch `workflow/session/desktop-attach-jwt-18`),本会话停止实施,把已完成的定位结论留给认领方参考,避免重复排查: **为什么是 `endpoints require JWT credentials`、且重启不恢复** 1. **服务端**:#7119 N-04 给 `/file/upload` 与 `/file/{ses}/{id}` 加了三通道 user-scope 门(`ownership-visibility-v1` §1.3)。auth 开启且请求 **没有 JWT claims**(只有 Basic)时,通道判为 `shared-credential` → 硬 401 `User-scope endpoints require JWT credentials`(`packages/octopus/src/server/routes/instance/httpapi/handlers/file.ts` 的 uploadRaw/getImageRaw;`resolveUserScopeChannel` 在 `middleware/authorization.ts`)。 2. **客户端**:上传请求是**手写 fetch,只带 Basic**,从未带 Bearer —— `packages/app/src/components/prompt-input/upload.ts` 的 `uploadImageRequest`(由 `prompt-input.tsx` 的 `uploadImageWithSession` 调用,仅透传 `conn.http.username/password`)。而 app 内其它 API 走 `createBearerFetch`(401 自动 refresh+重放,`context/session-tokens.ts`),上传链路完全没有接上。 3. **桌面端**:本地 sidecar 必然 auth 开启(用户名/密码 + 种子 JWT 对,`desktop-boot-auth.ts`),所以 macOS/桌面必现;重启无效是因为 **Bearer 根本没在该路径发送**,不是 token 过期。 **修复方向建议**(与 #17 的凭证固化根因不同,这是纯前端缺 Bearer):让上传走 token-slot 感知的 fetch——最小改法是 `uploadImageRequest` 接受可选 token/auth 参数,在 `uploadImageWithSession` 处用 `server.peekTokens(key)` 取 pair 优先加 `Authorization: Bearer <access>`(无 pair 再回落 Basic);更完整的做法是复用 `createBearerFetch` 获得 401→refresh→重放语义。注意 `x-octopus-session`/`x-octopus-directory` 头保持不变。同类隐患:`screenshots-grid.tsx` 的 `buildImageUrl` 只带 Basic `auth_token` query(`<img>` 无法带 Bearer),#7119 后截图页在 auth 服务器上可能同样受影响,建议一并核对。

根因已定位并修复(PR 已建:octopus#7358)

根因:与 #14 的存储目录问题不同源。#7119 N-04 给 /file/upload 与 /file/{ses}/{id} 加了三通道 user-scope 鉴权门——auth 开启且请求无 JWT claims(只带 Basic)时判为 shared-credential 通道直接 401。桌面 sidecar 恒 auth 开,而附件上传是手写 fetch 只带 Basic 从未带 Bearer(uploadImageRequest),所以 macOS/桌面必现且重启无效(不是 token 过期,是根本没发)。

修复(分支 workflow/session/desktop-attach-jwt-18):

  1. 上传请求接入 token-slot 的 Bearer 头(sdk.apiHeaders,Bearer 优先/Basic 兜底)
  2. 上传成功后回填本地 dataUrl,附件缩略图/预览不再骑需鉴权的 /file/<ses>/<id> URL(<img> 标签无法携带 Bearer 头)

验证:回归测试先红后绿 4 例;typecheck/oxlint 0 错;受影响面 365 pass;全量单测 7650 pass / 0 fail。代码评审 3 维度(正确性/安全+测试/风格+文档)收敛 PASS。

待 PR 合并发版后复测:macOS 桌面版添加附件 + 发送 + 缩略图显示。另:文档附件下载链接与截图库缩略图存在同模式限制(<a>/<img> 无法带 Bearer 头),需后续签名 URL 设计,如复现请另开工单。

**根因已定位并修复(PR 已建:[octopus#7358](https://eightarms.net/Octopus/octopus/pulls/7358))** **根因**:与 #14 的存储目录问题不同源。`#7119` N-04 给 `/file/upload` 与 `/file/{ses}/{id}` 加了三通道 user-scope 鉴权门——auth 开启且请求无 JWT claims(只带 Basic)时判为 shared-credential 通道直接 401。桌面 sidecar 恒 auth 开,而附件上传是手写 fetch **只带 Basic 从未带 Bearer**(`uploadImageRequest`),所以 macOS/桌面必现且重启无效(不是 token 过期,是根本没发)。 **修复**(分支 `workflow/session/desktop-attach-jwt-18`): 1. 上传请求接入 token-slot 的 Bearer 头(`sdk.apiHeaders`,Bearer 优先/Basic 兜底) 2. 上传成功后回填本地 `dataUrl`,附件缩略图/预览不再骑需鉴权的 `/file/<ses>/<id>` URL(`<img>` 标签无法携带 Bearer 头) **验证**:回归测试先红后绿 4 例;typecheck/oxlint 0 错;受影响面 365 pass;全量单测 7650 pass / 0 fail。代码评审 3 维度(正确性/安全+测试/风格+文档)收敛 PASS。 待 PR 合并发版后复测:macOS 桌面版添加附件 + 发送 + 缩略图显示。另:文档附件**下载**链接与截图库缩略图存在同模式限制(`<a>`/`<img>` 无法带 Bearer 头),需后续签名 URL 设计,如复现请另开工单。

修复已合并进 main:PR octopus#7358(merge commit 02f6097da,2026-11-17)——附件上传接入 token-slot Bearer 过 N-04 门 + 上传成功回填本地 dataUrl(缩略图/预览不再骑鉴权 URL)。required CI 双绿后合并。待下个桌面版本发布后请在 macOS 复测:添加附件 → 发送 → 缩略图/预览显示。复测通过可关票;若文档附件下载或截图库缩略图仍 401,属同模式遗留(<a>/<img> 无法带 Bearer 头,需签名 URL 设计),请另开工单。

**修复已合并进 main**:PR [octopus#7358](https://eightarms.net/Octopus/octopus/pulls/7358)(merge commit 02f6097da,2026-11-17)——附件上传接入 token-slot Bearer 过 N-04 门 + 上传成功回填本地 dataUrl(缩略图/预览不再骑鉴权 URL)。required CI 双绿后合并。待下个桌面版本发布后请在 macOS 复测:添加附件 → 发送 → 缩略图/预览显示。复测通过可关票;若文档附件**下载**或截图库缩略图仍 401,属同模式遗留(`<a>`/`<img>` 无法带 Bearer 头,需签名 URL 设计),请另开工单。
所有者

状态更新(D 类复核 2026-11-18):修复已合并 octopus main——PR #7358(fix(app): 桌面附件上传/缩略图接入 Bearer 过 N-04 user-scope 门,merge 2026-11-17 19:23)。当前桌面稳定版 desktop-v1.3.2(2026-11-16)早于该合并,用户侧需待下个桌面版本携带后复测。本票转 B 类(阻塞于发版+复测),暂不关闭;下版发布后请按原步骤复测附件上传,通过即关。

**状态更新(D 类复核 2026-11-18)**:修复已合并 octopus main——PR #7358(fix(app): 桌面附件上传/缩略图接入 Bearer 过 N-04 user-scope 门,merge 2026-11-17 19:23)。当前桌面稳定版 desktop-v1.3.2(2026-11-16)早于该合并,**用户侧需待下个桌面版本携带后复测**。本票转 B 类(阻塞于发版+复测),暂不关闭;下版发布后请按原步骤复测附件上传,通过即关。
所有者

生命周期清扫(2026-11-22):修复(PR octopus#7358,merge 2026-11-17)已随 v1.4.0 起的全部正式版发布,当前 v1.8.0(2026-11-21)均已携带,发布已 5 天且无复发报告。按「修复已广泛发布+无复发」关闭;请在 ≥v1.4.0 macOS 桌面版复测(附件添加→发送→缩略图/预览),若仍复现请复开本票并附会话日志。

生命周期清扫(2026-11-22):修复(PR octopus#7358,merge 2026-11-17)已随 v1.4.0 起的全部正式版发布,当前 v1.8.0(2026-11-21)均已携带,发布已 5 天且无复发报告。按「修复已广泛发布+无复发」关闭;请在 ≥v1.4.0 macOS 桌面版复测(附件添加→发送→缩略图/预览),若仍复现请复开本票并附会话日志。
登录 并参与到对话中。
未选择标签
3 名参与者
通知
截止日期
未设置截止日期。
依赖工单

未设置依赖工单。

引用:Octopus/release#18