用 UltraEdit 实现编码转换：TaoToken 统一 Key 通道下的配置文件骨架与验证动作
2026/9/26 10:41:34
1. 为什么你的 Obsidian 笔记库需要 LLM-Wiki
如果你用 Obsidian 记了半年以上笔记，大概率会遇到同一个尴尬：笔记越攒越多，真正回头翻的却没几篇。剪藏的文章躺在raw/里吃灰，概念页写了开头就烂尾，双链越连越乱，最后整个 vault 变成一个只进不出的仓库。这不是你懒，而是"整理"这件事本身没有即时反馈，人很难长期坚持。
LLM-Wiki 想解决的就是这个矛盾。它的核心思路不是让 AI 在你提问时临时检索一下，而是把 Claude 变成知识库的"常住管理员"：新内容进来时由它提取要点、更新概念页、补双向链接、写操作日志；你提问时它先读 wiki 再回答，好答案还能存回 wiki 变成新页面。整套流程围绕三种操作循环——Ingest（摄入）、Query（查询）、Lint（健康检查）。
这篇教程聚焦落地：怎么把 Obsidian 笔记库通过 CLAUDE.md 和 config.toml 接进 Claude Code，怎么用 TaoToken 统一 Key 和 API 通道，最后用一次真实问答验证知识库检索是否生效。适合已经在用 Obsidian、想给笔记库加一层 AI 养护能力的技术人。全程可跟做，命令和配置都能直接复制。
2. 前置准备：TaoToken 通道与 Claude Code 环境
在动手改 vault 之前，先把"AI 怎么连进来"这件事解决掉。Claude Code 默认走 Anthropic 官方通道，国内直连经常超时，而且多项目共用时 Key 管理很乱。TaoToken 在这里扮演的是统一 API 网关的角色：一个 Key 覆盖 Claude 系列模型，base_url 指向https://taotoken.net/api，Claude Code、Claudian 插件、脚本调用都能复用同一套凭证。
你需要准备三样东西：
第一，一个 TaoToken 账号和 API Key。登录官网https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=注册后，进控制台创建 Key。建议给知识库项目单独建一个 Key，方便后面按项目排查用量。
第二，安装 Claude Code。它是命令行 Agent，能读文件、改多个文件、跑脚本，LLM-Wiki 的 lint 和批量建链都靠它。安装命令：
npm install -g @anthropic-ai/claude-code claude --version第三，确认 Obsidian 已装好，并且你的 vault 是本地 Markdown 存储（不是同步到封闭云端的模式）。LLM-Wiki 的前提就是 AI 能直接读写.md文件，本地 vault 天然满足。
环境变量配置是这一步的关键。Claude Code 读取ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两个变量，把它们指向 TaoToken 即可：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="sk-你的TaoToken密钥"Windows 用户在 PowerShell 里用$env:ANTHROPIC_BASE_URL="https://taotoken.net/api"的写法，或者直接写进系统环境变量。配完执行claude能正常进入对话，说明通道通了。这一步别跳过，后面 Claudian 插件和 Claude Code 都依赖它。
3. 可复制配置：CLAUDE.md 与 config.toml 骨架
通道通了，接下来给 AI 立规矩。LLM-Wiki 能不能跑顺，八成取决于这两个文件写得好不好。
3.1 目录结构先定下来
在 vault 根目录建好这套结构，AI 才知道什么能改、什么不能碰：
my-knowledge-base/ ├── inbox/ # 收集箱，新内容先扔这 ├── raw/ # 原始来源，只读，AI 绝不修改 │ ├── articles/ │ ├── books/ │ └── papers/ ├── wiki/ # 维基站，AI 维护 │ ├── concepts/ # 概念页 │ ├── entities/ # 实体页 │ ├── sources/ # 来源总结 │ ├── index.md # 内容索引 │ └── log.md # 操作日志 └── notes/ # 个人笔记，共同维护raw/只读这条规则很重要。原始剪藏一旦被 AI 改写，你就失去了溯源依据，所以要在规范里明确写死。
3.2 CLAUDE.md 骨架
在 vault 根目录新建CLAUDE.md，这是给 Claude 看的职责说明书：
# LLM Wiki Schema ## 角色 - 用户：sourcing、提问、价值判断 - AI：总结、关联、维护 bookkeeping ## 目录权限 - raw/：只读，禁止修改 - wiki/：AI 全权维护 - notes/：共同维护，改动前先问 ## 三种操作 ### Ingest 1. 读取来源内容 2. 在 wiki/sources/ 建总结页 3. 更新相关 concept/entity 页 4. 在 wiki/index.md 加条目 5. 在 wiki/log.md 追加：## [YYYY-MM-DD] ingest | 标题 ### Query 1. 先读 wiki/index.md 定位 2. 读相关 wiki 页 3. 综合回答并标注来源 4. 有价值的答案存回 wiki ### Lint 检查：断链、孤立页、过时信息、缺 frontmatter 格式：## [YYYY-MM-DD] lint | 摘要 ## 冲突处理 发现矛盾时先询问用户，不擅自覆盖3.3 config.toml 骨架
Claude Code 支持项目级配置。在 vault 根目录建.claude/config.toml，把模型和通道固定下来，避免每次手动 export：
[api] base_url = "https://taotoken.net/api" model = "claude-sonnet-4-5" [project] name = "my-knowledge-base" vault_root = "." [permissions] allow_write = ["wiki/**", "notes/**"] deny_write = ["raw/**"]deny_write里锁死raw/，等于给只读规则上了第二道保险。配置里的模型名按你 TaoToken 控制台实际可用的填，别照抄。
4. 验证请求：跑通第一次 Ingest 与 Query
配置写完，必须验证知识库检索真的生效，否则后面全是空中楼阁。
4.1 启动并确认工作根
cd ~/my-knowledge-base claudeClaude Code 会以当前目录为工作根。进去后先问一句"你现在的工作目录是哪里，能看到哪些文件夹"，确认它读到了 vault 结构。
4.2 第一次 Ingest
往inbox/丢一篇 Markdown 文章，然后在 Claude Code 里说：
把 inbox/ 里的那篇文章 ingest 一下预期它执行：读原文 → 在wiki/sources/生成总结页 → 更新相关概念页 → 在index.md加一行 → 在log.md追加带日期的记录。跑完你去 Obsidian 里刷新，应该能看到新文件。
4.3 用 Query 验证检索
这是判断"知识库检索是否生效"的关键一步。问一个只有你笔记里才有的问题，比如：
根据我的 wiki，我之前对 RAG 和 LLM-Wiki 的区别是怎么记的？如果它先读wiki/index.md定位，再引用具体页面内容回答，并标注来源文件，说明检索链路通了。如果它凭空泛泛而谈、不引用你的文件，那就是没读到 wiki，回去检查 CLAUDE.md 里的 Query 流程和目录权限。
4.4 跑一次 Lint
lint 一下正常会输出分级报告：断链几处、孤立页几个、缺 frontmatter 几页。看到这份报告，整套 LLM-Wiki 就算立起来了。
5. 本篇常见错排查
报错一：401 Unauthorized或invalid api key。九成是环境变量没生效或 Key 写错。先echo $ANTHROPIC_AUTH_TOKEN确认值在，再确认ANTHROPIC_BASE_URL是https://taotoken.net/api（注意结尾不要多加/v1）。改完变量要重开终端。
报错二：Claude 读不到 vault 文件。检查是不是在 vault 根目录启动的claude。如果你在子目录启动，工作根就错了。另外确认.claude/config.toml里vault_root = "."没写错。
报错三：AI 改了raw/里的原文。说明权限没锁死。回到config.toml确认deny_write包含raw/**，并在 CLAUDE.md 里再强调一次只读。双保险缺一不可。
报错四：Query 不引用笔记，直接编答案。通常是wiki/index.md是空的，AI 定位不到内容。先跑一次 Ingest 把索引填起来，再试 Query。
报错五：Claudian 插件连不上。插件依赖本机 Claude CLI 路径，去插件设置里把 CLI 路径填对，并确认终端里claude能正常跑。插件和 Claude Code 共用同一套 TaoToken 环境变量。
报错六：lint 报大量断链。别慌，这是正常的。第一次 lint 就是照妖镜，按报告逐条修：断链补建页面或改链接，孤立页加 inbound link，缺字段补 frontmatter。修完再 lint 一次对比。
6. 把通道和规范固定下来，让知识库自己生长
走到这里，你已经有了一个能自己摄入、自己检索、自己体检的知识库。剩下的就是把它变成日常习惯：读完一篇文章顺手 ingest，每周跑一次 lint，遇到好答案让 AI 存回 wiki。
如果你还没配好 Key，先去 TaoToken 控制台把 API Key 建出来，接入文档里有各客户端的详细参数；想先验证模型回答质量，可以直接用模型对话试几轮；如果你打算长期跑 Claude Code 做编码和 Agent 任务，Coding Plan 的额度模型更适合高频调用。通道稳定了，CLAUDE.md 和 config.toml 这两份骨架就能一直复用，你的 Obsidian 笔记库也就真正从"死海"变成了会生长的活物。