這是一個基於 Python 與 Streamlit 開發的輕量化、高容錯台股技術分析儀表板。系統將技術分析名師林家洋的核心理論（力竭原理、K線組合、趨勢位置、攻擊K線、大底破繭、多週期共振）進行深度量化，並具備航太級的多層級備援抓取機制，讓投資者能快速且穩定地掃描全市場，精準捕捉具備高安全邊際與波段爆發力的頂級起漲訊號。
| 版本號 | 發布日期 | 核心升級重點與重大突破 |
|---|---|---|
| v8.5 旗艦版 | 2026-09-17 | ☁️ 雲端境外 IP 極速熔斷防護 + 🚀 實戰雙軌進場策略指引 + 💎 籌碼動能純淨化： 1. 境外 IP 智慧熔斷 (Cloud Fast-Failover)：完美相容 Streamlit Community Cloud (AWS 境外伺服器)，以極速探針偵測證交所防火牆阻擋 (403)，秒級降級「純技術面全速模式」，徹底終結雲端掃描卡頓與休眠！ 2. 實戰雙軌進場指引 (Dual-Track Entry)：打破「死等回測錯過大飆股」的逆選擇困境。首日帶量突破＋法人助攻標的採「09:30 站穩開盤價，平盤至+1～2檔動態試單」（如陽明、強茂）；多頭吞噬轉折股則恪守 1/2 處低接防守。 3. 籌碼動能純淨化與死存量過濾：自動識別日東紡等母公司/董監固定股權（死存量），標記「長期鎖碼無動能」，消除虛假大戶安全感；中小型股隔日沖警戒動態化。 4. 券商 APP 盤後即時加減推估演算法：下午 15:30～21:00 當官方外資持股尚未發布時，自動以「昨日存量＋今日買賣超流量」即時推估最新外資持股與持股率，夜間 21:00 官方大結算產出後自動切換官方檔案。 |
| v8.4 旗艦版 | 2026-09-16 | 三大法人全自動日報串接 (TWSE T86 / TPEx) + 籌碼動能矩陣評估： 1. 實裝土洋合擊 (+20分)、投信波段鎖碼 (+15分)、外資隔日沖疑慮標籤。 2. 高法人重倉區 (持股>=20%) 雙數張操作鐵律（強茂實戰經驗）。 3. 報表全自動納入「三大法人狀態」、「外資買賣(張)」、「投信買賣(張)」。 |
| v8.3 艦隊版 | 2026-09-14 | 週K線多週期宏觀趨勢共振過濾 + 上方 250 天歷史巨量套牢反壓一票否決 + 剛性破億門檻。 |
| v8.2 旗艦版 | 2026-09-08 | 40～60 天林家洋大底破繭起漲先鋒 (120分) + 五大目標金融股專屬季線乖離燈號存股系統。 |
| v8.1 升級版 | 2026-09-02 | 實戰持股四大防線體系 (v3.1 有狀態出場紀律，尾盤 13:10 判定，禁掛盤中觸價單)。 |
- Streamlit Community Cloud 伺服器位置：該平台為免費社群託管服務，其容器伺服器 IP 位於美國（AWS US）等海外節點。
- 主管機關資安防火牆：台灣證券交易所 (TWSE) 與櫃買中心 (TPEx) 針對非台灣境內 IP 設有嚴格的地理防火牆阻擋機制（通常直接回傳 HTTP 403 Forbidden 或直接阻斷連線逾時）。
- 過去造成的痛點：若在雲端主機強行發送全市場法人查詢請求，每檔股票將耗費 4～15 秒等待連線逾時，導致全市場掃描長達 1～2 小時以上，最終引發 Streamlit Cloud 自動休眠或連線崩潰。
- 🛡️ 自動極速連線探針 (Fast-Failover Probe)：系統啟動時，
TaiwanStockDataFetcher會在 1.5 秒內向證交所發送極速連線探針。若確認當前環境為境外阻擋 IP，全自動啟動極速熔斷，後續所有個股的 TWSE/TPEx/FinMind 連線直接 0 毫秒跳過，完全避免卡頓。 - ⚙️ 側邊欄手動開關：在
app3.py側邊欄提供「🏛️ 啟用三大法人籌碼分析」勾選框，使用者亦可隨時手動取消勾選，直接進入「純技術面全速掃描模式」。 - 💡 環境建議：
- 日常雲端行動看盤 (Streamlit Cloud)：使用「純技術面極速模式」，全市場掃描僅需數分鐘即可產出型態與分數。
- 完整法人籌碼分析 (含土洋合擊、外資持股、投信鎖碼)：請在台灣本地網路環境 (Localhost 虛擬環境或台灣本地 VPS) 下運行。
本系統全面升級為多週期雙軌架構，涵蓋以下核心型態與量化評分機制：
- 核心精髓：林家洋前輩傳授——「最好的股票還是要有長期整理，然後剛剛開始突破的股票」。
-
量化條件：
-
時間維度：過去 40～60 個交易日處於打底整理狀態（箱型震盪振幅
$\le 22%$ ）。 -
均線糾結：月線 (MA20) 與季線 (MA60) 差距
$\le 4.0%$ ，均線充分纏繞走平。 -
突破確認：當日實體紅K（漲幅
$\ge 2.5%$ ），成交量放量達 5 日均量 1.8 倍以上，實體收盤價突破過去 40 日箱頂！ -
剛性防護：必須同時通過「單日成交金額
$\ge 1.0$ 億元」、「上方 250 天無歷史巨量套牢」與「週線未走空」。基期極低、上方無浮額，為勝率與期望值最高之起漲點。
-
時間維度：過去 40～60 個交易日處於打底整理狀態（箱型震盪振幅
- 核心精髓：下降慣性破壞。在下降趨勢（高點越來越低、低點越來越低）力竭後，伴隨高成交量實體突破前波反彈高點，打破空方結構之破底翻起漲點。
-
剛性防護：成交金額
$\ge 1.0$ 億元，排除連漲力竭出貨K，排除週線空方段。
-
條件：股價位於季線 (MA60) 之上，當日實體紅K漲幅
$\ge 3.0%$ ，成交量達 5 日均量 1.5 倍以上，實體突破近 20 日波段高點。 - 首日突破限制：限於「底部/橫盤 10 天以上剛發動的第一根紅K」，嚴格排除過去 5 天已連續大漲 2 天以上的力竭出貨K。
- 條件：股價位於季線 (MA60) 之上，前日為黑K，當日紅K實體完全包覆前一日黑K實體。
- 大數據實證：回測顯示回檔洗盤完畢後的轉折點，T+5 賺錢勝率高達 70.3%！買點安全，不易被隔日沖砸盤。
- 條件：季線之上出現價格範圍包覆於前日K棒內的 Harami 型態，量能萎縮。大漲後的良性洗盤，等待帶量突破母K高點再行進場。
- 全自動法人日報串接：每日自動串接台灣證交所 (TWSE T86) 與櫃買中心 (TPEx)，取得外資、投信、自營商買賣超張數。
- 🔥 土洋合擊波段強攻 (+20分)：外資與投信同步買超，波段爆發力最強。
- 💎 投信波段鎖碼 (+15分)：投信單日買超佔比高或近 60 日累計鎖碼逾千張，具季底作帳續航力。
-
⚠️ 隔日沖疑慮動態警戒：外資買超佔當日成交量$\ge 25%$ 且買超張數達標（大型股$\ge 1,200$ 張、中小型股$\ge 500$ 張且佔比$\ge 35%$ ），自動標註警戒，次日早盤嚴禁追高。 - 🔒 外資死存量過濾：外資持股比雖高但進出極小（母公司/董監固定股權如建榮日東紡），標註為「長期鎖碼無動能」，消除投資人盲目樂觀之錯覺。
- 📊 雙軌外資持股推估：盤後 15:30～21:00 自動以「昨日存量＋今日買賣超流量」無時差推估最新持股；夜間 21:00 後自動採用證交所官方最新結算檔。
- 條件：上升趨勢中，股價收盤實體跌破波段拉回低點連線（上升趨勢線），或實體跌破前波次低點（Higher Low 階梯防守點）。代表多方墊高慣性終結，果斷獲利了結！
- 條件：股價位於季線 (MA60) 之下，或處於週線空方修正段時出現的反彈或吞噬。上方均線下彎反壓沉重，多單嚴禁進場。
- 條件：長黑K實體完全包覆前日紅K實體。主力高檔出貨訊號，持股無條件停損或停利結案。
為解決「限價回測掛單容易漏接真強者、卻全數接到深度拉回弱勢股」的逆選擇問題，v8.5 正式導入實戰雙軌進場機制：
- 適用對象：大底破繭第一根紅K、首日攻擊K線且具備「🔥 土洋合擊」或「💎 投信鎖碼」強勢動能者（如陽明、強茂）。
- 進場掛單原則：
- 開盤觀察：09:00～09:30 確認開盤價穩守在昨日收盤價之上，且即時成交量持續放大、均價線斜率向上。
- 動態試單：絕不死等 1/2 深幅回測！可於「昨日收盤價至平盤上 1～2 檔（或均價線附近）」分批建立 1/2 先鋒試單。
- 防守紀律：若盤中跌破均價線則暫停加碼，收盤跌破發動K低點嚴格停損。
- 適用對象：多頭吞噬、量縮內困、或無法人追價之個股（如建榮、上詮）。
- 進場掛單原則：
- 耐心承接：嚴格等待回測發動日攻擊K線實體之 1/2 處 再以限價單承接，絕不追高。
- 防守紀律：以發動K最低點為嚴格防守底線，13:10 尾盤收破果斷停損。
所有掃描標的進入 TOP 5 候選池前，必須通過以下 6 大硬性濾網，任何一項觸犯即「一票否決」：
- 🛑 短線暴衝與力竭過濾：近 20 日累積漲幅
$> 25.0%$ 或 短線 5 日急漲$> 20.0%$ ➔ 一票否決！ - 📏 季線乖離過濾：季線正乖離率
$> 18.0%$ ➔ 一票否決（黃金安全區間為$+1.0% \sim +12.0%$ ）。 - 📊 剛性流動性與破億門檻：5 日均量需
$\ge 800$ 張，當日成交量需$\ge 1,200$ 張，單日成交金額必須$\ge 1.0$ 億元台幣 ➔ 未達 1 億一票否決（徹底排除平時無量、偶爾炒作之小型妖股）。 - 🚫 上方 250 天歷史巨量套牢反壓過濾 (250D Overhead Supply)：過去 1 年內曾自歷史高點暴跌超過
$28%$ 且上方存在巨量套牢山頭者 ➔ 一票否決（排除如華經這類高空套牢深水區反彈股）。 - 📈 週K線宏觀趨勢共振過濾 (Weekly Trend Filter)：週 5MA 走平翻揚、打出週線 Higher Low 雙底者優先；凡最新週K收在週 5MA 之下且週 5MA 下彎、或高檔見頂下挫者 ➔ 一票否決（排除如華碩自高檔見頂的下跌波段）。
- 🌊 族群共振加權：同產業有 2 檔以上同時表態者優先決選。
- 🛑 第一道防線：攻擊K低點防守 (-3.5% 保命停損)
- 判定標準：以 13:10～13:20 尾盤收盤實體 是否跌破發動K低點為唯一依據。
- 防主力洗盤禁令：嚴禁預掛盤中窄幅條件觸價單（Stop Order）！盤中任何跌破皆屬過程，未收盤前不被主力開盤 09:05 下影線洗在阿呆谷（鴻準實戰教訓）。
- 📉 第二道防線：季線 MA60 終極多空分水嶺
- 實體收破 60MA 季線，波段趨勢破壞，多單全數停損結案。
- 💰 第三道防線：雙數張階梯移動保本與趨勢線防守
- 雙數張操作時序：第 1 張衝高達
$+5% \sim +8%$ 獲利落袋鎖死勝率；第 2 張「同一時間」將防守底線上移至「買進平均成本價（保本）」，確保該筆交易 100% 零風險，絕不讓賺錢單變賠錢單！
- 雙數張操作時序：第 1 張衝高達
- ⏳ 第四道防線：T+5 時間防線硬性換股 (杜絕資金鈍化)
- 持股滿 5 個交易日 (T+5)，若股價仍在成本
$\pm 2.0%$ 內牛皮停滯且推薦分數降為 0 分：第 5～6 天必須在平盤附近主動結案換股，將資金釋放給新的 TOP 5 標的，嚴禁以未破停損為由盲目死抱！
- 持股滿 5 個交易日 (T+5)，若股價仍在成本
- 📈 多週期週線重採樣：自動將日線資料以每週五收盤重採樣為週K線，計算週 5MA/10MA/20MA 及斜率，確保「大週期定方向、小週期找買點」。
- ⏱️ 400 天長週期歷史深度：資料抓取窗口擴大至 400 日，完整覆蓋 250 個交易日（1 年）籌碼套牢反壓檢測與 52 週週線分析。
-
🛡️ 航太級三層備援抓取 (Multi-Tier Fallback)：
yfinance遭遇 API 封鎖或上櫃股識別失敗時，自動切換至「台灣證交所 (TWSE)」與「櫃買中心 (TPEx)」進行資料救援。 - ☁️ 境外 IP 自動熔斷防護：全自動探針偵測證交所境外 IP 封鎖，秒級降級保護，防止 Streamlit Community Cloud 卡頓與休眠。
-
🚨 即時大盤空頭避險開關：加權指數收破 20MA 或單日重挫
$> 1.0%$ 時，系統強制啟動 BEAR_DEFENSE，全面關閉追價買單。 -
🌑 沉浸式暗黑 UI：專為長時間盯盤設計的高對比暗藍色背景 (
#0B1120) 與直覺式狀態燈號。
在專案虛擬環境啟動狀態下，於終端機輸入：
streamlit run app3.py系統將自動開啟瀏覽器並連線至 http://localhost:8501。
本專案所有程式碼、掃描結果、技術型態與籌碼分析，僅供學術研究、程式開發技術交流與個人交易紀律訓練之用，不構成任何形式的投資建議、證券推薦或買賣要約。台股交易具高度市場風險，投資人應獨立審慎評估風險並自負盈虧。