dsh-lcx-codex 0.5.0-pre.1 → 0.5.0

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 (2) hide show
  1. package/README.md +21 -10
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -37,18 +37,20 @@ LCX Codex 是 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness
37
37
 
38
38
  | 你的 DSH 版本 | 安装的 LCX 版本 | 安装命令中的标签 |
39
39
  | --- | --- | --- |
40
- | `0.2.0` 系列(`0.2.0-rc.2` 及以后,低于 `0.2.1`) | `0.5.0-pre.1`(预发布版) | `@prelatest` |
40
+ | `0.2.0` 系列(`0.2.0-rc.2` 及以后,低于 `0.2.1`) | `0.5.0`(稳定版) | `@latest` |
41
41
  | `0.1.6` 系列(`0.1.6-alpha.2` 及以后) | `0.4.4-pre.1`(旧预发布版) | `@0.4.4-pre.1` |
42
- | `0.1.5` 系列(`0.1.5-rc.1` 及以后) | `0.4.3`(稳定版) | `@latest` |
42
+ | `0.1.5` 系列(`0.1.5-rc.1` 及以后) | `0.4.3`(稳定版) | `@0.4.3` |
43
43
 
44
- 请务必按表格选择:三个版本互不兼容,装错版本时安装命令可能只给出依赖警告,但插件可能无法正常工作。`0.5.0-pre.1` 是预发布版,本次预发布的验收基线为 DSH `0.2.0-rc.2`(host / plugin Pi `0.87.1`)。
44
+ 请务必按表格选择:三个版本互不兼容,装错版本时安装命令可能只给出依赖警告,但插件可能无法正常工作。`@latest` 现在指向支持 DSH `0.2` 的 `0.5.0`,DSH `0.1.5` 用户请固定安装 `@0.4.3`。`0.5.0` 的发布基线为 DSH `0.2.0-rc.2`(host / plugin Pi `0.87.1`),运行时代码与此前的 `0.5.0-pre.1` 完全一致。
45
+
46
+ > 注意:安装范围写作 `>=0.2.0-rc.2 <0.2.1`,按 DSH 的版本范围规则,`0.2.1` 的预发布版(如 `0.2.1-alpha.2`)也可能被放行安装,但这些版本**不在** `0.5.0` 的支持和验证范围内,请不要依赖它们。
45
47
 
46
48
  ### 2. 安装并启动
47
49
 
48
50
  DSH `0.2.0` 系列:
49
51
 
50
52
  ```sh
51
- dsh plugin --profile web add dsh-lcx-codex@prelatest
53
+ dsh plugin --profile web add dsh-lcx-codex@latest
52
54
  dsh web
53
55
  ```
54
56
 
@@ -59,10 +61,10 @@ dsh plugin --profile web add dsh-lcx-codex@0.4.4-pre.1
59
61
  dsh web
60
62
  ```
61
63
 
62
- DSH `0.1.5` 系列:
64
+ DSH `0.1.5` 系列(注意固定版本号,不要用 `@latest`):
63
65
 
64
66
  ```sh
65
- dsh plugin --profile web add dsh-lcx-codex@latest
67
+ dsh plugin --profile web add dsh-lcx-codex@0.4.3
66
68
  dsh web
67
69
  ```
68
70
 
@@ -112,8 +114,10 @@ dsh web
112
114
 
113
115
  ## 从旧版本升级
114
116
 
115
- - **DSH 升级到 `0.2.0` 系列**:把插件换成 `@prelatest`(`0.5.0-pre.1`),旧版 `0.4.x` 不支持 DSH `0.2`。
116
- - **DSH `0.1.6` 系列**:继续使用 `@0.4.4-pre.1`;`@prelatest` 现在指向支持 DSH `0.2` 的 `0.5.0-pre.1`。
117
+ - **DSH 升级到 `0.2.0` 系列**:把插件换成 `@latest`(`0.5.0`),旧版 `0.4.x` 不支持 DSH `0.2`。
118
+ - **DSH `0.1.6` 系列**:继续使用 `@0.4.4-pre.1`。
119
+ - **DSH `0.1.5` 系列**:继续使用 `@0.4.3`;`@latest` 现在指向支持 DSH `0.2` 的 `0.5.0`。
120
+ - **已装了 `0.5.0-pre.1`**:重新运行同一条 `add` 命令(`@latest`)即可升到 `0.5.0`,两者运行时代码一致。
117
121
  - **升级后建议新建会话**:旧版本保存的压缩状态不保证兼容。DSH `0.2` 迁移过的旧长会话如果带有旧版 LCX 压缩检查点,LCX 会提示 `LCX_CHECKPOINT_UNSUPPORTED`,新建会话即可;其他模型不受影响。
118
122
 
119
123
  ## 停用与卸载
@@ -129,11 +133,11 @@ dsh web
129
133
 
130
134
  - **网关能力因人而异**:搜索、压缩、Alpha 都依赖对应的服务端能力,不同网关支持程度不同。
131
135
  - **Grok**:支持 API Key / API 网关路由,不支持 xAI OAuth / SuperGrok 登录。原生 X Search 目前只在 `grok-4.6` 上验证过。
132
- - **Grok 长对话压力**:xAI 的智能体调用会把多次内部请求的用量累加计费。`0.5.0-pre.1` 在服务端返回完整的实时上下文数据时,用它来判断何时压缩,缺失时退回估算;计费数字本身保持不变。
136
+ - **Grok 长对话压力**:xAI 的智能体调用会把多次内部请求的用量累加计费。`0.5.0` 在服务端返回完整的实时上下文数据时,用它来判断何时压缩,缺失时退回估算;计费数字本身保持不变。
133
137
  - **Alpha 仍是实验功能**:连续打开/查找页面在已测试的 OAuth 类上游上可用;API Key 类上游账号不在支持范围内。目标页面抓取失败时会提示 `LCX_ALPHA_PAGE_FETCH_FAILED`,模型可以换一个结果继续。
134
138
  - **Markdown 图片换行**:为避免 DSH `0.2` 中图片后的文字挤到图片右侧,LCX 会让回答里的 Markdown 图片单独占一行,这一点与“搜索媒体预览”开关无关;句中的小图也会因此换行。
135
139
  - **DSH `0.1.5` + LCX `0.4.3`**:在插件设置中启用或停用 LCX 后,已打开的浏览器页面可能需要刷新。
136
- - **验证范围**:`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`。同一安装范围内其他后续版本仍需单独评估,遇到问题欢迎反馈。
140
+ - **验证范围**:`0.5.0` 的发布基线为 DSH `0.2.0-rc.2`(与已发布验证的 `0.5.0-pre.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`。同一安装范围内其他后续版本仍需单独评估,遇到问题欢迎反馈。
137
141
 
138
142
  ## 常见问题
139
143
 
@@ -146,6 +150,12 @@ dsh web
146
150
  **安装时出现依赖版本警告,或插件加载失败?**
147
151
  通常是 DSH 版本和插件版本不匹配,按[上面的表格](#1-按-dsh-版本选择插件版本)重新选择。
148
152
 
153
+ **升级到 DSH 0.2 后插件“导入失败”(failed to import)?**
154
+ 从较早版本一路升级上来的配置目录里可能残留旧的依赖包。先停止 `dsh web`,把 DSH 主目录(默认 `~/.dsh`,或 `DSH_HOME` 指定的目录)下 `profiles/web/` 里的 `node_modules` 和 `pnpm-lock.yaml` 移走或删除,再重新运行 `dsh plugin --profile web add dsh-lcx-codex@latest`,然后启动 `dsh web`。
155
+
156
+ **刚发布新版时 `@latest` 装到了旧版本?**
157
+ 包管理器的缓存可能还没刷新,DSH 会因版本不兼容拒绝安装。稍等几分钟重试,或直接指定版本号,例如 `dsh-lcx-codex@0.5.0`。
158
+
149
159
  ## 反馈问题
150
160
 
151
161
  请在 [Issues](https://github.com/kk3ya03-star/dsh-lcx-codex/issues) 中附上:插件版本、DSH 版本、Node.js 版本、使用的模型/网关类型和复现步骤。
@@ -157,6 +167,7 @@ dsh web
157
167
  - [更新日志](CHANGELOG.md)
158
168
  - [架构说明](ARCHITECTURE.md)
159
169
  - [第三方许可](THIRD_PARTY_NOTICES.md)
170
+ - [参与贡献](CONTRIBUTING.md)
160
171
 
161
172
  ## 许可证
162
173
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-lcx-codex",
3
- "version": "0.5.0-pre.1",
3
+ "version": "0.5.0",
4
4
  "description": "Model-scoped DSH plugin: GPT Responses lifecycle, Native V2 compaction and Hosted/Alpha Search; Grok native Web/X Search",
5
5
  "keywords": [
6
6
  "deepseek-harness",