Project

myorch

由流程引擎驱动的 agent 平台
WIP 框架 AI Agent 更新于 2026-11-17 agentpythontemporaldocker

简介

一个由流程引擎驱动的 agent 平台,给想让 agent 按固定流程、在受控环境里干活的人用。写好一个流程(flow),在某个项目上发起一次运行(run),运行里的每个步骤都在一个全新的沙箱里执行:可以是一个 agent(Claude Code),也可以是一段 shell 脚本。步骤之间通过共享的工作区交接文件;遇到需要人拍板的问题或审批,运行就停下来等人。

背后的设计想法见 Agent Platform 的设计思考,完整文档在 leweii.github.io/myorch。

核心特性

一个步骤一个沙箱

每个步骤实例都跑在自己的 OpenShell 沙箱里,用完即删,从不复用。上游步骤的产物只读挂载进来,每个步骤只能写自己的输出目录;结束时写一份 manifest(状态、摘要、文件列表、给流程用的结构化输出),后面的条件、循环和审批人数都读它。

人只在需要的时候出场

  • 提问:agent 在执行中发现需要人决定的事,可以停下来提问,人在控制台、Slack 私信或命令行里直接回复
  • 审批:流程要求某一步放行前必须有人批准,审批人数可以由风险评估的结果算出来;也可以「要求修改」,让运行带着意见回到前面的循环重做
  • 循环跑满轮数仍未收敛、步骤重试用完仍然失败时,也会问人:再跑一轮、接受当前结果、重来或者给个提示让 agent 接着干

多种入口

本地 Web 控制台(myorch ui)、Slack、命令行和定时任务都能发起运行。本地的 Claude Code 会话通过 channel 接收运行结果、读日志、发起后续流程,但不能审批。控制台里还能看到定时任务和它们发起的运行,可以暂停、恢复或立即触发。

流程共享,项目差异放进项目包

development、review、learn、postmortem 等流程按角色写一份,所有项目共用;每个项目的差异(仓库、检查脚本、风险规则、项目知识、开发镜像)放在各自的项目包里。learn、postmortem 这类流程会从过往运行里提炼改进建议,人采纳后写回项目包,下一次运行就用上了。

能接着跑

失败或取消的运行可以原地恢复,已经成功的步骤和审批都保留;已经结束的运行也可以在它的基础上发起新一轮,原来的对话记录会带过去。

它是怎么工作的

自上而下分几层:

  • 入口:CLI、控制台、各个 channel,只负责读流程和项目包,通过 Temporal 客户端发命令
  • 流程引擎(第一版用 Temporal):只做适配,把执行、重试、取消和信号转成对核心库的调用,换引擎只换这一层
  • 核心库:流程定义、调度、表达式、提示词、manifest 和事件,纯逻辑、不做 IO;runner 把一个步骤变成「权限配置 + harness + 一次沙箱调用」
  • OpenShell:gateway 管理凭证、策略和沙箱生命周期;沙箱外的 supervisor 执行策略并注入凭证
  • 计算与存储:Docker 驱动,加一个共享卷,卷里的产物和 manifest 才是事实来源

凭证只存在 OpenShell gateway 里,上面各层只认 provider 的名字。沙箱里的 agent 也看不到原始密钥:它的出站请求经过沙箱外的 supervisor,由 supervisor 把凭证加上去。

技术栈

Python 3.12、pydantic、Temporal(temporalio)、OpenShell 0.1.6、Docker Compose;控制台是 Starlette + uvicorn,Slack 接入用 slack-sdk,agent 步骤用 Claude Code CLI。开发工具是 uv、pytest 和 import-linter(检查分层依赖)。

状态

第一版:单机、Docker 驱动,整套服务用 docker compose 在 macOS 上运行。2026-11-10 创建,仍在活跃开发中。MIT 协议开源。