工程知识卡片：让整理过程保留来源

让问题变成可以回看的材料

工程学习经常从一个具体问题开始。查到的资料有时很长，有时又不足以解释眼前的机构。我做工程原理知识卡片库，希望把一次检索整理成结构稳定、以后能够重新查阅的材料。2026 年 7 月的开发记录中，工具已经实现输入问题、检索资料、模型归纳和加入卡片库的流程。

这里的结构化不是把回答切成几块。固定的九个知识切面给整理过程提供约束，方便读者比较不同问题，也让生成是否完整有了基本检查标准。

把资料获取和模型归纳分开

当时的实现由服务端检索中文维基百科，再把资料交给模型归纳。卡片显示来源链接和对应的生成标识，读者能够区分原始材料与整理后的表述。模型调用凭据留在服务端，不随页面一起交付。

一次历史验收使用杠杆问题，确认检索找到了相关资料，模型生成完整章节，卡片进入列表。这个例子证明当时的一条具体链路能工作，并不能说明所有工程问题都能得到充分解释。

搜不到资料时，也说明发生了什么

后续修复增加了无检索结果时的模型补充路径。前端随之显示直接补充的标识，而不是让读者误以为内容仍来自检索资料。当次公网测试确实覆盖了没有维基结果的情况。

这一变化让我更重视来源状态。直接生成可以帮助继续学习，但来源不足也应该保留在界面上。完整的卡片结构与可靠的事实依据是两件事，模型补充内容仍需要读者核对。

发布验收也要覆盖入口

项目还遇到过卡片库页面无法访问的问题。历史记录将原因定位到公网入口缺少转发规则；修复时除了应用本身，也检查页面、脚本、样式和主页入口。只有生成接口通过测试，不能保证访问者真的能打开工具。

这些经历构成了卡片库的方法：给整理固定结构，给资料明确出处，给异常清楚状态。本文依据历史开发记录复盘，没有重新运行当前生成服务；它适合说明工具如何辅助理解，不把模型卡片作为工程设计结论或替代原始技术资料。