WorkBuddy+Obsidian：公式教材自动化生产与智能出题工作流

1. 培训教材生产的真实困境与破局思路

做培训讲师这行十几年，最磨人的从来不是站在讲台上那几个小时，而是台下那些看不见的重复劳动。尤其是理科方向的培训，公式教材的编写和题库的维护，几乎占据了我一半以上的备课时间。一份力学或者电路分析的讲义，里面动辄几十上百个公式，每个公式的符号、上下标、希腊字母、矩阵结构都得精确无误；讲完课还得配套出练习题，题干、选项、解析、答案，一套流程走下来，人还没上课就已经累趴了。

我身边很多同行都有类似的痛点。有人用Word硬敲公式，敲到手腕发酸；有人用LaTeX写，排版确实漂亮，但改一个符号要重新编译，出题的时候还得手动复制粘贴，效率极低。更麻烦的是，教材和题库分散在不同文件里，版本一多就乱套，学生问某道题的出处，我得翻半天才能找到对应的知识点。

后来我开始琢磨，能不能把内容生产和内容管理这两件事拆开，用工具链把它们串起来。核心思路很简单：用WorkBuddy负责公式教材的生成和自动出题，用Obsidian负责知识库的沉淀和检索，中间用MarkItDown和obsidian-cli做格式转换和自动化调度。这套组合拳打下来，我的备课时间从原来的每周二十多个小时压缩到了六七个小时，而且题库的复用率大幅提升。

这篇文章就是把我这套工作流的完整搭建过程、踩过的坑、以及一些只有实际用过才知道的细节，原原本本地分享出来。不管你是刚入行的培训讲师，还是已经在用Obsidian做知识管理的同行，都能从中找到可以直接抄作业的方案。整套流程不依赖任何特定平台，你在自己的电脑上就能跑起来。

2. 工具链选型背后的逻辑与核心组件拆解

2.1 为什么是WorkBuddy而不是其他AI助手

市面上能生成公式内容的工具不少，但WorkBuddy有几个特性特别适合培训教材这个场景。第一，它对数学公式的渲染支持比较完整，能直接输出LaTeX格式的公式块，这意味着我不用再手动调整符号。第二，它支持自定义规则，你可以给它定几条硬性约束，比如“所有公式必须用$$包裹”“每个知识点至少生成三道变式题”“题干中不得出现歧义表述”，这些规则一旦设定，后续生成的内容质量会稳定很多。

我试过用其他通用型AI工具生成公式教材，最大的问题是格式不统一。同一个文档里，有的公式用行内格式，有的用块级格式，有的甚至直接输出图片，后期整理起来非常痛苦。WorkBuddy在这方面做得比较克制，只要你把规则写清楚，它输出的内容结构是可控的。

还有一个细节值得提：WorkBuddy支持技能（skill）机制。你可以把常用的出题模板、公式规范、难度分级标准封装成一个技能包，下次直接调用，不用每次都重新描述需求。这对于需要批量生产教材的讲师来说，节省的时间是肉眼可见的。

2.2 Obsidian在知识管理中的不可替代性

Obsidian的核心优势在于本地化存储和双向链接。我的所有教材、题库、知识点卡片都以Markdown文件的形式存在本地，不依赖任何云端服务，数据安全性和可控性都很高。更重要的是，Obsidian的双向链接让我可以轻松建立“知识点—公式—题目”之间的关联网络。

举个例子，我在讲“基尔霍夫定律”的时候，可以把它关联到“节点电流定律”“回路电压定律”“叠加定理”等多个知识点卡片，每张卡片下面又挂着对应的例题和变式题。学生问某个问题时，我直接在Obsidian里搜索关键词，相关的公式、题目、解析一目了然。这种网状结构是传统的文件夹分类做不到的。

另外，Obsidian的插件生态非常丰富。我常用的有Dataview（用于动态查询题库）、Templater（用于批量生成题目模板）、以及QuickAdd（用于快速录入新题）。这些插件配合起来，基本上可以把出题和归档的流程自动化。

2.3 MarkItDown与obsidian-cli的桥梁作用

MarkItDown是一个格式转换工具，它的作用是把各种格式的文档（比如Word、PDF、PPT）转换成Markdown。为什么需要它？因为很多培训机构的原始教材是Word格式的，里面夹杂着公式图片和表格。手动转成Markdown几乎不可能，但MarkItDown可以批量处理，把公式尽量还原成LaTeX，表格转成Markdown表格，图片提取出来单独存放。

obsidian-cli则是Obsidian的命令行工具，它允许你在终端里直接操作Obsidian仓库，比如创建笔记、追加内容、搜索关键词、执行Dataview查询等。这个工具的意义在于，它把Obsidian从一个手动操作的笔记软件变成了一个可以被脚本调用的内容管理系统。你可以写一个Shell脚本，让WorkBuddy生成的内容自动写入Obsidian的指定文件夹，然后触发Dataview更新题库索引。

2.4 Pkmer-Math：公式处理的最后一块拼图

Pkmer-Math是一个专门处理数学公式的Obsidian插件，它支持公式的实时渲染、编号、引用和交叉链接。在培训教材中，公式编号非常重要，因为解析里经常需要引用“根据式(3-5)可得……”这样的表述。Pkmer-Math可以自动给公式编号，并且在引用时保持同步更新，避免了手动维护编号的麻烦。

这套工具链的组合逻辑是：WorkBuddy负责内容生成，MarkItDown负责格式转换，obsidian-cli负责自动化调度，Obsidian负责存储和检索，Pkmer-Math负责公式的专业化处理。每个工具各司其职，通过脚本串联成一条完整的生产线。

3. 环境搭建与基础配置的完整实操

3.1 WorkBuddy的安装与规则设定

WorkBuddy的安装过程比较简单，官网下载对应系统的安装包，一路下一步即可。安装完成后，第一件事是配置缓存目录。默认的缓存目录在系统盘，如果你像我一样经常处理大量公式内容，缓存文件会迅速膨胀。建议在设置里把缓存目录改到空间较大的数据盘，具体路径根据你的系统来定。

接下来是规则设定，这是整个流程中最关键的一步。我给WorkBuddy定了这么几条规则：

• 所有数学公式必须使用LaTeX语法，行内公式用$...$，块级公式用$$...$$
• 每个知识点的教材内容必须包含：定义、公式推导、物理意义、典型例题、至少三道变式题
• 变式题的难度分为基础、进阶、挑战三个等级，每级至少一道
• 题干中不得出现“显然”“易得”等模糊表述，所有推导步骤必须完整
• 输出的Markdown文件必须包含YAML头部，标注知识点标签、难度、适用课程

这些规则你可以根据自己的教学风格调整，但核心原则是：规则越具体，输出越稳定。我一开始只写了“生成力学教材”，结果WorkBuddy给我的内容忽深忽浅，格式也不统一。后来把规则细化到上面这个程度，生成的内容基本上可以直接用，只需要微调。

注意：WorkBuddy的规则设定支持导入导出，建议你把调好的规则集备份一份，换电脑或者重装系统的时候直接导入，不用重新配置。

3.2 Obsidian仓库的初始化与插件安装

Obsidian的下载和安装就不赘述了，重点说一下仓库的初始化。我建议专门为培训教材建一个独立的仓库，不要和个人的日常笔记混在一起。仓库的文件夹结构可以这样设计：

培训教材仓库/ ├── 00-收件箱/ ├── 01-知识点卡片/ ├── 02-公式教材/ ├── 03-题库/ │ ├── 基础题/ │ ├── 进阶题/ │ └── 挑战题/ ├── 04-课程讲义/ ├── 05-模板/ └── 06-附件/

收件箱用来存放WorkBuddy刚生成、还没来得及整理的内容。知识点卡片是原子化的知识单元，每张卡片对应一个具体的概念或公式。公式教材是按章节组织的完整讲义。题库按难度分级存放。模板文件夹里放Templater的模板文件。

插件方面，必装的有：Dataview、Templater、QuickAdd、Pkmer-Math。Dataview用于动态查询，比如你可以写一个查询语句，自动列出某个知识点下所有难度为“进阶”的题目。Templater用于批量生成标准化的题目模板。QuickAdd用于快速录入新题，配合快捷键可以做到秒级录入。Pkmer-Math用于公式编号和引用。

3.3 MarkItDown与obsidian-cli的配置

MarkItDown的安装需要Python环境，直接用pip安装即可：

pip install markitdown

安装完成后，你可以用命令行测试一下转换效果：

markitdown 原始教材.docx -o 输出教材.md

如果原始文档里有公式图片，MarkItDown会尝试用OCR识别并转成LaTeX，但识别率不是百分之百，需要人工校对。我的经验是，对于简单的代数公式，识别率很高；对于复杂的积分和矩阵，最好还是手动修正一下。

obsidian-cli的安装稍微麻烦一点，需要先安装Node.js，然后用npm安装：

npm install -g obsidian-cli

安装完成后，你需要配置Obsidian仓库的路径。在终端里执行：

obsidian-cli config set vault /path/to/your/vault

配置好之后，你就可以用命令行操作Obsidian了。比如创建一个新笔记：

obsidian-cli create "01-知识点卡片/基尔霍夫定律.md" --content "---\ntags: [电路分析, 定律]\n---\n\n# 基尔霍夫定律\n\n..."

这个功能配合Shell脚本，可以实现WorkBuddy生成内容后自动归档到Obsidian。

4. 公式教材自动化生产的核心流程

4.1 从知识点到教材的生成逻辑

公式教材的生产不是让WorkBuddy一次性生成一整本书，而是按照“知识点—小节—章节”的层级逐步生成。我的做法是先在Obsidian里建立知识点卡片，每张卡片包含这个知识点的核心定义和公式。然后把这些卡片的内容作为输入，让WorkBuddy扩展成完整的教材小节。

具体操作是这样的：我从知识点卡片里复制核心内容，粘贴到WorkBuddy的对话窗口，然后附上这样的指令：

基于以下知识点内容，生成一份完整的培训教材小节。要求： 1. 包含定义、公式推导、物理意义、典型例题、变式题 2. 公式使用LaTeX格式，块级公式用$$包裹 3. 推导步骤完整，不得跳步 4. 变式题分基础、进阶、挑战三个等级 5. 输出Markdown格式，包含YAML头部 知识点内容： [粘贴卡片内容]

WorkBuddy生成的内容会直接输出在对话窗口里，我复制出来，粘贴到Obsidian的“02-公式教材”文件夹里。这个过程听起来有点手动，但实际上因为规则设定得好，生成的内容质量很高，我基本上只需要检查一下公式渲染和题目答案是否正确。

4.2 公式编号与交叉引用的处理技巧

公式编号是培训教材里最烦人的事情之一。传统的做法是手动编号，但一旦插入或删除公式，后面的编号全要改。Pkmer-Math插件解决了这个问题，它支持自动编号和引用。

使用方法是在公式后面加上\tag{}，比如：

$$ F = ma \tag{3-1} $$

Pkmer-Math会自动识别这个标签，并且在引用时保持同步。如果你在解析里写“根据式(3-1)”，当公式编号变化时，引用也会自动更新。这个功能在编写大型教材时特别有用，我强烈建议所有理科讲师都装上。

提示：Pkmer-Math的自动编号需要在插件设置里开启“自动编号”选项，并且建议把编号格式设置为“章节号-序号”，这样在跨章节引用时不容易混淆。

4.3 批量生成变式题的参数化方法

变式题是培训教材的核心价值所在。同一道题，改变一个参数，就能变成一道新题。WorkBuddy支持参数化生成，你可以给它一个题目模板，然后指定参数的取值范围，让它批量生成变式题。

举个例子，对于“欧姆定律”这个知识点，我给WorkBuddy的指令是：

基于以下题目模板，生成10道变式题。参数U的取值范围为[1, 100]，步长为10；参数R的取值范围为[1, 50]，步长为5。要求： 1. 每道题给出题干、选项、答案、解析 2. 解析中必须包含公式代入过程 3. 输出Markdown表格格式 题目模板： 已知电压U为{ U }V，电阻R为{ R }Ω，求电流I。

WorkBuddy会生成一个包含10道题的Markdown表格，我直接复制到Obsidian的题库文件夹里。Dataview会自动索引这些题目，我可以通过查询语句快速筛选出特定难度或特定知识点的题目。

这种参数化生成的方法，让我的题库从原来的几十道题迅速扩展到了几百道题，而且每道题都有完整的解析，学生练习的时候不会因为答案不详细而卡住。

5. 自动出题系统的搭建与调度

5.1 题库的YAML元数据设计

自动出题的前提是题库有良好的元数据。每道题在Obsidian里都是一个独立的Markdown文件，文件头部有YAML元数据，标注了这道题的知识点、难度、题型、答案、解析等信息。我的YAML模板是这样的：

--- tags: [电路分析, 基尔霍夫定律] difficulty: 进阶 type: 计算题 answer: "I = 2A" source: "WorkBuddy生成" created: 2024-01-15 ---

有了这些元数据，Dataview就可以根据条件筛选题目。比如我要生成一套“电路分析”的进阶练习题，只需要写一个Dataview查询：

TABLE difficulty, type, answer FROM "03-题库" WHERE contains(tags, "电路分析") AND difficulty = "进阶" SORT created DESC LIMIT 10

这个查询会列出最近创建的10道电路分析进阶题。我可以直接把这些题目导出成试卷，或者让WorkBuddy基于这些题目生成一份完整的模拟卷。

5.2 用obsidian-cli实现自动组卷

自动组卷的核心逻辑是：根据指定的知识点和难度分布，从题库中随机抽取题目，组装成一份试卷。这个流程可以用Shell脚本实现，核心命令是obsidian-cli的搜索功能。

#!/bin/bash # 自动组卷脚本 # 定义知识点和难度分布 KNOWLEDGE_POINTS=("基尔霍夫定律" "叠加定理" "戴维南定理") DIFFICULTIES=("基础" "进阶" "挑战") COUNTS=(3 2 1) # 遍历知识点和难度，抽取题目 for i in "${!KNOWLEDGE_POINTS[@]}"; do for j in "${!DIFFICULTIES[@]}"; do obsidian-cli search "tag:${KNOWLEDGE_POINTS[$i]} difficulty:${DIFFICULTIES[$j]}" \ --limit ${COUNTS[$j]} \ --format markdown >> 试卷.md done done

这个脚本会按照指定的分布从题库中抽取题目，输出到“试卷.md”文件里。你可以根据需要调整知识点和难度的分布，比如期中考试基础题占60%，期末考试进阶题占50%等。

注意：obsidian-cli的搜索语法支持布尔运算，你可以用AND、OR、NOT组合条件。比如tag:电路分析 AND difficulty:进阶 AND NOT type:选择题可以筛选出所有电路分析的进阶非选择题。

5.3 定时任务与批量处理

如果你需要定期生成练习题，比如每周给学生发一套周测卷，可以用系统的定时任务工具（Linux下是cron，Windows下是任务计划程序）来调度组卷脚本。

Linux下的cron配置示例：

# 每周一早上8点自动生成周测卷 0 8 * * 1 /path/to/组卷脚本.sh

Windows下可以用任务计划程序，设置触发时间为每周一早上8点，操作选择“启动程序”，指向你的脚本文件。

批量处理方面，如果你有大量的Word格式教材需要转换，可以写一个循环脚本：

for file in ./原始教材/*.docx; do markitdown "$file" -o "./转换后教材/$(basename "$file" .docx).md" done

这个脚本会遍历“原始教材”文件夹下的所有docx文件，逐个转换成Markdown并输出到“转换后教材”文件夹。转换完成后，你可以用obsidian-cli把这些文件批量导入Obsidian仓库。

6. 实操中踩过的坑与排查技巧实录

6.1 公式渲染异常的常见原因

公式渲染失败是这套流程里最常见的问题。我遇到过几种典型情况：

第一种是LaTeX语法错误。WorkBuddy生成的公式偶尔会有拼写错误，比如把\frac写成\fraq，或者括号不匹配。这种错误在Obsidian里会显示为红色，比较容易发现。解决办法是让WorkBuddy在生成公式后自动检查一遍语法，或者在Obsidian里装一个LaTeX语法检查插件。

第二种是转义字符问题。Markdown里的某些字符（比如下划线、星号）和LaTeX语法冲突，导致公式渲染异常。解决办法是在YAML头部或者公式块前后加上适当的转义，或者用Pkmer-Math的公式块语法来隔离。

第三种是插件冲突。我有一次同时装了三个公式相关的插件，结果它们互相干扰，公式渲染时好时坏。后来只保留Pkmer-Math，问题就解决了。所以插件不是越多越好，功能重叠的插件尽量只留一个。

6.2 Obsidian同步失败的排查思路

Obsidian的同步问题主要出现在多设备场景下。我平时在台式机和笔记本之间切换，同步偶尔会出问题。常见的排查步骤是：

首先检查同步文件夹的路径是否正确。如果你用的是第三方同步工具（比如OneDrive、坚果云），要确保Obsidian仓库的路径和同步工具的路径一致。其次检查文件冲突。多设备同时编辑同一个文件时，同步工具可能会生成冲突副本，你需要手动合并。最后检查插件配置是否同步。有些插件的配置存在本地，不会自动同步，换设备后需要重新配置。

我的经验是，尽量用Obsidian官方的同步服务，虽然要付费，但省心很多。如果不想付费，可以用Git做版本控制，每次编辑后手动提交，虽然麻烦一点，但数据安全性最高。

6.3 WorkBuddy生成内容质量不稳定的应对

WorkBuddy生成的内容质量偶尔会波动，尤其是当知识点比较复杂的时候。我总结了几条应对策略：

第一，把复杂知识点拆分成多个简单知识点，分别生成后再合并。比如“交流电路分析”可以拆成“阻抗计算”“相位差”“功率因数”三个子知识点，每个子知识点单独生成，质量会稳定很多。

第二，在规则里明确要求WorkBuddy“如果某个步骤不确定，请标注[待确认]”。这样你可以在后期快速定位需要人工校对的地方，而不是通篇检查。

第三，用多个AI工具交叉验证。我有时候会把WorkBuddy生成的公式推导复制到另一个AI工具里，让它检查有没有错误。虽然多了一步，但对于关键公式来说，这个校验过程是值得的。

6.4 常见问题速查表

7. 效率提升的量化对比与个人体会

7.1 改造前后的时间投入对比

我记录了自己在改造前后各一个月的时间投入，数据如下：

这个数据是保守估计，实际节省的时间可能更多，因为有些隐性成本（比如切换工具、查找文件）没有计入。改造后，我每周只需要花7.5小时左右就能完成原来27小时的工作量，多出来的时间可以用来打磨课程设计或者休息。

7.2 这套工作流适合什么样的讲师

这套工作流最适合以下几类培训讲师：

• 理科方向：数学、物理、化学、电子电路等公式密集的学科，收益最大
• 有批量出题需求：需要定期给学生布置作业或组织考试的讲师
• 注重知识沉淀：希望把教学内容积累成可复用知识库的讲师
• 愿意折腾工具：对命令行和自动化脚本不排斥，愿意花时间搭建一次、长期受益

如果你是完全的技术小白，看到命令行就头疼，那这套方案的学习曲线可能有点陡。但好消息是，一旦搭建完成，日常使用几乎不需要碰命令行，所有操作都可以在Obsidian的图形界面里完成。

7.3 后续可以扩展的方向

这套工作流还有不少可以扩展的空间。比如，你可以把Obsidian仓库和飞书连接起来，实现团队协作和内容分发。也可以把题库导出成小程序，让学生直接在手机上刷题。还可以用Hermes Agent做智能答疑，学生提交问题后自动匹配题库里的相似题目和解析。

我目前正在尝试的是把WorkBuddy的出题能力和Obsidian的Dataview结合起来，做一个“自适应练习系统”。学生做完一道题后，系统根据答题情况自动推荐下一道题的难度和知识点，实现个性化练习。这个方向的技术难度不高，但效果很好，等跑通了再单独写一篇分享。

最后分享一个小技巧：WorkBuddy的规则文件可以版本化管理。我把每次调整后的规则都保存成一个独立的文件，标注日期和调整原因。这样当生成质量下降时，我可以快速回滚到之前的版本，而不是从头调试。这个习惯帮我省了不少时间，推荐你也试试。