dsh-lcx-codex 0.4.2 → 0.4.3-pre.2

package/README.md

@@ -1,277 +1,191 @@
-# dsh-lcx-codex
+<div align="center">
 
-[![npm](https://img.shields.io/npm/v/dsh-lcx-codex?label=stable&color=1677ff)](https://www.npmjs.com/package/dsh-lcx-codex)
-[![CI](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml/badge.svg)](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml)
-![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-4ea8ff)
-![Node](https://img.shields.io/badge/Node-%5E22.19%20%7C%7C%20%3E%3D24-2f855a)
-![Plugin Pi](https://img.shields.io/badge/plugin%20Pi-0.84.3-111827)
-![License](https://img.shields.io/badge/license-MIT-6b7280)
+<img src="https://raw.githubusercontent.com/kk3ya03-star/dsh-lcx-codex/main/assets/dsh-lcx-codex-banner.svg" alt="LCX Codex" width="100%" />
 
-**简体中文** · [English](README_EN.md) · [Architecture](ARCHITECTURE.md) · [Changelog](CHANGELOG.md) · [Releases](https://github.com/kk3ya03-star/dsh-lcx-codex/releases)
+# LCX Codex
 
-> **让 DSH 的 GPT Responses 会话从第一轮普通请求开始，到工具调用、Native V2 Compact / Replay、重启恢复和 GPT 模型切换，始终保持同一个最终 Responses wire owner。**
+**让 DeepSeek Harness 中的 GPT 会话支持原生压缩、联网搜索与连续网页操作。**
 
-`dsh-lcx-codex` 不替换 DSH。DSH 仍负责 Agent、Session、模型选择、工具执行、附件和 compaction policy；当 **LCX ON** 时，LCX 接管当前 GPT Responses 会话的最终 request / SSE wire。
+[![npm](https://img.shields.io/npm/v/dsh-lcx-codex?label=npm)](https://www.npmjs.com/package/dsh-lcx-codex)
+[![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-16803c)](#兼容性与限制)
+[![License](https://img.shields.io/badge/license-MIT-555)](LICENSE)
 
-## 当前稳定版
+**简体中文** · [English](README_EN.md) · [版本发布](https://github.com/kk3ya03-star/dsh-lcx-codex/releases) · [问题反馈](https://github.com/kk3ya03-star/dsh-lcx-codex/issues)
 
-**`0.4.2`** 是当前稳定版，也是已完成真实 DSH + Sub2API 验收的 `0.4.2-pre.1` 的 **zero-functional-change stable promotion**。
+</div>
 
-```powershell
-dsh plugin --profile web add dsh-lcx-codex
-dsh web
-```
-
-- npm dist-tag：`latest`
-- DSH：`0.1.1-rc.2`
-- Plugin Pi：`0.84.3`
-- Node.js：`^22.19.0 || >=24.0.0`
-
-`0.4.2-pre.1` 保留为历史 prerelease；新用户直接安装 `latest` 即可。
-
-## 产品约定
-
-```text
-LCX OFF
-= 完全使用 DSH 原生 LLM 流程
-
-LCX ON
-= 当前 GPT Responses 会话从 ordinary turn 1 开始
-  由 LCX 持有最终 Responses request / SSE wire
-```
-
-切换 Claude、Gemini、DeepSeek 等非 GPT 模型前先关闭 LCX；模型切换本身不需要重启 DSH。
-
-## 为什么需要 LCX
-
-DSH 原本已经拥有 Agent、Session、Tools 和 compaction lifecycle。LCX 解决的是 GPT Responses provider-native 路径的最后一层一致性：ordinary、tools、Native Compact、Replay、restart/resume 和 GPT route migration 不再在同一个会话中切换最终 wire owner。
-
-```text
-                        DSH
-              Agent / Session / Tools
-                         │
-                 llm / stream seam
-                         │
-              ┌──────────┴──────────┐
-              │                     │
-           LCX OFF               LCX ON
-              │                     │
-       native DSH adapter      LCX Responses Core
-                                    │
-                         ordinary turn 1
-                                    ↓
-                                 tools
-                                    ↓
-                         Native V2 Compact
-                                    ↓
-                                Replay
-                                    ↓
-                           Restart / Resume
-                                    ↓
-                         GPT Model Migration
-```
+LCX Codex（`dsh-lcx-codex`）是 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)（DSH）的社区插件，为已配置好的 **GPT / OpenAI Responses 接口**扩展长会话和搜索能力，适用于兼容的 Sub2API、NewAPI 等通道。
 
-Compact 因此只改变 history representation，不再同时改变 request owner。
+你仍然在 DSH 中选择模型、管理会话和使用工具。开启 LCX 后，从普通对话到工具调用、上下文压缩和压缩后的续聊，都使用同一条 Responses 请求路径。
 
-## 核心能力
+## 它能做什么
 
-### 1. Full GPT Responses lifecycle ownership
+| 你需要 | LCX 提供 |
+| --- | --- |
+| **长对话继续进行** | 接近上下文上限时优先使用 Native V2 原生压缩，支持压缩后续聊和重启恢复。 |
+| **在对话中查询网页** | 通过 DSH 原有的 `web_search` 使用 GPT Hosted Search，普通搜索跟随当前 Agent 的 GPT 模型。 |
+| **更细的搜索控制** | 按需启用域名过滤、位置、搜索上下文大小、图片搜索等 Hosted Search 参数。 |
+| **连续查阅网页** | 在支持的接口上使用 Alpha 工具，连续执行搜索、打开、查找、点击等操作。 |
+| **复用提示词缓存** | 在支持的 GPT-5.6 接口上保持稳定的缓存标识，让相同的请求前缀可以被重复利用。 |
 
-LCX ON 后，ordinary、tool continuation、Native Compact、Native Replay、restart/resume 和 portable GPT migration 使用同一套 LCX Responses request builder / transport owner。
+> LCX 面向 GPT / OpenAI Responses。各项扩展能力取决于上游接口支持；能正常对话，不代表该通道同时支持原生压缩、Hosted Search 或 Alpha 网页操作。
 
-DSH 仍是 canonical session/history owner；LCX 不创建第二套会话数据库，也不替换 DSH Tool Executor。
+## 快速开始
 
-### 2. GPT-5.6 Prompt Cache
+### DSH 0.1.3 用户：0.4.3-pre.2 预发布
 
-`0.4.2` 使用 GPT-5.6 当前 cache-options 路径，并保持同一会话的稳定 cache identity：
+`0.4.3-pre.2` 面向 **DSH `0.1.3-alpha.2` / host 与插件 Pi `0.85.1`**，安装时明确选择预发布：
 
-- 默认使用 implicit caching；
-- 当前支持 route 发送 `prompt_cache_options.ttl = 30m`；
-- 普通连续 turn / tool-heavy workload 可以复用已 warm 前缀；
-- Native Compact 会按设计建立新的 history/cache epoch，旧未压缩前缀不会被承诺继续复用；
-- 真实长会话中，稳定 topology 下 warm request 多次观察到接近完整前缀复用。
-
-缓存命中由 provider、模型、请求前缀、工具 schema 和会话状态共同决定，不是固定性能承诺。
-
-一个已确认的边界：运行中激活 skill 若改变顶层 tool schema，会发生一次 cache reset；新 tool topology 稳定后下一请求即可重新 warm。当前支持 route 会拒绝 content-level `prompt_cache_breakpoint`，而 DSH `0.1.1-rc.2` 也没有可靠的 dynamic-tool provenance，因此 `0.4.2` 保留一次安全 reset，而不靠猜测重写工具历史。
+```sh
+dsh plugin --profile web add dsh-lcx-codex@0.4.3-pre.2
+dsh web
+```
 
-### 3. Native V2 Compact + Replay
+也可使用 `dsh-lcx-codex@prelatest` 跟随预发布通道。稳定通道 `latest` 仍为 `0.4.2`，对应下面的旧版安装说明，不要混用 DSH 版本。
 
-DSH 仍决定 **何时压缩、压缩范围、事务与 recovery**；LCX 只负责 provider-native Responses V2 wire。
+新版只保留 LCX、Hosted Search、高级 Hosted、Alpha 四个开关；`90%` / `95%` 压缩阈值及 `240` 秒搜索超时为固定策略。设置页语言跟随 DSH。旧版 `0.4.2` 插件配置与 v3/v4 压缩检查点不再迁移，请重新配置并新建会话；当前 v5 检查点仍支持重启续聊。
 
-默认 pressure coordination：
+**预发布限制：** Windows 上 DSH `0.1.3-alpha.2` 存在启动时加载 `fs-ext` 的宿主问题。本轮 Windows 实测使用了仅在非 Windows 加载 `fs-ext` 的本地修正，保留原 Win32 会话锁；插件安装不会自动修补 DSH，不能宣称未修正的 Windows 宿主开箱即用。Alpha 网页引用仍可能偶发失效，`screenshot` 尚未验证返回可显示的图片。代理 / `NO_PROXY`、更高并发与取消交错、后台可续聊子代理尚未测全。
 
-```text
-0% ─────────────────── 90% ───── 95% ───── 100%
-       normal            Native      emergency   hard cap
-                         V2          DSH prune
-```
+普通对话、缓存、基础 PNG/TXT 附件、Native 压缩与重启续聊、压缩后模型切换、普通搜索与 Hosted 搜图展示、双会话并发、前台子代理缓存已有有界实测；这不是全平台或所有附件格式的完整兼容保证。
 
-- `90%`：优先 Native V2；
-- `95%`：允许 DSH emergency tool-result prune；
-- provider-confirmed overflow：继续交给 DSH recovery；
-- manual `/compact`：仍使用 DSH 原生 compaction transaction。
+### 1. 准备环境
 
-Native checkpoint v5 会持久化 provider-native compaction state 与必要的可移植保留历史；同 session / compatible route 可 Native replay，不兼容 route 不会错误复用 opaque state。
+- DSH **`0.1.1-rc.2`**，且 Web 界面能够正常使用。
+- Node.js **22.19.0 及以上的 22.x，或 24.0.0 及以上版本**。
+- 已在 DSH 中配置好可正常对话的 **GPT Responses 接口、模型与凭据**。
 
-### 4. Restart / Resume + GPT 热切换
+### 2. 安装插件
 
-同一个 DSH session 可以跨越：
+在运行 DSH 的环境中执行：
 
-```text
-Terra
-  → Compact
-  → Replay
-  → Restart DSH
-  → Resume same session
-  → Switch to Sol
-  → Continue
+```sh
+dsh plugin --profile web add dsh-lcx-codex
+dsh web
 ```
 
-compatible route/model 可恢复 Native opaque state；不兼容的 GPT model / route 会丢弃不安全 opaque state并重建 portable history，但仍保持 LCX Responses transport ownership。
+插件通过 npm 安装，无需克隆仓库或手动下载源码。本 README 对应 **`0.4.2`**；可在 [npm](https://www.npmjs.com/package/dsh-lcx-codex) 查看发布版本，或查看 [v0.4.2 发布说明](https://github.com/kk3ya03-star/dsh-lcx-codex/releases/tag/v0.4.2)。
 
-### 5. Hosted Search + Stateful Web Actions
+### 3. 启用并保存
 
-普通联网搜索仍使用 DSH 原生 `web_search`。LCX 可以把 SearchProvider 映射到当前 GPT Hosted Search，而不是再给模型暴露第二个普通搜索工具。
+1. 打开 DSH Web 的插件设置，展开 **Responses / Codex 能力**。
+2. 勾选 **启用 LCX（接管当前 GPT Responses 会话）**。
+3. 需要联网搜索时，再勾选 **使用 GPT Hosted Search 作为 DSH web_search 后端**。
+4. 保留默认压缩设置，点击 **保存**，使用已配置好的 GPT 模型开始对话。
 
-| 需求 | 使用入口 |
-|---|---|
-| 普通联网搜索 | DSH `web_search` |
-| Hosted Search 高级参数 | `websearch_gpt_advanced` |
-| 连续网页 / PDF 操作 | `websearch_alpha` |
+**LCX 和联网搜索默认关闭，安装后需要手动启用。** 高级搜索和 Alpha 可以在需要时再开。
 
-Alpha 支持：
+切换 Claude、Gemini、DeepSeek 等非 GPT 模型前，请先关闭 LCX 并保存。模型切换本身不需要重启 DSH。
 
-```text
-search → open → find / click → screenshot
-```
+## 长会话如何继续
 
-Alpha 默认关闭；只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署 fail-closed。
+LCX 使用上游的 **Native V2 原生压缩**处理长上下文，并将压缩结果接回 DSH 会话，供后续请求继续使用（Replay）。DSH 仍负责压缩时机、会话保存和工具执行。
 
-### 6. Pi 0.84.3 隔离升级
+默认的 Native-first 自动压缩策略为：
 
-插件独立使用 `@earendil-works/pi-ai 0.84.3`，不 override DSH host：
+| 上下文压力 | 行为 |
+| --- | --- |
+| 低于 `90%` | 正常运行，避免过早裁剪工具结果。 |
+| 达到 `90%`、低于 `95%` | 优先尝试 Native V2 压缩。 |
+| 达到 `95%` | 允许 DSH 紧急裁剪工具结果，并按现有流程处理压缩。 |
 
-```text
-DSH 0.1.1-rc.2
-└─ host Pi 0.82.1      ← 不改
+手动 `/compact` 仍通过 DSH 的压缩流程执行。首次建立压缩检查点时，符合条件的可恢复失败可以回退到 DSH 基础压缩；并非所有 Native 失败都会自动回退。
 
-dsh-lcx-codex 0.4.2
-└─ plugin Pi 0.84.3    ← 插件隔离依赖
-```
+原生压缩状态只在兼容的同一会话与接口配置中复用。切换到不兼容的 GPT 模型或通道时，LCX 会改用可迁移的会话历史继续请求。
 
-Pi 负责 canonical Responses message/tool serialization、reasoning、IDs、strict/grammar/custom tools、`additional_tools`、`tool_search`、namespace 和 stream semantics；LCX 不维护第二套通用 provider framework。
+## 搜索怎么选
 
-## 30 秒配置
+日常查询从 `web_search` 开始即可。三种搜索工具的用途和启用条件如下：
 
-### 前提条件
+| 工具 | 用途 | 启用条件 |
+| --- | --- | --- |
+| `web_search` | 日常联网查询，使用 DSH 原有搜索入口。 | 开启 LCX 和 GPT Hosted Search。 |
+| `websearch_gpt_advanced` | 域名过滤、位置、搜索上下文大小、图片搜索等额外参数。 | 在上述基础上开启高级 Hosted 工具。 |
+| `websearch_alpha` | 连续执行 `search / open / find / click / screenshot` 等操作。 | 开启 Alpha，且当前接口通过能力探测。 |
 
-- Node.js `^22.19.0 || >=24.0.0`
-- DSH `0.1.1-rc.2`
-- DSH 中已有可工作的 GPT Responses route
-- 上游 endpoint 实际支持准备启用的 Hosted Search / Native V2 / Alpha 能力
+Alpha 默认关闭。即使打开开关，也只有当前接口通过能力探测后才会注册工具。
 
-### 推荐初始设置
+### 可以直接让 DSH 搜图吗？
 
-| 设置 | 推荐值 | 说明 |
-|---|---:|---|
-| Enable LCX | **On** | 接管当前 GPT Responses 会话 |
-| Use GPT Hosted Search | 按需 | 让 DSH `web_search` 使用 GPT Hosted Search |
-| Advanced Hosted Search | Off | 需要高级 Hosted 参数时再开 |
-| Alpha Search | Off | capability probe 通过后再开 |
-| Native-first auto compaction | On | 使用 Native-first pressure coordination |
-| Native threshold | `90%` | 主动 Native V2 阈值 |
-| Emergency DSH prune | `95%` | 紧急 prune 阈值 |
-| Fallback to Basic Compaction | On | Native 首次失败时允许受控回退 |
-| `web_search` timeout | `240s` | 避免较慢 Hosted Search 被过早中断 |
+可以。开启 LCX、GPT Hosted Search 和高级 Hosted 工具后，直接说：
 
-### 如何确认生效
+> 搜索金门大桥的照片，选一张直接显示在回复里，并附上图片来源网页。
 
-| 能力 | 预期行为 |
-|---|---|
-| LCX ownership | LCX ON 后第一轮 GPT ordinary request 就进入 LCX Responses path |
-| Prompt Cache | 稳定 warm turn 可出现 provider `cached_tokens` |
-| Hosted Search | 普通入口仍是 DSH `web_search` |
-| Advanced Hosted | 开启后出现 `websearch_gpt_advanced` |
-| Alpha | capability probe 通过后才出现 `websearch_alpha` |
-| Native V2 | Compact 产生 provider-native checkpoint，而不是把 Basic Compaction 伪装成 Native |
-| Replay | Compact 后继续同一 DSH session；restart/resume 仍可续接 |
+通常不需要自己填写 JSON，模型负责选择 `websearch_gpt_advanced` 的图片搜索参数；若只返回文字，可以补充“请使用高级 Hosted 的图片搜索”。是否选择正确参数仍取决于模型，接口也必须支持图片搜索。
 
-## DSH 与 LCX 的责任边界
+工具返回的是现有网页图片的 URL、来源等信息，模型可用 Markdown 将图片显示在 DSH 中。`0.4.3-pre.2` 已实测图片结果解析及界面展示；这是**搜索已有图片，不是生成图片，也不等于模型已经看到了图片像素**。图片链接可能受原站权限或防盗链影响。Alpha 不必开启；Alpha 的网页操作发生在上游搜索服务，不会点击你的本机浏览器或 DSH 界面，其 `screenshot` 也不保证返回照片。
 
-| 组件 | 负责什么 |
-|---|---|
-| **DSH** | Agent loop、Session/history、GenerateOptions、模型/credential、工具执行、AttachmentStore、pressure policy、compaction transaction |
-| **DSH compatibility seam** | 把 DSH message / GenerateOptions 投影到 Pi Context，并把结果桥接回 DSH |
-| **Plugin Pi 0.84.3** | canonical Responses serialization / parser semantics |
-| **LCX** | ON/OFF ownership、最终 Responses body + HTTP/SSE wire、ordinary/compact/replay orchestration、Native opaque state、Search capabilities |
+## 缓存的使用预期
 
-更多 checkpoint、portable replay、cache identity、RefStore、pressure coordination 与 protocol 细节见 [ARCHITECTURE.md](ARCHITECTURE.md)。
+在支持的 GPT-5.6 接口上，LCX 使用 `prompt_cache_options` 并保持稳定的缓存标识。连续对话和工具任务的请求前缀保持一致时，可以复用提示词缓存；实际命中情况由上游决定。
 
-## 兼容性
+原生压缩会改变历史内容。运行中加载 skill、plugin，或切换会改变工具列表的功能，也可能使缓存需要重新建立。新请求前缀稳定后可以再次复用缓存。
 
-| Plugin | DSH | DSH host Pi | Plugin Pi | 状态 |
-|---|---|---|---|---|
-| `0.4.2` | `0.1.1-rc.2` | `0.82.1` | `0.84.3` | **VERIFIED STABLE** |
-| `0.4.1` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | historical stable |
+## 设置参考
 
-DSH `0.1.2-alpha.1` 和更新的 Pi 版本目前不属于 `0.4.2` 的正式兼容性声明；后续会按受影响 seam 单独验证，而不是自动视为兼容。
+下表为稳定版 `0.4.2`。`0.4.3-pre.2` 只提供前四项开关，其余为固定内部策略。
 
-## 当前边界
-
-- 当前支持 route 使用 implicit Prompt Cache；content-level explicit breakpoint 在该 route 上会被拒绝，因此没有作为产品设置开放。
-- dynamic skill / plugin 若改变 top-level tool schema，可能触发一次 prompt-cache reset；功能不受影响，新 topology 会重新 warm。
-- `reasoning.context` / `reasoning.mode` 仍取决于 host/Pi 暴露能力，LCX 不额外造第二套控制面。
-- normal operational context 仍使用约 `262K` 级别配置；1.05M long context 不是默认开启项。
-- credentialed `ALPHA-004` runtime 仍为 `NOT_COVERED`，fail-closed 行为已有测试覆盖。
-- Programmatic Tool Calling 当前不作为已支持能力宣传。
+| 设置 | 默认值 | 建议 |
+| --- | --- | --- |
+| 启用 LCX | 关闭 | 使用 GPT Responses 时开启。 |
+| GPT Hosted Search | 关闭 | 需要联网查询时开启。 |
+| 高级 Hosted 工具 | 关闭 | 需要额外搜索参数时开启。 |
+| Alpha command | 关闭 | 在支持的接口上按需开启。 |
+| Native-first 自动压缩 | 开启 | 保持默认，需先启用 LCX。 |
+| Native 自动压缩阈值 | `90%` | 保持默认。 |
+| DSH 紧急裁剪阈值 | `95%` | 必须高于 Native 阈值。 |
+| Native 失败后回退 DSH basic compaction | 开启 | 保留符合回退条件时的基础压缩能力。 |
+| `web_search` 超时 | `240` 秒 | 搜索较慢时再调整。 |
 
 ## 常见问题
 
-<details>
-<summary><strong>为什么切非 GPT 前要关闭 LCX？</strong></summary>
-
-LCX ON 是 GPT Responses lifecycle ownership switch，不是通用多模型代理层。非 GPT 模型继续走 DSH 原生 adapter。
+**安装后没有变化？**
 
-</details>
+确认插件安装到了启动 Web 使用的 `web` 配置中，再检查 LCX 是否已经勾选并保存。联网搜索有单独的开关。
 
-<details>
-<summary><strong>为什么 web_search 还是同一个工具？</strong></summary>
+**能对话，但搜索或压缩报错？**
 
-这是刻意设计。LCX 改的是 DSH `web_search` 后面的 SearchProvider，不给模型重复暴露两个普通搜索工具。
+检查当前通道是否支持对应能力，以及模型与凭据是否可用。Sub2API、NewAPI 的名称本身不代表其所有通道都支持相同功能。
 
-</details>
+**需要手动下载安装包吗？**
 
-<details>
-<summary><strong>为什么 Alpha 有时不出现？</strong></summary>
+常规安装使用上面的 DSH 命令即可。需要留存发布包时，可下载 [v0.4.2 npm 包（.tgz）](https://registry.npmjs.org/dsh-lcx-codex/-/dsh-lcx-codex-0.4.2.tgz)。GitHub 的 **Code → Download ZIP** 提供源码，不能代替插件安装步骤。
 
-这是 fail-closed 行为。当前 route/schema 没通过 capability probe 时，`websearch_alpha` 不注册。
+## 兼容性与限制
 
-</details>
+| 组件 | `0.4.2` 对应版本 |
+| --- | --- |
+| DSH | `0.1.1-rc.2` |
+| DSH host Pi | `0.82.1` |
+| 插件 Pi | `0.84.3` |
+| Node.js | `^22.19.0 \|\| >=24.0.0` |
 
-<details>
-<summary><strong>为什么加载 skill 后有时缓存会重新 warm？</strong></summary>
+插件单独使用 `@earendil-works/pi-ai@0.84.3`，不覆盖 DSH host 的 Pi 依赖。
 
-某些 skill 会动态注册新的顶层工具。工具 schema 属于可缓存 prompt prefix 的一部分，topology 改变时 provider 可能建立新的 cache epoch。`0.4.2` 优先保证工具定义正确，不通过猜测 provenance 来强行维持旧 cache。
+- DSH `0.1.2-alpha.1` 尚未列入此版本的正式兼容范围。
+- 1.05M 长上下文和 Programmatic Tool Calling 暂不作为正式支持项。
+- 显式 `prompt_cache_breakpoint` 设置未开放。
+- `reasoning.context` 和 `reasoning.mode` 是否可用，取决于 DSH / Pi 是否暴露相应字段。
 
-</details>
+## 开发与反馈
 
-## 开发与验证
+在仓库中安装依赖并运行检查：
 
-```bash
+```sh
+npm ci --ignore-scripts
+npm ci --prefix scripts/runtime-alpha2 --ignore-scripts
+node scripts/link-dsh-runtime.mjs scripts/runtime-alpha2
+node scripts/check-generated.mjs
 npm run typecheck
 npm test
 npm run test:schema
 npm pack --ignore-scripts
 ```
 
-- 架构：[ARCHITECTURE.md](ARCHITECTURE.md)
-- 版本记录：[CHANGELOG.md](CHANGELOG.md)
-- GitHub Releases：[Releases](https://github.com/kk3ya03-star/dsh-lcx-codex/releases)
-- npm：[`dsh-lcx-codex`](https://www.npmjs.com/package/dsh-lcx-codex)
+[架构说明](ARCHITECTURE.md)介绍请求生命周期、压缩检查点和 Replay 实现；[更新日志](CHANGELOG.md)记录版本变化。
 
-## License
+遇到问题可提交 [Issue](https://github.com/kk3ya03-star/dsh-lcx-codex/issues)，附上插件、DSH、Node.js 版本、接口类型、复现步骤和已脱敏的报错信息。
 
-MIT
+## 许可证
 
-> `LCX` 只是项目名称。本项目是社区项目，不隶属于 OpenAI、DeepSeek、Sub2API 或 NewAPI。
+[MIT](LICENSE)。本项目是独立社区插件，与 OpenAI、DeepSeek、Sub2API、NewAPI 无隶属或官方背书关系。DeepSeek 名称及鲸鱼标识归其权利人所有。

package/cordis.patch.yml

@@ -1,25 +1,8 @@
-# Optional Responses/Codex capabilities for GPT routes already configured in llm-pi-ai.
-# This does not replace DSH's compaction service. Native V2 is installed as the
-# documented purpose=compaction llm/stream override, leaving compaction policy,
-# range selection, pruning, transactions and /compact owned by DSH.
+# GPT Responses lifecycle plugin. Runtime defaults live in the plugin Config;
+# the bundle declares only route capabilities that differ from conservative defaults.
 - insert:
     - id: lcx-codex
       name: dsh-lcx-codex
       config:
-        provider: lcx
-        baseURL: https://api.lcxbot.com/v1
-        apiKeyEnv: LCX_API_KEY
-        model: gpt-5.6-sol
+        supportsLongCacheRetention: true
         supportsExplicitPromptCacheMode: true
-        legacyCheckpointPath: !!js dshHomePath('storages/lcx-codex/checkpoints-v3.json')
-        alphaCapabilityPath: !!js dshHomePath('storages/lcx-codex/web-alpha-capabilities.json')
-        alphaRefPath: !!js dshHomePath('storages/lcx-codex/web-alpha-refs.json')
-        webSearchProvider: lcx-responses
-        webMaxResults: 8
-        timeoutMs: 300000
-        maxAttempts: 3
-        requestImagePixelBudget: 4194304
-        requestImageMaxBytes: 1048576
-        webSearchTimeoutMs: 240000
-        autoCompactionThresholdPercent: 90
-        emergencyPruneThresholdPercent: 95