前言¶
在使用 DeepSeek Harness 開發智能體時，調用 opencode.ai 提供的模型服務通常需要特定的請求頭。手動爲每個請求添加 x-opencode-session 既繁瑣又容易出錯。該插件旨在自動化這一過程，確保請求符合服務端要求，避免因頭信息缺失導致的調用失敗。
插件介紹¶
這是一個 DeepSeek Harness 插件，由 Coco-king 維護，遵循 MIT 許可證。當模型調用發往 URL 包含 opencode.ai 的服務（如 OpenCode Go / Zen 網關）時，它會自動附加 x-opencode-session 請求頭。
核心功能¶
- 自動附加請求頭：自動爲發往 opencode.ai 的請求添加該頭。
- 同一對話內固定：同一對話的所有模型請求攜帶同一個值。
- 不同對話互不相同：各對話之間互不干擾。
- 斷開網絡或重啓後不變：值來自對話自身的持久標識，重啓、續聊、斷網重連後依然一致。
- 僅影響 opencode.ai 請求：不維護額外狀態，只修改目標請求。
安裝與啓用¶
從 GitHub 安裝：
dsh plugin --profile web add https://github.com/Coco-king/dsh-x-opencode-session.git#v0.1.0
從 Gitee 安裝（國內用戶可用；代碼由 GitHub 自動鏡像同步到 Gitee）：
dsh plugin --profile web add https://gitee.com/kkcoco/dsh-x-opencode-session.git#v0.1.0
重啓 web 服務（或刷新頁面 + HMR）後生效。
使用驗證¶
- 使用 opencode-go 提供方的模型發起對話並正常使用。
- 通過抓包或服務端日誌確認請求帶上了
x-opencode-session頭。 - 同一對話中多次請求值應保持一致，另開一個新對話值應不同，重啓 web 後再發消息值仍與之前一致。
注意事項¶
- 值無需任何配置，自動複用對話自帶會話標識。
- 不維護額外狀態，僅影響 opencode.ai 請求。
- 安裝前建議檢查源碼與許可證。
結語¶
該插件通過複用對話自帶標識，解決了 opencode.ai 調用中的會話頭問題。更多詳情可參考 GitHub。
