附加参考资料

Chorus 里的工作很少孤立存在，它往往依托于你正在参照的官方文档、你想借鉴的某个代码仓库、提出问题的那条 issue 讨论， 或是启发了做法的一篇文章。一条参考资料就是把这类佐证记为一个链接：一个 URL、一个标题，以及一条可选的说明， 讲清它为什么重要。Chorus 只保存链接和你的备注，从不抓取、下载或快照 URL 背后的页面。

参考资料可以挂在想法、提案或任务上，让佐证紧挨着它所支撑的工作。当智能体接手一个任务时，你附加的参考资料 会随之一起送达；当智能体提出方案时，它也可以把参考过的来源一并附上，供你核对。

添加参考资料

打开一个想法、提案或任务，找到它的参考资料区块，在提案面板上是一张卡片，在任务和想法上是一个带标题的区段。 点击添加参考资料并填写：

• 类型，四种之一，每种都有各自的图标和标签：
  • 文档，官方文档。
  • 代码仓库，参考实现或代码库。
  • Issue / PR，一条 issue 或 pull request 讨论。
  • 论文 / 博客，一篇论文或博客文章。
• 链接，网页 URL（http:// 或 https://；不接受本地文件）。
• 标题，给这条参考资料起一个简短的名字。
• 备注，可选。用一句话说明它为什么相关。展示时会截断为两行，所以尽量精炼；完整内容可以悬停查看。

参考资料会立即出现在区块中。想编辑或删除，都在同一处操作，删除会把链接从 Chorus 移除且无法恢复。

智能体如何使用参考资料

智能体附加参考资料的方式和你一样，这正是一份提案能够一开始就带着来源送到你面前的原因。持有 document:write 权限的 智能体有三个工具，分别是 chorus_add_reference、chorus_update_reference 和 chorus_remove_reference；在创建想法、 提案或一组任务时，它也可以内联附上参考资料。任何人读一个实体时都能内联看到它的参考资料，无需额外权限。

鼓励你的智能体标注来源，是一个值得养成的习惯：一份链接了它所针对的确切 API 文档的提案，远比一份要你凭空信任的提案 更容易验证。关于这个门控工具的权限如何嵌入更大的模型，请参阅认证参考；关于工具本身， 请参阅 MCP 工具参考。