核心用法
Zettel Brainstormer 是一套面向 Obsidian/Zettelkasten 用户的结构化知识合成工作流，通过四阶段流水线将单一「种子笔记」扩展为具备学术规范的长篇论述文章。
Stage 1 - 检索：从种子笔记出发，优先调用外部 zettel-link 技能进行语义检索，同时运行本地脚本提取维基链接与标签重叠笔记，合并去重后生成候选池。
Stage 2 - 预处理：为每个候选笔记启动独立子代理，依据 preprocess.md 指令评估与种子主题的相关性（0-10 分），提取关键论点、证据引文，并过滤低相关度内容。
Stage 3 - 起草：通过 compile_preprocess.py 聚合高相关性笔记，由单一合成子代理基于 draft.md 指令生成带内联引用的初稿，保留完整的溯源映射。
Stage 4 - 发布：Publisher 子代理将初稿重写为自然语言风格的长文，消除 AI 套话，构建层级论证结构，强制保留所有引文，并以 ## References 章节收尾。
显著优点
- 可追溯性保障：每句主张均绑定原始笔记出处，满足学术与专业写作规范
- 模块化架构：四阶段严格分离，便于调试、替换子代理策略或接入外部检索系统
- 本地优先设计：核心检索与预处理均基于本地 Markdown 文件，降低对外部 API 的依赖
- 灵活配置：通过
models.json控制链接深度、最大候选数、代理模型选择
潜在局限
- 依赖前置索引：语义检索效果取决于
zettel-link技能的索引完整度 - 冷启动成本：首次使用需运行
setup.py配置路径与模型参数 - 子代理开销：笔记量庞大时，逐笔记预处理可能产生较高的 Token 消耗与延迟
- 引用格式固定：输出格式偏向 Obsidian 风格，迁移至其他出版平台需后期调整
适合人群
- 积累大量原子化笔记、需定期产出深度文章的 Zettelkasten 实践者
- 研究者、咨询顾问、内容创作者等需将内部知识库转化为对外交付物的知识工作者
- 希望建立「笔记→草稿→发布」标准化流水线的效率工具用户
常规风险
- 信息茧房风险：检索策略基于既有链接网络，可能强化既有观点而遗漏颠覆性外部信息
- 幻觉传导：若预处理子代理错误评估相关性，低质量笔记可能污染最终输出
- 版本漂移：本地笔记修改后若未及时重建索引，可能引用过时内容
- 隐私泄露：配置中
zettel_dir路径若指向云同步文件夹，敏感笔记内容可能在子代理处理中经 API 外流