本週 3Q 工程團隊在三條主線同步推進：桌面 AI 產品「3Q夥計」完成多輪穩定性迭代，解決 WebSocket 重播、快取污染、UTF-8 編碼等深層 bug，雙版本部署上線；量化交易系統挖出沉睡一個多月的初始化 bug 並修復自動下單排程；eMobile 電子發票平台完成 LINE Pay 支付整合與 POS 套組折扣修正。摩葳寄售系統、PINKOI 通路匯入、太陽能監控也各自完成重要改版，展現跨領域系統同步交付的工程節奏。
既有專案改進 #
3Q夥計 WebSocket 架構重構：根除重複回答問題 #
診斷出 AI 夥計重複回答的根本原因是 parked WebSocket replay——舊連線未關閉導致歷史訊息被重送。經四輪迭代改為短命 WS、移除 hello handshake、以 session_id 維持對話連貫性，四輪驗證全數通過。這次除錯也讓我們體會到：誤判根因會讓工程師在錯誤方向徒勞數小時，建立可重現的驗證流程比憑直覺猜更重要。
3Q夥計多端部署：老闆版與員工版功能分化 #
完成雙版本差異化部署，依使用角色動態調整功能集合與推理強度（effort 參數），並修復截圖圖庫視窗的即時刷新問題——採輪詢 + 事件驅動 + 視窗顯示三層保險，確保畫面在 3 秒內更新。同步修復 Windows hook 的 UTF-8 編碼問題，驗證跨機通過。
Claude Nexus 全機群 hook 斷線修復 #
排查出全機 Claude Code 完全阻斷的根因：某個 hook 腳本被改名，但設定檔仍指向舊路徑。逐台復原多個安裝點，補齊 hook 至最新版並確認 chat server 正常。此事件說明：hook 路徑是關鍵基礎設施，改名前必須同步更新所有引用點，建議納入變更前置檢查清單。
量化交易 AutoTrader：修復沉睡一個多月的初始化 bug #
發現 AutoTrader 初始化流程存在一個靜默失敗的 bug，導致部分條件下自動下單未能正確觸發，問題已潛伏超過一個月才被挖出。修復後驗證自動排程行為正常，同步修正颱風假日判定邏輯，並發現回測評級較低的策略實際勝率反而更高，顯示評級指標需重新校準。
eMobile 完成 LINE Pay 支付整合並上線 #
POS 端完成 LINE Pay 支付流程整合，同步修復套組折扣計算與庫存扣減的雙 bug（v1.0.15）。另針對某製造業客戶實作條碼表 PDF 功能，支援類別分頁、CODE128 條碼與售價列印，排查字型缺失、HTTP 編碼、版面換頁三個問題後完成部署。
摩葳寄售系統 Phase 1：季報公式化與通路資料修正 #
完成摩葳寄售系統基礎建設，調整多通路負庫存資料（分月補進貨），季報改為公式版以利驗算，自有商品排除寄售計算範圍。同步完成 PINKOI 通路銷售匯入改造，清理三個月重複資料，驗證應開發票金額無誤後部署新版程式。
太陽能監控：假日電價邏輯修正與新機型備援準備 #
修正台電時間電價的假日判定，改用官方公告的正確國定假日清單，修正補假與彈性放假誤判為假日的問題。同步修正電池過流守門邏輯，排除 BMS 壞值干擾。另蒐集新型逆變器的英文手冊與 Modbus 協議文件，為即將進行的機型切換測試備妥。
新專案 #
3Q夥計視覺感知能力實測：OCR 擷取螢幕內容 #
測試 3Q夥計主動擷取螢幕畫面並透過 OCR 解讀內容的能力，歷經圖片尺寸過大、API 格式不相容等多個技術障礙並逐一排除。這項能力讓桌面 AI 能「看懂」使用者目前在做什麼，是實現主動提示與情境感知的基礎技術，未來可應用於工作流自動化與異常偵測。
基礎建設 #
gomylife.tw 內容更新：週報生成器修復與頁面整併 #
修復技術週報生成器的資料來源串接，確保週報能正常產出。同步將 F1 賽季專題內容整併進既有高排名頁面，加入截圖說明後上線，維持對外內容的持續更新節奏。
技術心得 #
根因誤判比 bug 本身更貴 #
本週最值得記錄的教訓不是某個 bug，而是「誤判根因的代價」。3Q夥計的重複回答問題，工程師在錯誤假設下花了六小時修了一個不存在的問題；量化交易的初始化 bug 靜默潛伏超過一個月，因為錯誤表象讓人以為系統正常。中小企業 IT 資源有限，無法承受在錯誤方向上的時間損耗。我們的對策是：先建立可重現的最小驗證場景，確認根因後再動手修，而不是憑直覺先改再看。這個紀律看似慢，實際上是最快的路。
本週技術心得 #
這週的工作橫跨 AI 產品、量化交易、電子發票、太陽能監控四個領域，表面上是分散的，但反覆出現同一個主題：靜默失敗比顯性錯誤更危險。WebSocket 舊連線靜默重播、hook 路徑靜默失效、AutoTrader 靜默跳過初始化、BMS 壞值靜默混入計算——這些 bug 的共同特徵是系統「看起來在跑」，但行為已經偏離預期。對中小企業的 IT 系統而言，這類問題特別棘手：沒有足夠的監控資源，很難在第一時間發現。我們這週學到的對策有三層：（1）關鍵路徑加入可觀測的驗證點，讓靜默失敗變成顯性警報；（2）每次修復後不只看「沒報錯」，要確認資料或行為層面的正確性；（3）跨機部署的設定變更（路徑、hook、格式）要有同步更新的前置檢查，不能只改一處。這些紀律不需要大型工程團隊才能落地，任何認真的 IT 顧問或開發團隊都可以直接採用。
本文是 3Q 工程團隊的每週技術進度整理，由 Claude 協助編寫。內容聚焦技術類型與通用心得，不含客戶資訊。