本指南带你从安装到完成第一个 Plan 驱动的任务。

第 1 步：安装 Alius

curl -fsSL https://alius.tech/install | sh

验证安装成功：

alius --version

第 2 步：初始化项目

进入你的项目目录并运行初始化向导：

cd your-project
alius init

初始化向导将引导你完成以下步骤：

  1. 语言选择 — 选择工作空间界面语言（如中文、English、日本語）
  2. 模型池配置 — 选择服务商（BigModel GLM、小米 MiMo、DeepSeek 等），输入 API Key，从远程导入可用模型
  3. 模型分配 — 为 Plan Model、Execute Model、Review Model 三个角色分别选择模型
  4. Soul 选择 — 选择 Agent 的角色身份（如 senior-engineer、code-reviewer 等）

初始化完成后，.alius/ 目录包含：

.alius/
├── config/             # 项目配置
│   ├── config.toml     # 主配置
│   ├── providers.toml  # 提供商、模型池、API Key
│   ├── model.toml      # Plan/Execute/Review 模型分配
│   ├── soul.toml       # Agent 身份
│   ├── tools.toml      # 工具配置
│   ├── permissions.toml # 安全权限
│   └── mcp.json        # MCP 服务器
├── memory/             # 项目记忆
└── workspace/          # 工作空间文档

初始化是可恢复的。如果你在某个步骤中断，下次运行 alius init 会询问你是继续之前的进度还是重新开始。

第 3 步：进入工作空间

alius

你将看到 TUI 工作空间的欢迎界面，显示版本号、当前 Soul、模型分配和模式信息。

按 Enter 进入工作空间。

第 4 步：Bypass 模式 — 快速查询

工作空间默认以 Bypass 模式启动。Bypass 模式适合快速的单轮交互：

> 解释这个项目中的认证模块

Bypass 模式的行为：

  • 直接将输入发送到单轮执行
  • 模型可能会请求一次工具调用
  • 不会进入多轮迭代循环
  • 适用于问答、解释、轻量分析

第 5 步：Plan 模式 — 复杂任务

按 Shift+Tab 切换到 Plan 模式，处理需要多步骤执行的任务：

> 重构数据库连接池以支持异步

Plan 模式的完整流程：

  1. 目标理解 — 如果目标不明确，模型会主动提问
    • 问题以选项形式展示（单选、多选或自由输入）
    • 你选择或输入答案，无需大量打字
  2. 计划生成 — 模型在充分理解目标后生成可执行的计划列表
  3. 审批 — 计划列表在会话区展示，交互区要求你批准或拒绝
  4. 执行 — 批准的计划节点按步执行
    • 工具调用通过 Shell Gate 审批
    • 会话区实时显示执行进度
  5. 完成 — 所有节点执行完成后，你确认计划完成，计划面板关闭

第 6 步：工作空间内配置

你可以在工作空间内随时调整配置，无需退出。

/config — 配置中心

输入 /config 打开内嵌配置中心，包含三个标签页：

标签内容
模型Plan Model / Execute Model / Review Model 分配
语言界面语言选择
SoulAgent 角色身份选择

操作方式：

  • Tab / Shift+Tab 切换配置标签
  • Up / Down 在选项间移动
  • Space 切换多选项
  • Enter 确认选择
  • Esc 退出（所有更改即时生效，无需保存按钮）

/model — 模型池管理

输入 /model 管理本地模型池：

  • 查看 已导入的模型列表
  • 添加 从远程服务商获取模型（选择提供商 → API 模式 → 输入 Base URL 和 API Key → 远程获取模型列表 → 多选导入）
  • 删除 移除已导入的模型（正在被分配使用的模型无法删除，需先在 /config 中更换）

/model 的所有操作即时生效并写入 .alius/config/providers.toml。

/init — 重新初始化

输入 /init 可以重新运行初始化向导。注意：这会清除现有配置并重新开始。

第 7 步：保存记忆

在任务完成后，将重要发现保存到项目记忆：

> /memory save 异步连接池需要 tokio 运行时

记忆会跨 Session 持久化，下次启动时 Agent 可以利用之前积累的知识。

第 8 步：下次恢复

Session 会自动保存到工作空间。下次处理这个项目时：

alius

你可以在工作空间中恢复之前的 Session，从上次离开的地方继续。

常用快捷键

快捷键功能
Shift+Tab切换 Plan / Bypass 模式
Ctrl+Enter提交输入
Esc清空输入或取消当前操作
Ctrl+O全部展开/折叠对话块
Ctrl+C / Ctrl+D退出工作空间

在配置中心内，Tab / Shift+Tab 用于切换配置标签，而不是切换执行模式。

下一步