@skillbuilder/minitool-cli 0.0.0-beta-20261027053041051

package/lib/utils/templates.js

@@ -0,0 +1,75 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPLATE_CATEGORIES = void 0;
+exports.loadTemplatesConfig = loadTemplatesConfig;
+exports.resolveTemplatePath = resolveTemplatePath;
+exports.selectTemplate = selectTemplate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const TEMPLATES_ROOT = path_1.default.join(__dirname, "../../templates");
+exports.TEMPLATE_CATEGORIES = {
+    "cloud-agents": path_1.default.join(TEMPLATES_ROOT, "cloud-agents"),
+    "cloud-dev": path_1.default.join(TEMPLATES_ROOT, "cloud-dev"),
+};
+function loadTemplatesConfig(category) {
+    const categoryDir = exports.TEMPLATE_CATEGORIES[category];
+    const configPath = path_1.default.join(categoryDir, "templates.json");
+    if (!fs_1.default.existsSync(configPath)) {
+        return [];
+    }
+    try {
+        const content = fs_1.default.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        if (!Array.isArray(config.templates))
+            return [];
+        return config.templates.filter((t) => {
+            const templateDir = path_1.default.join(categoryDir, t.id);
+            return fs_1.default.existsSync(templateDir) && fs_1.default.statSync(templateDir).isDirectory();
+        });
+    }
+    catch (_a) {
+        return [];
+    }
+}
+function resolveTemplatePath(category, templateId) {
+    return path_1.default.join(exports.TEMPLATE_CATEGORIES[category], templateId);
+}
+function selectTemplate(category, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const templates = loadTemplatesConfig(category);
+        if (templates.length === 0) {
+            throw new Error(`未找到可用模板，请检查 ${exports.TEMPLATE_CATEGORIES[category]}/templates.json`);
+        }
+        if (options.template) {
+            const found = templates.find((t) => t.id === options.template);
+            if (found)
+                return found.id;
+            throw new Error(`模板 "${options.template}" 不存在。可用: ${templates.map((t) => t.id).join(", ")}`);
+        }
+        const { templateId } = yield inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "templateId",
+                message: "请选择模板：",
+                choices: templates.map((t) => ({
+                    name: `${t.name} - ${t.desc}`,
+                    value: t.id,
+                })),
+            },
+        ]);
+        return templateId;
+    });
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@skillbuilder/minitool-cli",
+  "version": "0.0.0-beta-20261027053041051",
+  "description": "小红书小工具 CLI，面向创作者、三方 AI 工具和自动化流程",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "lib/index.js",
+  "types": "types/index.d.ts",
+  "bin": {
+    "redminitool": "./bin/redminitool.js",
+    "red-minitool": "./bin/redminitool.js",
+    "xhs-minitool": "./bin/redminitool.js",
+    "minitool": "./bin/redminitool.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "types"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.25.3",
+    "chalk": "^2.4.2",
+    "cli-table3": "^0.5.1",
+    "commander": "7",
+    "didyoumean": "^1.2.2",
+    "inquirer": "^6.5.2",
+    "jszip": "^3.10.1",
+    "log-symbols": "^3.0.0",
+    "open": "^7.4.2",
+    "ora": "^4.0.2",
+    "semver": "^7.3.7",
+    "update-notifier": "^4.0.0",
+    "yargs-parser": "^21.0.1",
+    "zod": "4.3.5",
+    "qrcode": "^1.5.4",
+    "@skillbuilder/endpoints": "0.0.0-beta-20261027053041051",
+    "@skillbuilder/minitool-cli-auth": "0.0.0-beta-20261027053041051",
+    "@skillbuilder/minitool-cli-config": "0.0.0-beta-20261027053041051",
+    "@skillbuilder/minitool-core": "0.0.0-beta-20261027053041051",
+    "@skillbuilder/miniapp-simulator": "0.0.0-beta-20261027053041051",
+    "@skillbuilder/minitool-e2e": "0.0.0-beta-20261027053041051"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC"
+}

package/types/bootstrap.d.ts

@@ -0,0 +1,14 @@
+import { type AuthService, type CredentialStorageController, DeviceAuthService } from "@skillbuilder/minitool-cli-auth";
+import { type MinitoolRuntime } from "@skillbuilder/minitool-core";
+export interface CliServiceGraph extends MinitoolRuntime {
+    readonly auth: AuthService & Pick<DeviceAuthService, "loginWithQr" | "cancelLogin">;
+    readonly credentialStorage: CredentialStorageController;
+    readonly environment: "prod" | "beta";
+}
+export interface CliServiceOptions {
+    environment?: string;
+    homeDir?: string;
+    apiBaseUrl?: string;
+    request?: typeof fetch;
+}
+export declare function createCliServices(options?: CliServiceOptions): CliServiceGraph;

package/types/commands/auth/identity.d.ts

@@ -0,0 +1,9 @@
+import { Command, type ICommandOptions } from "../../core/base";
+export declare class AuthStatusCommand extends Command {
+    execute(ctx: any): Promise<import("@skillbuilder/minitool-cli-auth").AuthState>;
+    get options(): ICommandOptions;
+}
+export declare class WhoAmICommand extends Command {
+    execute(ctx: any): Promise<import("@skillbuilder/minitool-cli-auth").CreatorIdentity>;
+    get options(): ICommandOptions;
+}

package/types/commands/auth/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./login";
+export * from "./logout";
+export * from "./identity";
+export * from "./storage";

package/types/commands/auth/login.d.ts

@@ -0,0 +1,13 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class LoginCommand extends Command {
+    execute(ctx: ICommandContext): Promise<{
+        authenticated: boolean;
+        creator: any;
+        credentialStore: "file" | "keychain";
+        credentialProvider: string;
+        expiresAt: any;
+    } | {
+        cancelled: boolean;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/auth/logout.d.ts

@@ -0,0 +1,7 @@
+import { Command, type ICommandOptions } from "../../core/base";
+export declare class LogoutCommand extends Command {
+    execute(ctx: any): Promise<{
+        loggedOut: true;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/auth/storage.d.ts

@@ -0,0 +1,14 @@
+import { Command, type ICommandOptions } from "../../core/base";
+export declare class AuthStorageCommand extends Command {
+    execute(ctx: any): Promise<{
+        authReason?: "credential_store_error" | "not_logged_in" | "expired";
+        authState: "authenticated" | "anonymous" | "unavailable";
+        sourceRetained?: boolean;
+        keyringIssue?: "package_unavailable" | "access_error";
+        keyringAvailable?: boolean;
+        credentialStore: "file" | "keychain";
+        provider: string;
+        protection: "restricted_plaintext_file" | "os_protected_store";
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/dev/dev.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/commands/dev.d.ts

@@ -0,0 +1,8 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../core/base";
+export declare class DevCommand extends Command {
+    execute(ctx: ICommandContext): Promise<{
+        rootDir: string;
+        workbenchUrl: string;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./auth";
+export * from "./dev";
+export * from "./minitool";

package/types/commands/minitool/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/commands/minitool/commands.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/commands/minitool/common.d.ts

@@ -0,0 +1,12 @@
+import type { ICommandContext } from "../../core/base";
+export declare const sourceOption: {
+    flags: string;
+    desc: string;
+};
+export declare const writeOptions: {
+    flags: string;
+    desc: string;
+}[];
+export declare function source(ctx: ICommandContext): string;
+export declare function payloadFile(ctx: ICommandContext): Record<string, unknown>;
+export declare function confirmWrite(ctx: ICommandContext, message: string): Promise<boolean>;

package/types/commands/minitool/config.d.ts

@@ -0,0 +1,5 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolConfigCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolConfig>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/edit.d.ts

@@ -0,0 +1,20 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolEditCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolReviewResult | {
+        dryRun: boolean;
+        input: {
+            appId: string;
+            appName: string;
+            slogan: string;
+            iconFileId: string;
+            source: string;
+            coverFileId?: string;
+        };
+        cancelled?: undefined;
+    } | {
+        cancelled: boolean;
+        dryRun?: undefined;
+        input?: undefined;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/history.d.ts

@@ -0,0 +1,5 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolHistoryCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolHistory>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./list";
+export * from "./preview";
+export * from "./status";
+export * from "./submit";
+export * from "./upload";
+export * from "./config";
+export * from "./history";
+export * from "./edit";

package/types/commands/minitool/list.d.ts

@@ -0,0 +1,5 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolListCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolPage>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/preview.d.ts

@@ -0,0 +1,23 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolPreviewCommand extends Command {
+    execute(ctx: ICommandContext): Promise<{
+        [x: string]: unknown;
+        previewUrl: string;
+    } | {
+        dryRun: boolean;
+        input: {
+            pkgFileId: string;
+            md5: string;
+            source: string;
+            appName?: string;
+            iconFileId?: string;
+            version?: string;
+        };
+        cancelled?: undefined;
+    } | {
+        cancelled: boolean;
+        dryRun?: undefined;
+        input?: undefined;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/status.d.ts

@@ -0,0 +1,5 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolStatusCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolSummary>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/submit.d.ts

@@ -0,0 +1,25 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolSubmitCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolReviewResult | {
+        dryRun: boolean;
+        input: {
+            appName: string;
+            slogan: string;
+            iconFileId: string;
+            coverFileId: string;
+            version: string;
+            pkgFileId: string;
+            md5: string;
+            categories: string[];
+            authorizations: string[];
+            source: string;
+            appId?: string;
+        };
+        cancelled?: undefined;
+    } | {
+        cancelled: boolean;
+        dryRun?: undefined;
+        input?: undefined;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/commands/minitool/upload.d.ts

@@ -0,0 +1,20 @@
+import { Command, type ICommandContext, type ICommandOptions } from "../../core/base";
+export declare class MiniToolUploadCommand extends Command {
+    execute(ctx: ICommandContext): Promise<import("@skillbuilder/minitool-core").MiniToolUploadResult | {
+        dryRun: boolean;
+        file: {
+            filePath: string;
+            type: "pkg" | "image";
+            format: string;
+            size: number;
+            md5: string;
+            sha256: string;
+        };
+        cancelled?: undefined;
+    } | {
+        cancelled: boolean;
+        dryRun?: undefined;
+        file?: undefined;
+    }>;
+    get options(): ICommandOptions;
+}

package/types/core/base.d.ts

@@ -0,0 +1,37 @@
+import { program } from "commander";
+import type { CliServiceGraph } from "../bootstrap";
+type Commander = typeof program;
+export declare const registrableCommands: Array<{
+    Command: CommandConstructor;
+}>;
+export declare function ICommand(): ClassDecorator;
+export interface ICommandOptions {
+    cmd: string;
+    childCmd?: {
+        cmd: string;
+        desc: string;
+    };
+    rootAlias?: boolean;
+    desc: string;
+    options: Array<{
+        flags: string;
+        desc: string;
+        hideHelp?: boolean;
+    }>;
+}
+export interface ICommandContext {
+    options: Record<string, unknown>;
+    params: unknown[];
+    services: CliServiceGraph;
+}
+export type CommandConstructor = new (services: CliServiceGraph) => Command;
+export declare abstract class Command {
+    readonly services: CliServiceGraph;
+    constructor(services: CliServiceGraph);
+    init(root?: Commander): void;
+    private configure;
+    protected isJson(ctx: ICommandContext): boolean;
+    abstract execute(ctx: ICommandContext): Promise<unknown> | unknown;
+    abstract get options(): ICommandOptions;
+}
+export {};

package/types/decorators/auth.d.ts

@@ -0,0 +1 @@
+export declare function AuthGuard(): ClassDecorator;

package/types/decorators/captureError.d.ts

@@ -0,0 +1 @@
+export declare function CaptureError(): MethodDecorator;

package/types/decorators/constants.d.ts

@@ -0,0 +1,7 @@
+export declare enum ParamTypes {
+    Credential = "Credential",
+    Log = "Log",
+    CmdContext = "CmdContext",
+    ArgsOptions = "ArgsOptions",
+    ArgsParams = "ArgsParams"
+}

package/types/decorators/decorators.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/decorators/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./auth";
+export * from "./captureError";
+export * from "./injectParams";
+export * from "./json-output";
+export * from "./params";

package/types/decorators/injectParams.d.ts

@@ -0,0 +1 @@
+export declare function InjectParams(): MethodDecorator;

package/types/decorators/json-output.d.ts

@@ -0,0 +1,2 @@
+export declare function JsonOutput(): ClassDecorator;
+export declare function isJsonOutputEnabled(target: object): boolean;

package/types/decorators/params/common.d.ts

@@ -0,0 +1,10 @@
+import type { ICommandContext } from "../../core/base";
+import type { ParamTypes } from "../constants";
+export type ParamGetter = (context: ICommandContext) => unknown | Promise<unknown>;
+export interface ParamBinding {
+    type: ParamTypes;
+    index: number;
+    getter: ParamGetter;
+}
+export declare function createParamDecorator(type: ParamTypes, getter: ParamGetter): () => ParameterDecorator;
+export declare function getParamBindings(method: Function): readonly ParamBinding[];

package/types/decorators/params/index.d.ts

@@ -0,0 +1,5 @@
+export declare const Credential: () => ParameterDecorator;
+export declare const Log: () => ParameterDecorator;
+export declare const CmdContext: () => ParameterDecorator;
+export declare const ArgsOptions: () => ParameterDecorator;
+export declare const ArgsParams: () => ParameterDecorator;

package/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./main";
+export * from "./bootstrap";

package/types/main.d.ts

@@ -0,0 +1,5 @@
+import { program } from "commander";
+import { type CliServiceGraph } from "./bootstrap";
+import "./commands";
+export declare function registerCommands(services?: CliServiceGraph, root?: typeof program): Promise<void>;
+export { flushCliApm } from "@skillbuilder/minitool-core";

package/types/mcp.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type MinitoolE2EMcpServerOptions } from "@skillbuilder/minitool-e2e";
+import { type CliServiceGraph, type CliServiceOptions } from "./bootstrap";
+export interface MinitoolMcpServerOptions extends MinitoolE2EMcpServerOptions {
+    services?: CliServiceGraph;
+    mcpUploadRoot?: string;
+}
+export declare function createMinitoolMcpServer(opts?: MinitoolMcpServerOptions): McpServer;
+export declare function runMcpCommand(options?: CliServiceOptions): Promise<void>;

package/types/output.d.ts

@@ -0,0 +1,4 @@
+import { outputHelpInfo } from "@skillbuilder/minitool-core";
+export declare const output: {
+    helpInfo: typeof outputHelpInfo;
+};

package/types/ui.d.ts

@@ -0,0 +1,4 @@
+export declare function printHeading(title: string, subtitle?: string): void;
+export declare function printDetails(rows: Array<[string, string | undefined]>): void;
+export declare function printHint(message: string): void;
+export declare function printTable(headers: string[], rows: string[][]): void;

package/types/utils/agent-check.d.ts

@@ -0,0 +1,16 @@
+export interface LegacyAgentLookup {
+    getAgentInfoById(agentId: string): Promise<{
+        agentId: string;
+        agentName?: string;
+        description?: string;
+    } | null>;
+    getAgentList(page: {
+        pageNo: number;
+        pageSize: number;
+    }): Promise<Array<{
+        agentId: string;
+        agentName?: string;
+        description?: string;
+    }>>;
+}
+export declare function checkAndGuideAgentProject(workDir: string, services: LegacyAgentLookup): Promise<string | undefined>;

package/types/utils/templates.d.ts

@@ -0,0 +1,17 @@
+export interface TemplateEntry {
+    id: string;
+    name: string;
+    desc: string;
+}
+export interface TemplatesConfig {
+    templates: TemplateEntry[];
+}
+export declare const TEMPLATE_CATEGORIES: {
+    readonly "cloud-agents": string;
+    readonly "cloud-dev": string;
+};
+export declare function loadTemplatesConfig(category: keyof typeof TEMPLATE_CATEGORIES): TemplateEntry[];
+export declare function resolveTemplatePath(category: keyof typeof TEMPLATE_CATEGORIES, templateId: string): string;
+export declare function selectTemplate(category: keyof typeof TEMPLATE_CATEGORIES, options: {
+    template?: string;
+}): Promise<string>;