Quick Start zh

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

快速开始指南

5 分钟内上手 ALICE！

前提条件

确保你已准备好：

• ✅ 已安装 ALICE（参见安装指南）
• ✅ 本地运行 LM Studio 或 Ollama
• ✅ 已下载 LLM 模型

步骤 1：启动 ALICE

打开终端并运行：

alice

你将看到启动横幅：

   █████  ██      ██  ██████ ███████ 
  ██   ██ ██      ██ ██      ██      
  ███████ ██      ██ ██      █████   
  ██   ██ ██      ██ ██      ██      
  ██   ██ ███████ ██  ██████ ███████ 
                                     
  AI-Powered CLI Assistant

步骤 2：第一次对话

直接输入你的问题：

> You: 你好！你能做什么？

Alice: 你好！我是 ALICE，你的 AI 助手。我可以帮你：

- 回答问题并进行对话
- 读取和搜索项目中的文件
- 查看当前时间和日期
- 查看 Git 仓库信息
- 执行系统命令（需要你的许可）
- 还有更多功能！

今天我能帮你什么？

步骤 3：尝试使用工具

ALICE 可以自动使用工具来完成任务：

示例 1：查看时间

> You: 现在几点了？

[⏰ getCurrentDateTime] 执行中...
[✅ getCurrentDateTime] 成功

Alice: 现在是 2026 年 2 月 10 日星期二，晚上 10:15。
时区为 Asia/Shanghai (UTC+8)。

示例 2：搜索文件

> You: 这个项目有多少个 TypeScript 文件？

[🔍 searchFiles] 正在搜索 **/*.ts...
[✅ searchFiles] 找到 25 个文件

Alice: 该项目包含 25 个 TypeScript 文件，分布在：
- src/core/: 5 个文件
- src/cli/: 8 个文件
- src/tools/: 7 个文件
- src/utils/: 3 个文件
- src/types/: 2 个文件

示例 3：读取文件

> You: package.json 里有什么？

[📄 readFile] 正在读取 package.json...
[✅ readFile] 文件读取成功 (1024 字节)

Alice: 你的项目名为 "alice-cli"，版本 0.2.0。
描述为 "支持 Function Calling 的 AI 驱动办公助手 CLI"。

主要依赖包括：
- ink: ^4.4.1 (CLI UI 框架)
- axios: ^1.6.5 (HTTP 客户端)
- ajv: ^8.17.1 (Schema 验证)

步骤 4：探索命令

ALICE 内置了快捷命令：

# 显示帮助
> /help

# 查看当前配置
> /config

# 清除聊天历史
> /clear

# 退出 ALICE
> /quit

步骤 5：处理项目工作

ALICE 理解你的工作空间：

# 查看 Git 状态
> You: 当前是什么 Git 分支？

[🌿 getGitInfo] 正在获取 Git 信息...
[✅ getGitInfo] 成功

Alice: 你当前在 "master" 分支上。
最近的提交：
- eba23ee: docs: add v0.2.0 release notes
- a65ad43: chore: prepare for v0.2.0 release
- 6ba256b: feat: integrate tool system into main UI

常见任务

任务：查找内容

> You: 查找所有 markdown 文件

[🔍 searchFiles] 正在搜索 **/*.md...
[✅ searchFiles] 找到 8 个文件

Alice: 找到 8 个 markdown 文件：
- README.md
- CONTRIBUTING.md
- RELEASE_v0.2.0.md
...

任务：查看目录

> You: 我在哪里？

[📂 getCurrentDirectory] 正在获取当前目录...
[✅ getCurrentDirectory] 成功

Alice: 你在 D:\projects\Alice
平台：Windows (win32)

任务：执行命令

> You: 显示磁盘使用情况

[🔧 executeCommand] 准备执行: du -sh .

⚠️  此命令即将执行。继续？(y/N): y

[🔧 executeCommand] 执行中...
[✅ executeCommand] 命令完成

Alice: 当前目录大小为 156M。

最佳实践技巧

1. 具体描述

❌ "检查文件" ✅ "src 文件夹中有多少个 JavaScript 文件？"

2. 自然提问

你不需要记住命令。只需自然地提问：

• "package.json 里有什么？"
• "列出 TypeScript 文件"
• "显示 Git 状态"

3. 安全使用工具

ALICE 会在以下操作前请求确认：

• 删除文件
• 执行潜在危险命令
• 进行系统更改

4. 浏览历史

• 按 ↑ 回顾之前的输入
• 按 ↓ 向前浏览历史

下一步

现在你已经熟悉基础功能：

1. 了解所有工具 - 探索全部 7 个内置工具
2. 配置 ALICE - 自定义设置
3. 添加更多模型 - 设置多个 LLM 后端
4. 了解安全机制 - 学习危险命令保护

需要帮助？

• 在 ALICE 中输入 /help
• 查看 FAQ
• 访问故障排除
• 提交 issue

开始愉快聊天吧！🎉