@juejin-opensource/jusage 0.1.6-beta.0 → 0.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 juejin-cn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 };

package/dist/dashboard/assets/Check-C6Vp6SAU.js

@@ -0,0 +1 @@
+import{t as p,R as l,j as r,cf as g,r as s,cg as v,a9 as c,bg as f,cb as x,a7 as h,bT as u,ch as w,ci as b,b4 as m}from"./index-3miiAdwH.js";const $=p({slots:{base:"popover",dialog:"popover__dialog",heading:"popover__heading",trigger:"popover__trigger"}}),n=s.createContext({}),d=({children:o,...t})=>{const a=l.useMemo(()=>$(),[]);return r.jsx(n,{value:{slots:a},children:r.jsx(g,{"data-slot":"popover-root",...t,children:o})})},j=({children:o,className:t,...a})=>{const{slots:e}=s.use(n);return r.jsx(n,{value:{slots:e},children:r.jsx(f,{value:{variant:"default"},children:r.jsx(x,{...a,className:h(t,e==null?void 0:e.base()),children:o})})})},C=({children:o,className:t,...a})=>{const e=r.jsx("svg",{"data-slot":"popover-overlay-arrow",fill:"none",height:"12",viewBox:"0 0 12 12",width:"12",xmlns:"http://www.w3.org/2000/svg",children:r.jsx("path",{d:"M0 0C5.48483 8 6.5 8 12 0Z"})}),i=l.isValidElement(o)?l.cloneElement(o,{"data-slot":"popover-overlay-arrow"}):e;return r.jsx(u,{"data-slot":"popover-overlay-arrow-group",...a,className:t,children:i})},P=({children:o,className:t,...a})=>{const{slots:e}=s.use(n);return r.jsx(w,{"data-slot":"popover-dialog",...a,className:c(e==null?void 0:e.dialog,t),children:o})},R=({children:o,className:t,...a})=>{const{slots:e}=s.use(n);return r.jsx(b,{children:r.jsx(m.div,{className:c(e==null?void 0:e.trigger,t),"data-slot":"popover-trigger",role:"button",...a,children:o})})},E=({children:o,className:t,...a})=>{const{slots:e}=s.use(n);return r.jsx(v,{slot:"title",...a,className:c(e==null?void 0:e.heading,t),children:o})},_=Object.assign(d,{Root:d,Trigger:R,Dialog:P,Arrow:C,Content:j,Heading:E}),A=o=>s.createElement("svg",Object.assign({xmlns:"http://www.w3.org/2000/svg",width:16,height:16,fill:"none",viewBox:"0 0 16 16"},o),s.createElement("path",{fill:"currentColor",fillRule:"evenodd",d:"M13.488 3.43a.75.75 0 0 1 .081 1.058l-6 7a.75.75 0 0 1-1.1.042l-3.5-3.5A.75.75 0 0 1 4.03 6.97l2.928 2.927 5.473-6.385a.75.75 0 0 1 1.057-.081",clipRule:"evenodd"}));export{A as C,_ as P};