dsh-lcx-codex 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.4.1 - 2026-08-25
+
+### Stable promotion
+
+- Promote the fully QA-passed `0.4.1-pre.1` runtime to stable `0.4.1` with **zero functional/runtime code changes**.
+- Make Alpha stateful continuation/fail-closed fixes, DSH compatibility-seam isolation, typed protocol hardening, conservative token budgeting, and the installed Settings lifecycle fix part of the default stable line.
+- Publish stable `0.4.1` to npm dist-tag `latest`; the prior `prelatest=0.4.1-pre.1` remains historical prerelease state.
+
+### Validation basis
+
+- `0.4.1-pre.1` passed Installed Candidate + Cross-feature QA before publication.
+- Public promotion preserved runtime/source parity with the frozen prerelease candidate.
+- Stable promotion requires package/version, typecheck, tests, schema, package/import boundary and zero-runtime-diff checks before publication.
+
+## 0.4.1-pre.1 - 2026-08-25
+
+### Released prerelease
+
+- Published as `dsh-lcx-codex@0.4.1-pre.1` on npm dist-tag `prelatest`; stable `latest` remained `0.4.0` at prerelease publication time.
+- Integrates the accepted Alpha stateful continuation and fail-closed capability work from #20, #21, and #22.
+- Includes accepted compatibility seam isolation (#24), typed protocol-core hardening (#25), unified conservative token budgeting (#26), and the installed-plugin settings lifecycle fix (#36).
+- Passed installed-candidate and cross-feature QA before publication, including ordinary/Advanced Hosted Search, Native compaction/replay, restart/resume, model continuation, fork isolation, and fail-closed Alpha behavior where unsupported.
+- Public promotion preserved source/runtime parity with the frozen private candidate; package, schema, typecheck, import, install-chain, and publication gates passed.
+- Post-release registry installation and Loader/client/settings-chain verification passed. The final provider-gated ordinary `web_search` recheck was not covered because the temporary authorized upstream credential returned HTTP 401; this was recorded as an external-auth verification gap rather than a package/source/runtime defect.
+- Superseded as the recommended release by stable `0.4.1` after zero-functional-change promotion.
+
 ## 0.4.0 - 2026-08-23
 
 ### Stable promotion
@@ -76,6 +102,7 @@
 - Restore the Alpha capability/ref-store interfaces consumed by `lib/index.js`; the rc.8 release package could pass its unit tests but fail immediately at module import with missing `AlphaCapabilityStore` / `AlphaRefStore` exports.
 - Add package-entry import regression coverage so CI fails when the server entry point and internal module exports drift out of sync.
 - Restore Native-first pressure coordination for isolated agent presets using DSH 0.1.1-rc.2's public `agentPresets.serviceFor(agent, name)` resolver. Preset-local `compaction` / `toolResultPruner` services are not visible through ordinary host or `agent.ctx` lookup; the plugin now addresses the actual per-Agent instances before applying the 90% Native / 95% emergency policy. A root service-lifecycle hook remains for non-preset deployments.
+
 ## 0.4.0-rc.8
 
 - Rebase the plugin on DSH `0.1.1-rc.2`; older DSH releases are no longer a supported runtime target.
@@ -88,7 +115,7 @@
 
 ### Fixed
 
-- Ordinary DSH `web_search` now follows the active Agent `provider/model` instead of always using the plugin fallback GPT model. A Luna conversation now searches with Luna; a Sol conversation searches with Sol.
+- Ordinary DSH `web_search` now follows the active Agent `provider/model` instead of always using the plugin fallback GPT model. A Luna conversation now searches with Luna; a Sol conversation now searches with Sol.
 - Added an AsyncLocalStorage route bridge at the DSH `tools/execute` boundary so the provider-only `ctx.web.search()` seam can receive Agent route context without changing the model-visible `web_search` schema.
 - Hosted Search now uses a separate stable `dsh-lcx-search:<route hash>` `prompt_cache_key`, avoiding intentional cache-key sharing with Native conversation replay.
 - The settings UI now labels the configured Responses endpoint/model as **fallback** values, matching their actual rc.7 role.
@@ -117,7 +144,7 @@
 
 - Adds a bounded conversation-fidelity layer after real DSH testing showed assistant-only facts could be lost by opaque Native V2 compaction.
 - New `lcx-native-compaction-v5` checkpoints retain selected user/developer/system messages plus user-visible assistant final answers before the opaque compaction item.
-- Keeps explicit retained history within an estimated 64k-token ceiling; defaults reserve at most 24k for assistant answers and cap one retained answer at about 3k tokens.
+- Keeps explicit retained history within an estimated 64k-token ceiling; defaults reserve at most 24k for assistant answers and cap one retained assistant answer at about 3k tokens.
 - Does not copy reasoning, tool calls/results, raw search payloads, or telemetry into the fidelity prefix.
 - Repairs rc.3/rc.4 v4 checkpoints from append-only `shadowedSeqs`, including assistant-visible answers when the original DSH events still exist.
 - Stores only the single opaque compaction output item, ignoring unrelated terminal output items from nonstandard proxies.

package/README.md

@@ -1,270 +1,225 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/kk3ya03-star/dsh-lcx-codex/main/assets/dsh-lcx-codex-banner.jpg" alt="DSH-LCX-CODEX" width="100%" />
+<img src="assets/dsh-lcx-codex-banner.png" alt="dsh-lcx-codex — 为 DSH 增加 GPT Hosted Search、Codex 风格网页操作与 Native V2 Compaction" width="100%" />
 
-# DSH-LCX-CODEX
-
-**给 DeepSeek Harness 补上 GPT Responses / Codex 原生能力。**
-
-[![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm)](https://www.npmjs.com/package/dsh-lcx-codex)
-![Node](https://img.shields.io/badge/Node-%3E%3D20-1677ff)
+[![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm%20latest)](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)
-![License](https://img.shields.io/badge/license-MIT-1677ff)
+![Node](https://img.shields.io/badge/Node-%3E%3D20-2f855a)
+![License](https://img.shields.io/badge/license-MIT-6b7280)
 
-**简体中文** · [English](README_EN.md)
+**简体中文** · [English](README_EN.md) · [Architecture](ARCHITECTURE.md) · [Changelog](CHANGELOG.md)
 
 </div>
 
----
-
-`dsh-lcx-codex` 是一个社区维护的 DSH 插件，面向已经通过 `llm-pi-ai / openai-responses` 接入的 GPT 路由。它尽量复用 DSH 自己的 Agent、Web、Session 和 Compaction 架构，只在缺少 OpenAI/Codex 原生语义的地方补能力。
-
-> `LCX` 只是项目名称。本项目不隶属于 OpenAI、DeepSeek、Sub2API 或 NewAPI。
-
-- **最新版 DSH 图片管线**：Native V2 直接复用 `readImageRequest()` 和当前路由图片预算，避免压缩请求与普通 GPT 请求使用不同的图片版本。
-
-## 核心能力
-
-| 能力 | 说明 | 默认 |
-|---|---|---:|
-| **DSH 原生 `web_search` → GPT Hosted Search** | 不新增重复的普通搜索工具；rc.7+ 自动跟随当前 Agent 的 GPT Responses 模型 | 可开启 |
-| **Advanced Hosted Search** | 域名过滤、location、search context、图片搜索等 OpenAI Hosted 参数 | 关闭 |
-| **Alpha Search** | `search/open/find/click/screenshot` 等 Codex/Alpha 风格命令；能力探针通过后才注册 | 关闭 |
-| **Native Remote Compaction V2** | 通过 Responses `compaction_trigger` 获取 provider-native opaque checkpoint | 可开启 |
-| **Conversation fidelity retention** | 显式保留 bounded user / assistant 可见事实，避免只记得“问过什么”却忘记“答了什么” | 内置 |
-| **Session-native checkpoint** | checkpoint 存在 DSH append-only session log，不再以 sidecar 作为新会话真相源 | 内置 |
-| **Native-first 自动压缩** | 90% 主动 Native V2，95% emergency 才允许 DSH prune；阈值可调 | 可开启 |
-| **长搜索超时** | DSH `web_search` 外层 timeout 默认提升到 240 秒，可调 30–600 秒 | 内置 |
+> **DSH 仍然是 host。LCX 只补齐 GPT Responses 路径缺失的原生能力，不修改 DSH 核心，也不替换 Agent / Session / Web / Compaction。**
 
-## rc.8：面向 DSH 0.1.1-rc.2
+## 当前稳定版
 
-rc.8 直接面向 **DSH 0.1.1-rc.2**。普通 `web_search` 继续跟随当前 Agent 模型，同时 Native V2 的图片输入改用新版 DSH `readImageRequest()` 管线，不再直接读取 attachment master bytes。
+`0.4.1` 是当前稳定版，也是此前完成完整 Installed Candidate / Cross-feature QA 的 `0.4.1-pre.1` 的 **zero-functional-change stable promotion**。
 
-搜索路由仍通过 **DSH `tools/execute` → SearchProvider** 运行时上下文传递：
-
-```text
-Agent: lcx / gpt-5.6-luna
-        │
-        └─ DSH web_search
-             │
-             └─ Hosted Search: lcx / gpt-5.6-luna
-
-Agent: lcx / gpt-5.6-sol
-        │
-        └─ DSH web_search
-             │
-             └─ Hosted Search: lcx / gpt-5.6-sol
+```powershell
+dsh plugin --profile web add dsh-lcx-codex
+dsh web
 ```
 
-这不会修改模型看到的 `web_search` schema。
+npm `latest` 指向 `0.4.1`。历史 `prelatest=0.4.1-pre.1` 与稳定版使用相同的已验收 runtime 基线；新用户直接使用 `latest` 即可。
 
-没有 Agent 上下文时，才使用设置页里的 **回退 Responses 地址 / 回退 GPT 模型**。
+## 它解决什么
 
-### Search 与会话缓存隔离
+如果你的 DSH 已经有一个可工作的 GPT `openai-responses` route，`dsh-lcx-codex` 会在保持 DSH 原有入口和生命周期的前提下补齐 Responses 能力。
 
-Hosted Search 是一笔独立 Responses 请求，不等于主会话推理。rc.8 继续给搜索使用独立 cache namespace：
+| 场景 | DSH 原有入口 | LCX 增强后 |
+|---|---|---|
+| 普通联网搜索 | DSH `web_search` | **仍然使用同一个 `web_search`**，由 LCX SearchProvider 映射到当前 GPT Hosted Search |
+| Hosted Search 高级参数 | 普通搜索入口保持简洁 | 按需增加 `websearch_gpt_advanced`，提供域名过滤、近似位置、search context、图片搜索等 |
+| 连续网页 / PDF 浏览 | DSH 继续拥有 Web 生命周期 | 按需增加 Codex / Alpha Web Actions：`search → open → find/click → screenshot` |
+| 长会话压缩 | DSH 继续负责 pressure、事务与 recovery | 在现有 compaction seam 上优先请求 Responses Native V2 checkpoint |
 
-```text
-主会话 replay:  dsh-lcx:<route hash>
-Hosted Search: dsh-lcx-search:<route hash>
-```
+**目标不是再造一套 Agent，而是让 DSH 的 GPT route 用上它本来就应该拥有的原生能力。**
+
+## 三大能力
 
-因此搜索不会故意与 Native replay 共用同一个 `prompt_cache_key`。NewAPI 后台仍可能看到搜索请求夹在主会话请求之间；它们是不同请求，搜索行本身 cache 较低并不代表 DSH session 被截断。
+### 1. GPT Hosted Search：普通搜索不换入口
 
-## Native V2 Compaction
+启用后，模型看到的普通搜索工具依然是 DSH 原生 `web_search`。LCX 替换的是 SearchProvider 路径，而不是再注册一个重复的普通搜索工具。
 
-DSH 本身已经负责：
+需要更细控制时，再单独启用 `websearch_gpt_advanced`。
 
-- token pressure；
-- compactable range selection；
-- tool-result pruning；
-- durable session transaction；
-- `/compact`；
-- context-overflow recovery。
+### 2. Codex 风格 Web Actions
 
-本插件不再造第二套 compaction engine，而是在 DSH 的 `purpose: 'compaction'` LLM seam 上执行 Native V2：
+`websearch_alpha` 面向连续浏览和结构化 Web action：
 
 ```text
-DSH compaction transaction
-        │
-        └─ purpose=compaction
-              │
-              └─ POST /responses
-                   x-codex-beta-features: remote_compaction_v2
-                   input: [...history, { type: "compaction_trigger" }]
+search → open → find / click → screenshot
 ```
 
-Native 成功：不再额外运行 basic summary。
-
-Native 失败且开启 fallback：才回到 DSH basic compaction。
+它默认关闭，并且只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署采用 **fail-closed**，不会被误报成“支持 Alpha”。
 
-## 为什么压缩后还能记住模型自己说过的话
+`0.4.1` 已包含此前 prerelease 验收通过的 URL/stateful continuation 和 capability fail-closed 修复。
 
-单纯依赖 provider-native opaque compaction 是有损的。真实长会话测试发现，低显著性的 assistant-only 事实可能被压掉，例如：
+### 3. Native V2 Compaction
 
-- 模型随机生成的项目代号；
-- 搜索后模型给出的具体姓名；
-- 只在 assistant 最终回答里出现的数字。
+LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactable range、`/compact`、durable session transaction、tool-result pruning 与 overflow recovery；LCX 只在已有 compaction LLM seam 上请求 Responses Native V2。
 
-因此当前 checkpoint 使用：
+默认自动策略：
 
 ```text
-bounded client-visible history
-+ bounded assistant-visible answers
-+ opaque Native V2 compaction item
+0% ─────────────────── 90% ───── 95% ───── 100%
+       normal            Native      emergency   hard cap
+                         V2          DSH prune
 ```
 
-默认总 explicit retention 预算约 `64k` estimated tokens，其中 assistant-visible answer 最多预留约 `24k`，单条默认最多约 `3k`。不把 reasoning、巨大 tool result、完整搜索正文和运行 telemetry 全塞回来。
-
-目标不是“逐字无损”，而是：**删过程，保事实。**
-
-## 自动压缩策略
+- **90%**：优先尝试 Native V2。
+- **95%**：才允许 emergency DSH prune。
+- provider-confirmed context overflow：继续使用 DSH 原有恢复逻辑。
+- 手动 `/compact`：继续使用 DSH 原生会话事务。
 
-rc.8 延续 rc.6 的 Native-first pressure policy：
+同一 source session 可以继续复用自己的 Native checkpoint；fork 或模型/route migration 不会跨 session 发送 parent opaque state，而是走 portable migration；重启后从 DSH session log 恢复。
 
-```text
-0% ─────────────────── 90% ───── 95% ───── 100%
-       正常使用          Native     emergency    hard cap
-                         V2         DSH prune
-```
+## 0.4.1 相比 0.4.0
 
-默认：
+`0.4.1` 将此前 `0.4.1-pre.1` 的已验收改动正式提升到 stable：
 
-- `< 90%`：不让 DSH 原来的 80% pressure prune 提前改写历史；
-- `90%–95%`：优先 Native V2；
-- `>= 95%`：允许 DSH replay-safe tool-result pruner 救场；
-- provider 明确返回 context overflow：仍保留 DSH 原生 recovery；
-- 手动 `/compact`：不受阈值影响。
+- Alpha URL/stateful continuation 与 capability fail-closed 修复；
+- DSH compatibility seam 收敛；
+- route / Native V2 / checkpoint typed protocol core；
+- Native retention 与 portable migration 的统一保守 token budgeting；
+- 正式安装态 settings namespace / configuration card lifecycle 修复；
+- Installed Candidate + Cross-feature QA。
 
-阈值可在插件设置页调整。
+该 stable promotion 不引入新的 runtime 行为。
 
-## 关于“缓存突然断了”
+## 30 秒开始使用
 
-需要区分两件事：
+### 1. 安装
 
-```text
-cacheRead = 0
-≠
-会话历史被删除
+```powershell
+dsh plugin --profile web add dsh-lcx-codex
+dsh web
 ```
 
-在真实 NewAPI 日志里，出现过：
+需要固定版本时：
 
-```text
-某轮：155k uncached / cacheRead 0
-下一轮：~1k new input / ~155k cacheRead
+```powershell
+dsh plugin --profile web add dsh-lcx-codex@0.4.1
 ```
 
-这说明上一轮只是 provider prompt-cache miss / eviction，完整上下文仍被重新发送，并没有发生 session compaction 或 surface replacement。
-
-真正会主动改变历史前缀的主要情况是：
-
-1. `/compact` / 自动 Native compaction；
-2. emergency tool-result pruning；
-3. 换模型 / provider / baseURL；
-4. DSH 自己发生其他 surface replacement。
-
-DSH 重启、长时间 idle、上游 cache TTL/eviction 也可能造成某一轮重新建 cache；插件无法保证第三方网关永不 evict KV cache。
+升级时请使用 DSH 官方 plugin remove/add 路径；不要为了“清理”删除用户 session 或 `$DSH_HOME/storages/lcx-codex/`。
 
-## 搜索分层
+### 2. 在 DSH Settings 启用
 
-### 1. 普通搜索：`web_search`
+第一次使用建议从最小配置开始：
 
-推荐默认使用。rc.8 会跟随当前 Agent 的 GPT Responses route。
+| 设置 | 建议 |
+|---|---:|
+| Enable plugin | **On** |
+| Use GPT Hosted Search | 需要 GPT Hosted Search 时 **On** |
+| Advanced Hosted Search | **Off**，需要高级参数再开 |
+| Alpha Search | **Off**，确认当前 route 支持后再开 |
+| Native V2 remote compaction | 上游实际支持 Native V2 时 **On** |
+| Native-first auto compaction | 使用 Native V2 时 **On** |
 
-### 2. 高级 Hosted：`websearch_gpt_advanced`
+**前提条件**
 
-仅在需要这些参数时开启：
-
-- allowed / blocked domains；
-- approximate user location；
-- `search_context_size`；
-- image search；
-- external web access；
-- return token budget。
-
-开启/关闭额外工具会改变 tool catalog，因此默认关闭以保持主会话 request schema 稳定。
+- Node.js `>=20`
+- DSH 中已有可工作的 GPT `openai-responses` route
+- 上游 endpoint 实际支持你准备启用的 Hosted Search / Native V2 / Alpha 能力
 
-### 3. Alpha：`websearch_alpha`
+### 3. 确认它真的生效
 
-面向 stateful Codex/Alpha 风格搜索：`search/open/find/click/screenshot` 等。只有 capability probe 与当前 endpoint/provider/model/schema 匹配后才注册。
+| 能力 | 应看到什么 |
+|---|---|
+| GPT Hosted Search | 普通工具入口仍是 DSH `web_search`，实际请求走当前 GPT Responses route |
+| Advanced Hosted | 启用后出现 `websearch_gpt_advanced` |
+| Alpha Web Actions | 只有 capability probe 通过时才出现 `websearch_alpha` |
+| Native V2 | compact 时出现 provider-native checkpoint 路径；普通 Basic Compaction 不会被伪装成 Native V2 成功 |
 
-## 安装
+## 搜索工具怎么选
 
-### npm
+| 你要做什么 | 使用入口 | 适合场景 |
+|---|---|---|
+| 普通联网搜索 | DSH `web_search` | 找资料、查网页、一般检索 |
+| 控制 Hosted Search 参数 | `websearch_gpt_advanced` | 域名 allow/block、近似位置、search context、图片搜索等 |
+| 连续浏览网页或 PDF | `websearch_alpha` | `search/open/find/click/screenshot` 与结构化 Web actions |
 
-稳定版：
+## 它如何接入 DSH
 
-```powershell
-dsh plugin --profile web add dsh-lcx-codex
+```text
+DSH Agent / Session / Web
+├─ web_search ──────────> LCX SearchProvider ──> GPT Hosted Search
+├─ Advanced / Alpha ────> LCX Web tools ───────> GPT Web actions
+└─ compact / replay ────> LCX Native bridge ───> Responses Native V2
 ```
 
-预发布版（当前 rc.8）：
+**DSH 是 host，LCX 是兼容扩展层。** 插件优先复用当前 DSH route 的 `baseURL`、credential reference、headers、模型与 retry policy，而不是维护第二套账号配置。
 
-```powershell
-dsh plugin --profile web add dsh-lcx-codex@next
-```
+checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与 pressure coordination 等实现细节见 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
-### 本地 RC
+## 兼容性
 
-```powershell
-dsh plugin --profile web remove dsh-lcx-codex
-dsh plugin --profile web add .\dsh-lcx-codex-0.4.0.tgz
-dsh web
-```
+当前正式稳定组合：
 
-不要为了升级删除 `$DSH_HOME/storages/lcx-codex/` 或旧 session。v3 sidecar 仍作为只读旧会话兼容层。
+| Plugin | DSH | DSH host Pi | Plugin Pi | 状态 |
+|---|---|---|---|---|
+| `0.4.1` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED STABLE** |
 
-## 推荐设置
+`0.4.1` 的 runtime 来自完整 QA 通过的 `0.4.1-pre.1`，stable promotion 本身保持 zero-functional-change。新的 DSH 版本**不会自动视为兼容**；项目会先检查受影响 seam，再按风险运行对应测试。
 
-```text
-Enable plugin                         ✅
-Use GPT Hosted Search                ✅
-Advanced Hosted Search               ❌
-Alpha Search                         ❌
-
-Native V2 remote compaction          ✅
-Native-first auto compaction         ✅
-Native threshold                     90%
-Emergency DSH prune                  95%
-web_search timeout                   240s
-```
+<details>
+<summary><strong>完整推荐设置</strong></summary>
 
-调试 Native 时可以先关闭 fallback；稳定使用时是否开启 fallback 由你决定。
+| 设置 | 推荐值 | 说明 |
+|---|---:|---|
+| Enable plugin | On | 启用插件 |
+| Use GPT Hosted Search | 按需 | 让 DSH `web_search` 走 GPT Hosted Search |
+| Advanced Hosted Search | Off | 需要高级 Hosted 参数时再开 |
+| Alpha Search | Off | capability 验证后再开 |
+| Native V2 remote compaction | On* | *上游 route 实际支持 Native V2 时 |
+| Native-first auto compaction | On | 启用自动 pressure 策略 |
+| Native threshold | 90% | 90% 开始优先 Native V2 |
+| Emergency DSH prune | 95% | 95% 才允许 emergency prune |
+| `web_search` timeout | 240 s | 避免长搜索被过早终止 |
 
-## 部署要求
+主要配置字段：`remoteCompaction`、`autoCompaction`、`fallbackToBasicCompaction`、`autoCompactionThresholdPercent`、`emergencyPruneThresholdPercent`、`webSearchTimeoutSeconds`、`advancedHostedSearch`、`alphaSearch`。
 
-- Node.js `>=20`
-- DSH `0.1.1-rc.2`
-- DSH 中已经能正常使用的 GPT `openai-responses` route
-- upstream 实际支持你启用的 Hosted Search / Native V2 / Alpha 能力
+</details>
 
-典型路径：
+<details>
+<summary><strong>常见情况</strong></summary>
 
-```text
-DSH → llm-pi-ai/openai-responses → Sub2API
-DSH → llm-pi-ai/openai-responses → NewAPI → upstream
-```
+**`web_search` 没走 GPT Hosted Search**  
+确认插件和 Hosted Search 已启用，并且当前 Agent 能解析到兼容的 GPT `openai-responses` route。
 
-插件优先复用 DSH route 的 `baseURL`、credential reference、headers 和 retry policy。
+**`websearch_alpha` 没出现**  
+这是预期的 fail-closed 行为。Alpha 必须对当前 route/schema 完成可信 capability probe 后才注册。
 
-## 发布通道
+**Native V2 没有生效**  
+确认当前 GPT Responses endpoint 实际支持 `remote_compaction_v2`。插件不会把普通 Basic Compaction 假装成 Native V2 成功。
 
-- npm stable：正式稳定版本
-- npm `next`：`0.4.0-rc.*` 预发布测试版本
+**安装成功但配置卡不可见**  
+确认安装的是 `0.4.1` 或更高版本，并重启/刷新 DSH Web；`0.4.1` 已包含正式安装态 settings lifecycle 修复。
 
-GitHub tag 与 `package.json` version 必须一致；Trusted Publishing workflow 会先跑测试再发布。
+</details>
 
-## 开发
+<details>
+<summary><strong>开发</strong></summary>
 
 ```bash
+npm run typecheck
 npm test
 npm run test:schema
 npm pack --ignore-scripts
 ```
 
-关键设计说明见 [ARCHITECTURE.md](ARCHITECTURE.md)，完整版本记录见 [CHANGELOG.md](CHANGELOG.md)。
+- 设计与协议细节：[ARCHITECTURE.md](ARCHITECTURE.md)
+- 版本变化：[CHANGELOG.md](CHANGELOG.md)
+- npm：[`dsh-lcx-codex`](https://www.npmjs.com/package/dsh-lcx-codex)
+
+</details>
 
 ## License
 
 MIT
+
+> `LCX` 只是项目名称。本项目是社区项目，不隶属于 OpenAI、DeepSeek、Sub2API 或 NewAPI。