@vibe-cafe/vibe-usage 0.9.0 → 0.9.1

package/README.md

@@ -31,6 +31,8 @@ npx @vibe-cafe/vibe-usage              # Init (first run, browser login) or sync
 npx @vibe-cafe/vibe-usage init         # Re-run setup via browser login
 npx @vibe-cafe/vibe-usage init --manual-key <vbu_...>   # Skip browser, use pre-issued key (CI/headless)
 npx @vibe-cafe/vibe-usage sync         # Manual sync
+npx @vibe-cafe/vibe-usage summary       # Print last 7 days as markdown (cost / tokens / by model / by project)
+npx @vibe-cafe/vibe-usage summary --days N  # Same, over the last N days (1-90)
 npx @vibe-cafe/vibe-usage daemon       # Continuous sync (every 30m, foreground)
 npx @vibe-cafe/vibe-usage daemon install    # Install background service (systemd/launchd)
 npx @vibe-cafe/vibe-usage daemon uninstall  # Remove background service

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-cafe/vibe-usage",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Track your AI coding tool token usage and sync to vibecafe.ai",
   "type": "module",
   "bin": {

package/src/index.js

@@ -132,6 +132,11 @@ export async function run(rawArgs) {
       await runSync();
       break;
     }
+    case 'summary': {
+      const { runSummary } = await import('./summary.js');
+      await runSummary(args.slice(1));
+      break;
+    }
     case 'reset': {
       printSmallHeader();
       const { runReset } = await import('./reset.js');
@@ -177,6 +182,8 @@ export async function run(rawArgs) {
     npx @vibe-cafe/vibe-usage init         Set up via browser login (default)
     npx @vibe-cafe/vibe-usage init --manual-key <vbu_...>   Skip browser, use a pre-issued key (CI/headless)
     npx @vibe-cafe/vibe-usage sync         Manually sync usage data
+    npx @vibe-cafe/vibe-usage summary       Print last 7 days as markdown (cost/tokens/model/project)
+    npx @vibe-cafe/vibe-usage summary --days N   Same, but over the last N days (1-90)
     npx @vibe-cafe/vibe-usage daemon       Continuous sync (every 30m, foreground)
     npx @vibe-cafe/vibe-usage daemon install    Install background service (systemd/launchd)
     npx @vibe-cafe/vibe-usage daemon uninstall  Remove background service

package/src/skill.js

@@ -33,53 +33,42 @@ function tildePath(absPath) {
 
 const SKILL_CONTENT = `---
 name: vibe-usage
-description: Track and sync AI coding tool token usage to vibecafe.ai dashboard.
+description: 查询和同步 AI 编程工具的 token 用量（VibeCafé 旗下 Vibe Usage 数据）。
 ---
 
 # Vibe Usage
 
-Track your AI coding tool token usage and sync to [vibecafe.ai](https://vibecafe.ai/usage).
+Track and answer questions about the user's AI coding token spend via [Vibe Usage](https://vibecafe.ai/usage) (VibeCafé).
 
-## Setup
+## 查询用量（默认行为）
 
-First-time setup (interactive — asks for API key):
+当用户问以下问题时，运行命令并**原样展示输出**（不要总结、不要换算单位、不要翻译）：
 
-\`\`\`bash
-npx @vibe-cafe/vibe-usage
-\`\`\`
+| 用户说... | 运行 |
+|---|---|
+| 我这周花了多少 / 查 usage / 看看消费 | \`npx @vibe-cafe/vibe-usage summary\` |
+| 今天花了多少 / 今天 token | \`npx @vibe-cafe/vibe-usage summary --days 1\` |
+| 本月花费 / 这个月用量 | \`npx @vibe-cafe/vibe-usage summary --days 30\` |
+| 哪个模型最贵 / 模型对比 | \`npx @vibe-cafe/vibe-usage summary\`（输出已按模型拆） |
+| 哪个项目花得最多 | \`npx @vibe-cafe/vibe-usage summary\`（输出已按项目拆） |
 
-Get your API key at https://vibecafe.ai/usage/setup
+输出是 markdown 表格，直接展示给用户即可。
 
-## Commands
+## 维护命令
 
-When the user asks to sync usage, check costs, or track tokens, run:
+| 用户说... | 运行 |
+|---|---|
+| 同步数据 / 上传 usage / 数据没更新 | \`npx @vibe-cafe/vibe-usage sync\` |
+| 看 daemon 状态 / 后台同步还在跑吗 | \`npx @vibe-cafe/vibe-usage daemon status\` |
+| 启动后台同步 | \`npx @vibe-cafe/vibe-usage daemon install\` |
+| 重置数据 / 重新上传 | \`npx @vibe-cafe/vibe-usage reset\` |
 
-\`\`\`bash
-npx @vibe-cafe/vibe-usage sync
-\`\`\`
+## 注意
 
-Other available commands:
-
-| Command | Description |
-|---------|-------------|
-| \`npx @vibe-cafe/vibe-usage sync\` | Sync latest usage data |
-| \`npx @vibe-cafe/vibe-usage status\` | Show config and detected tools |
-| \`npx @vibe-cafe/vibe-usage daemon\` | Continuous sync every 30 minutes |
-| \`npx @vibe-cafe/vibe-usage reset\` | Delete all data and re-upload |
-| \`npx @vibe-cafe/vibe-usage reset --local\` | Delete this host's data and re-upload |
-
-## When to Use
-
-- User says "sync my usage", "upload usage", "track tokens"
-- User asks "how much have I spent?", "what's my cost?"
-- User wants to check if sync is working: run \`status\`
-- User wants continuous background sync: run \`daemon\`
-
-## Notes
-
-- Requires initial setup with an API key (run \`npx @vibe-cafe/vibe-usage\` first)
-- Config is stored at \`~/.vibe-usage/config.json\`
-- Supports: Claude Code, Codex CLI, Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Qwen Code, Kimi Code, Amp, Droid
+- \`summary\` 读 \`~/.vibe-usage/config.json\` 里已有的 API key，不需要用户额外输入
+- summary 输出已是 markdown，**原样展示，不要复述**
+- 用户没装过 vibe-usage？提示运行 \`npx @vibe-cafe/vibe-usage\` 先用浏览器登录链接账号
+- 支持的工具：Claude Code, Codex CLI, Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Qwen Code, Kimi Code, Amp, Droid 等
 `;
 
 export async function runSkill(args = []) {
@@ -88,7 +77,7 @@ export async function runSkill(args = []) {
   console.log('  检测到的工具:');
   for (const t of SKILL_TARGETS) {
     const found = existsSync(t.detectDir);
-    const mark = found ? green('✓') : red('✗');
+    const mark = found ? green('[OK]') : red('[未装]');
     console.log(`    ${mark} ${t.name}`);
   }
   console.log();

package/src/summary.js

@@ -0,0 +1,146 @@
+import https from 'node:https';
+import http from 'node:http';
+import { URL } from 'node:url';
+import { loadConfig } from './config.js';
+
+export async function runSummary(args = []) {
+  const days = parseDays(args);
+  const config = loadConfig();
+  if (!config?.apiKey) {
+    console.error('No vibe-usage config found. Run `npx @vibe-cafe/vibe-usage init` first.');
+    process.exit(1);
+  }
+
+  const url = new URL('/api/usage', config.apiUrl || 'https://vibecafe.ai');
+  url.searchParams.set('days', String(days));
+
+  let data;
+  try {
+    data = await fetchJson(url, config.apiKey);
+  } catch (err) {
+    if (err.statusCode === 401) {
+      console.error('API key invalid or revoked. Run `npx @vibe-cafe/vibe-usage init` to re-link.');
+    } else {
+      console.error(`Failed to fetch usage: ${err.message}`);
+    }
+    process.exit(1);
+  }
+
+  console.log(render(data, days));
+}
+
+function parseDays(args) {
+  const idx = args.findIndex(a => a === '--days');
+  if (idx === -1) return 7;
+  const v = parseInt(args[idx + 1], 10);
+  if (!v || v < 1) return 7;
+  if (v > 90) return 90;
+  return v;
+}
+
+function render(data, days) {
+  const buckets = Array.isArray(data?.buckets) ? data.buckets : [];
+  const sessions = Array.isArray(data?.sessions) ? data.sessions : [];
+
+  if (buckets.length === 0) {
+    return `# Vibe Usage Summary (Last ${days} ${days === 1 ? 'day' : 'days'})\n\n暂无数据。运行 \`npx @vibe-cafe/vibe-usage sync\` 上传本地 token 记录。\n\n详情: https://vibecafe.ai/usage\n`;
+  }
+
+  let totalCost = 0;
+  let totalTokens = 0;
+  const byModel = new Map();
+  const byProject = new Map();
+
+  for (const b of buckets) {
+    const cost = Number(b.estimatedCost ?? 0);
+    const tokens = Number(b.totalTokens ?? 0);
+    totalCost += cost;
+    totalTokens += tokens;
+    accumulate(byModel, b.model, { cost, tokens });
+    accumulate(byProject, b.project || 'unknown', { cost, tokens, sessions: 0 });
+  }
+
+  const sessionsCount = sessions.length;
+  let activeSeconds = 0;
+  for (const s of sessions) {
+    activeSeconds += Number(s.activeSeconds ?? 0);
+    const proj = byProject.get(s.project || 'unknown');
+    if (proj) proj.sessions += 1;
+  }
+  const activeHours = activeSeconds / 3600;
+
+  const lines = [];
+  lines.push(`# Vibe Usage Summary (Last ${days} ${days === 1 ? 'day' : 'days'})`);
+  lines.push('');
+  lines.push(`**总览**: $${totalCost.toFixed(2)} · ${formatTokens(totalTokens)} tokens · ${sessionsCount} sessions · ${activeHours.toFixed(1)}h active`);
+  lines.push('');
+
+  lines.push('## 按模型');
+  lines.push('');
+  lines.push('| 模型 | 费用 | Tokens | 占比 |');
+  lines.push('|---|---:|---:|---:|');
+  for (const [model, { cost, tokens }] of topN(byModel, 'cost', 8)) {
+    const pct = totalCost > 0 ? ((cost / totalCost) * 100).toFixed(0) : '0';
+    lines.push(`| ${model} | $${cost.toFixed(2)} | ${formatTokens(tokens)} | ${pct}% |`);
+  }
+  lines.push('');
+
+  lines.push('## 按项目');
+  lines.push('');
+  lines.push('| 项目 | 费用 | Sessions |');
+  lines.push('|---|---:|---:|');
+  for (const [project, { cost, sessions: ss }] of topN(byProject, 'cost', 8)) {
+    lines.push(`| ${project} | $${cost.toFixed(2)} | ${ss} |`);
+  }
+  lines.push('');
+
+  lines.push('详情: https://vibecafe.ai/usage');
+  return lines.join('\n');
+}
+
+function accumulate(map, key, delta) {
+  const cur = map.get(key) || { cost: 0, tokens: 0, sessions: 0 };
+  for (const k of Object.keys(delta)) cur[k] = (cur[k] || 0) + delta[k];
+  map.set(key, cur);
+}
+
+function topN(map, sortBy, n) {
+  return [...map.entries()]
+    .sort((a, b) => b[1][sortBy] - a[1][sortBy])
+    .slice(0, n);
+}
+
+function formatTokens(n) {
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1) + 'M';
+  if (n >= 1_000) return (n / 1_000).toFixed(0) + 'K';
+  return String(n);
+}
+
+function fetchJson(url, apiKey) {
+  return new Promise((resolve, reject) => {
+    const mod = url.protocol === 'https:' ? https : http;
+    const req = mod.request(url, {
+      method: 'GET',
+      timeout: 15_000,
+      headers: { 'Authorization': `Bearer ${apiKey}` },
+    }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        if (res.statusCode === 401) {
+          const err = new Error('Unauthorized'); err.statusCode = 401; reject(err); return;
+        }
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+          const err = new Error(`HTTP ${res.statusCode}: ${data.slice(0, 200)}`);
+          err.statusCode = res.statusCode;
+          reject(err); return;
+        }
+        try { resolve(JSON.parse(data)); }
+        catch { reject(new Error('Invalid JSON response')); }
+      });
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('timeout (15s)')); });
+    req.end();
+  });
+}