-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ zh
关于 ALICE 的常见问题快速解答。
ALICE 是一个 AI 驱动的命令行助手，结合了对话式 AI 和实用工具。可以将其视为 GitHub Copilot CLI，但功能更多。
- 回答关于代码库的问题
- 读取和搜索文件
- 执行系统命令
- 获取 Git 仓库信息
- 提供编码辅助
- 通过工具系统实现更多功能
ALICE 本身是开源且免费的。但你需要一个 LLM 后端：
- 免费：使用 LM Studio 配合本地模型
- 付费：使用 OpenAI API（按使用付费）
任何兼容 OpenAI 的 API：
- OpenAI (GPT-3.5, GPT-4)
- LM Studio（本地模型）
- Ollama
- 任何自定义的 OpenAI 兼容端点
详见安装指南。
快速安装：
npm install -g alice-cli~/.alice/settings.jsonc
各平台路径：
- Windows:
C:\Users\<username>\.alice\settings.jsonc - macOS:
/Users/<username>/.alice/settings.jsonc - Linux:
/home/<username>/.alice/settings.jsonc
删除配置文件：
# macOS/Linux
rm ~/.alice/settings.jsonc
# Windows
del %USERPROFILE%\.alice\settings.jsoncALICE 会在下次运行时使用默认值重新创建。
alice或从源码：
npm run dev按 Ctrl+C 或 Ctrl+D
可以，使用 --no-banner 标志：
alice --no-banner输入 /clear 或按 Ctrl+L
有！使用 ↑ 和 ↓ 箭头键浏览历史。
可以，但仅限当前会话。退出后对话历史会丢失。
会话持久化计划在未来版本中实现。
工具是让 ALICE 与系统交互的函数：
- 读取文件
- 搜索目录
- 执行命令
- 获取 Git 信息
- 等等
ALICE 显示实时状态：
[🔧 readFile] 正在读取 package.json...
[✅ readFile] 成功 (1024 字节)
暂时不行。所有内置工具始终启用。
工具配置计划在未来版本中实现。
暂时不行。插件系统计划在 v0.3.0 实现。
可能导致数据丢失或系统更改的命令：
- 文件删除（
rm -rf） - 磁盘格式化
- 系统关机
- 等等
编辑 ~/.alice/settings.jsonc：
取决于你的 LLM 后端：
- LM Studio：不需要 API 密钥 ✅
- OpenAI API：需要 ❌
- Ollama：不需要 API 密钥 ✅
在 ~/.alice/settings.jsonc 中：
{
"llm": {
"apiKey": "sk-your-key-here"
}
}或使用环境变量：
{
"llm": {
"apiKey": "$OPENAI_API_KEY"
}
}编辑 ~/.alice/settings.jsonc：
{
"llm": {
"model": "gpt-4"
}
}重启 ALICE 使更改生效。
可以，但每次需要编辑配置并重启 ALICE。
多模型切换计划在未来版本中实现。
可能的原因：
- 模型太大 - 尝试较小的模型
- Temperature 过高 - 降低到 0.3-0.5
- 网络延迟 - 检查网络连接
- LM Studio 性能 - 本地模型速度各异
可以：
- 使用较小模型（如 GPT-3.5 而非 GPT-4）
- 降低配置中的
maxTokens - 降低
temperature获得更集中的响应 - 使用本地 LM Studio 消除网络延迟
原因：
- LM Studio 未运行
- 配置中 baseURL 错误
- 网络问题
解决方案：
- 启动 LM Studio
- 验证 baseURL：
http://localhost:1234/v1 - 检查端口 1234 是否可访问
原因：
- API 密钥错误
- 环境变量未设置
- API 密钥已过期
解决方案：
- 验证 API 密钥正确
- 检查环境变量：
echo $OPENAI_API_KEY - 从 OpenAI 控制台生成新密钥
原因：
- LM Studio 中未加载模型
- 模型名称拼写错误
- 模型在你的计划中不可用
解决方案：
- 在 LM Studio 中加载模型
- 检查模型名称拼写
- 使用 "auto" 让 LM Studio 自动选择
原因：
- 文件未找到
- 权限被拒绝
- 无效参数
解决方案：
- 检查文件路径是否正确
- 验证你有必要的权限
- 查看错误消息了解详情
尝试：
- 按 Ctrl+C 中断
- 重启 ALICE
- 检查 LLM 后端是否运行
- 查看终端错误消息
原因：
- 终端不支持 Unicode
- ANSI 转义码不工作
解决方案：
- 使用现代终端（Windows Terminal、iTerm2 等）
- 更新终端设置
- 尝试不同的终端模拟器
支持！响应默认实时流式输出。
暂时不行。目前 ALICE 只能：
- ✅ 读取文件
- ✅ 搜索文件
- ✅ 列出目录
- ❌ 写入/编辑文件（计划中）
没有，ALICE 仅限命令行。这就是设计初衷！😊
不推荐。ALICE 是为交互式使用设计的。
对于自动化任务，考虑直接使用 LLM API。
部分可以：
- ✅ 本地工具离线工作
- ❌ LLM 需要网络（除非使用本地 LM Studio）
不能。ALICE 专注于本地开发任务。
未来版本可能会添加网页搜索。
可以！ALICE 是开源的： https://github.com/AndersHsueh/Alice
git clone https://github.com/AndersHsueh/Alice.git
cd Alice
npm install
npm run build
npm run dev在 GitHub 上提交 issue： https://github.com/AndersHsueh/Alice/issues
同样的地方 - GitHub Issues，标记为 "feature request"。
查看 GitHub Issues 和 Projects。
| 功能 | ALICE | Copilot CLI |
|---|---|---|
| 开源 | ✅ | ❌ |
| 本地 LLM 支持 | ✅ | ❌ |
| 工具系统 | ✅ (7 个工具) | ✅ (有限) |
| 流式输出 | ✅ | ✅ |
| 成本 | 免费* | 付费 |
*使用本地 LLM 免费，使用 OpenAI 需付费
| 功能 | ALICE | ChatGPT |
|---|---|---|
| CLI 界面 | ✅ | ❌ |
| 系统集成 | ✅ | ❌ |
| 文件访问 | ✅ | ❌ |
| 命令执行 | ✅ | ❌ |
| 网页访问 | ❌ | ✅ |
| 语音 | ❌ | ✅ |
大约：
- 基础：~50-100 MB
- 含 LLM：取决于模型（本地模型：2-8 GB）
不会。ALICE 很轻量。LLM 后端（如果是本地）可能会占用资源。
技术上可以，但：
- ✅ ALICE 本身运行良好
- ❌ 本地 LLM 需要强大硬件
- ✅ 改用云端 LLM API
仅当你使用云端 LLM（OpenAI 等）时。
使用本地 LM Studio，一切都留在本地。
如果使用本地 LLM，是安全的。使用云端 LLM 需谨慎 - 请查看公司政策。
无。ALICE 没有分析或遥测功能。
ALICE 仅在以下情况访问文件：
- LLM 决定使用工具时
- 你可以看到正在调用的工具
- 你可以用 Ctrl+C 取消
对于危险操作，需要确认（除非禁用）。
- 查看文档：首页
- 搜索 GitHub Issues：https://github.com/AndersHsueh/Alice/issues
- 在 GitHub Discussions 提问：https://github.com/AndersHsueh/Alice/discussions
- 提交新 issue：https://github.com/AndersHsueh/Alice/issues/new
找不到需要的内容？ 告诉我们，我们会将其添加到 FAQ！
{ "dangerous_cmd": false }