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