擴展市場使用文件

風險提示：擴展市場提供的是策略和工具的分發能力，不承諾任何收益。任何擴展藍圖在實盤前都必須先回測，再模擬執行，最後才考慮小資金實盤。交易所 API 不要開啟提幣權限。

開啟程式後，在頂部導覽進入 擴展 頁面。

頁面分為左右兩部分：

左側和右側之間的分隔條可以拖動，用來調整 我的擴展 面板寬度。

我的擴展 面板用於管理和查看與目前環境相關的擴展。

這裡可能出現兩類內容：

• 已經下載並安裝到本機的擴展。
• 目前登入帳號在雲端擁有或新增過的擴展。

需要注意：程式判斷一個擴展是否「已安裝」，主要看本機是否存在對應的市場藍圖檔案，而不是只看雲端帳號列表。因此，某個擴展即使在雲端屬於你，如果目前電腦還沒有下載到本機，仍可能顯示為未安裝狀態。

常見標記：

常見操作：

擴展市場首頁會展示可安裝擴展列表。預設排序會優先顯示下載量更高、評分更高的擴展。

你可以用以下方式縮小範圍：

• 關鍵字搜尋：在搜尋框輸入擴展名稱、作者、簡介、分類、市場類型等關鍵字後，點擊 搜尋 或按 Enter。
• 分類篩選：依擴展分類查看，例如策略、風控、訊號、工具等。具體分類由市場後台返回。
• 市場類型篩選：依擴展支援的市場篩選，例如 Spot 或 Futures。

如果搜尋後沒有結果，可以清空關鍵字，並把分類和市場類型切回 全部。

市場列表裡的每張擴展卡片會展示關鍵資訊：

藍圖擴展通常更適合直接用於策略流程；腳本類或工具類擴展的使用方式需要閱讀詳情說明。

點擊擴展卡片後會進入詳情頁。詳情頁由頭部資訊、說明區、評論區和右側資訊欄組成。

詳情頁重點看這些內容：

如果詳情頁顯示「暫無擴展說明」或「暫無更改日誌」，表示發布者沒有提供對應內容。此時更應謹慎使用，先做充分回測。

安裝步驟：

1. 進入 擴展 頁面。
2. 在市場列表中搜尋或篩選目標擴展。
3. 點擊擴展卡片進入詳情頁。
4. 閱讀 細節、更改日誌、評論和回測資訊。
5. 點擊 安裝。
6. 如果擴展需要提取碼，依彈窗輸入提取碼並確認。
7. 等待安裝成功提示。
8. 進入 藍圖 頁面或資源管理，查看新安裝的市場藍圖。

安裝藍圖擴展時，程式會把擴展包下載到本機市場藍圖目錄，並重新整理藍圖工作區。安裝成功後，擴展會帶有市場來源資訊、版本資訊、包校驗資訊和下載時間，用於後續識別安裝狀態和版本升級。

安裝可能需要對應權限。如果目前帳號沒有下載權限，程式會彈出權限提示。

擴展市場支援多種下載方式：

提取碼擴展在安裝時會彈出輸入框。提取碼為空或不正確時，安裝不會繼續。請檢查大小寫、空格和有效期。

藍圖擴展支援 回測預覽。它適合在安裝前快速判斷擴展是否值得進一步使用。

回測預覽的特點：

• 僅藍圖擴展支援回測預覽。
• 回測預覽會從市場取得遠端藍圖預覽，不會直接寫入本機藍圖檔案。
• 程式會先檢查藍圖能否編譯，再開啟回測視窗。
• 回測視窗會自動開始執行。
• 預設交易對優先使用藍圖已有配置；沒有配置時使用 BTCUSDT。

預設回測時間範圍會根據藍圖執行週期自動決定：

預覽回測結果只代表歷史資料下的一次測試表現。正式使用前，建議安裝後在 藍圖 頁面重新設定交易對、週期、手續費、滑點、資金、槓桿和更長時間範圍，再做多組回測。

藍圖擴展安裝成功後，會進入本機藍圖工作區。推薦使用流程：

1. 開啟 藍圖 頁面。
2. 在藍圖列表或資源管理中找到已安裝的市場藍圖。
3. 開啟藍圖，先檢查節點結構、參數、執行週期、市場類型和風控節點。
4. 執行歷史回測，確認盈虧、回撤、勝率、交易次數和訂單日誌。
5. 在 交易 頁面把藍圖掛載到目標圖表或帳戶下。
6. 先使用模擬交易模式執行，觀察訊號觸發、下單意圖和風控攔截。
7. 確認行為穩定後，再考慮使用小資金實盤。

實盤前重點檢查：

• 目前帳戶是否正確。
• 交易對和市場類型是否匹配，例如現貨或合約。
• 槓桿、保證金模式、倉位比例是否在可承受範圍內。
• 策略是否包含限頻、最大倉位、止損、冷卻、熔斷等風控。
• API 是否只開啟必要權限，不要開啟提幣權限。

當已安裝擴展出現 可升級 標記時，可以在詳情頁或 我的擴展 面板點擊 升級。

升級前建議先做三件事：

1. 查看 更改日誌，確認新版本改了什麼。
2. 停止正在執行的藍圖掛載。
3. 記錄目前版本的核心參數和回測結果，方便對比。

升級規則：

• 只有藍圖擴展支援目前安裝狀態下的版本升級判斷。
• 如果目前已是最新版本，會提示無需升級。
• 如果該藍圖擴展存在正在執行的掛載，程式會拒絕升級，需要先停止掛載。
• 如果存在未執行的掛載，升級確認彈窗會提示數量；確認升級後，程式會同步這些掛載裡的藍圖版本快照。
• 升級會保留本機藍圖 ID，並清理同一市場擴展的舊版本檔案。

升級完成後，不要直接恢復實盤執行。建議先回測新版本，再模擬執行，確認行為符合預期。

卸載會刪除本機對應的市場藍圖檔案，並從目前使用者擴展關係中移除。

卸載步驟：

1. 在 我的擴展 或詳情頁找到目標擴展。
2. 點擊 卸載。
3. 閱讀確認彈窗。
4. 確認後等待卸載完成。

卸載規則：

• 如果擴展存在正在執行的掛載，程式會拒絕卸載，需要先停止掛載。
• 如果擴展存在未執行的掛載，確認卸載後會一併清理這些掛載。
• 卸載完成後，藍圖工作區會重新整理，擴展不再作為本機已安裝擴展展示。

如果只是暫時不想讓策略交易，優先停止掛載或關閉自動交易；只有確認不再使用時再卸載。

已安裝擴展可以在詳情頁點擊 評分。

評分規則：

• 需要選擇 1 到 5 星。
• 需要填寫評論內容。
• 提交成功後，評論區會重新整理。
• 如果評論接口有短暫延遲，程式會先把本次評論臨時顯示在本機列表中，後續重新整理時再以服務端資料為準。

評論區可能顯示普通使用者、作者和管理員回覆。作者或管理員身份只代表評論來源，不代表策略收益保證。

先檢查網路和登入狀態，然後點擊 我的擴展 旁邊的重新整理按鈕或重新進入 擴展 頁面。如果市場接口暫時不可用，列表可能為空。

清空關鍵字，把分類和市場類型切回 全部。搜尋只會在目前市場列表內匹配名稱、作者、簡介、分類、下載方式和市場類型等欄位。

這通常表示目前電腦還沒有本機安裝檔案。點擊 下載並安裝，安裝完成後才會變成 已安裝。

可能原因包括下載地址不可用、網路異常、提取碼錯誤、帳號沒有下載權限、擴展包格式異常或藍圖編譯校驗失敗。可以先重新整理市場並重試；提取碼擴展需要確認提取碼正確。

先切換到 藍圖 頁面並重新整理資源管理。如果仍然看不到，回到 擴展 頁面重新整理。安裝狀態以本機市場藍圖檔案為準，本機檔案被刪除或目錄不可寫都會影響顯示。

可能是遠端預覽藍圖取得失敗、藍圖編譯失敗、回測視窗未準備好，或目前行情資料不可用。可以進入詳情頁重新點擊 回測預覽，或安裝後在藍圖頁面手動回測。

如果沒有 可升級 標記，說明目前版本已經是最新版本，或版本號無法可靠比較。如果有正在執行的掛載，需要先停止掛載再升級。

如果該擴展有正在執行的掛載，程式會阻止卸載。先到交易或資源管理中停止對應掛載，再回到擴展市場卸載。

確認目前帳號有評分權限，並檢查網路狀態。評分必須選擇星級且填寫評論內容。

第一次使用擴展市場，建議按這個順序操作：

1. 在 擴展市場 搜尋或篩選目標擴展。
2. 開啟詳情，閱讀說明、更改日誌、評論和回測資訊。
3. 對藍圖擴展先執行 回測預覽。
4. 安裝擴展。
5. 到 藍圖 頁面重新回測，並檢查參數和風控。
6. 在模擬交易模式掛載執行。
7. 觀察日誌、訂單、風控攔截和帳戶變化。
8. 通過多組驗證後，再考慮小資金實盤。
9. 升級前先停止執行掛載，升級後重新回測。
10. 不再使用時先停止掛載，再卸載擴展。