C#中WinForm ListView 列表控件实用指南
2026-10-15 3467904
2026-10-12 0
在日常使用 Claude、Codex 等 AI 编程工具时，用量数据往往分散在不同客户端中。Juejin Usage 提供了一个本地优先的桌面面板，并允许通过宠物包扩展桌面形象。下面将从客户端安装开始，说明首次同步流程，以及自定义宠物所需的目录、配置文件和图集规格。
下载安装包 · 排行榜 · 常见问题 · 用户隐私协议 · 稀土掘金
Juejin Usage 提供 macOS / Windows 桌面客户端，安装即用，无需额外配置。
前往 Releases 页面下载对应系统的安装包（macOS 按芯片选 .dmg，Windows 选 .exe），安装即用。
? macOS 提示「已损坏」？在终端执行
sudo xattr -dr com.apple.quarantine后把应用拖入终端窗口即可。
如未检测到 Claude / Codex 等 Agent 工具，请确认已安装并使用过至少一次。
在面板「设置」中点击「桌面宠物」，打开 「显示桌面宠物」，提供 3 个可选的宠物
| Click | Yoyo | Hawking |
|---|---|---|
| (./assets/click.png) | (./assets/yoyo.png) | (./assets/hawking.png) |
在「设置 → 桌面宠物」中，应用会自动从仓库拉取社区宠物列表；未安装的项可点「下载」安装到 ~/.ai-usage/pets/。也可点击「打开宠物目录」手动放入自定义包。每次打开设置都会扫描本地目录；设置保持打开时，可点击「刷新」重新读取本地并同步远程列表。列表会显示每只宠物的 idle 预览；校验失败的包会标为「无效」且不可选。每只宠物使用独立子目录，结构如下：
pets/
└── my-pet/
├── pet.json
└── spritesheet.webp
首版仅支持 v2 动画包：spritesheet.webp 必须是 8×11 格、每格 192×208 px 的 1536×2288 WebP 图集。尺寸不对时可在仓库根执行 node pets/normalize-spritesheet.mjs <图集路径>（需 ImageMagick、带 libwebp 的 ffmpeg，或 cwebp + ffmpeg/sips）强制拉伸到目标尺寸——仅用于通过校验；正确动画仍需按格子导出。pet.json 示例：
{
"id": "my-pet",
"displayName": "我的宠物",
"description": "自定义桌面伙伴",
"spriteVersionNumber": 2,
"spritesheetPath": "spritesheet.webp",
"glow": { "primary": "#7c8cff", "accent": "#69d4ff" }
}
id 必须唯一，不能和内置宠物重名；删除或替换素材后重新打开设置，或点击「刷新」即可生效。早期测试版位于应用数据目录的宠物包不会自动迁移，请手动移入 ~/.ai-usage/pets/。
在面板「设置」中点击「掘金登录」，绑定账号后可：
需要 Node.js >= 20。macOS / Windows / Linux 安装后后台启动即可打开本地面板：
npm i -g @juejin-opensource/jusage
jusage service start
# 面板: http://127.0.0.1:8452
国内网络较慢可用 npm i -g @juejin-opensource/jusage --registry=https://registry.npmmirror.com/。完整命令、选项与数据说明见 CLI 使用说明。
前往 掘金 AI 使用排行榜 查看排名。
本产品采用本地优先架构，数据默认仅存储于您的设备。
~/.ai-usage/，云端鉴权采用加密 Token除了上报您使用的用量总数外，不会采集您任何信息。
具体内容前往点击查看用户隐私协议: 《稀土掘金用户隐私协议》
需要 Node.js >= 20。克隆后先在仓库根执行 pnpm install。
如 pnpm install 卡在 electron postinstall
Electron 二进制默认从 GitHub Releases 拉取；国内网络可能会超时
请在安装前设置环境变量：
# Git Bash / macOS / Linux
export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
export ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
pnpm install
# PowerShell
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"
pnpm install
源码按 Desktop / CLI / Web 三端贡献。分支规范与本地启动见 Contributing Guide。
感谢各位掘友们的贡献支持！? 提交 PR 即可上榜
