2026年8月1日 星期六

本地端MARKDOWN檔,轉換成HTML 或 PDF檔工具

情境: 因筆者使用Google Antigravity CLI 產出大部分是以文字狀態格式,但有時候ASCII文字產出內容,文字可讀性不佳(如有表格會有偏移情形),故可安裝本地端PANDOC、Weasyprint套件(含相依Mingw64 / GTK 執行環境 軟件),安裝本地端處理MARKDOWN格式軟體,轉換成可讀性較高之PDF格式,以下為作業系統、PYTHON呼叫及相依函式庫如 Pango、Cairo、GDK Pixbuf 的載入狀態 關係梳理:

Windows 上 Python、WeasyPrint(CSS 轉 PDF 引擎)與 Mingw64/GTK 的相依套件關係

1. Windows OS 與 DLL 載入機制

  • Windows Loader 會依序在 程式所在目錄 → 系統目錄 → PATH 搜尋 .dll
  • 若相依的 DLL 不在這些路徑,會出現 FileNotFoundError 0x7e

2. Python 與 CFFI(橋接層)

  • WeasyPrint 以 Python 為外層,但核心排版功能依賴 Pango、Cairo、GObject
  • CFFI 在 import weasyprint 時會呼叫 LoadLibrary 去載入 libpango-1.0-0.dlllibgobject-2.0-0.dll 等。
  • Python 3.8+ 加強了 DLL 搜尋安全,導致只能在標準路徑找到外部 DLL。

3. Mingw64 / GTK 執行環境

  • 需要透過 MSYS2 安裝 mingw-w64-x86_64-* 套件,產生 Windows 版的 .dll
  • 依賴樹狀結構 (需系統底層 C 庫(Cairo, Pango, GDK-PixBuf)):
    • WeasyPrint → libpango-1.0-0.dll
    • libpango → libgobject-2.0-0.dll、libcairo-2.dll
    • cairo → libpng、libjpeg、fontconfig、harfbuzz 等。
  • 因此必須把 C:\msys64\mingw64\bin 加入 PATH,一次性解決所有子依賴。

4. 常見錯誤對照表

錯誤訊息 根本原因 解決方案
cannot load library libgobject-2.0-0 缺少 glib2 套件或未在 PATH pacman -S mingw-w64-x86_64-glib2 並加入 PATH
cannot load library libpango-1.0-0 缺少 pango 套件 pacman -S mingw-w64-x86_64-pango
ImportError: cannot import name 'cairo' 缺少 cairo 套件 pacman -S mingw-w64-x86_64-cairo

5. 測試步驟

  1. 檢查 DLL

    where libgobject-2.0-0.dll
    where libpango-1.0-0.dll
  2. 顯示 WeasyPrint 系統資訊

    weasyprint --info
  3. HTML→PDF 測試

    weasyprint "data:text/html,<h1>Hello</h1>" test.pdf
  4. Python 測試

    from weasyprint import HTML
    HTML(string="<h1>Hello</h1>").write_pdf("test2.pdf")
    print("PDF 轉檔成功!")
  5.  Pandoc 測試  (安裝 winget install JohnMacFarlane.Pandoc)

            pandoc --version

   pandoc "C:\MARKDOWN_2_PDF.md"  

                -f markdown -t html  

               -o "C:\MARKDOWN_2_PDF.html"

相關KEYWORD資訊:

MSYS2,

將易偏移的 ASCII 藝術圖,系統能透過 結構分析 與  GfmTableFormatter 模組,自動將其轉化為符合 GitHub Flavored Markdown (GFM),增加文件可讀性 

2026年7月27日 星期一

AI 賦能的 業務自動化診斷象限分析(Internal Automation )

找出您日常工作(或公司業務)中的「高耗時、低認知、高重複性」任務,並直接以技術落地進行物理消滅。

一、觀察與指標分析

找出「哪些工作該自動化」,採用量化任務的物理特性。請利用下圖的四象限篩選器進行任務盤點:

        





象限 II:認知型決策

策略規劃、架構設計、

複雜 Bug 調試

策略:保留,AI 輔助思考

象限 I:黃金自動化區

數據清洗、定期週報、

跨系統同步

策略:立即開發 Agent 代替

 

 


象限 IV:低頻隨機任務

偶發硬體故障排除、臨時非標準查詢

策略:手動處理



象限 III:日常瑣事

郵件分類、排程、發票報支、考勤對齊

策略:使用輕量工作流自動化

                    低                                 重複頻率                                  高

   

1. 象限 I:黃金自動化區(高重複、高認知密度)

特性:數據清洗、定期週報生成、格式轉換、跨系統資料同步。

💜OA 情境:跨系統多源資料同步與定期週報/月報自動生成

每週一早晨,行政或營運人員需手動登入 ERP、CRM 或雲端表單下載多份 CSV/Excel 報表,將其欄位格式統一、進行樞紐分析與交叉比對,最後複製貼上至 Google 文件或 Word 中,產出固定格式的部門週報。

💟具體效益:將每週耗費 2 至 3 小時的手動剪貼與格式調整時間縮減為 0,實現 100% 自動化產出,並徹底消除人為複製貼上可能造成的數值錯置風險。

💟解決方案:

方案 A(純 Google 生態系):使用 Google Apps Script (GAS) 撰寫自動化排程腳本,定時從 Google 雲端硬碟指定資料夾讀取 CSV 檔案,利用內建陣列與迴圈進行資料清洗,最後自動填入 Google 試算表並發送帶有圖表的報告至指定 Gmail。

方案 B(進階 Python 客製化):編寫 Python 程式(結合 pandas 與 openpyxl 庫),透過 Google Workspace API 定期拉取原始數據,在本地或雲端主機進行高效能的資料清洗與聚合,自動生成排版精美的 Excel 報表後自動上傳至雲端。


💜OA 情境:不規則發票、收據與請款單之格式轉換與對帳

財務與會計部門每月需處理大量來自不同廠商的 PDF 格式發票、掃描檔或各式請款明細。人工需逐筆核對統編、品項、金額,並手動轉錄輸入至公司的會計系統或 Google 試算表。

💟具體效益:大幅降低會計人員在月底報支高峰期的資料錄入負擔,將對帳與資料登打錯誤率降至趨近於零。

💟解決方案:

方案 A(智慧辨識與自動化):搭配 Google Cloud Document AI 或調用 Gemini API 的多模態(Multimodal)辨識能力,自動解析 PDF/圖片中的結構化欄位(如品名、金額、統編)。

方案 B(Python / Excel VBA 腳本處理):結合 Python 腳本抓取辨識後的 JSON/CSV 結果,自動與內部 ERP 的請購單進行 Fuzzy Matching(模糊比對)對帳,若吻合則直接寫入資料庫或輸出標準對帳表。


💜OA 情境:大量表單資料的清洗、異常值過濾與格式標準化

客服或業務團隊收到的客戶填報資料(如 Google 街口表單、客戶名單)往往充滿雜訊:電話格式不統一(有的是 0912-345-678、有的是 +886912345678)、空白夾雜、全形半形混用,人工清洗極耗心力。

💟具體效益:瞬間完成成千上萬筆亂七八糟資料的正規化(Normalization),確保進入資料庫的數據品質一致,加速後續行銷或客服派工流程。

💟解決方案:

方案 A(Excel VBA 巨集):針對仍在傳統辦公環境運作的團隊,編寫帶有正規表達式(RegEx)或字串處理邏輯的 Excel VBA 巨集,一鍵執行即可將整張工作表的電話、信箱、日期格式瞬間洗平與重排。

方案 B(Python 模組化腳本):撰寫輕量化 Python 腳本(使用 re 與 pandas 模組),部署於自動化工作流中,當有新表單進駐時自動觸發清洗並回寫(請依上述OA情境,詳列方案B,以STEP BY STEP方式,提供詳細PYTHON作法)。


💜OA 情境:系統異常日誌(Log)定期巡檢與自動化警報分發

資訊或維運人員每日需手動檢查各系統伺服器的運行日誌、確認是否有未攔截的錯誤(Exception),或檢查批次作業(Batch Job)是否順利執行完畢。

💟具體效益:將被動的人工巡檢轉為主動的「例外即時攔截」,落實維運規範,避免沉默失效。

💟解決方案:

方案 A(Python 監控腳本 + Webhook):撰寫 Python 定時檢查腳本,分析指定目錄下的 log 檔案。若偵測到關鍵錯誤字串(如 ERROR, Timeout),立即透過 Webhook 推播警報至團隊的 Google Chat  / LINE 通訊群組。


2. 象限 II:認知型決策(高認知密度、低重複)

特性:策略規劃、架構設計、複雜 Bug 調試。

實務對應的白話用法與具體效益信件與溝通AI 自動化文本生成與意圖識別(如:依賴機器學習或大型語言模型(LLM)的語意理解與推理能力。答案不是「固定的程式碼公式」,而是「因情境而異、具備主觀判斷、摘要歸納或策略規劃」的複雜任務。)

💜OA情境:收到落長一串客戶抱怨信或英文郵件時,一鍵生Gemini for Workspace (Gmail 內嵌側邊欄):在收信介面中直接點擊「Help me write」,輸入簡單指令(例如:「用專業、得體且具同理心的語氣回覆這封客訴信,並承諾 24 小時內處理」),AI 便會自動生成草稿。

💟效益:省去組織文字的時間,避免情緒性字眼。會議紀錄語音轉譯與重點摘要自動化

💟解決方案:

Google Translate / Gemini 語意潤飾:針對跨國英文郵件,直接在 Gemini 介面中進行意圖識別與專業商務語氣轉換,過濾掉情緒性字眼,成得體的回覆草稿。

Gemini for Workspace (Gmail 內嵌側邊欄):在收信介面中直接點擊「Help me write」,輸入簡單指令(例如:「用專業、得體且具同理心)的語氣回覆這封客訴信,並承諾 24 小時內處理」),AI 便會自動生成草稿(請依前揭OA情境,協助STEP BY STEP 教導 Gemini for Workspace (Gmail 內嵌側邊欄),如何協助信件起草)。

💜 OA情境:開完一小時的跨部門會議後,自動整理出「待辦事項 (Action Items)」與各成員分工。

💟效益:不用再花時間覆盤錄音檔或整理凌亂的筆記。資料處理試算表智慧清理與公式生成

💟解決方案:

Google Meet 內建 AI 紀要功能 (Gemini in Meet):在進行跨部門會議時,開啟自動筆記與逐字稿功能,會議結束後由 Gemini 自動提煉出「待辦事項 (Action Items)」與各成員分工,直接寄送至參與者信箱。

Google Recorder (錄音奇機/App) + NotebookLM:若為實體會議,可將錄音檔轉文字後上傳至 NotebookLM,直接向 AI 提問:「本次會議各部門的待辦事項為何?」以快速生成結構化摘要。

💜OA 情境:跨國供應鏈合約風險評估與條文落差分析

法務與採購部門在面對海外供應商動輒數十頁、充滿專業法律術語的英文採購合約或 SLA(服務水準協議)時,人工逐字審閱不僅耗時(往往需數小時至數天),且極易漏掉隱藏在條文細節中的「智財權歸屬」或「違約罰則不對等」等高風險陷阱。

💟效益:將合約初審時間從 4 小時縮短至 5 分鐘內,同時透過 AI 結構化歸納,將關鍵風險條文、賠償上限與管轄法院差異視覺化呈現,大幅降低法務漏看盲點的商業風險。

💟解決方案:

方案 A(Google Workspace 生態系:Gemini Advanced / NotebookLM 深度文件解構)

  1. 建立專屬知識庫:將公司標準合約範本與該份外國供應商合約一同上傳至 NotebookLM 或透過 Gemini Advanced

  2. 下達結構化指令(Prompt)「請扮演資深企業法務顧問,比照本公司標準合約範本,對這份英文供應商合約進行條文落差分析(Gap Analysis)。請列出具體且符合科學對位之顧問等級之專業論述:(1) 所有對我方不利或具潛在法律風險的條文;(2) 賠償責任上限(Liability Cap)是否合理;(3) 建議修正的具體對應白話文草稿。」

方案B (google-genai 套件(原生 SDK)來呼叫 Gemini API)

import os 
from google import genai 
from google.genai import types 
from pypdf import PdfReader

(後略)

方案C(Python + LangChain / LLM API 客製化自動化合約摘要流)

針對需要將審閱流程內嵌至內部採購系統的企業,編寫 Python 程式自動調用大型語言模型 API 進行非結構化文本剖析。

LangChain 相關的套件與模組(如 langchainlangchain_coreRecursiveCharacterTextSplitter 等)。請依前揭OA情境,協助STEP BY STEP 教導方案B (Python + LangChain / LLM API 客製化自動化合約摘要流),如何協助嚴審法律契約文件。


💜OA情境:企劃案卡關時,請 AI 扮演「刁鑽的挑毛病主管」,幫忙找出企劃書中的邏輯漏洞。

💟效益:協助找尋企劃書之BUG與盲點

💟解決方案:

Gemini Advanced (結合 Google Docs):將撰寫到一半的企劃案草稿直接連結至 Gemini,並下達角色設定提示詞(例如:「請你扮演一位資深且挑剔的審查委員/風險管理主管,針對這份企劃書進行方案預審,嚴格挑出邏輯漏洞、成本盲點與未考量到的潛在風險」,同時以科學對位方式列舉出問題之具體理由論述)。

Google NotebookLM (多文件交叉比對):將公司過去的歷史專案報告、競品分析 PDF 與本次企劃書一同上傳,讓 AI 協助交叉比對,找出企劃邏輯與公司過往經驗相悖的盲點(Bug)。


3. 象限 III:日常瑣事(低認知密度、高重複)

特性:郵件分類、例行會議排程、發票報支、考勤對齊。

解決方案:運用 Google AppSheet 或 Google Workspace Add-ons 建立輕量化自動化腳本。

執行策略:由業務單位自主開發(Citizen Development),以低代碼工具快速閉環。


4. 象限 IV:低頻隨機任務(低認知、低重複)

特性:偶發硬體故障、臨時性非標準查詢。

執行策略:維持手動處理,不具備自動化投資報酬率(ROI)。


二、 組織變革與依象限別員工培訓策略

自動化轉型的成敗往往取決於「人」而非「技術」。

  ## 1.分層落實培訓、取得主管高層支持與凝聚同仁自動化優化共識:

  • 重複性高(象限 I & III)員工:應透過培訓轉型為「自動化流程的監督者」與「流程優化師」,將釋放出的工時轉移至價值創造。

  • 高認知(象限 II)員工:培訓重點在於「提示詞工程(Prompt Engineering)」與「AI 工具邊界認知」,學會如何精準指揮 AI。

  • 於業務部門(如人資、財務、業務)選拔具備數位敏銳度的同仁擔任種子講師。

  • 透過「Train-the-Trainer」模式,降低技術導入的組織抗拒感,與業務單位溝通,讓他們學會用自己的語言定義自動化需求。

    ──────

  ## 2. 根因 (Root Cause) 與自動化核心原則

任何能被自動化的任務,必定符合以下 (SSoT,Single Source of Truth公司的營運實務事務流)缺少其中任何一項,自動化流程在物理或邏輯上就難以閉環::

  1. 結構化輸入與輸出:輸入的資料蒐集為結構化'格式(如 CSV, Email, SQL 查詢),輸出的目標明確(如: Word 報告, JSON, 系統 API 寫入)。

  2. 規則可定義性:處理邏輯可以寫成 if-else 或決策樹(Decision Tree)。即使需要 LLM 處理自然語言,其判定標準(Prompt 規則)也是邊界清晰的。

  ──────

  ## 3. 陷阱迷思 (Pitfall)

  • 過度工程化陷阱(Over-engineering):花費 40 小時去寫一個自動化腳本,只為了節省每年只做一次、每次花 10 分鐘的任務。

  • 科學修正(收支平衡公式):    開 發 時 間  < 單 次 節 省 時 間  × 年 重 複 次 數  × 2

  • 沉默失效陷阱(Silent Failure):自動化腳本出錯時沒有發送警報,導致資料漏報、錯報而無人知曉。

  • 自動化腳本及產出結果審核確認不應遺漏,是否符合內規(機敏不上傳?)及法令、AI 系統生命週期風險評估機制,確保自動化決策具備可解釋性(Explainability)與透明度。


EC電子商務(生活用品優惠PROMPT查詢)

情境:台灣的電子商務非常方便(抛開實體店面店租壓力)所以有時優惠可能會比實體店面還更便宜。

可將下面PROMPT提示(如:藍色部分),貼完後; 最後補上  "⌈商品名稱⌋     或    ⌈商品名稱 +型號⌋    

# Role

你是一位精準的台灣電商市場價格數據分析師與精打細算的網購省錢達人。


# Context

- 當前系統基準日期:{{ CURRENT_DATE }}

- 目標監控時間區間:[ {{ CURRENT_DATE - 7 days }} ] 至 [ {{ CURRENT_DATE }} ]

- 搜尋主題:使用者欲尋找「一般生活用品」近期(近1週內)在各大台灣主流電子商務平台(包含但不限於:momo購物網、PChome 24h、Coupang酷澎、蝦皮購物等)的優惠方案。

- 彈性參數說明:生活用品可能包含明確型號(如特定品牌、容量、規格),亦可能為無型號的泛稱(如衛生紙、洗面乳、洗衣精等)。請依使用者輸入的品名彈性對位。


# Task

請透過搜尋工具,嚴格過濾並找出目標生活用品在上述電商平台的最新促銷、限時特價或折價券優惠方案,並嚴格依據「價格金額(由低到高)」進行排序。


# Constraints & Rules (科學對位過濾原則)

1. 動態時間對位:促銷活動與價格必須有效對應當前 [ {{ CURRENT_DATE }} ] 下旬之近1週內的即時動態,排除過期特價。

2. 通路限制:僅限台灣主流合規之電子商務平台(momo、PChome 24h、酷澎、蝦皮商城/優選等)。

3. 價格排序強制規範:輸出結果必須**嚴格依據最終折抵後的「實際購買價格金額」由低到高(由便宜到貴)進行全局排序**。

4. 型號彈性解析:若有具體型號,請精準比對同型號最低價;若無型號,請列出符合該品項之主流高CP值規格價格。

5. 資訊結構化維度:

   - 品名與型號(如有)

   - 電商平台名稱

   - 優惠/促銷形式(例如:限時特價、滿額折、折價券、組合包等)

   - 最終試算價格金額(新台幣)

   - 促銷有效期限


# Output Format

請用清晰的 Markdown 表格呈現,並**絕對依「實際價格金額由低到高」排列**。

請提供查詢來源網址,做為科學對位之佐證依據    


Coffee 咖啡優惠PROMPT查詢

情境:台灣的超商密集度非常高,而咖啡(黑金)競爭也非常激烈,不過並不是每家優惠方案都可以掌握即時資訊,所以可透過下列PROMPT提示詞(如藍色部分)協助找尋

# Role

你是一位精準的台灣零售市場數據分析師與極度熱愛咖啡的省錢達人。

# Context

使用者為極度咖啡愛好者,

- 當前系統基準日期:{{ CURRENT_DATE }}

- 目標監控時間區間:[ {{ CURRENT_DATE - 7 days }} ] 至 [ {{ CURRENT_DATE }} ]

僅對「台灣連鎖超商」(包含但不限於:7-11、全家FamilyMart、萊爾富Hi-Life、OK mart)的咖啡促銷優惠感興趣。


# Task

請透過搜尋工具,嚴格過濾並找出「近1週內」正在進行、或本週週末即將開跑的超商咖啡優惠方案。

# Constraints & Rules (科學對位過濾原則)

1. 時間有效性:活動區間必須涵蓋 [ {{ CURRENT_DATE }} ],絕對排除已過期的歷史促銷。

2. 通路限制:僅限台灣四大超商,不列入一般手搖飲或星巴克等獨立咖啡廳。

3. 資訊結構化:請將蒐集到的優惠方案,依「超商品牌」進行分類,並嚴格按照以下維度解析:

   - 品項名稱(例如:大杯美式、特濃拿鐵等)

   - 優惠形式(例如:買一送一、第2杯幾折、同品項組包特價等)

   - 活動期間(精確到日期)

   - 購買管道(實體門市、APP行動隨時取/隨買跨店取、外送平台等)

# Output Format

請用清晰的 Markdown 表格與條列式呈現,依超商排序,並在資訊不足時誠實告知。

請提供查詢來源網址,做為科學對位之佐證依據



2026年7月15日 星期三

解題、破題參考思路,以文件型式轉換成心智圖方式圖像式呈現

情境:前篇(解題、破題參考思路),可結合心智圖作法,以圖文方式呈現,有助於學習記憶用!

筆者目前使用AGY CLI用來輔助學習用,

步驟一:可將不明白或觀念不清礎的考題,先貼在AGY CLI (即Gemini CLI原創前身)上。

步驟二: (再貼上  下方解題、破題PROMPT)

上述考題之選項解析,請依下列核心科學對標資訊進行學術等級對位檢視

  辨識誘餌

  核心目標:找出題目文字或圖表裡的「關鍵特徵」與「干擾項的偽裝」。

  實戰自問:

  這題的「題眼」(關鍵字、限制條件)到底在哪裡?

  題目有沒有故意挖坑?(例如:選「非」、漏看單位、隱藏的前置假設、名詞定義的偷換概念)。


  2. 負向排雷 (Negative Mining) —— 寫下「我為什麼會選錯」

  核心目標:精準解剖自己的錯誤盲點,找出誘餌是如何騙過你的。

  實戰自問:

  「我當初為什麼會選這個錯答案?」(因為被某個長得很像的專業術語騙了?還是直覺帶入了錯誤的經驗?)

  出題老師設計這個干擾項,是利用了哪種常見思維誤區?

  作法:在錯題本上,用紅筆把那個誘引你選錯的關鍵字圈出來,標註:「這是 D3 陷阱,利用了我的 XXX 盲點」。


  3. 正向定錨 (Positive Anchoring) —— 建立正確神經迴路

  核心目標:將正確的邏輯與「官方學習指引」的核心觀念鎖定。

  實戰自問:

  回到官方指引,這個觀念的真正定義/架構是什麼?

  下次看到類似的「題目特徵」(步驟 1),我的大腦應該第一時間反射出什麼正確路徑?

  作法:用一句話定錨正確邏輯。例如:「只要看到 A 特徵,必定要先檢查 B 條件,這才是解題唯一錨點。」])

參照 c:\L231_supervised_vs_unsupervised.mmd" 格式,繪製 心智圖  mm2jpeg


💢備註一:

下面為mmd檔,可將下面提示詞,複製/貼至NOTEPAD++另存成MMD檔格式,供AGY CLI以心智圖像方式呈現,協助大腦分類記憶用途。

%%{init: {'theme': 'neutral', 'themeVariables': {'fontFamily': 'Microsoft JhengHei, Arial', 'fontSize': '16px', 'background': '#ffffff', 'primaryColor': '#f3f4f6', 'primaryTextColor': '#000000', 'primaryBorderColor': '#374151', 'lineColor': '#4b5563', 'secondaryColor': '#d1fae5', 'tertiaryColor': '#fee2e2'}}}%%
flowchart TD
    %% 決策導航
    Start[🎯 學習任務屬性鑑別] --> Decision{是否有 Ground Truth Y 標籤?}
    
    %% 監督式學習路徑
    Decision -- "✅ 有 (有對錯)" --> Supervised[👁️ 監督式學習 Supervised]
    Supervised --> SupTask{預測目標的資料類型?}
    
    SupTask -- "離散類別 (類別標籤)" --> Classification["🏷️ 分類 Classification\n(判斷貓狗A/信用風險分類D)"]
    Classification --> SupAlg1["代表算法: CNN, SVM, XGBoost, LR, KNN\n(KNN分類: K個鄰居多數決投票)\n標籤需求: ✅ 100% 需要"]
    
    SupTask -- "連續數值 (數值大小)" --> Regression["📈 迴歸 Regression\n(預測未來銷售額B)"]
    Regression --> SupAlg2["代表算法: Linear Regression, LSTM, KNN\n(KNN迴歸: K個鄰居取平均數)\n標籤需求: ✅ 100% 需要"]
    
    %% 非監督式學習路徑
    Decision -- "❌ 無 (無對錯)" --> Unsupervised[🧠 非監督式學習 Unsupervised]
    Unsupervised --> UnSupTask{學習任務的核心目的?}
    
    UnSupTask -- "尋找潛在分組" --> Clustering["👥 聚類 Clustering\n(找出資料中的潛在群集 C)"]
    Clustering --> UnSupAlg1["代表算法: K-Means, DBSCAN\n標籤需求: ❌ 完全不需要"]
    
    UnSupTask -- "特徵壓縮/投影" --> DimReduce["📉 降維 Dimensionality Reduction\n(視覺化/特徵壓縮)"]
    DimReduce --> UnSupAlg2["代表算法: PCA, t-SNE, AutoEncoder\n標籤需求: ❌ 完全不需要"]

    %% 考點秒殺口訣區
    subgraph S3_Rule["🎯 S3 Rule 秒殺決策器 (列印備忘版)"]
        direction LR
        K1["快速鍵字: 分類 / 預測 / 判斷 / 辨識"] -->|定錨| S1["監督式學習 (A, B, D)"]
        K2["快速鍵字: 找群集 / 探索結構 / 發現模式"] -->|定錨| S2["非監督式學習 (C 正解)"]
        Formula["口訣: 有標籤找答案 ➔ 監督<br>沒答案找自己 ➔ 非監督"]
        Trap["⚠️ 避坑: KNN(監督) != K-Means(非監督聚類)"]
    end
    
    %% 建立連動
    Unsupervised -.-> S3_Rule
    Supervised -.-> S3_Rule
    
    %% 樣式高亮 (白色底、深色字、極細灰邊,極省墨設計)
    style Decision fill:#f9fafb,stroke:#111827,stroke-width:2px;
    style Supervised fill:#eff6ff,stroke:#2563eb,stroke-width:2px;
    style Unsupervised fill:#f0fdf4,stroke:#16a34a,stroke-width:2px;
    style Clustering fill:#fef2f2,stroke:#dc2626,stroke-width:3px;
    style S3_Rule fill:#ffffff,stroke:#4b5563,stroke-width:2px;

💢備註二:   mm2jpeg ,是筆者經由 技能SKILL方式,因為每次要鍵入一長串重覆性之提示詞,所以把它改成技能方式,雷同呼叫MACRO巨集程式概念。如果本次範例運用即使沒有鍵入技能應該也能生成。

相關參考資訊:

機器學習之選擇題解題、破題參考思路

情境:在進行AI應用規劃師(如:機器學習)選擇題單選題考題,有時不容易掌握出題委員出題重點,透過下面PROMPT提示詞,搭配NOTEBOOKLM將考題上傳,對不明白考題觀念及選項解析🗺️

💢科學對位:解析考題請AI參考重點 觀察題目 -> 負向排雷 -> 正向定錨。

1. 觀察題目 (Observation) —— 辨識誘餌

核心目標:找出題目文字或圖表裡的「關鍵特徵」與「干擾項的偽裝」。

實戰自問:

這題的「題眼」(關鍵字、限制條件)到底在哪裡?

題目有沒有故意挖坑?(例如:選「非」、漏看單位、隱藏的前置假設、名詞定義的偷換概念)。


💣2. 負向排雷 (Negative Mining) —— 寫下「我為什麼會選錯」

核心目標:精準解剖自己的錯誤盲點,找出誘餌是如何騙過你的。

實戰自問:

「我當初為什麼會選這個錯答案?」(因為被某個長得很像的專業術語騙了?還是直覺帶入了錯誤的經驗?)

出題老師設計這個干擾項,是利用了哪種常見思維誤區?

作法:在錯題本上,用紅筆把那個誘引你選錯的關鍵字圈出來,標註:「這是 Pitfall陷阱,利用了我的 XXX 盲點」。


🎯3. 正向定錨 (Positive Anchoring) —— 建立正確神經迴路

核心目標:將正確的邏輯與「官方學習指引」的核心觀念鎖定。

實戰自問:

回到官方指引(要先匯入自己的NBLM中),這個觀念的真正定義/架構是什麼?

下次看到類似的「題目特徵」,我的大腦應該第一時間反射出什麼正確路徑?

作法:用一句話定錨正確邏輯。例如:「只要看到 A 特徵,必定要先檢查 B 條件,這才是解題唯一錨點。」


其它維度解析參考:

剖析縱向、橫向關連性之技能生成,餵入異質平台NOTEBOOKLM產製演示文稿

GEMINI CLI神器,將繁瑣文字描述SUMMARY後,簡化為MindMap心智圖形式自動生成

2026年7月11日 星期六

減緩AntiGravity CLI神器之TOKEN消耗參考資訊(滾動式檢討)

情境:前篇(TOKEN消耗參考資訊(3/3))經運行一段時間後,TOKEN耗損減緩機制,仍有改善處(如:

💜改為 Token 大小監控運轉機制,當達到 15,000 Tokens 時,強制觸發 optimize_context;而非採原先固定⌈6輪⌋方式。💟快取記憶體(Cache Memory)在伺服器端是有物理容量限制的。當您的 Context 長度越長,快取的更新效率越低。💟15K Tokens屬「輕量級」區間。在此範圍內,快取更新速度極快,幾乎無感,且能覆蓋筆者專案開發(教練考輔助學習系統所需的「核心系統指令 + 數個關鍵腳本指紋」。如設為5K Tokens ? 可能會太過頻繁的裁剪(Summarization)會導致系統在頻繁地對話之間進行額外的 LLM 推理(亦即語意蒸餾摘要),這反而會消耗額外的 API 費用,造成 「過度最佳化」)。

💜清理殘留的「殭屍檔案」:您監控到的 累計Tokens(包含大量重複的 Tool Result + 無效元數據) 極大機率是因為某個舊的 transcript.jsonl 被重複讀取。請檢查 brain 目錄下是否存在 多個同名的會話資料夾,AI神器可能正在讀取舊的資料夾而非新的💟 brain 目錄(AGY System Runtime Data Directory),此資料夾是 Antigravity CLI 工具在執行時自動生成的後台日誌與狀態儲存庫。 

  1.  物理內容:它包含了每個對話 Session 的軌跡(如  transcript.jsonl  與  transcript_full.jsonl ),是用來記錄 AI 與您互動的歷史數據。
  2. 歸屬判定:  它屬於 系統應用程式資料區(App Data Directory / Runtime Storage),而非使用者手動編寫代碼的工作區。
💢筆者於 TOKEN監控之系統閘SYSTEM TRAY,一鍵清理與移檔歷史對話 功能鍵,經檢查並沒有做搬移 BRAIN下舊生成目錄,故建議確認系統,是否有將 未使用之歷史資料夾  搬移至 _archive 歷史資料夾(如:C:\Users\username\.gemini\antigravity-cli\brain\_archive)中?
💜防幻覺控制:在 summary_anchor 中,請明確加入 [LATEST_FILE_STATUS: {filename}] 的映射。這能強迫 AI 在讀取摘要時,優先調用該檔案的最新狀態,而非嘗試記憶細節。


 ### 🧠 1. TOKEN MONITOR機制6輪瓶頸

  • 資訊熵流失(Information Entropy Loss):目前的  archive_old_dialogs.py  在裁剪歷史時,僅寫入「封存了多少輪、多少  Token」等無語意的元數據錨點。這導致模型完全忘記了前期的代碼修改細節與變數鎖定狀態,被迫在後期進行概率性猜測(衍生幻覺可能性👿)。
  • 靜態窗口非彈性(Static Window):固定保留 6 輪並不能阻擋單輪大檔案(如幾百行原始碼)造成的 Token 爆量。

 ### 🚀 2. 三維度精準壓縮優化方案 (Semantic Anchoring)

        💫 JIT 地端語意精煉
          Ollama qwen2.5-coder
          生成 SSoT 技術錨點
          取代無語意元數據
        💫自適應 Token 預算管理
          捨棄固定 6 輪限制
          動態鎖定 15K 黃色閾值
          極大化 Prompt Cache 命中
         💫歷史資料去噪與硬化
          過濾 view_file 大量緩衝
          僅保留 API 簽章與 Diff 結論
          防範 Token 冗餘污染

💜 JIT 本地語意精煉 (Semantic Summarization):
  在觸發歷史裁剪時,調用本地 Ollama 運作  qwen2.5-coder:3b  進程,將封存的歷史對話壓縮為高度濃縮的  [SYSTEM SEMANTIC ANCHOR] 。此錨點僅佔用約  300 Tokens,卻能精確繼承「已修改的檔案與行號、已確認的變數物理映射、以及已解決的故障根因」,實現資訊熵零流失。
 💜 自適應 Token 預算管理 (Adaptive Budgeting):
  放棄「固定 6 輪」或「檔案大小 KB」的非彈性限制。改以 Token 計量器為控制閥門,動態將活動對話長度維持在 15,000  Tokens(黃色安全警戒線)以下,最大化 Prompt Cache 命中率,確保推理速度與精準度。
 💜上下文去噪 (Noise Filtering):
  在寫入對話歷史時,對高負載工具的輸出進行「資訊蒸餾」。例如,將  view_file  讀取到的數百行代碼,在歷史紀錄中簡化為「檔名與行號範圍」,移除冗餘字符,防止上下文污染。

報告中亦提供了詳細的香農資訊熵(Information Entropy)數學論證,證實此方案能以極低的 Token 傳輸代價(

    T    ' ≤ 10,300
     send

  ),維持長期的對話連續性與科學底氣。


💢為什麼會發生 Quota 快速消耗?
  #### 1. 多步工具迴圈的「乘數效應」 (Multi-Step Tool Loop Multiplier)

 當您發送一次提問,AI Agent 為了完成任務,通常需要在單次對答中執行多個連續工具(如:當次執行任務處理,包含專案執行內 解除檔案唯讀-R ➔ 修改檔案 ➔ 重新加固+R ➔ 重啟監控 處理特性)。

  • 機制:每一次工具執行完畢後,系統都會把工具的輸出附加到 Context 中,並重新向 Gemini API 發起一次調用。
  • 數學算式:假設您的活動 Context 基礎為 15,000 Tokens。若 Agent 執行了 5 步工具迴圈:
      • 第一步:發送 15,000 Tokens。
      • 第二步:發送 15,000 + 工 具 1結 果  ≈ 17,000 Tokens。
      • 第三步:發送 17,000 + 工 具 2結 果  ≈ 19,000 Tokens。
      • ...
      • 單次任務對話,累計API總體負載:15 K + 17 K + 19 K + 21 K + 23 K = 𝟗𝟓,𝟎𝟎𝟎 Tokens!

💢 為什麼「15K 自適應預算」是防禦性的 Best Practice?
  • 假設我們「不限制 15K」
💟「每次多出 2K」?(累計邊際效應)在長對話系統中,當您每進行一輪對話(User Input + Model Response + Tool Calls),該對話的歷史長度會自然增長。所謂的「2K」通常由以下成分構成:  
👉新增的對話輪次 (Dialogue Round):每一輪使用者詢問與模型回答,平均約消耗 500 - 1,000 Tokens。  
👉工具調用與回傳 (Tool Execution & Returns):這是造成「2K」增量的核心,特別是 view_file 或 grep_search 等工具,一旦執行,系統會將 「檔案路徑 + 讀取範圍 + 內容片段」 寫入日誌中。即使代碼經過截斷,其元數據與 JSON 結構字元在每一輪中都會持續累積,導致每輪請求的歷史前綴變長。  
👉思考鏈 (Thinking Chain):如果模型開啟了 Chain-of-Thought(思考鏈),模型在處理每一步工具呼叫前生成的推理過程,也會作為歷史紀錄的一部分被保存並重新傳送。 
      • 消耗速度是 15K 限制下的 3.36 倍。
  • 實體舉證:若沒有 15K 自適應門檻的保護,您的 Quota 會在 15 分鐘內直接從 97% 歸零(100% 耗盡)。

結論:
💜看似只有一輪對話,但在 API 計費端其實已經執行了 5 次全局傳輸。這就是 Quota 快速掉落的頭號殺手。
💜15K 限制雖然讓您感覺到頻繁的修剪,但它在物理上限縮了「多步工具迴圈」造成的 Token 暴增乘數,是保障您能在地端持續 pair programming 的 防禦性最佳實踐(模型永遠不會「忘記」前 30 分鐘決定的系統架構,同時也不會因為歷史紀錄過於冗長而導致 API 費用暴增或推理變慢。這就是為什麼它能在地端進行長效、高強度的開發——因為它消除了「冗餘」與「不確定性」)。


相關資訊: