mcpField
Y
yuque-lakebook-export

yuque-lakebook-export

github.com/yangsonhung文档处理1850 次安装12 周前更新
代码仓库

关于 yuque-lakebook-export

用于将 Yuque 知识库、文档和 `.lakebook` 文件转换为适合 Obsidian 的本地 Markdown 文件夹的技能。支持单个或批量导出，并处理图片、链接、目录结构和表格等迁移问题。

主要功能

  1. 01将 Yuque 内容导出为 Markdown
  2. 02处理单个或多个 `.lakebook` 文件
  3. 03生成适用于 Obsidian 的文件夹
  4. 04处理图片和内部链接问题
  5. 05处理层级与表格渲染问题

适用场景

  1. 01将 Yuque 知识库迁移到 Obsidian
  2. 02转换一个或多个 `.lakebook` 文件
  3. 03修复常见图片和链接导出问题
  4. 04检查导出的 Markdown 和资源文件夹

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill yuque-lakebook-export

安装后在 Claude Code 中输入/yuque-lakebook-export确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

pyproject.toml
uv.lock
references/
usage.md
scripts/
cli.py
scripts/yuque_lakebook_export/
__init__.py
lake_handle.py
lake_reader.py
lake_setup.py

详细介绍

Yuque Lakebook 导出

概述

将 Yuque 知识库、Yuque 文档或 .lakebook 文件转换为本地 Markdown 文件夹，以便在 Obsidian 中使用。此工作流支持单个或批量导出，并可修复常见迁移问题，例如图片缺失、裁剪图片不匹配、内部链接失效、文件夹层级错误以及 Markdown 表格渲染问题。

适用场景

在用户要求以下操作时使用此技能：

  • 导出一个或多个 Yuque .lakebook 文件
  • 将 Yuque 知识库转换为 Markdown
  • 将 Yuque 内容迁移到 Obsidian
  • 修复 Yuque 导出中的图片、裁剪图片、内部链接、层级或表格问题

不适用场景

以下情况不要使用此技能：

  • 与 Yuque 或 .lakebook 无关的通用 Markdown 编辑
  • 网站抓取任务
  • 源格式并非 Yuque 的导出任务

说明

  1. 优先使用非交互式执行，以便 Agent 能够确定性地运行。
  2. 进行任何非交互式导出之前，Agent 必须先与用户确认输出根目录。不要擅自为用户选择输出目录。
  3. 如果用户尚未提供输出目录，请简洁地询问，并等待用户回答后再运行导出命令。
  4. 始终优先使用 uv。不要在工作目录中创建临时 .venv 或类似的任务专用环境。
  5. 运行任何 uv 命令前，先检查环境中是否有 uv。
  6. 如果未安装 uv 或 PATH 中不可用，Agent 必须先征得用户同意再安装。不得擅自安装。
  7. 运行 uv sync 或 uv run python scripts/cli.py ... 之前，必须先切换到已安装的技能工具目录，也就是包含此 SKILL.md、pyproject.toml、uv.lock 和 scripts/ 的目录。不要直接在 .lakebook 源目录、输出目录或用户当前工作区根目录中运行这些命令。
  8. Agent 执行时使用以下入口：
uv run python scripts/cli.py
  1. 首次使用前同步依赖：
uv sync
  1. 建议的命令顺序：
cd /path/to/installed-skill-root
uv sync
uv run python scripts/cli.py ...
  1. 标准单文件执行：
uv run python scripts/cli.py -l "/path/to/your_file.lakebook" -o "/target/root"
  1. 标准批量执行：
uv run python scripts/cli.py -l "/path/to/your_file_1.lakebook" "/path/to/your_file_2.lakebook" -o "/target/root"
  1. 虽然 scripts/cli.py 仍支持人工使用时通过交互式终端选择，但 Agent 不得依赖交互模式，因为无法可靠地捕获终端交互状态。始终传入明确的 -l 和 -o 参数。
  2. 不要在当前工作目录、用户的下载目录或任何任务目录中手动创建临时虚拟环境；依赖项应由 uv 在技能工具目录中管理。
  3. 一些 Yuque 导出文件的文档正文开头包含 <!doctype lake>；较旧的实现可能会将其渲染成 Markdown 中多余的 lake## 前缀。当前技能实现已处理此情况。
  4. 导出后，请确认：
  • 存在 .md 文件
  • 存在同级 .assets 文件夹
  • 内部链接为相对 Markdown 路径
  • 图片可在 Obsidian 中正常显示
  • 导出的文档开头没有错误的 lake## 前缀
  1. 如果导出失败，请检查写入 .lakebook 输入文件旁的批处理日志。

有关详细行为、故障排查和输出规则，请阅读 references/usage.md。

评论

支持 Markdown