技能介绍

要解决什么问题

本地想用 Codex 走 DeepSeek（例如 deepseek-v4-flash），通常得先确认 codex-bridge 代理和 Codex app-server 是否都在跑、端口是否冲突。手工 lsof、看日志、按顺序起两个进程，很容易漏一步或重复启动。

技能如何工作

触发「打开/启动 Codex」类说法后，技能会执行启动脚本，按固定顺序完成：

检查 codex-bridge（默认 4000），未运行则拉起
检查 app-server（默认 9998），未运行则拉起
验证两个服务健康后，提示用法与日志路径（如 /tmp/codex-bridge.log、/tmp/codex-appserver.log）

若服务已在运行，会跳过启动并直接告知当前状态。技能内已带 DeepSeek API Key 与 Proxy Auth Key 等配置，目的是减少首次手工填密钥的步骤（具体值以技能包为准）。

边界与注意

本技能只负责启动与校验，不替你执行 Codex 里的具体编码任务
进程会在后台持续运行，直到你手动停掉或系统重启
代理起不来时，常见原因是 Key 错误、4000 被占用；app-server 起不来时，先 curl http://127.0.0.1:4000/health 确认代理，再查 9998 占用与 app-server 日志
客户端连不上时，需确认双服务在线、客户端脚本与工作区目录是否与当前 workspace 一致

截图预览

使用场景

开机或换工作区后，要先确认 4000/9998 上的 bridge 与 app-server 都在，再连 Codex 客户端
说「启动 Codex」时，希望脚本自动补起未运行的 codex-bridge，而不是手动进 ~/codex-bridge 起进程
代理已起但 app-server 没起来，需要按顺序校验 health 并拉起 9998，避免客户端连上却报服务不可用
客户端连不上时，先让技能跑一遍双服务检查，并对照 /tmp 下 bridge 与 app-server 日志定位端口占用

适合人员

本机已配 Codex + DeepSeek，每次写代码前都要先起 bridge 与 app-server 的后端/全栈工程师
维护 ~/codex-bridge 与 Proxy Auth，不想记两套端口与启动顺序的本地 AI 工具维护者
通过 WebSocket 走 deepseek-v4-flash，频繁遇到「服务没开」却不想逐条 lsof 与 curl health 的 Codex 日常用户
负责帮同事搭 Codex 环境，需要统一用触发词一键校验并汇报日志路径的内部平台或 IT 支持