前言¶
在 DeepSeek Harness(DSH)裏接 GPT / OpenAI Responses route 做智能體開發,如果壓縮、Replay、搜索這些環節和 provider 原生能力對不上,就容易遇到中途換實現、緩存反覆失效這類問題。DSH 的理念是「一切皆插件」,這類缺口正適合交給插件來補。
下面介紹的 dsh-lcx-codex 做的就是這件事:接管 DSH 的 GPT Responses 路徑,補上 Native V2 Compact / Replay、Hosted Search、Prompt Cache 和連續網頁操作。
這是什麼¶
dsh-lcx-codex 是由 kk3ya03-star 維護的 DSH 插件,MIT 許可證,當前穩定版是 0.4.2,npm latest 已指向該版本。一句話定位(README 原文):
給 DeepSeek Harness 的 GPT / OpenAI Responses 路徑補上 Native V2 Compact / Replay、Hosted Search、Prompt Cache 和連續網頁操作。
需要說明:這是獨立社區插件,與 OpenAI、DeepSeek、Sub2API、NewAPI 無隸屬或官方背書關係。
核心功能¶
從第一輪開始接管 Responses 請求¶
LCX 開啓後,從第一輪普通請求開始接管 GPT Responses 請求,工具續接、Compact 和 Replay 不再中途換實現。
插件不改 DSH host:Agent、Session、工具執行和 compaction policy 仍由 DSH 管理。插件自帶的 Pi 版本(0.84.3)與 DSH host 的 Pi(0.82.1)相互隔離,不會通過 override 升級 host 的 Pi。
Native V2 Compact / Replay¶
壓縮時機仍由 DSH 決定,LCX 只負責把壓縮請求送到 Responses Native V2,並把結果接回現有 Session。默認 pressure 策略:
< 90% 正常運行
90% 優先 Native V2 Compact
95% 允許 DSH emergency prune
手動 /compact 繼續使用 DSH 自己的 compaction transaction。Native V2 Compact 支持 Replay、重啓恢復和 GPT 模型切換。
Native state 只在兼容的同一會話 / route 上覆用;切換到不兼容的 GPT route 時會自動改用 portable history,不會把舊 opaque state 硬塞過去。
Prompt Cache¶
在 GPT-5.6 兼容 route 上,LCX 使用 prompt_cache_options 並保持穩定的 cache identity。普通連續對話和 tool-heavy 任務只要請求前綴不變,就可以持續命中緩存。
搜索:保留原生入口,按需開啓高級能力¶
普通搜索仍走 DSH 原生 web_search,鏈路是:
DSH web_search → LCX SearchProvider → GPT Hosted Search
需要更多控制時,可以單獨開啓兩個能力:
websearch_gpt_advanced:域名過濾、位置、search context、圖片搜索等 Hosted Search 參數websearch_alpha:連續search / open / find / click / screenshot操作;默認關閉,只有當前 route 的 capability probe 通過後纔會註冊
安裝與啓用¶
先確認環境,再執行安裝命令。需要:
- DSH
0.1.1-rc.2 - Node.js
^22.19.0 || >=24.0.0 - 一個已經能工作的 GPT Responses route
安裝命令:
dsh plugin --profile web add dsh-lcx-codex
dsh web
第一條命令把插件裝進 DSH 的 web profile,第二條啓動 DSH Web。
經過上面的步驟,在 DSH Web 的插件設置裏就能看到 LCX 開關。
典型用法¶
在 DSH Web 的插件設置裏打開 LCX:
LCX OFF → 完全使用 DSH 原生 LLM 流程
LCX ON → 當前 GPT 會話從第一輪開始走 LCX Responses 路徑
兩點提醒:
1、LCX 只面向 GPT / OpenAI Responses。切換 Claude、Gemini、DeepSeek 等非 GPT 模型前先關掉 LCX,不需要重啓 DSH。
2、配置建議先用默認值,只改真正需要的選項,完整配置項見倉庫 README。
兼容性與已知限制¶
0.4.2 的官方兼容範圍:
- 插件
0.4.2 - DSH
0.1.1-rc.2 - DSH host Pi
0.82.1 - Plugin Pi
0.84.3(@earendil-works/pi-ai,僅插件自用) - Node.js
^22.19.0 || >=24
DSH 0.1.2-alpha.1 尚未列入 0.4.2 的正式兼容範圍。
已知限制:
- 當前常用 route 不接受 content-level
prompt_cache_breakpoint,插件未開放 explicit breakpoint 設置 - 動態加載 skill / plugin 改變頂層工具集合時,可能出現一次 Prompt Cache reset;工具功能不受影響
reasoning.context/reasoning.mode取決於 DSH / Pi 是否真正暴露這些字段- 1.05M long context 和 Programmatic Tool Calling 暫不是 0.4.2 的正式支持項
適用場景與注意¶
適合誰:在 DSH 裏使用 GPT / OpenAI Responses route、需要長會話穩定壓縮、Hosted Search 或 Prompt Cache 的開發者。只用非 GPT 模型的話,這個插件用不上。
安裝前注意兩點:
1、插件以當前 dsh 進程權限運行,裝進 profile 後它拿到的就是 dsh 進程的權限。安裝前建議檢查源碼與許可證,確認沒有問題再啓用。
2、對照上面的兼容範圍確認版本,尤其是 DSH 版本。
小結¶
dsh-lcx-codex 的事情很聚焦:把 DSH 的 GPT Responses 路徑補齊,讓壓縮、緩存、搜索儘量走 provider 原生能力,同時不碰 DSH host。如果你在 DSH 裏跑 GPT route,可以按上面的步驟試一下。
- 插件目錄頁:https://www.skillhub.cn/plugins/kk3ya03-star/dsh-lcx-codex
- GitHub 倉庫:https://github.com/kk3ya03-star/dsh-lcx-codex
最後提醒:skillhub.cn 是獨立的社區插件目錄,與 DeepSeek / 幻方無官方從屬關係,插件信息以倉庫 README 爲準。