OneCode

生产级CLI AI编程助手，基于 .NET 10 + MAF 与 Terminal.Gui 全屏 TUI 构建，引入 Hyperlight 沙箱、LSP 集成、代码索引、DAG 并行调度等增强能力

立即体验快速开始

核心能力

Hyperlight 沙箱

微虚拟机隔离代码执行，支持文件挂载控制与网络域名白名单，让AI安全地操作系统命令。

LSP 集成

内置语言服务协议，编辑后实时诊断更新，提供符号搜索与引用查找，编码更精准。

代码语义索引

基于 CodeIndexService 的语义符号搜索，支持精确、模糊与关键字匹配，快速定位代码。

DAG 并行调度

依赖驱动的并行代理调度，基于拓扑排序高效编排多代理任务，提升复杂任务完成速度。

多代理协作

支持 simple / magentic / groupchat / DAG 四种子代理模式，Agent 间通过消息路由高效协作。

跨会话记忆

User / Session / Repo 三级记忆作用域，AutoDream 后台自动整合关键信息，持续积累项目上下文。

四种工作模式

在 TUI 中按 Tab 键循环切换 BUILD → PLAN → TEAM → GOAL

BUILD

用户输入 → Agent 直接分析并执行，适合小改动、探索性任务与快速修复。

PLAN

Agent 先生成计划卡片，用户批准后再执行，适合复杂重构与多步骤任务。

TEAM

通过 team.yaml 驱动多 Agent 协作（Magentic / GroupChat），适合方案评审与复杂协调。

GOAL

Agent 自主分解目标、迭代执行并以 AI 验证完成度，适合开放式的顶层目标。

特色功能

安全与执行

Hyperlight 微虚拟机沙箱
SSH 远程执行（SSH.NET）
12 层渐进式安全带机制

智能与编排

LSP 深度集成
代码语义索引
DAG 并行调度
Agent 间消息路由

工程化能力

AutoDream 记忆整合
Git Worktree 任务隔离
Cron 定时任务
VCR 录制回放

便捷与发布

多级上下文压缩
Token 精确估算
自包含单文件发布
飞书 / 企业微信通知

快速开始

安装

Windows (PowerShell)

PowerShell

irm https://raw.githubusercontent.com/X2Agent/OneCode/main/scripts/install.ps1 | iex

Linux / macOS

bash

curl -fsSL https://raw.githubusercontent.com/X2Agent/OneCode/main/scripts/install.sh | bash

使用

交互式 TUI

onecode

onecode
# 携带初始 prompt 直接执行
onecode "修复登录页的 CSS 问题"

指定工作目录

onecode

onecode --cwd /path/to/project "分析项目结构"

版本与帮助

onecode

onecode --version
onecode --help

关于 OneCode

项目说明

OneCode 是一个生产级 CLI AI 编程助手，采用 .NET 10 + MAF (Microsoft Agent Framework) 1.17 构建，基于 Terminal.Gui v2 全屏 TUI，引入 Hyperlight 沙箱、LSP 集成、代码索引、DAG 并行调度等增强功能。

许可证与声明

本仓库内容仅用于技术研究和科研爱好者交流学习参考，严禁商用、盈利或未经授权的使用。知识产权归原公司所有，若有侵权请联系删除。

91%

能力综合完成度

~37

内置工具

1600+

测试方法