omnix

module
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

README

omnix

把 DeepSeek Agent 规划能力嵌入 Go 后端的进程内参考实现 · An in-process Go reference implementation of the DeepSeek Harness Agent

Go 1.25 DSH compat Event Sourcing Go Report License

English · 简体中文


omnix 是一份纯 Go、进程内的 DeepSeek Harness Agent 参考实现——它把官方 DSH 的 Turn/Step 双循环、事件溯源、Goal 规划、工具治理等核心能力接缝,逐词对译为 Go 代码,让开发者可以阅读、调试、复刻一个真实 Agent 的内部运作。

它定位为参考实现与学习素材,而非与 LangChain / Eino / 官方 DSH 竞争的生产级框架:生态、背书与多模型适配均非本文目标,本文目标是"读懂 Agent 内核"。

❓ 快速了解本项目 —— 想先弄清楚"这是什么 / 和 Eino·LangChain 什么关系 / 有什么优势 / 适合什么场景 / 值不值得用"?请直接阅读 FAQ(常见问题)。

SDK 核心链路更新:工具注册与派发、DeepSeek 流式工具调用、会话重放、取消/释放和持久化刷新已补通,见 使用说明与边界。

📖 Table of Contents

📌 Why omnix

  • 可读的 Agent 内核:官方仅有 TS 主仓与 Python minimal 版;本文用 Go 给出逐词对译的完整能力接缝,模块小而独立,适合**(对照源码)读懂**一个 Agent 的真实运作。
  • 三条学习主线:事件溯源 → fold 派生投影 → Goal 状态机,配合 examples/tutorial 三步渐进示例,是一条清晰的内核学习路径。
  • 可复现的工程实践:事件溯源增量投影(≈3437×)、连接池调优、并发加固与缓存亲和等,都带基准数据与回归用例可复现,适合作为工程范本研读。
  • 诚实边界:非生产级框架、非 LangChain/Eino 替代品;生态、多模型适配不在本文目标内。

✨ Features

  • 事件溯源会话(pkg/session):追加式日志 + 派生 fold 投影;45+ 事件词汇表;时序不变量由引擎强制。
  • Turn/Step 双循环(pkg/agent):取消 / 超时 / 追踪经 ctx 逐层传播到工具与 LLM(H01)。
  • 内建规划:Plan Mode、Goal(状态机 + 续轮驱动 + CAS + 稳定错误码)、Todo、Skills(6 层 Provider + fsnotify)。
  • 四段工具流水线(pkg/tools):pre → execute → post → result 中间件链;带 sync.Pool 与只读注册表,高并发更稳。
  • DeepSeek Provider(pkg/llm/provider_deepseek):流式 SSE + 生产级连接池 + 与官方 error.ts 对齐的稳定失败分类。
  • 30+ 能力包:文件系统、shell、子进程、spill、jobs、终端、工作区、权限、凭证、设置、子代理、工作流、MCP……
  • 可观测性(pkg/telemetry、pkg/tokenmeter):OTel 桥、会话遥测钩子、token 计量与预算、缓存指标。

🚀 Quick Start

作为参考实现,你不一定需要 go get 引入——最轻的入门方式是直接跑 examples/ 并对照源码阅读。若确实想在本项目上做实验,可这样引入:

安装:

go get github.com/herlanai/omnix@latest

最小可用示例 —— 创建会话、追加事件、派生状态:

package main

import (
	"fmt"

	"github.com/herlanai/omnix/pkg/brand"
	"github.com/herlanai/omnix/pkg/session"
)

func main() {
	sl := session.NewSessionLog(brand.NewSessionID("hello"))
	if _, err := sl.Append(session.UserMessageData{Content: "Hello"}); err != nil {
		panic(err)
	}
	proj := session.FoldAll(sl.Events())
	fmt.Printf("%d message(s) in log\n", len(proj.Messages))
}

🧭 Examples

仓库内置九个可直接运行的示例,全部零依赖可跑(除 chat 需 API Key),建议从 tutorial 开始:

go run ./examples/tutorial          # 教学三步曲:事件溯源 → fold 投影 → Goal 状态机(推荐入门)
go run ./examples/agent_loop       # 完整 Agent Turn/Step 循环(含工具续步)
go run ./examples/usage            # 会话/投影/Goal 工具/命令/DeepSeek Provider/持久化
go run ./examples/todo             # Todo 整体替换待办(规划原语)
go run ./examples/workflow         # 工作流编排:Pipeline 串行 / Parallel 并行 / Agent 步骤 / 取消级联
go run ./examples/subagent         # 子代理:多后端派生 + 家谱 + 父释放级联
go run ./examples/sandbox_approval # 沙箱(在哪儿) + 审批(能不能) 受控执行
go run ./examples/mcp              # MCP 客户端 → 工具桥(内存 Transport 模拟服务器)
go run ./examples/chat             # 真实调用 DeepSeek 大模型的多轮对话(需 DEEPSEEK_API_KEY)
  • examples/tutorial/main.go —— 教学入口:用「事件溯源 → fold 派生投影 → Goal 状态机」三条独立主线,渐进讲解 Agent 内核;每步带大量注释并对照 pkg/session / pkg/goal 源码阅读。
  • examples/agent_loop/main.go —— 装配 SessionLog + SystemPrompt + 工具流水线 + LLM 适配器,演示 Turn 内「工具续步 → 结束」。
  • examples/usage/main.go —— 事件溯源、fold 投影、Goal 工具(含稳定错误码)、slash 命令、DeepSeek 连接池与失败分类、JSONL 持久化读回。
  • examples/todo/main.go —— Todo 整体替换(last-write-wins):用 todo_write 写入待办、从事件日志派生读回、观察旧列表被整体覆盖。
  • examples/workflow/main.go —— 工作流引擎:Pipeline 串行短路 / Parallel 并发保序 / Agent 子代理步骤 / ctx 取消级联终止。
  • examples/subagent/main.go —— 子代理接缝:Runtime.Spawn 多后端派生 + ForkLineage 家谱归因 + Drain 收结果 + DisposeOwner 父释放级联 + 未知后端稳定错误。
  • examples/sandbox_approval/main.go —— 受控执行:审批三层策略解析(预设→用户→会话)+ 三态决策(allow/deny/ask)+ 危险工具 ask 的 fail-closed;沙箱模式解析与 danger 判定。
  • examples/mcp/main.go —— MCP 桥接:用内存 Transport 模拟 MCP 服务器,演示 Initialize → ListTools → Bridge.ToTools → 统一调用 → 挂进流水线 的完整链路,零网络零依赖。
  • examples/chat/main.go —— 从环境变量读取 DEEPSEEK_API_KEY,构造 DeepSeek provider,通过 LLMAdapter.Chat 发起流式多轮对话,展示 ChunkReasoning / ChunkText / ChunkToolCall / ChunkDone 分片消费、LlmFailure 稳定分类与 usage 用量统计。

🏗️ Architecture

Session (Event Sourcing) ──► fold / Projection ──► Prompt Assemble ──► Agent Turn/Step Loop
                                                                        │
                        Tool Waterfall (pre → execute → post → result) ◄─┘

每项能力都是一个 能力接缝(Capability Seam):服务定义 + Provider。替换 Provider 即改变整体行为,与官方 Capability Seam 设计一致。

📦 Package Map

Package Capability
pkg/session Event sourcing, 45+ vocabulary, fold, invariants, incremental projection
pkg/agent Agent registry, Turn/Step loop, cancel causes, request-error retry
pkg/tools Waterfall pipeline, execution context, presentation, restriction, schema, retention
pkg/llm LLM seam, stream protocol (SSE), failure taxonomy, retry, cache probe
pkg/goal / pkg/todo / pkg/plan / pkg/skills Planning primitives
pkg/persistence / pkg/storage JSONL (sharded/async) & SQLite(→FTS5) backends, CAS storage domains
pkg/subagent / pkg/workflow / pkg/mcp Subagents, workflow engine, MCP client→tool bridge
pkg/fs / pkg/shell / pkg/subprocess / pkg/spill / pkg/jobs / pkg/terminal File & process execution
pkg/settings / pkg/credentials / pkg/approval / pkg/sandbox / pkg/scope Config, credentials, safety, scoping
pkg/telemetry / pkg/tokenmeter / pkg/feedback / pkg/sessionquery Observability, metering, feedback, search

⚡ Performance

关键路径均做过并发与分配级加固(go test -bench 可复现):

场景 优化 实测
Session 派生投影(10k 事件,每步读) 增量 fold(H04) 16.9s → 4.9ms,≈ 3437×
共享注册表读(100 键 Get) Freeze 后无锁快照(H07) 65.6 → 49.4ns,快 25%,0 alloc
持久化 IO bytes.Buffer + bufio.Writer 双 sync.Pool(H05) 热路径分配显著下降
Tool 流水线 ExecContext 对象池(H06) allocs 9 → 8

📚 Documentation

  • 🌐 在线文档站(GitHub Pages):https://JopenChen.github.io/omnix/ —— 中英双语、全文搜索、教程与示例导航;基于 Hugo + Hextra,采用 DeepSeek Harness 风格 3D 玻璃拟态暗色主题(源码在 site/)。
  • Docs index —— 详细设计、任务表、缓存方案、测试用例矩阵。
  • docs/FAQ.md —— 新手 FAQ:本项目是什么、与 Eino / LangChain / 官方 DSH 的关系、审计算不算独有、适合什么场景、值不值得用。
  • docs/TASKS.md · docs/tasks.json —— 结构化任务表(机器 + 人可读)。
  • docs/TEST_CASES.md —— 328 条测试用例设计矩阵。
  • docs/CACHE_HIT_RATE_PLAN.md —— 前缀缓存命中率对齐方案。

🤝 Compatibility

  • 语言:Go 1.25+
  • SQLite:modernc.org/sqlite(纯 Go,无 CGO)
  • 上游锚点:DeepSeek Harness master @ cd5ef81(dsh-0.1.2-alpha.1)

🧑‍🤝‍🧑 Contributing

欢迎提交 Issue 与 PR。请确保改动通过 gofmt、go vet ./... 与 go test ./tests/ -count=1。

📄 License

See LICENSE.

Directories

Path Synopsis
cmd
gen_tc_skeletons command
一次性工具脚本:T01 测试骨架生成器。
一次性工具脚本:T01 测试骨架生成器。
examples
agent_loop command
本示例演示 omnix 的 Agent Turn/Step 双循环用法(进程内集成)。
本示例演示 omnix 的 Agent Turn/Step 双循环用法(进程内集成)。
chat command
本示例演示如何真实调用 DeepSeek 大模型进行多轮对话。
本示例演示如何真实调用 DeepSeek 大模型进行多轮对话。
mcp command
教程:MCP(Model Context Protocol)客户端 → 工具桥接(教学示例)。
教程:MCP(Model Context Protocol)客户端 → 工具桥接(教学示例)。
sandbox_approval command
教程:沙箱 + 审批(Sandbox & Approval)——Agent 的"受控执行"(教学示例)。
教程:沙箱 + 审批(Sandbox & Approval)——Agent 的"受控执行"(教学示例)。
subagent command
教程:子代理(Subagent)——父 Agent 派生子任务并回收(教学示例)。
教程:子代理(Subagent)——父 Agent 派生子任务并回收(教学示例)。
todo command
教程:Todo 系统(整体替换写入)——规划原语之一(教学示例)。
教程:Todo 系统(整体替换写入)——规划原语之一(教学示例)。
tutorial command
教程:从零理解 omnix 的 Agent 内核(参考实现 × 教学示例)。
教程:从零理解 omnix 的 Agent 内核(参考实现 × 教学示例)。
usage command
本示例演示如何在自己的 Go 服务中进程内使用 omnix(DeepSeek Agent 能力 SDK)。
本示例演示如何在自己的 Go 服务中进程内使用 omnix(DeepSeek Agent 能力 SDK)。
workflow command
教程:工作流引擎(Workflow)——串行 / 并行编排(教学示例)。
教程:工作流引擎(Workflow)——串行 / 并行编排(教学示例)。
internal
lint
Package lint 提供缓存安全(cache-safety)静态分析。
Package lint 提供缓存安全(cache-safety)静态分析。
telemetry
Package telemetry 提供缓存命中率监控指标与告警协同。
Package telemetry 提供缓存命中率监控指标与告警协同。
pkg
agent
Package agent 提供 Agent Registry 与 Turn/Step 双循环执行器。
Package agent 提供 Agent Registry 与 Turn/Step 双循环执行器。
approval
Package approval 提供审批策略(Approval Policy)接缝。
Package approval 提供审批策略(Approval Policy)接缝。
attachment
admission.go 复刻官方 attachment/admission 的上传准入:解码 base64 载荷时拒绝 非规范形式(解码后再编码必须与原串一致),防止同一字节的多种编码绕过校验。
admission.go 复刻官方 attachment/admission 的上传准入:解码 base64 载荷时拒绝 非规范形式(解码后再编码必须与原串一致),防止同一字节的多种编码绕过校验。
brand
Package brand 提供"品牌化(Branded)"类型封装,避免跨包契约中使用裸字符串 / []byte 混传。
Package brand 提供"品牌化(Branded)"类型封装,避免跨包契约中使用裸字符串 / []byte 混传。
coderuntime
Package coderuntime 定义代码执行缝(Code Execution Seam)的协议层抽象。
Package coderuntime 定义代码执行缝(Code Execution Seam)的协议层抽象。
commands
Package commands 提供 slash 命令(Commands)系统。
Package commands 提供 slash 命令(Commands)系统。
compaction
Package compaction 提供长对话压缩(任务 S01:Compaction LLM 摘要 + Surface Replace)。
Package compaction 提供长对话压缩(任务 S01:Compaction LLM 摘要 + Surface Replace)。
credentials
本文件实现任务 S06:Authorization Service(OAuth 流 stub)。
本文件实现任务 S06:Authorization Service(OAuth 流 stub)。
eventbus
Package eventbus 提供类型化的进程内事件总线,对齐 Cordis 的四种同步分发模式。
Package eventbus 提供类型化的进程内事件总线,对齐 Cordis 的四种同步分发模式。
feedback
Package feedback 提供 Message Feedback 接缝(Storage Domain sidecar + 稳定 fail 分类)。
Package feedback 提供 Message Feedback 接缝(Storage Domain sidecar + 稳定 fail 分类)。
fileref
Package fileref 复刻官方 context/file-reference 的 @文件引用语法:提取光标处 正在输入的 @token,并把选中的路径格式化为 @path / @"path" 文本。
Package fileref 复刻官方 context/file-reference 的 @文件引用语法:提取光标处 正在输入的 @token,并把选中的路径格式化为 @path / @"path" 文本。
fs
Package fs 提供文件系统(Filesystem)接缝。
Package fs 提供文件系统(Filesystem)接缝。
goal
本文件对应 code-review 修复点 R06:goal 对齐官方稳定失败分类与阻塞原因。
本文件对应 code-review 修复点 R06:goal 对齐官方稳定失败分类与阻塞原因。
homepath
Package homepath 复刻官方 util/home-paths 的用户数据根解析:按"显式配置 > OMNIX_HOME 环境变量 > ~/.omnix"的优先级确定唯一根,并支持 ~ 展开与符号化显示。
Package homepath 复刻官方 util/home-paths 的用户数据根解析:按"显式配置 > OMNIX_HOME 环境变量 > ~/.omnix"的优先级确定唯一根,并支持 ~ 展开与符号化显示。
instructions
Package instructions 复刻官方 context/agent-instructions 的指令文件发现纯逻辑: 从工作目录向上定位项目根、构建根到工作目录的祖先链、并按目录对内容去重。
Package instructions 复刻官方 context/agent-instructions 的指令文件发现纯逻辑: 从工作目录向上定位项目根、构建根到工作目录的祖先链、并按目录对内容去重。
invariant
Package invariant 提供不变量(Invariant)校验注册中心。
Package invariant 提供不变量(Invariant)校验注册中心。
jobs
Package jobs 提供后台任务运行时(Jobs Runtime)与 owner 绑定。
Package jobs 提供后台任务运行时(Jobs Runtime)与 owner 绑定。
launchenv
Package launchenv 复刻官方 util/launch-environment:启动时把多层环境变量 (进程环境 > 项目 .env > 用户 .env)冻结成不可变快照,按固定信任顺序解析, 并在 Windows 上对变量名做大小写折叠。
Package launchenv 复刻官方 util/launch-environment:启动时把多层环境变量 (进程环境 > 项目 .env > 用户 .env)冻结成不可变快照,按固定信任顺序解析, 并在 Windows 上对变量名做大小写折叠。
llm
本文件复刻官方 packages/llm/llm/src/assembler.ts 的核心算法,适配本项目简化版 StreamChunk 协议(text/reasoning/tool-call/done)。
本文件复刻官方 packages/llm/llm/src/assembler.ts 的核心算法,适配本项目简化版 StreamChunk 协议(text/reasoning/tool-call/done)。
llm/provider_deepseek
Package provider_deepseek 实现 DeepSeek 官方 API 的 REST + SSE 流式适配器。
Package provider_deepseek 实现 DeepSeek 官方 API 的 REST + SSE 流式适配器。
mcp
Package mcp 提供 MCP(Model Context Protocol)客户端 → ToolDefinition 桥(任务 S13)。
Package mcp 提供 MCP(Model Context Protocol)客户端 → ToolDefinition 桥(任务 S13)。
persistence
Package persistence 提供会话持久化接缝:Flush Checkpoint + Batch Window + Crash Repair。
Package persistence 提供会话持久化接缝:Flush Checkpoint + Batch Window + Crash Repair。
persistence/sqlite
Package sqlite 提供 SQLite 持久化后端 + FTS5 索引(任务 S03)。
Package sqlite 提供 SQLite 持久化后端 + FTS5 索引(任务 S03)。
plan
Package plan 提供 Plan Mode(计划模式)软引导 + 审批退出。
Package plan 提供 Plan Mode(计划模式)软引导 + 审批退出。
presets
Package presets 提供 Agent Preset(代理预设)接缝。
Package presets 提供 Agent Preset(代理预设)接缝。
registry
本文件对应任务 H07:Shared Registry 只读化。
本文件对应任务 H07:Shared Registry 只读化。
retain
Package retain 复刻官方 util/output-retention 的逻辑单元有界保留:向保留器持续 push 观察到的单元,只保留前 maxItems 个,其余精确计数为省略,finish 给出保留 子集与省略元数据。
Package retain 复刻官方 util/output-retention 的逻辑单元有界保留:向保留器持续 push 观察到的单元,只保留前 maxItems 个,其余精确计数为省略,finish 给出保留 子集与省略元数据。
sandbox
本文件实现沙箱升级机制(Escalation):严格更宽阶梯 + 审批集成 + 标记。
本文件实现沙箱升级机制(Escalation):严格更宽阶梯 + 审批集成 + 标记。
schedule
Package schedule 复刻官方 schedule 的进程内调度核心:after(延迟一次性)、 at(绝对时刻一次性)、every(固定周期,不低于 5 分钟)三类提醒的注册、触发与 取消。
Package schedule 复刻官方 schedule 的进程内调度核心:after(延迟一次性)、 at(绝对时刻一次性)、every(固定周期,不低于 5 分钟)三类提醒的注册、触发与 取消。
scope
本文件补充官方 scope 的父作用域链(bindScopeParent / scopeParentOf / scopeChainOf)。
本文件补充官方 scope 的父作用域链(bindScopeParent / scopeParentOf / scopeChainOf)。
session
本文件对应任务 M20:session/end-seed 种子边界 marker。
本文件对应任务 M20:session/end-seed 种子边界 marker。
sessionquery
Package sessionquery 提供会话查询与搜索(任务 S04:Session Query + FTS5 搜索)。
Package sessionquery 提供会话查询与搜索(任务 S04:Session Query + FTS5 搜索)。
sessiontitle
normalize.go 复刻官方 session-title/normalize:把不可信标题文本清洗为单行 (剥离转义/控制字符/方向控制、空白归一),并按 UTF-8 字节预算截断而不拆字符。
normalize.go 复刻官方 session-title/normalize:把不可信标题文本清洗为单行 (剥离转义/控制字符/方向控制、空白归一),并按 UTF-8 字节预算截断而不拆字符。
settings
Package settings 提供设置接缝(ctx.settings):分层作用域 + 路径操作 + CAS + 密钥脱敏。
Package settings 提供设置接缝(ctx.settings):分层作用域 + 路径操作 + CAS + 密钥脱敏。
shell
Package shell 提供 Shell/Bash 接缝与 tool-bash。
Package shell 提供 Shell/Bash 接缝与 tool-bash。
skills
grammar.go 复刻官方 skill 的名称语法与模型面内容块渲染:kebab-case 名称校验, 以及统一的 <skill_content> 块(资源提示 + 指令正文),转义内嵌文本防止越出框架。
grammar.go 复刻官方 skill 的名称语法与模型面内容块渲染:kebab-case 名称校验, 以及统一的 <skill_content> 块(资源提示 + 指令正文),转义内嵌文本防止越出框架。
spill
Package spill 提供 Spill Storage(大结果溢出接缝)。
Package spill 提供 Spill Storage(大结果溢出接缝)。
storage
本文件实现 filekv 后端:基于文件系统的键值存储。
本文件实现 filekv 后端:基于文件系统的键值存储。
subagent
本文件复刻官方 subagent/src/depth.ts:委托深度核算。
本文件复刻官方 subagent/src/depth.ts:委托深度核算。
subprocess
提供 pkg/subprocess 的本地实现:os/exec 驱动 + 进程树终止 + 环境 scrub + spill。
提供 pkg/subprocess 的本地实现:os/exec 驱动 + 进程树终止 + 环境 scrub + spill。
sysprompt
本文件对应任务 M10:PromptContext 动态注册与快照。
本文件对应任务 M10:PromptContext 动态注册与快照。
telemetry
anonymous.go 复刻官方 identity/anonymous-user-id:每个 Harness home 一个随机 UUID,持久化为 .anonymous-user-id 单行;文件缺失或损坏则新建,写入失败仍返回 可用 ID(best-effort),进程内按路径 memo。
anonymous.go 复刻官方 identity/anonymous-user-id:每个 Harness home 一个随机 UUID,持久化为 .anonymous-user-id 单行;文件缺失或损坏则新建,写入失败仍返回 可用 ID(best-effort),进程内按路径 memo。
terminal
sanitize.go 复刻官方 terminal/terminal-bash 的清洗逻辑:把 PTY 原始输出中的 ANSI CSI/OSC 转义序列剥离,并归一化回车换行,得到可安全展示的纯文本。
sanitize.go 复刻官方 terminal/terminal-bash 的清洗逻辑:把 PTY 原始输出中的 ANSI CSI/OSC 转义序列剥离,并归一化回车换行,得到可安全展示的纯文本。
timecontext
Package timecontext 复刻官方 context/time-context 的纯渲染部分:在准备请求时 采样当前时间、时区,并给出距上一条模型可见消息经过的时长,让模型知道"现在是 什么时候、已经过了多久"。
Package timecontext 复刻官方 context/time-context 的纯渲染部分:在准备请求时 采样当前时间、时区,并给出距上一条模型可见消息经过的时长,让模型知道"现在是 什么时候、已经过了多久"。
todo
本文件复刻官方 toTodoList 的值约束(schema 无法表达的部分):trim 后非空、 content 去重、非并行模式下最多一个 in_progress;并提供三态计数。
本文件复刻官方 toTodoList 的值约束(schema 无法表达的部分):trim 后非空、 content 去重、非并行模式下最多一个 in_progress;并提供三态计数。
tokenmeter
本文件复刻官方 token-meter/src/estimate.ts:固定密度启发式 token 估算。
本文件复刻官方 token-meter/src/estimate.ts:固定密度启发式 token 估算。
tools
aborted.go 复刻官方 session-checkpoint-policy 的"派发前取消"语义:当请求在 真正进入工具体之前就已被取消时,返回一个带稳定错误码的 isError 结果,而不是 带着半截状态进入工具实现。
aborted.go 复刻官方 session-checkpoint-policy 的"派发前取消"语义:当请求在 真正进入工具体之前就已被取消时,返回一个带稳定错误码的 isError 结果,而不是 带着半截状态进入工具实现。
userq
Package userq 提供 User Questions(用户提问)接缝。
Package userq 提供 User Questions(用户提问)接缝。
uuid
Package uuid 提供 RFC 9562 v4 UUID 的生成,复刻官方 util/crypto 的 randomUUID: 从密码学随机源取 16 字节,固定 version/variant 位后格式化为 8-4-4-4-12。
Package uuid 提供 RFC 9562 v4 UUID 的生成,复刻官方 util/crypto 的 randomUUID: 从密码学随机源取 16 字节,固定 version/variant 位后格式化为 8-4-4-4-12。
waterfall
Package waterfall 提供泛型中间件链(Waterfall)原语。
Package waterfall 提供泛型中间件链(Waterfall)原语。
workflow
ralph.go 复刻官方 workflow/tool-ralph 的纯编排:围绕一个固定目标,每轮让一个 全新子代理返回结构化报告,continue 则携带有界 handoff 进入下一轮,complete 成功收尾、blocked 需人工、达到 maxRounds 记为 budget-limited。
ralph.go 复刻官方 workflow/tool-ralph 的纯编排:围绕一个固定目标,每轮让一个 全新子代理返回结构化报告,continue 则携带有界 handoff 进入下一轮,complete 成功收尾、blocked 需人工、达到 maxRounds 记为 budget-limited。
workspace
path.go 复刻官方 util/workspace-path 的路径辅助:相对路径拼到工作区根、home 目录缩写为 ~、以及取路径最后一段用于显示。
path.go 复刻官方 util/workspace-path 的路径辅助:相对路径拼到工作区根、home 目录缩写为 ~、以及取路径最后一段用于显示。
tests
testutil
Package testutil 提供 N07 缓存命中率 E2E 的 Mock DeepSeek 工具。
Package testutil 提供 N07 缓存命中率 E2E 的 Mock DeepSeek 工具。

Jump to

Keyboard shortcuts

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