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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +116 -150
  2. package/cordis.patch.yml +3 -20
  3. package/lib/client.js +273 -146
  4. package/lib/compact-v2.js +218 -199
  5. package/lib/dsh-compat.js +227 -100
  6. package/lib/dsh-responses.js +445 -277
  7. package/lib/index.js +851 -757
  8. package/lib/json-store.js +50 -31
  9. package/lib/native-checkpoint.js +520 -194
  10. package/lib/responses-request.js +106 -121
  11. package/lib/responses-stream.js +972 -443
  12. package/lib/route.js +229 -355
  13. package/lib/service-mutex.js +73 -64
  14. package/lib/token-budget.js +176 -108
  15. package/lib/transport.js +277 -67
  16. package/lib/types/client/index.d.ts +6 -0
  17. package/lib/types/compact-v2.d.ts +104 -0
  18. package/lib/types/dsh-compat.d.ts +78 -0
  19. package/lib/types/dsh-responses.d.ts +82 -0
  20. package/lib/types/index.d.ts +83 -0
  21. package/lib/types/json-store.d.ts +10 -0
  22. package/lib/types/native-checkpoint.d.ts +213 -0
  23. package/lib/types/responses-request.d.ts +58 -0
  24. package/lib/types/responses-stream.d.ts +51 -0
  25. package/lib/types/route.d.ts +132 -0
  26. package/lib/types/service-mutex.d.ts +14 -0
  27. package/lib/types/token-budget.d.ts +50 -0
  28. package/lib/types/transport.d.ts +20 -0
  29. package/lib/types/web-run-output.d.ts +29 -0
  30. package/lib/types/web-search-alpha.d.ts +286 -0
  31. package/lib/types/web-search-capability.d.ts +26 -0
  32. package/lib/types/web-search-hosted.d.ts +246 -0
  33. package/lib/types/web-search-ref-store.d.ts +22 -0
  34. package/lib/web-run-output.js +167 -18
  35. package/lib/web-search-alpha.js +865 -163
  36. package/lib/web-search-capability.js +55 -65
  37. package/lib/web-search-hosted.js +210 -32
  38. package/lib/web-search-ref-store.js +63 -59
  39. package/package.json +79 -27
  40. package/ARCHITECTURE.md +0 -117
  41. package/CHANGELOG.md +0 -224
  42. package/README_EN.md +0 -213
  43. package/assets/dsh-lcx-codex-banner.jpg +0 -0
  44. package/lib/legacy-v3.js +0 -20
  45. package/lib/responses-replay.js +0 -68
  46. package/scripts/probe-alpha.mjs +0 -43
  47. package/scripts/validate-dsh-schema.mjs +0 -31
package/README.md CHANGED
@@ -1,225 +1,191 @@
1
1
  <div align="center">
2
2
 
3
- <img src="assets/dsh-lcx-codex-banner.png" alt="dsh-lcx-codex — 为 DSH 增加 GPT Hosted Search、Codex 风格网页操作与 Native V2 Compaction" width="100%" />
3
+ <img src="https://raw.githubusercontent.com/kk3ya03-star/dsh-lcx-codex/main/assets/dsh-lcx-codex-banner.svg" alt="LCX Codex" width="100%" />
4
4
 
5
- [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm%20latest)](https://www.npmjs.com/package/dsh-lcx-codex)
6
- [![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)
7
- ![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-4ea8ff)
8
- ![Node](https://img.shields.io/badge/Node-%3E%3D20-2f855a)
9
- ![License](https://img.shields.io/badge/license-MIT-6b7280)
5
+ # LCX Codex
10
6
 
11
- **简体中文** · [English](README_EN.md) · [Architecture](ARCHITECTURE.md) · [Changelog](CHANGELOG.md)
7
+ **让 DeepSeek Harness 中的 GPT 会话支持原生压缩、联网搜索与连续网页操作。**
12
8
 
13
- </div>
14
-
15
- > **DSH 仍然是 host。LCX 只补齐 GPT Responses 路径缺失的原生能力,不修改 DSH 核心,也不替换 Agent / Session / Web / Compaction。**
16
-
17
- ## 当前稳定版
9
+ [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?label=npm)](https://www.npmjs.com/package/dsh-lcx-codex)
10
+ [![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-16803c)](#兼容性与限制)
11
+ [![License](https://img.shields.io/badge/license-MIT-555)](LICENSE)
18
12
 
19
- `0.4.1` 是当前稳定版,也是此前完成完整 Installed Candidate / Cross-feature QA 的 `0.4.1-pre.1` 的 **zero-functional-change stable promotion**。
13
+ **简体中文** · [English](README_EN.md) · [版本发布](https://github.com/kk3ya03-star/dsh-lcx-codex/releases) · [问题反馈](https://github.com/kk3ya03-star/dsh-lcx-codex/issues)
20
14
 
21
- ```powershell
22
- dsh plugin --profile web add dsh-lcx-codex
23
- dsh web
24
- ```
15
+ </div>
25
16
 
26
- npm `latest` 指向 `0.4.1`。历史 `prelatest=0.4.1-pre.1` 与稳定版使用相同的已验收 runtime 基线;新用户直接使用 `latest` 即可。
17
+ LCX Codex(`dsh-lcx-codex`)是 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)(DSH)的社区插件,为已配置好的 **GPT / OpenAI Responses 接口**扩展长会话和搜索能力,适用于兼容的 Sub2API、NewAPI 等通道。
27
18
 
28
- ## 它解决什么
19
+ 你仍然在 DSH 中选择模型、管理会话和使用工具。开启 LCX 后,从普通对话到工具调用、上下文压缩和压缩后的续聊,都使用同一条 Responses 请求路径。
29
20
 
30
- 如果你的 DSH 已经有一个可工作的 GPT `openai-responses` route,`dsh-lcx-codex` 会在保持 DSH 原有入口和生命周期的前提下补齐 Responses 能力。
21
+ ## 它能做什么
31
22
 
32
- | 场景 | DSH 原有入口 | LCX 增强后 |
33
- |---|---|---|
34
- | 普通联网搜索 | DSH `web_search` | **仍然使用同一个 `web_search`**,由 LCX SearchProvider 映射到当前 GPT Hosted Search |
35
- | Hosted Search 高级参数 | 普通搜索入口保持简洁 | 按需增加 `websearch_gpt_advanced`,提供域名过滤、近似位置、search context、图片搜索等 |
36
- | 连续网页 / PDF 浏览 | DSH 继续拥有 Web 生命周期 | 按需增加 Codex / Alpha Web Actions:`search → open → find/click → screenshot` |
37
- | 长会话压缩 | DSH 继续负责 pressure、事务与 recovery | 在现有 compaction seam 上优先请求 Responses Native V2 checkpoint |
23
+ | 你需要 | LCX 提供 |
24
+ | --- | --- |
25
+ | **长对话继续进行** | 接近上下文上限时优先使用 Native V2 原生压缩,支持压缩后续聊和重启恢复。 |
26
+ | **在对话中查询网页** | 通过 DSH 原有的 `web_search` 使用 GPT Hosted Search,普通搜索跟随当前 Agent 的 GPT 模型。 |
27
+ | **更细的搜索控制** | 按需启用域名过滤、位置、搜索上下文大小、图片搜索等 Hosted Search 参数。 |
28
+ | **连续查阅网页** | 在支持的接口上使用 Alpha 工具,连续执行搜索、打开、查找、点击等操作。 |
29
+ | **复用提示词缓存** | 在支持的 GPT-5.6 接口上保持稳定的缓存标识,让相同的请求前缀可以被重复利用。 |
38
30
 
39
- **目标不是再造一套 Agent,而是让 DSH GPT route 用上它本来就应该拥有的原生能力。**
31
+ > LCX 面向 GPT / OpenAI Responses。各项扩展能力取决于上游接口支持;能正常对话,不代表该通道同时支持原生压缩、Hosted Search 或 Alpha 网页操作。
40
32
 
41
- ## 三大能力
33
+ ## 快速开始
42
34
 
43
- ### 1. GPT Hosted Search:普通搜索不换入口
35
+ ### DSH 0.1.3 用户:0.4.3-pre.2 预发布
44
36
 
45
- 启用后,模型看到的普通搜索工具依然是 DSH 原生 `web_search`。LCX 替换的是 SearchProvider 路径,而不是再注册一个重复的普通搜索工具。
37
+ `0.4.3-pre.2` 面向 **DSH `0.1.3-alpha.2` / host 与插件 Pi `0.85.1`**,安装时明确选择预发布:
46
38
 
47
- 需要更细控制时,再单独启用 `websearch_gpt_advanced`。
39
+ ```sh
40
+ dsh plugin --profile web add dsh-lcx-codex@0.4.3-pre.2
41
+ dsh web
42
+ ```
48
43
 
49
- ### 2. Codex 风格 Web Actions
44
+ 也可使用 `dsh-lcx-codex@prelatest` 跟随预发布通道。稳定通道 `latest` 仍为 `0.4.2`,对应下面的旧版安装说明,不要混用 DSH 版本。
50
45
 
51
- `websearch_alpha` 面向连续浏览和结构化 Web action:
46
+ 新版只保留 LCX、Hosted Search、高级 Hosted、Alpha 四个开关;`90%` / `95%` 压缩阈值及 `240` 秒搜索超时为固定策略。设置页语言跟随 DSH。旧版 `0.4.2` 插件配置与 v3/v4 压缩检查点不再迁移,请重新配置并新建会话;当前 v5 检查点仍支持重启续聊。
52
47
 
53
- ```text
54
- search → open → find / click → screenshot
55
- ```
48
+ **预发布限制:** Windows 上 DSH `0.1.3-alpha.2` 存在启动时加载 `fs-ext` 的宿主问题。本轮 Windows 实测使用了仅在非 Windows 加载 `fs-ext` 的本地修正,保留原 Win32 会话锁;插件安装不会自动修补 DSH,不能宣称未修正的 Windows 宿主开箱即用。Alpha 网页引用仍可能偶发失效,`screenshot` 尚未验证返回可显示的图片。代理 / `NO_PROXY`、更高并发与取消交错、后台可续聊子代理尚未测全。
56
49
 
57
- 它默认关闭,并且只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署采用 **fail-closed**,不会被误报成“支持 Alpha”。
50
+ 普通对话、缓存、基础 PNG/TXT 附件、Native 压缩与重启续聊、压缩后模型切换、普通搜索与 Hosted 搜图展示、双会话并发、前台子代理缓存已有有界实测;这不是全平台或所有附件格式的完整兼容保证。
58
51
 
59
- `0.4.1` 已包含此前 prerelease 验收通过的 URL/stateful continuation 和 capability fail-closed 修复。
52
+ ### 1. 准备环境
60
53
 
61
- ### 3. Native V2 Compaction
54
+ - DSH **`0.1.1-rc.2`**,且 Web 界面能够正常使用。
55
+ - Node.js **22.19.0 及以上的 22.x,或 24.0.0 及以上版本**。
56
+ - 已在 DSH 中配置好可正常对话的 **GPT Responses 接口、模型与凭据**。
62
57
 
63
- LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactable range、`/compact`、durable session transaction、tool-result pruning 与 overflow recovery;LCX 只在已有 compaction LLM seam 上请求 Responses Native V2。
58
+ ### 2. 安装插件
64
59
 
65
- 默认自动策略:
60
+ 在运行 DSH 的环境中执行:
66
61
 
67
- ```text
68
- 0% ─────────────────── 90% ───── 95% ───── 100%
69
- normal Native emergency hard cap
70
- V2 DSH prune
62
+ ```sh
63
+ dsh plugin --profile web add dsh-lcx-codex
64
+ dsh web
71
65
  ```
72
66
 
73
- - **90%**:优先尝试 Native V2
74
- - **95%**:才允许 emergency DSH prune。
75
- - provider-confirmed context overflow:继续使用 DSH 原有恢复逻辑。
76
- - 手动 `/compact`:继续使用 DSH 原生会话事务。
67
+ 插件通过 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)
77
68
 
78
- 同一 source session 可以继续复用自己的 Native checkpoint;fork 或模型/route migration 不会跨 session 发送 parent opaque state,而是走 portable migration;重启后从 DSH session log 恢复。
69
+ ### 3. 启用并保存
79
70
 
80
- ## 0.4.1 相比 0.4.0
71
+ 1. 打开 DSH Web 的插件设置,展开 **Responses / Codex 能力**。
72
+ 2. 勾选 **启用 LCX(接管当前 GPT Responses 会话)**。
73
+ 3. 需要联网搜索时,再勾选 **使用 GPT Hosted Search 作为 DSH web_search 后端**。
74
+ 4. 保留默认压缩设置,点击 **保存**,使用已配置好的 GPT 模型开始对话。
81
75
 
82
- `0.4.1` 将此前 `0.4.1-pre.1` 的已验收改动正式提升到 stable:
76
+ **LCX 和联网搜索默认关闭,安装后需要手动启用。** 高级搜索和 Alpha 可以在需要时再开。
83
77
 
84
- - Alpha URL/stateful continuation capability fail-closed 修复;
85
- - DSH compatibility seam 收敛;
86
- - route / Native V2 / checkpoint typed protocol core;
87
- - Native retention 与 portable migration 的统一保守 token budgeting;
88
- - 正式安装态 settings namespace / configuration card lifecycle 修复;
89
- - Installed Candidate + Cross-feature QA。
78
+ 切换 Claude、Gemini、DeepSeek 等非 GPT 模型前,请先关闭 LCX 并保存。模型切换本身不需要重启 DSH。
90
79
 
91
- stable promotion 不引入新的 runtime 行为。
80
+ ## 长会话如何继续
92
81
 
93
- ## 30 秒开始使用
82
+ LCX 使用上游的 **Native V2 原生压缩**处理长上下文,并将压缩结果接回 DSH 会话,供后续请求继续使用(Replay)。DSH 仍负责压缩时机、会话保存和工具执行。
94
83
 
95
- ### 1. 安装
84
+ 默认的 Native-first 自动压缩策略为:
96
85
 
97
- ```powershell
98
- dsh plugin --profile web add dsh-lcx-codex
99
- dsh web
100
- ```
86
+ | 上下文压力 | 行为 |
87
+ | --- | --- |
88
+ | 低于 `90%` | 正常运行,避免过早裁剪工具结果。 |
89
+ | 达到 `90%`、低于 `95%` | 优先尝试 Native V2 压缩。 |
90
+ | 达到 `95%` | 允许 DSH 紧急裁剪工具结果,并按现有流程处理压缩。 |
101
91
 
102
- 需要固定版本时:
92
+ 手动 `/compact` 仍通过 DSH 的压缩流程执行。首次建立压缩检查点时,符合条件的可恢复失败可以回退到 DSH 基础压缩;并非所有 Native 失败都会自动回退。
103
93
 
104
- ```powershell
105
- dsh plugin --profile web add dsh-lcx-codex@0.4.1
106
- ```
107
-
108
- 升级时请使用 DSH 官方 plugin remove/add 路径;不要为了“清理”删除用户 session 或 `$DSH_HOME/storages/lcx-codex/`。
94
+ 原生压缩状态只在兼容的同一会话与接口配置中复用。切换到不兼容的 GPT 模型或通道时,LCX 会改用可迁移的会话历史继续请求。
109
95
 
110
- ### 2. 在 DSH Settings 启用
96
+ ## 搜索怎么选
111
97
 
112
- 第一次使用建议从最小配置开始:
98
+ 日常查询从 `web_search` 开始即可。三种搜索工具的用途和启用条件如下:
113
99
 
114
- | 设置 | 建议 |
115
- |---|---:|
116
- | Enable plugin | **On** |
117
- | Use GPT Hosted Search | 需要 GPT Hosted Search 时 **On** |
118
- | Advanced Hosted Search | **Off**,需要高级参数再开 |
119
- | Alpha Search | **Off**,确认当前 route 支持后再开 |
120
- | Native V2 remote compaction | 上游实际支持 Native V2 时 **On** |
121
- | Native-first auto compaction | 使用 Native V2 时 **On** |
100
+ | 工具 | 用途 | 启用条件 |
101
+ | --- | --- | --- |
102
+ | `web_search` | 日常联网查询,使用 DSH 原有搜索入口。 | 开启 LCX 和 GPT Hosted Search。 |
103
+ | `websearch_gpt_advanced` | 域名过滤、位置、搜索上下文大小、图片搜索等额外参数。 | 在上述基础上开启高级 Hosted 工具。 |
104
+ | `websearch_alpha` | 连续执行 `search / open / find / click / screenshot` 等操作。 | 开启 Alpha,且当前接口通过能力探测。 |
122
105
 
123
- **前提条件**
106
+ Alpha 默认关闭。即使打开开关,也只有当前接口通过能力探测后才会注册工具。
124
107
 
125
- - Node.js `>=20`
126
- - DSH 中已有可工作的 GPT `openai-responses` route
127
- - 上游 endpoint 实际支持你准备启用的 Hosted Search / Native V2 / Alpha 能力
108
+ ### 可以直接让 DSH 搜图吗?
128
109
 
129
- ### 3. 确认它真的生效
110
+ 可以。开启 LCX、GPT Hosted Search 和高级 Hosted 工具后,直接说:
130
111
 
131
- | 能力 | 应看到什么 |
132
- |---|---|
133
- | GPT Hosted Search | 普通工具入口仍是 DSH `web_search`,实际请求走当前 GPT Responses route |
134
- | Advanced Hosted | 启用后出现 `websearch_gpt_advanced` |
135
- | Alpha Web Actions | 只有 capability probe 通过时才出现 `websearch_alpha` |
136
- | Native V2 | compact 时出现 provider-native checkpoint 路径;普通 Basic Compaction 不会被伪装成 Native V2 成功 |
112
+ > 搜索金门大桥的照片,选一张直接显示在回复里,并附上图片来源网页。
137
113
 
138
- ## 搜索工具怎么选
114
+ 通常不需要自己填写 JSON,模型负责选择 `websearch_gpt_advanced` 的图片搜索参数;若只返回文字,可以补充“请使用高级 Hosted 的图片搜索”。是否选择正确参数仍取决于模型,接口也必须支持图片搜索。
139
115
 
140
- | 你要做什么 | 使用入口 | 适合场景 |
141
- |---|---|---|
142
- | 普通联网搜索 | DSH `web_search` | 找资料、查网页、一般检索 |
143
- | 控制 Hosted Search 参数 | `websearch_gpt_advanced` | 域名 allow/block、近似位置、search context、图片搜索等 |
144
- | 连续浏览网页或 PDF | `websearch_alpha` | `search/open/find/click/screenshot` 与结构化 Web actions |
116
+ 工具返回的是现有网页图片的 URL、来源等信息,模型可用 Markdown 将图片显示在 DSH 中。`0.4.3-pre.2` 已实测图片结果解析及界面展示;这是**搜索已有图片,不是生成图片,也不等于模型已经看到了图片像素**。图片链接可能受原站权限或防盗链影响。Alpha 不必开启;Alpha 的网页操作发生在上游搜索服务,不会点击你的本机浏览器或 DSH 界面,其 `screenshot` 也不保证返回照片。
145
117
 
146
- ## 它如何接入 DSH
118
+ ## 缓存的使用预期
147
119
 
148
- ```text
149
- DSH Agent / Session / Web
150
- ├─ web_search ──────────> LCX SearchProvider ──> GPT Hosted Search
151
- ├─ Advanced / Alpha ────> LCX Web tools ───────> GPT Web actions
152
- └─ compact / replay ────> LCX Native bridge ───> Responses Native V2
153
- ```
120
+ 在支持的 GPT-5.6 接口上,LCX 使用 `prompt_cache_options` 并保持稳定的缓存标识。连续对话和工具任务的请求前缀保持一致时,可以复用提示词缓存;实际命中情况由上游决定。
154
121
 
155
- **DSH 是 host,LCX 是兼容扩展层。** 插件优先复用当前 DSH route 的 `baseURL`、credential referenceheaders、模型与 retry policy,而不是维护第二套账号配置。
122
+ 原生压缩会改变历史内容。运行中加载 skillplugin,或切换会改变工具列表的功能,也可能使缓存需要重新建立。新请求前缀稳定后可以再次复用缓存。
156
123
 
157
- checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与 pressure coordination 等实现细节见 [ARCHITECTURE.md](ARCHITECTURE.md)。
124
+ ## 设置参考
158
125
 
159
- ## 兼容性
126
+ 下表为稳定版 `0.4.2`。`0.4.3-pre.2` 只提供前四项开关,其余为固定内部策略。
160
127
 
161
- 当前正式稳定组合:
128
+ | 设置 | 默认值 | 建议 |
129
+ | --- | --- | --- |
130
+ | 启用 LCX | 关闭 | 使用 GPT Responses 时开启。 |
131
+ | GPT Hosted Search | 关闭 | 需要联网查询时开启。 |
132
+ | 高级 Hosted 工具 | 关闭 | 需要额外搜索参数时开启。 |
133
+ | Alpha command | 关闭 | 在支持的接口上按需开启。 |
134
+ | Native-first 自动压缩 | 开启 | 保持默认,需先启用 LCX。 |
135
+ | Native 自动压缩阈值 | `90%` | 保持默认。 |
136
+ | DSH 紧急裁剪阈值 | `95%` | 必须高于 Native 阈值。 |
137
+ | Native 失败后回退 DSH basic compaction | 开启 | 保留符合回退条件时的基础压缩能力。 |
138
+ | `web_search` 超时 | `240` 秒 | 搜索较慢时再调整。 |
162
139
 
163
- | Plugin | DSH | DSH host Pi | Plugin Pi | 状态 |
164
- |---|---|---|---|---|
165
- | `0.4.1` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED STABLE** |
140
+ ## 常见问题
166
141
 
167
- `0.4.1` 的 runtime 来自完整 QA 通过的 `0.4.1-pre.1`,stable promotion 本身保持 zero-functional-change。新的 DSH 版本**不会自动视为兼容**;项目会先检查受影响 seam,再按风险运行对应测试。
142
+ **安装后没有变化?**
168
143
 
169
- <details>
170
- <summary><strong>完整推荐设置</strong></summary>
144
+ 确认插件安装到了启动 Web 使用的 `web` 配置中,再检查 LCX 是否已经勾选并保存。联网搜索有单独的开关。
171
145
 
172
- | 设置 | 推荐值 | 说明 |
173
- |---|---:|---|
174
- | Enable plugin | On | 启用插件 |
175
- | Use GPT Hosted Search | 按需 | 让 DSH `web_search` 走 GPT Hosted Search |
176
- | Advanced Hosted Search | Off | 需要高级 Hosted 参数时再开 |
177
- | Alpha Search | Off | capability 验证后再开 |
178
- | Native V2 remote compaction | On* | *上游 route 实际支持 Native V2 时 |
179
- | Native-first auto compaction | On | 启用自动 pressure 策略 |
180
- | Native threshold | 90% | 90% 开始优先 Native V2 |
181
- | Emergency DSH prune | 95% | 95% 才允许 emergency prune |
182
- | `web_search` timeout | 240 s | 避免长搜索被过早终止 |
146
+ **能对话,但搜索或压缩报错?**
183
147
 
184
- 主要配置字段:`remoteCompaction`、`autoCompaction`、`fallbackToBasicCompaction`、`autoCompactionThresholdPercent`、`emergencyPruneThresholdPercent`、`webSearchTimeoutSeconds`、`advancedHostedSearch`、`alphaSearch`。
148
+ 检查当前通道是否支持对应能力,以及模型与凭据是否可用。Sub2API、NewAPI 的名称本身不代表其所有通道都支持相同功能。
185
149
 
186
- </details>
150
+ **需要手动下载安装包吗?**
187
151
 
188
- <details>
189
- <summary><strong>常见情况</strong></summary>
152
+ 常规安装使用上面的 DSH 命令即可。需要留存发布包时,可下载 [v0.4.2 npm 包(.tgz)](https://registry.npmjs.org/dsh-lcx-codex/-/dsh-lcx-codex-0.4.2.tgz)。GitHub 的 **Code → Download ZIP** 提供源码,不能代替插件安装步骤。
190
153
 
191
- **`web_search` 没走 GPT Hosted Search**
192
- 确认插件和 Hosted Search 已启用,并且当前 Agent 能解析到兼容的 GPT `openai-responses` route。
154
+ ## 兼容性与限制
193
155
 
194
- **`websearch_alpha` 没出现**
195
- 这是预期的 fail-closed 行为。Alpha 必须对当前 route/schema 完成可信 capability probe 后才注册。
156
+ | 组件 | `0.4.2` 对应版本 |
157
+ | --- | --- |
158
+ | DSH | `0.1.1-rc.2` |
159
+ | DSH host Pi | `0.82.1` |
160
+ | 插件 Pi | `0.84.3` |
161
+ | Node.js | `^22.19.0 \|\| >=24.0.0` |
196
162
 
197
- **Native V2 没有生效**
198
- 确认当前 GPT Responses endpoint 实际支持 `remote_compaction_v2`。插件不会把普通 Basic Compaction 假装成 Native V2 成功。
163
+ 插件单独使用 `@earendil-works/pi-ai@0.84.3`,不覆盖 DSH host 的 Pi 依赖。
199
164
 
200
- **安装成功但配置卡不可见**
201
- 确认安装的是 `0.4.1` 或更高版本,并重启/刷新 DSH Web;`0.4.1` 已包含正式安装态 settings lifecycle 修复。
165
+ - DSH `0.1.2-alpha.1` 尚未列入此版本的正式兼容范围。
166
+ - 1.05M 长上下文和 Programmatic Tool Calling 暂不作为正式支持项。
167
+ - 显式 `prompt_cache_breakpoint` 设置未开放。
168
+ - `reasoning.context` 和 `reasoning.mode` 是否可用,取决于 DSH / Pi 是否暴露相应字段。
202
169
 
203
- </details>
170
+ ## 开发与反馈
204
171
 
205
- <details>
206
- <summary><strong>开发</strong></summary>
172
+ 在仓库中安装依赖并运行检查:
207
173
 
208
- ```bash
174
+ ```sh
175
+ npm ci --ignore-scripts
176
+ npm ci --prefix scripts/runtime-alpha2 --ignore-scripts
177
+ node scripts/link-dsh-runtime.mjs scripts/runtime-alpha2
178
+ node scripts/check-generated.mjs
209
179
  npm run typecheck
210
180
  npm test
211
181
  npm run test:schema
212
182
  npm pack --ignore-scripts
213
183
  ```
214
184
 
215
- - 设计与协议细节:[ARCHITECTURE.md](ARCHITECTURE.md)
216
- - 版本变化:[CHANGELOG.md](CHANGELOG.md)
217
- - npm:[`dsh-lcx-codex`](https://www.npmjs.com/package/dsh-lcx-codex)
218
-
219
- </details>
185
+ [架构说明](ARCHITECTURE.md)介绍请求生命周期、压缩检查点和 Replay 实现;[更新日志](CHANGELOG.md)记录版本变化。
220
186
 
221
- ## License
187
+ 遇到问题可提交 [Issue](https://github.com/kk3ya03-star/dsh-lcx-codex/issues),附上插件、DSH、Node.js 版本、接口类型、复现步骤和已脱敏的报错信息。
222
188
 
223
- MIT
189
+ ## 许可证
224
190
 
225
- > `LCX` 只是项目名称。本项目是社区项目,不隶属于 OpenAI、DeepSeek、Sub2API NewAPI。
191
+ [MIT](LICENSE)。本项目是独立社区插件,与 OpenAI、DeepSeek、Sub2API、NewAPI 无隶属或官方背书关系。DeepSeek 名称及鲸鱼标识归其权利人所有。
package/cordis.patch.yml CHANGED
@@ -1,25 +1,8 @@
1
- # Optional Responses/Codex capabilities for GPT routes already configured in llm-pi-ai.
2
- # This does not replace DSH's compaction service. Native V2 is installed as the
3
- # documented purpose=compaction llm/stream override, leaving compaction policy,
4
- # range selection, pruning, transactions and /compact owned by DSH.
1
+ # GPT Responses lifecycle plugin. Runtime defaults live in the plugin Config;
2
+ # the bundle declares only route capabilities that differ from conservative defaults.
5
3
  - insert:
6
4
  - id: lcx-codex
7
5
  name: dsh-lcx-codex
8
6
  config:
9
- provider: lcx
10
- baseURL: https://api.lcxbot.com/v1
11
- apiKeyEnv: LCX_API_KEY
12
- model: gpt-5.6-sol
7
+ supportsLongCacheRetention: true
13
8
  supportsExplicitPromptCacheMode: true
14
- legacyCheckpointPath: !!js dshHomePath('storages/lcx-codex/checkpoints-v3.json')
15
- alphaCapabilityPath: !!js dshHomePath('storages/lcx-codex/web-alpha-capabilities.json')
16
- alphaRefPath: !!js dshHomePath('storages/lcx-codex/web-alpha-refs.json')
17
- webSearchProvider: lcx-responses
18
- webMaxResults: 8
19
- timeoutMs: 300000
20
- maxAttempts: 3
21
- requestImagePixelBudget: 4194304
22
- requestImageMaxBytes: 1048576
23
- webSearchTimeoutMs: 240000
24
- autoCompactionThresholdPercent: 90
25
- emergencyPruneThresholdPercent: 95