# ynuo

**Repository Path**: yanzkc/ynuo

## Basic Information

- **Project Name**: ynuo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# YNuo Agent（依诺）

> 个人智能体编码平台。一个 npm 包，跑起你的 AI 编码助手。

- Web 地址：[https://www.axxiu.cn/project/N6RExktL/](https://www.axxiu.cn/project/N6RExktL/)
- 源码：`https://gitee.com/yanzkc/ynuo.git`

## 简介

YNuo Agent 是一个开源的 AI 编码工作台，内置多模型调度、技能系统、MCP 工具集成、Web IDE，以及崩溃自愈的守护进程。  
安装后一条命令启动，无需额外部署前端或后端工程。

核心能力：

- 🎯 技能系统：内置 analyze / design / implement / review / refactor / debug / lead
- 🛠 MCP 集成：运行时动态接入外部工具
- 🧠 多模型：OpenAI / Anthropic / 本地模型（Ollama）
- 💬 流式会话：SSE 实时输出
- 🖥 Web IDE：Vue 3 前端，开箱即用
- 🛡 守护进程：崩溃自动重启，优雅停止

## 安装

### 环境要求

- Node.js >= 22.13.0
- npm >= 10

### 全局安装（推荐）

```bash
npm install -g @ynuo/ai
```

> Windows 上如果遇到 PowerShell 执行策略问题，改用：
> ```bash
> cmd /c "npm install -g @ynuo/ai"
> ```

### 项目内安装

```bash
cd 你的项目目录
npm install @ynuo/ai
```

## 使用

### 前台模式

```bash
ynuo
# 浏览器打开 http://localhost:2609
```

适合开发调试。终端关闭后服务停止。

### 守护模式（推荐）

```bash
ynuo daemon
# 后台运行，关闭终端不影响
# 浏览器打开 http://localhost:2609
```

守护模式特点：

- 崩溃自动重启
- 关闭终端 / SSH 断开后继续运行
- 用 `ynuo stop` 优雅停止

### 停止服务

```bash
ynuo stop
```

### 检查更新

```bash
ynuo check
# 或
ynuo update
```

`ynuo update` 会检查新版本，确认后自动升级并重启守护进程。

### Web 界面

启动后访问：

- `http://localhost:2609/` — Web IDE
- `http://localhost:2609/api/health` — 健康检查

## 卸载

### 全局安装卸载

```bash
npm uninstall -g @ynuo/ai
```

如果之前单独安装过平台包，也建议一起卸载：

```bash
npm uninstall -g @ynuo/ai-win32-x64
npm uninstall -g @ynuo/ai-linux-x64
npm uninstall -g @ynuo/ai-darwin-arm64
npm uninstall -g @ynuo/ai-darwin-x64
```

### 项目内卸载

```bash
npm uninstall @ynuo/ai
```

### 清理数据（可选）

YNuo Agent 的数据目录：

- Windows：`C:\Users\你的用户名\.ynuo\`
- macOS / Linux：`~/.ynuo/`

删除该目录会清空系统配置、用户账号、Agent 会话和项目数据，请确认后操作。

## 常见问题

**端口被占用怎么办？**  
修改配置文件 `config.toml` 中的 `port` 字段，重启即可。

**升级会丢数据吗？**  
不会。数据保存在 `.ynuo/` 目录，升级仅替换程序本身。

**Windows 和 macOS 都能用吗？**  
可以。主包跨平台，守护启动器按平台自动分发。

## 详细文档

- 完整文档：[https://www.axxiu.cn/project/N6RExktL/](https://www.axxiu.cn/project/N6RExktL/)
- 源码：`https://gitee.com/yanzkc/ynuo.git`