tutorial

command
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT Imports: 5 Imported by: 0

Documentation

Overview

教程:从零理解 omnix 的 Agent 内核(参考实现 × 教学示例)。

本示例的定位不是"教你跑通",而是——当你想搞懂一个 Agent 框架内部 到底怎么运作时,omnix 作为一份"可读的来源",比黑盒框架更适合入门。 它把官方 DeepSeek Harness 的核心概念翻译成了 Go 代码,且刻意保持模块 小而独立。

我们按三条主线渐进理解,每一条都能独立运行:

第 1 步  事件溯源(Event Sourcing):为什么"只记事件不记状态"更稳。
第 2 步  fold 派生投影:状态从事件日志里"算"出来,而不是"存"出来。
第 3 步  Goal 状态机:Agent 如何把"目标"变成可续轮的可执行循环。

运行方式(仓库根目录):

go run ./examples/tutorial

建议对照阅读源码:

  • pkg/session/session.go 事件日志与 45+ 事件词汇
  • pkg/session/fold.go fold 投影函数族
  • pkg/goal/goal.go Goal 状态机(active/paused/blocked/complete)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL