概览
dsh-plugin-codex-link
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **Codex 桌面端可能不会实时刷新插件新建的回合**。若刷新后仍看不到,重开该会话;后续会补 `codex queue` + rollout 增量读取的回退路径。 - **插件(含设置页面板)更新后需要重启 DSH** 才会加载新的 host/client 代码;`client.js` 由外壳在启动时注册。 - **`thread/list` 不返回空会话**:刚创建、还没有任何回合的会话不会出现在 `codex_threads` 里(Codex 服务端行为)。插件把默认会话 ID 记在绑定文件的 `__default__` 键中,避免重复新建。 - **线程级窗口聚焦没有官方 API**:`codex://` 深链在本机未注册可执行处理器,v1 只做逻辑切换与项目级窗口操作;键盘 UI 自动化留作 v2 可选(默认关闭)。 - 同一会话被桌面端和 DSH 同时写入时,以 `BUSY_THREAD` 明确拒绝,不并发抢写。 - Codex 更新会更换 bin 哈希目录;插件每次启动按 mtime 重新发现,路径失效时会再次探测。 - 审批应答按 Codex 0.165 的 `ReviewDecision` 形状(`{denied:{rejection}}`);更老版本可能需要调整。 - **Codex 自身的网络/证书问题会直接表现为回合失败**(例如 `workspace routing discovery failed`、`codex doctor` 报 provider endpoints unreachable)。这是 Codex 与网络环境问题,不是插件逻辑问题;可用 `node scripts/integration.mjs --protocol-only` 单独验证本地协议链路。
