本週 3Q 工程團隊橫跨八個專案同步推進：eMobile 電子發票平板對齊 Windows 端並修復版本檢測邏輯；Claude Nexus 完成 Canvas 點選改圖三層流程與權限控管上線；3Q 夥計 OCR 繁體升級帶來 37 倍辨識量躍升、置頂機制強化、SOP 自動分類；台股量化系統修復除息資料毒化根因；Solar Monitor 完成 IoT 重連、電池容量校正；多個 ERP 客製系統同步完成重點功能交付。這週的共同主題：找到真正的根本原因，而非打補丁。
既有專案改進 #
eMobile 平板端四大功能對齊與版本檢測修復 #
平板 InvoiceListScreen 新增統編判斷邏輯修正（B2B 模式才強制列印明細）、未上傳發票刪除含確認對話、刪除同步 Hub 機制（含庫存回補）、補印證明聯與明細按鈕（從資料庫重建發票資料）。版本檢測發現平板與 Hub 的 versionCode 計算公式不一致（patch 乘數差 10 倍），導致平板永遠誤判自己為最新版、跳過強制更新。統一公式後升版至 v2.7.0，APK 重新上傳 Hub。同步修正 sync-manager 的 SQL 條件，確保折扣預設值能正確推送平板。這次改版也澄清了三端架構邊界：平板開票不依賴 Windows 在線，但日結報表與設定同步（商品、折扣、字軌）需經 Windows 攤位版，建議營業結束前開啟執行日結確認。
Claude Nexus Canvas 點選改圖三層流程上線 #
完成 AI 素材生成的完整三層流程落地：第一層升級核心模型並導入 Antigravity CLI 取代失效的舊圖像整合，前端新增 /image 指令直接生成素材；第二層右側 Assets 面板展示庫存、支援右鍵「AI 改圖」與「插入畫布」；第三層實現點選改圖——在 Excalidraw 畫布上直接點選元素輸入改圖指令，AI 自動修改並回寫，無需跳轉外部工具。Studio 設計環境同步修復 Claude 認證 401 問題，完成全機群模型升級部署。
Claude Nexus 四層權限控管系統驗證完成 #
完整實作並驗證四層權限策略：本機環境無限制存取、內網 IP 開放指定專案及特定功能頁、Search 功能限唯讀、Dashboard 卡片依角色過濾、機群伺服器白名單保護自動化任務不被干擾。經四次迭代部署後通過完整驗證。同步修復 stock-trading-v2 watchdog 誤判 Claude 等佇列為任務結束、導致串流內容被清的問題。
3Q 夥計 OCR 繁體升級：辨識量 37 倍躍升 #
診斷歷史 OCR 引擎採用簡體中文模型，導致繁體字大量誤辨與漏字。升級為繁體專用模型後，同張截圖辨識字數從 48 字提升至 1798 字（37 倍）、繁體正確率達完整復現。騰出 GPU 記憶體資源供 OCR 加速，backfill 引擎同步升級，對既有截圖資料執行全量重跑，確保歷史知識庫的繁體覆蓋率。這次升級直接決定了 KOSMOS 知識萃取的品質天花板——模型選型錯誤會在資料層靜默放大，值得所有做 OCR pipeline 的團隊留意。
3Q 夥計窗口置頂機制重建與 SOP 自動分類 #
發現舊版 SetWindowPos 對已標記 topmost 旗標的窗口為空操作，導致浮動角色實際 z-order 仍會被其他視窗壓過。改為強制 NOTOPMOST→TOPMOST 雙步驟切換、縮短週期至 2 秒，實測被覆蓋狀態下 10/10 次成功搶回置頂位置。同步完成版本分化部署（老闆版保留完整功能、員工版移除隱私相關模組）、SOP 主題自動抽取（94 個業務流程類別）、員工版隱私過濾機制驗證。
Solar Monitor IoT 重連、電池容量校正與充電限流驗證 #
IoT 裝置因 DHCP 重分配通訊中斷長達 56 天，透過掃描網段定位新 IP、驗證裝置識別碼後更新設定重啟服務恢復連線。電池容量歷史資料執行 4,489 筆校正（平移 176.2 Ah），充飽點與深放點錨定值修正完成，即時監測數值精度驗證正常。另確認充電限流機制正常運作：PV 短時衝高時電流精準卡在轉換器上限，平時觀測到的平頂現象源自供給端穩定，非控制端異常。控制器首次同步機制同步修復，加入強制首次寫入旗標，解決重啟後設定值與硬體不同步問題。建議後續配置靜態 IP 綁定防止 DHCP 重分配再度造成連線中斷。
台股量化系統修復除息資料毒化根因 #
確認系統在除息日因還原收盤價欄位為 NULL 而改用未還原的原始資料，導致技術指標計算基準失真、觸發虛假訊號。修復後還原收盤價每日 15:35 自動重算，除息排除窗擴展至近 3 天 + 未來 14 天。同步驗證 BOLLINGER 下軌買進策略的回測統計基於乾淨資料後指標顯著，並完成修正 FinMind API 節流機制、後端排程服務部署。LIVE/PAPER 交易分離也在本週完成，前端不再混合顯示兩者績效，並新增券商 API 直連端點解決手動平倉後對帳延遲。
新專案 #
OMEinvn 時區修復、商品照片救援與 Turnkey 發票穩定化 #
發現訂單時間差 16 小時的根本原因是 Electron 進程時區設為 UTC，影響統計與發票產生時間。改採 wall-clock 語意統一處理，修改 DBF 匯入邏輯、SQL 查詢與前後端顯示，時間一致性問題解決。從舊備份救回 18 張商品照片（100% 匹配率），存入 SQLite BLOB 並自動 resize，新增匯出/匯入 ZIP 功能支援一鍵批次更新商品圖。Turnkey 發票整合移除已廢棄資料表的歷史查詢，確保上傳、作廢流程穩定。FoxPro 舊系統遷移同步加入重複匯入保護，防止歷史資料重複寫入。
基礎建設 #
LcbProduction 倉儲防呆三層保護與缺點別動態管理 #
進口商品批次掃描新增三層重複防呆：前端 Enter 事件立即鎖定輸入並遮罩提示、UpdatePanel 併發控制、後端 SELECT COUNT 檢查資料庫是否已存在同一條碼。結果回報分類顯示新增與略過筆數。另建置缺點別管理分頁，支援完整 CRUD 操作，幹部無需手動執行 SQL；採快照式設計，缺點名稱在掃描時存入紀錄、後續顯示直讀快照，修改或停用缺點立即反映至品檢、報表、列印等下游模組。同步修正噴釉統計機台顯示錯誤，改用人員機台對照表替代成型機台號，並完成跨系統查詢與舊資料回填方案。
gomylife 週報生成器 Map-Reduce 改造 #
將舊版單次彙總模式改為兩段式架構：Map 階段針對每個專案取全量 digest 加原始工作訊息，輸出 250-450 字詳報；Reduce 階段聚合成完整對外週報。同步擴大報導規模（專案數與訊息數均提升）、保留隱私防護與驗證 gate。3Q 夥計、emobile-b2b、emobile-pos 等產品頁同步完成內容更新，標記最新版本、功能進展與 CTA。
期貨實驗室策略引擎崩潰根因診斷與架構修正 #
確認策略連續崩潰根因：generate_signals 每根 K 棒從第 0 根重跑歷史重建持倉，無法反映平台觸價強平事件，策略與引擎對「當前部位」的認知永遠脫鉤。新增三層診斷機制（策略內部 debug_log、引擎執行事件、API 驗證端點），確認記憶體與券商帳戶部位同步正常。完成 Migration 新增 mode 欄位區分 LIVE/PAPER，修正 API 過濾分離績效顯示，並新增券商 API 直連端點處理手動平倉後對帳延遲。
技術心得 #
根本原因才是唯一出口：本週的共同課題 #
本週跨多個專案都碰到同一類型的問題：表面現象容易修，但如果只修表面，問題會以不同形式再出現。平板版本檢測因公式乘數差異導致永遠跳過更新、OCR 因模型語系錯誤導致知識庫靜默劣化、台股系統因 NULL 欄位 fallback 到未還原資料導致訊號失真、IoT 裝置因 DHCP 重分配悄悄斷線 56 天——這些問題的共同特徵是「系統不報錯、但輸出已經錯了很久」。對中小企業 IT 導入來說，這類潛伏型錯誤比顯性崩潰更危險，因為它會在你最依賴資料做決策的時候讓你信任一個錯誤的數字。我們的應對方式是：每個問題都倒推到最早的錯誤點（資料層、版本計算公式、模型選型），修完後設計可重複驗證的基準（回跑歷史資料、實測 10/10 次置頂、充飽/深放點錨定）。可驗證的修復才是真的修復。
本週技術心得 #
這週最值得提煉的工程心得，是「靜默失敗比顯性崩潰更難對付」。台股系統的除息毒化、夥計的繁體 OCR 漏字、平板的版本檢測失效、IoT 的 56 天斷線——這四件事有一個共同模式：系統正常運行、沒有報錯、但輸出已經錯了，而且很可能已經錯了很久。對 B2B IT 顧問來說，這個模式的危險在於：決策者往往在系統看起來「正常」的狀態下做出關鍵判斷。我們在實務上歸納出三個防線：第一，設計可重複執行的基準驗證（比如充飽點錨定值、OCR 字數對比、版本號公式對算），讓「修完」有明確的數字依據而非感覺；第二，資料 pipeline 的每一層都要有異常感知，NULL fallback 到原始值這類靜默降級邏輯是高風險設計，應明確記錄並告警；第三，外部依賴（DHCP、API 格式、模型語系）要假設它會悄悄變，建立主動偵測而非等待使用者回報。這套心態不只適用於我們自己的系統，也是我們在協助客戶規劃 ERP 客製、IoT 整合、資料驅動決策時反覆強調的架構紀律。
本文是 3Q 工程團隊的每週技術進度整理，由 Claude 協助編寫。內容聚焦技術類型與通用心得，不含客戶資訊。