連結長橋證券帳戶並同步資產

ONEW 支援透過長橋證券授權讀取帳戶資產，並把長橋帳戶關聯到一個 ONEW 帳戶中。完成綁定後，你可以先查看同步預覽，再決定是否把長橋傳回的現金、股票、基金等資產寫入 ONEW。

開始之前

請先確認：

• 已安裝支援長橋資產同步的 ONEW 版本（需 1.7.0 或以上）。
• 已擁有可登入的長橋證券帳戶。
• ONEW 中已經建立好用於承接長橋資產的帳戶，例如「長橋證券」。
• 網路可以存取長橋開放平台授權頁。

1. 開啟長橋證券連接入口

進入 ONEW 後，切換到底部「設定」標籤頁。在「進階設定」中點擊「長橋證券」。

2. 發起長橋帳戶連接

在「長橋證券」頁面點擊「連接長橋帳戶」。這裡顯示的是 ONEW 已儲存的長橋連線列表；首次使用時，列表會顯示「暫無已連接的長橋帳戶」。

ONEW 會呼叫系統登入授權能力。系統彈窗出現後，點擊「繼續」進入長橋授權頁面。

3. 在長橋頁面完成授權

長橋授權頁會顯示 ONEW 請求存取你的長橋帳戶。確認目前長橋帳戶無誤後，勾選同意條款並繼續授權。

授權完成後，頁面會回到 ONEW。此時「長橋證券」頁面的「已連接帳戶」列表中會出現剛剛授權的真實長橋帳戶。

注意：授權代表允許 ONEW 使用長橋開放平台讀取帳戶與持倉等資訊，用於資產同步。請只在確認帳戶正確時繼續。ONEW 僅需要「Account & Positions」授權即可，其他權限可以不用勾選。

4. 進入 ONEW 帳戶的資產同步設定

回到「帳戶」標籤頁，開啟你準備用來承接長橋資產的 ONEW 帳戶詳情頁。點擊「資產同步」這一行。

如果還沒有完成長橋授權，資產同步頁中的「長橋帳戶」會顯示「無連線」，無法載入真實同步預覽。

如果目前 ONEW 帳號沒有 Plus 權限，可以先在「設定」中進入示範模式，再新建一個用於承接同步結果的 Longbridge 示範帳戶。下面的同步截圖使用示範模式裡的 ONEW 帳戶承接資料，但長橋連線和同步預覽來自真實長橋授權傳回。

5. 綁定長橋帳戶並載入同步預覽

完成真實長橋授權後，在「資產同步」頁面按下面順序操作：

1. 開啟「長橋帳戶」，選擇剛剛授權的長橋帳戶。
2. 「同步指令碼」保持為 longbridge_sync.js。
3. 按需保留「自動合併同代碼資產」。開啟後，ONEW 會嘗試把長橋傳回的同代碼資產和本地已有資產合併。
4. 點擊「載入首次同步預覽」。

同步預覽會把長橋傳回的資料分為現金、證券、基金等分組，並標出每個項目將被建立、合併或更新。請逐項檢查預覽結果，確認無誤後再繼續。

6. 應用同步預覽

確認同步預覽無誤後，點擊「應用同步預覽」。ONEW 會把預覽中的變更寫入目前 ONEW 帳戶。首次同步預覽應用完成後，預覽列表會收合，「應用同步預覽」按鈕會變為不可點擊狀態。

重要：不要在應用首次同步預覽前直接儲存「啟用資產同步」。如果提前儲存，ONEW 會提示「啟用資產同步前，請先應用首次同步預覽。」

應用預覽後，再開啟「啟用資產同步」，點擊「儲存綁定」。儲存後，這個 ONEW 帳戶會保留長橋連線、同步指令碼和自動合併設定，後續重新整理時會繼續使用長橋唯讀資料更新資產。

應用成功後：

• 目前 ONEW 帳戶會出現從長橋同步來的資產。
• 「資產同步」狀態會變為已綁定或已開啟。
• 後續重新整理時，ONEW 會根據綁定關係繼續使用長橋唯讀資料更新資產。

常見問題

為什麼要先看同步預覽？

同步預覽可以讓你在寫入 ONEW 前檢查長橋傳回的資料，以及 ONEW 準備建立、合併或更新哪些資產。這樣可以避免把不符合預期的資料直接寫入帳戶。

可以把一個長橋帳戶綁定到多個 ONEW 帳戶嗎？

建議一個長橋帳戶只綁定到一個承接證券資產的 ONEW 帳戶，避免同一批資產被重複統計。

授權後 ONEW 會修改長橋帳戶嗎？

不會。長橋連線用於 ONEW 的唯讀資產同步，教學中的授權頁面也會提示 ONEW 請求存取帳戶相關資訊。