[Feature] 在 API 请求中发送 x-opencode-session 请求头（OpenCode Go 自 9 月 5 日起要求此项）

[Rain-0x01-39]

功能描述

Related #8158 #8179 #10045

Error code: 400 - {'type': 'error', 'error': {'type': 'MissingSessionID', 'message': 'Error from provider (Console Go): Request is missing x-opencode-session and cannot be routed efficiently. Please see [https://opencode.ai/docs/go/#where-can-i-use-it'}}](https://opencode.ai/docs/go/#where-can-i-use-it'%7D%7D)

AstrBot已有uuid标识对话数据，可以使用。

添加请求头

"custom_headers": {
  "User-Agent": "astrbot/4.25.x", // Go 文档中要求使用自身专属的 user agent 标识而不是通用的 SDK 或 HTTP 库名称。
  "x-opencode-session": "astrbot 114514" // 更推荐发送真实稳定的会话 UUID，但在这之前只能发送固定值
},

使用场景

No response

检查清单

• 我已在 Issue 列表中搜索过相关功能，确认该功能想法从未被提出过。
• 我建议的功能与 AstrBot 本体相关，而非在建议某一插件的功能。
• 我已阅读并同意本项目的贡献者行为准则。
• (可选)我愿意提交 PR 以帮助实现该功能。

[Rain-0x01-39]

是否应该让所有LLM提供商都携带UA和会话ID？

[LIghtJUNction]

结论：应该支持这个头，但不建议让所有 LLM 提供商无条件携带 UA 和会话 ID。OpenCode 文档要求的是“客户端自有 User-Agent + 每个 conversation 稳定的 x-opencode-session”，应按 OpenCode endpoint/provider 或显式兼容开关启用。官方说明见 OpenCode Go / Where can I use it。

代码依据与原因链

• astrbot/core/provider/entities.py::ProviderRequest 同时已有 session_id 和 conversation；conversation.cid 是现成的对话标识。
• astrbot/core/astr_main_agent.py 在没有显式 req.session_id 时将其回退为 event.unified_msg_origin。这个值带平台/会话身份语义，不适合直接作为第三方请求头；应优先使用不暴露 UMO 的 conversation.cid。
• astrbot/core/agent/runners/tool_loop_agent_runner.py::_iter_llm_responses（以及 skills-like re-query/repair 路径）把 self.req.session_id 传给 provider。
• 但 astrbot/core/provider/sources/openai_source.py::ProviderOpenAIOfficial.text_chat / text_chat_stream 虽然接收 session_id，后续没有使用；_query / _query_stream 调用 chat.completions.create 时也没有传 extra_headers。
• 当前 custom_headers 只在 __init__ 中作为 SDK 的 default_headers 设置，是 provider 实例级静态值。用固定 x-opencode-session 能绕过 400，但会把多个 AstrBot 对话映射到同一 OpenCode session，失去路由/缓存隔离。

修改建议

建议增加一个明确的 OpenCode 兼容配置（或可靠识别其 API base），并把“provider request session”沿调用链单独传递：

provider_session_id = req.conversation.cid if req.conversation else run_scoped_uuid
headers = dict(configured_custom_headers or {})
if opencode_compat:
    headers["User-Agent"] = "astrbot/<version>"
    headers["x-opencode-session"] = provider_session_id
chat.completions.create(..., extra_headers=headers)

具体应同时覆盖：

1. ToolLoopAgentRunner._iter_llm_responses、skills-like re-query 与 repair，保证同一轮工具调用/重试一直使用同一个 ID。
2. ProviderOpenAIOfficial._query 和 _query_stream 两条路径，按请求创建新 dict 并传 extra_headers；不要原地修改 self.custom_headers，因为 provider 实例会被多个异步会话共享，否则会串 session。
3. 定义自定义头的冲突优先级。建议 OpenCode 兼容模式下动态 session ID 优先，避免用户遗留的固定值重新破坏隔离；非 OpenCode provider 保持现状。
4. 没有关联 Conversation 的一次性调用使用 run-scoped 随机 ID，不应回退到原始 UMO。

修改后的效果与验证

同一 AstrBot 对话的流式、非流式、重试和辅助 re-query 会稳定落到同一 OpenCode session；不同对话不会互相污染；其他 OpenAI-compatible 服务不会收到其未约定的头，现有 custom_headers 也保持兼容。

建议增加 provider 层回归测试：两并发 conversation 得到不同 header 且不串值；同一 conversation 的 stream/non-stream/retry/re-query 值一致；用户配置其他 custom header 仍保留；显式关闭兼容或非 OpenCode endpoint 时不注入；没有 conversation 时不泄露 UMO。

[piexian]

#10005 其实本来已经加了但是莫名其妙给我中断了