YUAN

项目简介 YUAN 是一个开源的自主编码智能体（Autonomous Coding Agent），以确定性决策引擎（Decision Engine）为核心架构，在调用任何 LLM 之前先通过启发式推理完成决策判断。用户以自然语言描述任务，YUAN 自动完成规划、读取、编写、验证和自我修正的全流程。支持自备 API Key（BYOK）模式，可对接 OpenAI、Anthropic Claude、Google Gemini 等主流模型，或连接 YUA 平台使用托管服务。

核心功能 确定性决策引擎（Decision Engine）：所有用户消息在触发 LLM 调用前，先经过纯启发式推理的决策引擎处理，确保非必要时不消耗 token，同时避免低效的 LLM 调用。 全功能 TUI 界面：全屏终端用户界面，带消息历史记录和状态栏，支持交互式操作。 持久化会话：对话历史在会话内跨消息持久保存，可随时调用历史上下文。 多模型支持：BYOK 模式支持 OpenAI、Anthropic、Google Gemini；云端模式通过 YUA Platform 接入。 工具使用能力：内置文件读写/编辑、Shell 执行、grep、glob、git 操作、网页搜索等编码智能体核心工具。 审批系统：交互式确认破坏性工具操作，支持 [允许] [始终允许] [拒绝] 三种选择。 并行工具执行：依赖感知的批量工具调用，优化只读操作的执行效率。 设计协作模式（Design Mode）：AI 驱动的实时设计协作，结合 Playwright 实现可视化验证。 35 个内置技能：涵盖调试（debug）、测试驱动（test-driven）、代码审查（code-review）、安全扫描（security-scan）、重构（refactor）、计划（plan）等核心技能，以及 TypeScript、JavaScript、Python、React、Vue、Go、Rust、Java、Kotlin、Swift 等多语言支持。 插件系统：支持安装外部插件扩展工具、Provider、事件和资源发现能力。 Slash 命令体系：完整的命令菜单，包括 /model 切换模型、/mode 切换执行模式、/skills 技能管理、/mcp MCP 服务器管理等。 自管理 MCP 服务器：内置 @yuaone/mcp-server，支持通过 MCP 协议扩展智能体能力。

技术实现 YUAN 采用「决策引擎 + 智能体循环」的双层架构。决策引擎（Decision Engine）是系统的单一可信信息源（SSOT），在每次接收用户消息时先判断是否需要调用 LLM：若决策引擎判断无需 LLM 介入（如查询配置、状态展示等操作），则直接返回结果；否则进入完整的智能体循环（Observe → Decide → Act → Reflect）。 在完整循环中，LLM 负责制定行动计划，系统执行对应工具调用，验证执行结果与预期是否一致，若不符则触发自我修正流程重新规划。内置的 HierarchicalPlanner（分层规划器）、ReflexionEngine（反思引擎）、ContinuationEngine（延续引擎）和 PolicyEngine（策略引擎）协同工作，确保复杂编码任务的可靠执行。 决策引擎的存在使得 YUAN 在保持智能体能力的同时，显著降低了 token 消耗和响应延迟，适合在资源受限环境或大规模自动化场景中部署。

快速上手 安装：确保 Node.js ≥ 18，执行 npm install -g @yuaone/cli 全局安装 CLI 工具。 配置 API Key：运行 yuan config 启动交互式配置向导，或使用 yuan config set-key 直接设置指定平台的 Key。 启动交互式会话：直接运行 yuan 启动全屏 TUI，开始与智能体对话。 执行单次任务：使用 yuan code "" 直接执行一次性编码任务。 切换执行模式：在 TUI 内使用 /mode 命令切换 auto（自动）、manual（逐步审批）、architect（架构规划）、code（纯编码）、ask（仅问答）五种模式。 管理技能：使用 /skills 命令查看、启用或禁用特定技能，YUAN 默认根据文件类型和上下文自动激活相关技能。

适用人群 追求极致效率的开发者：希望用自然语言驱动编码工作流，减少手动操作的工程师。 AI 编码工具研究者：对智能体决策机制、成本控制和自我修正能力有研究兴趣的技术人员。 需要在受限环境运行的团队：BYOK 模式支持自选模型和自托管，适合对数据主权有要求的企业。 多语言项目维护者：35 个内置语言技能覆盖当前主流编程语言，适合维护多技术栈项目的团队。

适用场景 自动化代码重构和性能优化任务。 复杂多文件功能模块的生成和测试。 安全漏洞扫描和代码审查。 文档生成和代码解释。 需要在多个 LLM 提供商之间灵活切换的研发环境。