zcbot/skills/literature/references/source-materials-library.md

内部材料知识库来源

内部知识库覆盖胶凝、陶瓷、玻璃、晶体、复合、耐火和检验检测，提供跨语言语义检索、Markdown 正文片段和原件下载。API Key 留在宿主工具中，不进入 sandbox。

工具

• materials_library_list()：列出当前有效知识库。用户未指定材料方向且需要缩窄范围时调用。
• materials_library_search(queries, kb_names=None, classification_ids=None, max_documents=6, content_chars_per_doc=1200)：批量检索并返回元数据和截断的 md_content。
• materials_library_fetch(items)：把选定原件下载到当前任务的 documents/ 目录。

查询可使用中文或英文；复杂专业术语通常使用英文更精确。先规划互不重复的查询并批量调用，不逐个近义词反复搜索。

使用深度

• 题名、文件名、正文片段和知识库来源用于候选筛选。
• 片段足以核验局部论断时无需下载原件。
• 数据、公式、表格、章节、页码或版式需要更多上下文时，提高少量候选的片段长度或下载原件。
• 下载只使用搜索返回的 file_name 和 kb_name，不编造来源标识。

失败

• 工具不存在表示宿主未配置 DOCUMENT_SEARCH_API_KEY；继续使用其他来源。
• 认证、网络或知识库错误时说明内部材料库当前不可用。
• 未命中时调整术语、语言或库范围；没有新增思路时如实说明覆盖不足。