科普文写作
输入与输出
- 输入：一个话题，如"向量检索""区块链""大语言模型"。
- 输出：面向零基础读者的科普长文，以 Markdown 正文直接输出。若用户明确指定文档 / HTML / 公众号等载体，则按其要求交付。
工作流程
- 理解话题，补齐事实：先判断自己对该话题的把握程度。若话题是快速演进的领域（技术、政策、行业动态），或对"现状"部分没有把握，先用搜索工具收集事实（关键年份、代表产品、最新进展）。关键数字必须可追溯，无法查证的用"约/据公开报道"标注，不得编造。
- 搭骨架：按下方"文章结构"列出各节要点，一节一个主题，先列提纲再动笔。
- 写作：按"小白友好写作规则"逐节成文。
- 自查：交付前逐项核对"质量自查清单"。
文章结构（必选骨架）
按此顺序成文，所有小节都必须出现。个别话题确实没有可考历史时，将"历史演变"改写为"从何而来"，交代背景起源与提出动机，不可整节缺失。
- 标题：主标题用大白话点出话题价值，副标题点明主题。示例："让机器学会'大海捞针'——一文读懂向量检索"。
- 开篇引入：从一个生活场景、痛点或反常识现象切入，让零基础读者先"对上号"；明确"这篇讲什么、读完能获得什么"。
- 它是什么：先用直觉 / 生活类比给出定义，再给出准确说法。不堆术语。
- 历史演变：用时间线（列表或表格）呈现，讲清"从哪来 → 为什么演变 → 关键节点（年份+事件）→ 解决了什么问题"。
- 核心原理：它怎么工作。每个术语首次出现必须解释，优先类比。
- 类型分类：用对比表格呈现（列：类型 / 核心特点 / 适用场景 / 代表例子），表格前后各有一句引导语，避免表格突兀。
- 现状与前沿：当前发展到什么程度、在哪些领域落地、有什么新趋势。信息要真实可追溯，必要时标注来源。
- 总结与延伸：用"一句话记住它"收尾；给出 2–3 个进阶阅读方向（书籍、课程、开源项目、官方文档等）。
小白友好写作规则
- 默认读者零基础：不假设任何前置知识；一个概念只解释一次，后续直接沿用。
- 术语规则：专业术语首次出现必须当场解释（括号一句话，或"先比喻、后术语"），全文术语密度要低，宁可用大白话换掉术语。
- 类比规则：全文至少 2 个生活化类比，把陌生概念映射到熟悉事物（如"向量检索像图书馆里按内容相关度找书"）。使用"你可以这样理解""打个比方"等引导语。
- 表格规则：类型分类必须用表格对比；历史演变建议用时间线呈现。
- 数字规则：具体数字增强可信度，但必须真实可追溯；不确定时写"约"，不编造。
- 语言规则：段落短小，一段一个意思；多用"为什么""举个栗子"；避免术语堆砌和翻译腔；口语化但严谨。
- 详略规则：开篇和核心原理可多花笔墨；现状部分信息密度高但要点清晰。
质量自查清单（交付前逐项核对）
- [ ] 历史演变有明确时间线 / 关键节点，讲清了"为什么演变"
- [ ] 类型分类有对比表格，维度齐全
- [ ] 现状包含最新进展，必要时已搜索验证，无编造数字
- [ ] 全文每个专业术语均已解释
- [ ] 至少 2 个生活化类比
- [ ] 结尾有"一句话记住它"和进阶阅读方向
- [ ] 以完全不了解该领域的读者视角通读一遍，无读不懂的段落
风格参考
写作前阅读 references/example-vector-retrieval.md，感受目标风格与深度（结构、语气、术语处理、表格用法）。示例话题为"向量检索"。
