AICM v2.1

AiCodeMirror 桌面托盘余额助手

常驻 Windows 托盘 / macOS 菜单栏，快速查看余额、套餐、API Key 用量、模型消耗和公告。

---

✨ 亮点

能力	说明
余额速览	展示总余额、订阅余额、按量余额、套餐类型和剩余天数
用量分析	按 Claude / Codex / Gemini 查看近 48 小时用量趋势、记录数和 Token 统计
API Key 管理	聚合 API Key 消耗，支持快速跳转官网管理页
公告入口	自动抓取最新公告标题，点击直达官网公告页
邀请码	展示邀请码并支持一键复制邀请链接
外观自定义	可调整主题色、面板透明度、面板高度，设置自动保存
刷新策略	支持 5 到 3600 秒的刷新频率配置，也可手动立即刷新
检查更新	从 GitHub Releases 检查最新版本，有新 Release 即提示更新
跨平台体验	Windows 托盘弹层、macOS 菜单栏文字模式均已适配

🖼️ 界面预览

Windows

主面板	主题设置
右键快捷菜单

macOS

主面板	主题设置
菜单栏文字模式

🚀 安装使用

如果只是日常使用，不需要本地构建，直接前往仓库的 Releases 页面 下载对应安装包即可。

系统	安装包	说明
Windows x64	.exe	适合大多数 Intel / AMD Windows 设备
Windows arm64	.exe	适合 ARM Windows 设备
macOS x64	.dmg	适合 Intel Mac
macOS arm64	.dmg	适合 Apple Silicon Mac

使用步骤：

1. 启动应用后，程序会常驻系统托盘或菜单栏。
2. 首次使用会自动打开 AiCodeMirror 登录页。
3. 登录成功后，应用会自动同步余额、套餐、邀请码、API Key、模型价格和用量数据。
4. 左键点击托盘 / 菜单栏图标展开主面板。
5. 右键点击图标打开快捷菜单，可刷新、调整主题、检查更新、清除登录态或退出应用。

🧩 平台差异

Windows

• 左键点击系统托盘图标展开主面板，右键打开快捷菜单。
• 为减少透明无边框窗口闪烁，Windows 版默认不使用全透明窗体。
• 面板透明度通过窗口级透明度实现；在支持的 Windows 11 环境中会额外尝试启用 Acrylic 背景材质。
• Windows 托盘仅显示图标，不支持像 macOS 菜单栏那样显示余额文字。

macOS

• 应用运行在顶部菜单栏。
• 支持 AICM、总余额、关闭文字 三种菜单栏文字模式。
• 保留透明窗口和菜单栏弹层交互，适合快速查看账户状态。

🔄 检查更新

应用会通过 GitHub 最新 Release 判断是否有新版本：

• 启动后自动检查一次。
• 运行中每 6 小时自动检查一次。
• 也可以在主面板或右键菜单中手动点击「检查更新」。
• 如果发现新 Release，按钮会变为「下载更新」，点击后打开 GitHub Release 下载页。

🛠️ 本地开发

npm install
npm start

如遇到个别机器透明窗口渲染异常，可以尝试关闭 GPU 加速后启动：

AICM_DISABLE_GPU=1 npm start

📦 打包命令

# Windows
npm run build:win
npm run build:win:x64
npm run build:win:arm64

# macOS
npm run build:mac
npm run build:mac:x64
npm run build:mac:arm64

打包产物会输出到 dist/ 目录。

⚠️ 未签名包说明

当前安装包未做代码签名，可以正常使用，但首次打开时系统可能弹出安全提醒。

macOS

• 如果提示“无法验证开发者”或“无法检查是否包含恶意软件”，先关闭弹窗。
• 在应用图标上点击右键，选择“打开”。
• 如果仍被拦截，前往“系统设置 → 隐私与安全性”，在底部找到被拦截的应用并点击“仍要打开”。

Windows

• 如果出现“Windows 已保护你的电脑”提示，点击“更多信息”。
• 然后点击“仍要运行”即可继续安装。

建议将未签名包用于自测、内部试用或小范围分发。若需要公开分发，建议补充代码签名以减少系统拦截提示。

🧱 技术栈

• Electron
• Electron Builder
• session.fetch 复用应用内登录会话
• 原生 Tray / Menu Bar 交互
• GitHub Releases 更新检查

💬 联系方式

如需反馈问题、定制功能或进一步交流，可扫码添加微信：

📄 License

MIT