用途:devin 以 iii functions 形式暴露 Devin 的两类能力——本地 CLI 表面与云端 REST API 表面,便于在 iii 运行时中委托编码任务、让 Devin 自动发现并操作 iii mesh,或调度云会话与 PR 评审。
主要能力:CLI 表面中 devin::run 执行一次无头回合(devin --permission-mode dangerous --print -- <prompt>),把 stdout 流到 devin::events,并在 agent::events 发出终止 AgentEvent;因运行在本地并前置 iii 运行时上下文,可用自然语言让 Devin 自行发现并操作 engine,例如运行 iii trigger engine::functions::list、调用已注册函数并回报,通过 localhost 访问 engine 而不暴露。云表面调用 Devin REST API:devin::session::create 创建自主云会话,devin::session::get 读取,devin::session::message 引导,devin::pr-review::* 执行代码评审,devin::api 访问未封装端点。
使用方式:CLI 表面需安装官方 Devin CLI(brew install --cask devin-cli)并登录(devin auth login)。云表面需 DEVIN_API_KEY,服务密钥还需 DEVIN_ORG_ID。典型用法:用 devin::run 带 prompt 与 cwd 委托本地任务,跟随 devin::events / agent::events,用 devin::stop 中断;用 devin::session::create 创建云会话后轮询 devin::session::get 并用 devin::session::message 引导;用 devin::pr-review::trigger 与 devin::pr-review::status 评审 PR;用 devin::api 传 { method, path, query?, body? } 访问其他能力。可绑定 cron 触发器调度云会话,或用 harness::spawn 并行多任务;该 worker 不重新实现调度或子代理。
限制:devin::run / devin::start 默认以 --permission-mode dangerous 无头启动本地 CLI,自动批准全部本地工具;可用 cli_extra_args 降至 accept-edits 或 auto 进行限制。devin::run 依赖官方 CLI 与登录,裸容器中不可用。云表面消耗 ACU 并改动真实 Devin 状态,且不流式返回 JSON,应轮询而非紧凑循环。变更类函数默认需审批,只读与停止为白名单。api_key 为空时禁用云表面;本地 CLI 已认证则 CLI 表面仍可用。