A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
EPUB 构建脚本
功能
这个脚本会把整份指南构建成 EPUB 电子书,方便离线阅读。
需求
- Python 环境
uv- 相关依赖
- Node.js >= 20(Mermaid 图表由固定版本的 Pele 渲染,首次运行时下载并缓存到
scripts/.vendor-cache/pele/)
快速开始
最简单的方式是直接让 uv 帮你处理依赖:
uv run scripts/build_epub.py
开发环境
如果你要修改脚本本身,可以先创建虚拟环境,再安装开发依赖。
# 创建虚拟环境
# 激活并安装依赖
# 运行测试
# 运行脚本
命令行选项
常见选项包括:
- 指定输出路径
- 打开详细日志
- 限制并发请求
示例
# 带详细输出构建
# 指定输出位置
# 限制并发数(遇到限流时)
输出
脚本会生成 EPUB 文件,里面包含所有内容和渲染后的图表。
运行测试
你可以用虚拟环境或直接通过 uv 运行测试。
依赖
脚本依赖的包会在项目的开发依赖里列出。
故障排查
- 检查
uv是否可用 - 检查 Python 版本
- 检查依赖是否安装完整
- 检查
node --version是否 >= 20;首次构建需要联网下载 Pele 包