> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 参考说明指南

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

本指南适用于 `contributor-kit/reference-notes/` 下的精选参考说明。

## 什么是参考说明

精选参考说明不是实验室文章，也不是来源项目。
它是一种结构化的来源汇总，帮助未来的贡献者快速理解一个主题。

适用场景：

* 来源映射
* 对比汇总
* 有边界的阅读清单
* 面向未来实验室扩展的主题简报

## 放置位置与命名

* 将说明放在 `contributor-kit/reference-notes/`
* 使用“主题优先”的文件名，例如 `deep-research-source-map.md`

请将这些说明与 `references/` 中导入的材料清楚分开。

## 必需结构

从 [Reference Note Template](/zh-Hans/contributor-kit/templates/reference-note-template) 开始。

必需章节：

* `Summary`
* `Why It Matters`
* `Scope Notes`
* `Source Map`
* `Synthesis`
* `Gaps And Follow-up`
* `Update Log`

## 工作规则

* 要整理并综合来源，而不是复制它们。
* 明确说明范围，让未来的贡献者知道这份说明不涵盖什么。
* 优先使用简短的综合，而不是长篇引用。
* 让这份说明对未来起草仍然有用，而不只是一个书签堆。

## 完成标准

当参考说明满足以下条件时，即可提交审核：

* 具有清晰的主题边界
* 包含真实的来源映射
* 提供综合内容，而不是原始摘录
* 保持在导入的 `references/` 目录树之外