Karpathy-AI + Obsidian 个人知识库搭建完整指南

2026-07-14 田子越 技术分享

⚠️ 国内用户必读:Claude Code 存在高危安全风险,请勿直接使用

2026 年 7 月 8 日,工业和信息化部 NVDB(网络安全威胁和漏洞信息共享平台)正式发布高危风险提示: Claude Code 2.1.91 ~ 2.1.196 版本内置隐蔽监控后门,未经用户授权静默向境外服务器回传用户地域、设备标识、账号身份、研发代码、项目文档等核心敏感数据。

行业反应:阿里巴巴已于 7 月 10 日起全员禁用 Claude Code 及 Anthropic 全系产品;腾讯早在 2025 年 11 月已将其移出大模型选择池;美团、京东等也已限制外部 AI 模型调用。

本文方案:以下所有涉及 Claude Code 的位置,均已替换为国产合规替代方案(iFlow CLI / Kimi Code CLI / CodeBuddy),功能一致、数据不出境、完全免费。详见第零章·附的方案对比。

零·附:Claude Code 国产平替方案详解

💬 实问实答:在整理本文时,我意识到一个关键问题——Claude Code 在国内不仅网络访问困难,还存在严重的安全合规隐患。于是向 AI 助手追问:"Claude Code 能够替换吗?能不能用国内的模型?" 以下是完整解答。

0.1 为什么必须替换 Claude Code

  • 数据出境风险:Claude Code 拥有系统最高权限(读代码库、编辑文件、执行命令),其后门机制可绕过用户授权静默回传数据,跨境电商的供应链信息、客户数据、系统代码均在风险范围内。
  • 网络不可用:Anthropic API 在国内无法直接访问,需要科学上网环境,稳定性无法保证。
  • 合规红线:工信部已定调高危,大厂已全面切割。对于企业级应用,继续使用 Claude Code 存在合规审查风险。

0.2 三大国产替代方案对比

方案iFlow CLI(阿里心流)Kimi Code CLI(月之暗面)CodeBuddy Code(腾讯)
定位Claude Code 功能最完整的平替,免费开源Moonshot 官方 CLI Agent,中文理解极好已在本文撰写中实际使用,零迁移成本
支持模型Kimi K2、Qwen3 Coder、DeepSeek V3、GLM 等Kimi 系列模型混元 + 多模型切换
安装方式npm install -g @iflow/iflow-clinpm install -g @moonshot-ai/kimi-codeIDE 插件 / CLI / 独立 IDE 三形态
费用免费(心流开放平台提供 API Key)需 Kimi API Key(有免费额度)个人版免费
数据安全推理在国内,代码不出境推理在国内,代码不出境腾讯云部署,数据不出境
Karpathy 工作流兼容✅ 完美兼容(文件读写 + Shell + Skills)✅ 完美兼容✅ 完美兼容(本文即用此工具撰写)
推荐场景⭐ 首选推荐:功能最全、免费、开源已在 Kimi 生态中的用户已在腾讯云 / 微信生态中的用户

0.3 本文的后续约定

为保持内容简洁,下文将以 iFlow CLI 作为默认 AI 引擎进行演示。所有命令行中的 iflow 均可替换为 kimi(Kimi Code CLI)或直接使用你当前打开的 CodeBuddy(无需额外安装 CLI)。核心原理完全一致。

一、为什么需要这套系统

1.1 传统笔记的三大死穴

  • 收藏即遗忘 :存了 500 篇文章,从没再打开过——因为没有消化环节,信息只是堆积,从未内化为知识。
  • 知识孤岛 :笔记之间零散无关联,搜索只能靠关键词匹配。你明明记过某个概念,但就是找不到它在哪篇笔记里。
  • 检索靠运气 :ChatGPT 上传文件、NotebookLM、传统 RAG——每次提问 AI 都从你的原始资料里现找答案。下一次会话?什么都不记得了。没有积累,只有一次性检索。

1.2 Karpathy 的解法:把整理工作全部外包给 AI

2026 年 4 月,前 OpenAI 联合创始人、特斯拉 AI 总监 Andrej Karpathy 在 X(Twitter)上公开了他的个人知识库工作流,两天内获得 1900 万次曝光、5000+ GitHub Star。

核心思路极度简单: 不让 AI 每次提问时翻原始资料,而是让 AI 先把所有资料"编译"成一个结构化的 Wiki 。里面有摘要、有交叉引用、有概念连接,也会显式标出互相矛盾的地方。这一切都由 AI 维护,你只管读和提问。

一个核心类比:
Obsidian = IDE(开发环境)
LLM = 程序员(写代码的人)
Wiki = 代码库(编译产物)

你负责策展和提问,AI 负责所有繁琐的维护——摘要、分类、交叉链接、更新索引、标注矛盾。

二、核心架构:三层 + 四个工作流

2.1 系统架构全景图

整套系统没有任何花哨组件,没有向量数据库,没有 Embedding,没有 RAG 框架——只有文件夹 + Markdown 文件 + AI。

层级目录职责类比
输入层raw/原始资料(文章、论文、截图、笔记),只进不改,AI 只读src/ 源代码
编译层wiki/AI 自动维护的结构化知识页,你来读,AI 来写build/ 编译产物
输出层outputs/AI 生成的报告、分析、问答沉淀logs/ 运行日志
规则层AGENT.mdAI 的"工作说明书",定义 Wiki 如何组织、如何更新Makefile 构建规则

2.2 四个核心工作流

📥 Phase 1 — Ingest(摄入)

用 Obsidian Web Clipper 一键将网页保存到 raw/,或直接把 PDF/论文/笔记丢进去。然后告诉 AI"帮我消化这篇文章"。

🔧 Phase 2 — Compile(编译)

AI 自动读取 raw/ 中的新资料,生成摘要页、概念页、实体页,更新索引和日志,建立所有页面之间的双向链接。

🔍 Phase 3 — Query(查询)

用自然语言提问,AI 先读 index.md 定位相关页面,再综合多篇文章给出带引用来源的答案。高质量的答案可以存回 wiki/ 沉淀。

🧹 Phase 4 — Lint(维护)

定期让 AI 做健康检查:找出矛盾结论、过时信息、孤立页面、缺失的交叉引用、数据缺口,输出检查报告并自动修复。

三、环境准备与工具安装

3.1 系统要求

  • 操作系统:Windows 10/11、macOS、Linux 全平台支持
  • Node.js 18+(iFlow CLI / Kimi Code CLI 的运行时依赖)
  • 硬盘空间:至少 2GB(取决于资料量)
  • 内存:8GB 及以上(推荐 16GB)
  • 无需科学上网,国内网络直接可用

3.2 安装 Node.js

  1. 访问 https://nodejs.org ,下载 LTS(长期支持)版本
  2. 双击安装包,一路 Next,保持默认选项即可
  3. 安装完成后,打开终端(Win+R 输入 cmd)验证:
    node --version (应显示 v18.x 或 v20.x)
    npm --version (应显示 9.x 或 10.x)

3.3 安装 Obsidian(知识库容器)

  1. 访问官方下载页: https://obsidian.md/download
  2. 下载对应系统的安装包,双击安装
  3. 打开 Obsidian → 点击 「创建新仓库」 → 选择一个文件夹位置
  4. 建议将仓库放在云同步文件夹中 (如 OneDrive / iCloud),这样多设备自动同步且天然备份
  5. 仓库名称自定义,例如:my-knowledge-base

为什么选 Obsidian?

  • 所有文件是纯文本 Markdown,任何编辑器都能打开,不会被云服务锁定
  • 双向链接 [[页面名]] 让知识之间自动互相关联
  • 知识图谱(Graph view)可直观看到整个知识网络
  • 800+ 社区插件,可高度定制
  • 完全免费,本地优先,数据 100% 在你自己的电脑上

3.4 安装 Obsidian Web Clipper(网页剪藏)

  1. 在 Chrome / Edge / Firefox 扩展商店搜索 "Obsidian Web Clipper"
  2. 点击安装并固定到浏览器工具栏
  3. 配置保存路径:点击 Clipper 图标 → 设置 → 将默认保存文件夹改为 raw/articles/
  4. 以后看到好文章,点一下图标,文章自动转为干净 Markdown 存入 Obsidian

3.5 安装 AI 引擎(iFlow CLI — 首选推荐)

iFlow CLI 是阿里心流团队开源的终端 AI Agent,功能完整对标 Claude Code,且永久免费、数据不出境、支持国产顶尖模型。 基准测试(GAIA、SWE-bench、Terminal-Bench)综合表现优于 Claude Code。

  1. 打开终端(Win+R 输入 cmd),执行:
    npm install -g @iflow/iflow-cli
  2. 验证安装:
    iflow --version
  3. 获取免费 API Key: 访问心流开放平台 https://open.iflow.cn,注册账号后即可获取免费 API Key(支持 Kimi K2、Qwen3 Coder、DeepSeek V3 等模型),无需自备任何付费 Key。
  4. 首次启动配置:终端输入 iflow,按提示粘贴 API Key 即可
  5. 日常使用:cd 到知识库目录后输入 iflow 进入交互模式

3.5·附 备选方案:Kimi Code CLI

如果你更偏好 Kimi 生态,月之暗面的 Kimi Code CLI 是同样优秀的替代:

  1. npm install -g @moonshot-ai/kimi-code(需 Node.js 24+)
  2. platform.kimi.com 获取 API Key
  3. 用法与 iFlow CLI 基本一致:kimi 进入交互模式,kimi -p "任务" 执行单次命令
💡 你已经在用了: 如果你当前正在 CodeBuddy(腾讯 WorkBuddy)中阅读本文——恭喜,你不需要额外安装任何 CLI 工具。 CodeBuddy Code 本身就支持 CLI、IDE 插件、独立 IDE 三形态,且本文的调研、撰写、代码修改全部由 CodeBuddy 完成。 直接在 CodeBuddy 对话中进入你的知识库目录,即可执行所有 Karpathy 工作流操作。

3.6 安装 Obsidian AI 辅助插件(可选,图形化桥接)

Claudian(原来的 Claude Code Obsidian 桥接插件)依赖 Anthropic API,在国内不可用。 以下推荐两个国产兼容的替代方案:

  1. Text Generator 插件(推荐): 打开 Obsidian → 设置 → 第三方插件 → 浏览 → 搜索 "Text Generator" → 安装启用。 该插件支持自定义 API 端点,可接入 DeepSeek / Qwen / Kimi 等国内模型的 API。
    配置:设置 → Text Generator → Provider 选择 "Custom" → 填入你的国内模型 API 地址和 Key。
  2. Copilot 插件(备选): 同样在 Obsidian 插件市场搜索 "Copilot",安装启用后支持接入 OpenAI 兼容 API,包括国内模型的兼容端点。
  3. 直接用终端(最推荐): 实际上,在终端中运行 iFlow CLI / Kimi Code CLI + Obsidian 窗口并排是最佳体验——CLI 负责 AI 操作,Obsidian 负责浏览和阅读,无需在 Obsidian 内部嵌入 AI 面板。

3.7 安装 Graphify 插件(可选,知识图谱增强)

Graphify 在 Obsidian 原生图谱基础上,增加了社区发现、语义关联和知识补全建议功能。

  1. Obsidian → 设置 → 第三方插件 → 浏览
  2. 搜索 "Graphify" → 安装 → 启用
  3. 启用后,左侧边栏会出现 Graphify 面板,提供智能图谱分析

3.8 工具链总览

工具作用必要性费用
Obsidian知识库容器,Markdown 编辑器 + 图谱浏览必需免费
Obsidian Web Clipper网页一键剪藏到 raw/强烈推荐免费
iFlow CLIAI 引擎,负责编译/查询/维护(首选推荐)必需免费
Kimi Code CLIAI 引擎备选方案备选免费额度
Text GeneratorObsidian 内嵌 AI 面板(接入国内模型)推荐免费 + API 费用
Graphify知识图谱增强分析可选免费
Git版本控制,追踪 Wiki 变化可选免费

四、目录结构设计

4.1 完整目录树

在你的知识库根目录下,按照以下结构创建文件夹:

Windows 用户可以直接用文件管理器创建,也可以打开终端执行:
mkdir -p my-knowledge-base/raw/{articles,papers,podcasts,assets}
mkdir -p my-knowledge-base/wiki/{indexes,concepts,entities,sources,summaries}
mkdir -p my-knowledge-base/outputs/{qa,reports,blog}
mkdir -p my-knowledge-base/.ai/commands
cd my-knowledge-base && touch AGENT.md wiki/indexes/All-Sources.md wiki/indexes/All-Concepts.md wiki/log.md
路径用途谁来操作
raw/articles/网页文章(Web Clipper 剪藏)你来添加
raw/papers/论文、PDF 文档你来添加
raw/podcasts/播客转录文本你来添加
raw/assets/图片、截图、图表你来添加
wiki/concepts/概念条目(一个概念一个文件)AI 维护
wiki/entities/人物/公司/产品等实体页AI 维护
wiki/sources/每篇原始资料的摘要页AI 维护
wiki/summaries/主题级别的综合总结AI 维护
wiki/indexes/All-Sources.md(资料索引)、All-Concepts.md(概念索引)AI 维护
wiki/log.md按时间顺序的操作日志,仅追加不修改AI 维护
outputs/qa/高质量的问答沉淀AI 输出
outputs/reports/综合分析报告AI 输出
outputs/blog/可发布的博客文章AI 输出
.ai/commands/AI CLI 自定义快捷命令(原 Claude Code 的 .claude/ 目录)你来定义
AGENT.mdAI 工作说明书(整个系统的灵魂,模型无关)你来编写

4.2 目录设计原则

  • raw/ 永不修改 :原始资料是真相源,只追加不修改。AI 只能读取 raw/ 中的内容,绝不能编辑里面的文件。
  • wiki/ 全权交给 AI :你几乎不需要手动编辑 wiki/ 中的任何文件。AI 负责创建、更新、维护所有 wiki 页面。
  • outputs/ 可沉淀复用 :每次你向 AI 提问得到的好答案,都可以保存到 outputs/,下次直接引用,不会消失在聊天记录里。

五、编写 AI 工作说明书(AGENT.md)

这是整个系统最关键的配置文件。它决定了 AI 是"有纪律的 Wiki 维护者"还是"随便聊天的机器人"。 每次启动 iFlow CLI / Kimi Code CLI / CodeBuddy 时都会自动读取这个文件(不同工具可能用不同文件名,如 AGENT.mdCLAUDE.mdCODEX.md,但内容是通用的)。

5.1 完整模板(可直接复制使用)

在知识库根目录创建 AGENT.md(或你所用工具对应的文件名),将以下内容复制进去,再根据自己的领域修改 Focus Areas 部分:

# Knowledge Base Schema ## Identity This is a personal knowledge base about [你的领域,如:跨境电商 / 俄罗斯市场 / Ozon运营]. Maintained by an LLM agent. The human curates sources and asks questions; the LLM does everything else. ## Architecture - raw/ stores immutable source documents. NEVER modify files in raw/. - wiki/ stores compiled wiki pages. This directory is fully LLM-maintained. - outputs/ stores generated reports, analyses, and answers. ## Wiki Conventions - Each topic gets its own .md file in wiki/ - Every wiki file begins with YAML frontmatter: --- title: [Topic Name] created: [YYYY-MM-DD] last_updated: [YYYY-MM-DD] source_count: [N] status: [draft | reviewed | needs_update] tags: [tag1, tag2] --- - After frontmatter, start with a 2-3 sentence summary - Use [[topic-name]] for internal links between wiki pages - Every factual claim must cite its source: [Source: filename.md] - When new info contradicts existing content, explicitly mark: > ⚠️ CONTRADICTION: [old claim] vs [new claim] from [source] ## Index & Log - wiki/indexes/All-Sources.md: catalog of all ingested sources with one-line summaries - wiki/indexes/All-Concepts.md: catalog of all concept pages organized by category - wiki/log.md: append-only chronological log Log format: ## [YYYY-MM-DD] action | Description Actions: ingest | query | lint | update ## Ingest Workflow When processing a new source: 1. Read the source document completely 2. Discuss key takeaways with the user 3. Create or update a summary page in wiki/sources/ 4. Extract concepts → create/update pages in wiki/concepts/ 5. Extract entities → create/update pages in wiki/entities/ 6. Update wiki/indexes/All-Sources.md and All-Concepts.md 7. Add backlinks from existing pages to the new content 8. Mark any contradictions with existing wiki content 9. Append an entry to wiki/log.md 10. A single source should typically affect 10-15 wiki pages ## Query Workflow When answering a question: 1. Read wiki/indexes/All-Concepts.md to find relevant pages 2. Read all relevant wiki pages 3. Synthesize an answer with citations: [Source: page-name] 4. If the answer reveals valuable new insight, offer to save it to outputs/qa/ 5. Save high-value answers to outputs/ ## Lint Workflow (run monthly) Check for: - Contradictions between pages - Stale claims superseded by newer sources - Orphan pages with no inbound links - Important concepts mentioned but lacking their own page - Missing cross-references - Claims without source citations Output: wiki/lint-report-[date].md with severity levels ## Focus Areas - [你的核心主题 1,如:Ozon 平台运营策略] - [你的核心主题 2,如:俄罗斯跨境电商选品与定价] - [你的核心主题 3,如:AI 工具在电商中的应用] - [你的核心主题 4,如:跨境物流与供应链管理] - [你的核心主题 5,如:多平台 SEO 与广告优化]

5.2 关键配置项说明

  • Wiki Conventions :规定了每篇 Wiki 页面的格式标准——YAML 前置元数据、摘要段、双向链接语法、来源标注规范。这是 AI 保持输出一致性的基础。
  • CONTRADICTION 标记 :当 AI 发现新资料与已有 Wiki 结论冲突时,会显式标出矛盾而不是默默覆盖。这非常关键——知识不是一成不变的,你需要看到观点的演变过程。
  • Ingest Workflow 的 10 步流程 :明确了 AI 每次消化一篇文章要做什么。单篇资料通常会影响 10-15 个 wiki 页面(摘要页 + 多个概念页 + 多个实体页 + 索引 + 日志)。
  • Query Workflow :确保 AI 回答问题时不是拍脑袋,而是先查索引、读相关页面、再综合回答,并用 [Source: xxx] 标注依据。
  • Focus Areas :这是唯一需要你自己填写的地方,定义你的知识库聚焦哪些领域。AI 会围绕这些主题来组织和关联知识。

六、核心工作流详解

6.1 Ingest(摄入):让 AI 消化一篇新文章

这是最频繁的操作。每次你发现一篇有价值的文章或资料,执行以下流程:

  1. 收集素材: 用 Obsidian Web Clipper 将网页保存到 raw/articles/,或手动将 PDF/笔记放入 raw/ 对应子目录
  2. 打开终端,进入知识库目录:
    cd ~/my-knowledge-base
    iflow
  3. 对 AI 下达指令 (以下 Prompt 可直接使用):

    "读取 AGENT.md 中的规则。然后处理 raw/articles/ 里新增的文章。完整阅读它,先和我讨论关键收获,然后:在 wiki/sources/ 中创建摘要页,提取关键概念到 wiki/concepts/,更新 wiki/indexes/,补上反向链接,标记任何矛盾,追加日志。"
  4. 与 AI 对话: AI 会先总结文章要点,你可以告诉它哪些点你特别关注、哪些方向值得深挖
  5. 切换到 Obsidian 检查结果: 打开图谱视图(Graph view),你会看到新的节点和连接线出现在知识网络中
💡 最佳实践: Karpathy 本人建议一次只处理一篇资料,保持人工参与——读完 AI 生成的摘要,检查更新,告诉 AI 哪些点需要强调。不要批量丢入几十篇然后不管,那样质量会下降。

6.2 Compile(批量编译):一次性处理多篇资料

当你攒了多篇新资料后,可以批量编译。直接在 iFlow CLI 中输入:

"扫描 raw/ 目录,找出所有尚未编译的资料。按照 AGENT.md 中的 Ingest Workflow,逐篇处理。每完成一篇,告诉我进度。"

AI 会:

  • 扫描 raw/ 中所有文件,与 index 对比找出新资料
  • 逐篇生成摘要 → wiki/sources/
  • 提取概念 → wiki/concepts/(每个概念一个文件)
  • 提取实体 → wiki/entities/
  • 更新索引 → All-Sources.md、All-Concepts.md
  • 建立所有页面间的双向链接 [[]]
  • 追加操作日志 → wiki/log.md

6.3 Query(智能问答):跨文章知识检索

当知识库积累到一定规模(20+ 篇文章),你可以直接用自然语言提问:

示例提问:
"关于 Ozon 平台的定价策略,综合所有资料,帮我总结最佳实践,并指出不同资料之间的观点差异。"

"我读过的那篇关于俄罗斯消费者行为分析的论文里,提到了哪些关键洞察?这些洞察在其他资料中有没有佐证或反驳?"

"帮我对比文章中提到的三种物流方案(FBO / FBS / RFBS),列出每种方案的适用场景、成本和风险。"
💡 关键技巧:好答案要存回系统!
当 AI 给出一个高质量的对比分析或综合回答时,告诉它:"把这个回答保存到 outputs/reports/"
这样你的探索成果不会消失在对话历史里,而是沉淀为知识库的一部分,以后可以直接引用。

6.4 Lint(健康检查):定期维护知识库

每月执行一次,防止知识库腐化:

"对我的知识库做一次全面健康检查。按照 AGENT.md 中的 Lint Workflow,检查:页面之间的矛盾、被新资料推翻的旧结论、没有入链的孤立页面、缺失的交叉引用、没有标注来源的断言。输出检查报告到 wiki/lint-report-YYYY-MM-DD.md。"

AI 会检查并输出一份结构化报告,标明各项问题的严重级别,你可以据此决定哪些需要修复。

6.5 Output(成品输出):让知识库为你生产内容

积累了足够多的知识后,你可以让 AI 基于 Wiki 产出可直接使用的内容:

  • 综合分析报告"基于 wiki/ 中的全部资料,生成一份关于俄罗斯跨境电商市场现状的综合分析报告。"
  • 博客文章"根据 wiki/concepts/ 中关于俄罗斯消费者行为的内容,写一篇面向中国卖家的实战指南。"
  • 培训材料"把 Ozon 运营相关的所有 wiki 内容整理成一份新员工培训手册。"
  • 竞品分析"综合所有关于 Wildberries 的资料,做一份与 Ozon 的横向对比。"

七、Obsidian 推荐插件生态

以下插件能显著提升使用体验,按安装顺序排列:

插件作用优先级
Dataview用 SQL 式语法查询页面元数据,生成动态表格。如果你的 Wiki 页面有 YAML frontmatter(如 tags、date、source_count),Dataview 可以自动生成"最近更新"、"待审阅"等列表。⭐⭐⭐
Templater高级模板引擎,可创建 Wiki 页面的标准模板(如概念页模板、实体页模板),插入时自动填充日期、标题等元数据。⭐⭐⭐
Calendar日历视图,结合每日日志查看哪天做了什么操作(ingest/query/lint),与 wiki/log.md 互补。⭐⭐
Kanban看板视图,可以把"待消化文章"、"待深挖概念"、"待验证结论"做成看板卡片管理。⭐⭐
Excalidraw在 Obsidian 内手绘流程图、架构图、思维导图,作为知识的可视化补充。⭐⭐
Marp SlidesMarkdown 转幻灯片,直接从 Wiki 内容生成演示文稿,适合做技术分享和汇报。
Paste URL into selection选中文字后粘贴 URL 自动转为 Markdown 链接格式,建立外部引用更方便。

7.1 关键 Obsidian 设置

  1. 附件路径: 设置 → 文件与链接 → 附件文件夹路径 设为 raw/assets/ ,确保所有图片集中存放
  2. 图片本地化快捷键: 设置 → 快捷键 → 搜索 "Download attachments for current file" → 绑定 Ctrl+Shift+D。剪藏文章后按一次,所有图片自动下载到本地。
  3. 新建笔记位置: 设置 → 文件与链接 → 新建笔记的默认文件夹 设为 wiki/

八、进阶扩展

8.1 Git 版本控制

整个知识库就是一堆 Markdown 文件,天然适合 Git 管理:

  1. cd my-knowledge-base
  2. git init
  3. 创建 .gitignore,排除 .obsidian/workspace.json 等 Obsidian 内部文件
  4. git add . && git commit -m "init knowledge base"
  5. 后续每次 AI 大规模更新后:git add . && git commit -m "ingest: xxx"

好处:可以看到知识库的演变历史、比较不同版本的差异、出问题时可以回滚。还可以推送到 GitHub 做远程备份。

8.2 本地搜索引擎(qmd)

当知识库超过 100 篇文章时,仅靠 index.md 定位内容可能不够快。Karpathy 推荐使用 qmd——一个轻量级的本地 Markdown 搜索引擎:

  • 项目地址: https://github.com/tobi/qmd
  • 支持混合 BM25 + 向量搜索 + LLM 重排序
  • 完全本地运行,数据不出设备
  • 提供 CLI 和 MCP Server 两种接口,iFlow CLI 可以直接调用
  1. cargo install qmd(需要安装 Rust 环境)
  2. qmd index wiki/(对 wiki/ 目录建立索引)
  3. 之后 AI 可以通过 qmd search "关键词" 快速定位相关页面

8.3 Hook 自动化与增量更新

你可以在 AI CLI 中配置自定义命令(放在 .ai/commands/ 中),实现一键操作:

  • /ingest-all :自动扫描 raw/ 新文件并全部编译
  • /lint :一键执行 Lint 检查
  • /dashboard :生成知识库仪表盘(总文章数、概念数、最新更新、待处理项)

8.4 Dataview 动态查询示例

在 Obsidian 中创建一个"仪表盘"页面,插入以下 Dataview 查询块:

# 知识库仪表盘 ## 最近更新的页面 ```dataview TABLE last_updated, source_count, status FROM "wiki" SORT last_updated DESC LIMIT 10 ``` ## 标记为 needs_update 的页面 ```dataview TABLE last_updated, source_count FROM "wiki" WHERE status = "needs_update" SORT last_updated ASC ``` ## 概念索引(按标签) ```dataview TABLE tags, source_count FROM "wiki/concepts" SORT source_count DESC ```

九、实操案例:从零搭建跨境电商知识库

下面以我们的实际场景——俄罗斯跨境电商为例,完整演示从零搭建到首次使用的全流程。

9.1 场景设定

  • 领域:俄罗斯跨境电商(Ozon + Wildberries + Yandex Market)
  • 目标:建立一个能持续进化的运营知识库,沉淀平台规则、选品策略、广告优化、物流方案等知识
  • 初始资料:已有 5 篇 Ozon 运营文章、3 篇竞品分析报告、2 份物流方案文档

9.2 第一步:创建知识库并配置 AGENT.md

  1. D:\Documents\cross-border-wiki\ 创建目录结构(参考第四章)
  2. 编辑 AGENT.md,将 Focus Areas 设为:Ozon 平台运营策略、俄罗斯跨境电商选品与定价、AI 工具在电商中的应用、跨境物流与供应链管理、多平台 SEO 与广告优化
  3. 用 Obsidian 打开此文件夹作为 Vault

9.3 第二步:导入初始资料

  1. 将已有的 5 篇 Ozon 运营文章另存为 Markdown 放入 raw/articles/
  2. 将竞品分析报告、物流文档 PDF 放入 raw/papers/
  3. 打开终端:cd D:\Documents\cross-border-wiki && iflow

9.4 第三步:首次编译

在 iFlow CLI 中输入:

"读取 AGENT.md,扫描 raw/ 中的所有资料,逐篇执行 Ingest 流程。先处理文章,再处理报告和文档。每完成一篇,向我确认核心要点。"

AI 处理过程(约 5-10 分钟/篇):

  • 为每篇文章创建摘要页 → wiki/sources/ozon-ad-strategy.md
  • 提取核心概念 → wiki/concepts/ 下创建 FBO仓储模式、FBS发货模式、RFBS混合模式、DPP盈亏模型、加购率优化等页面
  • 提取实体信息 → wiki/entities/ 下创建 Ozon平台、Wildberries平台、俄罗斯物流公司等页面
  • 更新 All-Sources.md 和 All-Concepts.md 索引
  • 记录操作日志 → wiki/log.md

9.5 第四步:验证成果

切换到 Obsidian,你会看到:

  • 左侧文件列表中 wiki/ 下已经生成了 15-20 个结构化的 Markdown 页面
  • 打开图谱视图(Ctrl/Cmd + G),能看到一个以核心概念为节点的知识网络
  • 点击任意页面,内部有丰富的 [[]] 双向链接互相串联
  • 每篇摘要页底部有 YAML 前置元数据,可通过 Dataview 查询

9.6 第五步:持续使用

日常使用节奏:

  • 每天: 浏览俄罗斯电商相关文章时,用 Web Clipper 一键保存到 raw/,晚上让 AI 处理新增内容
  • 每周: 对 AI 提问,综合所有资料做一次深度分析(如"本周 Ozon 有哪些政策变动?对我现有策略有什么影响?")
  • 每月: 执行一次 Lint 检查,清理过时信息、补充缺失链接
  • 产出复用: 需要写运营报告或技术分享时,直接让 AI 基于 Wiki 生成初稿

十、Karpathy 方案 vs 传统方案对比

对比维度传统 RAG(ChatGPT 上传 / NotebookLM)Karpathy LLM Wiki
知识持久性每次从零检索,会话结束知识消失编译一次,永久累积,持续增长
交叉引用无(仅关键词匹配)自动建立双向链接 [[页面名]]
矛盾检测显式标记 CONTRADICTION
维护成本低(无需维护,但也无法积累)零(AI 全权维护)
技术门槛极低(网页上传即可)中等(需安装 Node.js + AI CLI)
数据可控性数据上传到云端服务数据 100% 本地,纯 Markdown 文件
可扩展性受平台限制无限(Git 版本控制、插件生态、自定义脚本)
成本免费(ChatGPT)/ $20/月(Plus)iFlow CLI / Kimi Code CLI 免费,其余工具全部免费
规模上限受单次上传限制(通常几十个文件)Karpathy 实测 100+ 文章、40 万字无压力
输出能力仅文本回答报告、博客、幻灯片、图表、对比表

十一、常见问题与排错

Q: 国内用户应该选哪个 AI 引擎?

首选 iFlow CLI(阿里心流),免费开源、功能最完整、支持国产模型、数据不出境。备选 Kimi Code CLI(月之暗面)同样优秀。如果你已经在用 CodeBuddy / WorkBuddy,可以直接用它,无需额外安装 CLI。核心要求不变:能读写本地文件夹中的 Markdown 文件即可。详见第零章·附的方案对比。

Q: AI 生成的 Wiki 质量不高?

检查 AGENT.md 是否写得足够详细。规则越具体,AI 输出越规范。可以在 Focus Areas 里列得更细化(不要只写"跨境电商",而是"Ozon 平台搜索排名算法、俄罗斯消费者价格敏感度、俄语关键词优化技巧")。

Q: 中文文章处理效果不好?

两个优化方向:(1) 在 AGENT.md 的 Identity 部分明确说明知识库主要语言是简体中文;(2) 使用 Web Clipper 剪藏前,确认文章是以 Markdown 格式而非纯 HTML 保存,格式越干净 AI 理解越准确。

Q: 知识库太大会不会变慢?

Karpathy 的实测数据:100 篇文章、约 40 万字的规模下,单纯靠 index.md 导航足够快,不需要向量数据库。如果未来超过 300 篇,可以安装 qmd 本地搜索引擎加速检索。

Q: 除了 iFlow CLI,还有什么替代方案?

除 iFlow CLI 外,Kimi Code CLI(月之暗面)、CodeBuddy Code(腾讯)都是优秀的国产替代。如果对数据安全有极高要求,可以本地部署 DeepSeek / Qwen-Coder / GLM-Coder 等开源模型,搭配 OpenCode 或 Cline 等开源 Agent 框架,实现完全离线运行、代码永不出本机。无论选哪个方案,Karpathy 工作流的核心原理完全不变。

Q: 图片怎么处理?AI 能看图片吗?

LLM 无法在一次读取中同时处理 Markdown 文本和行内图片。解决方法是分两步:(1) 先让 AI 读取 Markdown 文本内容;(2) 再让 AI 单独查看 raw/assets/ 中的图片文件。虽然略微繁琐,但效果足够好。建议在 Obsidian 中开启"自动下载附件"功能。

11.1 搭建实记:我在配置过程中遇到的真实问题

📝 说明:以下问答来自本文作者在实际搭建过程中的真实对话。AI 助手(CodeBuddy)研究并整理了本文的技术方案,但在作者准备落地时,发现了一个关键的合规问题。以下是完整记录。

❓ 问题一:Claude Code 在国内真的能用吗?

背景:文章初稿写完后,发现 Claude Code 需要 Anthropic API,而 Anthropic 在国内没有直接服务。更重要的是——

2026 年 7 月 8 日,工信部 NVDB 正式发布了关于 Claude Code 的高危安全风险提示。监测发现其 2.1.91~2.1.196 版本内置隐蔽监控后门,可绕过用户授权静默向境外传输数据。阿里巴巴已于 7 月 10 日起全员禁用,腾讯更早在 2025 年 11 月就已将其移除。

结论:不仅仅是"能用不能用"的问题,而是"用了会不会出事"的问题。对于跨境电商这类涉及供应链数据、客户信息的业务场景,Claude Code 存在不可接受的安全合规风险。

✅ 解法:国产 CLI Agent 完全可替代

核心认知:Karpathy 工作流本质上只需要一个能读写本地文件、能执行 Shell 命令的 AI Agent。任何支持这些能力的工具都能胜任,不绑定任何特定模型或厂商。

推荐方案:iFlow CLI(阿里心流)是 Claude Code 最完整的平替——免费、开源、支持 Kimi K2 / Qwen3 Coder / DeepSeek V3 等国产模型,基准测试综合表现优于 Claude Code。Kimi Code CLI(月之暗面)和 CodeBuddy Code(腾讯)同样是成熟方案。

本文即为证明:你现在看到的这篇文章,从调研、分析、撰写到代码修改,全程由 CodeBuddy(腾讯 CodeBuddy Code)完成——没有调用一次 Anthropic API。

❓ 问题二:换了工具后,工作流要变吗?

不变。核心流程(Ingest → Compile → Query → Lint → Output)完全一致。唯一不同的是:

· 启动命令从 claude 变为 iflow(iFlow CLI)或 kimi(Kimi Code CLI)
· 规则文件从 CLAUDE.md 变为 AGENT.md(内容通用)
· 不再需要科学上网,不再需要 $20/月订阅
· API Key 从心流开放平台 / Kimi 平台免费获取

实际使用体验几乎无差异——都是终端交互模式,都是自然语言对话。

❓ 问题三:数据安全怎么保证?

三个层面保障:

1. 传输层:国内模型的 API 推理全部在国内服务器完成,数据不出境。
2. 存储层:知识库本身就是本地 Markdown 文件,完全不依赖云端存储(Obsidian 是本地优先的)。
3. 极端方案:如果你对数据安全有极致要求,可以本地部署 DeepSeek / Qwen-Coder / GLM-Coder 等开源模型(Ollama),配合 OpenCode 等开源 Agent——实现完全离线运行,代码永不出本机。

❓ 问题四:2GB 内存的云服务器够用吗?推荐多大?

省流版:够用,但方案要选对。

2GB 内存不适合运行重型 Node.js 应用或 Docker + PostgreSQL 全家桶(如 Wiki.js、Outline 需要 2GB 以上), 但跑轻量级 Obsidian Web 浏览器完全没问题:
· Perlite(PHP): 内存占用 < 50MB,Docker 容器整体 < 100MB
· Silmaril(Python FastAPI): 内存占用 ~100MB
· VitePress 静态站点 + Nginx: 内存占用 < 30MB(最省资源)
· Obsidian-web(Go): 内存占用 ~50MB
推荐配置:2核 2GB 完全可跑,如果预算允许升级到 4GB 会更从容,但不升级也不是瓶颈。 详见 十一·附:云服务器部署方案

❓ 问题五:能否把知识库前端嵌入项目网页,随时随地查?

完全可以,而且有两种方式:

1. iframe 嵌入(推荐,零代码): 在 vueMaster 中新增一个路由页面,用 <iframe> 嵌入云服务器上的知识库 Web 界面。
2. 自定义 Vue 组件(深度集成): 用 Vue 2 + Element UI 写一个 Markdown 阅读器组件, 通过 API 从服务器拉取 Markdown 文件实时渲染。
无论是哪种方式,你都能在手机、平板、任何有浏览器的设备上访问知识库——而且因为是你自己的服务器,数据完全私密。 详见 十一·附:前端集成方案

十一·附:云服务器部署 + Web 前端集成方案

💬 实问实答:在文章完成后,作者继续追问了两个关键落地问题: "能在我的云服务器上搭建吗?2GB 内存够吗?"以及 "能否把知识库前端放入项目网页,随时随地进行知识查询和整理?" 以下是完整解答和操作方案。

附.1 云服务器上能跑知识库吗?—— 2GB 内存完全够用

结论先行:2GB 内存完全够用,但方案选择是关键。 云服务器的瓶颈不在 CPU,而在内存。2GB 的场景下,不能用"全家桶"式的重型方案(如 Wiki.js + PostgreSQL + Redis), 但轻量级的 Obsidian Vault Web 浏览器实测内存占用不到 100MB

附.1.1 四种轻量方案对比

方案技术栈内存占用部署方式支持功能推荐场景
PerlitePHP + Nginx(Docker)~80MBDocker 一行命令搜索、图谱、标签、Mermaid、LaTeX、Obsidian 主题首选推荐,最省心
SilmarilPython FastAPI~100MBpip install + 一行启动搜索、Obsidian 主题、移动端适配、代码高亮不用 Docker 的场景
VitePress 静态Vue 3 + Vite~20MB本地 build + Nginx 静态托管搜索、导航、主题追求极致性能
obsidian-webGo + Vue 3~50MBGo 二进制 + 前端搜索、图谱、LLM 集成、多仓库需要 LLM 集成的进阶场景

附.1.2 为什么不用 Obsidian Publish?

Obsidian 官方有 Publish 服务($8/月),但几个硬伤:
1. 数据在 Obsidian 官方服务器,不是你的云服务器
2. 无法自定义域名和鉴权
3. 月费累积成本:一年 $96,够买一台 2核4G 云服务器了
4. 无法集成到自己的项目网页——Publish 是独立站点
基于以上原因,本文推荐自建方案。

附.2 实操:用 Perlite 在云服务器上部署 Obsidian Vault Web 浏览器

以下是完整步骤(以 Ubuntu 20.04/22.04,2GB 内存为例):

第一步:在服务器上安装 Docker

curl -fsSL https://get.docker.com | bash
sudo usermod -aG docker $USER ← 免 sudo 运行 Docker

(退出 SSH 重新登录后生效)

第二步:上传你的 Obsidian Vault 到服务器

# 在本地终端执行(替换为你的服务器 IP)
scp -r ~/my-knowledge-base root@你的服务器IP:/home/kb/

注意:不需要上传 .obsidian/ 文件夹(那是 Obsidian 客户端配置,服务器用不上),只上传 Markdown 文件和附件即可。

第三步:启动 Perlite 容器

docker run -d \
--name perlite \
--restart unless-stopped \
-p 8080:80 \
-v /home/kb/my-knowledge-base:/var/www/perlite \
secure77/perlite:latest

第四步:验证 + 配置 Nginx 反向代理(可选)

  1. 浏览器访问 http://你的服务器IP:8080,应该能看到你的知识库 Web 界面
  2. 如果要配置域名 + HTTPS:
    sudo apt install nginx certbot python3-certbot-nginx -y
    sudo nano /etc/nginx/sites-available/kb
    Nginx 配置:
    server {
    server_name kb.your-domain.com;
    location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    }
    }
  3. 启用站点并申请证书:
    sudo ln -s /etc/nginx/sites-available/kb /etc/nginx/sites-enabled/
    sudo certbot --nginx -d kb.your-domain.com
    sudo systemctl reload nginx

附.2.1 备选方案:Silmaril(不用 Docker)

如果你的服务器没装 Docker 或想更轻量:

pip install silmaril
silmaril --vault /home/kb/my-knowledge-base --port 8080 --host 0.0.0.0
# 支持 416 个 Obsidian 社区主题,移动端完美适配

附.2.2 自动同步:让本地 Obsidian 改动自动推送到服务器

  1. 安装 Obsidian Git 插件:设置 → 第三方插件 → 搜索 Git → 安装
  2. 配置自动推送间隔:Git 插件设置 → Backup Interval → 设为 10(每 10 分钟)
  3. 服务器端配置自动拉取:
    # 在服务器上添加 crontab
    crontab -e
    # 添加:每 5 分钟 git pull 一次
    */5 * * * * cd /home/kb/my-knowledge-base && git pull

⚠️ 注意:在 obsidian-web 或 Perlite 中设置只读模式(readonly: true),避免 Web 端编辑与本地编辑冲突。

附.3 将知识库嵌入项目网页(vueMaster 集成)

有了云服务器上的 Web 版知识库后,下一步就是把它嵌入到"一颗松树"项目里——这样团队成员打开 OA 系统就能直接查知识库,无需记住额外网址。

附.3.1 方案一:iframe 嵌入(推荐,5 分钟搞定)

在 vueMaster 项目中新增一个路由页面,用 iframe 嵌入知识库:

  1. 创建 Vue 组件src/views/extranet/KnowledgeBase.vue
    <template>
    <div class="kb-container">
    <iframe
    src="https://kb.your-domain.com"
    class="kb-iframe"
    frameborder="0"
    allow="clipboard-write"
    />
    </div>
    </template>
    <style scoped>
    .kb-container { width: 100%; height: calc(100vh - 60px); }
    .kb-iframe { width: 100%; height: 100%; border: none; }
    </style>
  2. 注册路由(在 router/index.js 中):
    { path: '/knowledge-base', component: KnowledgeBase, meta: { title: '知识库' } }
  3. 在侧边栏菜单添加入口(在对应的菜单配置文件中):
    { path: '/knowledge-base', title: '知识库', icon: 'el-icon-reading' }

附.3.2 iframe 嵌入的三个注意事项

跨域问题

如果知识库部署在独立域名(如 kb.your-domain.com),而 OA 在另一域名,需要在服务器的 Nginx 中添加:

add_header X-Frame-Options "ALLOW-FROM https://oa.your-domain.com";

或者更简单:知识库和 OA 部署在同一域名下的不同路径(用 Nginx location 转发)。

移动端适配

Perlite 和 Silmaril 都原生支持移动端响应式布局。iframe 在手机上也能正常使用——建议给 kb-container 设置 height: 100dvh 以适配移动端地址栏变化。

附.3.3 方案二:自定义 Vue 组件(深度集成,进阶玩法)

如果你不想用 iframe,而是想做成一整套符合项目 UI 风格的知识库界面,可以基于 Vue 2 + Element UI 搭建:

架构概览

后端 API(Go/Node.js):部署在云服务器上,提供 Markdown 文件的 CRUD + 搜索接口
前端(vueMaster):marked + highlight.js 渲染 Markdown, 用 el-tree 展示目录结构,用 el-input 做全局搜索
数据流:Obsidian 本地编辑 → Git 同步 → 服务器 WebDAV/API → vueMaster 读取

核心依赖(在 vueMaster 中安装):

npm install marked highlight.js github-markdown-css

关键代码框架:

// API 接口设计(服务器端,Go 示例仅 30 行)
GET /api/notes → 返回目录树 JSON
GET /api/notes/:path → 返回 Markdown 原文
GET /api/search?q=关键词 → 全文搜索

// 前端 Markdown 渲染
import { marked } from 'marked';
import hljs from 'highlight.js';

marked.setOptions({
highlight: (code, lang) => hljs.highlightAuto(code, [lang]).value
});

// 渲染
this.renderedHtml = marked.parse(markdownContent);
// 加上 [[双向链接]] 的转换逻辑
// 加上 Mermaid 图表的实时渲染
选型建议:对大多数团队来说,方案一(iframe)已经足够好。它的优势是: Perlite/Silmaril 已经做好了搜索、图谱、标签、主题——你不需要重复造轮子。 方案二适合对 UI 统一性有极致追求、或需要做权限管控(如不同角色看不同文件夹)的场景。

附.4 最终效果预览

完整部署后的架构:

📱 手机/平板 ─── 浏览器 ───┐
💻 办公电脑 ─── Obsidian 客户端 ─── Git 同步 ───┐

┌──云服务器(2GB)──┐
│ Perlite / Silmaril │
│ Obsidian Vault │
│ Web 界面(:8080) │
└──────────┬─────────┘

🌐 vueMaster OA ─── iframe 嵌入 ───┘

→ 团队成员打开 OA → 点击"知识库"菜单 → 直接查、直接搜,一气呵成。

十二、总结与行动清单

12.1 四步启动清单

  1. 今天(30 分钟): 安装 Obsidian + Web Clipper + Node.js + iFlow CLI。创建目录结构和 AGENT.md。将你最近读的 3 篇文章放入 raw/。
  2. 明天(30 分钟): 在 iFlow CLI 中对这 3 篇文章执行首次 Ingest,查看 Obsidian 中生成的 Wiki 页面和图谱。
  3. 本周(持续): 每天用 Web Clipper 收集 1-2 篇文章,让 AI 处理。一周后你应该有一个 10+ 篇文章、20+ 概念页的初级知识库。
  4. 进阶(1 小时): 在云服务器上用 Docker 部署 Perlite(一行命令),将知识库目录上传到服务器。在 vueMaster 中用 iframe 嵌入知识库 Web 页面,团队成员打开 OA 即可随时查询。

12.2 核心要点回顾

  • 理念: 不让 AI 每次从零检索,而是让 AI 编译一次、持续复利。raw/ 是源码,wiki/ 是编译产物。
  • 工具: Obsidian(前端) + iFlow CLI / Kimi Code CLI(引擎) + Web Clipper(采集) + AGENT.md(规则)
  • 流程: Ingest(摄入) → Compile(编译) → Query(查询) → Lint(维护) → Output(输出)
  • 分工: 你负责策展和提问,AI 负责所有整理、链接、维护工作。
  • 部署: 本地 Obsidian 编辑 → Git 自动同步 → 云服务器 Perlite/Silmaril Web 界面 → vueMaster iframe 嵌入。2GB 云服务器完全够用。
  • 关键: AGENT.md 是整个系统的灵魂,花时间写好它能获得百倍回报。
一句话总结:
Karpathy 的方法不是在教你用一款新软件,而是在给你一种新的知识工作方式——把你大脑里最耗精力的"整理归类"工作外包给 AI,让你把时间花在真正有价值的事情上:深度思考和创造性连接