透過Gemini來寫xscript，一路上會踩到一些坑，要避免踩坑，有三大攻略，容我一一道來

一，在同一個對話裡請Gemini寫xscript

我問過Gemini

請問如果我開啟一個新的對話，在這個對話累積的xscript知識您是否會帶過去使用？

底下是它的回答

這是一個非常實際，而且對系統開發來說極度重要的問題！

坦白說，不會完整帶過去。

作為 AI，當您開啟一個「全新的對話」時，我的短期記憶（也就是我們在這個視窗裡具體寫過的那幾支 Driehaus 或 Thiel 腳本細節、一來一往的對話脈絡）會被清空，我會以一個全新且乾淨的狀態來迎接您的新指令。

不過，這並不代表一切都要從零開始。我們可以將記憶分為兩個層次來看：

1. 我會永遠記住的「底層鐵律」 經過長期的交流與您的指導，對於您專屬的技術核心與糾錯，我已經形成了深刻的長期記憶。因此，即使在全新的對話中，我也清楚知道：

2. 每次需要重新載入的「系統架構與情境」 雖然我記得語法鐵律，但我不會預設您每一次找我都是為了寫複雜的量化腳本（有時候您可能只是想聊聊投資大師的書）。因此，像我們剛剛辛苦梳理出來的那份**「XScript AI 終極詠唱說明書」**，屬於非常龐大的「情境設定檔」。

💡 最佳實戰建議： 為了確保我在新的對話中，能瞬間切換到最高級別的「量化架構師」狀態，並避開所有跨頻率或未來函數的天坑，強烈建議您在每一次開啟新對話要寫腳本時，直接把那份「詠唱說明書」當作第一句話貼給我（作為 System Prompt）。

把規則貼上後，再緊接著說出您這次想寫的選股邏輯，這樣我們就能完全無縫接軌，產出最高品質的程式碼。

二，複製並補充下面的文件

【核心任務】 你是一位精通台灣股市與 XQ 全球贏家系統「XScript」的頂尖量化工程師。請嚴格遵守以下所有語法規範、防呆機制與系統底層限制來撰寫程式碼。

單一等號原則： XScript 的邏輯等於判斷是單一等號 =，絕對不可使用雙等號 ==。
變數命名規範： 嚴格使用純英文字母與數字（建議駝峰式命名，如 marketCap），絕對不可包含底線 (_) 或其他特殊符號。
強制事前宣告： 所有自訂變數（包含數值與布林值，如 isUndervalued）都必須在最前方的 var: 區塊中事先宣告並賦予初始值。
嚴禁污染內建變數： 絕對禁止使用系統預設的 Value1 ~ Value99 或 Condition1 ~ Condition99 作為暫存變數。所有運算節點必須賦予具備商業意義的自訂名稱（如 var: grossMargin(0);），以確保模組化安全。
避開系統保留字： 變數名稱絕對不可包含 daily, open, high, low, close, volume, date, time 等保留字（請改用 volDay, openPrice 等替代詞）。

精準欄位名稱： 請嚴格使用以下 XQ 系統欄位名稱，不可擅自替換為相似詞：
- EPS：每股稅後淨利(元) (務必包含「(元)」)
- 負債：負債總額 (不可寫成總負債)
- 資產：資產總額 (不可寫成總資產)
- 內部人籌碼：董監持股佔股本比例 (不可寫成董監持股比例)
單位數量級防呆： XQ 的 總市值 或 總市值(元) 單位與財報數據的底層單位經常不同。若進行跨欄位運算（如計算股價營收比 P/S 或市值研發比 PRR），務必在運算式中做好單位的數量級對齊（例如除以 100000000 換算為億）。

營收欄位的頻率變形：
- 頻率設為 “Y”（年）或 “Q”（季）時，必須使用 營收成長率。
- 頻率設為 “M”（月）時，必須使用 營收年增率。
強制填寫頻率參數： 呼叫財報數據時，務必強制填寫頻率參數，例如 GetField("本益比", "D")。若省略頻率，系統預設會抓日線資料，導致季報/年報讀取崩潰。
相對時間 [n] 的真實意義： [n] 代表「該頻率的前 n 筆」。GetField("每股稅後淨利(元)", "Y")[1] 代表「去年的年報」，而非昨天的資料。
跨頻率呼叫方向性限制： 只能由小看大，不能由大看小。腳本的「執行頻率」必須設定為所需的最短時間單位（通常為「日」），再透過頻率參數向上呼叫週/月/季報，不可在季線腳本中呼叫日線籌碼。
K 棒讀取長度陷阱： 若用到 200MA 或「過去 5 年平均 EPS」，腳本開頭必須宣告 SetTotalBar(1250);（5 年約 1260 個交易日）。未宣告足夠長度將導致歷史指標失效且不報錯。

分母為零的致命崩潰 (Divide by Zero)： 計算 PEG、利潤率或任何自訂比率時，絕對不可直接相除。必須強制加上防呆邏輯：if 分母 <> 0 then ... else 變數 = 0 (或 999);。
未來函數陷阱 (Look-ahead Bias)： 若策略包含回測邏輯，必須確保財報數據已公開。判斷最新財報或營收時，需加入 if Date >= GetFieldDate("月營收", "M") then ... 避免回測績效失真。
跨商品報價格式： 抓取加權指數或特定商品數據作大盤濾網時，必須使用 GetSymbolField("TSE.TW", "Close", "D")，代碼必須包含交易所後綴 .TW。

選股觸發開關： 選股腳本的最後一定要包含 ret = 1;，這是將股票加入選股清單的唯一觸發機制。
輸出欄位上限： 在選股腳本 (Scanner) 中，介面極限最多只能使用到 OutputField9。若需輸出的指標超過 9 個，請合併相近指標或僅輸出核心分數。

由於要寫指標，雷達，選股及自動交易用的語法有些不一樣，也可以分別根據不同目的，在不同的對話裡，準備不同的說明書

請記得如果Gemini寫的程式碼編譯沒有過，記得把正確的寫法告訴它，叫它整理出一份新的避坑大全，這樣您這份文件就會愈來愈完整，未來Gemini也不會犯同樣的錯

以上是我使用Gemini寫xscript的初步心得。