@vibe-cafe/vibe-usage 0.10.19 → 0.10.20

package/README.md

@@ -35,7 +35,7 @@ npx @vibe-cafe/vibe-usage sync --extra-codex-home /path/to/.codex  # Add another
 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 install    # Install background service (systemd/launchd/Task Scheduler)
 npx @vibe-cafe/vibe-usage daemon uninstall  # Remove background service
 npx @vibe-cafe/vibe-usage daemon status     # Show background service status
 npx @vibe-cafe/vibe-usage daemon stop       # Stop background service
@@ -54,8 +54,8 @@ npx @vibe-cafe/vibe-usage status       # Show config & detected tools
 | Alma | Electron app-data `alma/chat_threads.db` (macOS: `~/Library/Application Support/alma/chat_threads.db`; fixture/relocation override: `VIBE_USAGE_ALMA_DB`). Reads the `usage_records` ledger plus workspace names without selecting chat bodies, message metadata, provider credentials, or full workspace paths. Provider-prefixed model identifiers are normalized to their final model segment. Cache writes are included in input usage. The ledger contains assistant responses only, so Alma emits token buckets without session timing. |
 | Claude Code + Claude Desktop Code/Cowork | Claude Code data in `~/.claude/projects/` (tokens + sessions) and `~/.claude/transcripts/` (sessions only), plus Claude Desktop Cowork's per-session `.claude/projects/` directories. Also scans `$CLAUDE_CONFIG_DIR` and data-bearing `~/.claude-*` profiles. All variants use the existing `claude-code` source; the parser selects the most complete copy of each session so shared/copied transcripts are not counted twice. Logs are streamed and cache creation tokens are included in input usage. |
 | Cindy | Per-owner SQLite ledgers in the two regional Electron user-data roots: macOS `~/Library/Application Support/{CindyGlobal,Cindy}/cindy-*.db`, Windows `%APPDATA%\{CindyGlobal,Cindy}\cindy-*.db`, Linux `${XDG_CONFIG_HOME:-~/.config}/{CindyGlobal,Cindy}/cindy-*.db` (fixture/relocation override: `VIBE_USAGE_CINDY_DIRS`). Cindy-launched Claude Code already writes ordinary `~/.claude` transcripts, so it remains attributed to **Claude Code** and is not read again. Cindy's otherwise-private Codex and Pi daily/model ledger rows augment the existing **Codex** and **pi** sources. Currency rows are summed and cache creation joins input; chat messages, credentials, costs, and owner ids are never selected. The ledger adds token buckets only, without project or session timing. |
-| Codex CLI | `$CODEX_HOME/sessions/` and `$CODEX_HOME/archived_sessions/` (default `~/.codex`), plus an optional temporary `--extra-codex-home` or manually persisted `codexExtraHome`; a versioned local index avoids re-reading unchanged rollouts and reads only safe append tails for ordinary sessions, while fork/sub-agent replay matching, duplicate suppression, and live/archive/cross-root deduplication retain their existing semantics |
-| Grok | `$GROK_HOME/sessions/<encoded-cwd>/<session-id>/` (default `~/.grok`); token usage from `updates.jsonl` `turn_completed.usage` (per-model `modelUsage`, cache reads, reasoning); project from `summary.json` cwd; honors `GROK_HOME` |
+| Codex CLI | `$CODEX_HOME/sessions/` and `$CODEX_HOME/archived_sessions/` (default `~/.codex`), plus an optional temporary `--extra-codex-home`, legacy `codexExtraHome`, or explicitly added Codex/Multica roots; a versioned local index avoids re-reading unchanged rollouts and reads only safe append tails for ordinary sessions, while fork/sub-agent replay matching, duplicate suppression, and live/archive/cross-root deduplication retain their existing semantics |
+| Grok | `$GROK_HOME/sessions/<encoded-cwd>/<session-id>/` (default `~/.grok`) plus explicitly added Grok Homes; token usage from `updates.jsonl` `turn_completed.usage` (per-model `modelUsage`, cache reads, reasoning); project from `summary.json` cwd; copied sessions keep the more complete local record |
 | GitHub Copilot CLI | `~/.copilot/session-state/*/events.jsonl` |
 | CraftAgent | `~/.craft-agent/workspaces/*/sessions/*/.pi-sessions/*.jsonl`; honors `$CRAFT_AGENT_DIR` / `$CRAFTAGENT_DIR`; cache writes are included in input usage |
 | Cursor | `state.vscdb` (SQLite, reads `cursorAuth/accessToken`, fetches CSV from `cursor.com`); cloud data is stamped with a fixed `cursor-cloud` hostname so multi-machine setups don't double-count |
@@ -64,9 +64,10 @@ npx @vibe-cafe/vibe-usage status       # Show config & detected tools
 | OpenCode | `~/.local/share/opencode/opencode.db` (SQLite, `json_extract` query) |
 | OpenClaw | `~/.openclaw/agents/`, `~/.openclaw-<profile>/agents/` (profile deployments); cache-creation/cache-write tokens are included in input usage |
 | Oh My Pi | `~/.omp/agent/sessions/`, `~/.omp/profiles/*/agent/sessions/`, and `$XDG_DATA_HOME/omp/{sessions,profiles/*/sessions}`; recognizes OMP's `$PI_CODING_AGENT_DIR`, current v3 title slots and path/hashed session directories, deduplicates copied records, includes cache writes in input, and splits reasoning from OMP's inclusive output count |
-| pi | `~/.pi/agent/sessions/` or `$PI_CODING_AGENT_DIR/sessions/`; cache writes are included in input usage |
+| pi | `~/.pi/agent/sessions/` or `$PI_CODING_AGENT_DIR/sessions/`, plus the session directory Pi itself was pointed at via `PI_CODING_AGENT_SESSION_DIR` or `sessionDir` in `~/.pi/agent/settings.json` (fixture/relocation override: `VIBE_USAGE_PI_SESSION_DIRS`). Cache writes are included in input usage; reasoning is read from Pi's `usage.reasoning` (legacy `usage.reasoningTokens` still accepted) and split out of the inclusive output total |
 | Qwen Code | `~/.qwen/tmp/` |
 | Kimi Code | Current `~/.kimi-code/sessions/wd_<slug>_<hash>/session_<id>/agents/<agent>/wire.jsonl` (`usage.record` deltas, including retry/compaction scope and cache creation; main/subagent wires form one session), data root resolved via `$KIMI_CODE_HOME` like the CLI itself, with project names from `session_index.jsonl`; legacy `~/.kimi/sessions/` is parsed alongside (`kimi migrate` never carries usage over, so both stores are always merged) |
+| MiniMax Code (mcode) | `$MCODE_HOME/v2/sqlite/runtime-state.sqlite` (default `~/.minimax/v2/sqlite/runtime-state.sqlite`; fixture override: `VIBE_USAGE_MCODE_DB`). Reads only allow-listed token ledger fields and session workspace/project paths, uses basename-only projects, folds cache writes into input, keeps cache reads and reasoning separate, and never selects raw/message JSON payloads. WAL/lock reads use a disposable snapshot; malformed or incompatible databases are skipped to preserve incremental state. |
 | MiMoCode | `$MIMOCODE_HOME/data/mimocode.db`, `$XDG_DATA_HOME/mimocode/mimocode.db`, or `~/.local/share/mimocode/mimocode.db` (SQLite; exact input, output, reasoning, and cache-read tokens from assistant messages; honors `MIMOCODE_DB`; cache-write tokens are included in input usage) |
 | Amp | `~/.local/share/amp/threads/`; cache-creation tokens are included in input usage |
 | Droid | `~/.factory/sessions/` |
@@ -76,7 +77,7 @@ npx @vibe-cafe/vibe-usage status       # Show config & detected tools
 | Cline | Standalone `~/.cline/` plus `<host>/User/globalStorage/saoudrizwan.claude-dev/` across VSCode-fork hosts; migrated copies are deduplicated and empty leftover extension stores no longer count as installed |
 | Roo Code | `<host>/User/globalStorage/rooveterinaryinc.roo-cline/{tasks/_index.json,tasks/<id>/{history_item,ui_messages}.json}` (walks all VSCode-fork hosts) |
 | Trae CLI | macOS: `~/Library/Caches/trae-cli/sessions/`; Windows: `%LOCALAPPDATA%/trae-cli/cache/sessions/`; Linux: `~/.cache/trae-cli/sessions/` (CLI telemetry only; Trae IDE/Trae Work chats are not supported). Token usage is summed per unique LLM call (`model.stream.eino`, plus `model.generate` failovers); nested duplicate spans that share a session `traceID` are not max-merged. `traces.jsonl` / `events.jsonl` are streamed line-by-line so a multi-hundred-MB events file cannot hit Node's string-length limit. |
-| Antigravity | App 2.0 `~/.gemini/antigravity/conversations/*.db` and `agy` CLI `~/.gemini/antigravity-cli/conversations/*.db` are parsed offline (tokens, real model display name when present, project, sessions). Gemini 3.7 CLI blobs omit `chatStartMetadata.createdAt` and `modelDisplayName`; usage still comes from `gen_metadata`, timestamps fall back to `steps.metadata` at the same idx, and the model name falls back to `responseModel`. Legacy App `.pb` history falls back to Connect RPC while the language server is running |
+| Antigravity | App 2.0 `~/.gemini/antigravity/conversations/*.db` and `agy` CLI `~/.gemini/antigravity-cli/conversations/*.db`, plus the same paths below explicitly added alternate Homes, are parsed offline (tokens, real model display name when present, project, sessions). Gemini 3.7 CLI blobs omit `chatStartMetadata.createdAt` and `modelDisplayName`; usage still comes from `gen_metadata`, timestamps fall back to `steps.metadata` at the same idx, and the model name falls back to `responseModel`. Legacy App `.pb` history falls back to Connect RPC only for the primary App store while the language server is running |
 | WorkBuddy | Current releases: `~/.workbuddy-ai/projects/**/*.jsonl`; legacy releases: `~/.workbuddy/projects/**/*.jsonl` (fixture/relocation override: `VIBE_USAGE_WORKBUDDY_DIRS`). Reads usage-bearing completed assistant and `function_call` records, using the routed model identifier exposed as `providerData.requestModelId`. Splits cache reads and reasoning from inclusive input/output totals, deduplicates copied record IDs, and extracts local session timing without uploading message content. |
 | ZCode | `~/.zcode/cli/db/db.sqlite` (SQLite; reads the `message` table for per-message tokens, model, and project `cwd`/`root`, joined to `session.directory`) |
 
@@ -157,6 +158,7 @@ Config stored at `~/.vibe-usage/config.json` (dev: `config.dev.json`).
 | `apiUrl` | Server URL (default: `https://vibecafe.ai`) |
 | `hostname` | Stable device name for usage tracking (set at init, reused across syncs) |
 | `codexExtraHome` | Optional additional Codex Home scanned together with `$CODEX_HOME` / `~/.codex` |
+| `extraRoots` | Tool-specific additional roots managed by the commands below; currently supports `codex`, `grok`, and `antigravity` |
 
 The `hostname` is captured once during `init` and reused for all future syncs. This prevents macOS mDNS hostname changes (e.g., `MacBook-Pro` → `MacBook-Pro-2`) from creating duplicate device entries. To change it manually:
 
@@ -164,6 +166,25 @@ The `hostname` is captured once during `init` and reused for all future syncs. T
 npx @vibe-cafe/vibe-usage config set hostname my-device-name
 ```
 
+Add isolated runtime data without editing JSON by hand:
+
+```bash
+# Codex accepts either one direct Codex Home or a Multica container whose
+# <workspace>/<task>/codex-home directories are at most three levels below it.
+npx @vibe-cafe/vibe-usage config add-root codex /path/to/multica-container
+
+# Grok expects a Grok Home containing sessions/.
+npx @vibe-cafe/vibe-usage config add-root grok /path/to/grok-home
+
+# Antigravity expects an alternate HOME containing .gemini/antigravity*/conversations/.
+npx @vibe-cafe/vibe-usage config add-root antigravity /path/to/alternate-home
+
+npx @vibe-cafe/vibe-usage config roots
+npx @vibe-cafe/vibe-usage config remove-root grok /path/to/grok-home
+```
+
+Default roots are always scanned and existing `codexExtraHome` configurations remain valid. Additional roots are only scanned after they are explicitly added. If a configured root later becomes unavailable, that tool is skipped for the current sync so its incremental upload state is not pruned.
+
 ## Daemon Mode
 
 ### Background service (recommended)
@@ -174,7 +195,7 @@ Install as a system service for automatic background syncing:
 npx @vibe-cafe/vibe-usage daemon install
 ```
 
-This creates a user-level service (systemd on Linux, launchd on macOS) that syncs every 30 minutes and starts automatically on login. Manage with:
+This creates a user-level service (systemd on Linux, launchd on macOS, Task Scheduler on Windows — no admin rights needed) that syncs every 30 minutes and starts automatically on login. Manage with:
 
 ```bash
 npx @vibe-cafe/vibe-usage daemon status

package/package.json

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

package/src/daemon-service.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-import { writeFileSync, unlinkSync, mkdirSync, existsSync } from 'node:fs';
+import { writeFileSync, readFileSync, unlinkSync, mkdirSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir, platform } from 'node:os';
 import { fileURLToPath } from 'node:url';
@@ -17,6 +17,9 @@ function detectPlatform() {
   if (os === 'darwin') {
     return 'launchd';
   }
+  if (os === 'win32') {
+    return 'taskscheduler';
+  }
   return null;
 }
 
@@ -25,8 +28,9 @@ function resolvePaths() {
   const thisFile = fileURLToPath(import.meta.url);
   const binPath = join(thisFile, '..', '..', 'bin', 'vibe-usage.js');
 
-  // npx cache paths are unstable — service will break when cache is cleared
-  const isNpxCache = binPath.includes('.npm/_npx');
+  // npx cache paths are unstable — service will break when cache is cleared.
+  // POSIX: ~/.npm/_npx/<hash>/...; Windows: %LocalAppData%\npm-cache\_npx\...
+  const isNpxCache = /[\\/]_npx[\\/]/.test(binPath);
 
   return { nodePath, binPath, isNpxCache };
 }
@@ -40,6 +44,15 @@ function getServicePaths(plat) {
     const dir = join(homedir(), 'Library', 'LaunchAgents');
     return { dir, file: join(dir, `${LAUNCHD_LABEL}.plist`) };
   }
+  if (plat === 'taskscheduler') {
+    const dir = join(homedir(), '.vibe-usage');
+    return {
+      dir,
+      file: join(dir, 'daemon-task.xml'),
+      cmd: join(dir, 'daemon-task.cmd'),
+      vbs: join(dir, 'daemon-task.vbs'),
+    };
+  }
   return null;
 }
 
@@ -47,6 +60,15 @@ function escapeSystemdEnvironment(value) {
   return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
 }
 
+// In `set "KEY=VALUE"`, cmd expands %VAR% on the line, so literal percents must double
+function escapeCmdValue(value) {
+  return value.replace(/%/g, '%%');
+}
+
+function psString(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+
 function escapeXml(value) {
   return value
     .replace(/&/g, '&amp;')
@@ -56,7 +78,17 @@ function escapeXml(value) {
     .replace(/'/g, '&apos;');
 }
 
-const PRESERVED_SERVICE_ENV = ['MIMOCODE_HOME', 'MIMOCODE_DB', 'XDG_DATA_HOME'];
+// Variables that relocate a tool's on-disk store. The service runs from a
+// launchd/systemd unit that inherits nothing, so anything the parsers read for
+// discovery has to be captured into the unit at install time.
+const PRESERVED_SERVICE_ENV = [
+  'MCODE_HOME',
+  'MIMOCODE_HOME',
+  'MIMOCODE_DB',
+  'XDG_DATA_HOME',
+  'PI_CODING_AGENT_DIR',
+  'PI_CODING_AGENT_SESSION_DIR',
+];
 
 function serviceEnvironment(claudeConfigDir, env) {
   const values = {
@@ -134,11 +166,88 @@ ${environment}    </dict>
 `;
 }
 
+export function generateWindowsTaskCmd(
+  nodePath,
+  binPath,
+  claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim(),
+  env = process.env,
+) {
+  const logPath = join(homedir(), '.vibe-usage', 'daemon.log');
+  const lines = [
+    '@echo off',
+    'rem Generated by `vibe-usage daemon install` - reinstalling overwrites this file',
+    'set "NODE_ENV=production"',
+  ];
+  for (const [key, value] of serviceEnvironment(claudeConfigDir, env)) {
+    lines.push(`set "${key}=${escapeCmdValue(value)}"`);
+  }
+  lines.push(
+    `"${escapeCmdValue(nodePath)}" "${escapeCmdValue(binPath)}" daemon >> "${escapeCmdValue(logPath)}" 2>&1`,
+  );
+  return lines.join('\r\n') + '\r\n';
+}
+
+export function generateWindowsTaskVbs(cmdPath) {
+  const lines = [
+    "' Vibe Usage daemon launcher - window style 0 keeps the logon session console-free;",
+    "' waitOnReturn=True keeps the task's Running state true to the daemon's lifetime",
+    "' (so MultipleInstancesPolicy can veto a second start while one daemon lives)",
+    `CreateObject("WScript.Shell").Run """${cmdPath}""", 0, True`,
+  ];
+  return lines.join('\r\n') + '\r\n';
+}
+
+// Task Scheduler kills tasks after its default 72h execution limit unless the XML
+// pins ExecutionTimeLimit to PT0S — the daemon is meant to run indefinitely.
+// Registered via `Register-ScheduledTask -Xml`: `schtasks /create /sc onlogon`
+// demands elevation, while a self-scoped LogonTrigger does not (verified non-admin).
+// The declaration must say UTF-16 or the Task Scheduler COM parser rejects the
+// registration with an XML format error, even though the string handed to
+// Register-ScheduledTask is read from the UTF-8 file via Get-Content -Raw.
+export function generateWindowsTaskXml(userId, wscriptPath, vbsPath) {
+  return `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo>
+    <Description>VibeCafe Usage Tracker background sync daemon</Description>
+  </RegistrationInfo>
+  <Triggers>
+    <LogonTrigger>
+      <UserId>${escapeXml(userId)}</UserId>
+    </LogonTrigger>
+  </Triggers>
+  <Principals>
+    <Principal id="Author">
+      <UserId>${escapeXml(userId)}</UserId>
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <AllowHardTerminate>true</AllowHardTerminate>
+    <StartWhenAvailable>true</StartWhenAvailable>
+    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+    <Priority>7</Priority>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <Command>${escapeXml(wscriptPath)}</Command>
+      <Arguments>"${escapeXml(vbsPath)}"</Arguments>
+    </Exec>
+  </Actions>
+</Task>
+`;
+}
+
 function run(cmd, args) {
   try {
     const output = execFileSync(cmd, args, {
       encoding: 'utf-8',
       stdio: ['pipe', 'pipe', 'pipe'],
+      windowsHide: true,
     });
     return { ok: true, output: output.trim() };
   } catch (err) {
@@ -146,11 +255,92 @@ function run(cmd, args) {
   }
 }
 
+function runPowerShell(script) {
+  return run('powershell.exe', [
+    '-NoProfile',
+    '-NonInteractive',
+    '-ExecutionPolicy',
+    'Bypass',
+    '-Command',
+    script,
+  ]);
+}
+
+// $ErrorActionPreference='Stop' turns cmdlet failures into the catch block's exit 1,
+// since -Command otherwise exits 0 even after a non-terminating error.
+function psTry(scriptLines) {
+  return [
+    "$ErrorActionPreference = 'Stop'",
+    'try {',
+    ...scriptLines.map(line => `  ${line}`),
+    '  exit 0',
+    '} catch {',
+    '  [Console]::Error.WriteLine($_.Exception.Message)',
+    '  exit 1',
+    '}',
+  ].join('\n');
+}
+
+function taskExists() {
+  const result = runPowerShell(
+    `if (Get-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }`,
+  );
+  return result.ok;
+}
+
+function windowsUserId() {
+  const domain = process.env.USERDOMAIN?.trim();
+  const user = process.env.USERNAME?.trim();
+  if (domain && user) return `${domain}\\${user}`;
+  const result = run('whoami', []);
+  return result.ok ? result.output : null;
+}
+
+// The cmd wrapper is the install-time record of the exact runtime + CLI
+// invocation. Process matching uses both paths so it works for Node and Bun
+// without touching foreground daemons from another checkout.
+export function parseWindowsTaskInvocation(cmd) {
+  const match = cmd.match(/^"([^"]+)" "([^"]+)" daemon\b/m);
+  if (!match) return null;
+  const unescapeCmdValue = value => value.replace(/%%/g, '%');
+  return {
+    runtimePath: unescapeCmdValue(match[1]),
+    binPath: unescapeCmdValue(match[2]),
+  };
+}
+
+function readTaskInvocation(paths) {
+  try {
+    return parseWindowsTaskInvocation(readFileSync(paths.cmd, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+// -like treats []*? as wildcards; a literal path containing any of them must be
+// bracket-escaped to still match.
+function psLikeFragment(value) {
+  return value.replace(/[[\]*?]/g, '[$&]');
+}
+
+export function windowsDaemonProcessExpression(invocation) {
+  if (!invocation) return null;
+  const binPattern = `'*${psLikeFragment(invocation.binPath)}* daemon*'`;
+  return `Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -ieq ${psString(invocation.runtimePath)} -and $_.CommandLine -like ${binPattern} }`;
+}
+
+function daemonProcessKillLines(invocation) {
+  const expression = windowsDaemonProcessExpression(invocation);
+  return expression
+    ? [`${expression} | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }`]
+    : [];
+}
+
 function install() {
   const plat = detectPlatform();
   if (!plat) {
     console.log(failure('当前平台不支持 daemon。'));
-    console.log(dim('  支持: Linux (systemd) / macOS (launchd)'));
+    console.log(dim('  支持: Linux (systemd) / macOS (launchd) / Windows (Task Scheduler)'));
     return;
   }
 
@@ -164,7 +354,10 @@ function install() {
 
   const paths = getServicePaths(plat);
 
-  if (existsSync(paths.file)) {
+  // A leftover daemon-task.xml without a registration (crashed uninstall) must
+  // not block a fresh install, so Task Scheduler checks the live task instead
+  const alreadyInstalled = plat === 'taskscheduler' ? taskExists() : existsSync(paths.file);
+  if (alreadyInstalled) {
     console.log(warn('Daemon 已安装，运行 `vibe-usage daemon restart` 或 `uninstall` 先处理。'));
     return;
   }
@@ -197,6 +390,36 @@ function install() {
     console.log(success('服务已加载并启动。'));
   }
 
+  if (plat === 'taskscheduler') {
+    const userId = windowsUserId();
+    if (!userId) {
+      console.error(failure('无法确定当前 Windows 用户，安装中止。'));
+      return;
+    }
+    const wscriptPath = join(
+      process.env.WINDIR?.trim() || process.env.SystemRoot?.trim() || 'C:\\Windows',
+      'System32',
+      'wscript.exe',
+    );
+
+    writeFileSync(paths.cmd, generateWindowsTaskCmd(nodePath, binPath), 'utf-8');
+    writeFileSync(paths.vbs, generateWindowsTaskVbs(paths.cmd), 'utf-8');
+    writeFileSync(paths.file, generateWindowsTaskXml(userId, wscriptPath, paths.vbs), 'utf-8');
+    console.log(dim(`  已写入 ${paths.file}`));
+
+    // Get-Content must force UTF8: the XML is written without a BOM and default
+    // decoding on e.g. zh-CN systems is ANSI, which mangles non-ASCII paths
+    const result = runPowerShell(psTry([
+      `Register-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -Xml (Get-Content -Raw -Encoding UTF8 ${psString(paths.file)}) -Force | Out-Null`,
+      `Start-ScheduledTask -TaskName ${psString(SERVICE_NAME)}`,
+    ]));
+    if (!result.ok) {
+      console.error(failure(`注册/启动计划任务失败: ${result.output}`));
+      return;
+    }
+    console.log(success('计划任务已注册并启动。'));
+  }
+
   console.log();
   console.log(success('Daemon 已安装，用量数据将每 30 分钟自动同步。'));
   console.log(dim('  运行 `vibe-usage daemon status` 查看状态。'));
@@ -211,7 +434,10 @@ function uninstall() {
 
   const paths = getServicePaths(plat);
 
-  if (!existsSync(paths.file)) {
+  const installed = plat === 'taskscheduler'
+    ? taskExists() || existsSync(paths.file)
+    : existsSync(paths.file);
+  if (!installed) {
     console.log(dim('未安装 daemon 服务。'));
     return;
   }
@@ -229,6 +455,24 @@ function uninstall() {
     unlinkSync(paths.file);
     console.log(success('服务已卸载并删除。'));
   }
+
+  if (plat === 'taskscheduler') {
+    if (taskExists()) {
+      const result = runPowerShell(psTry([
+        `Stop-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -ErrorAction SilentlyContinue`,
+        ...daemonProcessKillLines(readTaskInvocation(paths)),
+        `Unregister-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -Confirm:$false`,
+      ]));
+      if (!result.ok) {
+        console.error(failure(`删除计划任务失败: ${result.output}`));
+        return;
+      }
+    }
+    for (const file of [paths.file, paths.cmd, paths.vbs]) {
+      if (existsSync(file)) unlinkSync(file);
+    }
+    console.log(success('服务已卸载并删除。'));
+  }
 }
 
 function status() {
@@ -240,6 +484,63 @@ function status() {
 
   const paths = getServicePaths(plat);
 
+  if (plat === 'taskscheduler') {
+    if (!taskExists()) {
+      console.log(dim('未安装 daemon 服务。'));
+      console.log(dim('  运行 `vibe-usage daemon install` 安装。'));
+      return;
+    }
+    const invocation = readTaskInvocation(paths);
+    const processExpression = windowsDaemonProcessExpression(invocation);
+    const scriptLines = [
+      `$t = Get-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -ErrorAction SilentlyContinue`,
+      'if (-not $t) { exit 1 }',
+      'Write-Output ("State=" + $t.State)',
+    ];
+    if (processExpression) {
+      scriptLines.push(
+        `$p = ${processExpression} | Select-Object -First 1`,
+        'if ($p) { Write-Output "DaemonProcess=running" } else { Write-Output "DaemonProcess=stopped" }',
+      );
+    }
+    scriptLines.push(
+      '$i = Get-ScheduledTaskInfo -TaskName ' + psString(SERVICE_NAME) + ' -ErrorAction SilentlyContinue',
+      'if ($i -and $i.LastRunTime.Year -gt 1) { Write-Output ("LastRunTime=" + $i.LastRunTime.ToString("s")) }',
+      'if ($i) { Write-Output ("LastTaskResult=" + $i.LastTaskResult) }',
+    );
+    const result = runPowerShell(scriptLines.join('\n'));
+    if (!result.ok) {
+      console.log(warn('无法读取计划任务状态。'));
+      return;
+    }
+    const lines = Object.fromEntries(result.output
+      .split(/\r?\n/)
+      .map(line => line.trim())
+      .filter(Boolean)
+      .map(line => {
+        const idx = line.indexOf('=');
+        return idx === -1 ? [line, ''] : [line.slice(0, idx), line.slice(idx + 1)];
+      }));
+    // The live runtime process is the source of truth; the task State can lag.
+    const running = processExpression
+      ? lines.DaemonProcess === 'running'
+      : lines.State === 'Running';
+    if (running) {
+      console.log(success('服务运行中。'));
+    } else if (lines.State === 'Ready' || lines.State === 'Stopped' || lines.State === 'Running') {
+      console.log(warn('服务已安装但当前未运行。'));
+    } else {
+      console.log(warn(`服务状态异常: ${lines.State || '未知'}`));
+    }
+    for (const key of ['LastRunTime', 'LastTaskResult']) {
+      if (lines[key]) console.log(dim(`  ${key}=${lines[key]}`));
+    }
+    if (!running) {
+      console.log(dim(`  查看日志: ${join(homedir(), '.vibe-usage', 'daemon.log')}，或运行 \`vibe-usage daemon restart\`。`));
+    }
+    return;
+  }
+
   if (!existsSync(paths.file)) {
     console.log(dim('未安装 daemon 服务。'));
     console.log(dim('  运行 `vibe-usage daemon install` 安装。'));
@@ -287,6 +588,24 @@ function stop() {
     const result = run('launchctl', ['unload', paths.file]);
     console.log(result.ok ? success('服务已停止。') : failure(`停止失败: ${result.output}`));
   }
+
+  if (plat === 'taskscheduler') {
+    if (!taskExists()) {
+      console.log(dim('未安装 daemon 服务。'));
+      return;
+    }
+    // The logon trigger stays registered, so like launchd's unload the daemon
+    // stays stopped until `restart` or the next logon. Stop-ScheduledTask only
+    // terminates the wscript wrapper, so the real runtime daemon is matched and
+    // killed explicitly.
+    const paths = getServicePaths(plat);
+    const invocation = readTaskInvocation(paths);
+    const result = runPowerShell(psTry([
+      `Stop-ScheduledTask -TaskName ${psString(SERVICE_NAME)} -ErrorAction SilentlyContinue`,
+      ...daemonProcessKillLines(invocation),
+    ]));
+    console.log(result.ok ? success('服务已停止。') : failure(`停止失败: ${result.output}`));
+  }
 }
 
 function restart() {
@@ -309,6 +628,27 @@ function restart() {
     const result = run('launchctl', ['load', paths.file]);
     console.log(result.ok ? success('服务已重启。') : failure(`重启失败: ${result.output}`));
   }
+
+  if (plat === 'taskscheduler') {
+    if (!taskExists()) {
+      console.log(dim('未安装 daemon 服务。'));
+      return;
+    }
+    const paths = getServicePaths(plat);
+    const invocation = readTaskInvocation(paths);
+    const taskName = psString(SERVICE_NAME);
+    const result = runPowerShell(psTry([
+      `$t = Get-ScheduledTask -TaskName ${taskName}`,
+      "if ($t.State -eq 'Running') {",
+      `  Stop-ScheduledTask -TaskName ${taskName} -ErrorAction SilentlyContinue`,
+      ...daemonProcessKillLines(invocation),
+      '  $deadline = (Get-Date).AddSeconds(5)',
+      `  while ((Get-ScheduledTask -TaskName ${taskName}).State -eq 'Running' -and (Get-Date) -lt $deadline) { Start-Sleep -Milliseconds 200 }`,
+      '}',
+      `Start-ScheduledTask -TaskName ${taskName}`,
+    ]));
+    console.log(result.ok ? success('服务已重启。') : failure(`重启失败: ${result.output}`));
+  }
 }
 
 const SUBCOMMANDS = { install, uninstall, status, stop, restart };

package/src/extra-roots.js

@@ -0,0 +1,107 @@
+import { accessSync, constants, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { codexSessionDirs } from './codex-roots.js';
+
+export const EXTRA_ROOT_SOURCES = ['antigravity', 'codex', 'grok'];
+
+export function extraRootList(value) {
+  return Array.isArray(value) ? value.filter(root => typeof root === 'string' && root.trim()) : [];
+}
+
+export function normalizeExtraRoot(value) {
+  const trimmed = value.trim();
+  if (trimmed === '~') return homedir();
+  if (trimmed.startsWith('~/') || trimmed.startsWith('~\\')) {
+    return resolve(homedir(), trimmed.slice(2));
+  }
+  return resolve(trimmed);
+}
+
+function isReadableDirectory(path) {
+  try {
+    if (!statSync(path).isDirectory()) return false;
+    accessSync(path, constants.R_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isCodexHome(path) {
+  return isReadableDirectory(path) && codexSessionDirs(path).some(isReadableDirectory);
+}
+
+// Multica stores task-local Codex homes below a bounded
+// <container>/<workspace>/<task>/codex-home hierarchy. Do not follow symlinks
+// or descend beyond that shape: configured containers may also contain large
+// workdirs that are unrelated to usage logs.
+export function discoverCodexHomes(value, maxDepth = 3) {
+  const root = normalizeExtraRoot(value);
+  if (isCodexHome(root)) return { root, homes: [root], readable: true };
+  if (!isReadableDirectory(root)) return { root, homes: [], readable: false };
+
+  const homes = [];
+  const queue = [{ path: root, depth: 0 }];
+  let readable = true;
+  while (queue.length > 0) {
+    const current = queue.shift();
+    let children;
+    try {
+      children = readdirSync(current.path, { withFileTypes: true });
+    } catch {
+      readable = false;
+      continue;
+    }
+    for (const child of children) {
+      // Dirent#isDirectory is false for symbolic links, so traversal stays
+      // inside the explicitly selected tree.
+      if (!child.isDirectory()) continue;
+      const childPath = join(current.path, child.name);
+      const depth = current.depth + 1;
+      if (basename(childPath) === 'codex-home' && isCodexHome(childPath)) {
+        homes.push(childPath);
+        continue;
+      }
+      if (depth < maxDepth) queue.push({ path: childPath, depth });
+    }
+  }
+  return { root, homes: [...new Set(homes)], readable };
+}
+
+export function grokSessionsDir(value) {
+  return join(normalizeExtraRoot(value), 'sessions');
+}
+
+export function antigravityConversationDirs(value) {
+  const root = normalizeExtraRoot(value);
+  return [
+    join(root, '.gemini', 'antigravity', 'conversations'),
+    join(root, '.gemini', 'antigravity-cli', 'conversations'),
+  ];
+}
+
+export function validateExtraRoot(source, value) {
+  if (!EXTRA_ROOT_SOURCES.includes(source)) {
+    return { ok: false, path: value, reason: `不支持的工具: ${source}` };
+  }
+  const path = normalizeExtraRoot(value);
+  if (source === 'codex') {
+    const result = discoverCodexHomes(path);
+    return {
+      ok: result.readable && result.homes.length > 0,
+      path,
+      reason: '需要是 Codex Home，或包含 */*/codex-home 的 Multica 容器',
+    };
+  }
+  const dirs = source === 'grok'
+    ? [grokSessionsDir(path)]
+    : antigravityConversationDirs(path);
+  return {
+    ok: dirs.some(isReadableDirectory),
+    path,
+    reason: source === 'grok'
+      ? '需要包含 sessions/'
+      : '需要包含 .gemini/antigravity*/conversations/',
+  };
+}