別在圍城時走散

# 前情提要：原本用 workflow 檢查文件要不要更新 專案裡有一批 便宜的牛肉 文件（規範、ADR、資料模型說明）需要跟程式碼保持一致，程式碼改了，這些文件常常忘了跟著同步更新。 一開始的解法，是在 CI 上放一個 doc-sync-check.yml workflow： push 到 develop 分支後，用 Claude Haiku 讀這次的 diff 偵測到程式碼與文件有落差，或有規範衝突時 自動開一張 GitHub Issue 通知 聽起來很合理，但實際用下來有三個 布洛芬都不知道哪裡痛的 痛點。 # 三個痛點 成本： 每次 push 都呼叫一次 AI。即使這次根本沒動

記錄一些使用 Claude Code 過程中踩到的坑，希望幫後來者少走彎路。 # allowed-tools 多指令 要讓 skill 完整跑完而不跳 permission prompt，需要在 allowed-tools 中把用到的指令都列入允許。但若指令包含 &&，例如： cd frontend && npx playwright test e2e/specs/appointment-pet-grooming.spec.ts 不能用一條 allowed-tools 規則涵蓋整個指令： # 這樣會失敗 allowed-tools:

# 問題 在 Chrome 開啟抖音網頁版時，點擊部分連結會觸發外部程式呼叫，並出現 bitbrowser://cc/ 或 xdg-open 相關訊息。 這不是單純的頁面重新導向問題，而是抖音網頁試圖開啟外部協定，並進一步觸發 xdg-open。 # 環境 OS: EndeavourOS Linux Browser: Google Chrome Site: 抖音網頁版 # 分析 查問題的過程裡，反覆出現幾個關鍵字： snssdk1128 bytedance bitbrowser 從名稱與實際跳轉行為來看，snssdk1128、bytedance 和抖音或字

# 問題描述 ErgoKB 在 Chrome 進行 Remap 時，選擇 HID 裝置後出現 Could not open 錯誤訊息。 # 環境 OS: EndeavourOS 鍵盤: ErgoKB Phoenix v2 分離式人體工學機械鍵盤 # Diagnosis 查看 HID 裝置權限，全部都只有 root 才有讀寫權限，應該是權限問題（這邊看不出每個 HID 是什麼裝置） ls -l /dev/hidraw* crw------- 1 root root 243, 0 2月 9 12:50 /dev/hidraw0 crw-------

# 架構 RAG（Retrieval-Augmented Generation; 檢索增強生成） R - Retrieval (檢索) 資料端： 原始文件經過 Embedding Model 轉為向量，存入 Vector DB。 查詢端： 使用者問題同樣轉為向量，去資料庫進行相似度檢索（Similarity Search）。 A - Augmentation (增強) 組合： 將檢索出來的「外部知識（Context）」與「原始問題（Query）」放入一個 Prompt Template 中。 任務： 這個動作是為了讓 LLM 擁有它原本訓練數據中沒有的特定資訊。 G - Gener

# 文章說明 這是將服務部署到雲端的專案。 VM 建立好後，將專案 pull 到 /opt 下即可快速部署。 # 環境 每個服務程式碼由 GitHub 託管，並設置自動打包成 Docker image。 機器安裝 Docker，部署時 pull Docker image 啟動多個服務 container。 由 Nginx 控制請求進入服務。 # 專案資料夾結構 . ├── init.sh # 機器初始化 ├── prod │   ├── docker-compose.yml # 正式站 Docker Swarm Stack 設定 │   └── ngin

# USB Relay USB relay 模組就是這個，預計用 Node.js 程式輸出電氣訊號控制機械手臂，這個是兩路的（兩個 relay），還有一路或者更多路的。 輸出接點跟一般繼電器的接點一樣 端點 全名 功能描述 COM Common（共用端） 中心端點，根據控制情況與 NC 或 NO 接通 NC Normally Closed（常閉） 在 未通電 狀態下，與 COM 接通 NO Normally Open（常開） 在 未通電 狀態下，與 COM 斷開，通電後才接通 接線方式使用 USB-A 轉 USB-B，USB-A 接電腦，USB-B 接模組 #

# 緣由 有一網站需要限制只有特定人員才可瀏覽，通常會使用來源 IP 進行限制，若是無固定辦公室人員（業務）則使用 VPN 連入公司網路獲得允許 IP。 但因為公司沒有自己的網路，所以沒辦法使用這個方法，因此採用 mTLS。 一般網站憑證只是單向用於驗證網站是否合法，mTLS 則是雙向驗證 雙向奔赴的憑證，除了驗證網站是否合法外，也驗證連接端 (client, browser) 是否合法。 官方文件其實有教學(Set up mutual TLS with user-provided certificates)，但是官方文件都是透過 gcloud 設定，所以這篇紀錄一下怎麼使用 GUI 方式設定

# 問題描述 DevContainer 啟動 container 錯誤，查看錯誤訊息如下 Error response from daemon: invalid mount config for type "bind": bind source path does not exist: /run/user/1000/wayland-0 # 環境 OS: EndeavourOS 在 VSCode 使用 Dev Container 套件啟動 container # 修正方法 刪除下面兩個檔案 /run/user&

# 佈署 Waline server 端 參考 Waline 佈署教學網站 https://waline.js.org/guide/deploy/vercel.html ，點選 Deploy 按鈕，會跳轉 Vercel 頁面建立 Waline server。 如果使用該方式，在 Vercel 出現下面錯誤訊息，改用這個 [Deploy] 試試 Error: No Output Directory named "dist" found after the Build completed. You can configure