dsh-lcx-codex

LCX Codex 是 DeepSeek Harness（DSH）的社区插件。装上之后，你在 DSH 里用的 GPT 和 Grok 可以：

• 联网搜索：GPT 使用 Responses 服务端搜索（Hosted Search），Grok 使用 xAI 原生 Web Search 和 X Search；
• 长任务不中断：对话接近上下文上限时自动压缩并继续，不用手动开新会话；
• 直接看到图片和视频：搜索返回的图片、回答里的图片直链排成一行显示在回答下方，点击用 DSH 自带的看图器放大；视频直链显示为卡片，点击后在回答里直接播放。

模型、API Key、会话和其他工具仍由 DSH 管理，不需要额外配置。其他模型（如 DeepSeek）照常走 DSH 自己的逻辑，不受影响。

使用前提

• 已安装 DSH，并在 DSH 中配置好 GPT 或 Grok 的 Responses API 路由（官方 API 或兼容网关均可）。
• Node.js ^22.19.0 或 >=24.0.0。

搜索和压缩依赖服务端能力。你的网关能正常聊天，不代表它一定支持这些功能，详见已知限制。

安装

1. 按 DSH 版本选择插件版本

先运行 dsh --version 查看 DSH 版本，再按下表选择：

请务必按表格选择：几个版本互不兼容，装错版本时安装命令可能只给出依赖警告，但插件可能无法正常工作。@latest 是稳定版 0.5.2（发布基线 DSH 0.2.0-rc.2，host / plugin Pi 0.87.1），DSH 0.1.5 用户请固定安装 @0.4.3。

0.6.0-pre.2 是预发布版，面向 DSH 0.2.1-alpha.2。它的安装范围只有下限（>=0.2.1-alpha.2），没有上限：更新的 DSH 版本也能装上，但没有经过验证。本次预发布的验证基线只有 DSH 0.2.1-alpha.2（host Pi 1.1.0，plugin Pi 1.1.0），请不要据此认为其他 DSH 版本受支持。

本版本开始适配 DSH 0.2.1 的插件相关新能力：

• 增量工具更新（只增不改）：在 DSH 声明支持该模式的 GPT Responses 路由上，会话中途新增工具（例如打开联网搜索、启用 MCP 或技能）时，请求里的工具列表保持不变，新增的工具以历史项的形式声明，因此不再改变已缓存的前缀。设置卡片里有“增量工具更新”开关，默认开启，关闭后每次请求都发送完整的当前工具列表。删除工具或同名重定义仍会让缓存失效一次。Grok、自定义命名路由、分叉与路由迁移的回放、压缩检查点仍然发送完整工具列表。
• 程序化工具调用里的搜索：在 run_code 程序里调用 web_search / websearch_gpt_advanced 时，搜索用量和返回的图片也会计入并显示。
• 插件管理页卡片：LCX 在插件管理页显示自己的名称（LCX Codex）、简介和图标。

注意：稳定版 0.5.x 的安装范围写作 >=0.2.0-rc.2 <0.2.1，按 DSH 的版本范围规则，0.2.1 的预发布版（如 0.2.1-alpha.2）也可能被放行安装，但这些版本不在 0.5.x 的支持和验证范围内；DSH 0.2.1-alpha.2 及以后请使用 @prelatest。

2. 安装并启动

DSH 0.2.1-alpha.2 及以后（预发布版）：

dsh plugin --profile web add dsh-lcx-codex@prelatest
dsh web

DSH 0.2.0 系列（稳定版）：

dsh plugin --profile web add dsh-lcx-codex@latest
dsh web

DSH 0.1.6 系列：

dsh plugin --profile web add dsh-lcx-codex@0.4.4-pre.1
dsh web

DSH 0.1.5 系列（注意固定版本号，不要用 @latest）：

dsh plugin --profile web add dsh-lcx-codex@0.4.3
dsh web

以后更新插件，重新运行同一条 add 命令即可。

3. 打开功能开关

打开 DSH Web 的插件页面，在 LCX 的配置卡片 Responses / Codex 能力 中按需打开下列开关，然后点击 保存。

GPT

Grok 原生搜索（与“启用 LCX”相互独立）

开启任一项后，Grok 改用 xAI 原生搜索；网页读取和其他 DSH / MCP 工具仍可正常使用。

显示

怎么用

像平时一样和模型说话即可，不需要写任何工具参数：

搜索 Python 官方文档，告诉我 asyncio.TaskGroup 应该怎么用。

搜几张金门大桥的照片，显示一张，并附上来源网页。

用 Grok 看看 X 上最近关于这个项目的讨论。

长对话会在接近上限时自动压缩；你也可以随时输入 /compact 手动压缩。

从旧版本升级

• DSH 升级到 0.2.1-alpha.2 或更新版本：把插件换成 @prelatest（0.6.0-pre.2），稳定版 0.5.x 没有在这些 DSH 版本上验证。
• DSH 升级到 0.2.0 系列：把插件换成 @latest（0.5.2），旧版 0.4.x 不支持 DSH 0.2。
• DSH 0.1.6 系列：继续使用 @0.4.4-pre.1。
• DSH 0.1.5 系列：继续使用 @0.4.3；@latest 现在指向支持 DSH 0.2 的 0.5.2。
• 已装了 0.5.0-pre.1：DSH 0.2.0 系列重新运行 @latest 的 add 命令即可升到稳定版（0.5.0-pre.1 与 0.5.0 运行时代码一致）；DSH 0.2.1-alpha.2 及以后用 @prelatest。
• 升级后建议新建会话：旧版本保存的压缩状态不保证兼容。DSH 0.2 迁移过的旧长会话如果带有旧版 LCX 压缩检查点，LCX 会提示 LCX_CHECKPOINT_UNSUPPORTED，新建会话即可；其他模型不受影响。

停用与卸载

• 临时停用：在配置卡片中关闭 启用 LCX 和 Grok 原生搜索开关并保存，GPT 和 Grok 即恢复 DSH 原生行为。

• 卸载：

  dsh plugin --profile web remove dsh-lcx-codex
  

已知限制

• 网关能力因人而异：搜索、压缩、Alpha 都依赖对应的服务端能力，不同网关支持程度不同。
• Grok：支持 API Key / API 网关路由，不支持 xAI OAuth / SuperGrok 登录。原生 X Search 目前只在 grok-4.6 上验证过。
• Grok 长对话压力：xAI 的智能体调用会把多次内部请求的用量累加计费。LCX 在服务端返回完整的实时上下文数据时，用它来判断何时压缩，缺失时退回估算；计费数字本身保持不变。
• Alpha 仍是实验功能：连续打开/查找页面在已测试的 OAuth 类上游上可用；API Key 类上游账号不在支持范围内。目标页面抓取失败时会提示 LCX_ALPHA_PAGE_FETCH_FAILED，模型可以换一个结果继续。
• Markdown 图片换行：为避免 DSH 0.2 中图片后的文字挤到图片右侧，LCX 会让回答里的 Markdown 图片单独占一行，这一点与“搜索媒体预览”开关无关；句中的小图也会因此换行。
• DSH 0.1.5 + LCX 0.4.3：在插件设置中启用或停用 LCX 后，已打开的浏览器页面可能需要刷新。
• DSH 0.2.1 的工具更新：增量工具更新只在 DSH 声明“只增不改”的 GPT Responses 路由上生效；当 DSH 的工具历史或模型信息缺失、路由不支持或设置卡片里关闭了开关时，LCX 回到每次发送完整工具列表。删除工具或同名重定义仍会让缓存失效一次。缓存命中受上游影响有波动：在 openai/gpt-6-sol 上用同一操作序列对比，开启时新增工具后的首个请求约 80% 命中缓存，关闭时为 0%。LCX 自带的模型目录冻结在 Pi 0.86，目录里没有的新模型（如 gpt-6-sol）按 DSH 的声明处理。
• 验证范围：0.6.0-pre.2 的验证基线只有 DSH 0.2.1-alpha.2（预发布，host Pi 1.1.0），安装范围没有上限，更新的 DSH 版本未经验证；该基线上的真实运行验证覆盖 GPT 路由、搜索、压缩、增量工具更新、run_code 内的搜索和插件管理页卡片等主要场景；其中 run_code 的实机检查在隔离环境里使用了完全访问的权限模式（DSH 的 Windows 文件沙箱在该机器上无法启动 run_code），程序只做了搜索调用。Grok 原生搜索和用户图片输入只做了有限的回归检查，Alpha 搜索和自然触发的压缩压力档位没有在这一轮覆盖。稳定版 0.5.2 的发布基线为 DSH 0.2.0-rc.2（0.5.0 同）；0.4.4-pre.1 在 DSH 0.1.6-alpha.2 上完整验证；0.4.3 的稳定发布基线是 DSH 0.1.5-rc.1，并已另外验证 DSH 0.1.5-rc.2。同一安装范围内其他后续版本仍需单独评估，遇到问题欢迎反馈。

常见问题

装完没有变化？ 确认安装命令和启动命令用的是同一个 profile（上面的示例都是 web），并检查插件设置里的开关已经保存。

能正常聊天，但搜索或压缩失败？ 大概率是当前 GPT / Grok 路由没有提供对应的服务端能力。可以换官方 API 或其他网关对比一下。

安装时出现依赖版本警告，或插件加载失败？ 通常是 DSH 版本和插件版本不匹配，按上面的表格重新选择。

升级到 DSH 0.2 后插件“导入失败”（failed to import）？ 从较早版本一路升级上来的配置目录里可能残留旧的依赖包。先停止 dsh web，把 DSH 主目录（默认 ~/.dsh，或 DSH_HOME 指定的目录）下 profiles/web/ 里的 node_modules 和 pnpm-lock.yaml 移走或删除，再重新运行对应的 dsh plugin --profile web add dsh-lcx-codex@latest（DSH 0.2.1-alpha.2 及以后用 @prelatest），然后启动 dsh web。

刚发布新版时 @latest / @prelatest 装到了旧版本？ 包管理器的缓存可能还没刷新，DSH 会因版本不兼容拒绝安装。稍等几分钟重试，或直接指定版本号，例如 dsh-lcx-codex@0.6.0-pre.2 或 dsh-lcx-codex@0.5.2。

反馈问题

请在 Issues 中附上：插件版本、DSH 版本、Node.js 版本、使用的模型/网关类型和复现步骤。

请不要上传 API Key、完整请求内容或未脱敏的会话日志。

更多

• 更新日志
• 架构说明
• 第三方许可
• 参与贡献

许可证

MIT。独立社区插件，与 OpenAI、xAI、DeepSeek、Sub2API、NewAPI 无隶属关系，也未获得其官方背书。