作品集與筆記

Haowei Chan

我打造實用的網頁產品與 AI 系統，記錄學到的東西，並把專案、技術筆記與小型實驗公開整理在這裡。

閱讀所有文章查看 GitHub

精選作品

專案

TinBoker — AI 語音與 Podcast 知識庫平台

結合非結構化語音轉寫、LangGraph 多 Agent 狀態圖與多層快取的 AI 原生內容處理系統。

React 19TypeScriptViteFastAPIPython 3.12LangGraphRedisDockerCaddy

核心亮點與架構細節

  • 多 Agent 拓撲分工：過濾廣告贊助、依長度動態合併章節、提煉 3-8 條關鍵洞察。
  • Step-by-step Checkpoints：儲存 Raw / Checkpoint / Serving 三層狀態，支援失敗重播 (rerun_from)。
  • 高效能快取：FastAPI + Redis 記憶體快取，搭配 Single-Flight 鎖防範快取擊穿。
造訪網站GitHub 專案技術文章 (上)技術文章 (下)

Kuroshio — 開源 Quantamental 投資組合引擎

多因子選股、LLM Agent 個股研究與 IPS 驅動的再平衡提案：它只排序、辯論與提案，永遠不下單。

Python 3.11+Multi-Agent ResearchIPS Policy EngineBacktestApache-2.0

核心亮點與架構細節

  • Screen：美股與台股多因子動能篩選，以橫斷面百分位給分，把不同市場放在同一把尺上比較。
  • Research：每檔持股跑一次 LLM Agent 研究，facet 級快取讓每日執行的成本以美分計而非美元。
  • Propose：挑戰者對決最弱持股的換股提案，每張卡片都引用觸發它的 IPS 條款——用資源競爭取代二元否決。
GitHub 專案線上 Demo

Hermes Agent — 常駐型個人 AI 助理系統

雙入口（Discord 聊天視窗 + 排程器）、純文字 Vault 記憶與自動化資產追蹤的個人駐守助理。

Python 3.11Discord GatewayCron SchedulerObsidian VaultGit SweeperShioaji APISchwab API

核心亮點與架構細節

  • 頻道即角色 (Channel-as-Persona)：將 Discord 頻道劃分為黑潮交易檯 (#trading)、研報庫 (#reports)、產業分析 (#research)。
  • 自動化資產追蹤：每日定時解密元大電子對帳單 PDF、呼叫 Schwab/Shioaji API，計算 T+2 未交割款並自動繪製資產曲線。
  • 單一 Git Sweeper：寫檔與 Git 操作分離，定時自動 commit/push，杜絕多端寫入衝突。
hermes-desk (排程層開源)助理架構文章資產追蹤文章Hermes Agent (上游)

TaifexDesk — 台指期／股期／選擇權交易基礎設施

回測、模擬盤與實單執行共用同一套引擎的台灣期貨交易系統：Python + FastAPI 後端、React 戰情室儀表板、shioaji 券商轉接層。

PythonFastAPIReactShioajiBacktestingPaper TradingRisk Engine

核心亮點與架構細節

  • 訊號與執行分離：策略只是 entry / add / stop 三個 policy 的組合，引擎負責執行、從不產生決策 — 所以引擎能開源，策略不必。
  • Bar 內停損檢查：從 OHLC 重建盤中價格路徑，最低價跌破停損就算出場，消除只看收盤價回測的系統性樂觀偏誤。
  • 單一成本模型：回測、模擬與實單共用同一份手續費與稅金計算，成本隨指數變動，不會隨行情漂移。
GitHub 專案

最新發布

Blog

每個節點都回報成功，成品還是錯的：內容 Pipeline 的「局部成功」偵查

讀者說「每一篇都有不少錯字」，但那個月 pipeline 沒有任何一個節點失敗過。六個缺陷，沒有一個是失敗：全都是某個元件正確完成了它被交代的工作、回傳 200，然後在它沒被交代的那一寸出錯。以及我因此加進 review 清單的那個問題：這個成功訊號，是承重的嗎？

Agent 系統軟體工程

我如何用「預先聲明 + 三道閘門」建立因子研究的內控制度：一套避免自己騙自己的流程

研究者自由度是量化研究最大的敵人。從預先聲明、正交前篩、閘門 A、中性化階梯到前瞻影子簿：一套實際跑了一年多、也實際被自己違反過幾次的內控流程。它不保證賺錢，只保證結果是假的時候看得出來。

量化研究

雲端退場最後一哩：把 140GB 媒體檔和所有 Secrets 搬回自己的 VPS

大體積不可變檔案與高敏感小體積設定，是資料庫遷移沒覆蓋到的兩極：存儲層原地替換、secrets 三層解析順序、半成品考古學，以及「export → 異地備份 → 核對 → 才刪」的刪除紀律。

軟體工程

從文件資料庫搬回 PostgreSQL：我的六階段資料層退場方法論

把一場「動所有讀寫路徑」的遷移，切成六個可以獨立上線、獨立回滾的階段：同介面替換、雙寫安全網、停寫作為唯一的不可逆點，以及對抗審查抓出的十四個生產級炸彈。

軟體工程

當雲端帳單一夜暴漲二十倍：一次資料庫流量失血的完整偵查紀錄

帳單從幾百元變成四萬多，沒有人入侵——每一分錢都是自己的程式碼花掉的。從總金額一路下鑽到函式名的五層偵查法，以及「payload × 距離」為什麼比讀取次數更貴。

軟體工程

從對帳單 PDF 到多帳戶權益數：我如何用 Python + Cron 打造自動化資產與研報追蹤系統

個人常駐助理系列：解密加密 PDF 對帳單解析、多經紀商 API 串接、T+2 交割款時差計算與自動化券商研報爬蟲系統設計。

Agent 系統量化研究

我的個人助理不是 chatbot

用 Hermes Agent 蓋一個常駐、會自己開口的個人助理：六個讓它不像聊天機器人的特性、Hermes 的 agent 機制聰明在哪，以及它變得可信的那一天。

Agent 系統

FastAPI + Redis：高讀取量 API 的快取分層設計

全端產品架構系列：並非所有 API 都適用相同的 TTL。如何結合 Edge CDN、Redis 記憶體快取與 Cache-Aside 模式應對 Cache Stampede 並提升系統吞吐量。

軟體工程

Dev / Staging / Production：小團隊也需要的環境分層策略

環境分層不是大型公司的儀式，而是一個降低發布風險的設計模式：如何透過 Branch-to-env 映射、Preview Deploys、Secrets 隔離與生產環境 Release Guardrails 提升發布可靠性。

軟體工程

如何設計一條可靠的 Agentic Ingestion Pipeline (下)：Step-by-step Checkpoints、推理解算溢出與防寫閘實戰

生產環境實戰：Step-by-step Checkpoints 重播機制、推理模型 Token 截斷防禦、寫入前強校驗防寫閘與併發預算控制。

Agent 系統

如何設計一條可靠的 Agentic Ingestion Pipeline (上)：從單一 Prompt 瓶頸到 LangGraph 多 Agent 協作圖譜

從單一 Prompt 瓶頸到 LangGraph 多 Agent 協作：非結構化財經 Podcast 語音與逐字稿 Pipeline 的解耦與拓撲設計。

Agent 系統