多平台知识库 Markdown 导出工具，用自动化脚本代替用户手动打开页面、复制正文、保存文件的重复劳动。
万能导适合把你有权限访问的项目教学资料、团队知识库、课程文档导出为本地 Markdown，既可以一键全部导出，也可以按目录选择指定内容。导出后可以和源码项目放在一起，再交给 AI 阅读，让 AI 同时理解“教学文档 + 真实代码 + 项目结构”，更适合系统学习大型项目。
Author: tllovesxs
| 功能 | 说明 |
|---|---|
| 多平台导出 | 支持知识星球任意项目、语雀任意知识库、飞书任意 Wiki、阿里云 Thoughts 任意工作区 |
| 图形化界面 | 提供统一启动器和各平台导出界面，不熟悉命令行也能使用 |
| 目录选择 | 先读取目录，再选择全部导出或只导出部分章节 |
| 增量更新 | 已导出的文档会跳过，缺失或需要深入的链接可以继续补齐 |
| Markdown 输出 | 按目录结构保存为 Markdown，并生成入口索引和导出报告 |
| 评论区可选 | 知识星球导出可选择是否同时保存页面可见评论区内容 |
| 图片本地化 | 尽量下载正文图片到本地 assets/ 目录，减少后续失效风险 |
| 浏览器自动查找 | 自动扫描 Chrome、Edge、Chromium，也支持用户手动指定浏览器 |
| 请求节奏控制 | 内置固定延迟和随机浮动，尽量模拟正常阅读和复制粘贴节奏 |
| 停止按钮 | 导出过程中可以随时停止，已完成的文件会保留 |
| AI Skill 启动 | 内置 run-wandao Skill，可让 AI 根据链接推荐参数并调用脚本启动工具 |
统一启动器：
多平台导出界面：
- 支持知识星球任意项目、专栏、帖子和文章页导出。
- 支持语雀任意知识库导出。
- 支持飞书任意 Wiki 知识库导出。
- 支持阿里云 Thoughts 任意工作区导出。
工具会使用本机 Chrome/Edge 的调试协议打开页面。登录由用户自己完成，凭证文件只保存 Cookie，不保存账号密码。
| 依赖 | 要求 |
|---|---|
| Python | 3.10 或更高版本 |
| 浏览器 | Chrome、Edge 或 Chromium |
| 权限 | 用户需要拥有目标知识库的正常访问权限 |
在新电脑上运行时，万能导会自动查找常见安装位置中的 Chrome、Edge 或 Chromium，也会读取 PATH 中的浏览器命令。如果浏览器安装在非常规位置，可以设置环境变量 WANDAO_BROWSER 指向浏览器可执行文件。
每个导出界面都有“浏览器程序路径”一栏：
- 点击“查找”会自动扫描浏览器。
- 点击“选择”可以手动指定浏览器程序。
- 如果没有找到浏览器，请先安装 Chrome、Edge 或 Chromium。
git clone https://github.com/tllovesxs/wandao.git
cd wandao
python wandao.py启动后选择要导出的知识库类型，然后点击“打开导出界面”。
查看支持的平台：
python wandao.py --list- 填写知识库入口 URL。
- 点击“登录并保存凭证”，在浏览器中完成登录。
- 点击“读取目录”，工具会读取并展示目录树。
- 勾选要导出的目录或文档。
- 点击“增量导出选中/全部”或“全量导出选中/全部”。
未读取目录时，默认导出该入口下可识别的全部内容。
默认输出到项目目录下的 exports/：
exports/
zsxq/
yuque/
feishu/
aliyun-thoughts/
每次导出通常会生成：
| 文件或目录 | 说明 |
|---|---|
00-知识库入口.md |
本地目录索引 |
00-导出报告.json |
导出统计、失败项、图片下载情况 |
assets/ |
正文图片资源 |
*.md |
按目录结构导出的 Markdown 文档 |
仓库内置了一个 Codex Skill：skills/run-wandao。
它不是单纯的提示词，而是会让 AI 直接调用 Skill 内置脚本：
skills/run-wandao/scripts/launch_wandao.py
这个脚本会自动定位万能导项目目录；如果本机没有项目目录，会尝试从 GitHub 克隆，然后调用 wandao.py 启动程序。
它适合给不想阅读项目文档、也不熟悉参数的用户使用：用户把 Skill 导入 AI 工具后，只需要说 Use $run-wandao，AI 会先向用户索要要导出的知识库链接；拿到链接后再识别平台、推荐参数，并调用脚本启动导出。
Windows PowerShell：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse -Force ".\skills\run-wandao" "$env:USERPROFILE\.codex\skills\run-wandao"macOS/Linux：
mkdir -p ~/.codex/skills
cp -R ./skills/run-wandao ~/.codex/skills/导入后，在新的 AI 对话中可以这样说：
Use $run-wandao
AI 会先询问：
请发送你要导出的知识库链接。
也可以直接把链接一起发过去：
Use $run-wandao 帮我导出这个知识库：<你的链接>
如果用户没有克隆本项目，Skill 里的启动脚本会尝试自动定位本机已有的万能导目录；找不到时会从 GitHub 克隆到 ~/.wandao/wandao。
也可以手动运行 Skill 的启动脚本：
python skills/run-wandao/scripts/launch_wandao.py
python skills/run-wandao/scripts/launch_wandao.py --url "<你的链接>" --dry-run
python skills/run-wandao/scripts/launch_wandao.py --url "<你的链接>" --export直接打开某个平台：
python wandao.py --provider zsxq --gui
python wandao.py --provider yuque --gui
python wandao.py --provider feishu --gui
python wandao.py --provider aliyun-thoughts --gui知识星球任意项目：
python wandao.py --provider zsxq -- --entry-url "https://wx.zsxq.com/columns/..." --output "./exports/zsxq" --incremental --include-comments语雀任意知识库：
python wandao.py --provider yuque -- --book-url "https://www.yuque.com/<namespace>/<book>" --output "./exports/yuque" --incremental飞书任意 Wiki：
python wandao.py --provider feishu -- --wiki-url "https://<tenant>.feishu.cn/wiki/<token>" --output "./exports/feishu" --incremental阿里云 Thoughts 任意工作区：
python wandao.py --provider aliyun-thoughts -- --workspace-url "https://thoughts.aliyun.com/workspaces/<id>/overview" --output "./exports/aliyun-thoughts" --incremental浏览器安装在非常规位置时：
python wandao.py --provider zsxq -- --browser-path "C:\Program Files\Google\Chrome\Application\chrome.exe" --entry-url "https://wx.zsxq.com/columns/..."万能导适合和 AI 编程/阅读工具一起使用。推荐流程：
- 用万能导把你有权限访问的教学文档导出为 Markdown。
- 把导出的知识库目录复制到对应源码项目里，例如：
your-project/
src/
docs/
exported-knowledge/
00-知识库入口.md
01-项目介绍.md
...
- 用 AI 工具打开整个
your-project/目录，让 AI 同时看到源码和导出的教学文档。 - 把 prompts/项目学习导师提示词.md 里的提示词发给 AI。
- 之后就可以按章节、功能或技术点提问，例如“讲一下订单下单流程”“讲一下 Redis Lua 防超卖”“这一章和代码实现对应在哪里”。
这样做的核心思路是：先让 AI 阅读教学文档，再对照真实源码讲解，避免只凭通用知识泛泛回答。
万能导默认在文档/API 请求前等待：
固定延迟 0.8 秒 + 随机浮动 0~0.4 秒
也就是平均约 1 秒。这个设计是为了让自动化过程更接近用户手动浏览和复制粘贴的节奏，降低高频请求风险。你可以在 GUI 中调整，也可以使用命令行参数：
--request-delay 0.8 --request-jitter 0.4导出过程中可以随时点击“停止当前任务”，工具会在安全点停止并保留已经导出的文件。
知识星球导出默认 --max-depth 2，会导出目录文章本身，并继续进入正文里的下一层知识星球链接。GUI 中对应字段是“最多进入几层URL”。
知识星球评论区默认不导出。需要保存评论时，可以在 GUI 勾选“同时导出评论区”，或在命令行增加 --include-comments。开启后工具会额外滚动页面并尝试展开可见评论，然后把评论追加到 Markdown 的“评论区”章节。
本项目的目标是减少用户手动复制粘贴的机械劳动。它不会破解登录、不绕过权限控制，也不提供未授权内容访问能力。
使用本项目时请确认：
- 你对目标内容拥有访问权限。
- 你的使用方式符合平台服务条款和版权要求。
- 不要将导出的内容用于未获授权的传播、售卖或公开发布。
- 不要调低延迟进行高频请求或批量滥用。
更多说明见 docs/合规说明.md。
wandao/
├── wandao.py # 统一启动器
├── export_zsxq.py # 知识星球导出器
├── export_yuque.py # 语雀导出器
├── export_feishu.py # 飞书导出器
├── export_aliyun_thoughts.py # 阿里云 Thoughts 导出器
├── skills/run-wandao/ # AI 一键运行 Skill
├── prompts/项目学习导师提示词.md # 项目学习提示词
├── docs/ # 使用教程、合规说明和截图
└── exports/ # 默认导出目录，本地生成，不提交仓库
- LINUX DO — 新的理想型社区
本项目采用 MIT License 开源。
如果这个项目对你有帮助，欢迎在 GitHub 给一个 Star。