@skillbuilder/minitool-cli 0.0.0-beta-20261027053041051

package/lib/decorators/decorators.test.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert_1 = require("assert");
+const _1 = require(".");
+const test = require("node:test");
+function context(status) {
+    return {
+        options: { page: 2 },
+        params: ["sample"],
+        services: {
+            auth: {
+                getAuthState: () => __awaiter(this, void 0, void 0, function* () {
+                    return status === "authenticated"
+                        ? {
+                            status: "authenticated",
+                            method: "secret",
+                            source: "local_file",
+                            identitySnapshot: null,
+                            expiresAt: "2030-01-01T00:00:00.000Z",
+                        }
+                        : status === "unavailable"
+                            ? { status: "unavailable", reason: "credential_store_error" }
+                            : { status: "anonymous", reason: "not_logged_in" };
+                }),
+            },
+        },
+    };
+}
+test("AuthGuard 使用当前登录态，不执行未登录命令", () => __awaiter(void 0, void 0, void 0, function* () {
+    let invoked = false;
+    let ProtectedCommand = class ProtectedCommand {
+        execute(_ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                invoked = true;
+            });
+        }
+    };
+    ProtectedCommand = __decorate([
+        (0, _1.AuthGuard)()
+    ], ProtectedCommand);
+    const command = new ProtectedCommand();
+    yield assert_1.strict.rejects(command.execute(context("anonymous")), { code: "AUTHENTICATION_REQUIRED" });
+    yield assert_1.strict.rejects(command.execute(context("unavailable")), {
+        code: "CREDENTIAL_STORE_UNAVAILABLE",
+    });
+    assert_1.strict.equal(invoked, false);
+    yield command.execute(context("authenticated"));
+    assert_1.strict.equal(invoked, true);
+}));
+test("InjectParams 注入命令参数和脱敏会话，不注入原始秘钥", () => __awaiter(void 0, void 0, void 0, function* () {
+    class ParamCommand {
+        execute(options, params, credential) {
+            return __awaiter(this, void 0, void 0, function* () {
+                return { options, params, credential };
+            });
+        }
+    }
+    __decorate([
+        (0, _1.InjectParams)(),
+        __param(0, (0, _1.ArgsOptions)()),
+        __param(1, (0, _1.ArgsParams)()),
+        __param(2, (0, _1.Credential)()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [Object, Array, Object]),
+        __metadata("design:returntype", Promise)
+    ], ParamCommand.prototype, "execute", null);
+    const result = yield new ParamCommand().execute(context("authenticated"), [], { status: "anonymous" });
+    assert_1.strict.deepEqual(result.options, { page: 2 });
+    assert_1.strict.deepEqual(result.params, ["sample"]);
+    assert_1.strict.equal(result.credential.status, "authenticated");
+    assert_1.strict.equal(JSON.stringify(result).includes("sessionToken"), false);
+    assert_1.strict.equal(JSON.stringify(result).includes("secretKey"), false);
+}));

package/lib/decorators/index.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth"), exports);
+__exportStar(require("./captureError"), exports);
+__exportStar(require("./injectParams"), exports);
+__exportStar(require("./json-output"), exports);
+__exportStar(require("./params"), exports);

package/lib/decorators/injectParams.js

@@ -0,0 +1,30 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectParams = InjectParams;
+const common_1 = require("./params/common");
+function InjectParams() {
+    return (_target, _key, descriptor) => {
+        const original = descriptor.value;
+        if (typeof original !== "function")
+            return descriptor;
+        const bindings = (0, common_1.getParamBindings)(original);
+        descriptor.value = function (context, ...rest) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const args = [context, ...rest];
+                for (const { index, getter } of bindings)
+                    args[index] = yield getter(context);
+                return original.apply(this, args);
+            });
+        };
+        return descriptor;
+    };
+}

package/lib/decorators/json-output.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonOutput = JsonOutput;
+exports.isJsonOutputEnabled = isJsonOutputEnabled;
+const JSON_OUTPUT_ENABLED = Symbol("redminitool.json-output-enabled");
+function JsonOutput() {
+    return (target) => {
+        Object.defineProperty(target.prototype, JSON_OUTPUT_ENABLED, {
+            configurable: false,
+            enumerable: false,
+            value: true,
+            writable: false,
+        });
+    };
+}
+function isJsonOutputEnabled(target) {
+    return target[JSON_OUTPUT_ENABLED] === true;
+}

package/lib/decorators/params/common.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createParamDecorator = createParamDecorator;
+exports.getParamBindings = getParamBindings;
+const bindings = new WeakMap();
+function createParamDecorator(type, getter) {
+    return () => (target, key, index) => {
+        var _a;
+        if (key === undefined)
+            throw new Error("CLI 参数装饰器只能用于命令方法");
+        const method = target[key];
+        if (typeof method !== "function")
+            throw new Error("CLI 参数装饰器目标必须是方法");
+        const existing = (_a = bindings.get(method)) !== null && _a !== void 0 ? _a : [];
+        bindings.set(method, [...existing, { type, index, getter }]);
+    };
+}
+function getParamBindings(method) {
+    var _a;
+    return (_a = bindings.get(method)) !== null && _a !== void 0 ? _a : [];
+}

package/lib/decorators/params/index.js

@@ -0,0 +1,24 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgsParams = exports.ArgsOptions = exports.CmdContext = exports.Log = exports.Credential = void 0;
+const minitool_cli_auth_1 = require("@skillbuilder/minitool-cli-auth");
+const minitool_core_1 = require("@skillbuilder/minitool-core");
+const constants_1 = require("../constants");
+const common_1 = require("./common");
+exports.Credential = (0, common_1.createParamDecorator)(constants_1.ParamTypes.Credential, (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+    const state = yield ctx.services.auth.getAuthState();
+    return (0, minitool_cli_auth_1.requireAuthenticatedAuthState)(state);
+}));
+exports.Log = (0, common_1.createParamDecorator)(constants_1.ParamTypes.Log, () => minitool_core_1.logger);
+exports.CmdContext = (0, common_1.createParamDecorator)(constants_1.ParamTypes.CmdContext, (ctx) => ctx);
+exports.ArgsOptions = (0, common_1.createParamDecorator)(constants_1.ParamTypes.ArgsOptions, (ctx) => ctx.options);
+exports.ArgsParams = (0, common_1.createParamDecorator)(constants_1.ParamTypes.ArgsParams, (ctx) => ctx.params);

package/lib/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./main"), exports);
+__exportStar(require("./bootstrap"), exports);

package/lib/main.js

@@ -0,0 +1,26 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flushCliApm = void 0;
+exports.registerCommands = registerCommands;
+const minitool_core_1 = require("@skillbuilder/minitool-core");
+const commander_1 = require("commander");
+const bootstrap_1 = require("./bootstrap");
+const base_1 = require("./core/base");
+require("./commands");
+function registerCommands() {
+    return __awaiter(this, arguments, void 0, function* (services = (0, bootstrap_1.createCliServices)(), root = commander_1.program) {
+        (0, minitool_core_1.initCliApm)({ cliVersion: process.CLI_VERSION });
+        base_1.registrableCommands.forEach(({ Command }) => new Command(services).init(root));
+    });
+}
+var minitool_core_2 = require("@skillbuilder/minitool-core");
+Object.defineProperty(exports, "flushCliApm", { enumerable: true, get: function () { return minitool_core_2.flushCliApm; } });

package/lib/mcp.js

@@ -0,0 +1,197 @@
+"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;
+    };
+})();
+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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMinitoolMcpServer = createMinitoolMcpServer;
+exports.runMcpCommand = runMcpCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const minitool_core_1 = require("@skillbuilder/minitool-core");
+const minitool_e2e_1 = require("@skillbuilder/minitool-e2e");
+const zod_1 = require("zod");
+const bootstrap_1 = require("./bootstrap");
+const asJson = (value) => ({
+    content: [{ type: "text", text: JSON.stringify(value !== null && value !== void 0 ? value : null, null, 2) }],
+});
+function disposeServices(services) {
+    void services.dispose().catch(() => {
+        process.stderr.write("[redminitool] runtime cleanup failed\n");
+    });
+}
+function createMinitoolMcpServer(opts = {}) {
+    var _a;
+    const server = new mcp_js_1.McpServer({
+        name: "redminitool",
+        version: require("../package.json").version,
+    });
+    const ownsServices = opts.services === undefined;
+    const services = (_a = opts.services) !== null && _a !== void 0 ? _a : (0, bootstrap_1.createCliServices)();
+    if (ownsServices) {
+        server.server.onclose = () => {
+            disposeServices(services);
+        };
+    }
+    server.registerTool("auth_status", {
+        title: "Read authentication status",
+        description: "Return a redacted authentication snapshot. Never returns tokens, secret ids or secret keys.",
+        inputSchema: {},
+    }, () => __awaiter(this, void 0, void 0, function* () { return asJson(yield services.auth.getAuthState()); }));
+    server.registerTool("creator_whoami", {
+        title: "Read current creator identity",
+        description: "Return the current Xiaohongshu MiniTool creator identity without exposing credentials.",
+        inputSchema: {},
+    }, () => __awaiter(this, void 0, void 0, function* () { return asJson(yield services.auth.whoAmI()); }));
+    server.registerTool("minitool_list", {
+        title: "List my MiniTools",
+        description: "List MiniTools belonging to the signed-in creator.",
+        inputSchema: {
+            source: zod_1.z.string().min(1),
+            pageNum: zod_1.z.number().int().min(1).default(1),
+            pageSize: zod_1.z.number().int().min(1).max(100).default(20),
+        },
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ source, pageNum, pageSize }) { return asJson(yield services.miniTools.list({ source, pageNum, pageSize })); }));
+    server.registerTool("minitool_status", {
+        title: "Read MiniTool status",
+        description: "Read version, review and publish status for a MiniTool owned by the creator.",
+        inputSchema: { source: zod_1.z.string().min(1), appId: zod_1.z.string().min(1) },
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ source, appId }) { return asJson(yield services.miniTools.getStatus({ source, appId })); }));
+    server.registerTool("minitool_preview", {
+        title: "Create a device preview",
+        description: "Create a device preview for uploaded package file IDs. This changes server-side preview state and requires explicit confirmation.",
+        inputSchema: Object.assign(Object.assign({}, minitool_core_1.miniToolPreviewSchema.shape), { confirm: zod_1.z.boolean() }),
+    }, (_a) => __awaiter(this, void 0, void 0, function* () {
+        var { confirm } = _a, input = __rest(_a, ["confirm"]);
+        if (!confirm)
+            throw new Error("生成真机预览需要 confirm=true 明确确认");
+        return asJson(yield services.miniTools.createPreview(input));
+    }));
+    server.registerTool("minitool_config", {
+        title: "Read MiniTool configuration",
+        description: "Read current category and authorization codes.",
+        inputSchema: { source: zod_1.z.string().min(1) },
+    }, (input) => __awaiter(this, void 0, void 0, function* () { return asJson(yield services.miniTools.getConfig(input)); }));
+    server.registerTool("minitool_history", {
+        title: "Read version history",
+        description: "Read MiniTool version and audit history.",
+        inputSchema: { source: zod_1.z.string().min(1), appId: zod_1.z.string().min(1) },
+    }, (input) => __awaiter(this, void 0, void 0, function* () { return asJson(yield services.miniTools.getHistory(input)); }));
+    server.registerTool("minitool_submit", {
+        title: "Submit a MiniTool for review",
+        description: "Submit uploaded file IDs and complete metadata for review. Requires explicit confirmation.",
+        inputSchema: Object.assign(Object.assign({}, minitool_core_1.miniToolReviewSchema.shape), { confirm: zod_1.z.boolean() }),
+    }, (_a) => __awaiter(this, void 0, void 0, function* () {
+        var { confirm } = _a, input = __rest(_a, ["confirm"]);
+        if (!confirm)
+            throw new Error("提交审核需要 confirm=true 明确确认");
+        return asJson(yield services.miniTools.submitReview(input));
+    }));
+    server.registerTool("minitool_edit", {
+        title: "Edit MiniTool metadata",
+        description: "Edit name, slogan, icon or cover. Requires explicit confirmation.",
+        inputSchema: Object.assign(Object.assign({}, minitool_core_1.miniToolEditSchema.shape), { confirm: zod_1.z.boolean() }),
+    }, (_a) => __awaiter(this, void 0, void 0, function* () {
+        var { confirm } = _a, input = __rest(_a, ["confirm"]);
+        if (!confirm)
+            throw new Error("编辑需要 confirm=true 明确确认");
+        return asJson(yield services.miniTools.edit(input));
+    }));
+    if (opts.mcpUploadRoot) {
+        server.registerTool("minitool_upload", {
+            title: "Upload a MiniTool package",
+            description: "Upload a ZIP or image within the user-authorized workspace. Requires explicit confirmation.",
+            inputSchema: {
+                filePath: zod_1.z.string().min(1),
+                type: zod_1.z.enum(["pkg", "image"]).default("pkg"),
+                confirm: zod_1.z.boolean(),
+            },
+        }, (_a) => __awaiter(this, [_a], void 0, function* ({ filePath, type, confirm }) {
+            if (!confirm)
+                throw new Error("上传需要 confirm=true 明确确认");
+            const root = fs.realpathSync(opts.mcpUploadRoot);
+            const target = fs.realpathSync(filePath);
+            const relative = path.relative(root, target);
+            if (!relative ||
+                relative === ".." ||
+                relative.startsWith(`..${path.sep}`) ||
+                path.isAbsolute(relative))
+                throw new Error("上传文件必须位于用户授权的工作区目录内");
+            return asJson(yield services.miniTools.upload({ filePath: target, type }));
+        }));
+    }
+    (0, minitool_e2e_1.registerMinitoolE2ETools)(server, opts);
+    return server;
+}
+function runMcpCommand() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        const services = (0, bootstrap_1.createCliServices)(options);
+        const server = createMinitoolMcpServer({
+            distDir: process.env.MINITOOL_E2E_DIST_DIR,
+            services,
+            mcpUploadRoot: process.env.REDMINITOOL_MCP_UPLOAD_ROOT,
+        });
+        server.server.onclose = () => {
+            disposeServices(services);
+        };
+        try {
+            yield server.connect(new stdio_js_1.StdioServerTransport());
+        }
+        catch (error) {
+            yield services.dispose();
+            throw error;
+        }
+        process.stderr.write("[redminitool] MCP server ready on stdio\n");
+    });
+}

package/lib/output.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.output = void 0;
+const minitool_core_1 = require("@skillbuilder/minitool-core");
+exports.output = {
+    helpInfo: minitool_core_1.outputHelpInfo,
+};

package/lib/ui.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHeading = printHeading;
+exports.printDetails = printDetails;
+exports.printHint = printHint;
+exports.printTable = printTable;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+function printHeading(title, subtitle) {
+    console.log();
+    console.log(chalk_1.default.cyan.bold(`  ✦  ${title}`));
+    if (subtitle)
+        console.log(chalk_1.default.gray(`     ${subtitle}`));
+    console.log(chalk_1.default.gray("  ───────────────────────────────────────────────"));
+}
+function printDetails(rows) {
+    for (const [label, value] of rows) {
+        if (value === undefined)
+            continue;
+        console.log(`  ${chalk_1.default.gray(label.padEnd(12, " "))} ${chalk_1.default.white(value)}`);
+    }
+    console.log();
+}
+function printHint(message) {
+    console.log(chalk_1.default.gray(`  ↳ ${message}`));
+}
+function printTable(headers, rows) {
+    const table = new cli_table3_1.default({
+        head: headers.map((heading) => chalk_1.default.cyan.bold(heading)),
+        style: { head: [], border: ["gray"] },
+        wordWrap: true,
+    });
+    for (const row of rows)
+        table.push(row);
+    console.log(table.toString());
+}

package/lib/utils/agent-check.js

@@ -0,0 +1,157 @@
+"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.checkAndGuideAgentProject = checkAndGuideAgentProject;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const open_1 = __importDefault(require("open"));
+const OPEN_PLATFORM_URL = "https://miniapp.xiaohongshu.com/app-choose";
+function isPlaceholder(value) {
+    if (!value || !value.trim())
+        return true;
+    const v = value.trim();
+    return v.startsWith("[") || v.includes("从开放平台获取");
+}
+function readProjectConfig(workDir) {
+    const configPath = path_1.default.join(workDir, "project.config.json");
+    if (!fs_1.default.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs_1.default.readFileSync(configPath, "utf-8"));
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function writeProjectConfig(workDir, updates) {
+    var _a;
+    const configPath = path_1.default.join(workDir, "project.config.json");
+    const existing = (_a = readProjectConfig(workDir)) !== null && _a !== void 0 ? _a : {};
+    const next = Object.assign(Object.assign(Object.assign(Object.assign({}, existing), { agentId: updates.agentId }), (updates.name !== undefined ? { name: updates.name } : {})), (updates.desc !== undefined ? { desc: updates.desc } : {}));
+    fs_1.default.writeFileSync(configPath, JSON.stringify(next, null, 2), "utf-8");
+}
+function openUrl(url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield (0, open_1.default)(url);
+        }
+        catch (_a) {
+            console.log(chalk_1.default.cyan(`请手动访问：${url}`));
+        }
+    });
+}
+function checkAndGuideAgentProject(workDir, services) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const config = readProjectConfig(workDir);
+        if (!config || !("agentId" in config)) {
+            return undefined;
+        }
+        const rawAgentId = config.agentId;
+        if (isPlaceholder(rawAgentId)) {
+            console.log(chalk_1.default.yellow("\n⚠️  检测到 project.config.json 中的 agentId 尚未配置，正在引导您关联智能体..."));
+            return yield selectAndBindAgent(workDir, services);
+        }
+        try {
+            const detail = yield services.getAgentInfoById(rawAgentId);
+            if (!detail) {
+                console.log(chalk_1.default.yellow(`\n⚠️  project.config.json 中的 agentId「${rawAgentId}」在当前账号下未找到，正在引导您重新关联...`));
+                return yield selectAndBindAgent(workDir, services);
+            }
+            const remoteName = (_a = detail.agentName) !== null && _a !== void 0 ? _a : "";
+            const remoteDesc = (_b = detail.description) !== null && _b !== void 0 ? _b : "";
+            const localName = (_c = config.name) !== null && _c !== void 0 ? _c : "";
+            const localDesc = (_d = config.desc) !== null && _d !== void 0 ? _d : "";
+            const localAgentId = (_e = config.agentId) !== null && _e !== void 0 ? _e : "";
+            const needsUpdate = localAgentId !== detail.agentId || localName !== remoteName || localDesc !== remoteDesc;
+            if (needsUpdate) {
+                writeProjectConfig(workDir, {
+                    agentId: detail.agentId,
+                    name: remoteName,
+                    desc: remoteDesc,
+                });
+                console.log(chalk_1.default.green(`✅ 已同步 project.config.json（agentId: ${detail.agentId}，name: ${remoteName || "(空)"}，desc: ${remoteDesc || "(空)"}）`));
+            }
+            else {
+                console.log(chalk_1.default.gray(`ℹ️  project.config.json 与开放平台一致，无需更新（agentId: ${detail.agentId}）`));
+            }
+            return detail.agentId;
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  校验 agentId 时出现错误（${(_f = err === null || err === void 0 ? void 0 : err.message) !== null && _f !== void 0 ? _f : String(err)}），将跳过校验直接启动。`));
+            return rawAgentId;
+        }
+    });
+}
+function selectAndBindAgent(workDir, services) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        let agentList = [];
+        try {
+            agentList = yield services.getAgentList({ pageNo: 1, pageSize: 50 });
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  获取智能体列表失败（${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : String(err)}），将跳过关联直接启动。`));
+            return undefined;
+        }
+        if (!agentList || agentList.length === 0) {
+            console.log("");
+            console.log(chalk_1.default.bold.yellow("你好，您当前的账号下没有智能体，请先去开放平台创建智能体："));
+            console.log(chalk_1.default.cyan(OPEN_PLATFORM_URL));
+            console.log("");
+            yield openUrl(OPEN_PLATFORM_URL);
+            return undefined;
+        }
+        let selectedId;
+        if (agentList.length === 1) {
+            const only = agentList[0];
+            selectedId = only.agentId;
+            console.log(chalk_1.default.green(`\n✅ 检测到您账号下只有一个智能体，已自动关联：${only.agentName}（${only.agentId}）`));
+        }
+        else {
+            console.log("");
+            const { chosenId } = yield inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "chosenId",
+                    message: "检测到您账号下有多个智能体，请选择要开发的智能体：",
+                    choices: agentList.map((a) => ({
+                        name: `${a.agentName}  ${chalk_1.default.gray(`(${a.agentId})`)}`,
+                        value: a.agentId,
+                    })),
+                },
+            ]);
+            selectedId = chosenId;
+        }
+        try {
+            const detail = yield services.getAgentInfoById(selectedId);
+            if (detail) {
+                writeProjectConfig(workDir, {
+                    agentId: detail.agentId,
+                    name: (_b = detail.agentName) !== null && _b !== void 0 ? _b : "",
+                    desc: (_c = detail.description) !== null && _c !== void 0 ? _c : "",
+                });
+                console.log(chalk_1.default.green(`✅ project.config.json 已更新（agentId: ${detail.agentId}，name: ${detail.agentName || "(空)"}，desc: ${detail.description || "(空)"}）`));
+                return detail.agentId;
+            }
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  获取智能体详情失败（${(_d = err === null || err === void 0 ? void 0 : err.message) !== null && _d !== void 0 ? _d : String(err)}），将直接写入 agentId。`));
+        }
+        writeProjectConfig(workDir, { agentId: selectedId });
+        return selectedId;
+    });
+}