開源Mac 優先・跨平台Shioaji Pro
AI Agent × Shioaji，開創你的交易 Pro 世代
它幫你研究、幫你回測、幫你做出想要的畫面，還會從你每天的操作學會你的習慣。每一筆下單都需要你的核可。
首屏是 App 實際畫面（模擬環境，帳號與金額已遮蔽）；Agent 對話與均線為示意。
AI Agent 用的是你自己在 App 設定裡登入的 AI 服務，用量算在你的方案。
App 在你的電腦記錄最近的操作：看了哪些商品、開關哪些面板、套用哪個版面、下了什麼單。紀錄只存在本機，不會上傳。
開啟「工作流程觀察」後，常駐的 Agent 每天看一次這些紀錄。同樣的步驟重複出現兩三次以上，就存成技能並通知你，例如「早盤例行檢查」；下次輸入「/早盤例行檢查」，它就照做一遍。你自己改過的技能，它不會覆寫。
這個任務只有分析權限，不會下單。開啟前會先跳出核可卡，寫清楚排程、環境，以及每次執行會用到你的 AI 額度。
不用等券商改版，也不用自己一個一個拖。跟 Agent 說你要怎麼看盤，它用 App 的工具套版面、加面板、把面板鎖在某一檔；要的指標沒有內建，它用 JavaScript 寫成自訂指標，掛到你指定的 K 線圖上，之後也能幫你調參數或拿掉。
需要券商沒有的表，例如持股的除息日和殖利率，它可以開瀏覽器查、寫程式整理成檔案或網頁。要做成 App 裡的面板，可以修改公開的介面程式碼，上傳到 shioaji server 當成自己的 App。
貼一篇文章或講一個交易想法，Agent 把它寫成策略，用歷史 K 線回測，再用參數最佳化找最好的參數。它會把樣本內和樣本外的成績分開報告，告訴你這組參數是不是只對過去有效。回測依你的設定計入手續費、交易稅和滑價，訊號收盤成立、次根開盤成交，策略讀到未來資料會被擋下來。
研究和回測只模擬成交，不會送出委託。
「策略回測」面板可以直接寫策略（內建雙均線範例）、選商品與期間、執行回測，結果有權益曲線、報酬、回撤、勝率、獲利因子；展開「最佳化研究」設定參數範圍和樣本內外期間。可以單商品或多商品執行。
你先定好目標比例，例如股票 60%、債券 ETF 30%、現金 10%。Agent 讀你的持倉和帳戶餘額，算出現在偏離多少，列出要買賣哪幾檔、各多少、預估成本。也可以建立排程任務定時檢查，例如每天開盤後看一次，偏離超過 5% 才通知你。
比例和規則都由你決定，Agent 不推薦標的。要調整時，它一筆一筆送出下單提案，每一筆下單都需要你的核可；正式環境改用獨立的核可視窗。
建立一個排程任務，寫好要它做什麼：每天 08:30 整理持股與自選的夜盤、美股、重大公告和今天要注意的價位；收盤後整理今天的成交、損益來源，和你的計畫差在哪。做完它會通知你，結論留在「紀錄」頁。
任務可以每天定時、每 N 分鐘、到價觸發，或在委託／成交時觸發，每個任務有自己的交易權限和執行時間上限。
任務綁定模擬或正式環境，只在相符的環境執行；模擬的任務不會跑到正式帳戶。每次執行都會用到你的 AI 額度，畫面上會寫清楚。
你負責判斷，它負責把事情做完。每一筆下單都需要你的核可。
就算不用 Agent，Shioaji Pro 也是一個完整的台股看盤下單 App：現股、零股、觸價與停損停利、條件單、在 K 線上掛單，自選、持倉、委託放在旁邊。
閃電下單的價格梯標出目前成交價，開「跟隨」會自動置中。點左邊掛買單、點右邊掛賣單，委託標在那一格，點標記就刪單；成交後那一格顯示實心的成交數量，上方顯示持倉和損益。剛開啟時是鎖住的，要先按「啟用閃電下單」。
價格梯最外側多了「觸買」「觸賣」兩欄，點哪一格就在那個價位掛觸價單；梯子上會標出你的觸價單，點一下刪除、拖到別的價位就改價。打開「自動停損停利」，設好停損、停利各幾檔，也可以加移動停損，之後每一筆閃電進場成交，就依實際成交價自動掛上保護。
新的「條件單管理」面板把觸價單、二擇一、括號單和時間條件放在一起，看得到現價離條件還差多少，可以修改、暫停或取消；已穿價、結果不明這類需要你決定的事會置頂提醒。條件成立時由 App 照你的設定送出，協助你交易；按「建立」就是核可這一筆，每一筆下單都需要你的核可。
下單面板的「單位」切到盤中零股，數量從「張」變成「股」；零股只能限價 ROD，市價、IOC、FOK 會停用。閃電下單也能切零股，五檔與成交改看零股行情。每檔股票會記住你上次選哪一種。
按工具列的「點價買」或「點價賣」，再點圖上的價位，就照設定的數量掛一張限價單，點完自動回到看盤模式。委託畫成一條線，整股委託拖到新價位放開就是改價。停損、停利也掛在圖上，由 App 盯價、觸價時送單，所以 App 要開著。
自選清單有迷你走勢，成交時那一列會閃一下；持倉損益跟著行情更新。截圖或直播前，到「設定 › 音效與隱私」打開「帳號遮蔽」和「金額遮蔽」，帳號只留末兩碼，數量、損益、權益都會遮起來。遮蔽只影響畫面，不影響下單和查詢。
K 線圖上方的報價列改得更精簡，把空間留給圖。指數與個股／期貨可以分別設定要顯示哪些欄位、排什麼順序：成交量、量比、高低、開盤、漲跌停、日內區間軌、產業標籤；指數還能加上漲跌家數與成交金額。
依各產業鏈、題材成分股每分鐘的成交與漲跌，即時估算資金流向。不用一檔一檔翻，就知道今天資金在追哪裡、從哪裡撤出，再對照自己的持股和公司基本面。
每個產業鏈或題材是一條通道：往右是流入、往左是流出，長度是淨流入，粗細是成交值，光點流得越密代表資金越集中。每分鐘依最新成交重新排名，點一下就展開上、中、下游和帶頭的個股。
先分產業、再分個股的兩層熱力圖。面積可選貢獻、市值或成交值，預設是對指數的貢獻：格子越大，對大盤的影響越大；紅漲綠跌，深淺代表幅度。行情更新時格子平滑移動，不會整片跳動。
把持有的現股依族群、產業鏈或題材分組，直接對上資金流向。泡泡圖把每個族群畫成一個大圓，位置是近 10 分鐘淨流入占成交值的比例和今日漲跌，持股依市值放在裡面；通道圖每個族群一條，粗細是你的持股權重，長度是族群的淨流入。
選一檔股票，就看到產業分類、市值、本益比、月營收、毛利率，以及業務介紹、營收組成和所屬題材；它在產業鏈的上游、中游還是下游，點一下就看同一段的其他公司。
以下都是 App 的實際畫面（模擬環境；含帳務的畫面已開啟帳號與金額遮蔽）。每一種都是一個面板，可以多開、拖拉、彈出成獨立視窗，排好存成自己的版面。
從「新增面板」搜尋要的面板加進來，拖曳、調整大小；排好後在「版面庫」存成自己的版面，下次一鍵套用。App 也內建十多組版面，例如標準看盤、當沖交易、閃電矩陣、雙圖對照；v0.1.53 再加六組：期貨當沖、期現對照、零股存股、條件單監控、選擇權組合、盤勢總覽。v0.1.56 再加五組研究版面：族群資金、產業掃描、持股健檢、族群輪動、個股研究。多螢幕的話，把面板彈出成獨立視窗；彈出的閃電下單視窗也能直接點價、平倉、刪單，確認也在同一個視窗完成。
從永豐金證券網站申請，到在 Shioaji Pro 正式下單，一共 13 步，第一步先說明為什麼用 API Key。每一步都標出要點哪裡、勾什麼、填什麼；可以暫停，也可以點上一步、下一步。網站畫面是依官方文件重建的示意，資料都是假的；App 畫面是實際截圖。
Agent 只能在你開放的權限內動作，而且每一筆下單都需要你的核可。
API Key 是給程式用的鑰匙，和你的登入帳號密碼分開。權限可以分開開，也能綁定 IP、設到期時間；App 和 AI Agent 都只能在這組 API Key 的權限內動作，加上每一筆下單都需要你的核可，兩層控制。
待確認：官方文件沒寫 API Key 能否暫停；目前寫法是到 API 管理頁刪除後另建一組。
需要永豐金證券帳戶，交割帳戶是永豐銀行；要交易期貨、選擇權，另外開期貨帳戶。已經有帳戶就直接下一步。
登入永豐金證券網站，點右上角的個人選單，在「個人服務」底下找到「API管理」。
頁面上方有三點提醒：最多 30 組、不要給別人、建議綁定 IP。按「新增 API Key」開始建立。
為落實安全防護機制，將以本人手機或 Email 信箱進行身份驗證。
選「手機」或「Email 信箱」收驗證碼，填入後按「確認驗證」。驗證碼有時間限制。
名稱自己認得就好，例如「ShioajiPro」。到期後要重新申請，可以設長一點。
待確認：到期時間可選的最長範圍，官方文件沒寫。
行情／資料看報價、五檔、K 線、排行。Agent 能讀行情；不勾，App 和 Agent 都看不到行情。
帳務查持倉、委託、餘額與損益。Agent 能讀你的帳務；不勾，它就查不到持倉和餘額。
交易下單、改單、刪單，模擬測試也需要。不勾，App 和 Agent 都無法下單；勾了，Agent 下單仍需要你的核可。
正式環境用真實資金下單才需要。不勾，這組 API Key 只能在模擬環境用。
App 和 AI Agent 都用這組 API Key，勾哪些權限，就是 Agent 能動的上限：只想讓它看盤研究，只勾「行情／資料」；要它幫你看帳務再勾「帳務」；要下單才勾「交易」；要用真實資金再勾「正式環境」。就算勾了交易，Agent 的每一筆下單都需要你的核可。
待確認：各權限涵蓋的 API 範圍以官方文件為準；官方只寫「行情／資料、帳務、交易、正式環境」四項的名稱與用途。
勾要讓這組 API Key 使用的帳戶（證券、期權）。官方建議選「限制 IP」並填入你的固定 IP；最後按「確定」。
請確保已將此保存完成，您將不會再次得到此 Secret Key。
Secret Key 只會出現這一次，關掉就看不到了。按「複製」存到密碼管理器或安全的地方，不要傳給任何人。存好再按「確定」。
到「個人服務 › 簽署中心」，在「證券類」找到「API 證券下單簽署」完成簽署；交易期貨、選擇權的話，到「期貨類」分頁另外簽。一定要先簽署，再做下一步的模擬測試。
待確認：期貨類分頁裡的項目名稱，官方文件只附了截圖。
第一次開啟 App 會看到設定畫面：貼上 API Key、Secret Key，環境選「模擬環境」，按「啟動並開始使用」。也可以用「選擇 .env 檔案」匯入。金鑰只存在你的電腦。
在 Shioaji Pro 的模擬環境，用下單面板下一筆限價單；證券、期貨要分開測。模擬環境裡還沒完成簽署與測試的帳戶也能下單，就是為了讓你完成這一步。約 5 分鐘後，簽署中心的「python 測試與否」會變成「已測試」。
待確認：審核時間官網寫約 5 分鐘，Shioaji skill 寫約 1 分鐘。
憑證已下載，請至下載檔案查看。
確定
回 API 管理頁按「下載憑證」，得到 Sinopac.pfx。在 App 右上角「伺服器」開「伺服器設定」：下次啟動環境選「正式環境」，選擇 Sinopac.pfx、填憑證密碼，按「儲存並重啟」。API Key 要有「正式環境」權限，簽署和測試都通過，就能正式下單。
待確認：憑證密碼在哪裡設定，官方文件沒寫清楚；App 的提示是「下載時設定」。
步驟依 Shioaji 官方文件：API Key 與 簽署與測試 整理（2026-10-09）。網站可能改版，以永豐金證券網站實際畫面為準。
想知道怎麼用 Shioaji 接即時行情、送單、查帳務、處理斷線重連？這個 repo 就是透過 Shioaji server 的 HTTP API 與 SSE 寫成的完整介面，下表是可以直接參考的地方。AI Agent 和回測引擎在桌面版的私有模組，不在這個 repo。
| 想學 | 看這裡 | 用到的 API |
|---|---|---|
| 即時報價與五檔 | src/lib/stream.ts | 一條 SSE /api/v1/stream/data，斷線後自動重新訂閱 |
| 下單、改價、刪單 | src/lib/shioaji.ts | /api/v1/order/place_order、update_price、cancel_order |
| K 線與歷史資料 | src/lib/shioaji.ts | /api/v1/data/kbars、/api/v1/data/ticks |
| 持倉與帳務 | src/lib/shioaji.ts | /api/v1/portfolio/* |
| 停損停利（客戶端觸價） | src/lib/trigger-engine.ts | 行情觸發後送 place_order |
| 自訂指標的沙箱 | src/lib/custom-worker.ts | Web Worker 執行使用者的 JavaScript，ta.* 在 src/lib/ta.ts |
讓你用的 AI 寫程式工具知道怎麼寫 Shioaji 程式，包括登入、下單、訂閱行情、查帳務。
claude plugin marketplace add Sinotrade/Shioaji claude plugin install shioaji
codex plugin marketplace add Sinotrade/Shioaji codex plugin add shioaji@sinotrade
讓 agent 透過 App 的工具看行情、調整版面、寫指標和策略、跑回測與最佳化。交易一樣照 App 的權限設定：逐筆確認時，每一筆下單都需要你的核可。
放在 repo 的 plugins/shioaji-pro，可以裝進常用的 AI 寫程式工具。
為 Mac 打造的跨平台看盤下單 App：Apple Silicon、Intel 都有，也支援 Windows、Linux。程式碼在 GitHub 公開，安裝檔由 GitHub Actions 建置，啟動時自動檢查更新。
舊版本和更新紀錄在 GitHub Releases。
需要永豐金證券帳戶，登入用的是你在永豐金證券網站申請的 API Key。要交易期貨、選擇權，另外需要期貨帳戶。
模擬環境的委託不會送到交易所，不會動到真的錢，第一次開啟預設就是模擬。正式環境要匯入憑證，委託會動用真實資金。
API Key、Secret Key 和憑證密碼存在你電腦的 App 資料夾，不會上傳。操作紀錄也只存在本機。
不會。交易權限預設要逐筆核可，每一筆下單都需要你的核可；也可以設成只能分析、完全不下單。另外有單筆數量、金額等風控上限，Agent 也要遵守。
台股上市、上櫃的現股與盤中零股，以及期貨、選擇權。這頁以股票為主介紹。
啟動畫面會直接說明原因，例如登入失敗、憑證無法使用、連線逾時或連接埠被占用，並附上記錄檔位置和「打開記錄資料夾」按鈕。照提示處理後重試即可；需要回報問題時，附上記錄檔能更快找到原因。
可以。Shioaji Pro 是為 Mac 打造的跨平台 App，Windows 10／11 和 Linux 也有安裝檔，功能相同。
