Ordewell 多智能体任务编排工具 – 概述与核心功能
Ordewell 的作用 —— 将单一目标转化为可编辑的多智能体计划
Ordewell 将自然语言目标转换为类型化计划，其中每个任务都明确指定运行者、模型、思考力度和模式。计划在消耗任何 token 之前均可编辑，使开发者能够为每个任务选择合适的模型、重新配置依赖关系，并在不丢失已完成工作的情况下添加或删除步骤。
- 计划器在只读探索环境中运行：它可以查询仓库、提出澄清问题，然后将其最终计划作为最后一则消息输出。
- 执行阶段会为每个 AI 任务启动独立的编码智能体会话，遵循依赖图并利用运行者输出中的唯一标记来验证完成状态。
- 手动任务以待办事项列表形式呈现，用户可自行标记为完成。
- 计划器无需额外 API 密钥；它可复用你已有的 Claude Code、Codex 或 OpenCode 订阅。
- 内置支持多种运行者，可通过插件清单添加更多运行者。
快速入门 – 安装并运行终端 UI
npm install -g ordewell
ordewell # 启动全屏 TUI
- 首次启动时会提示你选择一个计划器和一个或多个运行者（例如 Claude Code、Codex、OpenCode）。无需预先提供 API 密钥。
- 使用
npx ordewell（无需全局安装）或 VS Code 扩展（code --install-extension ordewell.ordewell）也可实现相同流程。 - 对于无头自动化，每个斜杠命令也是子命令；设置
AI_PROVIDER或相应的*_API_KEY环境变量，即可在无 UI 的情况下运行ordewell plan … && ordewell run。
核心概念与工作流程
- 目标定义 – 提供自然语言描述，例如："为公共 API 添加速率限制"。
- 计划器研究 – 计划器只读读取仓库，提出澄清问题，并收集证据。
- 计划生成 – 生成一个有序任务列表，每个任务均标注运行者、模型、努力程度和模式。该计划是可编辑的类型化产物。
- 执行 – 独立任务并行运行（默认最多 3 个并发会话）。每个 AI 任务在独立会话中运行；手动任务变为待办事项列表。
- 判定引擎 – 仅当运行者输出中出现唯一完成标记时，任务才被标记为 PASS。退出码将保留作为诊断证据；任务可手动标记为 完成 或 未完成。
三种用户界面，一个核心引擎
| 界面 | 主要使用场景 |
|---|---|
| VS Code 扩展 | 集成式流式时间线、实时研究步骤和可展开的任务卡片。支持就地重定向运行者和模型。 |
| 终端 UI (TUI) | 全屏、键盘驱动的工作流，适用于 SSH；tab 键可在聊天和计划面板间切换，单键快捷键驱动计划（例如 f 启动，E 运行全部）。 |
| CLI | 可脚本化、无头自动化；所有 UI 操作均可作为子命令使用（ordewell plan、ordewell run、ordewell task-runner）。 |
所有界面共享相同的底层包（core/、cli/、vscode/、web/），并通过本地守护进程（ordewell web --daemon）通信，该进程暴露 JSON-over-WebSocket API。
配置要点
| 设置 | 默认值 | 效果 |
|---|---|---|
提供商密钥（OPENROUTER_API_KEY、ANTHROPIC_API_KEY 等） |
— | 用于所选 AI 提供商；Ordewell 会根据设置的密钥自动检测提供商标识。 |
ORCHESTRATOR_MODEL |
deepseek/deepseek-v4-flash |
用于研究和计划生成的计划器模型。 |
ORDEWELL_PLANNER_EFFORT |
— | 编码智能体计划器的努力级别（例如 high、low）。 |
ORDEWELL_MAX_PARALLEL |
3 |
最大并发 AI 任务会话数（1–5）。 |
环境变量可通过 ordewell key set …、ordewell model set … 或 VS Code 设置面板设置。更改立即生效，无需重启守护进程。
可扩展性 – 自定义运行者与插件
- 内置运行者包括 Claude Code、Codex 和 OpenCode。
- 通过创建插件清单（
ordewell plugins create my-runner）并从 Git URL 安装（ordewell plugins install github:user/repo）可添加额外运行者。 - 插件可托管在 GitHub、GitLab、Bitbucket 或 Codeberg；其他来源需本地克隆。
社区反馈来自 Hacker News
@ramon156: “我希望能有一个确定性程序，能自信地为像 DeepSeek 这样的低成本模型制定计划。虽然 LLM 部分无法确定，但这样更容易衡量质量。” – 突显了对使用预算模型实现可复现计划的需求。
@Lalabadie: “我打开页面是想找一个差异化点，但整个项目（包括作者回复）都是 AI 生成的。” – 指出项目文档高度由 AI 生成，可能影响信任度。
@sharathr: “你试过 https://github.com/highflame-ai/codeoid 吗？” – 建议对比一个替代的代码生成工具。
@ac‑ciano: “[dead]” – 表示原始作者评论已被删除，未提供额外信息。
平台支持与 Windows 注意事项
| 平台 | Linux | macOS | Windows |
|---|---|---|---|
| VS Code 扩展 | ✅ | ✅ | ✅ |
| API 服务器 | ✅ | ✅ | ✅ |
| CLI | ✅ | ✅ | ✅ |
| TUI（需 tmux） | ✅ | ✅ | 需 WSL |
- TUI 依赖 tmux 为每个任务提供终端；请通过包管理器安装（
apt install tmux、brew install tmux）。 - 在 Windows 上，使用原生安装程序运行代理 CLI，以避免大型系统提示中的
.cmd代理限制。 - 确保安装 Git for Windows，以保证计划器只读 shell 命令（如
ls、grep等）行为一致。
架构快照
packages/
├─ core/ # 纯 TypeScript：Session、PlanStore、Planner、Orchestrator、VerdictEngine
├─ cli/ # TUI、plan/run/status 命令、轻量终端驱动
├─ vscode/ # 扩展 UI、流式计划时间线、任务卡片
└─ web/ # Hono HTTP + WebSocket 守护进程（127.0.0.1:3742）
TUI 核心是一个纯还原器，返回 {state, effects}，渲染器每行输出一个字符串，确保 UI 逻辑可测试且与 UI 无关。
许可证
Ordewell 采用 Apache License 2.0 发布。名称和标志不包含在许可证范围内，详见 NOTICE 文件。
Sources
相关
- 项目
- 项目
- 项目
- 项目
- 项目