Skip to content

Installation zh

Jump to bottom
andershsueh edited this page Feb 10, 2026 · 1 revision

📖 其他语言: English | 中文 | 日本語

安装指南

本指南将帮助您在系统上安装 ALICE。

前置要求

  • Node.js: 版本 18.0.0 或更高
  • LLM 后端: 以下之一：
    • LM Studio（推荐本地使用）
    • Ollama
    • OpenAI API 账户
    • 任何兼容 OpenAI 的 API

方法一：下载预编译二进制文件（推荐）

下载

前往 Releases 页面 并下载适合您的版本：

平台 文件 说明
Windows x64 alice-win-x64.zip 用于 64 位 Windows
macOS Intel alice-macos-x64.tar.gz 用于 Intel 芯片的 Mac
macOS Apple Silicon alice-macos-arm64.tar.gz 用于 M1/M2/M3 芯片的 Mac
Linux x64 alice-linux-x64.tar.gz 用于 64 位 Linux

安装步骤

Windows

# Extract the zip file
# Double-click alice.exe or run from PowerShell:
.\alice.exe

macOS / Linux

# Extract
tar -xzf alice-*.tar.gz

# Add execute permission
chmod +x alice-*

# Optional: Move to system path
sudo mv alice-* /usr/local/bin/alice

# Run
alice

方法二：从源码安装

步骤 1：克隆仓库

git clone https://github.com/AndersHsueh/Alice.git
cd Alice

步骤 2：安装依赖

npm install

这将安装所有必需的包，包括：

  • ink - CLI 界面框架
  • axios - 用于 LLM API 的 HTTP 客户端
  • ajv - 工具的 JSON Schema 验证
  • glob - 文件搜索
  • simple-git - Git 操作

步骤 3：构建

npm run build

这会将 TypeScript 编译到 dist/ 目录中的 JavaScript。

步骤 4：运行

# Development mode (supports live editing)
npm run dev

# Production mode
npm start

# Or run directly
node dist/index.js

方法三：通过 npm 安装（即将推出）

npm install -g alice-cli
alice

⚠️ 注意：npm 包发布计划在未来版本中推出。

配置 LLM 后端

选项 A：LM Studio（推荐）

  1. 下载 LM Studio 从 https://lmstudio.ai/
  2. 安装并启动 LM Studio
  3. 下载模型：
    • 点击 "Search" 标签
    • 搜索模型（例如："qwen"、"llama"、"mistral"）
    • 下载您喜欢的模型
  4. 启动本地服务器：
    • 点击 "Local Server" 标签
    • 加载您的模型
    • 点击 "Start Server"
    • 默认地址：http://127.0.0.1:1234/v1

选项 B：Ollama

  1. 安装 Ollama 从 https://ollama.ai/
  2. 拉取模型： 
    ollama pull qwen2.5:7b
  3. 启动 Ollama（通常会自动运行）
    • 默认地址：http://localhost:11434/v1

选项 C：OpenAI API

  1. 获取 API Key 从 https://platform.openai.com/
  2. 设置环境变量： 
    # macOS / Linux
export OPENAI_API_KEY="sk-xxxxx"

# Windows
set OPENAI_API_KEY=sk-xxxxx

验证安装

使用 --help 参数运行 ALICE：

alice --help

如果看到帮助信息，说明安装成功！

首次运行

首次运行时，ALICE 将：

  1. 显示欢迎横幅（使用 --no-banner 跳过）
  2. 在 ~/.alice/ 创建配置目录
  3. 生成默认的 settings.jsonc 
# First run
alice

# Or skip banner
alice --no-banner

下一步

故障排除

"Cannot find module" 错误

确保您首先运行了 npm install。

"Connection refused" 错误

您的 LLM 后端未运行。启动 LM Studio 或 Ollama。

macOS/Linux 上的 Permission denied 错误

运行 chmod +x alice 添加执行权限。

更多问题，请查看 故障排除。

Clone this wiki locally