OY

🚀 一个 Rust 工作区，实现了基于 OpenAI / 兼容 API 的函数调用 AI 智能体，提供 Read/Write/Edit/Bash 四类工具。基于领域驱动设计和洋葱架构原则，构建在四个隔离的 crate 之上。

oy (CLI 入口, 默认启动 TUI) ──► oy-agent (编排) ──► oy-ai (AI 提供者抽象)

• oy-code-cli → oy-tui→ oy-agent → oy-ai
• oy-tui → oy-agent → oy-ai
• oy-code-cli → oy-tui（无参数时默认启动 TUI）

• Rust 1.95+（rust-toolchain.toml 自动配置）
• 一个 Opencode-go 或兼容 OpenAI 的 API 密钥

~/.oy-ai-agent/config.toml：

api_key = "sk-or-..."
base_url = "https://opencode.ai/zen/go/v1"
model = "deepseek-v4-pro"
theme = "light"          # "light" 或 "dark"
reasoning_effort = "xhigh"
context_capacity = 256000
...other

支持平台： macOS (arm64)、Linux (x86_64, Ubuntu latest, GNU)、Windows (x86_64)

通过 bun（推荐）快速安装：

bun install -g @ghyper9023/oy --registry https://registry.npmjs.org/

通过 npm 安装：

npm install -g @ghyper9023/oy --registry https://registry.npmjs.org/

或通过 cargo 从源码编译（推荐）：

cargo install oy-code-cli

💡 推荐排序：bun > cargo 自编译 > npm。bun 安装速度最快；cargo 自编译可获得当前架构最佳优化。

# 启动 TUI（默认）
oy

# 继续最近会话（自动加载最新 session）
oy -c

# 选择并恢复指定会话
oy -r

# 加载指定路径的 session 文件
oy -s /path/to/session.json

# 查看并恢复子代理 session
oy sub-sessions

# 更新 CLI 工具到最新版本
oy update

oy -c：自动扫描 ~/.oy-ai-agent/sessions/ 下的最新 session 并加载历史消息。 oy -r：列出所有 session（按时间降序），显示 uuid 前缀 + 项目目录 + 首条消息摘要，用户选择后恢复。 oy -s <path> 或 oy --session <path>：直接加载指定文件作为 session（不限位置）。 oy sub-sessions：列出所有子代理 session 文件（按时间降序），交互选择后通过 TUI 加载查看。

# 构建
cargo build --workspace

# 启动 TUI
cargo run -p oy-code-cli

# 测试
cargo test --workspace

在输入框输入 / 弹出命令选择器：

快捷键：

AI 回复内容以 Markdown 格式渲染，支持：

• 每个工具调用显示为 🔧 工具调用 · Read，含实时计时器

• 结果返回后合并显示在调用下方，带用时时长 ✓ (0.5s)

• Read 结果折叠至前 5 行，Bash 结果折叠至后 5 行

• Ctrl+O 展开全部内容

• 默认加载~/.pi-ai-agent/skills/下的标准skills
• 可配置bool加载~/.claude/skills/下的标准skills
• llm系统提示词自动附带安装的skill技能

内置 light / dark 双主题：

• light：白底，消息气泡淡蓝/淡绿/淡紫
• dark：黑底，消息气泡深蓝/深绿/深紫

通过 /settings → /theme 切换，设置持久化到 config.toml。

每条消息独立背景色，整行填充：

状态栏显示 agent 运行状态：• 空闲，⠋⠙⠹… 旋转动画表示工作中。

一个统筹调度 + 多角色子代理的智能体协作系统。

CommanderAgent 是用户主入口，通过 Shift+Tab 与 MainAgent 切换。职责是意图识别 → 任务拆分 → 调度子代理 → 结果汇总。

CommanderAgent 接收用户需求
  ├─ 拆分为 sub-issue 1/2/3...
  ├─ 对每个 sub-issue:
  │   ├─ create_sub_agent("planner")    → 获得计划
  │   ├─ create_sub_agent("worker")     → 获得代码产出
  │   ├─ create_sub_agent("reviewer")   → 获得审查
  │   └─ create_sub_agent("git_helper") → 提交 commit / 创建 Issue / 创建 PR
  └─ 汇总输出

• System Prompt：自动注入工作目录和当前时间，子代理具备完整上下文
• Session：MainAgent 与 CommanderAgent 共用同一 UUID 和 session 文件，切换 agent 自动通过 channel 恢复对话历史；子代理 session 自动保存用于调试
• 独立 Runtime：子代理在独立 tokio runtime 中运行，不阻塞主循环
• UUID 工具：子代理可调用 uuid 工具生成 v4/v7 标识符
• 错误处理：tool 执行 panic 在 UI 展示，不静默丢失；Worker drain loop 不丢弃 prompt

• 底部 Sub-Agents 面板显示实时执行状态（▶ 运行中 / ✓ 完成 / ✗ 失败），最多显示 5 行，支持鼠标滚轮滚动
• 每个 toolcall 显示对应 agent 名称，带实时计时器和冻结计时
• 状态栏显示当前 active agent 名称

• 各子代理达到推理轮次上限立即返回错误
• 同一子问题 Review 最多重试 15 次
• CommanderAgent 不直接执行文件操作，主要通过 create_sub_agent 工具调度

oy/
├── Cargo.toml                     # 工作区
├── oy-ai/                         # AI 提供者抽象
│   └── src/
│       ├── domain/ (AiProvider trait, ChatMessage, ToolCall, AiConfig, AiError)
│       └── infrastructure/ (OpenCode-go 实现)
├── oy-agent/                      # 智能体编排
│   ├── tests/integration_test.rs  # MockProvider 集成测试
│   └── src/
│       ├── domain/ (Agent trait, Tool trait, ToolRegistry, AgentError, SubAgentType)
│       ├── application/ (Orchestrator 主循环)
│       └── infrastructure/ (ReadTool, WriteTool, EditTool, BashTool,
│               CommanderAgent, SubAgentRunner, create_sub_agent meta-tool, 持久化)
├── oy-code-cli/                   # CLI 二进制 `oy`
│   └── src/ (CliArgs, run())
└── oy-tui/                        # TUI 二进制
    └── src/
        ├── app.rs                 # 应用状态、事件循环、键盘处理、命令执行
        ├── ui.rs                  # ratatui 渲染（消息区、输入框、状态栏、弹出框）
        ├── message.rs             # Message 枚举、to_lines() MD 渲染、visual_line_count
        ├── command.rs             # 命令注册器、CommandInfo、CommandItem
        ├── event.rs               # 事件循环（tick、crossterm、agent 信号）
        ├── load_config.rs         # config.toml 加载/保存
        ├── theme.rs               # Theme 结构体、DARK_THEME / LIGHT_THEME
        ├── agent.rs               # AgentManager
        └── main.rs                # 入口

cargo test --workspace     # 80% 覆盖率

对话历史自动保存到 ~/.oy-ai-agent/sessions/<项目路径>/<uuidv7>.json。

MIT