dsh-lcx-codex

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

你的 DSH 版本	安装的 LCX 版本	安装命令中的标签
0.2.1-alpha.2 及以后	最新预发布版（0.6.x 预发布线）	@prelatest
0.2.0 系列（0.2.0-rc.2，早于 0.2.1-alpha.2）	0.5.2（稳定版）	@latest
0.1.6 系列（0.1.6-alpha.2 及以后）	0.4.4-pre.1（旧预发布版）	@0.4.4-pre.1
0.1.5 系列（0.1.5-rc.1 及以后）	0.4.3（稳定版）	@0.4.3

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

@prelatest 指向 0.6.x 预发布线的最新预发布版，面向 DSH 0.2.1-alpha.2 及以后。它的安装范围只有下限（>=0.2.1-alpha.2），没有上限：更新的 DSH 版本也能装上，但没有经过验证。每个预发布版只验证其发布说明里写明的 DSH 基线（目前为 DSH 0.2.1-alpha.2），请不要据此认为其他 DSH 版本受支持。

注意：稳定版 0.5.2 的安装范围写作 >=0.2.0-rc.2 <0.2.1，按 DSH 的版本范围规则，0.2.1 的预发布版（如 0.2.1-alpha.2）也可能被放行安装，但这些版本不在 0.5.2 的支持和验证范围内；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

开关	作用	建议
启用 LCX	GPT 功能的总开关，包括长对话自动压缩	用 GPT 时打开
使用 GPT Hosted Search 作为 DSH web_search 后端	GPT 联网搜索	需要联网时打开
启用高级 Hosted 工具	图片搜索、限定网站、指定位置等（需先打开上一项）	按需
启用 Alpha command	实验功能：让 GPT 继续打开、查找搜索结果中的页面	日常不需要

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

开关	作用
启用原生 Web Search	Grok 搜索网页
启用原生 X Search	Grok 搜索 X 内容

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

显示

开关	作用
搜索媒体预览	在回答下方显示搜索返回的图片、回答里的图片直链和可直接播放的视频直链；图片横排显示、点击放大，视频点击后在回答里播放。回答里用 Markdown 写的图片由 DSH 原生显示，不会重复；普通网页链接保持为链接。只改变界面显示，不影响发给模型的内容

怎么用

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

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

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

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

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

从旧版本升级

• DSH 升级到 0.2.1-alpha.2 或更新版本：把插件换成 @prelatest（0.6.x 预发布线），稳定版 0.5.2 没有在这些 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、0.5.1 或 0.5.0-pre.1：DSH 0.2.0 系列重新运行 @latest 的 add 命令即可升到 0.5.2（修复了缺陷，安装范围不变，详见 CHANGELOG；0.5.2 修复了 profile 里没写 api 时 gpt-6-sol 等模型报 NO_ADAPTER 的问题）；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 0.2.1 的“只增不改”增量工具更新没有实现，LCX 仍然每次请求都发送完整的当前工具列表；这一变化带来的缓存收益不在声明范围内。
• 验证范围：@prelatest（0.6.x 预发布线）只验证其发布说明里写明的 DSH 基线（目前为 DSH 0.2.1-alpha.2），安装范围没有上限，更新的 DSH 版本未经验证；具体验证覆盖范围见对应预发布版的 CHANGELOG 和发布说明。0.5.2 的发布基线为 DSH 0.2.0-rc.2（host / plugin Pi 0.87.1）；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.5.2。

反馈问题

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

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

更多

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

许可证

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