AI 编码工作流

概述

OpenVort 的 AI 员工可以实际编写代码，不仅仅是在聊天中贴代码片段。编码能力通过两种方式实现：工作电脑（Docker 容器）直接编码，以及编码沙箱隔离执行。

两种编码模式

模式一：工作电脑编码

AI 员工绑定工作电脑后，直接在 Docker 容器中操作：

node_file_read → 阅读代码
node_file_write → 修改文件
node_shell → 运行测试、编译、git 操作

代码持久化在 /workspace 中，跨会话保留。这是主要推荐模式。

模式二：编码沙箱

为没有工作电脑的 AI 员工提供临时隔离环境：

用户消息 → AI 决定使用 git_code_task 工具
  → 检测编码环境 (Docker 是否可用)
  → 创建临时沙箱容器
  → 克隆代码、编码、测试
  → 提交并推送
  → 销毁沙箱

编码环境检测

系统启动时自动检测可用的编码环境：

根据检测结果，系统自动选择最佳执行模式：

编码 CLI 工具

AI 员工可以在工作电脑上安装和使用编程 CLI 工具来处理复杂编码任务：

AI 员工使用 CLI 工具的方式：

张小明: 这个功能改动比较大，我用 Claude Code 来处理。
  [在工作电脑上操作中...]
  $ claude -p "为用户模块添加手机号登录支持" --output-format stream-json
  ......

张小明: 改好了，涉及 4 个文件。我跑一下测试。
  $ python -m pytest tests/test_auth.py -x
  全部通过。

沙箱安全

编码沙箱有以下安全措施：

完整编码流程

以 AI 员工修复 Bug 为例：

1. 用户: "登录页验证码不刷新，帮我修一下"

2. AI 理解意图 → 决定需要编码

3. 在工作电脑上操作:
   $ cd /workspace/project && git pull
   $ node_file_read: web/src/views/login/Index.vue

4. AI 分析代码 → 定位问题

5. 创建分支:
   $ git checkout -b fix/captcha-refresh

6. 修改文件:
   node_file_write: web/src/views/login/Index.vue

7. 验证修改:
   $ cd web && npm run build

8. 提交推送:
   git_commit_push: "fix: 修复验证码不刷新问题"

9. 创建 PR:
   git_create_pr: fix/captcha-refresh → main

整个过程 AI 员工边做边向用户汇报进度。

配置编码环境

CLI 命令

openvort coding setup    # 配置编码环境（构建沙箱镜像等）
openvort coding status   # 查看编码环境状态

Docker 沙箱模式

通过环境变量控制沙箱的使用策略：