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
- 使用官方 Poki 0.2.9 (672) Alpha。
- 在模型设置中选择自定义 OpenAI 兼容地址,填写 OpenCode Go 对应接口、有效的 Go API Key 和所用 DeepSeek 模型。
- 新建聊天并发送消息。
- 观察 HTTP 400,错误类型为
MissingSessionID,提示缺少x-opencode-session。 - 对照验证:使用上述传递 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再补一个数据点:问题不止在聊天,模型页的「连接测试」就已经失败,所以这个 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 正确时连接测试应当通过。 实际:配置无法保存,用户走不到聊天那一步,因此聊天侧的会话标识修复对这条路径无效。
测试请求看起来没有携带任何会话元数据;这一点是否属于本次修复范围,还是需要单独处理?
谢谢补充「测试连接」这条路径和两组 HTTP 状态。测试发生在会话创建前,我已单独提交 #427,让每次测试使用自己的 OpenCode 会话标识,标识只发送到 PiSwift 识别的 OpenCode 目标。模拟器已通过请求层回归,使用替身服务验证了你报告的地址和普通自定义地址。真实账号还未测试,聊天中的持久会话标识仍由 #322 跟进。修复进入可用构建后,如果你方便复测,反馈版本和「测试连接」的结果就够了,无需分享密钥。谢谢!
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.
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.