Omi Crossref App：为 Omi 对话工具打造的无认证学术文献检索集成

Omi Crossref App为 Omi 对话工具打造的无认证学术文献检索集成【免费下载链接】FriendAI that sees your screen, listens to your conversations and tells you what to do项目地址: https://gitcode.com/GitHub_Trending/fr/Friend本篇技术指南围绕开源仓库GitHub_Trending/fr/Friend中 plugins/omi-crossref-app 插件展开系统讲解如何基于公共 Crossref REST API 构建一套免认证no-auth的 Omi chat tools 集成服务。读完本文你将掌握该插件的三个核心工具文献搜索、DOI 详情查询、按作者检索的接口契约、底层调用链与部署方式并能直接本地运行或发布到 Railway/Heroku 类平台。插件定位无认证的学术元数据查询服务omi-crossref-app是 Omi 插件体系中的独立子应用其目标是在对话场景中为 AI 提供学术论文元数据检索能力。与仓库内其他需要 OAuth 或 API Key 的插件如 plugins/omi-google-calendar-app、plugins/omi-dropbox-app不同它直接使用公共的 Crossref REST APIhttps://api.crossref.org不依赖任何环境变量、OAuth 流程或密钥天然适合作为轻量 chat tool 接入。从 README 的定位描述A no-auth Crossref integration app for Omi chat tools与 main.py 中 FastAPI 应用的标题Crossref Omi Integration可以确认该插件只承担查询、清洗、返回文本结果这一件事不涉及数据库、鉴权与用户态存储。三个核心工具及其请求契约README 声明了三个工具其参数契约完整定义在 main.py 的/tools端点以及 models.py 的 Pydantic 模型中工具名功能输入参数默认值search_crossref_works按关键词搜索学术文献query必填、max_results1–10max_results5get_crossref_work按 DOI 获取单篇文献详情doi必填—get_crossref_works_by_author按作者名列出近期文献author必填、max_results1–10max_results5三个输入模型SearchWorksInput、GetWorkInput、AuthorWorksInput均继承pydantic.BaseModel其中max_results默认为 5。所有工具响应统一使用ChatToolResponseresult/error二选一的可选字段这保证了 Omi 侧解析结果时接口形状一致。1. search_crossref_works关键词检索对应实现位于 main.py。它先将query去除首尾空白并校验长度至少 2 个字符随后调用crossref_get(/works, {query: query, rows: limited, sort: relevance, order: desc})即按相关度降序向 Crossref 拉取最多limited条结果最后逐条输出序号. 标题 (年份)与DOI: xxx两行文本。注意max_results并非直接透传clamp_max_resultsmain.py会将其钳制在max(1, min(10, value))区间内防止越界请求。2. get_crossref_work按 DOI 查详情对应实现位于 main.py。入参doi需满足两个校验必须包含/否则返回Invalid DOI format. Example: 10.1038/nphys1170且不得包含..防路径注入类异常值。合法后将 DOI 通过urllib.parse.quote编码后请求/works/{doi}输出Title / DOI / Year / Publisher / URL五行并在存在摘要时追加Abstract: {abstract[:1200]}截断至 1200 字符以控制 token 消耗。3. get_crossref_works_by_author按作者检索对应实现位于 main.py。逻辑与关键词检索对称但请求参数改为query.author、sort: published、order: desc即按出版时间降序返回该作者最近的作品列表。底层实现要点JATS 清洗与年份提取Crossref 的abstract字段经常携带 JATS XML 标记如jats:p、jats:italic而 chat tools 需要纯文本。clean()函数main.py按三层正则处理无条件剥离jats:...开闭标签_JATS_TAG无条件剥离通用闭合标签_CLOSE_TAG对开标签要求其前一个字符不是字母/数字/下划线_OPEN_TAG使用负向后行断言从而保留ab这类数学不等式。同时clean()会先执行html.unescape将amp;还原为。这一行为有专门的单测佐证test_clean.py 中的四个用例分别验证了 JATS 段落标签剥离jats:pSleep quality improved jats:italicslightly/jats:italic./jats:p→Sleep quality improved slightly.、HTML 实体反转义、不等式操作符保留If ab, then cd.原样输出以及闭合标签清理。年份提取由extract_year()main.py完成按published-print→published-online→issued的优先级读取date-parts[0][0]全部缺失时返回空字符串保证输出行格式稳定。HTTP 调用层与超时控制所有上游请求统一走crossref_get()异步封装main.py每次调用创建httpx.AsyncClient(timeout20.0)拼接CROSSREF_BASEhttps://api.crossref.org发起 GET异常时由上层捕获并转为ChatToolResponse(error...)返回。20 秒超时对 Crossref 公共 API 的典型响应时间留有余量同时避免工具调用长期挂起拖慢对话。依赖版本钉死在 requirements.txtfastapi0.104.1、uvicorn0.24.0、httpx0.27.0、pydantic2.5.2保证构建可复现。本地运行README 给出了最简启动方式pip install -r requirements.txt uvicorn main:app --reload --host 0.0.0.0 --port 8080启动后服务提供四类端点GET /health健康检查返回{status: ok}main.pyGET /tools人类可读的工具清单名称、描述、参数GET /.well-known/omi-tools.jsonOmi 平台约定的工具清单端点main.py声明每个工具的endpoint、method: POST、参数properties/required、auth_required: false及status_message如Searching Crossref...供 Omi 侧自动发现与挂载POST /tools/{tool_name}三个工具的实际执行端点。可以先用 curl 做端到端自测# 搜索文献 curl -X POST http://localhost:8080/tools/search_crossref_works \ -H Content-Type: application/json \ -d {query:graph neural network, max_results:3} # 按 DOI 查详情 curl -X POST http://localhost:8080/tools/get_crossref_work \ -H Content-Type: application/json \ -d {doi:10.1038/nphys1170} # 按作者查近期作品 curl -X POST http://localhost:8080/tools/get_crossref_works_by_author \ -H Content-Type: application/json \ -d {author:Geoffrey Hinton, max_results:3}同一仓库中的 plugins/omi-arxiv-app 遵循完全相同的架构/health/.well-known/omi-tools.jsonPOST /tools/*可作为对照参考。部署到 Railway / Heroku插件为平台即服务PaaS部署做了两重准备Procfileweb: uvicorn main:app --host 0.0.0.0 --port ${PORT:-8080}兼容 Heroku 等按PORT环境变量注入端口的平台本地缺省回退 8080railway.tomlRailway 部署配置builder NIXPACKS自动识别 Python 项目startCommand同样读取$PORT并配置healthcheckPath /health、healthcheckTimeout 100、restartPolicyType ON_FAILURE、restartPolicyMaxRetries 10。由于服务无状态且不读写本地文件--reload仅用于开发环境生产部署时直接以 Procfile/railway.toml 中不带--reload的启动命令运行即可。在 Omi 生态中的角色与适用边界从 plugins/main.py 的聚合入口可见Omi 插件体系把各集成作为独立 FastAPI 子应用挂载而omi-crossref-app这类工具型插件则更倾向于独立部署通过/.well-known/omi-tools.json清单被对话运行时发现属于 Omi 的 chat tools 能力通道。需要明确两点适用边界其一本插件是只读的元数据查询服务不提供文献全文下载、引用导出或账号体系其二结果质量完全取决于 Crossref 公共索引的收录与字段完整度——缺失title/date-parts的记录会回退为Untitled/空年份见clean与extract_year的防御逻辑摘要字段仅在有值时输出且截断至 1200 字符。基于这些源码级事实本插件最适合作为学术场景对话助手的轻量检索后端与 plugins/omi-pubmed-appNCBI E-utilities、plugins/omi-arxiv-apparXiv Atom feed共同构成免认证学术检索工具矩阵。【免费下载链接】FriendAI that sees your screen, listens to your conversations and tells you what to do项目地址: https://gitcode.com/GitHub_Trending/fr/Friend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考