知识卡片生成

解决什么问题

知识库文件越攒越多之后，典型的困境是「存得下，但用不起来」：一篇几百页的报告里真正值得反复引用的往往只有少数几个知识点，散落在正文中难以检索；多个文件讨论同一主题时，谁和谁是同一件事、参数是否冲突，全靠人工比对。这个技能把「读完并消化」这一步自动化：输入文件或关键词，输出结构统一、互相关联、带领域索引的知识卡片，让知识库从归档仓库变成可查可用的卡片网络。

核心能力与工作流

技能支持两种建卡模式，先用一条指令区分，再走后续步骤。

模式一：单篇→多卡。 触发词如「给《XXX》建卡」。流程是：用 search(kb, question="XXX") 定位文件，多个匹配时列出候选让用户挑选；用 pdftext 提取全文（支持 PDF、DOCX、XLSX，图片走 OCR 兜底），结果写入 card_source_[文件名].txt；AI 按「一个独立知识点一张卡」的原则拆单元——主题明显切换的段落拆开，同主题数据点合成参数卡，项目案例按概况/应用/成效/经验四块合成，规范条款合成规范卡。每张卡确定 4 个属性：17 个领域中的领域字母（🅰~🆀）、5 种卡片类型之一、符合 [领域字母][类型emoji][标题≤25字] 格式的标题，以及用自己的话编译的核心内容。

模式二：多篇→卡片（关联建卡）。 用户一次提到多篇文件时触发，先并行定位并提取所有文件，再做跨文件分析：共同点写入核心共识，互补点合并成完整方法卡，差异点拆成独立卡做对比。综合卡的来源字段格式为「综合自：文件A、文件B、文件C」。

两种模式都经过 预览确认循环：输出卡片预览后等待用户反馈，可合并、改类型、删除卡片；确认后先在对应领域索引笔记里按来源文件名去重，再通过 import_doc 写入 🗂️知识卡片笔记本，每张卡至少 1 条关联（关系词限定为参数来源/应用案例/配套使用/对比参考/扩展深入，建议不超过 3 条）。最后用 append_doc 更新领域索引与总索引，并输出汇报。

建卡前有 6 项质量关卡 自动检查：标题格式、核心内容≥80 字、内容是编译而非摘录、来源字段无「主卷v6」「续篇」等残留、正文无「更新日志」等元数据脏词、关联卡片至少 1 条。任一不通过则修正后重试。17 个领域索引笔记已预建并写死在资源索引里，直接引用，无需搜索。

适用边界与注意点

• 单文件建议产出 1~5 张卡，多文件综合建卡同样 1~5 张；超出上限只做标记，留给手动拆分。
• 核心内容必须是编译，摘录原文会在质量关卡被拦下重写。
• 总索引 API 只增不改，因此采用末尾追加更新行的方式追踪增量，不要尝试重建总索引；条目数保留原始预估值。
• 去重依赖来源字段中的文件名，跨文件同名文件可能漏检，合并前建议人工留意。