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 工具。 |
Click to show internal directories.
Click to hide internal directories.