内容
">
#-dag
###之外的完整装备 —在 [pi](https.dev) coding-agent 运行时[](LICENSE)
[](bun.sh)
[
</div>
---
## 这`oh-my-*` 传统:pi 提供极简可 agent 运行时,这个仓库给它配上**整套装备**omd** 是内置终端 agent;以下每一层 pi extension 挂载,任意 OpenAI 兼容后端可用 **自我整理的记忆**——运行时信号蒸馏成事实,跨 session 复现的事实升级为自信,
自信为下次的行为;TTL 清扫保持有界,每次校验闸。
- **DAG 执行引擎**(旗舰conductor 把任务变成有类型的节点图并发执行:五类
(command / / agent / **map**展开 / **primitive** 原语菜单含 saga 补偿)、
ready-set 就绪即跑调度、节点级、跨模型校验失败、checkpoint 断点、
SQLite 落库 + 画图、band模型路由。
- **代码级闸门而非 prompt告**——计划模式阻断写操作直到方案对齐后必验闸拦住未验证
改动命令;危险命令过 fail-closed 分类器。
- **M由**——所有 MCP server 收敛到一个按需输出卸载到可搜索沙- **17 个技能12 个 harness 技能(session 仪式/记忆/)+ 5 个 DAG 技能,
兼容aude/skills`,进化飞轮(复成功模式挖掘成新技能提案)。
> 模型是整辆车的其余部分。
## DAG 引擎
单个 agent 聊天在单一上下文窗口中串行执行一切;即席并行调用丢失结构。引擎将任务转换为**有类型的 DAG 节点图**:
```
任务 ──▶ 导演(一个 LLM 调用)──▶ 计划 { 节点,依赖 }
就绪集
┌───────────┬───────────┼───────────┬───────────┐
命令 代理 映射 原语
( (单次 (工具使用 (运行时 (锦标赛/路由器/
LLM LLM 调用) 子 分发) 比赛/升级/传奇)
└───────────┴───────────┼───────────┴───────────┘
跨
│
◀──────────┴──────────失败 → 升级 &规划
```
- **,一个故障边界** —— 一个失败的节点在下游成为]` 输入;其余节点继续运行。节点在其依赖结算。
- **`映射点** —— 当计划列表未知时,列表运行时发现它,模板项目印出一个子节点,具有稳定的可恢复 ID。
-类型的原语菜单 导演 *选择*的控制流
并行`、`管道`、`锦标赛`、`路由器`、`比赛`、`升级`、`传奇` 带有反向补偿),每个单元上限和故障关闭。
- **信任是外部的** —— 计划经过 Zod 验证;跨模型怀疑者判断结果
(默认为 *失败*,当不确定时);只有在失败时才会升级到更强的模型,并且前提是您配置了一个。
- **记录和可恢复** —— 计划、每个节点的 结果和令牌使用情况存储在 SQLite 中;
工件哈希检查点允许重新运行跳过已完成的节点;`planToMermaid()` 绘制任何运行;ε-贪婪强盗学习每个节点类型哪个配置的模型值得。
## 快速开始
```bash
git clone https://github.com/AbyssCN/oh-my-dag.git oh-my-dag
cd oh-my-dag
bun install
# 任意支持的/OpenAI 兼容后端 - 没有默认配置
export OMD_RUNTIME_PROVIDER=deepseek
export OMD_RUNTIME_MODEL=deepseek-v4-pro
export DEEPSEEK_API_KEY=sk-...
bun run omd # 交互式终端代理
bun run omd -p "..." # 一次性,非交互式
```
或 `bun run init` 进行交互式向导。`bun link` 将 `omd` / `oh-my-dag` 放入您的 PATH。配置存储在 `.env` 中 - 复制 [.env.example](.env.example)。
旧版 `XIHE_*` 环境变量仍然被接受。需要 [Bun](https://bun.sh) ≥ 1.3。
### 在 TUI 中
| 命令 | 运行内容 |
|---|---|
| `/cg <问题>` | 并行代码检索 DAG:同步 → 并发查询节点 → 合成 |
| `/audit` | 多镜头安全/质量审计作为代理节点 DAG |
| `/sast` | 并发 semgrep 命令节点 → 报告合成 |
| `/iterate <任务>` | 完整 DAG 在不动点循环中,直到收敛判断通过 |
| `shift+tab` | 计划模式:只读审议,写入被代码阻止 |
| `/recall` · `/cost` · `/mcp` | 记忆回忆 · 成本账本 · MCP 路由 |
### 从 shell(无需 TUI)
| 命令 | 运行内容 |
|---|---|
| `bun run dag-research "<问题>"` | 搜索 + 分层爬取 → 多镜头分发 → 判决答案,零损失工件 |
| `bun run dag-council <goal.json>` | 导演自动授权 N 个人 → 并发候选人 → 判决 + 嫁接 |
| `bun run dag-fanout <spec.json>` | 手写镜头规格,直接到分发(手动变速箱) |
| `bun run dag-review --2` | 对多维差异审查,验证/驳斥收敛 |
bun run dag-build "<目标>" --oracle-cmd "…"` | 导演计划 → 代理离开构建并发 → 神谕门 → 治愈不动点,可恢复 |
都有 `--help`;[skills/](skills/) 中的匹配技能记录了该学科。
## 状态 - 今天的现实
诚实胜过营销。如 v0.2:
| 功能 |
|---|---|
| 导演 → 有类型计划绪集并发调度 | ✅ 已交付 |
| 执行器命令 / 内部处理 / 代理 / 映射 / 原语 | ✅ 已交付 |
| 控制流原语菜单(锦标赛,路由器,比赛,升级,传奇...) |交付(模式验证,单元上限,故障关闭) |
点级故障边界;文件生产者防护 | ✅ 已交付 |
| 跨模型验证器仅在失败;多镜头验证 / 无偏见的裁判 | ✅ 已交付(需要第二个提供者密钥) |
| 不迭代(`/iterate`)+ 发现循环 | ✅ |
| 运行记录(SQLite)+ 节点级检查点/恢复(工件哈希) | ✅ 已交付 |
| 强盗模型路由(按节点类型,持久化) | ✅ 已交付(单个模型时无操作) |
| 自我整合记忆(信号 → 梦想 → 提升事实)+ 回忆 | ✅ 已交付 计划模式(只读门,决策账本,N 中取优) 已交付 |
| 编辑→验证工具门 | ✅(`OMD_VERIFY_GATE=0` 禁用| MCP 路由 + 输出沙箱 | ✅ 已| 17 技能包 + 技能飞轮 → 提出) | ✅ 已交付 |
| DAG → 渲染(`planToMermaid`) | ✅ 已交付(API;TUI `/dag` 命令计划中 计划模板 / 重放记录的计划运行 | 🚧 路线图 |
| 持久化跨进程工作流存储(租赁/CAS,节点级精 | 🚧 路线图 |
## 设计规则
可靠性在模型之外。** 验证计划、代码强制、
默认失败的验证器、验证门后的。
- **宽度优于深度。** 并行隔离都来自宽度。
- **只为失败付** 廉价模型有效;升级是可选的,由验证失败触发,而不是由感觉触发。
## 许可证
MIT - 请参阅 [LICENSE](LICENSE)。
---
---
<div align">
# 中文
### 模型之外的完整 跑在 [pi](https://pi.dev) coding-agent 运行时上。
</div>
## 这是什么
-my-*` 传统:pi 提供极简可 agent 运行时,这个仓库给它配上**整套装备**。
**omd** 是内置终端 agent;层都以 pi extension 挂载,任意 OpenAI 兼容后端可用。
- **自我整理的记忆**——蒸馏成事实,跨 session 复现的事实升级为自信,
落地为下次的行为;TTL 清扫保持有界,每次写入闸。
- **DAG 执行引擎**()——conductor 把任务变成有类型的节点执行:五类执行器
( inproc / agent / **map** / **primitive** 原语菜单含 saga回滚)、
ready-set 就绪调度、节点级故障边界、跨模型校验失败才升级、checkpoint 断点续跑、
SQLite 落库 + Mermaid 画图、bandit 模型路由。
- **代码级闸门而非 prompt 劝告**——计划模式阻断写操作直到方案对齐;写后必拦住未 改动命令;危险命令过 fail-closed 分类器。
- **MCP 路由**——所有 MCP server 收敛到一个按需菜单,大输出卸载搜索沙箱。
- **17 个技能12 个 harness 技能(session 仪式/验证/审查)+ 5 个 DAG 技能,
`.claude/sk,配自进化飞轮(复现的挖掘成新技能提案)。
>引擎,这里是整辆车的其余## 快速开始
见上方英文:`bun install` 后设 `OMUNTIME_PROVIDER/MODEL` + 后端`bun run omd` 启动(旧HE_*` 环境变量仍兼容)。T `/cg` `/audit` `/iterate`命令、shell bun run dag-research|dag-council|dag-fanout-review|dag-build`。
## 现状实版)
上方 Status 表为准:DAG 引擎全链路(五类执行器、原语菜单、校验升级、不动点断点续跑、bandit 路由)、记忆层、计划模式、写后必验MCP 路由、17 技能
**已交付**;计划模板重跨进程持久化工作流存储——**图上**。
## 设计准则
可靠性