GitHub 开源项目调研工具

深度调研 GitHub 上的开源项目，生成结构化调研报告。

默认报告存放路径: /Users/lytton/mac_wps_clound/Obsidian笔记知识库/调研分析

工作流程

1. 需求确认

明确调研目标：

调研领域/功能（如：视频下载工具、PDF 处理库、CLI 框架）
目标语言/技术栈（可选）
特殊需求（如：star 数要求、维护状态、许可证）

询问用户：

报告输出路径（默认询问）
是否有特定关注点

2. 多维度搜索

使用 WebSearch 进行多轮搜索，覆盖不同关键词组合：

# 搜索策略模板
"github {功能} {类型} downloader/scraper/tool/library"
"github {功能} stars:>1000"
"site:github.com {功能} {技术栈}"
"github {功能} best practices"
"github {竞品名} alternative"

搜索维度：

功能关键词（中英文）
技术栈（Python/TypeScript/Go/Rust 等）
使用场景（CLI/GUI/API/Web）
相关话题（GitHub Topics）

3. 信息收集

对每个发现的仓库，收集以下信息：

字段	说明
仓库名称	owner/repo
星标数	stars 数量
主要功能	核心特性
技术栈	语言/框架
维护状态	最近更新时间
许可证	MIT/Apache/etc
特点/亮点	独特优势

信息来源：

GitHub 仓库主页
README.md
Issues/Discussions
Release 页面

4. 分类整理

将仓库按功能/用途分类：

示例分类结构：
├── 综合工具（功能全面）
├── 专用工具（特定场景）
├── CLI 工具
├── GUI/桌面应用
├── 库/SDK
├── 浏览器扩展
└── 已弃用/不维护

5. 对比分析

制作对比表格，包含关键指标：

工具名	Stars	语言	无需API	GUI	功能A	功能B	推荐指数
...	...	...	✅/❌	✅/❌	✅/❌	✅/❌	⭐⭐⭐⭐

6. 生成报告

输出 Markdown 格式报告，包含：

# {调研主题} GitHub 开源项目调研报告

> 调研日期: YYYY-MM-DD
> 调研目标: [目标描述]

## 一、最推荐工具（Top Picks）
[2-3 个最佳选择，含详细说明]

## 二、分类工具列表
[按类别组织的仓库列表]

## 三、功能对比表
[对比表格]

## 四、使用建议
[按场景推荐]

## 五、注意事项
[法律/技术/安全提醒]

## 六、参考链接
[所有仓库链接]

7. 保存报告

默认路径: /Users/lytton/mac_wps_clound/Obsidian笔记知识库/调研分析

文件命名格式: {调研主题}-GitHub调研报告.md
用户可指定其他路径，否则使用默认路径
使用 Write 工具写入文件
确认写入成功

搜索技巧

GitHub 高级搜索语法

语法	示例	说明
`stars:>n`	`stars:>1000`	star 数大于 n
`language:xxx`	`language:python`	指定语言
`pushed:>date`	`pushed:>2024-01-01`	最近更新
`license:xxx`	`license:mit`	许可证类型
`topic:xxx`	`topic:twitter`	GitHub Topic

关键词扩展

英文: downloader, scraper, exporter, batch, bulk, archive
中文: 下载, 爬取, 导出, 批量, 归档
场景: CLI, GUI, API, web, extension

质量标准

覆盖面: 每个调研至少发现 10+ 相关仓库
深度: Top 3 工具需详细说明功能和使用方式
时效: 标注仓库最后更新时间
实用: 提供具体使用建议和代码示例
客观: 包含注意事项和局限性

github-researcher