macOS 桌面客户端会话输入框通过附件按钮添加文件时失败,提示 endpoints require JWT credentials。
endpoints require JWT credentials
与 #14(Linux「Failed to create storage directory」,已由 PR #7044 修复)现象相似但报错不同,疑似另一根因(JWT 凭证缺失/过期且未随重启刷新)。
附件正常添加并随消息发送。
附件添加被拒绝,报错指向 JWT 凭证;重启不恢复。
claim — session unspecified-session · branch workflow/session/desktop-attach-jwt-18 · account fourbroad (atomic claim via script/claim.sh, #3327)
unspecified-session
workflow/session/desktop-attach-jwt-18
fourbroad
根因分析(stand-down 协作评论,未实施)
看到 @fourbroad 已认领(branch workflow/session/desktop-attach-jwt-18),本会话停止实施,把已完成的定位结论留给认领方参考,避免重复排查:
为什么是 endpoints require JWT credentials、且重启不恢复
/file/upload
/file/{ses}/{id}
ownership-visibility-v1
shared-credential
User-scope endpoints require JWT credentials
packages/octopus/src/server/routes/instance/httpapi/handlers/file.ts
resolveUserScopeChannel
middleware/authorization.ts
packages/app/src/components/prompt-input/upload.ts
uploadImageRequest
prompt-input.tsx
uploadImageWithSession
conn.http.username/password
createBearerFetch
context/session-tokens.ts
desktop-boot-auth.ts
修复方向建议(与 #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 服务器上可能同样受影响,建议一并核对。
server.peekTokens(key)
Authorization: Bearer <access>
x-octopus-session
x-octopus-directory
screenshots-grid.tsx
buildImageUrl
auth_token
<img>
根因已定位并修复(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 过期,是根本没发)。
#7119
修复(分支 workflow/session/desktop-attach-jwt-18):
sdk.apiHeaders
dataUrl
/file/<ses>/<id>
验证:回归测试先红后绿 4 例;typecheck/oxlint 0 错;受影响面 365 pass;全量单测 7650 pass / 0 fail。代码评审 3 维度(正确性/安全+测试/风格+文档)收敛 PASS。
待 PR 合并发版后复测:macOS 桌面版添加附件 + 发送 + 缩略图显示。另:文档附件下载链接与截图库缩略图存在同模式限制(<a>/<img> 无法带 Bearer 头),需后续签名 URL 设计,如复现请另开工单。
<a>
修复已合并进 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 设计),请另开工单。
状态更新(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 桌面版复测(附件添加→发送→缩略图/预览),若仍复现请复开本票并附会话日志。
未设置依赖工单。
该备注对被屏蔽的用户不可见。
问题描述
macOS 桌面客户端会话输入框通过附件按钮添加文件时失败,提示
endpoints require JWT credentials。与 #14(Linux「Failed to create storage directory」,已由 PR #7044 修复)现象相似但报错不同,疑似另一根因(JWT 凭证缺失/过期且未随重启刷新)。
复现步骤
endpoints require JWT credentials提示期望行为
附件正常添加并随消息发送。
实际行为
附件添加被拒绝,报错指向 JWT 凭证;重启不恢复。
环境
claim — session
unspecified-session· branchworkflow/session/desktop-attach-jwt-18· accountfourbroad(atomic claim via script/claim.sh, #3327)根因分析(stand-down 协作评论,未实施)
看到 @fourbroad 已认领(branch
workflow/session/desktop-attach-jwt-18),本会话停止实施,把已完成的定位结论留给认领方参考,避免重复排查:为什么是
endpoints require JWT credentials、且重启不恢复/file/upload与/file/{ses}/{id}加了三通道 user-scope 门(ownership-visibility-v1§1.3)。auth 开启且请求 没有 JWT claims(只有 Basic)时,通道判为shared-credential→ 硬 401User-scope endpoints require JWT credentials(packages/octopus/src/server/routes/instance/httpapi/handlers/file.ts的 uploadRaw/getImageRaw;resolveUserScopeChannel在middleware/authorization.ts)。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),上传链路完全没有接上。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只带 Basicauth_tokenquery(<img>无法带 Bearer),#7119 后截图页在 auth 服务器上可能同样受影响,建议一并核对。根因已定位并修复(PR 已建:octopus#7358)
根因:与 #14 的存储目录问题不同源。
#7119N-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):sdk.apiHeaders,Bearer 优先/Basic 兜底)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 设计),请另开工单。状态更新(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 桌面版复测(附件添加→发送→缩略图/预览),若仍复现请复开本票并附会话日志。