# routes

**Repository Path**: chengzi404-byte/routes

## Basic Information

- **Project Name**: routes
- **Description**: 一个带有 AI 快照的 Vibe coding 工具
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: JavaScript, Electron, AI

## README

# Routes

Routes 是基于 Electron 的 AI 快照版本管理工具，用于管理 AI 生成的代码快照版本。

> 💡 **为什么叫 Routes?** 因为每个 AI 快照就像一条路径 (Route)，你可以在不同版本之间自由切换、分叉、回溯。

## 功能特性

- **快照版本管理**: 类似 Git 的快照版本控制，支持创建、切换、回滚
- **可视化界面**: 树状结构展示快照历史，直观显示分支和合并
- **状态管理**: 三种状态 (Activated/Current/Deprecated) 清晰标识快照状态
- **分叉支持**: 从任意快照创建分支，实现多版本并行开发
- **Agents 系统**: 内置 5 种 Agent 类型 (Default, Quick, Librarian, Docs, Coder)
- **Git 集成**: 自动使用 Git 进行底层版本控制

## 安装

```bash
npm install
```

## 运行

### GUI 版本 (Electron)
```bash
npm start
```

### TUI 版本 (Terminal)
```bash
npm run tui
```

## 打包

```bash
# 打包所有平台
npm run dist

# Windows
npm run dist:win

# macOS
npm run dist:mac

# Linux
npm run dist:linux
```

## 项目结构

```
src/
├── main/               # 主进程
│   ├── main.js        # 主进程入口
│   └── git-manager.js # Git 操作模块
├── renderer/          # 渲染进程 (GUI)
│   ├── index.html     # 主页面
│   ├── app.js         # 渲染进程逻辑
│   ├── styles.css     # 样式
│   └── components/    # UI 组件
├── tui/               # 终端界面 (TUI)
│   └── app.js         # TUI 入口
├── core/              # 核心逻辑
│   ├── snapshot.js    # 快照模型
│   ├── branch.js      # 分支模型
│   ├── repository.js  # 仓库管理
│   ├── snapshot-manager.js # 快照管理器
│   └── agents/        # Agents 实现
└── shared/            # 共享工具
```

## 使用说明

### GUI 版本

1. **选择项目**: 点击"选择项目"按钮选择一个工作目录
2. **创建快照**: 点击"创建快照"按钮保存当前工作进度
3. **查看快照**: 在左侧快照树中点击任意快照查看详情
4. **切换版本**: 在快照详情中点击"切换到该版本"来回滚
5. **创建分支**: 使用"从此分叉"功能创建新的分支

### TUI 版本

TUI 版本提供命令行交互界面：

```bash
npm run tui
```

**可用命令：**
- `1` - 打开/切换项目
- `2` - 列出所有快照
- `3` - 创建新快照
- `4` - 切换到指定快照
- `5` - 从快照创建分支
- `6` - 查看快照详情
- `7` - 删除快照
- `0` - 退出

**特性：**
- 🎨 彩色终端输出
- 🌳 树状快照列表显示
- 👁️ 实时状态标识 (Activated/Current/Deprecated)
- 🤖 Agent 类型图标显示

## Agents 类型

| Agent | 图标 | 用途 |
|-------|------|------|
| Default | 🤖 | 通用 AI 助手 |
| Quick | ⚡ | 快速任务处理 |
| Librarian | 📚 | 查询网络资源 |
| Docs | 📝 | 文档编写维护 |
| Coder | 💻 | 代码编写重构 |

## 快照状态

- **Current (蓝色)**: 当前正在工作的快照
- **Activated (青绿)**: 当前快照链上的快照
- **Deprecated (灰色)**: 不在当前链上的历史快照

## 技术栈

- Electron 30.x
- Node.js
- Git (系统依赖)
- 原生 JavaScript (无框架)