让知识没有壁垒，多平台文档互转。用自动化脚本代替手动复制、整理目录、搬运文档的重复劳动。
万能导是一个多平台(目前已支持飞书,语雀,阿里云,印象笔记,有道云笔记,为知笔记,OneNote,知识星球,ima,钉钉文档,息流,Obsidian,本地md)知识库 Markdown 导入导出工具。你可以把自己有权限访问的项目资料、团队知识库、课程文档导出为本地 Markdown，也可以把整理好的本地 Markdown 再导入到支持的平台中。全网效果最好的导入导出工具,在文档格式,图片,目录结构方面的导出质量效果最好.
如果还有你不满意的地方,请提issues,你任何需求都会被重视.
它适合用来做知识备份、平台迁移、项目学习资料整理，以及把“教学文档 + 源码项目”放在一起交给 AI 阅读。
万能导:让知识没有壁垒,助你弯道超车.
Author: tllovesxs
| 项目 | 内容 |
|---|---|
| tllovesxs/wandao | |
| Gitee | shi-xiansong/wandao |
| 📦 发行版下载 | GitHub Releases |
| 🐛 问题反馈 | GitHub Issues / Gitee Issues |
| 📖 使用教程 | docs/使用教程.md |
| 🤝 共创流程 | docs/共创流程.md |
| 🧩 新平台插件开发 | docs/在线插件开发与发布.md |
| 🚢 发布与回滚手册 | docs/发布与回滚手册.md |
| 🗃️ 本地数据存储策略 | docs/本地数据存储策略.md |
| 🔐 安全策略 | SECURITY.md |
| 🔌 Provider v1 兼容说明 | docs/Provider接入说明.md |
| 🧰 旧文件型 Provider 维护 | docs/插件开发指南.md |
| 🧠 项目学习提示词 | prompts/项目学习导师提示词.md |
| 💬 作者微信 | pressure_spring |
| 📮 联系邮箱 | tl200599@163.com |
首页
平台中心
| 平台 | 能力 |
|---|---|
| 🌟 知识星球 | 支持项目、专栏、帖子、文章页导出，可选导出可见评论区 |
| 🪶 语雀 | 支持任意知识库导出，并尽量本地化正文图片和附件 |
| 🪽 飞书 Wiki | 支持 Wiki 知识库导出为 Markdown |
| ☁️ 阿里云 Thoughts | 支持工作区文档导出为 Markdown |
| 支持同步后按笔记本导出 Markdown | |
| 📝 有道云笔记 | 支持浏览器登录后读取目录树，导出 Markdown、图片和附件 |
| 📒 为知笔记 | 支持网页版登录后导出 Markdown，并保留目录和图片 |
| 🗂️ OneNote | 支持 Windows 桌面版 OneNote 导出 Markdown，并保留笔记本/分区/页面层级 |
| 🤖 ima 知识库 | 支持读取知识库目录树，按知识库、文件夹或文件勾选导出 |
| 平台 | 能力 |
|---|---|
| 🪽 飞书 Wiki | 支持本地 Markdown 批量导入，并恢复多层目录结构 |
| 🪶 语雀 | 支持本地 Markdown 创建或更新到语雀知识库，上传图片和附件 |
| 支持本地 Markdown 批量导入，并上传本地图片和附件 | |
| 🤖 ima 知识库 | 支持本地文件上传到知识库根目录或已有文件夹 |
| 平台 | 能力 |
|---|---|
| Notion | 展示官方 Markdown 导出迁移指南 |
- 🧭 统一桌面端：左侧按“首页 / 平台中心 / 任务中心 / 设置”等工作台入口组织功能。
- ✅ 目录选择：先读取目录，再选择全部或部分内容。
- 📊 进度反馈：读取目录、导入、导出都有进度条和实时日志。
- 🧾 任务历史：导入导出会保留最近任务记录，可复制任务报告和失败项，也可继续/重试支持恢复的任务。
- 🧩 全平台 Plugin v1：飞书、语雀、知识星球、阿里云 Thoughts、印象笔记、有道、为知、OneNote、ima、Notion 全部由插件提供；官方插件随桌面端离线可用，签名更新可独立安装、回滚和卸载。
- 🧱 共享核心：浏览器、checkpoint、凭证、结构化日志和任务报告归入
wandao_core，插件不会再依赖另一平台的实现。 - 🧯 错误报告：用户日志和详细日志分离，反馈问题时可一键复制脱敏后的详细报告。
- 🔁 增量更新：已导出的文档可以跳过，只补缺失内容。
- 🖼️ 图片和附件处理：尽量把正文图片、附件下载或上传到目标平台。
- 🔎 浏览器自动查找：自动扫描 Chrome、Edge、Chromium，也支持手动指定。
- ⏱️ 请求节奏控制：内置固定延迟和随机浮动，尽量接近正常手动浏览节奏。
- ⏹️ 停止按钮：任务执行中可以随时停止，已完成文件会保留。
- 🌙 夜间模式和更新检查：桌面端支持主题切换和新版本提示。
如果你有基础计算机知识，推荐直接拉取源码进行启动，很方便，因为有时候我可能发行版打包更慢👌
- 打开 GitHub Releases。
- 下载对应系统的发行版。
- 安装或解压后打开
Wandao。 - 在左侧进入“平台中心”，选择要使用的平台。
- 按界面提示填写链接、登录、读取目录、选择范围并执行任务。
macOS 用户注意：当前 macOS
.zip包未进行 Apple 公证。请只从本项目 GitHub Release 下载；若解压并移动到“应用程序”后提示“已损坏，无法打开”，在终端执行：xattr -cr /Applications/Wandao.app，再重新打开。
发行版已内置 Python 运行时，普通用户不需要额外安装 Python。
如果你想改代码、本地调试，或者当前系统暂时没有合适的发行版，可以直接用源码启动。
一键启动脚本会自动完成三件事：
- 检查本机有没有 Node.js/npm。
- 如果没有，会下载一个本地便携 Node.js 到
.dev-runtime，不污染系统环境。 - 自动检测官方 npm 源和国内 npmmirror，选择更适合当前网络的方式安装依赖并启动。
Windows：
git clone https://github.com/tllovesxs/wandao.git
cd wandao
.\start-wandao.cmd也可以直接双击：
start-wandao.cmd
macOS/Linux：
git clone https://github.com/tllovesxs/wandao.git
cd wandao
chmod +x ./start-wandao.sh
./start-wandao.sh国内网络环境也可以把 clone 地址换成 Gitee：
git clone https://gitee.com/shi-xiansong/wandao.git
cd wandao
.\start-wandao.cmd如果只想安装依赖、不启动软件，可以运行
.\start-wandao.cmd -InstallOnly或./start-wandao.sh --install-only。
- 进入“平台中心”，选择目标平台。
- 点击该平台的“导出”动作。
- 填写入口链接，或填写平台账号/API 配置。
- 第一次使用时点击“登录并保存凭证”或“保存 API 配置”。
- 点击“读取目录”。
- 勾选要导出的目录或文档。
- 点击“开始导出”。
- 进入“平台中心”，选择目标平台。
- 点击该平台的“导入”动作。
- 选择本地 Markdown 目录。
- 按目标平台要求填写链接、API 配置或账号信息。
- 先“扫描目录”或“生成计划”。
- 先做“单篇/单文件导入测试”。
- 确认效果后再批量导入。
飞书导入、语雀导入、印象笔记导入、ima 导入的详细步骤见 使用教程。
如果平台本身已经支持导入导出，或者暂时不适合稳定自动化，可以在“平台中心”查看对应平台的 Markdown 教程。
社区贡献者也可以先提交教程型插件，后续再逐步升级为自动化脚本。
万能导适合和 AI 编程/阅读工具一起使用：
- 用万能导导出你有权限访问的教学文档。
- 把导出的 Markdown 目录放进源码项目中。
- 用 AI 打开整个项目目录。
- 把 项目学习导师提示词 发给 AI。
- 之后可以按章节、功能或技术点提问，让 AI 结合“教学文档 + 真实源码”讲解。
| 依赖 | 要求 |
|---|---|
| 发行版已内置；源码运行需要 Python 3.10+ | |
| 🟩 Node.js | 仅源码运行桌面端、参与开发或本地打包时需要 |
| 🌐 浏览器 | Chrome、Edge 或 Chromium，浏览器类平台登录时使用 |
| 🔐 权限 | 需要拥有目标内容的正常访问权限 |
提交代码或本地打包前，建议先运行统一质量检查：
python scripts\quality_check.py如果只修改在线插件，可以先跑插件校验：
node scripts\validate_plugins.js
node --test tests_js/plugin_manager.test.js如果只维护旧 providers/ 兼容目录或公告索引，可以先跑更轻量的配置校验：
python scripts\validate_providers.pycd wandao_electron
npm ci
npm run build:winmacOS 包建议使用 GitHub Actions 或 macOS 本机打包：
npm run build:mac:x64
npm run build:mac:arm64本项目用于减少用户手动复制、整理、迁移文档的机械劳动。它不会破解登录、不绕过权限控制，也不提供未授权内容访问能力。
请确认：
- 你对目标内容拥有访问权限。
- 你的使用方式符合平台服务条款和版权要求。
- 不要将导出的内容用于未获授权的传播、售卖或公开发布。
- 不要调低延迟进行高频请求或批量滥用。
更多说明见 docs/合规说明.md。
欢迎提交 Issue 和 Pull Request。Bug 反馈、平台适配、导入导出效果优化、文档补充和界面体验改进都可以参与。
为了避免重复开发，新平台、大功能、复杂 Bug 请先搜索已有 Issue/PR，再提交 Issue 并认领。认领后建议 7 天内提交 Draft PR 或同步进展。
提交前请阅读 CONTRIBUTING.md 和 docs/共创流程.md。请不要在 Issue、PR、截图或日志里提交 Cookie、账号密码、App Secret、Token、API Key 等敏感信息。
本项目采用 GNU Affero General Public License v3.0 开源。
如果这个项目对你有帮助，欢迎在 GitHub 给一个 Star。