GitHub Issue Fetcher：轻松整理项目问题与解决方案知识库
你是否曾为如何高效整理和利用GitHub仓库中的issue知识而烦恼？当项目越来越大，issue数量不断增加时，如何快速查找和利用这些宝贵的知识资产？今天我要向大家推荐一个实用工具------GitHub Issue Fetcher，它能帮助你轻松将GitHub仓库中的issue内容整理成结构化的知识库文档。
项目地址：https://github.com/wangqiqi/issue-fetcher.git
工具简介
GitHub Issue Fetcher 是一个Python脚本工具，专门用于从GitHub拉取指定仓库的issue内容（包括问题描述和所有评论讨论），并将它们格式化为美观、结构化的Markdown文档。这个工具特别适合项目经理、开发人员和技术文档维护者，帮助他们快速建立项目的问题与解决方案知识库。
核心功能
1. 灵活的Issue状态选择
与其他工具不同，GitHub Issue Fetcher 支持三种状态的issue获取：
- 已关闭的issue（默认）
- 开放的issue
- 所有状态的issue
这意味着你可以根据自己的需求，选择整理项目中的问题记录、待解决问题或者完整的问题历史。
2. 智能过滤与完整内容获取
该工具会自动过滤掉Pull Request，只保留真正的issue，并获取每个issue的完整信息，包括：
- 问题标题和描述
- 提问者和创建时间
- 标签信息
- 关闭时间和关闭者
- 所有评论和讨论内容
3. 进度保存与续拉功能
这是我最喜欢的一个特性！GitHub API有速率限制，当处理大型仓库时，可能需要分多次运行。GitHub Issue Fetcher 会自动保存处理进度，下次运行时可以从上次中断的地方继续，避免重复劳动。
4. 支持API Token自动读取
为了方便用户使用，工具增加了从文件自动读取GitHub API Token的功能。只需在项目目录下创建一个 github_key.txt文件并放入你的Token，工具就会自动读取，无需每次都在命令行中输入。
5. 智能遵守API速率限制
工具会自动检测GitHub API的速率限制，并在接近限制时智能等待，避免触发API调用限制。如果等待时间过长，工具还会自动保存进度并退出，确保已处理的数据不会丢失。
应用场景
项目知识沉淀
对于团队协作项目，GitHub Issue中往往包含了大量有价值的讨论、问题分析和解决方案。使用GitHub Issue Fetcher可以将这些零散的知识点整理成结构化的文档，形成团队内部的知识库，方便新成员快速上手和老成员查找参考。
技术文档补充
技术文档往往侧重于功能说明和使用方法，而对实际使用中遇到的问题和解决方案描述较少。通过整理GitHub Issue，可以为技术文档提供丰富的补充案例和常见问题解答。
版本迭代分析
通过分析不同时期的Issue，可以了解项目的演进历程、技术难点的解决过程，为未来的版本规划提供参考。
快速上手
基本用法
bash
python issue_fetcher.py https://github.com/用户名/仓库名这将拉取指定仓库的所有已关闭issue及其回答，并保存为Markdown文档。
指定状态
bash
python issue_fetcher.py https://github.com/用户名/仓库名 --state all支持的状态参数：open（开放）、closed（已关闭，默认）、all（所有状态）。
使用API Token
方法一：在命令行中指定
bash
python issue_fetcher.py https://github.com/用户名/仓库名 -t 你的GitHubToken方法二：在项目目录下创建 github_key.txt文件并放入Token，工具会自动读取。
自定义输出文件
bash
python issue_fetcher.py https://github.com/用户名/仓库名 -o 自定义文件名.md输出示例
生成的Markdown文档包含以下内容：
markdown
# 项目名Issue知识整理（Closed状态，包含回答）
## 统计信息
- 共拉取到 X 个已关闭的issue
- 拉取时间：YYYY年MM月DD日 HH:MM:SS
- 仓库地址：https://github.com/用户名/仓库名
- 注：本文件包含issue的提问内容以及所有回答和讨论
## 详细Issue列表
## Issue #001
- 问题：XXXXX
- 提问者：@用户名
- 创建时间：YYYY年MM月DD日
- 标签：bug, help wanted
- 关闭时间：YYYY年MM月DD日
- 关闭者：@用户名
问题描述：
这里是问题的详细描述...
## 回答与讨论
### 回答 1
- 回答者：@用户名
- 回答时间：YYYY年MM月DD日 HH:MM:SS
这是第一个回答...
状态：Closed总结
GitHub Issue Fetcher 是一个简单但实用的工具，它能帮助团队和个人更好地利用GitHub Issue中的知识资产。无论是用于项目知识沉淀、技术文档补充还是版本迭代分析，这个工具都能发挥重要作用。如果你也经常需要整理和利用GitHub上的issue内容，不妨试试这个工具，相信它会给你带来不少便利！
这个工具使用Python标准库开发，无需安装额外依赖，支持Python 3.x版本，非常轻量级。项目代码开源，你可以访问GitHub仓库获取源码，也可以根据自己的需求进行定制和扩展。