此生成器適合的用途
此生成器會建立 Apps Script 側邊欄，連接使用者本機 PC 上的 Ollama，用於提問、處理選取範圍並建立主要函數。
它會呼叫 /api/tags 列出已安裝模型，並使用所選模型透過 /api/chat 執行 Ollama 回應診斷。
在編輯模式中，它會讀取 Google 試算表目前選取範圍，並在側邊欄顯示 A1 表記、大小、預覽、公式狀態與 fingerprint。
選取範圍資料與指示會從側邊欄瀏覽器 JavaScript 傳送到本機 Ollama。Code.gs 不會呼叫 localhost，編輯結果只會在使用者確認且 fingerprint 驗證通過後寫入。
網站側選擇的顯示語言
選單顯示語言
Google 應用程式選單與對話框或面板中顯示的語言。
導入後確認的項目
Sidebar Origin
需要設定 OLLAMA_ORIGINS 時，請複製側邊欄顯示的 Origin。
已安裝模型
模型清單來自 Ollama /api/tags。gemma4:12b-it-q4_K_M 會顯示為推薦模型。
Ollama 回應診斷
/api/chat 診斷只會傳送很小的提示，不會讀取或寫入試算表資料。
導入步驟
從 Google 試算表開啟 Apps Script
開啟要用於連線測試的 Google 試算表，從擴充功能開啟 Apps Script。
貼上 Code.gs
將生成的 Code.gs 貼到 Apps Script。若已有既有程式碼，請先備份再替換。
建立 Sidebar.html
建立名為 Sidebar 的 HTML 檔案，並貼上生成的 Sidebar.html 內容。
建立 Styles.html 與 ClientJS.html
再建立兩個名為 Styles 與 ClientJS 的 HTML 檔案，分別貼上生成的 Styles.html 與 ClientJS.html 內容。
確認 appsscript.json
在 Apps Script 專案設定中啟用資訊清單顯示，視需要確認並貼上生成的 appsscript.json。
儲存並重新載入試算表
儲存 Apps Script 專案後重新載入 Google 試算表。上方選單會顯示本機 AI。
開啟側邊欄並測試 Ollama
從 KOKOCAL 本機 AI 選單開啟本機 AI 助理，必要時複製 Sidebar Origin，然後執行 Ollama 連線與回應診斷。
確認選取範圍
在 Google 試算表中選取儲存格，按下側邊欄的確認選取範圍，確認 A1 範圍、大小、預覽與 fingerprint。
預覽 AI 結果
輸入指示並執行用 AI 處理，確認回傳矩陣會顯示在預覽中，此時尚不變更試算表。
套用 AI 結果
確認預覽後按下套用到試算表，只有 fingerprint 與大小仍一致時才寫入結果。
儲存導入指南
生成腳本後，可從生成結果欄右上方的「下載導入指南」儲存導入所需資訊。離開頁面後生成結果會消失，因此建議在導入前先儲存。
導入後確認事項
KOKOCAL 本機 AI 選單
重新載入試算表，確認上方選單顯示 KOKOCAL 本機 AI。
側邊欄開啟
選擇開啟本機 AI 助理，確認本機 AI 助理側邊欄會顯示。
Sidebar Origin
確認 Sidebar Origin 會顯示且可以複製。設定 OLLAMA_ORIGINS 時使用此值。
Ollama 停止時的錯誤
停止 Ollama 後執行連線測試，確認畫面顯示可理解的連線錯誤。
模型清單
在 Ollama 執行且 Origin 已允許的狀態下執行連線測試，確認 /api/tags 的模型會列出。
Ollama 回應診斷
選擇模型並執行 Ollama 回應診斷，確認 /api/chat 的回答會顯示在側邊欄。
選取範圍
選取單一儲存格、一欄多列、以及多列多欄範圍，確認側邊欄會顯示範圍資訊與顯示值。
AI 預覽
執行小範圍的表記統一任務，確認結果顯示在預覽中，此時原始試算表保持不變。
套用 AI 結果
套用預覽並確認只有目前選取範圍會被 AI 結果更新。
fingerprint 不一致時阻擋
預覽後變更來源儲存格或選取範圍，再確認套用會被阻擋。
沒有伺服器端 Ollama 通訊
確認 Code.gs 沒有使用 UrlFetchApp 存取 http://127.0.0.1:11434。
注意事項
確認後寫入試算表
此腳本會在預覽確認後，將 AI 結果寫入目前選取範圍。套用前請確認預覽，並在需要時使用可還原變更的檔案。
重要注意事項
正式使用生成腳本前，請確認此項目。
使用前確認
正式使用生成腳本前，請確認此項目。
公式與合併儲存格會被阻擋
為避免誤覆寫，選取範圍包含公式或合併儲存格時，會阻擋套用 AI 結果。
可能需要設定 OLLAMA_ORIGINS
如果 Apps Script 側邊欄的 Origin 未被 Ollama 允許，瀏覽器可能因 CORS 阻擋要求。設定 Ollama 時請使用畫面顯示的 Sidebar Origin。
瀏覽器本機網路權限
Chrome 的 Local Network Access 控制可能會要求 loopback 存取權限。允許後請再次執行連線測試。
本機 AI 的範圍
AI 推論會在使用者 PC 上的 Ollama 執行，但 Google 試算表本身是 Google 的雲端服務。編輯模式會將選取範圍與指示送到本機 Ollama 以生成預覽，並只在使用者確認後套用。
準備好後前往生成器
從 Google 試算表側邊欄連接本機 Ollama，用於提問、處理選取範圍與建立函數，並透過預覽與 fingerprint 檢查後套用。