【免费下载链接】cupertinoA local Apple Documentation crawler and MCP server. Written in Swift.项目地址https://gitcode.com/gh_mirrors/cup/cupertino点击查看免费下载Cupertino 是一个本地 Apple 文档爬虫与 MCP 服务器用它做多源融合搜索时一条cupertino search命令就能并行查询 Apple 文档、Swift 提案、示例代码等 8 大数据源并通过 RRFReciprocal Rank Fusion倒数排名融合把各源的独立排名合并成一份权威排序让新手也能一次拿到最佳结果。快速上手3 分钟安装 Cupertino大多数用户推荐用 Homebrew 安装再执行一次setup下载预构建数据库即可brew tap mihaelamj/tap brew install cupertino cupertino setup # 下载预构建数据库约 30 秒偏好从源码构建的话可先克隆仓库git clone https://gitcode.com/gh_mirrors/cup/cupertino cd cupertino make build # 构建 release 二进制 cupertino setup装好后跑一条搜索感受一下融合效果cupertino search NavigationStack --limit 5输出开头会显示Searched: apple-docs, samples, swift-evolution, ...告诉你本次哪些数据源真正参与了融合。8 大数据源一览Cupertino 把文档拆成 8 个按源独立的数据库fan-out 模式下全部可用数据源内容RRF 权重apple-docsApple 官方框架参考36 万 页面、417 个框架3.0swift-evolutionSwift 语言提案约 429 条1.5packagesSwift 包源码与元数据185 个包1.5swift-bookSwift 编程语言官方教程1.0swift-orgswift.org 文档约 501 页1.0samplesApple 官方示例代码619 个项目1.0apple-archive2016 年前的 Apple 遗留指南0.5higHuman Interface Guidelines 设计指南0.5权重定义在 SmartQuery.swift 的sourceWeights表中。fan-out 搜索如何工作五步流水线不带--source的搜索默认进入 fan-out 模式完整流程是详见 docs/commands/search/README.md打开所有可用数据库按--skip-*开关决定哪些源参与意图检测查询长得像 Swift 符号名单个大写开头的标识符如Task、View时自动裁剪到符号权威源按源独立查询每个源用自己的排序器apple-docs 内部是 BM25F返回最多--per-source个候选RRF 融合按weight[source] / (k rank)k 60累加打分渲染按--limit截断输出分段摘要text / json / markdown 三种格式。某个源的数据库缺失或损坏时只会被降级跳过不会拖垮整条查询——这是融合搜索对新手最友好的地方之一。RRF 排名背后的公式与权重技巧RRF 的核心公式出自 Cormack 等人的经典论文实现见 SmartQuery.swift 的融合循环fused(d) Σ 各源 weight(source) / (k rank_s(d))k 60为什么用它各源的原始分数刻度互不兼容有的取反 BM25有的是归一化分数直接比大小毫无意义而排名位置是各源可比的所以“各自先排好、再按名次融合”天然稳健。Cupertino 在此基础上加了权威权重让 apple-docs 的 rank-1 结果在平局时稳赢源权重rank-1 的融合贡献apple-docs3.03.0/61 ≈ 0.0492swift-evolution / packages1.51.5/61 ≈ 0.0246swift-book / swift-org / samples1.01.0/61 ≈ 0.0164hig / apple-archive0.50.5/61 ≈ 0.0082这套权重的实测效果记录在 search-quality-crosssource-baseline-v1.2.0.md25 条跨源查询中19 条“期望源存在即命中 top-1”全部为 100%。6 个实用排名技巧1. 用符号名查询触发意图路由输入Task这类单个大写标识符时Cupertino 会走 isLikelySymbolQuery 判定把 fan-out 裁剪到apple-docs、swift-evolution、packages三个符号权威源避免散文型语料把 API 页面挤出第一页。所以查 API 直接敲符号名比敲完整句子更精准。2. 用 --per-source 和 --limit 控制结果规模--per-source默认 10限制每个源进入融合前的候选数防止某个语料库用大量边缘匹配淹没其他源的强命中--limit默认 20限制融合后的最终条数。两者配合使用例如cupertino search actor reentrancy --per-source 5 --limit 3即可快速 triage说明见 docs/commands/search/option (--)/per-source.md/per-source.md)。3. 给 HIG 这类低权重源用 --source 定向查询HIG 与 apple-archive 权重只有 0.5默认融合下很难冲到 top-1设计如此参考 交叉源基线审计。查设计规范时直接锁定单源跳过 RRF 阶段用源内原生排序cupertino search Dark mode --source hig cupertino search CALayer --source apple-archive4. 用 --skip-* 开关排除干扰源只关心第三方包时跳过 Apple 文档系源只看示例代码时跳过 packagescupertino search swift-nio EventLoopGroup --skip-docs5. 按平台与最低版本过滤配合--platform与--min-version可以把结果限定到目标部署平台cupertino search structured concurrency --platform iOS --min-version 16.06. 用 serve 接入 AI Agentcupertino serve启动 MCP 服务器后AI 客户端调用同一个search工具即可享受完全相同的 RRF 融合流水线serve 命令文档AI 拿到的是带分数与来源的 JSON可直接read_document跟进。延伸阅读项目关键文件融合核心实现SmartQuery.swiftsearch 命令完整选项文档docs/commands/search/README.md数据库与 RRF 架构详解docs/architecture/database.md质量基线审计方法论docs/design/search-quality-eval.md项目总览与数据源清单README.md小结Cupertino 的多源融合搜索把“一次查询、八源参与、RRF 融合”做成了默认行为用符号名查询触发意图路由用--per-source/--limit控制规模用--source定向低权重源再配合--platform过滤与 MCP 接入新手也能在几毫秒内拿到跨 8 大数据源、且经过权威加权排名的最佳答案。赞分享【免费下载链接】cupertinoA local Apple Documentation crawler and MCP server. Written in Swift.项目地址https://gitcode.com/gh_mirrors/cup/cupertino点击查看免费下载相关推荐xerj 混合检索实战一条 hybrid 查询用 RRF 融合 BM25 与 kNNxerj 混合检索实战一条 hybrid 查询用 RRF 融合 BM25 与 kNN 本篇以 混合检索配方 https://link.gitcode.com/人工智能搜索引擎本地部署后端MCP 服务Cupertino查询流水线全解从用户输入到BM25F重排再到RRF融合的10步排序Cupertino查询流水线全解从用户输入到BM25F重排再到RRF融合的10步排序 Cupertino 是一个用 Swift 编写的本地 Apple 文档爬一条SQL搞定两种搜索SereneDB混合搜索与RRF分数融合实战一条SQL搞定两种搜索SereneDB混合搜索与RRF分数融合实战 SereneDB 是一个实时搜索分析数据库Real Time Search Ana创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考