1. 为什么技术书 PDF 一问就烧 token先说个我自己的真实场景。手头有一本 600 多页的《深入理解 Java 虚拟机》还有几本 DDIA、Redis 设计与实现之类的电子书。以前我的做法很粗暴把整本 PDF 用脚本抽成纯文本然后一股脑塞进对话上下文让模型基于全文回答。结果就是——问一个「方法区垃圾回收怎么触发」的小问题输入 token 直接飙到十几万一次问答成本高得离谱而且模型还经常在长上下文里「走神」答得似是而非。问题的本质不是模型不行而是检索方式错了。每次提问都重新把整本书读一遍等于每问一次就交一次「翻书税」。book-to-skill 这个项目GitHub 上 24k Star解决的正是这件事它在转换阶段把 PDF 一次性蒸馏成结构化的 Agent 技能之后每次问答只加载相关章节实测能把单次问答的 token 压到原来的 1/50 量级。这篇不讲空泛原理直接给你可复制的配置骨架settings.json怎么写、技能目录长什么样、怎么把一本 PDF 入库、怎么验证问答真的省了 token。适合已经在用 Claude Code、手里囤了一堆技术书 PDF、想让 AI「基于真实内容」回答而不是瞎编的人。2. TaoToken 前置给 Claude Code 接上稳定通道book-to-skill 本身是个技能生成器它最终要跑在 Claude Code 这类 Agent 宿主里。而 Claude Code 要调用模型就得先有一个可用的 API 通道。我这边统一用 TaoToken 来做模型接入原因是它把 Claude 系列模型的调用封装得比较干净配合 Claude Code 的settings.json直接填就行不用自己折腾转发层。你需要先拿到两样东西一个 API Key在控制台里创建一个 Base URLhttps://taotoken.net/api创建 Key 的入口在这里登录后进 API Keys 页面新建即可https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面试一下 Claude 的响应质量确认通道通了再往下走https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite注意API Key 只创建一次、只显示一次复制后立刻存到本地环境变量或配置文件里别贴在聊天窗口或公开仓库。对于长期要跑编码、Agent 任务的场景Coding Plan 会比按量付费更划算尤其是你打算把 book-to-skill 生成的技能反复调用的时候https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite3. 可复制配置settings.json 与技能目录骨架这一节是全文的核心直接给骨架你照着改路径就能用。3.1 Claude Code 的 settings.jsonClaude Code 读取的配置文件在~/.claude/settings.json。下面这份是我实测能跑通的版本把模型通道指向 TaoToken同时把技能目录挂进去{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 }, skills: { directory: ~/.claude/skills, autoLoad: true }, permissions: { allow: [ Read(~/.claude/skills/**), Bash(python3 scripts/extract.py:*) ] } }几个关键点解释一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址注意这里不要加任何 UTM 参数接口地址保持干净。ANTHROPIC_MODEL按你实际订阅的模型名填写错会直接报模型不存在。skills.directory是技能根目录book-to-skill 生成的东西都会落在这里。permissions.allow里放行技能目录的读取权限否则 Agent 加载章节文件时会被权限拦下来。3.2 技能目录骨架book-to-skill 转换完成后会在~/.claude/skills/slug/下生成一套结构化文件。以《深入理解 Java 虚拟机》为例slug 假设是jvm目录长这样~/.claude/skills/jvm/ ├── SKILL.md # 核心心智模型 章节目录约 4000 tokens ├── chapters/ │ ├── ch01-overview.md │ ├── ch02-memory.md │ ├── ch03-gc.md │ └── ... ├── glossary.md # 术语表按字母排序 章节引用 ├── patterns.md # 技巧、算法、设计模式汇总 └── cheatsheet.md # 决策表和速查规则这套结构的设计精髓在于按需加载。SKILL.md是常驻的「目录页」只有 4000 tokens 左右真正的章节文件每个约 1000 tokens你不问到那个主题它就不进上下文。这跟「把整本书糊进 prompt」是本质区别——前者是查手册后者是每次重读全书。3.3 安装 book-to-skill推荐用跨 Agent 的技能 CLI 一条命令装npx skills add virgiliojr94/book-to-skill如果你只想手动 clone 到 Claude Code 的技能目录git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill装完重启 Claude Code/book-to-skill这个命令就注册好了。4. 验证请求从 PDF 入库到一次省 token 的问答配置写完不算完得跑一遍完整链路验证。下面是我实测的步骤。4.1 PDF 提取工具的选择转换前 skill 会问你书是「技术书」还是「纯文字书」自动挑提取工具。对照表如下书类型工具安装速度纯文字散文、表格少pdftotextsudo apt install poppler-utils秒级纯文字备选pypdfpip install pypdf秒级技术书代码、表格、公式doclingpip install docling约 1.5s/页技术书务必用 docling它能保留 Markdown 表格和代码块纯散文用 pdftotext 更快。先检查环境里装没装python3 scripts/extract.py --check4.2 执行入库把 PDF 转成技能主模式一条命令/book-to-skill ./深入理解Java虚拟机.pdf jvm如果是整个文档文件夹或者一堆 markdown 笔记/book-to-skill ./docs/ /book-to-skill notes/*.md几百页的技术书用 docling 大概要几分钟正常。建议先拿一章或一个 md 试通流程再整本转。4.3 验证问答与 token 对比生成完成后直接按技能名提问/jvm 讲一下方法区的垃圾回收 /jvm 字节码里 invokedynamic 是怎么工作的关键验证动作是看 token 消耗。我实测下来同一个问题「方法区垃圾回收的触发条件」两种方式的输入 token 差距是这样的方式输入 token说明整本 PDF 塞上下文约 150000每次问答都重读全书book-to-skill 按需加载约 3000只加载 SKILL.md 相关章节量级上就是 50 倍左右的差距跟项目文档里说的 24×–51× 吻合。而且因为回答是从真实章节内容里检索出来的幻觉明显少了很多——它不会跟你编「JVM 有个 XXX 参数」而是直接引用书里的原文段落。5. 本篇常见错排查跑这套流程时我踩过几个坑列出来帮你省时间。报「检测到扫描版 PDF」直接停了。这是有意为之——skill 检查前几页发现没有文字层就停下来解释而不是硬转出一本空技能。解决办法是先 OCRocrmypdf input.pdf output.pdf然后再把output.pdf丢给 book-to-skill。技术书表格、代码转出来乱。大概率是提取器选错了。技术书一定要选 doclingpdftotext 对代码块和表格的保真度很差转出来的章节文件里代码全糊成一团。生成的技能找不到、命令没注册。确认装到了对应宿主的技能目录。Claude Code 是~/.claude/skills/别装错成 Copilot 的~/.copilot/skills/。装完记得重启 Claude Code否则新技能不会被扫描到。大书转得慢。docling 约 1.5s/页几百页的书要几分钟这是正常的不是卡死。可以先从一章试起。隐私和版权。转换是本地进行的书不出你的机器。但生成技能后如果用了「发布到 GitHub」功能默认是 private别改成 public 泄露版权内容。模型调用报 401 或模型不存在。回头检查settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY是否填对Base URL 不要带多余参数。如果 Key 有问题去 API Keys 页面重新生成一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节和参数说明可以对照官方文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite6. 把书架变成 Agent 的外挂大脑book-to-skill 抓的是 Agent 生态里一个很实在的痛点知识资产怎么变成 Agent 能直接调用的技能。它的答案是「结构化 按需加载 一次付费」而不是「每次糊进上下文」。对我们这种天天跟 Claude Code 打交道的人一条npx skills add命令就能把吃灰的技术书变成随时可查的外挂大脑。如果你打算长期跑编码和 Agent 任务把模型通道固定下来会更省心。Coding Plan 适合高频调用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite想先验证模型质量再决定就去对话页面直接试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite最后给个实用建议别一上来就转整本书。先挑你最常翻的那一章转成技能用一周感受一下「问一句、秒回、还带章节引用」的体验。确认流程顺了再批量把书架上的 PDF 都入库。这样既不会一次性卡在转换上也能早点用起来。