Cupertino

Cupertino 是一個基於 Swift 的本地化工具，用於爬取、索引並通過模型上下文協議（MCP）向 AI 智能體提供蘋果開發者文檔。它支持離線訪問超過 23 萬頁的蘋果平臺文檔、Swift 提案、設計指南和示例代碼，並通過 SQLite FTS5 搜索引擎實現快速檢索。

開發者工具搜索工具 #蘋果文檔 #本地搜索 #AI助手 #離線開發 .swift

評分 : 2.5分

下載量 : 5.6K

更新時間 : 2025-12-29

打開站點

什麼是Cupertino?

Cupertino是一個專門為AI助手設計的本地Apple文檔系統。它能夠自動抓取、索引並離線存儲Apple的官方開發者文檔，然後通過Model Context Protocol（MCP）讓Claude等AI助手能夠準確查詢Apple API信息，避免AI幻覺問題。

如何使用Cupertino?

Cupertino提供三種使用方式：1) 一鍵安裝下載預構建數據庫（最快，約30秒）；2) 從GitHub流式構建（約45分鐘）；3) 完整手動抓取（約20-48小時）。安裝後配置Claude Desktop即可使用。

適用場景

Cupertino最適合以下場景：1) 離線開發時需要查閱Apple文檔；2) 希望AI助手提供準確的Apple API信息；3) 需要快速搜索Swift Evolution提案；4) 研究Apple設計指南和最佳實踐；5) 查找官方示例代碼和實現方案。

主要功能

多源文檔抓取

支持Apple開發者文檔（234,000+頁面）、Swift Evolution提案、Swift.org文檔、Swift包元數據、Apple示例代碼、Apple Archive歷史指南、Human Interface Guidelines等7種文檔源。

全文搜索引擎

基於SQLite FTS5和BM25排名的快速搜索，支持詞幹提取（如'running'匹配'run'）、框架過濾、平臺版本過濾，查詢響應時間<100ms。

MCP協議集成

通過Model Context Protocol為AI助手提供文檔訪問能力，支持search_docs、search_hig、list_frameworks、read_document等工具調用。

完全離線訪問

所有文檔本地存儲，無需網絡連接即可使用。包含287個框架的完整文檔，總計234,331個頁面。

示例代碼搜索

索引606個Apple官方示例項目，18,000+ Swift文件全文搜索，可直接查看項目README和源代碼。

預構建數據庫

提供一鍵下載的預構建文檔數據庫，30秒內完成安裝，無需長時間抓取。包含Swift包目錄（9,699個包）和示例代碼目錄。

優勢

消除AI幻覺：為AI助手提供準確的Apple API文檔，避免錯誤信息

離線開發：無網絡環境下也能訪問完整文檔

確定性搜索：相同查詢總是返回相同結果，可重現

本地控制：完全掌控自己的文檔數據，可檢查數據庫和自定義工作流

AI優先設計：專門為AI助手集成優化，通過MCP協議無縫連接

快速安裝：預構建數據庫30秒完成安裝，無需長時間等待

侷限性

僅支持macOS 15+：需要最新macOS系統

初始抓取時間長：完整抓取需要20-48小時（但預構建數據庫可避免此問題）

磁盤空間需求：完整文檔約需2-3GB存儲空間

文檔更新延遲：需要手動更新才能獲取最新文檔

僅限Apple平臺：專注於Apple生態，不包含其他平臺文檔

如何使用

安裝Cupertino

選擇最適合您的安裝方式。推薦使用一鍵安裝命令，最快最簡單。

下載文檔數據庫

使用setup命令下載預構建的文檔數據庫，這是最快的方式。

配置Claude Desktop

編輯Claude Desktop配置文件，添加Cupertino作為MCP服務器。

重啟並開始使用

重啟Claude Desktop，現在您可以向Claude詢問Apple相關技術問題了。

使用案例

SwiftUI開發查詢

在開發SwiftUI應用時，需要查詢特定組件的使用方法

Swift語言特性研究

瞭解Swift Evolution提案中的新語言特性

設計規範查閱

設計iOS應用時需要參考Apple的設計指南

示例代碼查找

需要查找特定功能的官方實現示例

API可用性檢查

檢查某個API支持的最低系統版本

常見問題

Cupertino需要網絡連接嗎？

為什麼抓取文檔需要那麼長時間？

支持哪些AI助手？

如何更新文檔？

可以在非macOS系統上使用嗎？

文檔數據存儲在哪裡？

可以只下載特定框架的文檔嗎？

如何檢查服務器是否正常運行？

🚀 ReleaseTool

ReleaseTool 是一款僅由維護者使用的命令行工具（CLI），用於自動化 Cupertino 項目的發佈流程，極大地提高了發佈效率和準確性。

🚀 快速開始

使用 cupertino-rel 可自動化多步驟的發佈流程：

bump - 更新 Constants.swift、README.md、CHANGELOG.md 和 DEPLOYMENT.md 中的版本號。
tag - 提交更改並創建 Git 標籤。
databases - 打包並將數據庫上傳到 cupertino-docs。
homebrew - 用新的 SHA256 更新 Homebrew 公式。
full - 按順序運行所有步驟（默認）。

📦 安裝指南

cd Packages
swift build --product cupertino-rel

💻 使用示例

基礎用法

完整發布

# 通過版本號發佈
cupertino-rel 0.5.0

# 通過版本更新類型發佈
cupertino-rel patch   # 從 0.4.0 到 0.4.1
cupertino-rel minor   # 從 0.4.0 到 0.5.0
cupertino-rel major   # 從 0.4.0 到 1.0.0

# 預覽更改而不實際執行
cupertino-rel 0.5.0 --dry-run

單個命令

# 僅更新版本號
cupertino-rel bump 0.5.0
cupertino-rel bump patch --dry-run

# 打標籤並推送
cupertino-rel tag --push
cupertino-rel tag --version 0.5.0 --dry-run

# 上傳數據庫（需要 GITHUB_TOKEN）
export GITHUB_TOKEN="your-cupertino-docs-token"
cupertino-rel databases
cupertino-rel databases --dry-run

# 更新 Homebrew 公式
cupertino-rel homebrew --version 0.5.0
cupertino-rel homebrew --dry-run

跳過選項

# 跳過等待 GitHub Actions
cupertino-rel 0.5.0 --skip-wait

# 跳過數據庫上傳
cupertino-rel 0.5.0 --skip-databases

# 跳過 Homebrew 更新
cupertino-rel 0.5.0 --skip-homebrew

🔧 技術細節

環境變量

屬性	詳情
`GITHUB_TOKEN`	用於 `databases` 和 `full` 命令，是對 `cupertino-docs` 倉庫具有寫入權限的令牌

修改的文件

bump 命令會更新以下文件：

文件	字段
`Packages/Sources/Shared/Constants.swift`	`version = "X.Y.Z"`
`README.md`	`Version: X.Y.Z`
`CHANGELOG.md`	添加 `## X.Y.Z` 章節
`docs/DEPLOYMENT.md`	`Version: X.Y.Z`

為何與 CLI 分離

安全性 - 發佈憑證不會暴露給用戶。
簡潔的用戶體驗 - 用戶僅看到所需的命令。
可維護性 - 發佈邏輯可以獨立發展。

架構

ReleaseTool/
├── ReleaseCLI.swift           # @main 入口點，共享輔助函數
├── BumpCommand.swift          # 使用正則表達式進行版本更新
├── TagCommand.swift           # Git 操作
├── DatabaseReleaseCommand.swift  # GitHub Releases API
├── HomebrewCommand.swift      # 公式更新
├── FullCommand.swift          # 編排所有步驟
└── README.md                  # 本文件