docs: rewrite README for Gitee compliance

README.md

@@ -1,5 +1,9 @@
 # 小狸 Pro-CLI
 
+<p align="center">
+  <img src="logo.png" width="120" alt="xiaoli-cli logo">
+</p>
+
 <p align="center">
   <strong>智能编程助手 — 代码编辑 · Git 集成 · 浏览器自动化 · 多 Agent 协作 · 图像生成 · 记忆系统</strong>
 </p>
@@ -10,30 +14,32 @@
   <img src="https://img.shields.io/badge/license-MIT-orange" alt="license">
   <img src="https://img.shields.io/badge/tests-150+%20passed-brightgreen" alt="tests">
   <img src="https://img.shields.io/badge/plugins-19-blueviolet" alt="plugins">
-  <img src="https://img.shields.io/badge/MCP-supported-brightgreen" alt="mcp">
 </p>
 
 ---
 
-##  特性
+## 简介
 
--  **双 AI 引擎** — Ollama 本地模型 + OpenAI 兼容格式（DeepSeek、Grok、硅基流动等）
--  **代码编辑与搜索** — 精准替换、批量编辑、符号提取、依赖分析、正则搜索、**自动语法检查**
--  **Git 版本控制** — 完整 Git 操作 + 工作流自动化（smart-commit、changelog）
--  **浏览器自动化** — Playwright 驱动，导航/交互/截图/JS 执行/PDF
--  **子 Agent 系统** — 多 Agent 并行协作，独立任务分配与结果回收
--  **统一安全层** — AI 风险识别 + 三模式切换（普通/人工/无限制）
--  **图像生成** — 基于 ComfyUI 在线服务，自然语言/Tag 双模式，支持中文描述
--  **记忆系统** — 长期记忆 + 每日日记 + AI 写日记 + 全局搜索 + 自动保存对话
--  **Clawli 远程模式** — PC-手机 WebSocket 双向通信，支持内网穿透代理
--  **定时任务** — 支持相对时间、绝对时间、重复任务，到期自动激活 AI
--  **系统通知** — 跨平台任务完成通知（Windows / macOS / Linux）
--  **MCP 协议** — 19 个插件全部实现 MCP 定义，支持 Function Calling 原生调用
--  **19 个插件 161+ 个操作** — 代码编辑、Git、浏览器、工程化、文件管理、图像生成、记忆、桌面GUI自动化等
--  **三模式界面** — TUI 图形化 + 传统命令行 + **Web UI 浏览器界面**
--  **150+ 个自动化测试** — pytest 覆盖全部插件和核心模块
+小狸 Pro-CLI 是一款基于 Python 的智能编程助手，集成了代码编辑、版本控制、浏览器自动化、图像生成、记忆系统等功能，支持多种 AI 引擎，帮助开发者提升工作效率。
 
-##  快速开始
+## 特性
+
+- **双 AI 引擎** — Ollama 本地模型 + OpenAI 兼容格式（DeepSeek、Grok、硅基流动等）
+- **代码编辑与搜索** — 精准替换、批量编辑、符号提取、依赖分析、正则搜索、自动语法检查
+- **Git 版本控制** — 完整 Git 操作 + 工作流自动化（smart-commit、changelog）
+- **浏览器自动化** — Playwright 驱动，导航、交互、截图、JS 执行、PDF 导出
+- **子 Agent 系统** — 多 Agent 并行协作，独立任务分配与结果回收
+- **图像生成** — 基于 ComfyUI 在线服务，自然语言/Tag 双模式，支持中文描述
+- **记忆系统** — 长期记忆 + 每日日记 + AI 写日记 + 全局搜索 + 自动保存对话
+- **远程通信** — PC 与手机 WebSocket 双向通信
+- **定时任务** — 支持相对时间、绝对时间、重复任务，到期自动激活 AI
+- **系统通知** — 跨平台任务完成通知（Windows / macOS / Linux）
+- **MCP 协议** — 19 个插件全部实现 MCP 定义，支持 Function Calling 原生调用
+- **19 个插件 161+ 个操作** — 代码编辑、Git、浏览器、工程化、文件管理、图像生成、记忆等
+- **三模式界面** — TUI 图形化 + 传统命令行 + Web UI 浏览器界面
+- **150+ 个自动化测试** — pytest 覆盖全部插件和核心模块
+
+## 快速开始
 
 ### 安装
 
@@ -52,11 +58,11 @@ python ai_cli.py
 # 指定引擎
 python ai_cli.py --engine openai
 
-# Windows 一键启动（无需 Python 环境）
+# Windows 一键启动
 launcher.exe
 ```
 
-##  AI 引擎
+## AI 引擎
 
 | 引擎 | 类型 | 说明 |
 |------|------|------|
@@ -87,17 +93,17 @@ launcher.exe
 }
 ```
 
-##  插件列表 (19 个)
+## 插件列表 (19 个)
 
-> 💡 更多社区插件请访问 [xiaoli-cli-plugins](https://gitee.com/shuiyu1123/xiaoli-cli-plugins)，使用 `/plugin install <插件码>` 一键安装。
+> 更多社区插件请访问 [xiaoli-cli-plugins](https://gitee.com/shuiyu1123/xiaoli-cli-plugins)，使用 `/plugin install <插件码>` 一键安装。
 
 ### 核心生产力
 
 | 插件 | 操作数 | 说明 |
 |------|--------|------|
-| `code_editor` | 24 | 代码编辑+搜索。精准替换、批量编辑、find/regex/symbols/imports/callers/todo/structure + 自动语法检查 + diff 弹窗 |
+| `code_editor` | 24 | 代码编辑+搜索。精准替换、批量编辑、find/regex/symbols/imports/callers/todo/structure + 自动语法检查 |
 | `git_tools` | 17 | Git 版本控制。status/diff/log/commit/branch + smart-commit/changelog/contributors/stale |
-| `cmd_executor` | 1 | Shell 命令执行。跨平台，超时控制，危险命令拦截 |
+| `cmd_executor` | 1 | Shell 命令执行，跨平台，超时控制 |
 | `file_manager` | 10 | 文件系统。list/read/write/copy/move/delete/search/info/mkdir/append |
 | `auto_engineer` | 12 | 工程化。lint/format/test/build/deps + 复杂度/安全扫描/质量指标/项目初始化 |
 | `task_manager` | 7 | 任务管理。add/list/complete/delete/clear，JSON 持久化 |
@@ -108,12 +114,12 @@ launcher.exe
 |------|--------|------|
 | `sub_agent` | 8 | 子 Agent 系统。spawn/list/status/result/send/kill，多 Agent 并行协作 |
 | `browser_auto` | 28 | 浏览器自动化。导航/点击/填写/截图/JS执行/PDF/cookies（基于 Playwright） |
-| `gui_auto` | 20 | **桌面GUI自动化**。基于 Windows UIA，屏幕元素识别/点击/输入/截图/元素树遍历（仅Windows） |
-| `ai_image` | — | **AI生图**。基于 ai.2x.nz 自然语言生图，异步生成 + WebSocket 进度推送 |
-| `image_generator` | 7 | **图像生成**。基于 ComfyUI 在线服务，自然语言/Tag 双模式，28 个角色工作流 |
-| `memory_plugin` | 11 | **记忆系统**。AI 写日记/搜索记忆/管理聊天记录/长期记忆 MEMORY.md |
-| `scheduler` | 4 | **定时任务**。支持相对时间/绝对时间/重复任务，到期自动激活 AI |
-| `tool_search` | — | 工具搜索。按关键词发现可用插件（供 AI 按需调用） |
+| `gui_auto` | 20 | 桌面 GUI 自动化。基于 Windows UIA，屏幕元素识别/点击/输入/截图（仅 Windows） |
+| `ai_image` | — | AI 生图。基于 ai.2x.nz 自然语言生图，异步生成 + WebSocket 进度推送 |
+| `image_generator` | 7 | 图像生成。基于 ComfyUI 在线服务，自然语言/Tag 双模式，28 个角色工作流 |
+| `memory_plugin` | 11 | 记忆系统。AI 写日记/搜索记忆/管理聊天记录/长期记忆 |
+| `scheduler` | 4 | 定时任务。支持相对时间/绝对时间/重复任务，到期自动激活 AI |
+| `tool_search` | — | 工具搜索。按关键词发现可用插件 |
 
 ### 辅助工具
 
@@ -124,9 +130,9 @@ launcher.exe
 | `frontend_tester` | 前端测试。HTML/CSS/JS 语法检查、响应式验证 |
 | `speech_recognition` | 语音识别。录音 + 语音转文字（Whisper） |
 | `audio_player` | 音频播放 |
-| `send_image` | Clawli 模式下发图片到手机 |
+| `send_image` | 远程模式下发图片到手机 |
 
-##  记忆系统
+## 记忆系统
 
 内置持久化记忆系统，AI 可以记住之前的工作：
 
@@ -146,28 +152,26 @@ memory_plugin remember 用户偏好深色主题
 memory_plugin chat_search 图像生成
 ```
 
-##  Clawli 远程模式
+## 远程通信
 
-通过 WebSocket 实现 PC-手机双向通信：
+通过 WebSocket 实现 PC 与手机双向通信：
 
 ```bash
 /remote start 9079 mypassword    # 启动本地服务
-/remote proxy relay.example.com  # 通过中继服务器穿透内网
 /remote stop                      # 停止服务
 /remote status                    # 查看状态
 ```
 
 功能：手机发消息给 AI、AI 回复推到手机、文件传输、图片识别。
 
-##  安全机制
+## 安全机制
 
-### 三模式切换 (`/safe`)
+### 模式切换 (`/safe`)
 
-| 模式 | 图标 | 说明 |
-|------|------|------|
-| **普通模式** (默认) |  | AI 识别风险，有风险才请求确认 |
-| **人工确认** |  | 所有指令都需要用户确认 |
-| **无限制** |  | 直接执行，不检查 |
+| 模式 | 说明 |
+|------|------|
+| **普通模式** (默认) | AI 识别风险，有风险才请求确认 |
+| **人工确认** | 所有指令都需要用户确认 |
 
 ### 检查流程
 
@@ -175,20 +179,20 @@ memory_plugin chat_search 图像生成
 工具调用 → safety.check()
   ├─ 快速预检（读取/查询类）→ 直接放行
   ├─ 普通模式 → AI 独立分析风险
-  │   ├─ safe=true → 放行
-  │   └─ safe=false → 展示风险等级+影响，y/n 确认
+  │   ├─ safe → 放行
+  │   └─ unsafe → 展示风险等级+影响，y/n 确认
   └─ 特殊指令（rm/delete/chmod）→ 始终确认
 ```
 
-### 代码沙箱
+### 代码执行
 
 独立的安全代码执行环境：
 - AST 级危险代码检测
-- 模块白名单（阻断 os/subprocess/socket 等 25 个模块）
+- 模块白名单（阻断 25 个高危模块）
 - 子进程隔离执行
 - 内存限制
 
-##  MCP 协议支持
+## MCP 协议支持
 
 所有 19 个插件均实现 MCP (Model Context Protocol) 定义，支持三种工具调用协议：
 
@@ -198,27 +202,25 @@ memory_plugin chat_search 图像生成
 | **FC** | OpenAI Function Calling 原生调用 |
 | **JSON** | 传统 `{"action": "use_tool", ...}` 格式 |
 
-`fc_tools.py` 自动将 MCP 定义转换为 OpenAI FC 格式，支持混合响应解析。
-
-##  命令列表
+## 命令列表
 
 | 命令 | 说明 |
 |------|------|
 | `/help` | 显示帮助 |
-| `/safe` | 切换安全模式（普通→人工→无限制） |
+| `/safe` | 切换安全模式 |
 | `/engine list` | 列出可用引擎 |
 | `/engine switch <引擎>` | 切换引擎 |
 | `/engine.openai models` | 列出 OpenAI 引擎模型 |
 | `/chat save/list/open` | 聊天记录管理 |
 | `/file.read <路径>` | 读取文件 |
-| `/remote` | Clawli 远程连接帮助 |
+| `/remote` | 远程连接帮助 |
 | `/notify` | 切换任务完成通知 |
 | `/scheduler` / `/remind` | 管理定时任务 |
 | `/memory` | 管理记忆系统 |
 | `/tui` | 切换 TUI 模式 |
 | `/quit` | 退出 |
 
-##  Web UI
+## Web UI
 
 WebSocket 实时交互界面，支持完整的 AI 对话体验。
 
@@ -227,89 +229,85 @@ WebSocket 实时交互界面，支持完整的 AI 对话体验。
 python webui_server.py --port 8080
 # 浏览器访问 http://localhost:8080
 
-# 方式 2: 直接打开静态页面（功能有限）
+# 方式 2: 直接打开静态页面
 start webui.html       # Windows
 open webui.html        # macOS
 xdg-open webui.html    # Linux
 ```
 
-##  项目结构
+## 项目结构
 
 ```
 xiaoli-cli/
 ├── ai_cli.py                   # 主入口
-├── webui.html                  # Web UI 界面 (WebSocket 实时交互)
-├── webui_server.py             # Web UI 后端 (WebSocket + 静态文件服务)
-├── launcher.py                 # 智能启动器（自动检测环境/安装依赖）
+├── webui.html                  # Web UI 界面
+├── webui_server.py             # Web UI 后端
+├── launcher.py                 # 智能启动器
 ├── config.json.example         # 配置模板
-├── easter_egg.py               #  彩蛋
-│
+├── easter_egg.py               # 彩蛋
 ├── xcli_core/                  # 核心模块
 │   ├── cli_core.py             # 主循环 + 提示词构建
 │   ├── cli_base.py             # 初始化 + 引擎/插件加载
-│   ├── cli_tools.py            # 工具调用执行（支持 MCP/FC/JSON）
-│   ├── cli_clawli.py           # Clawli 远程模式
-│   ├── cli_code_exec.py        # 代码沙箱执行
+│   ├── cli_tools.py            # 工具调用执行
+│   ├── cli_clawli.py           # 远程模式
+│   ├── cli_code_exec.py        # 代码执行
 │   ├── cli_display.py          # 显示输出
 │   ├── cli_history.py          # 聊天记录
 │   ├── config.py               # 配置管理
 │   ├── constants.py            # 常量定义
 │   ├── fc_tools.py             # MCP → FC 格式转换
-│   ├── memory.py               # 记忆系统（长期记忆+日记+搜索+压缩）
+│   ├── memory.py               # 记忆系统
 │   ├── notification.py         # 跨平台系统通知
-│   ├── plugin_manager.py       # 插件管理器（Liugin/Plugin 双协议）
-│   ├── safety.py               # 统一安全层（AI 风险分析）
-│   ├── sandbox.py              # 代码安全沙箱（AST 级检测）
-│   └── tui.py                  # TUI 界面（Textual + 动画）
-│
+│   ├── plugin_manager.py       # 插件管理器
+│   ├── safety.py               # 统一安全层
+│   ├── sandbox.py              # 代码安全沙箱
+│   └── tui.py                  # TUI 界面
 ├── ai_engines/                 # AI 引擎
-│   ├── ollama_engine.py        # Ollama 本地模型
-│   └── openai_engine.py        # OpenAI 兼容格式
-│
+│   ├── ollama_engine.py
+│   └── openai_engine.py
 ├── plugins/                    # 插件 (19 个)
-│   ├── code_editor.py          # 代码编辑+搜索 (24 操作)
-│   ├── git_tools.py            # Git 版本控制 (17 操作)
-│   ├── cmd_executor.py         # Shell 命令执行
-│   ├── file_manager.py         # 文件管理 (10 操作)
-│   ├── auto_engineer.py        # 工程化自动化 (12 操作)
-│   ├── task_manager.py         # 任务管理
-│   ├── sub_agent.py            # 子 Agent 系统 (8 操作)
-│   ├── browser_auto.py         # 浏览器自动化 (28 操作)
-│   ├── gui_auto.py             # 桌面GUI自动化 (20 操作) ⭐ NEW
-│   ├── ai_image.py             # AI生图 (ai.2x.nz) ⭐ NEW
-│   ├── image_generator.py      # 图像生成 (7 操作) ⭐ NEW
-│   ├── memory_plugin.py        # 记忆系统 (11 操作) ⭐ NEW
-│   ├── scheduler.py            # 定时任务
-│   ├── tool_search.py          # 工具搜索
-│   ├── network_tools.py        # 网络工具
-│   ├── ai_search.py            # AI 搜索
-│   ├── frontend_tester.py      # 前端测试
-│   ├── speech_recognition.py   # 语音识别
-│   └── send_image.py           # 图片发送
-│
-├── skills/                     # 技能 (Skill 协议)
-├── image_engine/               # 图像识别引擎（Ollama 视觉模型）
-├── tests/                      # 测试套件 (113 用例)
+│   ├── code_editor.py
+│   ├── git_tools.py
+│   ├── cmd_executor.py
+│   ├── file_manager.py
+│   ├── auto_engineer.py
+│   ├── task_manager.py
+│   ├── sub_agent.py
+│   ├── browser_auto.py
+│   ├── gui_auto.py
+│   ├── ai_image.py
+│   ├── image_generator.py
+│   ├── memory_plugin.py
+│   ├── scheduler.py
+│   ├── tool_search.py
+│   ├── network_tools.py
+│   ├── ai_search.py
+│   ├── frontend_tester.py
+│   ├── speech_recognition.py
+│   └── send_image.py
+├── skills/                     # 技能
+├── image_engine/               # 图像识别引擎
+├── tests/                      # 测试套件 (150+ 用例)
 ├── love.txt                    # 彩蛋情话
 └── about.txt                   # 关于信息
 ```
 
-##  测试
+## 测试
 
 ```bash
-# 运行全部测试 (113 用例)
+# 运行全部测试
 python -m pytest tests/ -v
 
 # 语法检查
 python -c "import py_compile; py_compile.compile('ai_cli.py', doraise=True)"
 ```
 
-##  插件开发
+## 插件开发
 
 小狸支持 `Liugin`（自研协议）和 `Plugin`（通用协议）两种类名，均可被插件管理器自动识别：
 
 ```python
-class Plugin:  # 或 class Liugin
+class Plugin:
     """我的插件"""
 
     def __init__(self):
@@ -343,14 +341,13 @@ class Plugin:  # 或 class Liugin
         return "处理结果"
 ```
 
-##  许可证
+## 许可证
 
 [MIT License](LICENSE)
 
-##  链接
+## 链接
 
--  Gitee: https://gitee.com/shuiyu1123/xiaoli-cli
--  插件仓库: https://gitee.com/shuiyu1123/xiaoli-cli-plugins
--  [更新日志](CHANGELOG.md)
--  [使用指南](HELP.md)
--  [AI 编程助手横评](compare.html)
+- Gitee: https://gitee.com/shuiyu1123/xiaoli-cli
+- 插件仓库: https://gitee.com/shuiyu1123/xiaoli-cli-plugins
+- [更新日志](CHANGELOG.md)
+- [使用指南](HELP.md)