@ttkit/daily-hot-api 0.0.0-stage → 0.1.0

package/dist/cli/commands/stop.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopCommand = stopCommand;
+exports.stopService = stopService;
+const errors_1 = require("../errors");
+const output_1 = require("../output");
+const paths_1 = require("../paths");
+const run_state_1 = require("../run-state");
+async function stopCommand(options, context = {}) {
+    const outcome = await stopService(options, context);
+    if (options.json) {
+        console.log(JSON.stringify(outcome));
+    }
+    else {
+        (0, output_1.info)(outcome.message);
+    }
+    return outcome.stopped ? errors_1.EXIT_CODES.ok : errors_1.EXIT_CODES.error;
+}
+async function stopService(options, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const env = context.env ?? process.env;
+    const homeDir = (0, paths_1.resolveHomeDir)({ home: options.home, cwd, env });
+    const paths = (0, paths_1.buildCliPaths)(homeDir);
+    const existing = (0, run_state_1.readRunState)(paths.stateFile);
+    if (existing.corrupt) {
+        (0, run_state_1.clearRunState)(paths.stateFile);
+        return {
+            stopped: true,
+            stale: true,
+            forced: false,
+            message: `运行状态文件损坏，已清理: ${paths.stateFile}（热点服务未在运行）`,
+        };
+    }
+    const state = existing.state;
+    if (!state) {
+        return {
+            stopped: true,
+            stale: false,
+            forced: false,
+            message: '热点服务未在运行',
+        };
+    }
+    if (!(0, run_state_1.isProcessAlive)(state.pid)) {
+        (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+        return {
+            stopped: true,
+            stale: true,
+            forced: false,
+            pid: state.pid,
+            port: state.port,
+            message: `热点服务未在运行（PID ${state.pid} 已退出，已清理过期状态文件）`,
+        };
+    }
+    const trusted = (0, run_state_1.processLooksLikeService)(state.pid, (0, paths_1.getPackageRoot)());
+    if (!trusted && !options.force) {
+        return {
+            stopped: false,
+            stale: false,
+            forced: false,
+            pid: state.pid,
+            port: state.port,
+            message: `PID ${state.pid} 存在但无法确认是 ${paths_1.APP_NAME} 进程，已跳过停止。` +
+                `若确认该进程属于本服务，请执行: ${paths_1.APP_NAME} stop --force；或手动删除状态文件 ${paths.stateFile}`,
+        };
+    }
+    if (options.force) {
+        (0, output_1.warn)(`--force: 直接发送 SIGKILL 终止 PID ${state.pid}`);
+        try {
+            process.kill(state.pid, 'SIGKILL');
+        }
+        catch (error) {
+            if (error.code !== 'ESRCH') {
+                throw new errors_1.CliError(`发送 SIGKILL 失败: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        const killed = await (0, run_state_1.waitForProcessExit)(state.pid, 5000);
+        if (!killed && (0, run_state_1.isProcessAlive)(state.pid)) {
+            throw new errors_1.CliError(`无法终止进程 ${state.pid}，请手动执行: kill -9 ${state.pid}`);
+        }
+        (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+        return {
+            stopped: true,
+            stale: false,
+            forced: true,
+            pid: state.pid,
+            port: state.port,
+            message: `已强制停止热点服务（PID ${state.pid}）`,
+        };
+    }
+    (0, output_1.progress)(`正在停止热点服务（PID ${state.pid}，端口 ${state.port}）...`);
+    try {
+        process.kill(state.pid, 'SIGTERM');
+    }
+    catch (error) {
+        if (error.code === 'ESRCH') {
+            (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+            return {
+                stopped: true,
+                stale: true,
+                forced: false,
+                pid: state.pid,
+                port: state.port,
+                message: `热点服务未在运行（PID ${state.pid} 已退出，已清理过期状态文件）`,
+            };
+        }
+        throw new errors_1.CliError(`发送停止信号失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    let forced = false;
+    const exited = await (0, run_state_1.waitForProcessExit)(state.pid, options.timeoutSeconds * 1000);
+    if (!exited) {
+        forced = true;
+        (0, output_1.warn)(`进程在 ${options.timeoutSeconds} 秒内未退出，发送 SIGKILL`);
+        try {
+            process.kill(state.pid, 'SIGKILL');
+        }
+        catch {
+        }
+        const killed = await (0, run_state_1.waitForProcessExit)(state.pid, 5000);
+        if (!killed && (0, run_state_1.isProcessAlive)(state.pid)) {
+            throw new errors_1.CliError(`无法停止进程 ${state.pid}，请手动执行: kill -9 ${state.pid}`);
+        }
+    }
+    (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+    return {
+        stopped: true,
+        stale: false,
+        forced,
+        pid: state.pid,
+        port: state.port,
+        message: forced
+            ? `已强制停止热点服务（PID ${state.pid}）`
+            : `热点服务已停止（PID ${state.pid}）`,
+    };
+}
+//# sourceMappingURL=stop.js.map

package/dist/cli/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,4 @@
+export interface CommandContext {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}

package/dist/cli/context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":""}

package/dist/cli/env.d.ts

@@ -0,0 +1,2 @@
+export declare function applyEnvFile(envFile: string, env?: NodeJS.ProcessEnv): string[];
+export declare function resolvePort(flagPort: number | undefined, env?: NodeJS.ProcessEnv): number;

package/dist/cli/env.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyEnvFile = applyEnvFile;
+exports.resolvePort = resolvePort;
+const fs_1 = require("fs");
+const dotenv = __importStar(require("dotenv"));
+const errors_1 = require("./errors");
+const paths_1 = require("./paths");
+function applyEnvFile(envFile, env = process.env) {
+    if (!(0, fs_1.existsSync)(envFile)) {
+        throw new errors_1.CliError(`配置文件不存在: ${envFile}`);
+    }
+    let parsed;
+    try {
+        parsed = dotenv.parse((0, fs_1.readFileSync)(envFile));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`读取配置文件失败: ${envFile} (${reason})`);
+    }
+    const applied = [];
+    for (const [key, value] of Object.entries(parsed)) {
+        if (env[key] === undefined) {
+            env[key] = value;
+            applied.push(key);
+        }
+    }
+    return applied;
+}
+function resolvePort(flagPort, env = process.env) {
+    if (flagPort !== undefined) {
+        return flagPort;
+    }
+    const raw = (env.PORT ?? '').trim();
+    if (!raw) {
+        return paths_1.DEFAULT_PORT;
+    }
+    if (!/^\d+$/.test(raw)) {
+        throw new errors_1.CliError(`环境变量 PORT 配置无效: "${raw}"，应为 1-65535 的整数`);
+    }
+    const port = Number(raw);
+    if (port < 1 || port > 65535) {
+        throw new errors_1.CliError(`环境变量 PORT 配置无效: "${raw}"，应为 1-65535 的整数`);
+    }
+    return port;
+}
+//# sourceMappingURL=env.js.map

package/dist/cli/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/cli/env.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,oCAwBC;AAKD,kCAsBC;AAhED,2BAA8C;AAC9C,+CAAiC;AACjC,qCAAoC;AACpC,mCAAuC;AAUvC,SAAgB,YAAY,CAC1B,OAAe,EACf,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,iBAAQ,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,MAAgC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,iBAAQ,CAAC,aAAa,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAKD,SAAgB,WAAW,CACzB,QAA4B,EAC5B,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,oBAAY,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,iBAAQ,CAAC,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,iBAAQ,CAAC,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/errors.d.ts

@@ -0,0 +1,14 @@
+export declare const EXIT_CODES: {
+    readonly ok: 0;
+    readonly error: 1;
+    readonly usage: 2;
+    readonly notRunning: 3;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+export declare class CliError extends Error {
+    readonly exitCode: ExitCode;
+    constructor(message: string, exitCode?: ExitCode);
+}
+export declare class UsageError extends CliError {
+    constructor(message: string);
+}

package/dist/cli/errors.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageError = exports.CliError = exports.EXIT_CODES = void 0;
+exports.EXIT_CODES = {
+    ok: 0,
+    error: 1,
+    usage: 2,
+    notRunning: 3,
+};
+class CliError extends Error {
+    constructor(message, exitCode = exports.EXIT_CODES.error) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+    }
+}
+exports.CliError = CliError;
+class UsageError extends CliError {
+    constructor(message) {
+        super(message, exports.EXIT_CODES.usage);
+        this.name = 'UsageError';
+    }
+}
+exports.UsageError = UsageError;
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IAExB,EAAE,EAAE,CAAC;IAEL,KAAK,EAAE,CAAC;IAER,KAAK,EAAE,CAAC;IAER,UAAU,EAAE,CAAC;CACL,CAAC;AAIX,MAAa,QAAS,SAAQ,KAAK;IAGjC,YAAY,OAAe,EAAE,WAAqB,kBAAU,CAAC,KAAK;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AARD,4BAQC;AAED,MAAa,UAAW,SAAQ,QAAQ;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AALD,gCAKC"}

package/dist/cli/health.d.ts

@@ -0,0 +1,2 @@
+export declare function checkHealth(port: number, timeoutMs?: number, host?: string): Promise<boolean>;
+export declare function waitForHealthy(port: number, timeoutMs: number, intervalMs?: number): Promise<boolean>;

package/dist/cli/health.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkHealth = checkHealth;
+exports.waitForHealthy = waitForHealthy;
+const http_1 = require("http");
+const run_state_1 = require("./run-state");
+function checkHealth(port, timeoutMs = 2000, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (healthy) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve(healthy);
+        };
+        const request = (0, http_1.get)({ host, port, path: '/health', timeout: timeoutMs }, (response) => {
+            response.resume();
+            const statusCode = response.statusCode ?? 0;
+            finish(statusCode >= 200 && statusCode < 400);
+        });
+        request.on('timeout', () => {
+            request.destroy();
+            finish(false);
+        });
+        request.on('error', () => {
+            finish(false);
+        });
+    });
+}
+async function waitForHealthy(port, timeoutMs, intervalMs = 250) {
+    const deadline = Date.now() + timeoutMs;
+    do {
+        if (await checkHealth(port)) {
+            return true;
+        }
+        if (Date.now() >= deadline) {
+            return false;
+        }
+        await (0, run_state_1.sleep)(intervalMs);
+    } while (Date.now() < deadline);
+    return false;
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/cli/health.ts"],"names":[],"mappings":";;AAIA,kCA+BC;AAED,wCAgBC;AArDD,+BAA2B;AAC3B,2CAAoC;AAGpC,SAAgB,WAAW,CACzB,IAAY,EACZ,SAAS,GAAG,IAAI,EAChB,IAAI,GAAG,WAAW;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAQ,EAAE;YACxC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,UAAG,EACjB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EACnD,CAAC,QAAQ,EAAE,EAAE;YACX,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC;QAChD,CAAC,CACF,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,SAAiB,EACjB,UAAU,GAAG,GAAG;IAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,GAAG,CAAC;QACF,IAAI,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAA,iBAAK,EAAC,UAAU,CAAC,CAAC;IAC1B,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE;IAChC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandName } from './args';
+export declare function globalHelp(): string;
+export declare function commandHelp(command: CommandName): string;

package/dist/cli/help.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalHelp = globalHelp;
+exports.commandHelp = commandHelp;
+const paths_1 = require("./paths");
+function versionOrUnknown() {
+    return (0, paths_1.getPackageVersion)();
+}
+const START_HELP = `用法: daily-hot-api [start] [选项]
+
+在前台启动热点服务（默认命令）。服务日志直接输出到当前终端，
+按 Ctrl+C 停止；也可以在其他终端执行 daily-hot-api stop。
+
+选项:
+  -p, --port <端口>      覆盖监听端口（默认取 .env 的 PORT，否则 6689）
+  -d, --daemon           在后台启动，日志写入状态目录
+      --config <路径>    指定 .env 配置文件（默认顺序: DAILY_HOT_API_ENV_FILE → 当前目录 .env → 状态目录 .env）
+      --home <目录>      指定状态目录（默认 ~/.daily-hot-api）
+  -h, --help             查看帮助
+
+示例:
+  daily-hot-api                    前台启动
+  daily-hot-api -p 6699            前台启动并指定端口
+  daily-hot-api start -d           后台启动
+  daily-hot-api start -d --port 6699 --config ./prod.env`;
+const STOP_HELP = `用法: daily-hot-api stop [选项]
+
+停止由 CLI 启动的热点服务。先发送 SIGTERM 优雅退出，
+超过 --timeout 仍未退出则发送 SIGKILL。
+
+选项:
+      --timeout <秒>     等待进程退出的超时时间（默认 10 秒）
+      --force            跳过进程校验并立即 SIGKILL
+      --json             以 JSON 输出结果
+      --home <目录>      指定状态目录（默认 ~/.daily-hot-api）
+  -h, --help             查看帮助
+
+退出码:
+  0  已停止（或本来未在运行，幂等）
+  1  停止失败`;
+const STATUS_HELP = `用法: daily-hot-api status [选项]
+
+查看由 CLI 启动的热点服务状态，包括 PID、端口、运行时长和健康检查。
+
+选项:
+      --json             以 JSON 输出结果
+      --home <目录>      指定状态目录（默认 ~/.daily-hot-api）
+  -h, --help             查看帮助
+
+退出码:
+  0  运行中
+  3  未运行`;
+const RESTART_HELP = `用法: daily-hot-api restart [选项]
+
+重启由 CLI 启动的热点服务。默认沿用上一次的端口、配置文件和运行模式；
+服务未在运行时等同于 start。
+
+选项:
+  -d, --daemon           重启后在后台运行
+      --foreground       重启后在前台运行
+  -p, --port <端口>      覆盖监听端口
+      --config <路径>    指定 .env 配置文件
+      --timeout <秒>     等待旧进程退出的超时时间（默认 10 秒）
+      --force            停止旧进程时立即 SIGKILL
+      --home <目录>      指定状态目录（默认 ~/.daily-hot-api）
+  -h, --help             查看帮助
+
+示例:
+  daily-hot-api restart
+  daily-hot-api restart -d
+  daily-hot-api restart --foreground -p 6699`;
+const LOGS_HELP = `用法: daily-hot-api logs [选项]
+
+查看后台服务日志。前台模式的标准输出直接打印在启动终端，
+不会写入日志文件。
+
+选项:
+  -n, --lines <行数>     显示最后 N 行（默认 50）
+  -f, --follow           持续跟踪新增日志，按 Ctrl+C 退出
+      --home <目录>      指定状态目录（默认 ~/.daily-hot-api）
+  -h, --help             查看帮助
+
+示例:
+  daily-hot-api logs
+  daily-hot-api logs -n 200
+  daily-hot-api logs -f`;
+const HELP_HELP = `用法: daily-hot-api help [命令]
+
+显示全局帮助或指定命令的帮助。
+
+示例:
+  daily-hot-api help
+  daily-hot-api help start`;
+const VERSION_HELP = `用法: daily-hot-api --version
+
+打印当前 CLI 版本。`;
+const COMMAND_HELP = {
+    start: START_HELP,
+    stop: STOP_HELP,
+    status: STATUS_HELP,
+    restart: RESTART_HELP,
+    logs: LOGS_HELP,
+    help: HELP_HELP,
+    version: VERSION_HELP,
+};
+function globalHelp() {
+    return `daily-hot-api v${versionOrUnknown()}
+
+每日热榜聚合 API 服务命令行工具：在前台或后台启动热点服务，并管理其生命周期。
+
+用法:
+  daily-hot-api [start] [选项]      在前台启动热点服务（默认命令）
+  daily-hot-api start -d [选项]     在后台启动热点服务
+  daily-hot-api stop [选项]         停止由 CLI 启动的热点服务
+  daily-hot-api restart [选项]      重启热点服务
+  daily-hot-api status [选项]       查看服务状态（未运行时退出码 3）
+  daily-hot-api logs [选项]         查看或跟踪后台服务日志
+  daily-hot-api help [命令]         查看命令帮助
+  daily-hot-api --version           查看版本
+
+常用选项:
+  -p, --port <端口>        覆盖监听端口（默认取 .env 的 PORT，否则 6689）
+  -d, --daemon             在后台运行（start/restart）
+      --foreground         在前台运行（restart 用来覆盖原模式）
+      --config <路径>      指定 .env 配置文件
+      --home <目录>        指定状态目录（默认 ~/.daily-hot-api）
+      --timeout <秒>       stop/restart 等待退出的超时时间（默认 10 秒）
+      --force              强制结束进程（SIGKILL，stop/restart）
+      --json               以 JSON 输出（status/stop）
+  -n, --lines <行数>       logs 显示的行数（默认 50）
+  -f, --follow             logs 持续跟踪新增日志
+  -h, --help               查看帮助
+  -v, --version            查看版本
+
+示例:
+  daily-hot-api                         前台启动，默认端口 6689
+  daily-hot-api -p 6699                 前台启动并指定端口
+  daily-hot-api start -d                后台启动
+  daily-hot-api status                  查看状态
+  daily-hot-api logs -f                 跟踪后台日志
+  daily-hot-api stop                    停止服务
+  npx daily-hot-api start -d            不全局安装，直接用 npx 后台启动
+
+环境变量:
+  PORT                    服务端口
+  DAILY_HOT_API_HOME      状态目录，默认 ~/.daily-hot-api
+  DAILY_HOT_API_ENV_FILE  显式指定 .env 文件（等同于 --config）
+
+首次使用: 在运行目录准备 .env（可复制 .env.example），或使用 --config 指定。
+文档: https://helti.github.io/daily-hot-api/guide/cli`;
+}
+function commandHelp(command) {
+    if (command === 'version') {
+        return `daily-hot-api v${versionOrUnknown()}\n\n${VERSION_HELP}`;
+    }
+    return COMMAND_HELP[command];
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":";;AAgHA,gCA6CC;AAED,kCAKC;AAnKD,mCAA4C;AAE5C,SAAS,gBAAgB;IACvB,OAAO,IAAA,yBAAiB,GAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;yDAgBsC,CAAC;AAE1D,MAAM,SAAS,GAAG;;;;;;;;;;;;;;UAcR,CAAC;AAEX,MAAM,WAAW,GAAG;;;;;;;;;;;SAWX,CAAC;AAEV,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;6CAkBwB,CAAC;AAE9C,MAAM,SAAS,GAAG;;;;;;;;;;;;;;wBAcM,CAAC;AAEzB,MAAM,SAAS,GAAG;;;;;;2BAMS,CAAC;AAE5B,MAAM,YAAY,GAAG;;aAER,CAAC;AAEd,MAAM,YAAY,GAAgC;IAChD,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,SAAgB,UAAU;IACxB,OAAO,kBAAkB,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDA2CO,CAAC;AACrD,CAAC;AAED,SAAgB,WAAW,CAAC,OAAoB;IAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,kBAAkB,gBAAgB,EAAE,OAAO,YAAY,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv: string[]): Promise<number>;
+export declare function main(argv?: string[]): void;

package/dist/cli/index.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.main = main;
+const args_1 = require("./args");
+const logs_1 = require("./commands/logs");
+const restart_1 = require("./commands/restart");
+const start_1 = require("./commands/start");
+const status_1 = require("./commands/status");
+const stop_1 = require("./commands/stop");
+const errors_1 = require("./errors");
+const help_1 = require("./help");
+const paths_1 = require("./paths");
+async function run(argv) {
+    let options;
+    try {
+        options = (0, args_1.parseArgs)(argv);
+    }
+    catch (error) {
+        if (error instanceof errors_1.UsageError) {
+            console.error(`错误: ${error.message}`);
+            console.error('');
+            console.error((0, help_1.globalHelp)());
+            return errors_1.EXIT_CODES.usage;
+        }
+        throw error;
+    }
+    if (options.version || options.command === 'version') {
+        console.log((0, paths_1.getPackageVersion)());
+        return errors_1.EXIT_CODES.ok;
+    }
+    if (options.help || options.command === 'help') {
+        printHelp(options);
+        return errors_1.EXIT_CODES.ok;
+    }
+    switch (options.command) {
+        case 'start':
+            return (0, start_1.startCommand)(options);
+        case 'stop':
+            return (0, stop_1.stopCommand)(options);
+        case 'status':
+            return (0, status_1.statusCommand)(options);
+        case 'restart':
+            return (0, restart_1.restartCommand)(options);
+        case 'logs':
+            return (0, logs_1.logsCommand)(options);
+        default: {
+            const exhaustive = options.command;
+            throw new errors_1.UsageError(`未知命令: ${String(exhaustive)}`);
+        }
+    }
+}
+function printHelp(options) {
+    let target;
+    if (options.command === 'help') {
+        target = options.helpTarget;
+    }
+    else if (options.commandExplicit) {
+        target = options.command;
+    }
+    if (!target || target === 'help') {
+        console.log((0, help_1.globalHelp)());
+    }
+    else {
+        console.log((0, help_1.commandHelp)(target));
+    }
+}
+function main(argv = process.argv.slice(2)) {
+    run(argv)
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        let exitCode = errors_1.EXIT_CODES.error;
+        if (error instanceof errors_1.CliError) {
+            console.error(`错误: ${error.message}`);
+            exitCode = error.exitCode;
+        }
+        else {
+            console.error('错误:', error instanceof Error ? error.message : String(error));
+            if (process.env.DAILY_HOT_API_DEBUG &&
+                error instanceof Error &&
+                error.stack) {
+                console.error(error.stack);
+            }
+        }
+        process.exitCode = exitCode;
+        setTimeout(() => process.exit(exitCode), 100).unref();
+    });
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/log-file.d.ts

@@ -0,0 +1,8 @@
+export declare const LOG_TAIL_MAX_BYTES: number;
+export declare function tailFile(file: string, lines: number, maxBytes?: number): string;
+export interface LogChunk {
+    text: string;
+    nextPosition: number;
+    truncated: boolean;
+}
+export declare function readLogChunk(file: string, fromPosition: number): LogChunk;