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

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 (49) hide show
  1. package/README.md +90 -154
  2. package/cordis.patch.yml +3 -20
  3. package/lib/client.js +309 -146
  4. package/lib/compact-v2.js +218 -199
  5. package/lib/dsh-compat.js +232 -100
  6. package/lib/dsh-responses.js +452 -277
  7. package/lib/grok-native-search.js +254 -0
  8. package/lib/index.js +1013 -757
  9. package/lib/json-store.js +50 -31
  10. package/lib/native-checkpoint.js +520 -194
  11. package/lib/responses-request.js +109 -121
  12. package/lib/responses-stream.js +1249 -447
  13. package/lib/route.js +411 -369
  14. package/lib/service-mutex.js +73 -64
  15. package/lib/token-budget.js +176 -108
  16. package/lib/transport.js +280 -68
  17. package/lib/types/client/index.d.ts +6 -0
  18. package/lib/types/compact-v2.d.ts +104 -0
  19. package/lib/types/dsh-compat.d.ts +78 -0
  20. package/lib/types/dsh-responses.d.ts +82 -0
  21. package/lib/types/grok-native-search.d.ts +34 -0
  22. package/lib/types/index.d.ts +83 -0
  23. package/lib/types/json-store.d.ts +10 -0
  24. package/lib/types/native-checkpoint.d.ts +213 -0
  25. package/lib/types/responses-request.d.ts +59 -0
  26. package/lib/types/responses-stream.d.ts +64 -0
  27. package/lib/types/route.d.ts +153 -0
  28. package/lib/types/service-mutex.d.ts +14 -0
  29. package/lib/types/token-budget.d.ts +50 -0
  30. package/lib/types/transport.d.ts +21 -0
  31. package/lib/types/web-run-output.d.ts +29 -0
  32. package/lib/types/web-search-alpha.d.ts +286 -0
  33. package/lib/types/web-search-capability.d.ts +26 -0
  34. package/lib/types/web-search-hosted.d.ts +246 -0
  35. package/lib/types/web-search-ref-store.d.ts +22 -0
  36. package/lib/web-run-output.js +167 -18
  37. package/lib/web-search-alpha.js +865 -163
  38. package/lib/web-search-capability.js +55 -65
  39. package/lib/web-search-hosted.js +210 -32
  40. package/lib/web-search-ref-store.js +63 -59
  41. package/package.json +89 -29
  42. package/ARCHITECTURE.md +0 -117
  43. package/CHANGELOG.md +0 -224
  44. package/README_EN.md +0 -213
  45. package/assets/dsh-lcx-codex-banner.jpg +0 -0
  46. package/lib/legacy-v3.js +0 -20
  47. package/lib/responses-replay.js +0 -68
  48. package/scripts/probe-alpha.mjs +0 -43
  49. package/scripts/validate-dsh-schema.mjs +0 -31
package/README.md CHANGED
@@ -1,225 +1,161 @@
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 提供 Responses 生命周期能力,并为 Grok 接入原生 Web / X Search。**
8
+
9
+ [![npm prerelease](https://img.shields.io/npm/v/dsh-lcx-codex/prelatest?label=prelatest)](https://www.npmjs.com/package/dsh-lcx-codex)
10
+ [![DSH](https://img.shields.io/badge/DSH-0.1.5--alpha.1-16803c)](#安装)
11
+ [![License](https://img.shields.io/badge/license-MIT-555)](LICENSE)
12
+
13
+ **简体中文** · [English](README_EN.md) · [更新日志](CHANGELOG.md) · [问题反馈](https://github.com/kk3ya03-star/dsh-lcx-codex/issues)
12
14
 
13
15
  </div>
14
16
 
15
- > **DSH 仍然是 host。LCX 只补齐 GPT Responses 路径缺失的原生能力,不修改 DSH 核心,也不替换 Agent / Session / Web / Compaction。**
17
+ LCX Codex [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)(DSH)的社区插件。它按当前模型启用对应能力:GPT 可使用远程原生压缩、Hosted / Alpha Search;Grok 可直接使用 xAI Responses 的原生 `web_search` `x_search`。其他模型继续走 DSH 原生路径。
18
+
19
+ 模型、接口、API Key / credential、会话和工具仍由 DSH 管理,不需要在插件里再配置一遍。GPT 与 Grok 的功能开关彼此独立;当前 Grok 原生搜索支持 API Key / API 网关调用,不包含 xAI OAuth / SuperGrok 登录。
16
20
 
17
- ## 当前稳定版
21
+ ## 安装
18
22
 
19
- `0.4.1` 是当前稳定版,也是此前完成完整 Installed Candidate / Cross-feature QA `0.4.1-pre.1` **zero-functional-change stable promotion**。
23
+ 本页对应 **`0.4.3-pre.12` 预发布版**,只支持 **DSH `0.1.5-alpha.1` + Pi `0.85.1`**。稳定版仍为 `0.4.2`;本预发布版不为旧 DSH / Session 格式保留兼容层。
20
24
 
21
- ```powershell
22
- dsh plugin --profile web add dsh-lcx-codex
25
+ 安装前,请确认 DSH `0.1.5-alpha.1` Web 能正常启动,并已配置需要使用的 GPT Responses 或 Grok Responses API 路由。Node.js 要求 `^22.19.0 || >=24.0.0`。
26
+
27
+ ```sh
28
+ dsh plugin --profile web add dsh-lcx-codex@0.4.3-pre.12
23
29
  dsh web
24
30
  ```
25
31
 
26
- npm `latest` 指向 `0.4.1`。历史 `prelatest=0.4.1-pre.1` 与稳定版使用相同的已验收 runtime 基线;新用户直接使用 `latest` 即可。
32
+ 以后升级预发布版,可执行 `dsh plugin --profile web add dsh-lcx-codex@prelatest`。不带版本或标签安装会得到稳定版,**不是本页介绍的新版本**。
27
33
 
28
- ## 它解决什么
34
+ **升级到本版:** 只支持 DSH `0.1.5-alpha.1` 的 Session V3。旧插件配置、旧 DSH session、旧 LCX checkpoint / Grok replay envelope 都不迁移到活动目录。需要保留旧历史时,请先将旧 `sessions` 目录改名或归档,再让 DSH `0.1.5-alpha.1` 从新的空 `sessions` 目录开始;旧数据只作为离线备份保留。
29
35
 
30
- 如果你的 DSH 已经有一个可工作的 GPT `openai-responses` route,`dsh-lcx-codex` 会在保持 DSH 原有入口和生命周期的前提下补齐 Responses 能力。
36
+ DSH 持久化层重新打开同一个已保存 session 时,LCX 可以恢复该 session 内保存的 v5 checkpoint;这只是 DSH session persistence 上的继续对话,**不是 Codex rollout/checkpoint 的进程级 restart/resume 机制**。
31
37
 
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 |
38
+ ## 启用
38
39
 
39
- **目标不是再造一套 Agent,而是让 DSH GPT route 用上它本来就应该拥有的原生能力。**
40
+ 打开 DSH Web 的插件设置,展开 **Responses / Codex 能力**,按需打开开关并保存:
40
41
 
41
- ## 三大能力
42
+ | 开关 | 什么时候开 |
43
+ | --- | --- |
44
+ | 启用 LCX | 使用 GPT Responses 生命周期、Native V2 压缩及 GPT 搜索能力时。 |
45
+ | GPT Hosted Search | 当前模型是 GPT,且需要普通联网查询时。 |
46
+ | 高级 Hosted 工具 | GPT 需要搜图、限定网站或使用其他 Hosted 搜索条件时。 |
47
+ | Alpha | GPT 需要连续 `open / find / click / screenshot` 网页操作时,属于实验功能。 |
48
+ | Grok 原生 Web Search | 当前模型是 Grok,并希望使用 xAI 服务端原生网页搜索时。 |
49
+ | Grok 原生 X Search | 当前模型是 Grok,并希望直接搜索 X 内容时。 |
42
50
 
43
- ### 1. GPT Hosted Search:普通搜索不换入口
51
+ **六个开关默认均关闭。** GPT 四项由“启用 LCX”控制;Grok 两项独立,不要求打开 GPT LCX 主开关。模型、推理等级、图片输入、endpoint 与 credential 都继续在 DSH 的模型/provider 配置中管理。
44
52
 
45
- 启用后,模型看到的普通搜索工具依然是 DSH 原生 `web_search`。LCX 替换的是 SearchProvider 路径,而不是再注册一个重复的普通搜索工具。
53
+ 模型切换不需要重启插件:
46
54
 
47
- 需要更细控制时,再单独启用 `websearch_gpt_advanced`。
55
+ - GPT → 只启用已打开的 GPT / LCX 能力;
56
+ - Grok → 只启用已打开的原生 Web / X Search;开启任意 Grok 原生搜索时,该请求不会同时暴露 DSH `web_search`,但 `web_fetch` 和其他 DSH/MCP 工具仍可用;
57
+ - Claude、Gemini、DeepSeek 等其他模型 → 保持 DSH 原生会话、搜索、工具和压缩行为。
48
58
 
49
- ### 2. Codex 风格 Web Actions
59
+ ## 搜索与搜图
50
60
 
51
- `websearch_alpha` 面向连续浏览和结构化 Web action:
61
+ ### GPT 联网查询
52
62
 
53
- ```text
54
- search → open → find / click → screenshot
55
- ```
63
+ GPT 普通查询沿用 DSH 的单一 `web_search` 工具入口;开启 **GPT Hosted Search** 后,LCX 按当前 GPT Responses route 执行 Hosted Search。需要域名、位置、search context 或图片等额外参数时,可启用 `websearch_gpt_advanced`。
56
64
 
57
- 它默认关闭,并且只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署采用 **fail-closed**,不会被误报成“支持 Alpha”。
65
+ 例如:
58
66
 
59
- `0.4.1` 已包含此前 prerelease 验收通过的 URL/stateful continuation 和 capability fail-closed 修复。
67
+ > 只搜索 Python 官方文档,查找 asyncio.TaskGroup 的用法。
60
68
 
61
- ### 3. Native V2 Compaction
69
+ ### Grok 原生 Web / X Search
62
70
 
63
- LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactable range、`/compact`、durable session transaction、tool-result pruning 与 overflow recovery;LCX 只在已有 compaction LLM seam 上请求 Responses Native V2。
64
-
65
- 默认自动策略:
71
+ Grok 使用 xAI Responses 的服务端工具,而不是把搜索包装成 DSH function tool
66
72
 
67
73
  ```text
68
- 0% ─────────────────── 90% ───── 95% ───── 100%
69
- normal Native emergency hard cap
70
- V2 DSH prune
74
+ { type: "web_search" }
75
+ { type: "x_search" }
71
76
  ```
72
77
 
73
- - **90%**:优先尝试 Native V2。
74
- - **95%**:才允许 emergency DSH prune。
75
- - provider-confirmed context overflow:继续使用 DSH 原有恢复逻辑。
76
- - 手动 `/compact`:继续使用 DSH 原生会话事务。
77
-
78
- 同一 source session 可以继续复用自己的 Native checkpoint;fork 或模型/route migration 不会跨 session 发送 parent opaque state,而是走 portable migration;重启后从 DSH session log 恢复。
79
-
80
- ## 0.4.1 相比 0.4.0
81
-
82
- `0.4.1` 将此前 `0.4.1-pre.1` 的已验收改动正式提升到 stable:
83
-
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
+ 开启任意 Grok 原生搜索后,Grok 请求会移除 DSH `web_search`,避免重复搜索语义;`web_fetch`、`read` 及其他 DSH/MCP function tools 仍保持可用。原生搜索结果可以继续进入本地工具调用,再回到同一 Grok agentic workflow;插件会保存 xAI 必需的 provider-native replay state,但不会把服务端搜索伪装成 DSH 本地工具调用。
90
79
 
91
- stable promotion 不引入新的 runtime 行为。
80
+ 当前支持 **API Key / API Gateway** 路由;OAuth / SuperGrok / X Premium 订阅登录不在本版范围内。LCX 不再为 Grok 自动追加可见的 synthetic `Sources:` 列表,并会清理已知的 `render_inline_citation` / `stateless_invoke` /私有区 renderer 标记、尾部 `<|eos|>` 等上游渲染协议残留;模型正文中主动写出的普通链接仍保持可见。完整 provider-native 搜索输出只保存在 same-session replay state 中。
92
81
 
93
- ## 30 秒开始使用
82
+ ### GPT 搜索图片并显示
94
83
 
95
- ### 1. 安装
84
+ 开启高级 Hosted 工具后,可以这样说:
96
85
 
97
- ```powershell
98
- dsh plugin --profile web add dsh-lcx-codex
99
- dsh web
100
- ```
101
-
102
- 需要固定版本时:
86
+ > 搜索金门大桥的照片,选一张直接显示在回复里,并附上来源网页。
103
87
 
104
- ```powershell
105
- dsh plugin --profile web add dsh-lcx-codex@0.4.1
106
- ```
88
+ **不需要自己填写 JSON 参数。** 模型负责选择图片搜索参数;如果只返回文字,可以补充“请使用高级 Hosted 的图片搜索,并把图片显示出来”。
107
89
 
108
- 升级时请使用 DSH 官方 plugin remove/add 路径;不要为了“清理”删除用户 session 或 `$DSH_HOME/storages/lcx-codex/`。
90
+ 搜索工具提供图片链接与来源,DSH 用现有的 Markdown 渲染器显示图片。这是**搜索已有图片,不是生成图片**,也不代表模型已经读取了图片像素。图片能否显示还取决于原站链接是否可访问。
109
91
 
110
- ### 2. 在 DSH Settings 启用
92
+ ### Alpha 网页操作
111
93
 
112
- 第一次使用建议从最小配置开始:
94
+ `websearch_alpha` 支持 `search / open / find / click / screenshot` 等动作,用于 GPT 连续查阅网页。它操作的是**上游搜索服务中的网页内容**,不会操作你的本机浏览器或 DSH 界面。
113
95
 
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** |
96
+ Alpha 需要单独开启,且接口通过能力探测后才会出现。目前网页引用仍可能偶发失效,`screenshot` 尚未验证能返回可显示的图片。**日常 GPT 搜索/搜图和 Grok 原生搜索都不需要开启 Alpha。**
122
97
 
123
- **前提条件**
98
+ ## 长对话与压缩
124
99
 
125
- - Node.js `>=20`
126
- - DSH 中已有可工作的 GPT `openai-responses` route
127
- - 上游 endpoint 实际支持你准备启用的 Hosted Search / Native V2 / Alpha 能力
100
+ 开启 LCX 后,插件将 DSH 的压缩请求交给上游 GPT 接口执行 **Native V2 远程原生压缩**,再将结果接回当前会话。会话保存、工具执行和压缩事务仍由 DSH 负责。
128
101
 
129
- ### 3. 确认它真的生效
102
+ | 上下文占用 | 处理方式 |
103
+ | --- | --- |
104
+ | 低于 `90%` | 正常对话,不提前裁剪工具结果。 |
105
+ | `90%` 至 `95%` | 优先尝试远程原生压缩。 |
106
+ | 达到 `95%` | 允许 DSH 紧急裁剪工具结果,再按流程压缩。 |
130
107
 
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 成功 |
108
+ 也可以输入 `/compact` 手动压缩。这些阈值是固定策略,不需要额外设置;实际能否压缩取决于是否有可压缩的历史以及接口支持情况。Grok 不走 GPT Native V2,而继续使用 DSH `0.1.5-alpha.1` 自己的 compaction;Session V3 的 leading `system/message` 由 DSH 保持在摘要之外。
137
109
 
138
- ## 搜索工具怎么选
110
+ 压缩后可以在同一存活 session 内继续对话;如果 DSH 自身重新打开同一个已持久化 session,LCX 也会校验并恢复其中的 v5 checkpoint。遇到不兼容的模型、route 或 session identity 时,插件改用可迁移的历史,不会强行复用原生状态。首次建立检查点时,部分可恢复失败可以回退到 DSH 基础压缩;并非所有失败都会回退。这里不引入 Codex 式 rollout/checkpoint restart-resume。
139
111
 
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 |
112
+ ## 缓存
145
113
 
146
- ## 它如何接入 DSH
114
+ 缓存由上游服务实现,插件只负责保持与当前 provider 兼容的缓存/session identity。
147
115
 
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
- ```
116
+ - **GPT**:延续 LCX 既有策略;前台会话与其子代理可共享父会话的 prompt-cache identity,以复用公共请求前缀。真正的 DSH Session、工具执行与私有历史仍各自独立。
117
+ - **Grok**:严格跟随 DSH/Pi 原生语义;每个前台/子代理使用自己的 DSH Session ID 作为 prompt cache / session affinity identity,sibling 子代理不会共享 opaque replay state。
154
118
 
155
- **DSH host,LCX 是兼容扩展层。** 插件优先复用当前 DSH route `baseURL`、credential reference、headers、模型与 retry policy,而不是维护第二套账号配置。
119
+ Pi `0.85.1` 的显式缓存模式支持 `30m` 长保留参数;`cacheRetention=none` 时不发送 prompt cache key。压缩、切换模型或改变工具列表后,缓存可能需要重新建立。
156
120
 
157
- checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与 pressure coordination 等实现细节见 [ARCHITECTURE.md](ARCHITECTURE.md)。
121
+ ## 故障排查
158
122
 
159
- ## 兼容性
123
+ **从旧版 Windows DSH 升级后还需要 `fs-ext` 本地补丁吗?**
160
124
 
161
- 当前正式稳定组合:
125
+ 不需要把 `0.1.3-alpha.2` 的 `fs-ext` 本地 workaround 带到 DSH `0.1.5-alpha.1`。本版已经在未修改的 Windows DSH `0.1.5-alpha.1` 上完成 Web 与 headless 启动验证。若旧安装曾手工修改 DSH 文件,请通过正常安装得到干净的 `0.1.5-alpha.1` 文件,不要把旧补丁复制到新版本。
162
126
 
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** |
127
+ **安装后没有变化?**
166
128
 
167
- `0.4.1` runtime 来自完整 QA 通过的 `0.4.1-pre.1`,stable promotion 本身保持 zero-functional-change。新的 DSH 版本**不会自动视为兼容**;项目会先检查受影响 seam,再按风险运行对应测试。
129
+ 检查安装和启动是否使用同一个 `web` 配置,并确认对应模型的开关已保存。GPT 主开关与 Grok Web/X 开关彼此独立。
168
130
 
169
- <details>
170
- <summary><strong>完整推荐设置</strong></summary>
131
+ **对话正常,但搜索或压缩失败?**
171
132
 
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 | 避免长搜索被过早终止 |
133
+ 普通 Responses 对话可用,不代表接口同时支持 Native V2、Hosted/Alpha Grok 原生 Web/X Search。请确认当前通道提供对应服务端能力;Sub2API、NewAPI 或其他网关名称本身不是能力保证。
183
134
 
184
- 主要配置字段:`remoteCompaction`、`autoCompaction`、`fallbackToBasicCompaction`、`autoCompactionThresholdPercent`、`emergencyPruneThresholdPercent`、`webSearchTimeoutSeconds`、`advancedHostedSearch`、`alphaSearch`。
135
+ ## 版本与验证范围
185
136
 
186
- </details>
137
+ 本版使用 DSH `0.1.5-alpha.1`、DSH host Pi `0.85.1` 和插件 Pi `0.85.1`。插件单独声明 Pi 依赖,不替换 DSH 的依赖。
187
138
 
188
- <details>
189
- <summary><strong>常见情况</strong></summary>
139
+ 发布候选已通过 **246/246 PASS**、strict host/client typecheck 与 DSH schema 校验。真实 DSH `0.1.5-alpha.1` 隔离运行已验证:Web 启动、headless GPT 普通请求、Session V3 `system/message`、Native V2 `/compact`、compact 后同 session continuation,以及 v5 checkpoint 的 session identity 绑定。
190
140
 
191
- **`web_search` 没走 GPT Hosted Search**
192
- 确认插件和 Hosted Search 已启用,并且当前 Agent 能解析到兼容的 GPT `openai-responses` route。
141
+ Grok 另做了真实长会话验证:原生 Web Search → 足够长的上下文 → DSH 实际 `/compact` compact 后再次原生搜索/续聊。marker 与关键事实保持,`system/message` 只出现一次,Grok replay 为当前 v3 envelope,最终可见正文 `sourceLeak=false`。
193
142
 
194
- **`websearch_alpha` 没出现**
195
- 这是预期的 fail-closed 行为。Alpha 必须对当前 route/schema 完成可信 capability probe 后才注册。
143
+ 仍需保留的预发布限制:Alpha 引用及 screenshot 展示、代理/NO_PROXY、更广的并发/取消和后台 continuable subagent 矩阵仍未全面覆盖;Grok OAuth 不支持;未知的新型上游 renderer 协议仍可能需要额外适配。DSH `0.1.5-alpha.1` 本身仍是 alpha/developer-preview 级上游。
196
144
 
197
- **Native V2 没有生效**
198
- 确认当前 GPT Responses endpoint 实际支持 `remote_compaction_v2`。插件不会把普通 Basic Compaction 假装成 Native V2 成功。
145
+ ## 开发与反馈
199
146
 
200
- **安装成功但配置卡不可见**
201
- 确认安装的是 `0.4.1` 或更高版本,并重启/刷新 DSH Web;`0.4.1` 已包含正式安装态 settings lifecycle 修复。
202
-
203
- </details>
204
-
205
- <details>
206
- <summary><strong>开发</strong></summary>
207
-
208
- ```bash
147
+ ```sh
148
+ npm ci --ignore-scripts
149
+ npm ci --prefix scripts/runtime-dsh015 --ignore-scripts
150
+ node scripts/link-dsh-runtime.mjs scripts/runtime-dsh015
151
+ node scripts/check-generated.mjs
209
152
  npm run typecheck
210
153
  npm test
211
154
  npm run test:schema
212
- npm pack --ignore-scripts
213
155
  ```
214
156
 
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>
220
-
221
- ## License
157
+ 实现细节见[架构说明](ARCHITECTURE.md)。提交 [Issue](https://github.com/kk3ya03-star/dsh-lcx-codex/issues) 时,请附上插件、DSH、Node.js 版本及复现步骤,不要上传 API Key、完整请求或未脱敏的会话日志。
222
158
 
223
- MIT
159
+ ## 许可证
224
160
 
225
- > `LCX` 只是项目名称。本项目是社区项目,不隶属于 OpenAI、DeepSeek、Sub2API NewAPI。
161
+ [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