前言¶
在 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 为准。