
Day27 [llm-wiki] 用 mod 裝飾我的 llm-wiki:我是如何強化我的 llm-wiki 儀錶板
接續 Day26,這篇寫 navi 這個 mod 的畫面設計:橫條、狀態列、輸入框、側邊面板各自負責一種注意力;統計分頁以「哪裡還沒連起來、哪裡值得再寫、書的概念流到哪些域」三個問題分區,每個數字旁邊都附一個只填不送的動作;趣味分頁放單篇事實。記錄每個畫面要我關注什麼、門檻怎麼定、以及看到畫面之後改掉的地方。

接續 Day26,這篇寫 navi 這個 mod 的畫面設計:橫條、狀態列、輸入框、側邊面板各自負責一種注意力;統計分頁以「哪裡還沒連起來、哪裡值得再寫、書的概念流到哪些域」三個問題分區,每個數字旁邊都附一個只填不送的動作;趣味分頁放單篇事實。記錄每個畫面要我關注什麼、門檻怎麼定、以及看到畫面之後改掉的地方。

Claude Code 新推出了 mod,我試著導入 llm-wiki。主軸是為什麼要用 mod:先分清 skill、hook、MCP、plugin、mod 各管什麼,再從最直觀的介面開始,在 session 裡畫出 vault 儀表板:側邊面板列出 TODO.md 未完成項與近期新增 wiki,點項目就把對應 skill 指令填進輸入框、點 wiki 頁直接在 Obsidian 開;面板下半部畫各域 wiki 數與 raw 堆積;輸入框上方的橫條放今日隨機三頁,狀態列放待辦/Inbox/本週新增數。接著往下看 mod 的 hook:旁觀、改寫、接手三種行為,以及它排在既有守門 hook 前面這件事。也記錄怎麼算「近期新增」、怎麼打開 Obsidian、mod 放在哪、raw 堆積的第一版為什麼不能用,以及幾個驗證錯誤。

原本只想把 Projects 收進 /blogs/ 變成一個小方塊、順便讓它有趣一點,結果 /blogs/ 的方塊排版前後改了四版:原本的卡片、貼紙牆、改成三欄放描述,最後在 Claude Design 跑了三輪定稿成「走去哪裡?」的奇異鳥徽章,描述改成 hover 才出現。記錄每一版為什麼被換掉、Projects 怎麼在不搬目錄的情況下出現在 /blogs/、新畫的工程師 kiwi,以及幾個坑:worktree 沒拉主題時 Hugo 照樣 build 出空白頁、hover 不會晃是因為 Windows 關了動畫效果、設計稿在 claude.ai 上讀不到、寫這篇截圖時才發現徽章在寬螢幕排成 5+3、字體跟全站不一樣。

Day19 定下的「每趟旅行是一個單一的 HTML」,用起來最困擾的是按上一頁就直接回總覽。這篇記錄把它翻掉的過程:為什麼光拆檔案沒用、要每個畫面都有網址;單一外殼加

指南升成主角之後,我拿手機實際用了一輪,丟給 Claude 一串體驗問題,第一條就是收回 Day21 做的「往下收、往上露」:「那個好卡,用一層就好了」。記錄這輪 UI 調整的取捨:固定哪一層(Claude 建議只固定頁首,我選頁首加日期列)、「← 總覽」收進選單還是整個拿掉、地區篩選要不要改下拉選單(地區要、類別不要),以及計畫被我退回六次、每次補了什麼。踩到的坑是為了壓低日期列把日期排成一行,最後一顆按鈕超出畫面 13px、整頁可以左右滑;之後「手機不能左右滑」寫成專案的硬規定,改版面前要在四種寬度量過。另外自動部署停住,改成手動部署。

旅行頁原本以「回來後的紀錄」為主,行前指南只是一個原樣保留的內嵌分頁;實際用下來我只看指南。這次的目標是四件事:少切頁面、打開就是當天的建議行程、旅途中記下去了哪就同步回指南(之後找店先列還沒去的,回來後的整理也直接在上面做)、頁首講清楚還剩幾天。記錄的取捨有:指南的分項攤平成頁首導覽、手機用漢堡選單(下拉選單被我否決),地點總表併進指南、新店只能加在清單尾端,頁首日期併進原本那一列、改成時間軸;另外用地址補座標的腳本把每家店畫進示意圖,太遠或沒座標的用虛線圈。踩到的坑有:合併時一刀切掉一個函式導致整頁空白、記住的舊分頁讓預設頁失效、平滑捲動讓切分項看起來沒反應、手機上一列塞不下日期、只靠店名幾乎查不到座標。

手機看行前指南時,頂部疊了三層固定列、約 190px。記錄為什麼選「往下滑收起」而不是壓縮高度、往上滑時再分兩段(滑一點只露出日期列,滑多才全部回來),為此破例改了說好原樣保留的指南樣式,以及讓收起不惱人的幾條規則:靠近頂端一定顯示、小於 8px 不判斷、捲到底的回彈不算往上滑、看不見的列鍵盤也碰不到。另一條線是地點總表的「吃」加上子分類與篩選按鈕:選項太少時 AI 可以上網補,但來源不明是隱憂,所以我改成自己丟資料給 Claude、由它查證與統整。

/projects/ 的卡片明明寫了 aspect-ratio,Art-Tracking 還是被一張直式截圖撐到 985px:封面是 column flex 的子項目,圖片的 height 100% 對不到確定的高度,修法是把圖片改成絕對定位。另外記錄封面比例選 4:3、手動 weight 排序、Archived 分區、自動連到最新一篇開發紀錄、為了漢堡選單複製一份 PaperMod header,以及上線後第二輪把小卡精簡、封面從截圖換成 icon。坑包括只讀 CSS 就誤判、漏一行 project 讓最新一篇指錯、背景分頁量到 0×0、拿掉一層包裝後標題被主題蓋成 24px。

新專案 travel-storage:跟 Claude 一起排行程,每趟旅行做成一個自含式 HTML,放成一個私人網站。這篇記錄旅行頁怎麼設計成「一頁走完一趟旅行」:模板照行前指南還是回來後的全紀錄、行程項目用 done/plan/skip 等狀態從計畫走到實際、行前指南原樣內嵌而不是拆掉重寫、總覽頁對還沒結束的旅行只給出發日期(網址也不帶地名)、旅途中「先在對話回選項,挑了才寫進頁面」的更新流程,以及離線快取的代價。

用 git 同步 vault 十天後的四個觀察:log 和 TODO 這種每個動作都會碰的檔一直衝突、手機能互動很實用、本機所有 session 都踩在 main 上互相卡住、GitHub 網頁可以直接當閱讀介面。今天一次 push 被另一個 session 沒 commit 的變更擋下來,於是把「每個 session 都開 worktree、不分任務大小」寫成規則,並用 SessionStart 與 PreToolUse 兩層 hook 擋住在主目錄寫檔。記錄過程中的取捨(為什麼不是看情況才開、為什麼保留 Obsidian 自動 pull、規則之外要不要用 hook 硬擋、收件重複要查 git 歷史還是另記一本帳、過期的決策檔怎麼刪),四個坑(hook 擋到自己要寫的另一個 repo、剛開的 worktree 被判成可清、log 同一個 hunk 混著兩個 session 的條目、在 worktree 裡長指令被拒),以及接下來要觀察的九件事。