一個(gè)可維護(hù)的 TqSdk 策略至少要把行情更新、信號(hào)計(jì)算、目標(biāo)生成、執(zhí)行管理和狀態(tài)核對(duì)分開(kāi)。最小閉環(huán)不是“均線上穿就下單”這一句而是每根有效數(shù)據(jù)只計(jì)算一次、目標(biāo)只在變化時(shí)更新、委托由單一入口管理、成交后持倉(cāng)能夠與目標(biāo)對(duì)賬、異常時(shí)停止新增風(fēng)險(xiǎn)。先把純計(jì)算函數(shù)獨(dú)立出來(lái)信號(hào)函數(shù)只接收固定數(shù)據(jù)不創(chuàng)建 API、不讀取賬戶也不下單。這樣同一函數(shù)可以用小樣本測(cè)試、在回測(cè)中調(diào)用也能在實(shí)時(shí)循環(huán)使用。def moving_average_signal(closes, short5, long20): if len(closes) long: return 0 short_ma closes.iloc[-short:].mean() long_ma closes.iloc[-long:].mean() if short_ma long_ma: return 1 if short_ma long_ma: return -1 return 0返回值只表達(dá)方向示例不代表完整盈利策略。窗口、交叉確認(rèn)、退出條件和重復(fù)信號(hào)都需要按真實(shí)規(guī)則定義。純函數(shù)的價(jià)值是輸入與輸出清楚計(jì)算錯(cuò)誤不會(huì)和網(wǎng)絡(luò)、賬戶問(wèn)題混在一起。行情層只在正確事件上觸發(fā)策略若按一分鐘收盤判斷就訂閱足夠長(zhǎng)度的 K 線在末行datetime變化時(shí)使用已完成數(shù)據(jù)。當(dāng)前末行仍在形成不應(yīng)提前當(dāng)成收盤值。import os from tqsdk import TqApi, TqAuth, TqSim, TargetPosTask symbol SHFE.rb2610 sim TqSim(init_balance100000) api TqApi( sim, authTqAuth(os.environ[TQ_USER], os.environ[TQ_PASSWORD]), ) klines api.get_kline_serial(symbol, 60, data_length50) position sim.get_position(symbol) executor TargetPosTask(api, symbol, priceACTIVE) last_target None try: while True: api.wait_update() if not api.is_changing(klines.iloc[-1], datetime): continue closed klines.close.iloc[:-1] signal moving_average_signal(closed) target signal if target ! last_target: executor.set_target_volume(target) last_target target print(目標(biāo), target, 當(dāng)前持倉(cāng), position.pos) finally: api.close()代碼使用本地模擬賬戶并把方向直接映射為一手目標(biāo)僅用于骨架演示。正式策略要把風(fēng)險(xiǎn)預(yù)算、合約有效性、交易時(shí)段和退出規(guī)則放在目標(biāo)進(jìn)入執(zhí)行器之前。目標(biāo)層把信號(hào)翻譯成賬戶意圖信號(hào)為一不一定等于目標(biāo)一手。目標(biāo)手?jǐn)?shù)可能取決于賬戶資金、合約風(fēng)險(xiǎn)、當(dāng)前持倉(cāng)和組合限制。應(yīng)有獨(dú)立函數(shù)把信號(hào)轉(zhuǎn)換為目標(biāo)并返回拒絕原因。def build_target(signal, risk_ok, unit_size1): if not risk_ok: return None, RISK_BLOCKED if signal not in {-1, 0, 1}: return None, INVALID_SIGNAL return signal * unit_size, OK返回None表示本輪不允許改變目標(biāo)不等同于目標(biāo)零。零是明確空倉(cāng)意圖二者必須區(qū)分。否則風(fēng)險(xiǎn)檢查失敗時(shí)程序可能意外發(fā)出平倉(cāng)目標(biāo)。目標(biāo)也要帶信號(hào)時(shí)間和規(guī)則版本。執(zhí)行前發(fā)現(xiàn)行情已經(jīng)過(guò)期或規(guī)則已切換就應(yīng)丟棄舊目標(biāo)。只傳一個(gè)整數(shù)會(huì)讓后續(xù)無(wú)法判斷它為何產(chǎn)生。目標(biāo)函數(shù)還應(yīng)保持確定性相同信號(hào)、賬戶快照和配置得到相同結(jié)果。若函數(shù)內(nèi)部讀取隨時(shí)變化的全局變量回測(cè)復(fù)現(xiàn)與實(shí)時(shí)排錯(cuò)都會(huì)變得困難。需要?jiǎng)討B(tài)風(fēng)險(xiǎn)數(shù)據(jù)時(shí)把它作為顯式輸入并記錄時(shí)間。組合策略中單合約目標(biāo)還要經(jīng)過(guò)賬戶級(jí)匯總。每個(gè)信號(hào)分別看都合規(guī)合在一起可能超過(guò)資金或方向限制。先生成候選目標(biāo)再由統(tǒng)一風(fēng)險(xiǎn)層批準(zhǔn)避免各合約自行占用同一份預(yù)算。執(zhí)行層必須只有一個(gè)訂單入口示例使用 TargetPosTask 后不再對(duì)同一合約調(diào)用insert_order。若改為手工訂單管理也應(yīng)由一個(gè)執(zhí)行組件負(fù)責(zé)創(chuàng)建、撤銷和跟蹤訂單。多個(gè)信號(hào)函數(shù)不能各自直接下單。執(zhí)行層讀取當(dāng)前持倉(cāng)、活動(dòng)委托和目標(biāo)差額記錄每個(gè)動(dòng)作的業(yè)務(wù)標(biāo)識(shí)。目標(biāo)未完成時(shí)新信號(hào)如何處理需要明確覆蓋舊目標(biāo)、排隊(duì)還是先取消再評(píng)估。沒(méi)有規(guī)則就會(huì)產(chǎn)生重復(fù)訂單。成交后執(zhí)行層更新賬戶事實(shí)不反向修改信號(hào)。信號(hào)解釋市場(chǎng)判斷成交解釋實(shí)際執(zhí)行兩者分開(kāi)才能看出偏差來(lái)自策略還是交易過(guò)程。執(zhí)行動(dòng)作也需要冪等邊界。相同業(yè)務(wù)標(biāo)識(shí)被重復(fù)提交時(shí)執(zhí)行層應(yīng)識(shí)別已有目標(biāo)或活動(dòng)委托而不是再次創(chuàng)建訂單。網(wǎng)絡(luò)重試、任務(wù)重啟和重復(fù)行情事件都可能讓同一請(qǐng)求到達(dá)兩次防重復(fù)不能只依賴上游。當(dāng)目標(biāo)被新目標(biāo)覆蓋時(shí)先記錄覆蓋關(guān)系再?zèng)Q定撤銷舊委托還是等待完成。沒(méi)有明確策略時(shí)最安全的是停止新增動(dòng)作并核對(duì)當(dāng)前賬戶而不是同時(shí)追趕兩個(gè)目標(biāo)。狀態(tài)核對(duì)讓閉環(huán)真正結(jié)束每次目標(biāo)變化后至少要核對(duì)訂單狀態(tài)、成交記錄、持倉(cāng)和資金。持倉(cāng)等于目標(biāo)但仍有活動(dòng)委托時(shí)任務(wù)尚未完全安全訂單結(jié)束但持倉(cāng)不符時(shí)也不能直接重發(fā)。可以為一次目標(biāo)建立狀態(tài)序列已產(chǎn)生、已通過(guò)風(fēng)險(xiǎn)檢查、已交給執(zhí)行器、出現(xiàn)訂單、出現(xiàn)成交、持倉(cāng)達(dá)到目標(biāo)、活動(dòng)委托歸零。每一步都保留時(shí)間和關(guān)鍵標(biāo)識(shí)。程序重啟后從賬戶讀取持倉(cāng)與訂單再結(jié)合最后目標(biāo)恢復(fù)。內(nèi)存中的last_target會(huì)丟失不能因?yàn)樗謴?fù)成None就再次提交同一動(dòng)作。日志與配置怎樣支撐復(fù)現(xiàn)配置保存合約、周期、窗口、手?jǐn)?shù)上限和賬戶環(huán)境不保存憑據(jù)。啟動(dòng)時(shí)校驗(yàn)每個(gè)參數(shù)并輸出非敏感摘要。任何默認(rèn)值都應(yīng)明確不能因缺少配置靜默切換到實(shí)盤或另一合約。日志按事件記錄而不是每輪打印全部對(duì)象。新 K 線、信號(hào)變化、目標(biāo)變化、風(fēng)險(xiǎn)拒絕、訂單變化、成交和退出各有清楚類型?？吹阶罱K持倉(cāng)時(shí)可以沿標(biāo)識(shí)回到產(chǎn)生它的信號(hào)。同一策略在回測(cè)和實(shí)時(shí)模擬中盡量復(fù)用計(jì)算與目標(biāo)函數(shù)只更換數(shù)據(jù)推進(jìn)和賬戶環(huán)境。若兩邊各寫一套條件結(jié)果差異很難解釋。測(cè)試也按層進(jìn)行。計(jì)算層用固定表格驗(yàn)證邊界目標(biāo)層用不同信號(hào)和風(fēng)險(xiǎn)狀態(tài)驗(yàn)證輸出執(zhí)行層在模擬賬戶測(cè)試未成交與撤單整合層再跑完整事件循環(huán)。分層測(cè)試能在最終持倉(cāng)錯(cuò)誤前找到更早的原因。每層輸出都保留最小定位數(shù)據(jù)時(shí)間、信號(hào)標(biāo)識(shí)、目標(biāo)標(biāo)識(shí)、訂單標(biāo)識(shí)。它們不是給讀者看的復(fù)雜流程字段而是讓運(yùn)行中的一次動(dòng)作能夠從結(jié)果回到來(lái)源。策略骨架的適用邊界這份骨架沒(méi)有處理復(fù)雜開(kāi)平、換月、多賬戶、多合約組合和真實(shí)交易成本也沒(méi)有證明均線規(guī)則有效。它只展示職責(zé)如何連接。任何新增功能應(yīng)放進(jìn)對(duì)應(yīng)層而不是直接塞進(jìn)主循環(huán)。高頻數(shù)據(jù)或耗時(shí)計(jì)算可能需要異步任務(wù)或外部進(jìn)程但先保證單循環(huán)版本正確。并發(fā)不會(huì)修復(fù)錯(cuò)誤狀態(tài)只會(huì)增加重現(xiàn)難度。進(jìn)入實(shí)盤前必須在回測(cè)與實(shí)時(shí)模擬分別驗(yàn)證并主動(dòng)測(cè)試異常、重啟和未成交場(chǎng)景。能運(yùn)行一段時(shí)間不報(bào)錯(cuò)只說(shuō)明順利路徑?jīng)]有立刻失敗。最小閉環(huán)清單數(shù)據(jù)只在定義好的事件更新計(jì)算函數(shù)不接觸 API 與賬戶。信號(hào)經(jīng)風(fēng)險(xiǎn)和倉(cāng)位規(guī)則轉(zhuǎn)換為目標(biāo)None與零目標(biāo)含義分開(kāi)。同一合約只有一個(gè)執(zhí)行入口目標(biāo)、訂單、成交與持倉(cāng)可追溯。重啟從賬戶事實(shí)恢復(fù)日志和配置足以復(fù)現(xiàn)每次目標(biāo)變化?；販y(cè)、模擬與異常演練通過(guò)后才評(píng)估受控實(shí)盤驗(yàn)證。策略骨架的價(jià)值是讓每個(gè)問(wèn)題都有固定位置。行情不對(duì)查數(shù)據(jù)層信號(hào)不對(duì)查計(jì)算層手?jǐn)?shù)不對(duì)查目標(biāo)層持倉(cāng)不對(duì)查執(zhí)行與核對(duì)層。邊界清楚后策略復(fù)雜度增加也不會(huì)把所有錯(cuò)誤擠進(jìn)同一個(gè)循環(huán)。