deepwiki-export

deepwiki-export 是一个命令行工具，用于从 DeepWiki 或 GitHub URL 下载内容并将其处理为按章节组织的多个 Markdown 文件。GitHub URL 会被自动转换为相应的 DeepWiki URL。

功能

• 从 DeepWiki/GitHub 页面提取主要内容。
• 将提取的每个内容块（章节）保存为单独的 Markdown 文件。
• 输出文件保存在一个根据 URL 自动命名的子目录中，该子目录位于用户指定的基础输出目录下。
• 对于 GitHub URL，子目录结构为 username/reponame/。
• 支持保留原始下载的 HTML 文件（保存在同一子目录中）。
• 可配置请求和文件编码。

安装

通过 pip 从 PyPI 安装 (当发布后):

pip install deepwiki-export

或者从源代码本地安装 (用于开发):

pip install -e .

使用方法

python -m deepwiki_export.cli_tool [OPTIONS] URL

或者，如果通过 pip 安装并已添加到 PATH：

deepwiki-export [OPTIONS] URL

参数

• URL: (必需) 要处理的 GitHub 或 DeepWiki URL。

选项

示例

假设您要从 Roo Code 项目的某个 DeepWiki 页面导出内容，并希望输出到当前目录下的 my_exports 基础目录中：

deepwiki-export --output-base-dir ./my_exports "https://deepwiki.com/RooVetGit/Roo-Code/some-page" --keep-html

这将：

• 从指定的 DeepWiki URL 下载内容。
• 在 ./my_exports/ 目录下创建一个名为 RooVetGit_Roo-Code (或类似，取决于 derive_dirname_from_url 的具体实现) 的子目录。
• 在该子目录 (./my_exports/RooVetGit_Roo-Code/) 内，将每个提取的章节保存为单独的 Markdown 文件 (例如 chapter_1.md, chapter_2.md, ...)。
• 同时，原始 HTML 文件 (例如 _original_page.html) 也会保存在这个子目录中。

贡献

欢迎提出问题、错误报告和功能请求。

许可证

本项目根据 MIT 许可证 授权。