@raingor/pi-web-switch 0.4.1 → 0.4.2

package/README.ja.md

@@ -88,17 +88,32 @@ npm run build  # プロダクションビルド
 
 ## 🖥️ デスクトップアプリ（Electron）
 
-pi-web-switch はデスクトップアプリ（macOS / Windows / Linux）としても利用でき、専用ブランドアイコンを備えています。
+pi-web-switch は **macOS メニューバーアプリ**（および Windows/Linux トレイアプリ）としても利用可能 — アプリはメニューバーに常駐し、トレイアイコンのクリックで使用量サマリー（今日の tokens / コスト / リクエスト数 + 7 日間の sparkline + Top プロバイダ）がポップアップします。フルダッシュボードはトレイメニュー or ダブルクリックで開けます。
 
 ```bash
-# 開発モードで実行（Vite 開発サーバー + Electron、HMR 対応）
+# 開発モードで実行（Vite 開発サーバー + Electron、HMR 寂応）
 npm run electron:dev
 
-# インストーラー（DMG / NSIS / AppImage）を release/ にビルド
+# インストーラー（macOS DMG+ZIP / Windows NSIS / Linux AppImage）を release/ にビルド
 npm run electron:build
+
+# パッケージ化せずプロダクションビルドをプレビュー
+npm run electron:preview
 ```
 
-アプリアイコンは `build/`（`icon.icns` / `icon.ico` / `icon.png`）にあり、プラットフォームごとに electron-builder へ組み込まれています。開発モードでは実行時に macOS の Dock アイコンを設定します。
+### 🍹 macOS メニューバーモード
+
+パッケージ化された macOS アプリは **メニューバー専用アプリ** として実行 — Dock に表示されず、`Cmd+Q` でトレイメニューから終了。`electron-builder` の `extendInfo` で `LSUIElement = true` を設定して実装。開発モード（`electron:dev`）では Dock アイコンが表示されます（この Info.plist キーはパッケージビルドにのみ適用）。トレイアイコンは両モードで動作します。
+
+| トレイ操作 | 動作 |
+|------------|------|
+| クリック | 使用量ポップアップの切替（今日 + 7 日 tokens / コスト / リクエスト数、sparkline、Top プロバイダ） |
+| 右クリック | コンテキストメニュー：Dashboard を開く、使用量を更新、終了 |
+| メニュー → "開く Dashboard" | フル React Dashboard ウィンドウを開く |
+
+ポップアップは表示中 30 秒ごとに自動更新。トレイアイコンは 32×32 template PNG（`build/trayIconTemplate.png`）で明暗メニューバーに自動適合；`npm run tray:icon` で再生成。
+
+アプリアイコンは `build/`（`icon.icns` / `icon.ico` / `icon.png`）にあり；開発モードでは実行時に `public/icon-512.png` から macOS の Dock アイコンを設定します。
 
 ## 🏗️ 技術スタック
 
@@ -124,9 +139,12 @@ pi-web-switch は **pi コーディングエージェント拡張** としてイ
 
 | コマンド | 説明 |
 |---------|------|
-| `/pi-web-switch start` | ダッシュボード起動 http://localhost:5173 |
-| `/pi-web-switch stop` | サーバー停止 |
-| `/pi-web-switch status` | 実行状態を確認 |
+| `/pi-switch start` | ダッシュボード起動 http://localhost:5173 |
+| `/pi-switch stop` | サーバー停止 |
+| `/pi-switch status` | 実行状態を確認 |
+| `/pi-usage` | 使用量サマリー（今日 + 7 日）を端末に印字 — tokens / コスト / リクエスト数 / デイリー sparkline、ダッシュボード起動不要 |
+
+`/pi-usage` コマンドは `~/.pi/agent/sessions/*.jsonl` を直接読み込み、今日 + 直近 7 日の統計を集約します。どの pi セッションからでも一目で使用量を確認可能。macOS メニューバーポップアップと同じ内容を表示します。
 
 ### パッケージ構造
 
@@ -134,12 +152,18 @@ pi-web-switch は **pi コーディングエージェント拡張** としてイ
 pi-web-switch/
 ├── package.json           # npm パッケージ + pi.extensions + pi.skills
 ├── pi-package/
-│   ├── index.ts           # 拡張エントリ：/pi-web-switch コマンド登録
+│   ├── index.ts           # 拡張エントリ：/pi-switch、/pi-usage コマンド登録
 │   └── skills/
 │       └── pi-web-switch/
 │           └── SKILL.md   # 使用ドキュメント
 ├── server/
 │   └── pi-reader.ts       # サーバーサイド：~/.pi/agent/ 読み取り
+├── electron/              # デスクトップアプリ（macOS メニューバー / トレイ）
+│   ├── main.ts            # メインプロセス：トレイ、ポップアップ、IPC、ローカル API サーバー
+│   ├── api-server.ts      # ローカル HTTP サーバー（パッケージ版で dist/ + /api/pi/* を提供）
+│   ├── preload.ts         # contextBridge：settings/auth/models/usage IPC
+│   ├── popup.html         # メニューバー使用量ポップアップ
+│   └── popup-render.ts    # ポップアップ描画（今日/7 日 tokens、sparkline、Top プロバイダ）
 └── src/                   # React フロントエンド
 ```
 

package/README.md

@@ -139,17 +139,32 @@ The dev server automatically serves pi configuration via Vite middleware at `/ap
 
 ## 🖥️ Desktop App (Electron)
 
-pi-web-switch also runs as a desktop app (macOS / Windows / Linux) with its own branded app icon.
+pi-web-switch also runs as a **macOS menu bar app** (and a Windows/Linux tray app) — the app lives in your menu bar, and a single click on the tray icon pops up a compact usage summary (today's tokens / cost / requests + a 7-day sparkline + top providers). The full Dashboard is still available from the tray menu or by double-clicking the tray icon.
 
 ```bash
 # Run in development (Vite dev server + Electron with HMR)
 npm run electron:dev
 
-# Build installers (DMG / NSIS / AppImage) into release/
+# Build installers (DMG + ZIP for macOS, NSIS for Windows, AppImage for Linux) into release/
 npm run electron:build
+
+# Preview the production build without packaging
+npm run electron:preview
 ```
 
-App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`) and are wired into electron-builder per platform; in development the macOS dock icon is set at runtime.
+### 🍹 macOS menu bar mode
+
+The packaged macOS app runs as a **menu bar-only** app — it does not appear in the Dock, and `Cmd+Q` quits from the tray menu. This is wired in via `LSUIElement = true` in `electron-builder`'s `extendInfo`. In dev (`electron:dev`) the Dock icon still shows because that Info.plist key only applies to packaged builds; the tray icon works in both modes.
+
+| Tray interaction | What happens |
+|------------------|--------------|
+| Click | Toggle the usage popup (today + 7d tokens / cost / requests, sparkline, top providers) |
+| Right-click | Context menu: open Dashboard, refresh usage, quit |
+| Menu → "打开 Dashboard" | Open the full React Dashboard window |
+
+The popup auto-refreshes every 30 seconds while visible. The tray icon is a 16×16 template PNG (`build/trayIconTemplate.png`) that adapts to light/dark menu bars; regenerate it with `npm run tray:icon`.
+
+App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`); in development the macOS dock icon is set at runtime from `public/icon-512.png`.
 
 ## 🏗️ Tech Stack
 
@@ -170,10 +185,21 @@ App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`) and are wired
 pi-web-switch/
 ├── index.html
 ├── package.json
-├── vite.config.ts          # Vite config + pi API plugin (middleware)
+├── vite.config.ts          # Vite config + pi API plugin (middleware) + popup entry
 ├── tsconfig.json
 ├── server/
 │   └── pi-reader.ts        # Server-side module: reads ~/.pi/agent/ files + parses sessions
+├── electron/               # Desktop app (macOS menu-bar / tray)
+│   ├── main.ts             # Main process: tray, popup window, IPC, local API server
+│   ├── api-server.ts       # Local HTTP server serving dist/ + /api/pi/* in packaged mode
+│   ├── preload.ts          # contextBridge: settings/auth/models/usage IPC
+│   ├── popup.html          # Menu-bar popup UI
+│   └── popup-render.ts     # Popup renderer (today/7d tokens, sparkline, top providers)
+├── scripts/
+│   └── generate-tray-icon.mjs  # Regenerates build/trayIconTemplate.png
+├── build/
+│   ├── trayIconTemplate.png    # 32x32 menu-bar template icon
+│   └── icon.icns / icon.ico / icon.png
 ├── public/
 │   └── pi.svg
 └── src/
@@ -224,7 +250,7 @@ Changes made in the UI are written back to these files in real time — the pi a
 
 ## 🧩 API Routes
 
-The Vite dev server exposes these endpoints at `/api/pi/*`:
+These endpoints at `/api/pi/*` are served by the Vite middleware in dev, and by the built-in HTTP server (`electron/api-server.ts`) in the packaged app — so the frontend works identically in both modes:
 
 | Method | Path | Description |
 |--------|------|-------------|
@@ -236,10 +262,29 @@ The Vite dev server exposes these endpoints at `/api/pi/*`:
 | POST | `/api/pi/models` | Write `models.json` |
 | GET | `/api/pi/builtin-providers` | List hardcoded built-in providers |
 | GET | `/api/pi/usage` | Aggregated token/cost/request data from sessions |
-| GET | `/api/pi/usage-range` | Date-range filtered usage with hourly/daily breakdown |
+| GET | `/api/pi/usage-range` | Date-range filtered usage (pi sessions) — `?range=today\|7d\|30d\|custom&from=&to=` |
+| GET | `/api/pi/all-usage-range` | Same shape, but combined across **all** sources (pi + cindy + claude + codex + atomcode + copilot) |
+| GET | `/api/pi/{cindy-pi\|claude\|codex\|opencode\|gemini\|grok\|atomcode\|copilot}-usage-range` | Per-source usage range |
+| GET | `/api/pi/copilot-usage-range` | Local Copilot CLI usage from `~/.copilot/session-store.db` (tokens / requests per day per model; no GitHub API or token required) |
+| GET | `/api/pi/copilot-config` | Read Copilot GitHub config (username, token) |
+| POST | `/api/pi/copilot-config` | Write Copilot GitHub config |
 | GET | `/api/pi/sessions` | Session list grouped by project |
-| DELETE | `/api/pi/session?path=` | Delete a session file (path must be under sessions/) |
+| DELETE | `/api/pi/session?path=` | Move a session file to trash (path must be under sessions/) |
+| POST | `/api/pi/session/trash` | Move a session to trash (body: `{ path }`) |
+| POST | `/api/pi/session/restore` | Restore a session from trash (body: `{ trashPath }`) |
+| GET | `/api/pi/session-preview` | Preview session messages — `?path=` |
+| GET | `/api/pi/trash` | List trashed sessions |
+| DELETE | `/api/pi/trash?path=` | Permanently delete a trashed session |
 | GET | `/api/pi/memory` | Read MEMORY.md, USER.md, failures.md |
+| POST | `/api/pi/memory/delete-entry` | Delete a memory entry (body: `{ filename, text }`) |
+| GET | `/api/pi/subagents` | Read subagent run history |
+| GET | `/api/pi/check-updates` | Check pi package updates |
+| POST | `/api/pi/apply-updates` | Apply package updates (body: `{ names }`) |
+| POST | `/api/pi/provider-test` | Test a provider connection (body: `{ baseUrl, apiKey }`) |
+| POST | `/api/pi/provider-models` | Fetch a provider's live model list (body: `{ baseUrl, apiKey, providerId }`) |
+| POST | `/api/pi/model-test` | Test a model (body: `{ baseUrl, modelId, apiKey, apiType }`) |
+
+All `-usage-range` endpoints accept `&refresh=1` to force a rescan, bypassing the 30-second session cache (the Dashboard refresh button sends this).
 
 ## 📦 Pi Package
 
@@ -263,9 +308,12 @@ Once installed, the following commands are available in your pi session:
 
 | Command | Description |
 |---------|-------------|
-| `/pi-web-switch start` | Launch the dashboard at `http://localhost:5173` |
-| `/pi-web-switch stop` | Stop the server |
-| `/pi-web-switch status` | Check if the dashboard is running |
+| `/pi-switch start` | Launch the dashboard at `http://localhost:5173` |
+| `/pi-switch stop` | Stop the server |
+| `/pi-switch status` | Check if the dashboard is running |
+| `/pi-usage` | Print a quick usage summary (today + 7 days) in the terminal — tokens / cost / requests / daily sparkline, without launching the dashboard |
+
+The `/pi-usage` command reads `~/.pi/agent/sessions/*.jsonl` directly and aggregates today + last-7-days stats, so you can see your usage at a glance from any pi session. It mirrors what the macOS menu bar popup shows.
 
 ### Package Structure
 

package/README.zh-CN.md

@@ -126,17 +126,32 @@ npm run preview # 预览生产构建
 
 ## 🖥️ 桌面应用（Electron）
 
-pi-web-switch 同样提供桌面应用（macOS / Windows / Linux），并带有专属品牌图标。
+pi-web-switch 同样提供 **macOS 菜单栏应用**（以及 Windows/Linux 托盘应用）—— 应用驻留在顶部菜单栏，点击托盘图标即可弹出使用量摘要（今日 tokens / 成本 / 请求数 + 7 天 sparkline + Top 提供商）。完整仪表盘仍可从托盘菜单或双击图标打开。
 
 ```bash
 # 开发模式运行（Vite 开发服务器 + Electron，支持 HMR）
 npm run electron:dev
 
-# 构建安装包（DMG / NSIS / AppImage）到 release/
+# 构建安装包（macOS DMG+ZIP / Windows NSIS / Linux AppImage）到 release/
 npm run electron:build
+
+# 不打包预览生产构建
+npm run electron:preview
 ```
 
-应用图标位于 `build/`（`icon.icns` / `icon.ico` / `icon.png`），已按平台接入 electron-builder；开发模式下会在运行时设置 macOS 程序坞图标。
+### 🍹 macOS 菜单栏模式
+
+打包后的 macOS 应用以 **纯菜单栏应用** 运行 —— 不出现在 Dock 中，`Cmd+Q` 从托盘菜单退出。通过 `electron-builder` 的 `extendInfo` 中 `LSUIElement = true` 实现。开发模式下（`electron:dev`）Dock 图标仍会显示（该 Info.plist 键仅对打包构建生效），托盘图标两种模式都可用。
+
+| 托盘交互 | 行为 |
+|----------|------|
+| 点击 | 切换使用量弹窗（今日 + 7 天 tokens / 成本 / 请求数、sparkline、Top 提供商） |
+| 右键 | 上下文菜单：打开 Dashboard、刷新使用量、退出 |
+| 菜单 → "打开 Dashboard" | 打开完整 React Dashboard 窗口 |
+
+弹窗可见时每 30 秒自动刷新。托盘图标是 32×32 template PNG（`build/trayIconTemplate.png`），自动适配明暗菜单栏；用 `npm run tray:icon` 重新生成。
+
+应用图标位于 `build/`（`icon.icns` / `icon.ico` / `icon.png`）；开发模式下会在运行时从 `public/icon-512.png` 设置 macOS 程序坞图标。
 
 ## 🏗️ 技术栈
 
@@ -162,9 +177,12 @@ pi-web-switch 可安装为 **pi 编码代理扩展**，在 pi 会话中直接启
 
 | 命令 | 说明 |
 |------|------|
-| `/pi-web-switch start` | 启动仪表盘 http://localhost:5173 |
-| `/pi-web-switch stop` | 停止服务器 |
-| `/pi-web-switch status` | 查看运行状态 |
+| `/pi-switch start` | 启动仪表盘 http://localhost:5173 |
+| `/pi-switch stop` | 娶止服务器 |
+| `/pi-switch status` | 查看运行状态 |
+| `/pi-usage` | 在终端打印使用量摘要（今日 + 7 天）—— tokens / 成本 / 请求数 / 每日 sparkline，无需启动仪表盘 |
+
+`/pi-usage` 命令直接读取 `~/.pi/agent/sessions/*.jsonl` 并聚合今日 + 最近 7 天统计，让你在任何 pi 会话中一眼看到使用量。它与 macOS 菜单栏弹窗显示的内容一致。
 
 ### 包结构
 
@@ -172,12 +190,18 @@ pi-web-switch 可安装为 **pi 编码代理扩展**，在 pi 会话中直接启
 pi-web-switch/
 ├── package.json           # npm 包 + pi.extensions + pi.skills
 ├── pi-package/
-│   ├── index.ts           # 扩展入口：注册 /pi-web-switch 命令
+│   ├── index.ts           # 扩展入口：注册 /pi-switch、/pi-usage 命令
 │   └── skills/
 │       └── pi-web-switch/
 │           └── SKILL.md   # 使用文档
 ├── server/
 │   └── pi-reader.ts       # 服务端：读取 ~/.pi/agent/ 文件
+├── electron/              # 桌面应用（macOS 菜单栏 / 托盘）
+│   ├── main.ts            # 主进程：托盘、弹窗、IPC、本地 API 服务器
+│   ├── api-server.ts      # 本地 HTTP 服务器（打包模式提供 dist/ + /api/pi/*）
+│   ├── preload.ts         # contextBridge：settings/auth/models/usage IPC
+│   ├── popup.html         # 菜单栏使用量弹窗
+│   └── popup-render.ts    # 弹窗渲染（今日/7 天 tokens、sparkline、Top 提供商）
 └── src/                   # React 前端
 ```