開發過程中,一直在想交易邏輯幾乎是固定的,為何要用Skill,而這串討論,就是在確認開發AP是否適合
跟著 Claude 把美股當沖 skill 改成台股版・第 14 篇
延伸開發 AP 2:和 Claude 一起規劃網頁版 AP,先做出 UI demo
上一篇的結論是:這套工具盤中每一步都是固定規則,做成 AP 比較適合。這一篇把它落實成規劃:要有哪些頁面、架構怎麼選、三道關在網頁上怎麼保留、port 和金鑰怎麼處理。動手寫程式之前,先請 Claude 做出一份可以點的 UI demo,看著畫面討論,再開始做第一個階段。
1. 需求:我想要的 AP
我先把想要的功能直接告訴 Claude:
先幫我規劃 AP 的功能,我希望有盤前選股結果、盤中即時監控狀態訊息、回測頁面,有參數可以調整、還有設定 API 的頁面,還有 port 可以自行調整,整個 AP 用網頁形式呈現,規劃之後,還要給我 UI 設計 demo。
Claude 先讀了我另一個專案「網格自動交易系統」的網頁介面怎麼寫,再把需求整理成一張「要做/不做」的表。「不做」那一欄和「要做」一樣重要:
| 要做 | 不做 |
|---|---|
| 盤前選股結果(自動排程+手動執行) | 沒有你點擊確認就送單 |
| 盤中即時監控(觀察清單、觸發、持倉、事件紀錄) | 盤中改交易規則 |
| 回測頁(參數可調、結果與資金曲線) | 先賣後買、融資融券 |
| API 設定頁(FinMind、永豐) | 把金鑰寫進任何檔案 |
| 交易規則、系統設定(port 可自行調整) | 對外網路開放 |
| 下單確認(三道關照舊) | AI 盤中判斷買賣 |
小辭典
- 網頁版 AP
- 程式在你自己的電腦上執行,用瀏覽器打開來操作,畫面就像一個網站,但只有你的電腦連得到。
- Port
- 同一台電腦上可以同時開很多個網頁程式,用不同的號碼區分,例如
http://127.0.0.1:8780的 8780。 - 127.0.0.1
- 代表「這台電腦自己」。只綁在這個位址,別台電腦就連不進來。
- UI demo
- 畫面設計的示範品:可以點、可以切換,但資料是假的,也不會真的連線或下單。
2. 架構:照網格交易系統的做法
網格交易系統已經用同樣的技術在真實帳戶上跑了一段時間,台股 AP 直接沿用:
| 項目 | 做法 | 為什麼 |
|---|---|---|
| 伺服器 | Python(FastAPI+uvicorn) | 和台股版的程式同一種語言,可以直接呼叫 |
| 畫面 | 單一網頁,用瀏覽器打開 | 不用安裝其他軟體 |
| 即時更新 | 伺服器主動推送狀態(SSE) | 畫面不用一直重新整理 |
| 交易規則 | 直接用台股版 skill 的同一套程式 | 規則只有一份;回測測的就是 AP 實際跑的 |
| 資料 | 和 skill 共用 trader/ 資料夾 | 盤前盤後還是可以在 Claude 對話裡問 |
| 連線範圍 | 只綁 127.0.0.1 | 可以下單的介面不對外開放 |
上一篇提到「把 Claude 換成排程器,中間那層固定規則不用改」,這裡就是實際的做法:AP 取代的是「誰來決定什麼時候跑哪支程式」,交易規則本身一行都不用重寫。
3. UI demo:點分頁看每個畫面
規劃寫完,Claude 做了一份可以點的 UI demo。下面是用網頁程式碼「畫」出來的簡化版,點分頁就能切換畫面;在盤中監控按「確認下單」,也會跳到送出確認(資料都是示意,不是真實行情,按鈕也不會連線或下單):
漲跌顏色用台股習慣:紅漲綠跌。用手機看,或把視窗縮小,畫面會改成手機排版。
| 股票 | 現價 | 漲跌 | 區間高/低 | 狀態 |
|---|---|---|---|---|
| 2409友達 | 29.15 | +0.69% | 28.95 / 27.95 | 持倉 |
| 1802台玻 | 31.40 | +0.96% | 31.35 / 30.95 | 觸發 |
| 2330台積電 | 2,350 | +0.43% | 2,355 / 2,330 | 等待 差 1 檔 |
| 3017奇鋐 | 1,180 | +1.29% | 1,185 / 1,160 | 等待 差 1 檔 |
| 2382廣達 | 302.5 | −0.33% | 305.0 / 301.0 | 等待 差 5 檔 |
| 3374精材 | 268.0 | +9.84% | 268.0 / 255.0 | 鎖漲停 |
盤中監控:上方是交易階段、模擬環境標示與分 K 延遲;觀察清單即時顯示每檔狀態;觸發後自動準備好待確認委託(10 分鐘倒數)。
買進 1802 台玻 4 張,限價 31.40,現股當沖。停損 31.15 出場最多虧 1,399 元(含成本)。送到:永豐模擬環境。
送出後同一筆不會再送;結果不明時會先查詢,不會重送。
送出確認:按「確認下單」後還有一個確認框,寫清楚內容和送到哪個環境,再按一次「送出」才會送(這裡是示意,按了只會回到盤中監控)。
| 股票 | 型態 | 收盤 | 漲跌 | 新聞 | 營收年增 | 法人 |
|---|---|---|---|---|---|---|
| 3017奇鋐 | 突破 20 日高 | 1,165 | +3.1% | 訂單法人 | +38.2% | 外資連買 4 天 |
| 3443創意 | 多頭旗形 | 1,610 | +1.9% | 營收 | +52.6% | 投信連買 3 天 |
| 2330台積電 | 站回 20 日均線 | 2,340 | +1.2% | 法說 | +41.0% | 外資連買 2 天 |
| 1802台玻 | 突破 20 日高 | 31.1 | +6.9% | 法人 | +12.1% | 投信連買 5 天 |
| 1303南亞 | 超賣反彈 | 46.0 | +2.2% | 法人 | −3.4% | 外資連買 2 天 |
| 3374精材 | 量增 2 倍 | 244 | +9.9% | 漲停 | +61.3% | 投信連買 2 天 |
盤前選股:08:30 自動掃描,可以依型態篩選;新聞標籤、營收年增、法人放在同一張表,勾選後加入觀察清單。
| # | 參數 | 樣本內 | 平均 R | 樣本外 R |
|---|---|---|---|---|
| 1 | 30 分・區間低點・1.5R | 276 筆 | −0.123 | −0.075 |
| 2 | 30 分・區間低點・2R | 276 筆 | −0.124 | −0.068 |
| 3 | 30 分・區間低點・2R・量 1.5× | 98 筆 | −0.126 | +0.040 |
回測:上面調參數,下面是樣本內/樣本外、帳戶模擬、資金曲線與排名;警語一定原文顯示(數字是第 11 篇的真實回測結果)。
[OK] 證券帳號 API 簽署:已簽署
[OK] 讀取合約:2330 台積電(參考價 2340.0)
API 設定:金鑰欄位只顯示「已設定」與末四碼;「檢查連線」的結果和第 12 篇的 check 一樣。
系統:port 可以自己改,畫面會提示重新啟動後的新網址;連線範圍固定只限本機。
每個頁面的內容:
| 頁面 | 內容 |
|---|---|
| 盤中監控 | 今日損益、已用風險、筆數、現金;觀察清單即時狀態;觸發後自動準備好的待確認委託;持倉;事件紀錄 |
| 盤前選股 | 自動掃描結果、型態篩選、新聞/營收/籌碼補充欄位、加入觀察清單 |
| 回測 | 參數表單、進度條、結果與資金曲線;「套用」只填進草稿,盤後才能儲存 |
| 紀錄 | 今天每一筆的確認、送出、成交;月統計 |
| 設定 | 交易規則(盤中鎖定)、API 連線、系統(port、排程時間)、通知(第二期) |
4. 三道關在網頁上怎麼保留
AP 會在觸發後自動跑完停損停利、張數和風控,但只是「準備好一張單」,不會自己送出:
- 觸發收盤站上
- 停損停利自動
- 張數自動
- 風控自動
- 你確認按兩次
- 送出10 分鐘內
| 關卡 | Claude 對話(第 12 篇) | 網頁 AP |
|---|---|---|
| 1. 風控 | tw-risk PASS,指紋相符 | 完全一樣 |
| 2. 你同意 | 在對話中明確說「確認下單第 1 筆」 | 按「確認下單」,再在確認框按「送出」 |
| 3. 送出 | 同意後 10 分鐘內、盤中、只送一次 | 完全一樣 |
其他沿用的規則:送單結果不明時不重送;交易規則盤中鎖定;切換到實盤要輸入「我了解這是真實帳戶」,而且盤中不能切。到價的停損停利也一樣,AP 只會準備平倉單,等你確認。
5. Port、金鑰與排程
Port
- 優先順序:啟動時指定的 port > 設定頁儲存的 port > 預設 8780(避開網格系統用的 8765)。
- 被占用時:顯示錯誤,並建議下一個可用的 port,但不會自己換,避免你的書籤失效。
- 改了之後:重新啟動 AP 才生效,畫面會直接告訴你新網址。
金鑰
API 設定頁可以輸入金鑰,但 AP 會把它寫進 Windows 的「使用者環境變數」,和第 12 篇用 setx 設定是同一個地方,不寫進任何檔案。畫面之後只顯示「已設定」和末四碼。另一個選項是 Windows 的認證管理員,比較安全,但和 FinMind token 的做法不一致,這一點還在決定。
排程
| 時間 | 工作 |
|---|---|
| 08:30 | 盤前掃描 → 新聞、基本面、籌碼 |
| 08:45 | 檢查連線、交易日、處置股 |
| 09:00–13:30 | 每 30 秒檢查觀察清單與持倉;觸發就準備單據 |
| 13:20 | 平倉時間:還有持倉就準備平倉單 |
| 13:35 | 收盤摘要:損益、筆數、未成交委託 |
每 30 秒、10 檔股票,一小時大約 1,200 次 FinMind 請求,在 Sponsor 方案每小時 6,000 次的額度內。
6. 做 demo 時抓到的錯
就算是示意資料,也要符合自己的規則。看 demo 時抓到幾個錯:
| 錯在哪 | 為什麼不對 | 改成 |
|---|---|---|
| 待確認委託用台積電 | 1 張要兩百多萬,停損一次虧好幾萬;30 萬資金、每筆最多虧 1,500 元的規則,根本不可能產生這張單 | 換成股價三十幾元的股票、4 張,用工具實際算出最多虧 1,399 元、扣成本報酬風險比 1.14 |
| 漲 6.9% 標成漲停 | 台股漲停是 10% | 改成法人標籤 |
| 時間顯示「下午 01:20」 | 交易時間習慣用 24 小時制 | 改成 13:20 |
| 手機上委託排在最下面 | 最重要、有倒數的東西被擠到最後 | 手機寬度時,待確認委託排到最上面 |
示意資料也要過自己的規則
第一個錯最值得注意:畫面上出現一張「你的規則不可能產生」的單,讀者會誤以為工具允許這種事。用真正的計算工具算一次示意數字,比憑感覺填可靠得多。
7. 開發階段與 AP-1
| 階段 | 內容 |
|---|---|
| AP-1 | 骨架:網頁伺服器、port 設定、首頁框架、即時狀態推送、交易規則與系統設定 |
| AP-2 | API 設定頁:金鑰寫入環境變數、檢查連線 |
| AP-3 | 盤前選股頁+排程 |
| AP-4 | 盤中監控:觀察清單即時狀態、事件紀錄、持倉 |
| AP-5 | 網頁確認與送單 |
| AP-6 | 回測頁:參數調整與執行 |
| AP-7 | 第二期:LINE 通知與確認 |
規劃和 demo 都確認後,我對 Claude 說「可以開始製作 AP-1」。AP-1 完成後的樣子(照實際畫面畫成簡化版,資料是真的;週六所以顯示休市):
| 股票 | 型態 | 前一日收盤 | 漲跌 | 盤中狀態 |
|---|---|---|---|---|
| 2330台積電 | 站回 20 日均線 | 2,350 | +0.43% | AP-4 |
| 2454聯發科 | 站回 20 日均線 | 4,120 | +7.01% | AP-4 |
| 1303南亞 | 站回 20 日均線 | 304 | +3.75% | AP-4 |
| 3443創意 | 突破 20 日高 | 8,610 | +9.54% | AP-4 |
| 1802台玻 | 突破 20 日高、量增 2 倍 | 85.1 | +4.16% | AP-4 |
AP-1 實際畫面的簡化版:交易階段、模擬帳戶標示、今日數字都是即時讀取;觀察清單是第 6 篇掃描出來的真實結果(第 3 節 UI demo 的股價是示意,和這裡的真實價格不同),盤中即時狀態要到 AP-4 才加入。
- 交易規則頁:只能改白名單裡的欄位,券商模式、模擬/實盤、金鑰都不能從這裡改;盤中鎖定;每次修改都留紀錄。
- 系統頁:改 port 會提示新網址;port 被占用時,啟動會告訴你可以改用哪一個。
- 啟動:雙擊「啟動AP.bat」,瀏覽器會自動打開。
- 測試:10 個自動測試,包含盤中改規則會被擋、不能從網頁把模擬改成實盤。
8. 學到的事、照著說的話
01
先看畫面再寫程式
可以點的 demo,比文字規劃更容易發現缺什麼、哪裡怪。
02
「不做」要寫下來
不自動送單、不對外開放、不把金鑰寫進檔案,比功能清單更重要。
03
示意資料也要算過
畫面上的範例數字,要能被自己的規則產生出來。
04
沿用跑過真錢的做法
網格系統驗證過的架構,讓台股 AP 少踩很多坑。
你可以照著說的話
先幫我規劃 AP 的功能:盤前選股結果、盤中即時監控狀態訊息、回測頁面(參數可以調整)、設定 API 的頁面、port 可以自行調整,整個 AP 用網頁形式呈現。規劃之後給我 UI 設計 demo。
請把規劃整理成「要做/不做」兩欄,並列出開發階段與每個階段的完成條件。
檢查 demo 上的示意數字:用我的資金規則實際算一次,畫面上的委託是不是真的會被產生?
沒有台股版程式的話:我想把一個每天要重複操作的工作做成網頁工具(請換成你自己的工作)。先幫我列出需要的頁面、哪些操作一定要我按確認,再做一份可以點的 UI demo,資料用假的就好。
常見問題
網頁版 AP 別人連得到嗎?
連不到。AP 只綁在 127.0.0.1,也就是只有你自己的電腦能打開。可以下單的介面,刻意不提供對外連線。
有了 AP,還需要 Claude 嗎?
需要。盤中的固定工作交給 AP;盤前研究、盤後檢討、回測結果的討論、調整規則,還是在 Claude 對話裡做最方便。兩邊共用同一個資料夾。
AP 會自己下單嗎?
不會。觸發後 AP 只會準備好一張單據,一定要你在網頁上按確認、再按送出;同意後 10 分鐘內有效,同一筆只送一次。
AP 可以下載嗎?
可以。整個系列已經完成,程式放在 GitHub:github.com/charlie711207/day-trader-skill(fork 自原作,台股版在 taiwan 資料夾)。這是開發過程分享,程式碼尚未經過完整測試,請先用模擬帳戶;遇到問題可以把錯誤訊息告訴 Claude,請它找出原因並修正。
下一篇預告
AP-1 的骨架做好了。接下來會依序做 API 設定、盤前選股、盤中監控與網頁確認送單,並在交易日實際跑一次,看即時狀態訊息在盤中長什麼樣子。
本文僅為軟體工具教學與開發經驗分享,不構成任何投資建議。文中畫面為示意資料,個股僅為示範。程式交易與當沖風險極高,請自行評估並為自己的交易決策負責。









