SuperAPI AI 工具集

yuque-lakebook-export-cn

办公与效率

查看项目

更新于 10-16 09:35

技能介绍

用途:把语雀知识库、语雀文档或 .lakebook 文件导出并转换为本地 Markdown 目录,优先适配 Obsidian;支持单个或批量导出,并处理迁移中常见的图片缺失、裁剪图不匹配、内部链接损坏、目录层级错误、Markdown 表格渲染异常。

不适用:与语雀或 .lakebook 无关的普通 Markdown 编辑、网页抓取、非语雀来源的导出转换。

使用方式:优先非交互模式,便于 Agent 稳定执行。执行任何非交互导出前,必须先向用户确认输出根目录;未明确时先简短询问再执行。统一优先使用 uv,不要在任务目录临时创建 .venv、.yuque-export-venv 等环境。执行 uv 命令前先检查 uv 是否可用;未安装或不在 PATH 时,须先征求用户确认再安装,不得静默安装。执行 uv sync 或 uv run python scripts/cli.py ... 前,先切换到已安装 skill 的工具目录(含 SKILL.md、pyproject.toml、uv.lock 和 scripts/ 的目录),不要在 .lakebook 所在目录、目标输出目录或工作区根目录执行。入口为 uv run python scripts/cli.py,首次使用前先 uv sync。推荐顺序:cd /path/to/installed-skill-root、uv sync、uv run python scripts/cli.py ...。单文件:uv run python scripts/cli.py -l "/path/to/your_file.lakebook" -o "/target/root";批量:uv run python scripts/cli.py -l "/path/to/your_file_1.lakebook" "/path/to/your_file_2.lakebook" -o "/target/root"。始终显式传入 -l 和 -o,不依赖交互模式。

已知问题:部分语雀导出正文含 <!doctype lake>,旧实现可能导出成 lake## 标题,当前内置实现已处理。

导出后检查:.md 文件是否生成、同名 .assets 目录是否生成、内部链接是否转为相对 Markdown 路径、图片在 Obsidian 中能否正常显示、文档首行是否有异常 lake## 前缀。导出失败时优先查看输入 .lakebook 同目录下生成的批量日志。详细行为、输出规则和排查说明见 references/usage.md。