安装与启动

安装后 alius 命令找不到

确保安装路径在 PATH 环境变量中：

# 检查 alius 路径
which alius

# 如果使用 npm 安装，检查全局路径
npm list -g @alius-tech/alius

alius 启动后立即退出

检查是否缺少必要的环境配置：

  1. 运行 alius init 初始化项目
  2. 确认 .alius/config/providers.toml 中配置了有效的提供商和 API Key
  3. 确认至少分配了 Plan/Execute/Review 三个模型

alius init 中模型获取失败

如果远程模型列表获取失败：

  1. 检查网络连接和 API Key 是否有效
  2. /model 的添加流程支持手动输入模型名称作为回退
  3. 确认 Base URL 是否正确

工作空间

工作空间启动提示缺少 API Key

在 /init 中成功导入模型后，API Key 会写入活跃运行时设置。如果你手动编辑了 providers.toml，确认 api_key_env 指向正确的环境变量。

模型分配报错”模型未启用”

在 /config 中检查模型分配之前，先在 /model 中确认模型的 enabled 状态为 true。

无法删除模型

正在被 Plan Model、Execute Model 或 Review Model 使用的模型无法删除。先在 /config 中更改分配，再删除模型。

执行模式

Plan 模式下工具调用被暂停

这是正常行为。Plan 模式中需要审批的操作（文件写入、风险 Shell 命令等）会暂停等待你的确认。你可以选择批准或拒绝。

Bypass 模式下风险操作自动执行了

在 Bypass 模式中，Shell Gate 的 ApprovalRequired 决策会直接执行，而非弹出确认。如果你不希望某些操作自动执行，请在 Plan 模式中工作，或在 permissions.toml 中将相关操作设为 deny。

记忆

记忆数据存储在哪里？

所有记忆存储在项目目录的 .alius/memory/ 下。没有外部数据传输。

如何清除项目记忆？

/memory clear

这会清除全局记忆。项目记忆通过 memory_list 和 memory_clear 运行时操作管理。

遗留 REPL

如何使用旧的 REPL 界面？

ALIUS_LEGACY_REPL=1 alius

遗留 REPL 支持斜杠命令和终端流式输出，但不是主要产品界面。

更多帮助