shuiyuPyLab/xiaoli-cli
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity
Files
b7e87e40f3abeff90125f3c166026ac6fda366f3
xiaoli-cli/HELP.md
T
xiaoli-cli bot 6f13d41c11 feat: 添加 /plugin 插件市场命令 
功能:
- /plugin list - 列出可用插件（自动同步远程源）
- /plugin search <关键词> - 搜索插件
- /plugin info <插件码> - 查看插件详情
- /plugin install <插件码|URL> - 安装插件（自动下载、启用、动态加载）
- /plugin remove <名称> - 卸载插件
- /plugin update <插件码> - 更新插件
- /plugin add-source <URL> - 添加远程插件源

文件:
- xcli_core/plugin_market.py - PluginMarketMixin 核心逻辑
- plugin_registry.json - 本地插件码注册表
- xcli_core/cli_core.py - 集成 PluginMarketMixin
- HELP.md - 添加插件市场文档
2026-04-30 02:37:05 +08:00

307 lines
8.4 KiB
Markdown
Raw Blame History

# 小狸 Pro-CLI 使用指南
## 快速上手
### 启动
```bash
python ai_cli.py
```
### 基本操作
- **退出**: `/quit` 或 `Ctrl+C`
- **帮助**: `/help`
- **版本**: `/about`
---
## AI 引擎
### 切换引擎
```
/engine switch ollama # 切换到 Ollama 本地模型
/engine switch openai # 切换到 OpenAI 兼容引擎
```
### 查看可用引擎
```
/engine list
```
### OpenAI 引擎管理
```
/engine.openai models # 列出可用模型
/engine.openai set gpt-4o # 切换模型
/engine.openai info # 查看配置
```
---
## 安全模式
### 切换模式
```
/safe # 循环切换: 普通 → 人工确认 → 无限制
/safe off # 直接切换到无限制模式
/safe on # 切换到普通模式
/safe manual # 切换到人工确认模式
```
### 三种模式
| 模式 | 图标 | 说明 |
|------|------|------|
| **普通模式** (默认) | | AI 自动识别风险，有风险才请求确认 |
| **人工确认** | | 所有指令都需要用户 y/n 确认 |
| **无限制** | | 直接执行，不检查 |
### 风险检查流程
当 AI 调用工具时，安全层会：
1. 快速预检 — 读取/查询类操作直接放行
2. AI 分析 — 调用引擎独立评估风险（不带历史对话）
3. 展示风险 — 如果有风险，显示指令、风险等级、可能影响
4. 用户确认 — 输入 y 执行，n 取消
特殊指令（`rm`、`delete`、`chmod` 等）无论哪个模式都需要确认。
---
## 核心工具
### 代码编辑 (`code_editor`)
| 操作 | 说明 | 示例 |
|------|------|------|
| `edit` | 精准替换（自动检查语法） | `edit file.py old_code <<<>>> new_code` |
| `multi` | 批量编辑（自动检查语法） | `multi file.py [{"old":"a","new":"b"}]` |
| `read_range` | 按行读取 | `read_range file.py 10 20` |
| `find` | 关键词搜索 | `find . keyword *.py` |
| `regex` | 正则搜索 | `regex . def\\s+\\w+ *.py` |
| `symbols` | 符号提取 | `symbols .` |
| `imports` | 导入分析 | `imports file.py` |
| `callers` | 调用查找 | `callers . func_name` |
| `structure` | 项目结构 | `structure .` |
| `stats` | 代码统计 | `stats .` |
| `ast_info` | AST 摘要 | `ast_info file.py` |
| `diff` | 文件对比 | `diff file1.py file2.py` |
| `create` | 创建文件（自动检查语法） | `create new.py content` |
| `write` | 写入文件（自动检查语法） | `write file.py content` |
| `syntax_check` | **主动语法检查** | `syntax_check file.py` |
| `check` | 语法检查简写 | `check file.py` |
| `diff_popup` | **开关 diff 弹窗** | `diff_popup on` / `diff_popup off` |
| `popup` | diff_popup 简写 | `popup` |
> **自动语法检查**: edit/multi/insert/delete_lines/create/write/append 操作完成后，如果是代码文件（.py/.js/.ts/.json/.yaml/.html/.css/.sh/.sql 等），会自动检查语法并报告结果。AI 也可随时用 `syntax_check` 主动检查。
> **Diff 弹窗**: 每次编辑操作完成后，自动弹出新终端窗口，显示修改前后的完整内容（带行号）和 diff 差异对比。默认开启，用 `diff_popup off` 关闭，`diff_popup on` 重新开启。
### Git 操作 (`git_tools`)
| 操作 | 说明 |
|------|------|
| `status` | 查看状态 |
| `diff` | 查看变更 |
| `log --oneline 10` | 提交历史 |
| `add .` | 暂存所有 |
| `commit message` | 提交 |
| `branch` | 查看分支 |
| `checkout -b name` | 创建分支 |
| `smart-commit` | 智能提交（自动 add + 规范化消息） |
| `changelog` | 生成 CHANGELOG |
| `contributors` | 贡献者统计 |
| `summary` | 变更摘要 |
### 文件管理 (`file_manager`)
| 操作 | 说明 |
|------|------|
| `list . -p "*.py"` | 列出目录 |
| `read file.txt -n 50` | 读取前 50 行 |
| `write file.txt -c "内容"` | 写入文件 |
| `copy src dst` | 复制文件 |
| `move src dst` | 移动/重命名 |
| `delete file.txt` | 删除文件 |
| `delete dir -r` | 递归删除目录 |
| `search . -c "keyword"` | 搜索文件内容 |
| `info file.txt` | 文件详情 |
| `mkdir newdir` | 创建目录 |
### 命令执行 (`cmd_executor`)
```
run ls -la # 执行命令
run make build --timeout 60 # 60秒超时
```
### 浏览器自动化 (`browser_auto`)
| 操作 | 说明 |
|------|------|
| `start` | 启动浏览器 |
| `open https://example.com` | 打开网页 |
| `click .btn-primary` | 点击元素 |
| `fill #search keyword` | 填写输入框 |
| `text body` | 获取页面文本 |
| `screenshot page.png` | 页面截图 |
| `eval document.title` | 执行 JS |
| `wait .loaded` | 等待元素 |
| `pdf page.pdf` | 保存 PDF |
| `stop` | 关闭浏览器 |
### 桌面GUI自动化 (`gui_auto`) ⭐ NEW
> 仅支持 Windows，基于 UI Automation API
| 操作 | 说明 |
|------|------|
| `snapshot [深度]` | 获取屏幕 UI 元素树 |
| `snapshot --window 记事本` | 获取指定窗口元素树 |
| `screenshot [路径]` | 全屏截图 |
| `windows` | 列出所有窗口 |
| `focus 记事本` | 聚焦窗口 |
| `click 确定` | 点击元素（模糊匹配） |
| `click --xy 500 300` | 点击坐标 |
| `type 搜索框 Hello` | 在元素中输入文本 |
| `keys ctrl+s` | 发送按键 |
| `find 保存` | 查找元素 |
| `exists 确定` | 检查元素是否存在 |
| `wait 加载完成 10` | 等待元素出现 |
| `highlight 确定` | 高亮闪烁元素 |
### 子 Agent (`sub_agent`)
| 操作 | 说明 |
|------|------|
| `spawn coder 重构 main.py` | 创建子 Agent 并分配任务 |
| `list` | 列出所有子 Agent |
| `status agent_xxx` | 查看状态 |
| `result agent_xxx` | 获取结果 |
| `send agent_xxx 继续优化` | 发送消息 |
| `kill agent_xxx` | 终止 |
| `clean` | 清理已完成的 |
### 工程化 (`auto_engineer`)
| 操作 | 说明 |
|------|------|
| `lint .` | 代码检查 (ruff/flake8) |
| `format .` | 代码格式化 |
| `test .` | 运行测试 (pytest) |
| `build` | 构建项目 |
| `deps` | 检查过时依赖 |
| `complexity .` | 圈复杂度分析 |
| `security .` | 安全风险扫描 |
| `metrics .` | 代码质量指标 |
| `suggest .` | 改进建议 |
| `info` | 项目信息摘要 |
### 任务管理 (`task_manager`)
| 操作 | 说明 |
|------|------|
| `add 任务描述` | 添加任务 |
| `list` | 列出所有任务 |
| `complete 1` | 标记完成 |
| `in_progress 1` | 标记进行中 |
| `delete 1` | 删除任务 |
| `clear` | 清除已完成的 |
### 工具搜索 (`tool_search`)
```
tool_search 文件 # 搜索与文件相关的工具
tool_search git # 搜索 Git 相关工具
tool_search 浏览器 # 搜索浏览器相关工具
```
---
## 插件市场
通过 `/plugin` 命令管理插件，支持从远程仓库一键安装。
### 查看可用插件
```
/plugin list # 列出所有可用插件（自动同步远程源）
/plugin search 郊狼 # 搜索关键词
/plugin info dglab # 查看插件详情
```
### 安装插件
```
/plugin install dglab # 通过插件码安装
/plugin install https://example.com/my_plugin.py # 从 URL 安装
```
安装后自动：
- 下载插件文件到 `plugins/` 目录
- 在 `plugins_config.py` 中启用
- 尝试动态加载（无需重启）
### 卸载插件
```
/plugin remove dglab_ws # 卸载指定插件
```
### 更新插件
```
/plugin update dglab # 重新下载更新
```
### 添加插件源
```
/plugin add-source https://example.com/registry.json # 同步远程插件源
```
### 插件码注册表
插件码是插件的唯一标识，映射到下载地址。注册表文件：`plugin_registry.json`
---
## 聊天记录
```
/chat save my-session # 保存当前对话
/chat list # 列出所有对话
/chat open my-session # 加载历史对话
```
---
## 自然语言交互
不需要记住命令格式，直接用自然语言：
```
"帮我看看 src/app.py 的第 10 到 20 行"
"搜索项目里所有用到 requests.get 的地方"
"提交代码，消息是修复登录bug"
"统计一下这个项目的代码量"
"打开百度搜索 Python 教程"
"创建一个子agent帮我重构utils.py"
```
AI 会自动选择合适的工具执行。
---
## 使用技巧
1. **引擎选择** — 本地开发用 `ollama`，云端用 `openai`（配 DeepSeek 等）
2. **安全模式** — 日常开发用普通模式，生产环境用人工确认模式
3. **子 Agent** — 复杂任务拆分给多个子 Agent 并行处理
4. **浏览器** — 自动化测试、网页抓取、表单填写
5. **工具搜索** — 不确定用什么工具时，先 `tool_search` 查一下
Reference in new issue View Git Blame Copy Permalink