前言¶

用 DeepSeek Harness（DSH）时，如果同时开着 OpenAI Codex 桌面应用，想确认它是否在跑、或要整应用重启一下，往往得切到任务管理器搜 codex.exe 或相关进程名。Codex 商店版主进程甚至可能是 ChatGPT.exe，单靠进程名并不稳。

社区插件 whitesandshi/dsh-codex-control（目录分类：客户端）在 Harness 会话输入框下方增加一行控件：显示 Codex 是否在运行，并提供重启、关闭；也可通过智能体工具 codex_control 走同一套逻辑。下面按安装、界面行为、配置与限制说明用法。

这是什么¶

维护者 whitesandshi。包名 @local/codex-control，版本 1.0.0（见仓库 package.json），许可证 MIT。

插件定位：Host 提供本机 HTTP 路由与工具，Client 在 conversation.composer.dock 轮询并渲染按钮。它不负责替代 Codex 本身，只解决「在 DSH 里一眼看状态、少开任务管理器」这一件事。

核心功能¶

界面示意（README 原文）：

● Codex 运行中 · 17 个进程                    [重启] [关闭]

已核实能力如下：

1. 状态：每 4 秒读一次 Codex 相关进程，显示运行中或未运行。
2. 重启：先对主窗口走正常关窗（CloseMainWindow）；3.5 秒内未退出则结束整个进程树，再重新拉起 Codex。
3. 关闭：第一次点「关闭」后需第二次「确认关闭」，降低误触；关窗与强杀顺序与重启前相同。
4. 智能体工具：codex_control，参数 action 为 status、stop 或 restart，与按钮共用 Host 逻辑；可对智能体说「重启 Codex」一类指令。

Windows 侧识别逻辑（README）：用 Get-AppxPackage OpenAI.Codex 取安装目录，目录内进程加上名为 Codex.exe / codex.exe 的进程；商店包路径通常在 C:\Program Files\WindowsApps\OpenAI.Codex_<版本>_x64__<商店 ID>。启动通过 Get-StartApps 解析 AppUserModelId，再用 explorer.exe shell:AppsFolder\<AUMID> 激活，因商店应用不宜直接运行 exe。

安装与启用¶

环境要求（README）：Windows 10/11、Windows PowerShell 5.1（系统自带）、已安装 Codex 桌面版（商店版默认识别；其他安装方式需配置 startExe）。

1. 将仓库下载或放到本机目录，例如 D:\tools\dsh-codex-control（README 示例路径；请改为你的实际绝对路径）。
2. 在 DSH 中让智能体安装为 bundle，安装命令须与文档一致：

   plugin_manager install_bundle  target: <仓库绝对路径>

也可手工在 cordis.patch.yml 中增加一行，包名为 @local/codex-control。
3. 打开任意会话，输入框下方应出现该行控件；若未出现，刷新 Harness 页面。

插件以当前 DSH 进程权限在本机执行 PowerShell 脚本；安装前建议阅读仓库源码与 MIT 许可证，确认与本机安全策略一致。

典型用法¶

Composer 控件：打开会话后查看圆点与进程数文案，按需点「重启」或两次确认「关闭」。

智能体工具（与按钮同逻辑）：

• action: status — 查询是否在运行
• action: stop — 关闭
• action: restart — 重启

可选配置：在 cordis.patch.yml 对应行的 config 中可写：

- insert:
    - id: codex-control
      name: '@local/codex-control'
      config:
        appName: OpenAI.Codex        # 商店包名
        startExe: ''                 # 非商店版：直接指定要启动的 exe
        startTimeoutMs: 25000        # 启动后等待进程出现的上限（毫秒）

仓库主要文件：index.js（Host 路由 GET/POST /codex-control、codex_control）、client.js（dock 控件）、scripts/codex-probe.ps1 / codex-stop.ps1 / codex-start.ps1。

适用场景与注意¶

适合在 Windows 上长期用 DSH，且经常需要重启 Codex 桌面版（更新、卡死、多进程堆积）的开发者。不适用 macOS / Linux：README 明确仅 Windows。

需注意（README「已知限制」）：

• 非 MSIX 安装必须配置 startExe。
• 关闭会结束终端里的 codex.exe 会话，与完全退出 Codex 含义一致，未保存输入可能丢失。
• 最坏情况下一次关闭约 12 秒（等关窗 3.5 秒 + 等强杀最多约 8 秒）。
• 状态轮询走本机 HTTP 路由，不经过 DSH Remote 通道；路由仅监听本机，但同机其他进程理论上可访问该路由。

DSH 生态沿用「一切皆插件」思路；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系，本文不以「官方应用商店」表述。

结尾¶

经过上面的步骤，你可以在 Composer 底部直接看到 Codex 是否在运行，并用重启或确认关闭替代反复打开任务管理器。进一步细节与英文说明见仓库 README。

• 目录页：https://www.skillhub.cn/plugins/whitesandshi/dsh-codex-control
• GitHub：https://github.com/whitesandshi/dsh-codex-control