浏览 GitHub 仓库的文件列表。

找到仓库后，用本工具看目录结构。找到文件后再用 read_github_file 读内容。 禁止用 gh CLI 或 curl 代替。

Args: url: 仓库 URL (来自 search_github 的结果，如 https://github.com/owner/repo) path: 子目录路径（留空看根目录）

读取 GitHub 仓库中某个文件的内容。

读到的代码可以直接复用，需要在代码中标注来源。 文件内容会自动索引到本地，之后可用 search_code 搜索。

Args: url: 仓库 URL (如 https://github.com/owner/repo) path: 文件路径 (如 "src/main.py")

在已读过的代码中搜索关键词。

写代码前先搜一下有没有现成的实现，有就直接复用，禁止从零编写。 只能搜到之前用 read_github_file 读过的文件。

Args: query: Search keywords repo: Optional filter by repository name top_k: Number of results (default: 5, max: 20)

查询某个类别之前读过什么项目。

用户说"做个XX"时，第一步调本工具查历史记录。 有记录 → search_code 搜代码，无记录 → search_github 搜新仓库。

Args: category: Search category (e.g. "电商web", "点餐小程序")

在 GitHub 搜索仓库，返回仓库 URL。

这是搜索 GitHub 的唯一途径，禁止使用 gh CLI 或 curl。 找到仓库后，用 list_github_files 浏览文件，read_github_file 读代码。

Args: query: Search keywords (中文或英文均可) limit: Maximum results (default: 10, max: 30)

通过 GitHub 官方搜索页搜索开源项目（免费，无需 API Key，无限额度）。

当 search_github 限流时用这个替代。搜索 GitHub 上的仓库。 解析 github.com/search 的 HTML 结果页，不依赖第三方搜索引擎。

Args: query: 搜索关键词 (如 "电商网站 React") limit: 返回结果数 (default: 10, max: 20)

查看当前本地索引了哪些代码文件。

查看数据库表结构和内容概况（所有表、字段、记录数、最近记录）。

想看当前索引了哪些数据时用这个。比 index_status 更详细，展示完整表结构。

整理数据库表，清理不需要的历史数据。

当 db_inspect 发现数据太多或过时了，用这个工具清理。

Args: action: 操作类型 - "stats" 查看各表数据量（默认） - "purge_category" 删除指定类别的搜索历史（需传 category） - "purge_repo" 删除指定仓库的所有数据（需传 repo，格式 owner/repo） - "purge_all" 清空所有数据（慎重！） - "vacuum" 压缩数据库，回收空间 repo: 仓库名，格式 "owner/repo"，配合 action="purge_repo" 使用 category: 类别名，配合 action="purge_category" 使用