@juejin-opensource/jusage 0.1.8 → 0.1.10

package/dist/args.d.ts

@@ -1,4 +1,11 @@
 export declare const DEFAULT_HOST = "127.0.0.1";
+/** `--source` 的合法取值提示，从 sync registry 生成，避免帮助与实现脱节。 */
+export declare function formatSyncSourceList(): string;
+/**
+ * 校验 `--source`：未传 / `all` 表示全量；别名与大小写归一为标准 id；
+ * 未知值抛错（由 main 打印并以非零码退出），绝不静默跳过。
+ */
+export declare function resolveSyncSource(raw?: string): string | undefined;
 export declare function isWildcardListenHost(host: string): boolean;
 export declare function formatListenUrl(host: string, port: number): string;
 export interface ParsedArgs {
@@ -15,6 +22,7 @@ export interface ParsedArgs {
     days?: number;
 }
 export declare function normalizeListenHost(raw: string): string;
+export declare function normalizeListenPort(raw: string): number;
 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

@@ -1,5 +1,19 @@
-import { DEFAULT_PORT } from '@juejin-opensource/jusage-core';
+import { DEFAULT_PORT, SYNC_SOURCE_IDS, normalizeSyncSource, } from '@juejin-opensource/jusage-core';
 export const DEFAULT_HOST = '127.0.0.1';
+/** `--source` 的合法取值提示，从 sync registry 生成，避免帮助与实现脱节。 */
+export function formatSyncSourceList() {
+    return ['all', ...SYNC_SOURCE_IDS].join(' | ');
+}
+/**
+ * 校验 `--source`：未传 / `all` 表示全量；别名与大小写归一为标准 id；
+ * 未知值抛错（由 main 打印并以非零码退出），绝不静默跳过。
+ */
+export function resolveSyncSource(raw) {
+    const resolved = normalizeSyncSource(raw);
+    if (resolved !== null)
+        return resolved;
+    throw new Error(`未知的数据源: ${raw}\n可用值: ${formatSyncSourceList()}`);
+}
 export function isWildcardListenHost(host) {
     return host === '0.0.0.0' || host === '::';
 }
@@ -18,6 +32,13 @@ export function normalizeListenHost(raw) {
     }
     return host;
 }
+export function normalizeListenPort(raw) {
+    const port = Number(raw);
+    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+        throw new Error(`无效的 --port: ${raw}，请输入 1 到 65535 之间的整数`);
+    }
+    return port;
+}
 function isFlagToken(value) {
     return value != null && value.startsWith('-') && value !== '-';
 }
@@ -42,8 +63,11 @@ export function parseArgs(argv) {
         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;
+        if (args[i] === '--port') {
+            if (isFlagToken(args[i + 1]) || args[i + 1] == null) {
+                throw new Error('--port 需要端口号，例如 8452');
+            }
+            port = normalizeListenPort(args[i + 1]);
             i += 1;
         }
         else if (args[i] === '--host') {
@@ -105,7 +129,7 @@ Commands:
 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
+  --source <name>       sync 数据源：${formatSyncSourceList()}
   --force               upload 时忽略云端同步开关，强制上报
   --reconcile           upload 时做全量对账
   -h, --help            显示帮助