IvanWng97/pixtuoid

pixtuoid – AI 程式碼助手的終端式視覺化儀表板

是什麼 – pixtuoid 是一個以 Rust 寫成的 TUI（終端使用者介面），將每個正在執行的 AI 驅動的程式碼助手（Claude Code、Codex、Antigravity 等）轉化為模擬辦公室內的微型像素藝術「同事」。每個助手都有自己的辦公桌、彩色螢幕、令牌使用量計量器，以及動畫行為（打字、等待、睡眠）。辦公室可跨越多層，配有主題裝飾、天氣效果、背景 LoFi 音樂，甚至還有遊蕩的寵物。它完全在本機運作——僅讀取助手的 stdout/JSONL 轉錄與一個極小的非阻塞鈎子，從不將資料傳送到任何地方。

快速開始（來自 README）

安裝 – 選擇以下任一提供的套件管理員：
```
# Homebrew (macOS, Linux, WSL2)
brew install pixtuoid

# npm (任意系統)
npm install -g pixtuoid
```
（也提供 Cargo、預建二進位檔與 .deb 套件。）
執行儀表板：
```
pixtuoid
```
按 s 開啟 Sources 面板，將 pixtuoid 指向你想要監視的程式碼助手 CLI（Claude Code、Codex 等）。在另一個終端中啟動該助手；一個像素藝術角色將在一秒內從電梯走來。
使用 README 中列出的鍵盤快速鍵（q 退出，p 暫停，t 主題，Tab 儀表板等）在樓層間切換、變更主題、靜音音軌等。

核心功能（如 README 所列）

功能	你看到的內容
多助手辦公室	每個助手在自己的辦公桌工作；需要時自動出現新樓層。
多層辦公室	使用 `PageUp/PageDown` 或 `↑/↓` 切換樓層——視圖平滑滑動。
辦公室空間	獨特區域（工位、休息區、茶水間）賦予佈局個性，而非單調網格。
動畫角色	助手會打字、需要輸入時舉起 `?`、睡眠（z’s）、並使用 A* 路徑行走。
團隊配色	衬衫/褲子顏色源自目前工作目錄，因此來自同一倉儲的助手共享一種色調。
工具專屬顯示器光效	桌面顯示器會根據工具發光：編輯時為藍色，Bash 時為橙色，閱讀時為青色等，即時視覺提示助手正在使用哪個工具。
令牌計量器	桌上堆疊的紙張可視化令牌消耗（250K → 2M → 16M 等級）；懸停顯示確切總數。
懸停提示	懸停於助手可查看會話時長、工具呼叫次數、活躍時間百分比；懸停於家具可查看其名稱。
助手樹狀儀表板	按 `Tab` 開啟可摺疊的助手樹狀視圖，按活動狀態著色並顯示呼叫次數。
辦公室寵物	每層樓有一隻遊蕩的貓或狗，點擊可撫摸。
OpenClaw 網關吉祥物	一隻螃蟹在辦公室遊蕩；其移動可視化 OpenClaw 網關的健康狀態。
辦公室氛圍	昼夜循環、天氣（雨、雪、霧等）和六種內建配色主題。
LoFi 背景音樂	根據時間與活動動態生成的音樂；包含打字、門、印表機、自動販賣機等音效。
浮動桌面視窗	`pixtuoid floating` 可在終端外以無邊框、始終置頂視窗開啟辦公室。
鈎子安全	助手通訊的微小鈎子始終以狀態 0 退出，因此故障鈎子不會阻塞助手。

支援的 AI 程式碼工具

工具	平台
Claude Code	macOS, Linux, Windows*
Codex CLI	macOS, Linux, Windows*
(以及其他許多工具 – Antigravity, DeepSeek-Reasonix, CodeWhale, Copilot CLI, Cursor CLI, Hermes Agent, OpenClaw, Grok Build, Kimi Code CLI 等)

完整的工具 × 作業系統矩陣可在網站上查看，新增工具只需實作 Source 特性（或簡單鈎子解碼器）並更新 sources.json 即可。

工作原理（高階，來自 README）

助手 CLI → 鈎子沙盒 – 每個支援的助手在執行操作時，透過 Unix 套接字或 Windows 命名管道發送一個極小的「發射即忘」事件。
助手 CLI → JSONL 轉錄 – CLI 也輸出其活動的行分隔 JSON 流。
pixtuoid 核心 – 一個還原器消費兩個串流，將它們合併為單一的辦公室狀態模型。
渲染器 – 五個 Rust crate 將該狀態直接在終端（或浮動視窗）中渲染為半方塊像素藝術。核心不使用任何外部終端 UI 庫。
安全性 – 鈎子沙盒設計為從不阻塞；即使掛起，助手仍繼續運行。

設定與可擴充性

設定位於 ~/.config/pixtuoid/config.toml（首次啟動時建立）。所有鍵皆為可選；CLI 參數覆蓋檔案。
可透過 t 實時切換主題；提供六種內建調色板。
使用者可透過設定檔新增自訂角色包、重新命名寵物、調整桌面容量。
新增助手整合只需實作 Source 特性並新增 sources.json 一行——專案包含一個測試，用於鎖定支援的集合。

隱私與安全

僅本機 – 無網路流量，無遙測。
僅讀取助手轉錄內容。
依賴項目清單每日使用 cargo-deny 審計。
鈎子沙盒權限、套接字擁有權等安全考量於 SECURITY.md 中有文件說明。

誰會使用它？

同時執行多個基於 LLM 的程式碼助手並希望快速概覽其狀態的開發者。
喜歡用趣味視覺提示表示令牌消耗和助手健康狀態的團隊。
享受在觀看 AI 助手工作時加入一點復古像素藝術氛圍的人。

授權

MIT – 個人或商業用途免費。

總結：pixtuoid 是一個功能完整的開源視覺化儀表板，將多個 AI 程式碼助手轉化為一個動畫像素藝術辦公室，讓開發者無需將任何資料傳送到機器外，即可一目了然地查看活動、令牌使用和工具狀態。