#243

自定义第三方 API 缺少会话标识:OpenCode Go 返回 400 MissingSessionID

OpenYANGTHEKINGopened 9d ago

What happened

在 Poki iPhone 独立版的“自定义地址”中配置 OpenCode Go 的 OpenAI 兼容接口、有效 API Key 和 DeepSeek 模型后,请求返回 HTTP 400 MissingSessionID。当前自定义提供商界面没有提供会话请求头的配置入口。

期望:自定义第三方提供商能够收到其要求的会话标识;同一个聊天在多轮消息、重试及恢复聊天时保持同一个 ID,新聊天使用新的 ID。除 OpenCode Go 外,也希望考虑其他需要额外请求头的兼容服务。

OpenCode Go 官方文档 要求客户端发送每个会话稳定的 x-opencode-session,并使用真实的客户端 User-Agent。文档将 Go 定位为编码代理服务;这里报告的是缺少请求元数据导致的接口兼容问题。

已验证与代码线索:

  • 实际 400 错误在官方 Poki 0.2.9 (672) Alpha 上出现。
  • 本机基于该阶段代码构建 0.2.9 (672.1):把 ChatModel 已保存的 session ID 传给 PiLoop,再通过 AgentOptions.sessionId 传给 PiSwift;同时设置真实的 Poki/<version> 客户端标识。覆盖安装后,用户用原来的 OpenCode Go/DeepSeek 设置新建聊天,确认能够正常回复。
  • 随后已按用户意愿换回官方 0.3.1 (752)。尚未在该官方版本上重新验证这次 HTTP 400,不能把旧版的运行结果当作新版复现。
  • 不过,0.3.1 发布提交 e5071ac 的 PiLoop.swift 仍未向 AgentOptions 传入 session ID 或客户端 identity。固定依赖中的 PiSwift OpenCodeHeaders.swift 已有生成该请求头的逻辑。

建议优先把 Poki 聊天的持久化会话 ID 接入现有 PiSwift 能力,并覆盖辅助模型请求;也可考虑为自定义提供商提供额外请求头配置及会话变量支持。以上是本机验证过的修复方向,尚未提交 PR。

Steps to reproduce

  1. 使用官方 Poki 0.2.9 (672) Alpha。
  2. 在模型设置中选择自定义 OpenAI 兼容地址,填写 OpenCode Go 对应接口、有效的 Go API Key 和所用 DeepSeek 模型。
  3. 新建聊天并发送消息。
  4. 观察 HTTP 400,错误类型为 MissingSessionID,提示缺少 x-opencode-session。
  5. 对照验证:使用上述传递 session ID 的本机测试构建,保持同一提供商设置,新建聊天后可以正常回复。

初次配置的完整接口路径和 DeepSeek 子型号未单独记录,因此不在报告中猜测。未对其他第三方提供商做实际测试。

Area

Chat, voice, or sessions

App version

  • 运行时复现:Poki 0.2.9 (672) Alpha,官方包。
  • 本机验证修复:Poki 0.2.9 (672.1),自编译测试包。
  • 当前已安装:官方 Poki 0.3.1 (752) Alpha,未加入上述本机修改;本报告对该版本的说明限于源码核对。

Installed with

Poki Setup 0.2.2 (661),免费 Apple 账号签名。初装 Mac 为 macOS 26.5.1;本机验证构建使用 macOS 27.2.1 / Xcode 27.2。当前官方版也通过 Poki Setup 覆盖安装。

iPhone and iOS

iPhone(硬件标识 iPhone18,2),iOS 26.6.2。

Debug log

用户截图中的原始错误文本:

自定义地址: OpenAI API error (400): {"type":"error","error":{"type":"MissingSessionID","message":"Request is missing x-opencode-session and cannot be routed efficiently. Please see https://opencode.ai/v2/docs/console/go/#where-can-i-use-it"}}

未附 API Key、Apple 账号、设备唯一标识或聊天内容。

Activity

4
JosssphZhou8d ago

Thanks for the MissingSessionID report and the earlier workaround. #322 addresses the session metadata path, but it still needs a regression that observes the actual outgoing request and confirms stability across retries and reopening the conversation. We cannot identify a released fix yet, so this issue should remain open.

vecStardo5d ago

再补一个数据点:问题不止在聊天,模型页的「连接测试」就已经失败,所以这个 provider 根本存不下来。

环境

  • Poki 0.4.2 (1515),Poki Setup + 免费 Apple 账号签名
  • iPhone19,2 / iOS 27.0.1
  • 自定义端点 https://opencode.ai/inference/go/openai/v1,模型 deepseek-v4-pro,有效 OpenCode Go key

现象

填完 key 点测试立即报错,此时还不存在任何对话:

POST https://opencode.ai/inference/go/openai/v1/chat/completions
400 {"type":"error","error":{"type":"MissingSessionID","message":"Request is missing x-opencode-session and cannot be routed efficiently. ..."}}

同一端点在 Mac 上用假 key 做的对照:不带头 → 400 MissingSessionID;带 x-opencode-session: <uuid> → 401 Invalid credential。说明路由在鉴权之前就把请求挡了,缺头是唯一卡点。

影响

期望:key 正确时连接测试应当通过。 实际:配置无法保存,用户走不到聊天那一步,因此聊天侧的会话标识修复对这条路径无效。

测试请求看起来没有携带任何会话元数据;这一点是否属于本次修复范围,还是需要单独处理?

ScottH11225d ago

谢谢补充「测试连接」这条路径和两组 HTTP 状态。测试发生在会话创建前,我已单独提交 #427,让每次测试使用自己的 OpenCode 会话标识,标识只发送到 PiSwift 识别的 OpenCode 目标。模拟器已通过请求层回归,使用替身服务验证了你报告的地址和普通自定义地址。真实账号还未测试,聊天中的持久会话标识仍由 #322 跟进。修复进入可用构建后,如果你方便复测,反馈版本和「测试连接」的结果就够了,无需分享密钥。谢谢!

JosssphZhou5d ago

Thanks for the clear data point, the header comparison with a fake key made the cause obvious. You're right that Test Connection needs its own fix: it runs before any conversation exists, so the chat-side session ID work does not reach it.

#427 covers exactly this path. Test Connection gets its own session ID and sends the OpenCode header. We're reviewing it now and will post here once it lands in a build.