DeepKnow 是一款知识与检索助手,通过 DeepKnow REST API 提供知识导入、管理与检索深读能力。它可以浏览知识库、文件夹、分类和条目,读取详情与原文分块;支持上传文件、导入 URL 或飞书文档、写入或编辑 Markdown、重新解析、删除知识;支持单库、跨库或文件夹范围检索,按分类过滤,并生成可核验引用。此外,它还能综合检索专业来源、官网及授权公众号资料,查询食品伙伴网的专业数据(法规、标准、添加剂、污染物、生产许可等),检索批准域名下的实时网页与政策信息,并通过自然语言查询表格真实数据、查看表结构、按受控 DSL 查行及预览原始网格。
使用方式上,所有数据源统一通过 REST API 调用,基础地址为 https://wiki.sbtbiotech.cn/api/v1,鉴权使用环境变量 DEEPKNOW_API_KEY,请求头包括 X-API-Key、X-DeepKnow-Channel 和 X-DeepKnow-Skill-Version。调用前需阅读对应能力文档(如 knowledge-bases.md、import.md、search.md、food-knowledge.md、external-search.md、tabular.md),参数与工作流以文档为准。检索前需根据用户意图选择单一业务入口,不因空结果或错误自行切换入口或追加多源查询。写操作方面,上传、导入或写入可直接执行;编辑、重新解析或删除前需确认具体条目,删除必须获得用户明确确认。表格数据查询需按 tabular.md 执行,不得用 AI 摘要冒充原始表格值。
当后端返回 HTTP 426 及 upgrade_info 时,需先确认 request_executed 为 false,然后使用固定命令升级(npx --yes skills@latest update deepknow -g -y,或重新安装 npx --yes skills@latest add SBTbiotech/deepknow-skill --skill deepknow -a codex -g -y),升级后仅重试一次原请求,避免循环。限制方面,所有数据源仅通过本 Skill 的 REST API 和 DEEPKNOW_API_KEY 调用,不直接连接 /mcp、不调用 MCP 工具,也不向用户索取 FoodPartner、Firecrawl 或 MCP 凭据。内部知识库检索与深读引用必须来自实际返回的 content 中逐字支持结论的短句,结果顺序以 rank 和数组顺序为准,外部检索保持接口返回顺序。