Merge pull request #18 from lzwjava/feat/update-docs-readme

Docs: Update READMEs with Latest Features

Author: lzwjava

README.md

@@ -4,10 +4,12 @@ An interactive terminal REPL for chatting with GitHub Copilot, built with Python
 
 ## Features
 
-- Multi-turn conversations with GitHub Copilot in your terminal
-- GitHub OAuth device flow authentication
-- Automatic Copilot token refresh during session
-- GPT-4o model
+- **Multi-turn conversations** with GitHub Copilot in your terminal.
+- **Native Tool Calling**: Automatically triggers web searches when real-time information is needed.
+- **Customizable**: Select search providers and models during the session.
+- **GitHub OAuth device flow** authentication.
+- **Automatic token refresh** during sessions.
+- **Modern Default**: Uses GPT-5.2 as the default model.
 
 ## Installation
 
@@ -19,40 +21,50 @@ pip install -e .
 
 ## Usage
 
-1. Authenticate with GitHub (once):
+1. **Authenticate with GitHub** (once):
    ```bash
    mini-copilot-login
    ```
    This runs the GitHub device authorization flow and saves your token to `~/.config/mini-copilot/config.json`.
 
-2. Start the REPL:
+2. **Start the REPL**:
    ```bash
    mini-copilot
    ```
 
-```
-> What is a closure in Python?
-
-GitHub Copilot: A closure is ...
-
-> Can you give me an example?
-
-GitHub Copilot: Sure! Here's an example ...
-```
+### CLI Commands
+- `/login`: Authenticate with GitHub.
+- `/model`: View and switch between available models.
+- `/search_provider`: View and switch web search providers (default: DuckDuckGo).
+- `/copy`: Copy the last response to your clipboard.
+- `/help`: Show available commands.
+- `.exit`: Quit the REPL.
 
-Type `.exit` or press `Ctrl+C` to quit.
+## Web Search (Native Tool Calling)
+The agent is equipped with a `web_search` tool. When you ask about recent events or real-time data, the model will autonomously invoke the tool, fetch content, and provide an answer based on live results.
 
 ---
 
 [中文说明 (README_CN.md)](README_CN.md)
 
-## Project Structure
+## Development
 
+### Running Tests
+We use `unittest` and `coverage` for testing.
+```bash
+python3 -m coverage run -m unittest discover tests
+python3 -m coverage report -m
 ```
-mini_copilot/
-├── main.py       # Interactive REPL
-└── login.py      # CLI login utility
 
-pyproject.toml    # Package metadata and entry points
+### Project Structure
+```
+mini_copilot/
+├── commands/     # Modular CLI command handlers
+├── main.py       # Core REPL loop and tool definitions
+├── github_api.py # GitHub/Copilot API communication
+├── web_search.py # DuckDuckGo search and extraction logic
+└── login.py      # OAuth device flow logic
+
+tests/            # Unit tests
+integration_tests/# Network-dependent integration tests
 ```
-

README_CN.md

@@ -5,9 +5,11 @@
 ## 功能特性
 
 - **多轮对话**：在终端中与 GitHub Copilot 进行持续对话。
+- **原生工具调用**：当需要实时信息时，自动触发网页搜索。
+- **可定制化**：在会话期间选择搜索提供商和模型。
 - **GitHub OAuth 认证**：通过 GitHub 设备授权流程进行认证。
 - **自动刷新**：在会话期间自动刷新 Copilot 令牌。
-- **使用 GPT-4o 模型**。
+- **默认使用 GPT-5.2 模型**。
 
 ## 安装步骤
 
@@ -30,24 +32,37 @@ pip install -e .
    mini-copilot
    ```
 
-```
-> 什么是 Python 中的闭包？
-
-GitHub Copilot: 闭包是……
+### 终端命令
+- `/login`: 进行 GitHub 认证。
+- `/model`: 查看并切换可用模型。
+- `/search_provider`: 查看并切换网页搜索提供商（默认：DuckDuckGo）。
+- `/copy`: 将最后一条回复复制到剪贴板。
+- `/help`: 显示可用命令。
+- `.exit`: 退出 REPL。
 
-> 能给我个例子吗？
+## 网页搜索（原生工具调用）
+该代理配备了 `web_search` 工具。当您询问最近发生的事件或实时数据时，模型将自主调用该工具、获取内容并根据实时结果提供答案。
 
-GitHub Copilot: 没问题！这是一个例子……
-```
+---
 
-输入 `.exit` 或按下 `Ctrl+C` 即可退出。
+## 开发相关
 
-## 项目结构
+### 运行测试
+我们使用 `unittest` 和 `coverage` 进行测试。
+```bash
+python3 -m coverage run -m unittest discover tests
+python3 -m coverage report -m
+```
 
+### 项目结构
 ```
 mini_copilot/
-├── main.py       # 交互式 REPL
-└── login.py      # CLI 登录工具
-
-pyproject.toml    # 项目元数据和入口点
+├── commands/     # 模块化 CLI 命令处理器
+├── main.py       # 核心 REPL 循环和工具定义
+├── github_api.py # GitHub/Copilot API 通信
+├── web_search.py # DuckDuckGo 搜索和内容抓取逻辑
+└── login.py      # OAuth 设备流程逻辑
+
+tests/            # 单元测试
+integration_tests/# 依赖网络的集成测试
 ```