kk3ya03-star/dsh-lcx-codex

简体中文 · English · Architecture · Changelog

DSH 仍然是 host。LCX 只补齐 GPT Responses 路径缺失的原生能力，不修改 DSH 核心，也不替换 Agent / Session / Web / Compaction。

当前稳定版

0.4.1 是当前稳定版，也是此前完成完整 Installed Candidate / Cross-feature QA 的 0.4.1-pre.1 的 zero-functional-change stable promotion。

dsh plugin --profile web add dsh-lcx-codex
dsh web

npm latest 指向 0.4.1。历史 prelatest=0.4.1-pre.1 与稳定版使用相同的已验收 runtime 基线；新用户直接使用 latest 即可。

它解决什么

如果你的 DSH 已经有一个可工作的 GPT openai-responses route，dsh-lcx-codex 会在保持 DSH 原有入口和生命周期的前提下补齐 Responses 能力。

目标不是再造一套 Agent，而是让 DSH 的 GPT route 用上它本来就应该拥有的原生能力。

三大能力

1. GPT Hosted Search：普通搜索不换入口

启用后，模型看到的普通搜索工具依然是 DSH 原生 web_search。LCX 替换的是 SearchProvider 路径，而不是再注册一个重复的普通搜索工具。

需要更细控制时，再单独启用 websearch_gpt_advanced。

2. Codex 风格 Web Actions

websearch_alpha 面向连续浏览和结构化 Web action：

search → open → find / click → screenshot

它默认关闭，并且只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署采用 fail-closed，不会被误报成“支持 Alpha”。

0.4.1 已包含此前 prerelease 验收通过的 URL/stateful continuation 和 capability fail-closed 修复。

3. Native V2 Compaction

LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactable range、/compact、durable session transaction、tool-result pruning 与 overflow recovery；LCX 只在已有 compaction LLM seam 上请求 Responses Native V2。

默认自动策略：

0% ─────────────────── 90% ───── 95% ───── 100%
       normal            Native      emergency   hard cap
                         V2          DSH prune

• 90%：优先尝试 Native V2。
• 95%：才允许 emergency DSH prune。
• provider-confirmed context overflow：继续使用 DSH 原有恢复逻辑。
• 手动 /compact：继续使用 DSH 原生会话事务。

同一 source session 可以继续复用自己的 Native checkpoint；fork 或模型/route migration 不会跨 session 发送 parent opaque state，而是走 portable migration；重启后从 DSH session log 恢复。

0.4.1 相比 0.4.0

0.4.1 将此前 0.4.1-pre.1 的已验收改动正式提升到 stable：

• 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. 安装

dsh plugin --profile web add dsh-lcx-codex
dsh web

需要固定版本时：

dsh plugin --profile web add dsh-lcx-codex@0.4.1

升级时请使用 DSH 官方 plugin remove/add 路径；不要为了“清理”删除用户 session 或 $DSH_HOME/storages/lcx-codex/。

2. 在 DSH Settings 启用

第一次使用建议从最小配置开始：

前提条件

• Node.js >=20
• DSH 中已有可工作的 GPT openai-responses route
• 上游 endpoint 实际支持你准备启用的 Hosted Search / Native V2 / Alpha 能力

3. 确认它真的生效

搜索工具怎么选

它如何接入 DSH

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

DSH 是 host，LCX 是兼容扩展层。 插件优先复用当前 DSH route 的 baseURL、credential reference、headers、模型与 retry policy，而不是维护第二套账号配置。

checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与 pressure coordination 等实现细节见 ARCHITECTURE.md。

兼容性

当前正式稳定组合：

0.4.1 的 runtime 来自完整 QA 通过的 0.4.1-pre.1，stable promotion 本身保持 zero-functional-change。新的 DSH 版本不会自动视为兼容；项目会先检查受影响 seam，再按风险运行对应测试。

npm run typecheck
npm test
npm run test:schema
npm pack --ignore-scripts

License

MIT

LCX 只是项目名称。本项目是社区项目，不隶属于 OpenAI、DeepSeek、Sub2API 或 NewAPI。