LCX Codex

给 DeepSeek Harness 里的 GPT 和 Grok 加上联网搜索和长对话自动压缩。

简体中文 · English · 更新日志 · 问题反馈

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 版本，再按下表选择：

请务必按表格选择：三个版本互不兼容，装错版本时安装命令可能只给出依赖警告，但插件可能无法正常工作。0.5.0-pre.1 是预发布版，本次预发布的验收基线为 DSH 0.2.0-rc.2（host / plugin Pi 0.87.1）。

2. 安装并启动

DSH 0.2.0 系列：

dsh plugin --profile web add dsh-lcx-codex@prelatest
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 系列：

dsh plugin --profile web add dsh-lcx-codex@latest
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.0 系列：把插件换成 @prelatest（0.5.0-pre.1），旧版 0.4.x 不支持 DSH 0.2。
• DSH 0.1.6 系列：继续使用 @0.4.4-pre.1；@prelatest 现在指向支持 DSH 0.2 的 0.5.0-pre.1。
• 升级后建议新建会话：旧版本保存的压缩状态不保证兼容。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 的智能体调用会把多次内部请求的用量累加计费。0.5.0-pre.1 在服务端返回完整的实时上下文数据时，用它来判断何时压缩，缺失时退回估算；计费数字本身保持不变。
• Alpha 仍是实验功能：连续打开/查找页面在已测试的 OAuth 类上游上可用；API Key 类上游账号不在支持范围内。目标页面抓取失败时会提示 LCX_ALPHA_PAGE_FETCH_FAILED，模型可以换一个结果继续。
• Markdown 图片换行：为避免 DSH 0.2 中图片后的文字挤到图片右侧，LCX 会让回答里的 Markdown 图片单独占一行，这一点与“搜索媒体预览”开关无关；句中的小图也会因此换行。
• DSH 0.1.5 + LCX 0.4.3：在插件设置中启用或停用 LCX 后，已打开的浏览器页面可能需要刷新。
• 验证范围：0.5.0-pre.1 的验收基线为 DSH 0.2.0-rc.2（预发布）；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@prelatest，然后启动 dsh web。

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

反馈问题

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

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

更多

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

许可证

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