用途：把 PLAN.md（≥3 个任务）拆成依赖图，依赖关系以数据形式存于 graph.json，用确定性工具回答 5 个问题（某任务需要什么、什么可并行、依赖什么、为何存在、与谁相关），按拓扑层加锁、租约、generation 派发任务，状态以 append-only 的 events.jsonl 持久化，并对模型回答按带来源的评分标准打分。
主要能力：build 生成 graph.json 并报告环、推断依赖、并行节点写同一文件的冲突；ask 回答 5 类问题；next/lock/set/run 按拓扑层调度；verify 与可选 QC 独立复核；audit 重开每个来源；graph-viz.py 与 graph-atlas.py 生成 HTML 图与 2D 图谱；支持 --parent 嵌套子图、add-node 追加任务、sync-orca 单向镜像。
使用方式：先有 PLAN.md，再运行 python3 harness/scripts/orca-graph.py build <PLAN.md>；引擎未安装时按提示执行 curl -fsSL https://raw.githubusercontent.com/Rheinmir/orca-graph/main/install.sh | bash，或直接调用 ~/.orca-graph/bin/orca-graph。
限制：仅面向单机文件式场景；不支持 PostgreSQL ledger、secret gateway、预算、LangGraph、进程级沙箱等；depth ≤ 6、每图 ≤ 20 节点；atlas 超过约 500 节点需 graphviz；allow-list 只检查文件系统，不覆盖网络、进程与密钥访问；无法自动回滚半途失败的 agent。
分类：编程与开发。