dsh-plugin-codex-link

LIMITATIONS

Known limitations

- **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` 单独验证本地协议链路。