@yunzai-ng/cli 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @yunzai-ng/cli
+
+命令行入口。命令名 `yzng`。
+
+## 命令
+
+| 命令 | 作用 |
+|---|---|
+| `yzng start` | 启动 |
+| `yzng dev` | 启动,缺省日志级别更低 |
+| `yzng init` | 只生成主目录与默认配置,不启动 |
+| `yzng doctor` | 体检:Node 版本、目录权限、可选原生模块、端口占用 |
+| `yzng plugin new <名>` | 生成一个插件骨架 |
+
+常用参数:
+
+```bash
+yzng start --home D:\yunzai          # 指定主目录（也可用环境变量 YZNG_HOME）
+yzng start --plugins ../a,../b       # 额外加载这几个目录（开发时用）
+yzng start --log-level debug
+```
+
+## `dev` 与 `start` 的唯一区别是缺省日志级别
+
+**刻意不提供文件监听自动重载。** Node 的 ESM 模块缓存无法真正清除 —— 每次重载都会永久留下一份
+旧模块连同其闭包。一个「保存即重载」的开发模式会让人在几十次保存之后面对一个内存里堆着几十份
+旧闭包的进程,而那时的行为已经无从解释。开发期改了插件,重启进程。
+
+## 主目录怎么定
+
+优先级:`--home` 参数 > `YZNG_HOME` 环境变量 > 便携模式标记 > 系统默认位置。
+
+Windows 的默认位置是 `%LOCALAPPDATA%\YunzaiNG`。**首次启动会打印它的实际位置** —— 这一条要紧,
+因为「我改的配置为什么不生效」几乎总是改错了目录。

package/dist/args.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 模块职责：命令行参数解析
+ * 依赖方向：无依赖
+ * 生命周期：纯函数
+ * 注意事项：手写实现而非引入 commander / yargs。CLI 的参数总计不足十个，
+ *          而这两个库各自会引入 10~30 个传递依赖 —— 对一个需在 Termux 上
+ *          执行 `pnpm install` 的框架而言，装机体积与安装时长是真实成本。
+ *
+ *          `--` 之后的内容原样收入 `rest`，不作解析：`yzng plugin new x -- --raw`
+ *          这类"将其余参数转交给下游"的场景需要该行为。
+ */
+/** 解析结果 */
+export interface ParsedArgs {
+    /** 子命令，未提供时为空串 */
+    readonly command: string;
+    /** 子命令之后的位置参数 */
+    readonly positional: readonly string[];
+    /** 长短选项；出现但未带值的记为 `true` */
+    readonly flags: Readonly<Record<string, string | boolean>>;
+    /** `--` 之后的原样内容 */
+    readonly rest: readonly string[];
+}
+/**
+ * 解析 `process.argv.slice(2)`
+ * @param argv 参数数组
+ * @returns 解析结果
+ */
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+/**
+ * 取字符串选项
+ * @param args 解析结果
+ * @param name 选项名
+ * @returns 值；未提供或仅为布尔开关时 undefined
+ */
+export declare function flagString(args: ParsedArgs, name: string): string | undefined;
+/**
+ * 取布尔选项
+ * @param args 解析结果
+ * @param name 选项名
+ * @param fallback 未提供时的取值
+ * @returns 布尔值
+ */
+export declare function flagBoolean(args: ParsedArgs, name: string, fallback?: boolean): boolean;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,iBAAiB;IACjB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAA;IAC1D,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAoBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA2D7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAKrF"}

package/dist/args.js

@@ -0,0 +1,116 @@
+/**
+ * 模块职责：命令行参数解析
+ * 依赖方向：无依赖
+ * 生命周期：纯函数
+ * 注意事项：手写实现而非引入 commander / yargs。CLI 的参数总计不足十个，
+ *          而这两个库各自会引入 10~30 个传递依赖 —— 对一个需在 Termux 上
+ *          执行 `pnpm install` 的框架而言，装机体积与安装时长是真实成本。
+ *
+ *          `--` 之后的内容原样收入 `rest`，不作解析：`yzng plugin new x -- --raw`
+ *          这类"将其余参数转交给下游"的场景需要该行为。
+ */
+/** 单字母短选项到长名的映射 */
+const SHORT = {
+    h: "help",
+    v: "version",
+    d: "debug",
+    c: "home"
+};
+/**
+ * 会带值的选项
+ *
+ * 必须显式列出，不可依据"下一个 token 不似选项即视为其值"推断 —— 该规则会使
+ * `yzng --debug start` 中的 `start` 被 `--debug` 并入，子命令因此为空，
+ * CLI 转而输出帮助，而使用者无从察觉问题所在。清单之外的选项一律为布尔开关；
+ * 确需为其传值时应写 `--新选项=值`，等号形式的优先级恒高于本清单。
+ */
+const VALUE_FLAGS = new Set(["home", "plugins", "port", "host"]);
+/**
+ * 解析 `process.argv.slice(2)`
+ * @param argv 参数数组
+ * @returns 解析结果
+ */
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    const rest = [];
+    let command = "";
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i] ?? "";
+        if (token === "--") {
+            rest.push(...argv.slice(i + 1));
+            break;
+        }
+        if (token.startsWith("--")) {
+            const body = token.slice(2);
+            const eq = body.indexOf("=");
+            if (eq >= 0) {
+                flags[body.slice(0, eq)] = body.slice(eq + 1);
+                continue;
+            }
+            if (body.startsWith("no-")) {
+                flags[body.slice(3)] = false;
+                continue;
+            }
+            // 仅清单内的选项会消耗下一个 token 作为其值。代价是以横杠开头的值
+            // （`--home -x`）须写作 `--home=-x`；该代价换取的是子命令绝不会被误并入
+            const next = argv[i + 1];
+            if (VALUE_FLAGS.has(body) && next !== undefined && !next.startsWith("-")) {
+                flags[body] = next;
+                i++;
+            }
+            else {
+                flags[body] = true;
+            }
+            continue;
+        }
+        if (token.startsWith("-") && token.length > 1) {
+            // 允许 `-dv` 形式的合并写法；合并时仅最后一个字母可能带值
+            const letters = [...token.slice(1)];
+            for (let k = 0; k < letters.length; k++) {
+                const name = SHORT[letters[k] ?? ""] ?? letters[k] ?? "";
+                const last = k === letters.length - 1;
+                const next = argv[i + 1];
+                if (last && VALUE_FLAGS.has(name) && next !== undefined && !next.startsWith("-")) {
+                    flags[name] = next;
+                    i++;
+                }
+                else {
+                    flags[name] = true;
+                }
+            }
+            continue;
+        }
+        if (command === "")
+            command = token;
+        else
+            positional.push(token);
+    }
+    return { command, positional, flags, rest };
+}
+/**
+ * 取字符串选项
+ * @param args 解析结果
+ * @param name 选项名
+ * @returns 值；未提供或仅为布尔开关时 undefined
+ */
+export function flagString(args, name) {
+    const value = args.flags[name];
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+/**
+ * 取布尔选项
+ * @param args 解析结果
+ * @param name 选项名
+ * @param fallback 未提供时的取值
+ * @returns 布尔值
+ */
+export function flagBoolean(args, name, fallback = false) {
+    const value = args.flags[name];
+    if (value === undefined)
+        return fallback;
+    if (typeof value === "boolean")
+        return value;
+    return value !== "false" && value !== "0";
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * 模块职责：`yzng` 可执行入口 —— 唯一允许调用 `process.exit` 的位置
+ * 依赖方向：仅调用 run()
+ * 生命周期：进程入口
+ * 注意事项：**未捕获异常在此处理，而非交由 Node 缺省处理。** Node 缺省会输出
+ *          完整调用栈，其中绝大部分为内核与 fastify 的栈帧；对使用者不具信息量，
+ *          反而将真正有用的第一行挤出屏幕。此处仅输出消息，调用栈保留给 `--debug`。
+ *
+ *          `unhandledRejection` 必须显式接管：自 Node 20 起其缺省行为是终止进程，
+ *          而"某个插件的 promise 未附加 catch"不应导致整个机器人下线。
+ */
+import process from "node:process";
+import { run } from "./run.js";
+/**
+ * 输出一条致命错误
+ * @param label 场景
+ * @param err 错误
+ */
+function fatal(label, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`\n${label}：${message}\n`);
+    if (err instanceof Error && err.stack !== undefined && process.argv.includes("--debug")) {
+        process.stderr.write(`${err.stack}\n`);
+    }
+    else {
+        process.stderr.write("附加 --debug 可查看完整调用栈\n");
+    }
+}
+process.on("unhandledRejection", reason => {
+    fatal("未处理的 promise 拒绝", reason);
+});
+try {
+    process.exitCode = await run(process.argv.slice(2));
+}
+catch (err) {
+    fatal("命令执行失败", err);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AACH,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B;;;;GAIG;AACH,SAAS,KAAK,CAAC,KAAa,EAAE,GAAY;IACxC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,CAAA;IAC/C,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE;IACxC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+/** 自检参数 */
+export interface DoctorOptions {
+    /** 应用主目录 */
+    readonly home?: string | undefined;
+    /** 待探测的面板端口，缺省 2536（与配置缺省值一致） */
+    readonly port?: number | undefined;
+    /** 待探测的监听地址 */
+    readonly host?: string | undefined;
+}
+/**
+ * 执行一次环境自检
+ * @param opts 参数
+ * @returns 进程退出码；存在 error 级问题时为 1
+ */
+export declare function runDoctor(opts?: DoctorOptions): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAwJA,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,eAAe;IACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCzE"}

package/dist/commands/doctor.js

@@ -0,0 +1,181 @@
+/**
+ * 模块职责：`yzng doctor` —— 环境自检：运行环境、目录、可选原生依赖、端口占用
+ * 依赖方向：依赖 @yunzai-ng/core 的公开入口与 node:net
+ * 生命周期：一次性，执行完毕即退出
+ * 注意事项：**每一项均须给出后续处置方式，否则本命令不具备存在价值。**
+ *          一句"Redis 连接失败"不指明该改哪里，等于把排障推回给使用者；故每条不合格项
+ *          都附一条可执行的下一步。
+ *
+ *          退出码：存在 `error` 级问题时为 1，仅有 `warn` 时仍为 0 ——
+ *          `yzng doctor && yzng start` 是自然的用法，不应被"尚未配置账号"一类提示阻断。
+ */
+import net from "node:net";
+import process from "node:process";
+import { createRequire } from "node:module";
+import { access } from "node:fs/promises";
+import { detectPlatform, resolvePaths, sampleUsage } from "@yunzai-ng/core";
+import { bold, cyan, dim, green, print, printRows, red, yellow } from "../terminal.js";
+/** Node 最低版本，与根 package.json 的 engines 保持一致 */
+const MIN_NODE_MAJOR = 20;
+/**
+ * 检查 Node 版本
+ * @returns 结论
+ */
+function checkNode() {
+    const major = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+    if (major >= MIN_NODE_MAJOR)
+        return { level: "ok", title: "Node 版本", detail: process.version };
+    return {
+        level: "error",
+        title: "Node 版本",
+        detail: `${process.version}，低于要求的 ${MIN_NODE_MAJOR}`,
+        next: "将 Node 升级至 20.11 或更高版本：内核使用了 import.meta.dirname 与原生 ESM 解析"
+    };
+}
+/**
+ * 检查一个可选原生依赖能否加载
+ *
+ * **解析基准必须是内核而非 CLI 自身。** pnpm 的隔离式 node_modules 将
+ * `classic-level` 安装于 `packages/core/node_modules` 之下，CLI 的模块图中并不含有
+ * 该包 —— 自 CLI 自身解析将一律得到"未安装"，而该结论会将使用者引向
+ * 一个并不存在的问题（去安装一个实际已安装完毕的包）。
+ *
+ * 使用 `createRequire` 而非 `await import()`：这两个包均为 CommonJS 原生扩展，
+ * 而此处需要区分的是"未安装"与"已安装但 ABI 不匹配"—— 仅 `require` 的报错信息中
+ * 携带 `NODE_MODULE_VERSION` 一段，动态 import 会将其重新包装并丢失该细节。
+ * @param name 包名
+ * @param purpose 该包的用途
+ * @param fallback 缺失时的降级说明
+ * @returns 结论
+ */
+function checkNative(name, purpose, fallback) {
+    const self = createRequire(import.meta.url);
+    let require = self;
+    try {
+        require = createRequire(self.resolve("@yunzai-ng/core/package.json"));
+    }
+    catch {
+        // 未找到内核时退回自身解析：此情形下 CLI 属于单独安装，
+        // 报告"未安装"至少不构成误导，而真正的问题（内核缺失）由其他检查项覆盖
+    }
+    try {
+        require.resolve(name);
+    }
+    catch {
+        return { level: "warn", title: name, detail: `未安装（${purpose}）`, next: `${fallback}。需要时执行：pnpm add -w ${name}` };
+    }
+    try {
+        require(name);
+        return { level: "ok", title: name, detail: `可用（${purpose}）` };
+    }
+    catch (err) {
+        return {
+            level: "warn",
+            title: name,
+            detail: `已安装但加载失败：${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
+            next: `原生模块与当前 Node ABI 不匹配，重建即可解决：pnpm rebuild ${name}。${fallback}`
+        };
+    }
+}
+/**
+ * 检查目录可达
+ * @param label 检查项名称
+ * @param dir 路径
+ * @returns 结论
+ */
+async function checkDir(label, dir) {
+    try {
+        await access(dir);
+        return { level: "ok", title: label, detail: cyan(dir) };
+    }
+    catch {
+        return {
+            level: "warn",
+            title: label,
+            detail: `${cyan(dir)} ${dim("尚不存在")}`,
+            next: "首次启动时将自动创建；亦可先执行 yzng init"
+        };
+    }
+}
+/**
+ * 检查端口是否可监听
+ *
+ * 实际执行一次 bind 而非查询进程列表：其行为跨平台一致，且"能否监听"本身即为
+ * 内核关注的问题 —— 端口被同一用户的另一实例占用，与被防火墙策略拦截，
+ * 对启动而言结果相同。
+ * @param host 监听地址
+ * @param port 端口
+ * @returns 结论
+ */
+function checkPort(host, port) {
+    return new Promise(resolve => {
+        const probe = net.createServer();
+        probe.once("error", (err) => {
+            resolve({
+                level: "error",
+                title: "面板端口",
+                detail: `${host}:${port} 不可用（${err.code ?? err.message}）`,
+                next: err.code === "EADDRINUSE"
+                    ? "该端口已被其他程序占用（通常为另一个 Yunzai 实例）。请修改 config/yunzai.yaml 中的 server.port，或先停止该程序"
+                    : "请检查监听地址是否属于本机网卡"
+            });
+        });
+        probe.once("listening", () => {
+            probe.close(() => resolve({ level: "ok", title: "面板端口", detail: `${host}:${port} 可用` }));
+        });
+        probe.listen(port, host);
+    });
+}
+/**
+ * 输出一条结论
+ * @param finding 结论
+ */
+function printFinding(finding) {
+    const mark = finding.level === "ok" ? green("✓") : finding.level === "warn" ? yellow("!") : red("✗");
+    print(`  ${mark} ${finding.title}  ${finding.detail}`);
+    if (finding.next !== undefined)
+        print(`      ${dim(`→ ${finding.next}`)}`);
+}
+/**
+ * 执行一次环境自检
+ * @param opts 参数
+ * @returns 进程退出码；存在 error 级问题时为 1
+ */
+export async function runDoctor(opts = {}) {
+    const platform = detectPlatform();
+    const paths = resolvePaths({ home: opts.home });
+    const usage = sampleUsage();
+    print();
+    print(`  ${bold("环境")}`);
+    printRows([
+        ["系统", `${platform.os}/${platform.arch}${platform.isTermux ? " · Termux" : ""}${platform.isContainer ? " · 容器" : ""}`],
+        ["Node", platform.nodeVersion],
+        ["CPU", `${platform.cpus} 核`],
+        ["常驻内存", `${(usage.rss / 1024 / 1024).toFixed(1)} MB`]
+    ]);
+    const findings = [
+        checkNode(),
+        await checkDir("主目录", paths.home),
+        await checkDir("配置目录", paths.config),
+        await checkDir("数据目录", paths.data),
+        checkNative("classic-level", "内嵌 KV，用于计数与冷却", "缺失时内核降级为 JSON 文件存储，功能不受影响但写入速度较低"),
+        checkNative("better-sqlite3", "关系数据，用于插件建表", "缺失时依赖 SQL 的插件将取得一条错误说明，而非静默失效"),
+        await checkPort(opts.host ?? "127.0.0.1", opts.port ?? 2536)
+    ];
+    print();
+    print(`  ${bold("检查")}`);
+    for (const finding of findings)
+        printFinding(finding);
+    const errors = findings.filter(f => f.level === "error").length;
+    const warns = findings.filter(f => f.level === "warn").length;
+    print();
+    if (errors > 0)
+        print(`  ${red(`${errors} 项需要处理`)}${warns > 0 ? dim(`，${warns} 项提示`) : ""}`);
+    else if (warns > 0)
+        print(`  ${yellow(`${warns} 项提示`)}${dim("，不影响启动")}`);
+    else
+        print(`  ${green("全部检查项正常")}`);
+    print();
+    return errors > 0 ? 1 : 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,12 @@
+/** 初始化参数 */
+export interface InitOptions {
+    /** 应用主目录；缺省时按内核的探测顺序确定 */
+    readonly home?: string | undefined;
+}
+/**
+ * 建立主目录与缺省配置
+ * @param opts 参数
+ * @returns 进程退出码
+ */
+export declare function runInit(opts?: InitOptions): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAiBA,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCrE"}

package/dist/commands/init.js

@@ -0,0 +1,61 @@
+/**
+ * 模块职责：`yzng init` —— 在主目录中建立目录布局与缺省配置文件
+ * 依赖方向：依赖 @yunzai-ng/core 的公开入口
+ * 生命周期：一次性，执行完毕即退出
+ * 注意事项：**刻意不经由 `createApp()`。** `createApp` 会一并打开 KV 数据库、
+ *          建立 HTTP 客户端连接池、装配插件宿主 —— 在"仅需查看配置文件结构"
+ *          的场景中，上述工作均属额外开销，且 KV 无法打开时会直接抛出异常，
+ *          使一次本应成功的初始化转为失败。此处仅执行两项必要工作：建立目录、
+ *          声明配置（从而将缺省值落盘）。
+ *
+ *          幂等：已存在的目录与配置文件均不会被覆盖（`ConfigStore` 仅在文件
+ *          缺失时写入缺省值），因此对一个已长期运行的实例再次执行 init 是安全的。
+ */
+import { ConfigStore, createLoggerHub, defineCoreConfig, ensurePaths, resolvePaths } from "@yunzai-ng/core";
+import { linkFramework } from "../link.js";
+import { bold, cyan, dim, green, print, printErr, printRows, red, yellow } from "../terminal.js";
+/**
+ * 建立主目录与缺省配置
+ * @param opts 参数
+ * @returns 进程退出码
+ */
+export async function runInit(opts = {}) {
+    // 仅输出至控制台、级别限制为 warn：ConfigStore 自身会输出"已写出缺省配置"一类的
+    // info，而本命令需要给出的是一份经过整理的清单，两者叠加将降低可读性
+    const hub = createLoggerHub({ level: "warn", console: true });
+    try {
+        const paths = await ensurePaths(resolvePaths({ home: opts.home }));
+        const store = new ConfigStore({ dir: paths.config, logger: hub.root, watch: false });
+        const config = await defineCoreConfig(store);
+        const link = await linkFramework(paths.home);
+        print();
+        print(`  ${bold(green("已就绪"))} ${dim("目录与缺省配置均已建立")}`);
+        print();
+        printRows([
+            ["主目录", cyan(paths.home)],
+            ["配置", cyan(paths.config)],
+            ["数据", cyan(paths.data)],
+            ["日志", cyan(paths.logs)],
+            ["插件", cyan(paths.plugins)],
+            ["临时", cyan(paths.temp)]
+        ]);
+        print();
+        if (link.failed.length > 0) {
+            print(`  ${yellow("!")} 框架包未能链接至主目录，插件将无法 import @yunzai-ng/core`);
+            for (const [name, reason] of link.failed)
+                print(`      ${dim(`${name}：${reason}`)}`);
+            print();
+        }
+        print(`  ${dim("下一步")} ${cyan("yzng start")} ${dim(`随后访问 http://${config.get().server.host}:${config.get().server.port}/`)}`);
+        print();
+        return 0;
+    }
+    catch (err) {
+        printErr(red(`初始化失败：${err instanceof Error ? err.message : String(err)}`));
+        return 1;
+    }
+    finally {
+        hub.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/plugin.d.ts

@@ -0,0 +1,14 @@
+/** 脚手架参数 */
+export interface PluginNewOptions {
+    /** 插件名 */
+    readonly name: string;
+    /** 应用主目录 */
+    readonly home?: string | undefined;
+}
+/**
+ * 生成插件骨架
+ * @param opts 参数
+ * @returns 进程退出码
+ */
+export declare function runPluginNew(opts: PluginNewOptions): Promise<number>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/commands/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAmBA,YAAY;AACZ,MAAM,WAAW,gBAAgB;IAC/B,UAAU;IACV,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAmED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC1E"}