授权与配置

插件遵守 DSH 的会话权限。桌面访问不受工作区目录限制，因此处于 read-only / workspace-write 的会话会请求本次桌面操作授权。Codex 的首次应用授权还会通过 DSH 单独确认；该授权按 DSH 会话和原生应用标识保存于内存，重启或卸载后清除。

发送、提交、删除、付款、共享等要求当次确认的操作，使用 confirm: true 和具体 reason。这一参数由调用方按任务选择；插件不能仅从一个鼠标坐标判断所有业务后果。

应用授权不受普通工具审批策略 never 影响。0.1.4 默认打开独立 Windows 窗口，点击「允许本次会话」即可。点击「拒绝」、按 Esc、关闭窗口、取消任务或窗口进程异常退出均不批准访问。confirm: true 在完全权限下也使用独立窗口，仅允许本次操作，不缓存。插件不会改写会话或全局权限策略；工作区和只读模式仍遵守原有桌面访问审批。

独立窗口显示在运行 DSH 的 Windows 桌面上，由 Windows PowerShell 和 WinForms 提供，不需要安装额外组件。若宿主没有交互桌面或系统策略禁止该脚本，可设置 approvalUi: dsh，在 DSH 桌面或 Web 的问答卡片中确认。插件不会绕过系统的 PowerShell 执行策略。无人应答时不会自动批准；子代理应将首次授权请求交回主会话。

插件条目支持以下配置；均可省略：

- id: dsh-codex-computer-use
  config:
    timeoutMs: 30000
    observationTtlMs: 120000
    approvalUi: window # window：独立窗口（默认）；dsh：聊天内问答卡片
    # skyDir: 'C:\...\node_modules\@oai\sky'
    # codexPath: 'C:\...\codex.exe'
    # allowedApps:
    #   - 'process:C:\Windows\System32\notepad.exe'

skyDir 指向 @oai/sky 的包目录，也可设置环境变量 DSH_CODEX_SKY_DIR。默认从 %LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node 查找最新安装目录。allowedApps 使用 list_windows 或 list_apps 返回的完整应用标识；空数组表示不额外限制应用列表。

codexPath 或 DSH_CODEX_CLI_PATH 可指定 CLI 的绝对路径。默认优先使用有效的 CODEX_CLI_PATH，然后查找 %LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe，最后检查进程 PATH；自动查找会跳过不完整安装。路径只写入插件的独立工作进程。

若旧版出现 failed to launch codex app-server: program not found，更新到 0.1.2 并重启 DSH。该错误不要求你手动打开 Codex，也不能通过改成“免批准”解决。

安装

说明文档

授权与配置