xiaoli-cli/HELP.md

小狸 Pro-CLI 使用指南

快速上手

启动

# TUI 模式（默认）
python -m xiaoli

# CLI 模式
python -m xiaoli --cli

# 指定引擎
python -m xiaoli --engine ollama

基本操作

• 退出程序: 输入 /quit 或 Ctrl+C
• 查看帮助: 输入 /help
• 查看版本: 输入 /about

---

AI 引擎管理

切换引擎

/model ollama    # 切换到 Ollama 本地模型
/model mimo      # 切换到小米 MiMo
/model glm       # 切换到智谱 GLM
/model qwq       # 切换到 QwQ 深度思考

查看可用引擎

/engine list

---

聊天记录管理

命令	说明
/chat save <名称>	保存当前对话
/chat list	列出所有保存的对话
/chat open <名称>	加载历史对话

---

内置工具

小狸会根据你的自然语言描述自动选择合适的工具。以下是主要工具：

代码编辑器 (code_editor)

用于精准的代码编辑操作：

• 替换代码 — 指定文件和要替换的内容
• 批量编辑 — 一次修改多处
• 查看代码 — 按行号范围查看

代码搜索 (code_search)

用于理解和搜索代码库：

• 项目结构 — 查看目录树
• 搜索代码 — 按关键词搜索文件
• 符号提取 — 提取函数、类定义
• 代码统计 — 代码行数、文件数统计

Git 操作 (git_tools)

• status — 查看状态
• diff — 查看变更
• log — 查看提交历史
• commit <消息> — 提交更改

文件管理 (file_manager)

操作	说明
list	列出目录内容
read <路径>	读取文件
write <路径> -c "内容"	写入文件
append <路径> -c "内容"	追加内容
delete <路径>	删除文件
mkdir <路径>	创建目录
copy <源> <目标>	复制文件
move <源> <目标>	移动文件
info <路径>	查看文件信息
tree	显示目录树

命令执行 (cmd_executor)

直接在沙箱中执行系统命令，支持超时控制。

AI 搜索 (ai_search)

使用 AI 进行智能搜索和问答。

---

自然语言交互

你不需要记住命令格式，直接用自然语言描述需求即可：

"帮我看看 src/app.py 的第 10 到 20 行"
"搜索项目里所有用到 requests.get 的地方"
"提交代码，消息是修复登录bug"
"统计一下这个项目的代码量"

AI 会自动理解你的意图并调用合适的工具。

---

远程连接

启动 WebSocket 服务

/remote start <端口> <密码>

代理模式

/remote proxy <中继地址> <服务器密码> <本地端口> <本地密码>

---

使用技巧

1. TUI 模式 — 默认启动 TUI 图形界面，体验更好；使用 --cli 切换到传统模式
2. 引擎选择 — 本地开发用 ollama，深度思考用 qwq，通用场景用 mimo
3. 代码编辑 — 描述需求即可，AI 会自动使用代码编辑器
4. Git 工作流 — 自然语言描述，AI 自动执行 Git 操作
5. 插件扩展 — 可以自行开发插件，详见 开发文档

---

注意事项

• 文件操作大小限制为 50MB
• 代码执行在沙箱环境中，有超时限制
• 音频播放需要系统支持相应格式
• TUI 模式需要安装 textual 和 rich