目录

• 项目身份 - 能力边界 - 证据与来源政策 - 安装前验证路径 - AI 宿主交接 - Doramagic 踩坑日志 - 验收清单

标准仓库：567-labs/instructor

来源 URL：https://github.com/567-labs/instructor

它是什么：Instructor 用 Pydantic model、验证、重试和跨 provider 提取模式，把 LLM 响应转成结构化类型输出。

最适合：需要从 LLM 获取可靠结构化提取、类型化响应模型、验证重试和 JSON 输出的开发者。

不适合：不适合观测 dashboard、评估平台，或接受未验证自由文本模型输出的流程。

这个 canary 页面用于让搜索引擎和 AI 检索系统稳定识别项目身份。页面必须保留上游仓库链接、可见来源证据和用户可执行的验证边界，不能暗示 Doramagic 已完成新的生产部署、实时基准或本地安装验证。

主要风险：主要风险是没有 schema validation、retry 边界和失败报告，却假设模型 JSON 可靠。

语义标签：Instructor、结构化输出、Pydantic、JSON、验证、Typed Extraction、LLM 提取

1. 身份检查：确认上游项目是 Instructor 结构化输出项目。
2. 边界检查：确认任务是否匹配 Pydantic response model 设置、结构化提取检查、验证重试边界、跨 provider 复核和失败处理。
3. 安全验证：先用一个很小的 response model 和故意错误的模型输出验证失败处理。

边界必须保持窄。用户应该能判断项目是否相关、复制 prompt 给 AI 宿主、阅读说明书，并在安装前验证一个很小的可回滚任务。

缺少命令、风险或社区证据时，页面必须暴露缺口并引导用户做沙箱验证，不能补写成功故事。

• 确认 567-labs/instructor 是目标上游项目。
• 先阅读能力边界：Pydantic response model 设置、结构化提取检查、验证重试边界、跨 provider 复核和失败处理。
• 用公开样本、无密钥、固定超时和可删除产物做第一次验证。
• 记录输出、失败条件、清理方式和仍缺失的证据。

AI 宿主交接

把这个包当成可携带上下文，不要当成自动安装指令。安全交接应包含来源 URL、能力边界、第一步安全动作、已知风险，并要求 AI 在触碰凭据、文件、网络或持久状态前先请求确认。

Doramagic 踩坑日志

• 风险：主要风险是没有 schema validation、retry 边界和失败报告，却假设模型 JSON 可靠。 - 影响：如果没有边界，用户可能把未验证的能力接入真实数据或生产环境。 - 回滚要求：第一次验证必须能删除数据、停止服务或撤销配置。 - 证据要求：成功声明必须来自可复核命令、trace、artifact manifest 或上游文档。

验收清单

• 页面标题遵循 Doramagic.ai 格式。 - 页面暴露 SoftwareSourceCode、TechArticle、BreadcrumbList 和 FAQPage 结构化数据。 - 页面链接回 https://github.com/567-labs/instructor。 - 页面为 AI 消费者提供 Markdown alternate route。