這週 3Q 工程團隊橫跨七條產品線同步推進：Claude Nexus 完成雙指令圖片生成系統與 Opus 升級；eMobile 電子發票確立三層產品架構並修復多項上線問題；3Q夥計儀表板完成大幅重構；Solar Monitor 推出電池展望卡與智能預報校正；股票系統 V3 修正除權還原公式並完善交易介面；金流整合完成 LINE Pay 與永豐 Sandbox 驗證；倉儲品檢系統完成缺點別動態管理上線。每條線都在用紮實的技術細節往前推，沒有虛的。
既有專案改進 #
Claude Nexus 雙指令圖片系統上線，破解 skill 劫走問題 #
建立兩條獨立圖片生成路線：/image 走照片級生成（供產品照、海報素材），/chart 產出 HTML 資訊圖表後轉 PNG（供含中文標籤的分析圖與流程圖）。根本問題在於模型自由判斷會讓指令被設計 skill 攔截，改寫 chat_server 入口點將指令內部化、禁止呼叫前置 skill，確保流程固定可控。跨六台 Linux 主機與 Windows 雙系統全面部署驗證完成。同步升級 Opus 模型，並實現 Studio 三層功能（生圖 → Assets 面板 → 點選大圖即時改圖），完整解決舊版黑屏問題。
Nexus 假 session 過濾與 API 穩定性修復 #
排查出系統列表出現假 session 的根因：官方 Claude 桌面應用會自動快取並寫入系統目錄，修改代碼識別並過濾這類 instance。同步發現 Chat 重複提示訊息源自 API 請求掛死，釘回特定模型版本後全機群部署測試通過，穩定性問題確認解決。
eMobile 電子發票系統三層產品架構確立 #
完成產品線盤點，確立前台層（Biz 企業版、Store 零售版、Dine 餐飲版）、中樞層（HQ 總部統樞、Shop 零售中樞、Feast 餐飲中樞）的三層架構。釐清字軌流程：HQ 統一申請後分配至各中樞，再流向前台本機快取。同步確認平板版技術方案採 XPrinter SDK 搭配 bitmap 中文渲染。設計文檔移除內部案例、改用通用情境（如工廠 B2B+市集零售、連鎖餐飲+團膳），與對外問卷決策樹對齊。
eMobile 上線 patch 修復與 ModSecurity 誤判排除 #
修復某客戶系統四項遺漏 patch：發票資料同步、時區修正、來客報表欄位、訂單邏輯控制。同時修正儀表板時間戳 bug，補建 POS 折扣訂單記錄結構。重要發現：POS 發票重推被 Apache ModSecurity 誤判中文字元導致 403 拒絕，確認根因後修復，發票推送流程恢復正常。CSV 自動上傳評估結論：財政部平台無 API 上傳通道，改採官方 Turnkey 通道為主方案（自動化程度最高、法律風險最低）。
3Q夥計儀表板重構：時區修正、事件完整顯示、身份識別優化 #
修正容器時區與前端本地日期不一致問題，事件改為全量顯示不設上限，全公司檢視模式預設不隱藏使用者身份標籤。事件列重構為主行（時間、應用、重點、時長、縮圖）加副行（URL、資料夾、對話對象），排版撐滿寬度，便於管理端快速瀏覽。整合檔案總管提取、瀏覽器歷史蒐集與即時通訊對話對象辨識（命中率達 99%）。四台機器全數佈署新版本，642 筆事件完整顯示。
3Q夥計流程庫智能分類：區分 SOP 與日常活動 #
盤查大量歷史流程記錄，發現其中混雜 AI 使用紀錄、日常巡檢與非工作片段。實裝四分類標籤（doc_type），員工搜尋自動過濾只顯示教學流程，私人活動對員工隱藏。垃圾片段（小節標題被誤當流程名）透過黑名單機制自動併回原流程，新萃取內容亦自動帶分類標籤，從源頭維持資料品質。
Solar Monitor 電池展望卡上線：充飽 ETA、撐到時間、省錢建議三合一 #
新增智能電池展望模組，整合三大預測功能：充飽 ETA 掃描小時模擬曲線找出首次觸及目標容量的時刻；撐到時間預測電池何時觸及保護電壓門檻；省錢建議透過 48 小時枚舉找出成本最低的方案切換點。API 採 5 分鐘快取，實測驗證三項功能均按預期輸出。同步解決 TUYA 電表查詢效能問題，改用 stale-while-revalidate 快取策略，頻繁查詢從冷啟動 9.3 秒降至 6.3 秒，後續查詢回應在 0.03 秒內完成。
Solar Monitor PV 預估動態校正：實測比值逐步衰減機制 #
實時監測當前小時實測 PV 與氣象預報的比值，後續小時以指數衰減係數逐步降低修正信度，2-3 小時內維持高信任、5 小時後逐步回歸原始預報，使電池續航預測更貼近實際氣象變化。修正效果：充飽 ETA 從原估時間推遲一小時，當前 PV 功率正確打平負載預測，估算準確度明顯提升。
股票系統 V3：除權還原公式缺陷修正，避免歷史 K 線失真 #
發現除權除息還原公式嚴重缺陷：原程式誤將面額股利（元/股）當作比例使用，導致配股個股整段歷史被錯誤壓縮，造成 K 線跳空失真。修正公式為「面額 ÷ 10 = 比例」後，adj_close 還原精度提升，純現金股利標的不受影響。完成全池逾千支股票的 adj_close 回測資料 backfill，勝率分布與進場效率驗證正常。此類資料還原的精確性，對任何依賴歷史資料的自動決策系統都至關重要。
股票系統 V3：賣觸發進度視覺化與配置層級修正 #
前端交易介面新增賣觸發進度顯示，RSI、BOLLINGER 等具明確門檻的賣策略顯示百分比進度，灰、橙、紅三級顏色分別對應距觸發的遠近；MACD 等無連續指標的策略改採紅箭燈號機制。同時修正系統配置讀取層級混亂問題：原本 DB 層設定被程式碼硬編碼值蓋過，改為 DB 優先、config 作 fallback，使管理介面的配置修改能真正影響下單邏輯。
Futures Lab 帳戶同步完全修復與客戶自助對帳工具 #
發現原有自動對帳僅同步記憶體，未同步策略 session 內的部位欄位，導致策略誤判部位未變動而停止下單。已修改同步邏輯同時更新 session 狀態，並標記退場原因供事後追蹤。新增客戶自助下載功能，一鍵取得最近 24 小時全部策略決策事件 JSON（含不進場決策），並提供切換顯示無訊號事件的選項，客戶可自行診斷策略行為，大幅降低支援負擔。修復部署腳本的 SSH 認證失敗問題，自動 rebuild 機制恢復穩定。
LcbProduction 倉儲品檢：缺點別動態管理系統上線 #
新增缺點別管理分頁，實現不依賴硬編碼 SQL 的動態管理模式，支援缺點代碼新增、inline 編輯、啟用/停用切換，代碼重複時自動擋下提示。採快照式儲存策略——掃描當下即存檔缺點名稱字串進檢驗紀錄，事後無需回查資料表。驗證確認掃描頁選單、列印檢驗表、日報表三位一體同步無延遲，既有的條碼履歷與員工缺點查詢功能無需調整。品檢頁面同步補強組別資訊顯示，員工編號後新增組別括號展示，中英文版本統一調整。
新專案 #
LINE Pay 與永豐金流整合完成 Sandbox 驗證，正式上線準備就緒 #
完成 LINE Pay 金流整合前置作業：商店審核通過、正式環境金鑰取得、Sandbox 端到端全流程驗證通過（Request → 付款 → Confirm 全鏈路正常）、正式環境 IP 白名單設定完成。永豐信用卡及虛擬帳號金流 Sandbox 驗證同步完成，待正式環境申請核准即可上線。整合指南文件已編製完整，含程式碼樣板、API schema、結帳頁面整合說明與關鍵細節（transactionId 格式、金額 ×100 處理），可直接進行正式環境接軌。
國泰世華信用卡特約商店申請文件完成，涵蓋完整合規要件 #
製作線上刷卡收單合規說明書，含實際網站截圖，依審核要點涵蓋申請目的、商品內容、交易流程、退換貨政策（含消保法七天鑑賞期）、配送方式、服務條款、FAQ、隱私權政策及合規檢核總表，共十一個章節完整編排。所有資料均來自實際頁面截圖，未使用假資料。待確認服務條款頁面內容後即可提交申請。
基礎建設 #
chat_server v2 全機群部署完成，SQLite 持久化與 HTTP 直連派發到位 #
部署 chat_server v2 至全數六台 Linux 主機，實現 SQLite 持久化（涵蓋多處業務邏輯引用）與 HTTP 直連派發模式（消除舊版 SSH screen 中繼的黑屏問題）。完成全伺服器 MCP 工具驗證（browser-knowledge、context7、playwright 跨 Linux 與 Windows 主機），確保統一工具鏈。更新基礎設施規範文件，統一 SSH 操作規範，禁止直連改用中繼工具，降低誤操作風險。
某客戶平台 nginx 緩衝升級，修復大型 Session Cookie 502 問題 #
將 nginx proxy_buffer 從 4KB 升級至 32K，修復大型 session cookie 塞不下導致的 502 錯誤，登入 callback 流程驗證通過，Set-Cookie header 完整寫入。同步修正五個 ESLint error，包括建立時間 wrapper 統一 server render 內的 Date.now() 呼叫、以 reduce 消除副作用、Link 取代站內 a 標籤，對應 Next.js 16 與 React 19 新 purity 規則，build/tsc/eslint 全綠。資料層補修角色代碼誤植並補齊電子發票相關權限，端點 smoke test 覆蓋公開與受保護端點，整體完整性達 92%。
技術心得 #
3Q 網站庫存列表 Excel 中文字寬校正，從根本解決列印截字 #
發現 Excel 中文字元視覺寬度與計算值不符，原以 2 個標準字寬計算，實際渲染約佔 2.5 個字寬，導致長品項名末字被隔壁欄覆蓋。修正權重並擴展 autoFitColumns helper 支援 per-column 欄寬上限與自動換行選項，各分類 sheet 名稱欄寬依實測最長品名重新計算，所有欄位對齊驗證通過。此類「計算值 vs 渲染值」的落差在任何含中文的報表輸出場景都會遇到，應視為標準校正步驟而非偶發 bug。
本週技術心得 #
這週有幾個值得中小企業 IT 團隊參考的通用觀察。
第一，「配置層級混亂」是系統成長後的常見陷阱。股票系統出現 DB 設定被程式碼硬編碼值蓋過的問題，管理者在介面改了配置卻沒有生效。這種「UI 看起來改了，系統行為沒變」的問題在多層配置架構中極易出現，解法是明確定義優先順序（DB > 設定檔 > 預設值）並在每一層加上 log，讓變更有跡可查。
第二，快取策略的選擇直接決定用戶體驗。Solar Monitor 的 TUYA 電表查詢從冷啟動 9 秒降至 0.03 秒，靠的是 stale-while-revalidate 模式——先回傳舊資料、背景更新。這個模式適合「資料略舊沒關係、但不能讓用戶等」的場景，是一個高 CP 值的優化手法。
第三，指令系統的可控性比彈性更重要。Nexus 的圖片指令問題本質上是「模型自由判斷」與「工程可預期性」之間的衝突。把關鍵流程內部化、明確禁止外部干預，犧牲一點彈性換來穩定可重現的行為，在正式產品中幾乎永遠是正確的取捨。
第四，資料還原的準確性是量化系統的生死線。除權還原公式錯誤導致歷史 K 線失真的問題提醒我們：任何依賴歷史資料做決策的系統，資料前處理的每一個假設都要有文件記錄與驗證測試，否則錯誤會在最難察覺的地方悄悄累積。
本文是 3Q 工程團隊的每週技術進度整理，由 Claude 協助編寫。內容聚焦技術類型與通用心得，不含客戶資訊。