kaf-cli

name kaf-cli description kaf-cli 是一个把 TXT 小说文本转成 EPUB/AZW3/MOBI 电子书格式的命令行工具。 当用户需要：转换小说 txt 到电子书格式、批量生成 epub、设置书籍封面、匹配章节目录、自定义电子书样式、 使用 kaf-cli 或 kaf-mcp 命令、了解 kaf-cli 的安装和参数用法时，都应该使用此 skill。 kaf-cli - TXT 转电子书工具 kaf-cli 可以把 TXT 文本小说快速转换为 EPUB、AZW3、MOBI 格式的电子书。支持自动识别编码、章节、书名作者，也支持自定义封面、CSS 样式等高级功能。 工具安装 详细安装说明请参考 references/installation.md 。 快速安装 平台 方式 Windows winget install kaf-cli 或从 GitHub Releases 下载 Linux (Arch) yay -S kaf-cli macOS 从 GitHub Releases 下载 darwin 版本 Linux (通用) 从 GitHub Releases 下载对应架构 下载文件名格式 kaf-cli_{version}_windows_amd64.zip - Windows 64 位 kaf-cli_{version}_windows_386.zip - Windows 32 位 kaf-cli_{version}_darwin_amd64.zip - macOS Intel kaf-cli_{version}_darwin_arm64.zip - macOS Apple Silicon kaf-cli_{version}_linux_amd64.zip - Linux 64 位 kaf-cli_{version}_linux_arm64.zip - Linux ARM64 kaf-cli_{version}_linux_loong64.zip - 龙芯 LoongArch64 Windows 和 macOS 版本自带 kindlegen，可直接生成 mobi 格式。Linux 需单独安装 kindlegen 才能生成 mobi。 基本使用 拖拽模式（最简单） 把 txt 文件直接拖到 kaf-cli.exe （Windows）或 kaf-cli （Linux/Mac）可执行文件上即可自动转换。如果目录下有 cover.png 文件会自动添加为封面。 命令行简单模式 kaf-cli 全职法师.txt 命令行完整模式 kaf-cli -filename 全职法师.txt -author 乱 -format epub 常用参数 参数 默认值 说明 -filename (必填) txt 文件路径 -author YSTYLE 作者 -bookname 文件名 书名，默认从文件名自动识别 -cover cover.png 封面：本地图片路径、 orly （在线生成 O'Rly 风格封面）、 none （无封面） -format epub 输出格式： epub 、 mobi 、 azw3 、 all （全部格式） -match 自动 章节匹配正则表达式，不填自动识别 -volume-match 自动 卷匹配正则，设为 false 禁用卷识别 -lang zh 语言：en,de,fr,it,es,zh,ja,pt,ru,nl -indent 2 段落缩进字数 -align center 标题对齐：left、center、right -out 书名 输出文件名（不含后缀） -font 无 嵌入字体文件路径 -line-height 1.5rem 行高/行间距 -bottom 1em 段落间距 -max 35 标题最大字数 -custom-css-file 无 自定义 CSS 文件路径 -separate-chapter-number false 分离章节序号和标题样式 -tips true 添加软件教程到书中 -exclude 自动 排除无效章节的正则 完整参数说明和更多示例请参考 references/cli-reference.md 。 使用示例 基本转换 # 最简用法，自动识别书名和章节 kaf-cli 小说.txt # 指定作者 kaf-cli -filename 小说.txt -author "作者名" # 指定输出格式 kaf-cli -filename 小说.txt -format all 自定义章节匹配 # 章节格式为 "第x节" kaf-cli -filename ebook.txt -match "第.{1,8}节" # 章节格式为 "Section 1" ~ "Section 100" kaf-cli -filename ebook.txt -match "Section \d+" # 章节格式为 "Chapter xxx" kaf-cli -filename ebook.txt -match "Chapter .{1,8}" 使用 O'Rly 风格封面 # 自动生成随机封面 kaf-cli -filename 小说.txt -cover orly # 指定封面主题色和动物图案 kaf-cli -filename 小说.txt -cover orly -cover-orly-color "#ff6600" -cover-orly-idx 5 自定义 CSS 样式 kaf-cli -filename 小说.txt -custom-css-file mystyle.css 可用 CSS 类名： h2.volume - 卷名样式 h3.title - 章节标题样式 h3.title span.chapter-number - 章节序号样式 .content - 正文段落样式 body - 整体样式 环境变量 可以通过环境变量修改默认值： export KAF_CLI_ALIGN=left # 默认标题对齐方式 export KAF_CLI_LANG=zh # 默认语言 export KAF_CLI_FORMAT=epub # 默认输出格式 文件名自动识别 支持知轩藏书格式文件名自动提取书名和作者： 《希灵帝国》（校对版全本）作者：远瞳.txt → 书名：希灵帝国，作者：远瞳 《希灵帝国》作者：远瞳.txt → 书名：希灵帝国，作者：远瞳 MCP 版本（kaf-mcp） kaf-cli 还提供了 MCP (Model Context Protocol) 服务器版本，可集成到 AI 助手中使用。详细说明请参考 references/mcp-usage.md 。 MCP 快速配置 从 GitHub Releases 下载 kaf-mcp（与 kaf-cli 在同一个 Release） 在 AI 工具中配置 MCP 服务器，命令指向 kaf-mcp 路径 设置环境变量 KAF_DIR 为小说文件所在目录 在 AI 对话中直接请求转换小说即可 常见问题 中文乱码 kaf-cli 自动识别字符编码，无需手动处理。 章节没有生成 使用 -match 参数指定章节匹配规则，例如 -match "第.{1,8}章" 。 MOBI 格式生成 需要 kindlegen 程序。Windows 和 macOS 版本已自带，Linux 需单独下载。 在任意位置使用 Windows : 把 kaf-cli.exe 放到 C:\Windows\ 下 Linux/Mac : 把 kaf-cli 放到 PATH 目录中，如 /usr/local/bin/