选 Eino 不选 LangGraph:选的是系统拓扑,不是框架能力
模块:技术路线 · 运行时选型(doc/04)|状态:已定案(2026-09-24,仍有效)|证据:
doc/04-技术路线.md、doc/08-Eino规划机制调研.md、yk-tako-eino/go.mod、yk-tako-eino/cmd/yktako
1. 场景与病灶
项目起步于「照着 Octop 复刻一个 AI 工作伙伴」。第一个必须回答的问题是:Agent 核心用什么技术栈写。 桌上两个候选:
- LangGraph.js(Node/TS):与 Octop 的 Python LangGraph 血统几乎一一对应,接近逐行翻译;owner 之前用 TS 与 Go 各复刻过一遍 pi agent,实测体感 TS 更顺手。
- Eino(Go):概念一一对应(Graph / Node / Edge / State / Checkpoint),但 API 要重写。
第一直觉选了 LangGraph.js,理由是「人的连续性」——生长式路线下,学习连续性权重最高;deepagents 的中间件矩阵在 JS 版有官方对应物,翻译最直接(doc/04 §4.1)。
然后实地 clone 了 Octop(v0.9.33),前提当场塌了:不存在「可保留的 Go 后端」。Octop 主进程是 Python 3.12+ 单进程(FastAPI + uvicorn,src 约 13.1 万行),Go 只存在于 desktop/ 桌面外壳(约 2.6k 行),Agent 核心在外部 pip 包 orcakit-harness-agent 里。
这一下把选项重排了:
| 路线 | 实际含义 |
|---|---|
| 用 LangGraph.js 复刻 | 得到一个 Python + Node 双语双进程系统:Octop 原有的 Python 应用还在,Agent 芯换成 JS。复杂度没有下降,只是换了一种双语 |
| 用 Eino 复刻 | 收敛为纯 Go 单语言,只需一种运行时;gRPC 边界最终可整个删掉 |
「翻译省力」这个好处,只在「有存量代码可翻译」时成立;存量不存在时,两条路都是全量重写,谁也没有便宜可占。
第二圈反转(同两天内)来自更深的一层:规划与执行的时序保证。L2(任务规划)调研暴露的问题是——在 LangGraph 系里,这类约束只有 middleware 一层可做文章(afterModel 之类),等于用软钩子模拟硬约束;Eino 把分界写死:Graph 管确定性、Agent 管自主性,不要用静态编排假装动态决策,要硬保证时直接编图(Workflow Agents / Plan-Execute 节点图)。后续的子代理、断点恢复、多入口都会反复碰到这条线。
2. 候选与代价
| 候选 | 做法 | 好处 | 代价 |
|---|---|---|---|
| A LangGraph.js | Octop 的 Python 图逻辑逐行翻成 TS;deepagents JS 版 | 与参考实现最贴;owner TS 手感好 | 多一种运行时(Go + Python + Node)或被迫砍掉 Go 部分;桌面/本地部署重;确定性约束只能靠 middleware 软钩子 |
| B Eino(选定) | 概念映射后按 Eino 思想重写 | 纯 Go 单语言;单二进制部署;Graph/Agent 分界是一等公民;WeKnora 同为 Go 可抄 | 不是翻译而是重写;Eino 生态较新、文档要自己读源码;先要建映射表 |
| C 保留 Octop 原栈(Python) | 直接在 Octop 上改 | 与参考实现零距离 | 主进程 13.1 万行 + 外部 pip 包,改造成本高;部署是 Python 应用形态,与「本地数字员工单二进制」目标冲突 |
| D 自研最小 loop | 不用框架,自己写 ReAct 循环 | 完全可控、依赖少 | 断点恢复、流式、子代理、MCP 适配都要自己造;这些正是框架的活 |
选 B。决定性理由不是「Eino 比 LangGraph.js 强」,而是系统拓扑:
- 目标形态是本地数字员工,Go 单二进制是硬优势;
- 收敛为一种运行时,少一条进程边界、少一套依赖与部署;
- 参考系(WeKnora)是 Go,遇到问题有两个大型 Go 项目可抄;
- 确定性 vs 自主性有正式答案,不用把约束伪装成 middleware。
代价也写清楚:复刻不是翻译,是重写;移植时先用映射表把「这个概念在 Eino 里叫什么」定位出来,再决定照抄语义还是按 Eino 正式做法重做。
3. 概念映射(移植手册)
| LangGraph (Python) | Eino (Go) |
|---|---|
StateGraph |
compose.Graph / compose.NewChain |
add_node / add_edge |
AddNode / AddEdge |
条件边 add_conditional_edges |
AddBranch(GraphBranch) |
| State(TypedDict + reducer) | 泛型 State + WithStatePostHandler / GenLocalState |
Checkpointer(PostgresSaver) |
compose.CheckPointStore 接口,需自实现存储 |
interrupt / 人机协同 |
compose.StatefulInterrupt + Runner.ResumeWithParams |
| ReAct Agent(prebuilt) | react.Agent / ADK ChatModelAgent |
| 多智能体 supervisor | Eino ADK 的多 Agent 组合 |
| 工具节点 ToolNode | compose.ToolsNode + MCP 工具适配 |
流式 astream_events |
Callbacks + StreamReader |
这张表的用法是定位,不是翻译:读 Octop / harness 的 Python 实现时,先查出对应概念,再按 Eino 的做法重写(doc/05 §翻译原则)。
4. 同族小裁定
| 小问题 | 裁定 | 代价 / 备注 |
|---|---|---|
| 唯一主线 | yk-tako-eino/ 一个 |
旧 L0–L2 五个入口与 internal/planexec 已删;TS 实现全删;maf/(.NET 对照)冻结为存档 |
| 复刻方针 | 功能翻译,按 Eino 思想写 | 不逐行搬 Python 结构;先映射再重写 |
| 记忆方案(T-Mem) | 接口先行、两期走:一期 pgvector + 简明情景表,二期再上 T-Mem | 写入成本高(多次 LLM 调用),须异步管线;接口不钉死才换得动 |
| 要不要为了省事引 TS 工具链 | 不引 | 前端是 Vue(Node 只用于构建),运行时不引第二种语言 |
| 版本基线 | go.mod = Go 1.27.0 + Eino v0.9.21 |
doc/04 §5 写的「Go 1.25」已过期,以 go.mod 为准 |
| 参考实现可信度 | 先 clone 读真代码,再判断 | Octop 案例:desktop/ 的 Go 只有 2.6k 行,不足以撑「保留 Go 后端」的论据 |
| 反转怎么记 | 保留反转记录与原因 | doc/04 §4 记了两圈反转;避免下一轮重复踩同一个前提 |
5. 证据
方案:doc/04-技术路线.md §1(两个问题)、§3.1(对比表)、§3.2(拓扑理由)、§3.3(映射表)、§4.1–4.3(两次反转:TS 手感 → 实地 clone 推翻前提 → 确定性约束回到 Eino)、§5(落点与现状);doc/08-Eino规划机制调研.md(Eino Graph/Agent 分界的调研全文);doc/05-Octop架构剖析与生长式复刻.md §翻译原则。
代码符号:
| 位置 | 是什么 |
|---|---|
yk-tako-eino/go.mod:3 |
go 1.27.0(doc/04 写 1.25,已过期) |
yk-tako-eino/go.mod:6 |
github.com/cloudwego/eino v0.9.21 |
yk-tako-eino/go.mod:7-9 |
eino-ext 的 claude / openai / officialmcp 组件 |
yk-tako-eino/cmd/yktako/ |
唯一入口(go run ./cmd/yktako) |
复核命令:
git log --oneline -- doc/04-*.md | head
grep -n "go 1\.\|cloudwego/eino " yk-tako-eino/go.mod
ls yk-tako-eino/cmd # 期望:只有 yktako
ls yk-tako-eino/internal # 期望:无 planexec现场事实(2026-09-24 调研):Octop v0.9.33 主进程 Python 3.12+(FastAPI + uvicorn,约 13.1 万行),Go 仅在 desktop/ 约 2.6k 行;Agent 核心在外部 pip 包 orcakit-harness-agent。这组数字是反转的前提,出处见 doc/08 与 ref-agent/Octop 快照。
6. 现状
- 仍有效:纯 Go / Eino 单主线;功能翻译按 Eino 思想重写;
cmd/yktako唯一入口;Graph 管确定性、Agent 管自主性。 - 已翻转:2026-09-23 的「全栈 TypeScript + LangGraph.js」作废(前提被实地代码推翻);TS 实现与
maf/不再推进。 - 待办:doc/04 §5 的 Go 版本号需要随
go.mod校准(1.25 → 1.27.0);记忆的 T-Mem 二期仍未开工。 - 同族问题:多副本目标栈(Go + PG + Redis + Vue)→ 租户并发闸放进数据库;子代理与工具边界 → 子代理规格与工具边界;RAG/记忆的定位 → 记忆要不要上向量。