@juejin-opensource/jusage 0.1.6 → 0.1.8

package/README.md

@@ -55,6 +55,7 @@ jusage start                  # 或直接 jusage
 ```bash
 jusage service start
 jusage start --port 8452
+jusage start --host 0.0.0.0          # 局域网可访问；默认 127.0.0.1
 jusage sync --source=claude          # claude | codex | cursor | all
 jusage upload --force                # 忽略云端同步开关，强制上报
 jusage upload --reconcile            # 全量对账后上报

package/dist/args.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_HOST = "127.0.0.1";
+export declare function isWildcardListenHost(host: string): boolean;
+export declare function formatListenUrl(host: string, port: number): string;
+export interface ParsedArgs {
+    command: string;
+    serviceAction?: string;
+    /** Set only when --port is passed. */
+    port?: number;
+    /** Set only when --host is passed. */
+    host?: string;
+    source?: string;
+    force?: boolean;
+    reconcile?: boolean;
+    /** Hidden debug: seed statsSince to N days ago when missing. Not shown in --help. */
+    days?: number;
+}
+export declare function normalizeListenHost(raw: string): string;
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function resolveDaysAgo(days: number | undefined): number | undefined;
+export declare function printHelp(): void;

package/dist/args.js

@@ -0,0 +1,121 @@
+import { DEFAULT_PORT } from '@juejin-opensource/jusage-core';
+export const DEFAULT_HOST = '127.0.0.1';
+export function isWildcardListenHost(host) {
+    return host === '0.0.0.0' || host === '::';
+}
+export function formatListenUrl(host, port) {
+    const display = isWildcardListenHost(host) ? DEFAULT_HOST : host;
+    const formatted = display.includes(':') && !display.startsWith('[') ? `[${display}]` : display;
+    return `http://${formatted}:${port}`;
+}
+export function normalizeListenHost(raw) {
+    const host = raw.trim();
+    if (!host) {
+        throw new Error('--host 不能为空，例如 0.0.0.0 或 127.0.0.1');
+    }
+    if (/[\s/?#]/.test(host)) {
+        throw new Error(`无效的 --host: ${raw}`);
+    }
+    return host;
+}
+function isFlagToken(value) {
+    return value != null && value.startsWith('-') && value !== '-';
+}
+export function parseArgs(argv) {
+    const args = argv.slice(2);
+    let command = args[0] ?? 'start';
+    let serviceAction;
+    let port;
+    let host;
+    let source;
+    let force = false;
+    let reconcile = false;
+    let days;
+    if (command === 'help' ||
+        command === '--help' ||
+        command === '-h' ||
+        args.includes('--help') ||
+        args.includes('-h')) {
+        return { command: 'help', port, host, source, force, reconcile };
+    }
+    if (command === 'service') {
+        serviceAction = args[1];
+    }
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--port' && args[i + 1]) {
+            port = Number(args[i + 1]) || DEFAULT_PORT;
+            i += 1;
+        }
+        else if (args[i] === '--host') {
+            if (isFlagToken(args[i + 1]) || args[i + 1] == null) {
+                throw new Error('--host 需要地址，例如 0.0.0.0 或 127.0.0.1');
+            }
+            host = normalizeListenHost(args[i + 1]);
+            i += 1;
+        }
+        else if (args[i]?.startsWith('--host=')) {
+            host = normalizeListenHost(args[i].slice('--host='.length));
+        }
+        else if (args[i] === '--source' && args[i + 1]) {
+            source = args[i + 1];
+            i += 1;
+        }
+        else if (args[i]?.startsWith('--source=')) {
+            source = args[i].slice('--source='.length);
+        }
+        else if (args[i] === '--force') {
+            force = true;
+        }
+        else if (args[i] === '--reconcile') {
+            reconcile = true;
+        }
+        else if (args[i] === '--days' && args[i + 1]) {
+            days = Number(args[i + 1]);
+            i += 1;
+        }
+        else if (args[i]?.startsWith('--days=')) {
+            days = Number(args[i].slice('--days='.length));
+        }
+    }
+    if (command.startsWith('-'))
+        command = 'start';
+    return { command, serviceAction, port, host, source, force, reconcile, days };
+}
+export function resolveDaysAgo(days) {
+    if (days === undefined)
+        return undefined;
+    if (!Number.isInteger(days) || days <= 0) {
+        throw new Error(`--days 须为正整数，收到: ${days}`);
+    }
+    return days;
+}
+export function printHelp() {
+    console.log(`Usage: jusage <command> [options]
+
+Commands:
+  start                 前台启动本地面板与同步（默认；桌面已运行时为观察模式）
+  stop                  停止当前进程内的服务
+  status                查看 CLI / 面板当前启动状态
+  sync                  手动同步本地用量数据
+  upload                上报数据到云端
+  service <action>      后台服务与开机自启（macOS / Windows / Linux）
+                        action: start | stop | status
+  help                  显示帮助
+
+Options:
+  --port <number>       面板端口（默认 ${DEFAULT_PORT}）
+  --host <address>      面板监听地址（默认 ${DEFAULT_HOST}；局域网访问用 0.0.0.0）
+  --source <name>       sync 数据源：claude | codex | cursor | qoder | trae | gemini | opencode | copilot | antigravity | openclaw | hermes | zcode | pi | kimi | roocode | droid | kiro | cline | amp | qwen | codebuddy | workbuddy | grok | mimo | every-code | omp | kilo-cli | kilocode | goose | zed | warp | all
+  --force               upload 时忽略云端同步开关，强制上报
+  --reconcile           upload 时做全量对账
+  -h, --help            显示帮助
+
+Examples:
+  jusage
+  jusage start --port 8452
+  jusage start --host 0.0.0.0
+  jusage status
+  jusage sync --source=claude
+  jusage upload --force
+  jusage service start`);
+}

package/dist/daemon.d.ts

@@ -3,14 +3,14 @@ export { clearPid, getRunningOwner, getRunningPid, isPidAlive, pidFilePath, read
 export declare function daemonLogPath(dataDir?: string): string;
 export declare function ensureDaemonLogDir(dataDir?: string): Promise<string>;
 /** True when local-api `/health` returns `{ ok: true }`. */
-export declare function probeLocalHealth(port: number): Promise<boolean>;
+export declare function probeLocalHealth(port: number, host?: string): Promise<boolean>;
 export declare function waitForPid(dataDir?: string, timeoutMs?: number): Promise<number | null>;
 export interface ServiceReady {
     pid: number | null;
     health: boolean;
 }
 /** Wait until the pid file is live, or `/health` is up as a fallback. */
-export declare function waitForServiceReady(dataDir: string, port: number, timeoutMs?: number): Promise<ServiceReady>;
+export declare function waitForServiceReady(dataDir: string, port: number, host?: string, timeoutMs?: number): Promise<ServiceReady>;
 export declare function readDaemonLogTail(dataDir?: string, maxChars?: number): Promise<string>;
 export declare function resolveServiceCommand(cliBinPath: string): {
     nodePath: string;

package/dist/daemon.js

@@ -3,6 +3,7 @@ import { realpathSync } from 'node:fs';
 import { mkdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { DEFAULT_DATA_DIR, argsMatchRuntimeKind, logsDir, clearPid, getRunningOwner, getRunningPid, isPidAlive, pidFilePath, readPid, readProcessArgs, readRuntimeOwner, stopPid, writePid, writeRuntimeOwner, } from '@juejin-opensource/jusage-core';
+import { DEFAULT_HOST, formatListenUrl } from './args.js';
 export { clearPid, getRunningOwner, getRunningPid, isPidAlive, pidFilePath, readPid, readRuntimeOwner, stopPid, writePid, writeRuntimeOwner, };
 export function daemonLogPath(dataDir = DEFAULT_DATA_DIR) {
     return join(logsDir(dataDir), 'daemon.log');
@@ -21,9 +22,9 @@ async function readLivePid(dataDir) {
     return null;
 }
 /** True when local-api `/health` returns `{ ok: true }`. */
-export async function probeLocalHealth(port) {
+export async function probeLocalHealth(port, host = DEFAULT_HOST) {
     try {
-        const res = await fetch(`http://127.0.0.1:${port}/health`, {
+        const res = await fetch(`${formatListenUrl(host, port)}/health`, {
             signal: AbortSignal.timeout(400),
         });
         if (!res.ok)
@@ -83,21 +84,21 @@ export async function waitForPid(dataDir = DEFAULT_DATA_DIR, timeoutMs = 15_000)
     return getRunningPid(dataDir);
 }
 /** Wait until the pid file is live, or `/health` is up as a fallback. */
-export async function waitForServiceReady(dataDir, port, timeoutMs = 15_000) {
+export async function waitForServiceReady(dataDir, port, host = DEFAULT_HOST, timeoutMs = 15_000) {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
         const pid = await readLivePid(dataDir);
         if (pid != null)
-            return { pid, health: await probeLocalHealth(port) };
-        if (await probeLocalHealth(port)) {
+            return { pid, health: await probeLocalHealth(port, host) };
+        if (await probeLocalHealth(port, host)) {
             return { pid: await recoverPidFromHealth(dataDir, port), health: true };
         }
         await new Promise((r) => setTimeout(r, 200));
     }
     const pid = (await readLivePid(dataDir)) ?? (await getRunningPid(dataDir));
     if (pid != null)
-        return { pid, health: await probeLocalHealth(port) };
-    if (await probeLocalHealth(port)) {
+        return { pid, health: await probeLocalHealth(port, host) };
+    if (await probeLocalHealth(port, host)) {
         return { pid: await recoverPidFromHealth(dataDir, port), health: true };
     }
     return { pid: null, health: false };