DSH Codex Computer Use

很多事只能在图形界面里做：内部 IM、设计工具、没有 API 的老系统、系统设置……Agent 能写代码，却点不了按钮。 DSH Codex Computer Use 把 OpenAI 随 Codex / ChatGPT 桌面端发布的官方 Computer Use 引擎，作为 mcp__codex_cu__* 工具交给 DSH 里的 Agent——它能看懂窗口里的界面结构，在后台点击、输入、滚动、拖拽，不抢你的鼠标和前台窗口。

实验版（0.1.0-experimental）。与 dsh-kimi-computer-use 使用独立的工具命名空间，可以并存，按 profile 自由切换。

亮点

• 装上就能用 —— dsh plugin add 一条命令；不要求你先装 Codex 或 ChatGPT 桌面端，缺的官方组件安装时自动准备，装包时跳过了也会在首次启动时补齐。

• 能复用就不下载 —— 本机已有兼容的 ChatGPT / Codex 桌面端时，逐组件校验后直接引用，零下载；只缺哪一块才补哪一块。

• 按字节只取需要的 —— 需要下载时，用 HTTP Range 从固定的官方 ZIP 里只取运行必需的文件：约 174 MB，而不是 719 MB 的完整安装包（省约 76%）。

• 全程官方签名 —— Node、CLI、Computer Use 都来自 OpenAI 官方发布，逐文件 SHA256 + Apple 签名（Team ID 2DC432GLL2）校验；不重签名、不修改官方二进制、不绕过系统安全机制。

• 界面结构 + 截图双通道 —— 每次观察同时拿到辅助功能树（元素编号、可写字段、二级操作）和窗口截图，能按元素精确操作，也能按坐标点选。

• 自带操作 skill —— 内置参考 Codex 官方行为改写的 codex-computer-use skill：先观察再动手、每步复核、高风险操作先征得你同意。

• 不碰你的账号 —— 不读取、不复制你的 Codex 登录凭据、配置或会话；需要私有运行目录时与 ~/.codex 完全分开。

Related MCP server: blade-computer-use

Agent 能做什么

装好后直接用自然语言下指令，例如：

• 「打开提醒事项，新建列表『下周计划』，把 周报.md 里的两项逐条加进去。」

• 「在 Wea 里找到第一条未读消息，根据上下文写一段回复填进输入框，先别发送。」

• 「把系统设置里的『勿扰模式』排程改成每天 22:00 到 8:00。」

背后是这 10 个工具（参数以运行时 MCP schema 为准，详见 docs/native-tool-schemas.json）：

三步用起来

要求：Apple Silicon Mac，macOS 14.4 或更高；已安装 DSH（@deepseek-ai/dsh，Node ≥ 22.19）。

1. 安装插件（实验版请带 @experimental 标签）：

   dsh plugin --profile web add dsh-codex-computer-use@experimental

   如果 DSH 提示构建被拦截（pnpm 默认禁止安装脚本），在该 profile 的 pnpm-workspace.yaml 里允许本包后重跑：

   allowBuilds:
     dsh-codex-computer-use: true

   本机 npm 默认源是内部镜像时，可临时指定公共源：npm_config_registry=https://registry.npmjs.org dsh plugin ...。

2. 启动 DSH：dsh --profile web（或 dsh web）。几秒后 mcp__codex_cu__* 工具就会出现。

3. 首次授权：第一次操作时，按 macOS 提示给官方 Computer Use 授予「辅助功能」和「屏幕录制」权限。插件不会替你修改系统隐私设置。

想确认一切就绪，可以跑一次只读体检（不点击、不输入）：

dsh-codex-cu-doctor

轻量又可信的运行时

flowchart LR
  agent(["dsh 里的 Agent"]) -- "mcp__codex_cu__*" --> bridge["dsh-mcp-client<br/>（通用 MCP 桥）"]
  bridge --> node["OpenAI 签名 Node<br/>+ 权限代理"]
  node --> cu["官方 Computer Use<br/>client / service"]
  cu -- "辅助功能 + 截图" --> apps["你的 Mac 应用"]
  style node fill:#0A84FF,stroke:#0A84FF,color:#fff

为什么要签名 Node？ 用普通 Node 直接启动官方 Computer Use，会被 -10000 Sender process is not authenticated 拒绝。本插件用 OpenAI 签名的 Node 运行一个很小的 MCP 权限代理，再拉起官方 client；同时提供官方 CLI 路径（缺少它会报 -10005），并实现 elicitation/create 回调，使应用访问授权能在 DSH 中正常走完。

运行时从哪来，按以下顺序，能省则省：

校验什么：固定的官方 URL 与文件大小；ZIP 中央目录 SHA256；每个文件压缩数据与解压内容的 SHA256、类型、权限；组装后 Node / CLI / Computer Use 的完整 Apple 签名。任何一项不符直接失败，绝不静默降级。

• 当前兼容版本固定为 26.1007.30912（官方 ZIP），不会自动追随 latest，也不会把不同版本的组件拼在一起。清单见 runtime-source.json 与 runtime-components.json。这些 SHA256 是维护者从官方 HTTPS 下载、验证官方签名后固定的，不代表 OpenAI 发布过这份清单。

• 准备好的运行时缓存在 ~/Library/Caches/dsh-codex-computer-use/runtime，按版本分目录；临时目录验证通过后才原子发布，有跨进程安装锁，不会把半成品当成就绪。

• 本机原有的 app 被更新、删除或损坏时，引用自动失效，下次重新检测。

• 本包只分发安装器、桥接代码和 skill；Computer Use 等官方专有组件不做镜像，始终从官方来源获取。详见 依赖分发策略。

权限与安全

默认 config: {} 即可：自动准备运行时，permissionMode: allow-all——自动接受已识别的官方「应用访问」请求，不逐个应用弹窗确认。

任何模式下，账号、token、URL 跳转、未知表单和已取消的请求都会被拒绝。

请注意：放开应用访问，意味着 Agent 能读取、操作这些应用里的内容，只在你信任当前任务时使用。它不等于发送消息、删除、购买、发布等业务授权——内置 skill 会要求 Agent 在这些不可逆操作前先征得你同意。切回 prompt / deny 并重启即可收紧。

在 profile 里覆盖稳定的 row id：

- id: computer-use-codex-cu
  config:
    autoSetup: true                 # false：首次使用也不自动下载
    runtimeDir: /absolute/path/private-runtime-cache
    permissionMode: allow-all       # allow-all | prompt | deny
    allowedApps: []                 # deny 模式下的白名单（应用显示名称）
    toolCallTimeoutMs: 60000

• mode: direct 保留直连诊断模式；同时提供 appPath / nodePath / cliPath（均须为绝对路径）会跳过自动准备，但插件不会因此宣称它们是官方签名。

• 显式 codexHome 优先；自定义目录需自行满足 computer-use 的标准布局。

• 环境变量：DSH_CODEX_CU_SKIP_SETUP=1 跳过 npm 安装钩子（首次使用仍会补装）；DSH_CODEX_CU_ARCHIVE 指定本地官方 ZIP；DSH_CODEX_CU_SKIP_LOCAL=1 不复用本机已装的 app。

平时不需要手动运行；遇到问题时可用：

dsh-codex-cu-setup                 # 准备 / 补齐运行时
dsh-codex-cu-setup --check         # 只检查就绪标记，不下载
dsh-codex-cu-setup --force         # 重新校验并准备同一固定版本（完成前不影响旧缓存）
dsh-codex-cu-setup --archive /absolute/path/official-pinned.zip --skip-local   # 用同一官方 ZIP 离线准备
dsh-codex-cu-doctor                # 真实只读体检：initialize / listTools / list_apps

--runtime-dir 指定绝对缓存目录；--source-app 只接受版本和签名都正确的官方 app。

卸载与回退

dsh plugin --profile web remove dsh-codex-computer-use

卸载不会终止共享的 Computer Use 服务，也不会删除原有的 Codex / ChatGPT 安装或任何账号文件。确认没有客户端在使用后，可手动清理 ~/Library/Caches/dsh-codex-computer-use。想换回 KimiCU，切换到装有 dsh-kimi-computer-use 的 profile 即可。

开发

DSH_CODEX_CU_SKIP_SETUP=1 npm install
npm run check        # 构建 + 单元测试
npm run test:pack    # 校验发布包内容
npm run setup        # 在本机准备运行时
npm run doctor       # 真实只读体检

发布：通过 GitHub Actions 发布到 npm，使用 Trusted Publishing（OIDC）并附带 Provenance，不保存长期 npm token。

本插件代码以 MIT 许可发布（保留 KimiCU 原始归属）。MIT 不延伸到运行时下载的 OpenAI 专有组件，这些组件保留其官方版权、许可与签名。本项目是第三方互操作插件，不代表 OpenAI 或 DeepSeek 的背书、合作或长期支持承诺。

DSH App 家族

DSH App 是为 DeepSeek Harness（dsh）打造的一组客户端与插件。它们都接入你电脑上同一个 dsh——会话、模型与插件处处互通，按需组合即可。下载与文档见 dshapp.github.io。

flowchart LR
  subgraph pc["你的电脑"]
    mac["macOS App"] --> dsh(["dsh"])
    cc["dsh-chrome-control"] --- dsh
    mb["dsh-mobile-bridge"] --- dsh
    cu["dsh-kimi-computer-use"] --- dsh
    codex["dsh-codex-computer-use"] --- dsh
    cs["dsh-claude-subscription"] --- dsh
    ext["Chrome 扩展"] <--> cc
  end
  android["Android App"] --> proxy["dsh-proxy"]
  mini["微信小程序"] --> proxy
  proxy <--> mb
  style codex fill:#0A84FF,stroke:#0A84FF,color:#fff