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 编码助手转化为一个动画像素艺术办公室，让开发者无需将任何数据发送到机器外，即可一目了然地查看活动、令牌使用和工具状态。