快速上手

本文档帮助你在 5 分钟内上手 AggRoot。假设你已完成安装与配置。

首次运行

在项目目录或任意目录启动 AggRoot：

aggroot

启动后，你会看到交互式提示符，直接输入你的问题或指令即可。

基本交互

AggRoot 支持自然语言交互，你可以像和同事聊天一样描述需求：

你> 熟悉下当前项目

你> 读取 README.md 并总结

你> 搜索所有 TypeScript 文件

你> 帮我修复 main.ts 里的类型错误

你> 写一个单元测试覆盖 utils.ts 的功能

AggRoot 会自动理解你的意图，调用合适的工具完成任务。

快捷键

AggRoot 提供了几个常用快捷键，提升操作效率：

快捷键	功能	说明
`$`	切换模型	弹出模型选择列表
`#`	切换代理	弹出代理选择列表
`@`	文件引用	在输入中引用文件路径
`/`	斜杠命令	输入命令执行特定操作

Tips: 按下快捷键后会弹出选择界面，用方向键选择后回车确认。

切换模型

AggRoot 支持在对话中随时切换 AI 模型：

方式一：快捷键

按下 $ 键，从弹出的模型列表中选择。

方式二：斜杠命令

你> /model deepseek-v4-flash
你> /model gpt-5.5

常用模型切换场景：

编码任务用 DeepSeek V4 / GLM-5.2（性价比高、长上下文）
复杂推理用 Claude Opus 4.8 / GPT-5.5
本地隐私场景用 Ollama

切换代理

AggRoot 内置多个专业代理，适合不同场景：

方式一：快捷键

按下 # 键，从弹出的代理列表中选择。

方式二：斜杠命令

你> /agents

代理切换场景示例：

编程开发 → code之神（默认）
文案创作、PPT、Word → 内容创作助手
系统运维、环境配置 → 运维大师

Tips: 不同代理拥有不同的工具集和行为准则。编程代理可以读写代码、执行 Git 操作；创作代理擅长文案和文档生成。

YOLO 模式

默认情况下，AggRoot 在执行高风险操作（如写入文件、执行 Shell 命令）前会请求确认。YOLO 模式可以跳过所有确认，自动执行：

你> /yolo

进入 YOLO 模式后，所有操作将自动执行，不再弹出确认提示。

Tips: YOLO 模式适合你已经信任的操作场景。在不确定时，保持默认模式更安全。再次输入 /yolo 可退出 YOLO 模式。

会话管理

AggRoot 提供了完整的会话管理功能：

命令	功能	说明
`/sessions`	查看会话列表	列出所有历史会话
`/switch <id>`	切换到指定会话	继续之前的对话
`/reset`	重置当前会话	清空对话历史，重新开始
`/export`	导出当前会话	将对话导出为文件

会话示例

你> /sessions
  #1  2025-01-15 14:30  修复登录Bug
  #2  2025-01-15 16:20  重构API层

你> /switch 1
已切换到会话 #1：修复登录Bug

你> /reset
会话已重置

你> /export
会话已导出到 .aggroot/exports/session-20250115.md

其他常用命令

命令	功能
`/help`	显示帮助信息
`/exit`	退出 AggRoot
`/memory`	管理项目记忆
`/undo`	撤销最近的文件修改
`/status`	查看当前状态（模型、代理等）

退出

你> /exit

或按 Ctrl+C 退出。

Tips: AggRoot 会自动保存会话状态。下次启动时可以用 /sessions 恢复之前的对话。

← 上一篇

安装与配置

工作原理