Guide
Ollama 與推薦模型安裝指南
使用 KOKOCAL Google 試算表 AI 助理前，請先在本機電腦安裝 Ollama 本體與需要的模型。本頁整理 Windows、macOS、Linux 的導入方式、推薦模型安裝命令與導入後確認方法。
本機 AI 助理會連接到 http://127.0.0.1:11434 的 Ollama。
連線後會取得已安裝模型列表，並可依用途選擇使用模型。
若要使用圖片附件，請在圖片附件模型中選擇支援 Text, Image 的模型。
導入前須知
Ollama 是在本機電腦上執行大型語言模型的應用程式。KOKOCAL Google 試算表 AI 助理不是從 Google Apps Script 伺服器端連線，而是從側邊欄中的瀏覽器 JavaScript 直接連接到本機 PC 上的 Ollama。
Ollama 的連線端點固定為 http://127.0.0.1:11434。若無法連線，請確認 Ollama 是否正在啟動、瀏覽器是否允許本機存取，以及 OLLAMA_ORIGINS 是否已設定。
安裝 Ollama 本體
請先開啟 Ollama 官方網站，從首頁右上或中央的Download前往下載頁面。下載頁面中可從 macOS、Linux、Windows 分頁選擇使用中的作業系統。
使用安裝程式安裝
Windows 與 macOS 可從下載頁面取得安裝程式並執行，即可完成 Ollama 本體安裝。若已使用安裝程式導入，同一台 PC 不需要再執行額外的安裝命令。
安裝完成後前往推薦模型安裝使用命令安裝
若熟悉終端機操作，或使用 Linux 環境，可依官方文件中的命令安裝。安裝程式方式與命令方式擇一即可，不需要兩者都執行。
下方 OS 別卡片整理了使用命令安裝時的執行命令。模型檔案可能從數 GB 到十數 GB 以上，請同時確認儲存空間。
Windows
官方步驟通常從下載頁面的 Download for Windows 取得安裝程式並執行即可完成。下方命令是想用 PowerShell 安裝時的替代方式。
irm https://ollama.com/install.ps1 | iexmacOS
官方步驟通常從下載頁面取得 Ollama.dmg，並放入 Applications 即可完成。下方命令是想用 Terminal 安裝時的替代方式。
curl -fsSL https://ollama.com/install.sh | shLinux
官方步驟Linux 通常使用官方安裝腳本以命令方式導入。在 systemd 環境中，建議以服務方式啟動 Ollama。
curl -fsSL https://ollama.com/install.sh | sh安裝推薦模型
模型請依需要從重要項目開始安裝。只安裝標準版模型 gemma4:12b-it-q4_K_M 或輕量版模型 qwen3.5:9b，也可以先試用提問、函數建立與一般表格資料處理。若要使用 CSV/Text 附件或圖片附件，再依用途追加模型。
標準版模型組合
| 處理內容 | 推薦模型 |
|---|---|
| 通常與整合處理 | gemma4:12b-it-q4_K_M |
| CSV/Text 附件處理 | ministral-3:14b-instruct-2512-q4_K_M |
| 圖片處理 | qwen3-vl:8b |
輕量版模型組合
| 處理內容 | 推薦模型 |
|---|---|
| 通常與整合處理 | qwen3.5:9b |
| CSV/Text 附件處理 | qwen2.5vl:7b |
| 圖片處理 | qwen2.5vl:7b |
模型安裝命令請在 Windows 的 PowerShell，或 macOS、Linux 的 Terminal 中執行。複製命令並貼到終端機視窗後，按 Enter 執行。PowerShell 的導入方法請參考在 Windows 安裝 PowerShell 7 的方法。
標準版 通常與整合處理模型
gemma4:12b-it-q4_K_M
提問、函數建立與一般表格資料處理最先建議使用的模型。
ollama pull gemma4:12b-it-q4_K_M標準版 CSV/Text 附件處理模型
ministral-3:14b-instruct-2512-q4_K_M
適合讀取 CSV、TSV、文字、Markdown 等包含結構的附件資料。
ollama pull ministral-3:14b-instruct-2512-q4_K_M輕量版 CSV/Text 與圖片處理模型
qwen2.5vl:7b
以輕量構成嘗試 CSV/Text 附件處理與圖片處理的候選模型。
ollama pull qwen2.5vl:7bqwen3-vl 系列圖片對應模型可能會受 Ollama 版本需求影響。使用圖片附件前，請先將 Ollama 更新到最新版，再執行連線測試。
導入後確認
安裝後，請在終端機確認 Ollama 與模型是否被正確識別。Windows 請使用 PowerShell，macOS 與 Linux 請使用 Terminal。
確認 Ollama 版本
ollama -v
已安裝模型列表
ollama list
確認 Ollama API 啟動
用瀏覽器開啟 http://127.0.0.1:11434/api/tags
簡易啟動模型
ollama run gemma4:12b-it-q4_K_M
助理側確認
- 1
開啟側邊欄
重新載入 Google 試算表，從上方選單的 KOKOCAL 開啟本機 AI 助理。
- 2
執行連線
在 Ollama 設定中按下連線，確認已安裝模型會顯示在下拉選單中。
- 3
儲存 AI 模型設定
選擇通常處理、CSV/Text 附件、圖片附件與整合處理的模型，然後按下儲存並關閉。
- 4
執行 Ollama 回應診斷
在診斷模式中送出最小提示，確認有回應返回。
- 5
試用提問模式
詢問函數名稱或語法，選擇回答風格後執行 AI 提問。
官方資訊
安裝方法與模型標籤可能會更新。最新資訊請確認 Ollama 官方頁面。
Guide
相關指南
Ollama 與模型準備完成後，也建議確認 Apps Script 導入步驟與同時使用多個腳本時的注意事項。