跳到主要内容

在 Codex 中使用 ConsoleX 任务

Codex 可以在你的电脑上执行任务;提交交付物后,ConsoleX 记录结果,并在开启自动验收时按保存的标准检查。连接需要付费套餐。Codex 使用自己的模型和账号;ConsoleX 验收与工具调用使用 ConsoleX 套餐用量或 Credits。

安装与连接​

  1. 安装 Codex、Git 和 Python 3.9 或更高版本。在 ConsoleX 中打开 设置 → 编码代理,选择 Codex,将两条命令复制到终端执行:

    codex plugin marketplace add EvalsOne/consolex-codex-plugin
    codex plugin add consolex@consolex-codex
  2. 新建一个 Codex 对话并发送一条消息以完成准备。插件会安装钩子、命令 Skill 和本地 MCP 服务。

  3. 再新建一个对话,打开 /hooks 或 Settings → Hooks,审核并信任 ConsoleX 钩子,然后运行 $consolex-login,在浏览器中确认匹配的验证码。$consolex-status 可查看连接状态。

如果这台电脑已将其他 ConsoleX 地址设为默认连接,请运行 $consolex-login https://api.consolex.ai 切回生产环境。

运行任务并验收​

在任务列表或运行历史中打开 运行,选择 在编码代理中运行…,切换到 Codex,将 $consolex-start <任务 UUID> 粘贴到 Codex。UUID 可以区分同名任务。

看 Codex 如何把三份笔记整理成每周简报。第一次交付漏了 TL;DR,用户确认修改后,第二次交付通过。画面取自开发环境的示例会话和验收报告,配有背景音乐,无旁白。
  • 重复使用:$consolex-add <任务 UUID> 会为任务添加一个 $cx-… 快捷方式。添加不会运行任务。
  • 停止运行:在这次 Codex 对话里说"停止制作"。这次运行会记为已中断,不做交付验收。

提交交付物后,Codex 会显示结论;验收通过时还会附上回执和这次运行的链接。在 运行历史 查看结果和验收报告。未通过或不确定的检查会等你决定,除非开启了自动修订。详见一次运行如何验收。

把会话存成任务​

在 Codex 中输入 $consolex-save [任务名称]。打开审核链接,检查任务要求、Skill 和验收标准,然后点击 创建任务。保存后,任务快捷方式通常会自动添加到这台电脑。

这个任务的做法保存在本地 Skill 中,在 Codex 里运行。想改做法就修改这个 Skill;交付目标、运行规则和验收标准在 ConsoleX 中修改。详见两类任务。

定时运行​

在 Codex 应用中打开任务的工作文件夹,运行任务运行面板或设置中提供的命令,例如:

$consolex-schedule <任务 UUID> 每个工作日 09:00

如有需要,它会先在本地添加任务。到点时保持应用开启。在 Codex 中修改或停止定时;换地方定时之前,先在这里停掉。

命令​

命令作用
$consolex-login连接这台电脑
$consolex-status查看连接状态和本机已添加的任务
$consolex-tasks列出或搜索你的任务
$consolex-start在当前对话中开始任务
$consolex-add、$consolex-remove添加或移除任务的 $cx-… 快捷方式
$consolex-save把这次会话存成任务
$consolex-schedule在 Codex 应用中给任务定时
$consolex-logout断开这台电脑的连接

遇到问题时​

  • 找不到命令或钩子:在新对话中发送消息以完成准备,再打开另一个新对话并审核 ConsoleX 钩子。更新导致钩子变化后也需要重新审核。
  • 账号或任务不对:使用 $consolex-status 和 $consolex-tasks 检查账号和地址。浏览器验证码过期时,重新运行 $consolex-login。
  • 缺少本地 Skill:在这台电脑安装任务的主要 Skill,或在已有该 Skill 的电脑上运行。
  • 无法使用 ConsoleX 工具:检查任务的工具权限及所需连接;部分工具和 Skill 不能通过此集成使用。

更新或卸载。 更新时运行 codex plugin marketplace upgrade consolex-codex,新建对话以刷新安装,再在另一个新对话中审核变更的钩子。卸载时先运行 codex plugin remove consolex@consolex-codex,再运行 python3 ~/.consolex/codex-integration/scripts/marketplace_installer.py --uninstall;ConsoleX 登录状态会保留。安装使用默认的 ~/.consolex 和 ~/.agents/skills 目录;自定义 CONSOLEX_HOME 或 CONSOLEX_SKILLS_DIR 路径请使用独立安装程序。

能力和证据范围见在编码代理里使用任务和验收怎么用。