@doubao-dev/plugin-cli 0.0.0-stage → 0.0.40-canary-dea0ddc73-20261026073950

package/dist/categories.js

@@ -0,0 +1,8 @@
+import { listPluginCategories } from "./188.js";
+import { ensureLogin } from "./command~1.js";
+async function runCategories() {
+    await ensureLogin(false);
+    const { items = [] } = await listPluginCategories();
+    console.log(JSON.stringify(items, null, 2));
+}
+export { runCategories };

package/dist/command.js

@@ -0,0 +1,184 @@
+import { randomUUID } from "node:crypto";
+import { cancel, isCancel, select as prompts_select, text as prompts_text } from "@clack/prompts";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { z } from "zod";
+import { upsertPluginDraft, getPluginDraft, errorMessage, terminal_log, submitApproval, withProgress, isInteractive, savePluginVersion, listPluginCategories } from "./188.js";
+import { ensureLogin } from "./command~1.js";
+const nonEmptyString = z.string().trim().min(1, '不能为空');
+const skillMaterialsSchema = z.strictObject({
+    evaluation_report_url: nonEmptyString.regex(/^https?:\/\//i, '请输入 HTTP 或 HTTPS 报告地址'),
+    example_prompts: z.array(nonEmptyString).min(5).max(10)
+});
+const auditInputSchema = z.strictObject({
+    category_id: nonEmptyString.optional(),
+    modules: z.array(z.strictObject({
+        module_id: nonEmptyString,
+        mcp: z.strictObject({
+            test_credential: nonEmptyString
+        }).optional(),
+        skill: skillMaterialsSchema.optional()
+    })).default([])
+});
+function readAuditInput(projectRoot, path) {
+    const inputPath = resolve(projectRoot, path);
+    try {
+        return auditInputSchema.parse(JSON.parse(readFileSync(inputPath, 'utf8')));
+    } catch (cause) {
+        const message = cause instanceof SyntaxError ? '文件不是有效的 JSON' : cause instanceof Error ? cause.message : String(cause);
+        throw new Error(`无法读取审核材料 ${inputPath}：${message}`, {
+            cause
+        });
+    }
+}
+function resolveAuditModules(modules, inputs = []) {
+    const byId = new Map();
+    for (const input of inputs){
+        if (byId.has(input.module_id)) throw new Error(`审核材料中 module_id 重复：${input.module_id}`);
+        const module = modules.find((item)=>item.module_id === input.module_id);
+        if (!module) throw new Error(`草稿中不存在审核材料指定的模块：${input.module_id}`);
+        if ('MCP' === module.type && (!input.mcp || input.skill) || 'SKILL' === module.type && (!input.skill || input.mcp) || 'MCP' !== module.type && 'SKILL' !== module.type) throw new Error(`模块 ${input.module_id} 的审核材料须与草稿类型 ${module.type} 一致`);
+        byId.set(input.module_id, input);
+    }
+    const result = [];
+    for (const module of modules){
+        const input = module.module_id ? byId.get(module.module_id) : void 0;
+        const name = module.name || module.module_id;
+        if ('MCP' === module.type) {
+            if (!input?.mcp && !module.mcp?.masked_test_credential?.trim()) throw new Error(`连接器 ${name} 缺少测试账号或 Key，请通过 --input <path> 提供模块 ${module.module_id} 的 mcp.test_credential`);
+            if (input?.mcp && input.mcp.test_credential !== module.mcp?.masked_test_credential?.trim()) result.push({
+                module_id: module.module_id,
+                mcp: input.mcp
+            });
+        } else if ('SKILL' === module.type) {
+            const materials = input?.skill ?? {
+                evaluation_report_url: module.skill?.evaluation_report_url,
+                example_prompts: module.skill?.example_prompts
+            };
+            if (!skillMaterialsSchema.safeParse(materials).success) throw new Error(`Skill ${name} 缺少有效报告地址或 5–10 条示例提示词，请通过 --input <path> 提供模块 ${module.module_id} 的 skill 审核材料`);
+            if (input?.skill) result.push({
+                module_id: module.module_id,
+                skill: input.skill
+            });
+        }
+    }
+    return result;
+}
+async function promptMcpAuditInfo(module) {
+    const moduleName = module.name || module.module_id || 'MCP';
+    const testCredential = await prompts_text({
+        message: `请填写连接器 ${moduleName} 的测试账号或 Key`,
+        initialValue: module.mcp?.masked_test_credential,
+        validate: (value)=>nonEmptyString.safeParse(value).error?.issues[0]?.message
+    });
+    if (isCancel(testCredential)) return testCredential;
+    if (testCredential.trim() === module.mcp?.masked_test_credential?.trim()) return;
+    return {
+        module_id: module.module_id,
+        mcp: {
+            test_credential: testCredential.trim()
+        }
+    };
+}
+async function promptSkillAuditInfo(module) {
+    const skillName = module.name;
+    const reportUrl = await prompts_text({
+        message: `Skill ${skillName} 的评测报告地址`,
+        initialValue: module.skill?.evaluation_report_url,
+        validate: (value)=>skillMaterialsSchema.shape.evaluation_report_url.safeParse(value).error?.issues[0]?.message
+    });
+    if (isCancel(reportUrl)) return reportUrl;
+    terminal_log.info('请逐条填写 5–10 条覆盖核心场景的示例提示词，仅用于平台审核测试，不会向用户展示。');
+    const examplePrompts = [];
+    for(let index = 0; index < 10; index++){
+        const examplePrompt = await prompts_text({
+            message: `Skill ${skillName} 的第 ${index + 1} 条示例提示词`,
+            placeholder: index >= 5 ? '留空结束' : void 0,
+            initialValue: module.skill?.example_prompts?.[index],
+            validate: (value)=>{
+                if (index < 5 && !value.trim()) return '请填写示例提示词，至少需要 5 条';
+            }
+        });
+        if (isCancel(examplePrompt)) return examplePrompt;
+        if (!examplePrompt?.trim()) break;
+        examplePrompts.push(examplePrompt.trim());
+    }
+    return {
+        module_id: module.module_id,
+        skill: {
+            evaluation_report_url: reportUrl.trim(),
+            example_prompts: examplePrompts
+        }
+    };
+}
+async function runAudit(project, options = {}) {
+    await ensureLogin(false);
+    const { name } = project.plugin;
+    const input = void 0 !== options.input ? readAuditInput(project.root, options.input) : void 0;
+    const interactive = isInteractive() && !input;
+    const { draft } = await withProgress('查询草稿', ()=>getPluginDraft(name));
+    if (!draft) throw new Error(`服务端未找到 ${name} 的草稿，请先执行 dbx upload`);
+    const { items = [] } = await withProgress('查询意向分类', ()=>listPluginCategories());
+    const categoryOptions = items.flatMap(({ category_id, name })=>category_id ? [
+            {
+                value: category_id,
+                label: name || category_id
+            }
+        ] : []);
+    if (0 === categoryOptions.length) throw new Error('服务端未返回可选分类，暂时无法提交审核');
+    let categoryIds = input?.category_id ? [
+        input.category_id
+    ] : (draft.form?.categories ?? []).flatMap(({ category_id })=>category_id ? [
+            category_id
+        ] : []);
+    let modules = [];
+    if (interactive) {
+        const categoryId = await prompts_select({
+            message: '请选择意向分类',
+            options: categoryOptions,
+            initialValue: categoryOptions.find(({ value })=>categoryIds.includes(value))?.value
+        });
+        if (isCancel(categoryId)) {
+            cancel('已取消审核。');
+            process.exitCode = 130;
+            return;
+        }
+        categoryIds = [
+            categoryId
+        ];
+        for (const module of draft.modules ?? []){
+            if ('MCP' !== module.type && 'SKILL' !== module.type) continue;
+            const materials = 'MCP' === module.type ? await promptMcpAuditInfo(module) : await promptSkillAuditInfo(module);
+            if (isCancel(materials)) {
+                cancel('已取消审核。');
+                process.exitCode = 130;
+                return;
+            }
+            if (materials) modules.push(materials);
+        }
+    } else {
+        if (!categoryIds.length || categoryIds.some((id)=>!categoryOptions.some(({ value })=>value === id))) throw new Error('请先运行 dbx categories 查询审核类目，再通过 --input <path> 的 category_id 指定有效类目。');
+        modules = resolveAuditModules(draft.modules ?? [], input?.modules);
+    }
+    const { draft: updatedDraft } = await withProgress('保存审核信息', ()=>upsertPluginDraft({
+            name,
+            category_ids: categoryIds,
+            modules: modules.length > 0 ? modules : void 0
+        }));
+    if (!updatedDraft) throw new Error('审核信息保存失败：服务端未返回草稿');
+    const { version } = await savePluginVersion({
+        name,
+        request_id: randomUUID()
+    });
+    if (!version) throw new Error('保存版本失败：服务端未返回 version');
+    try {
+        const { approval_id: approvalId } = await withProgress('提交审核', ()=>submitApproval(name, version));
+        if (!approvalId) throw new Error('服务端未返回 approval_id');
+        terminal_log.success(`提交审核成功，审核 ID：${approvalId}`);
+    } catch (error) {
+        throw new Error(`提交审核失败：${errorMessage(error)}\n应用插件：${name}@${version}`, {
+            cause: error
+        });
+    }
+}
+export { runAudit };

package/dist/command~1.js

@@ -0,0 +1,45 @@
+import open_0 from "open";
+import { runtime, startLogin, terminal_log, whoami, NotLoggedInError, login, isInteractive, completeLogin } from "./188.js";
+async function runStatus() {
+    const result = await whoami(runtime.auth);
+    console.log(result.credentialError?.message ?? (result.loggedIn ? '已登录' : '尚未登录，请运行 dbx auth login'));
+    if (result.uid) console.log(`用户 ID：${result.uid}`);
+}
+async function ensureLogin(interactive = isInteractive()) {
+    const status = await whoami(runtime.auth);
+    if (status.credentialError) throw new Error(status.credentialError.message);
+    if (!status.loggedIn) {
+        if (!interactive) throw new NotLoggedInError();
+        await runLogin({});
+    }
+}
+async function runLogin(options) {
+    if (!isInteractive() && !options.begin && void 0 === options.complete) throw new Error('请使用 auth login --begin 发起授权，再使用 --complete <device-code> 完成授权');
+    if (void 0 !== options.complete && !options.complete.trim()) throw new Error('设备码不能为空');
+    if (options.begin) {
+        const result = await startLogin(runtime.auth);
+        showVerification(result);
+        terminal_log.step(`完成授权后运行：\n  dbx auth login --complete ${result.deviceCode}`);
+        return;
+    }
+    terminal_log.step(options.complete ? '正在等待授权确认…' : '正在发起登录…');
+    const { expiresAt } = options.complete ? await completeLogin(options.complete.trim(), runtime.auth) : await login({
+        ...runtime.auth,
+        onVerification (info) {
+            showVerification(info);
+            terminal_log.step('正在等待浏览器授权…');
+        }
+    });
+    terminal_log.success('登录成功');
+    terminal_log.info(`凭证到期时间（本地）：${new Date(1000 * expiresAt).toLocaleString('zh-CN', {
+        hour12: false
+    })}`);
+}
+function showVerification(info) {
+    terminal_log.info(`请在浏览器中完成授权（${info.expiresIn} 秒内）\n授权地址：${info.verificationUrl}\n用户验证码：${info.userCode}`);
+    if (!isInteractive()) return;
+    open_0(info.verificationUrl).catch(()=>{
+        terminal_log.warn('无法自动打开浏览器，请复制上方的授权地址完成授权。');
+    });
+}
+export { ensureLogin, runLogin, runStatus };

package/dist/command~2.js

@@ -0,0 +1,14 @@
+import { terminal_log, listPluginVersions, withdrawApproval, withProgress } from "./188.js";
+import { ensureLogin } from "./command~1.js";
+async function runCancelAudit(project) {
+    await ensureLogin(false);
+    const { name } = project.plugin;
+    const approvalId = await withProgress('查询审核记录', async ()=>{
+        const versions = await listPluginVersions(project.plugin);
+        return versions.find((version)=>version.current_approval?.approval_id)?.current_approval?.approval_id;
+    });
+    if (!approvalId) return void terminal_log.info(`应用插件 ${name} 暂无审核记录`);
+    await withProgress('取消提审', ()=>withdrawApproval(approvalId));
+    terminal_log.success(`已取消提审，审核 ID：${approvalId}`);
+}
+export { runCancelAudit };

package/dist/command~3.js

@@ -0,0 +1,91 @@
+import { spawn } from "node:child_process";
+import { once } from "node:events";
+import { join, resolve } from "node:path";
+import { cancel, confirm as prompts_confirm, isCancel, text as prompts_text } from "@clack/prompts";
+import { copySync } from "fs-extra/esm";
+import { TEMPLATE_SUFFIX, STANDARD_TEMPLATE_DIRECTORY, DOUBAO_APP_DIRECTORY, projectNameSchema, runtime, TEMPLATES_DIRECTORY, loadAppModule, errorMessage, terminal_log, PLUGIN_NAME_PLACEHOLDER, loadPackage, isInteractive, syncProjectSkill } from "./188.js";
+import * as __rspack_external_node_fs_1b05aee1 from "node:fs";
+async function createProject(name, app) {
+    projectNameSchema.parse(name);
+    const directory = join(process.cwd(), name);
+    const existing = __rspack_external_node_fs_1b05aee1.lstatSync(directory, {
+        throwIfNoEntry: false
+    });
+    if (existing && (!existing.isDirectory() || __rspack_external_node_fs_1b05aee1.readdirSync(directory).length > 0)) throw new Error(`目标路径已存在且不是空目录：${directory}`);
+    const assets = app ? await loadAppModule('./assets') : void 0;
+    if (assets) await loadPackage(runtime.kit, new AbortController().signal);
+    const templates = join(import.meta.dirname, TEMPLATES_DIRECTORY);
+    copySync(join(templates, STANDARD_TEMPLATE_DIRECTORY), directory);
+    if (assets) copySync(assets.templatesRoot, directory);
+    for (const entry of __rspack_external_node_fs_1b05aee1.readdirSync(directory, {
+        recursive: true,
+        withFileTypes: true
+    }))if (entry.isFile() && entry.name.endsWith(TEMPLATE_SUFFIX)) {
+        const source = join(entry.parentPath, entry.name);
+        const target = source.slice(0, -TEMPLATE_SUFFIX.length);
+        __rspack_external_node_fs_1b05aee1.writeFileSync(target, __rspack_external_node_fs_1b05aee1.readFileSync(source, 'utf8').replaceAll(PLUGIN_NAME_PLACEHOLDER, name));
+        __rspack_external_node_fs_1b05aee1.unlinkSync(source);
+    }
+    __rspack_external_node_fs_1b05aee1.mkdirSync(join(directory, "skills"), {
+        recursive: true
+    });
+    if (app && 'example' !== name) __rspack_external_node_fs_1b05aee1.renameSync(join(directory, "skills", 'example'), join(directory, "skills", name));
+    await syncProjectSkill(directory);
+}
+async function runInit(name, options) {
+    let app = Boolean(options.app);
+    if (!name) {
+        if (!isInteractive()) throw new Error('请指定项目名称，例如 dbx init my-plugin');
+        const answer = await prompts_text({
+            message: '项目名称',
+            placeholder: 'my-plugin',
+            defaultValue: 'my-plugin',
+            validate: (value)=>projectNameSchema.safeParse(value || 'my-plugin').error?.issues[0]?.message
+        });
+        if (isCancel(answer)) {
+            cancel('已取消创建。');
+            process.exitCode = 130;
+            return;
+        }
+        name = answer;
+        if (!app) {
+            const choice = await prompts_confirm({
+                message: '添加应用前端（App）？',
+                initialValue: false
+            });
+            if (isCancel(choice)) {
+                cancel('已取消创建。');
+                process.exitCode = 130;
+                return;
+            }
+            app = choice;
+        }
+    }
+    await createProject(name, app);
+    terminal_log.success(`已创建 ${name}`);
+    if (!app) return;
+    if (false !== options.installDeps) {
+        const cwd = resolve(name, DOUBAO_APP_DIRECTORY);
+        terminal_log.info('正在使用 pnpm 安装应用依赖…');
+        try {
+            const child = spawn('pnpm', [
+                'install'
+            ], {
+                cwd,
+                stdio: [
+                    isInteractive() ? 'inherit' : 'ignore',
+                    'inherit',
+                    'inherit'
+                ]
+            });
+            const [code] = await once(child, 'close');
+            if (0 !== code) throw new Error(`pnpm 安装失败，退出码：${code}`);
+            terminal_log.success('应用依赖已安装');
+        } catch (error) {
+            terminal_log.warn(`应用依赖未安装：${errorMessage(error)}`);
+            terminal_log.info(`项目已保留，请进入 ${cwd} 后运行 pnpm install。`);
+        }
+    }
+    terminal_log.step(`运行 dbx dev --app --cwd ${name}，打开 Web 模拟器后发送“搜索牛奶”。`);
+}
+export { runInit };

package/dist/command~4.js

@@ -0,0 +1,191 @@
+import chalk from "chalk";
+import { TextPrompt } from "@clack/core";
+import { isCancel, text as prompts_text } from "@clack/prompts";
+import ora from "ora";
+import { upsertPluginDraft, listPluginVersions, versionSchema, callHook, runtime, terminal_log, validateMaterial, uploadPackage, isInteractive, errorMessage, withProgress } from "./188.js";
+import { ensureLogin } from "./command~1.js";
+async function selectUploadVersion(plugin, specified) {
+    if (void 0 !== specified) return versionSchema.parse(specified);
+    if (!isInteractive()) throw new Error('请通过 --version 指定上传版本，例如 dbx upload --version 0.0.1');
+    let versions;
+    const spinner = ora({
+        text: ' 查询历史版本',
+        stream: process.stdout,
+        discardStdin: false
+    }).start();
+    try {
+        versions = await listPluginVersions(plugin);
+        spinner.succeed(versions.length ? ' 已获取历史版本' : ' 暂无历史版本');
+    } catch (error) {
+        spinner.stop();
+        if (errorMessage(error).includes('multiple plugins created by you have the same name')) throw new Error('存在同名插件，请在 plugin.json 中填写目标插件的 id 后重新上传。', {
+            cause: error
+        });
+        terminal_log.warn('暂时无法获取历史版本，可手动输入上传版本。');
+        const version = await prompts_text({
+            message: '请手动输入上传版本（首次上传可使用 0.0.1）',
+            validate: (value)=>versionSchema.safeParse(value).error?.issues[0]?.message
+        });
+        if (isCancel(version)) {
+            process.exitCode = 130;
+            return;
+        }
+        return version;
+    }
+    const { latest, choices } = versionChoices(versions.flatMap(({ version })=>{
+        const parsed = versionSchema.safeParse(version);
+        return parsed.success ? [
+            parsed.data
+        ] : [];
+    }));
+    let cursor = 0;
+    const selected = (input = '')=>input.trim() || choices[cursor].value;
+    const prompt = new TextPrompt({
+        initialValue: '',
+        validate: (input)=>versionSchema.safeParse(selected(input)).error?.issues[0]?.message,
+        render () {
+            if ('cancel' === this.state) return chalk.gray('└ 已取消上传');
+            if ('submit' === this.state) return `◇ 上传版本\n│ ${selected(this.value)}`;
+            const pageSize = Math.max(1, Math.min(6, (process.stdout.rows || 24) - 8));
+            const start = Math.floor(cursor / pageSize) * pageSize;
+            const input = (this.value ?? '').trim();
+            const rows = input ? [
+                `│ ${chalk.cyan('●')} 使用 ${input}`
+            ] : choices.slice(start, start + pageSize).map((choice, index)=>`│ ${index + start === cursor ? chalk.cyan('●') : '○'} ${choice.label}`);
+            return [
+                `${chalk.cyan('◆')} 上传版本${latest ? `（当前最高版本 ${latest}）` : '（首次上传）'}`,
+                `│ > ${this.valueWithCursor}`,
+                '│',
+                ...rows,
+                'error' === this.state ? `│ ${chalk.red(this.error)}` : `│ ${chalk.gray(input ? 'Enter 确认' : `↑↓ 选择或直接输入 · 第 ${Math.floor(cursor / pageSize) + 1}/${Math.ceil(choices.length / pageSize)} 页`)}`,
+                '└'
+            ].join('\n');
+        }
+    });
+    prompt.on('cursor', (key)=>{
+        if (!prompt.value && ('up' === key || 'down' === key)) cursor = (cursor + ('up' === key ? -1 : 1) + choices.length) % choices.length;
+    });
+    const value = await prompt.prompt();
+    if (isCancel(value)) {
+        process.exitCode = 130;
+        return;
+    }
+    return selected(value);
+}
+function versionChoices(versions) {
+    const choices = [
+        ...new Set(versions)
+    ];
+    if (!choices.length) return {
+        latest: '',
+        choices: [
+            {
+                value: '0.0.1',
+                label: '0.0.1'
+            }
+        ]
+    };
+    const [major, minor, patch] = choices[0].split('.').map(BigInt);
+    return {
+        latest: choices[0],
+        choices: [
+            {
+                value: `${major}.${minor}.${patch + 1n}`,
+                label: `${major}.${minor}.${patch + 1n}  Patch`
+            },
+            {
+                value: `${major}.${minor + 1n}.0`,
+                label: `${major}.${minor + 1n}.0  Minor`
+            },
+            {
+                value: `${major + 1n}.0.0`,
+                label: `${major + 1n}.0.0  Major`
+            },
+            ...choices.map((value)=>({
+                    value,
+                    label: value
+                }))
+        ]
+    };
+}
+async function runUpload(project, options, hooks) {
+    await ensureLogin(false);
+    const { name, id } = project.plugin;
+    const identity = id ? {
+        ability_id: id
+    } : {
+        name
+    };
+    const version = await selectUploadVersion(project.plugin, options.version);
+    if (!version) return;
+    const ctx = {
+        project,
+        options: {
+            ...options,
+            version
+        }
+    };
+    let plan = {
+        version
+    };
+    for (const hook of hooks.modifyPackagePlan)plan = await callHook(hook, ctx, plan);
+    const content = await withProgress('打包项目', ()=>project.pack(plan));
+    const fileName = `${name}-${Date.now()}.zip`;
+    const packageId = await withProgress('上传应用插件包', async ()=>{
+        const { package_id: packageId } = await uploadPackage(fileName, content);
+        if (!packageId) throw new Error('上传失败：服务端未返回 package_id');
+        return packageId;
+    });
+    await withProgress('校验物料', async ()=>{
+        const validation = await validateMaterial({
+            package_id: packageId,
+            ...identity,
+            validate_list: [
+                'PACKAGE_PARSE'
+            ]
+        });
+        if (!validation.passed) {
+            const issues = validation.issues?.map((issue)=>{
+                const location = [
+                    issue.path,
+                    issue.field_path
+                ].filter(Boolean).join(':');
+                const message = issue.message || issue.code || '未知问题';
+                return `- ${location ? `${location}：` : ''}${message}`;
+            }).join('\n');
+            throw new Error(`物料校验未通过${issues ? `\n${issues}` : ''}`);
+        }
+    });
+    const draft = await withProgress('保存草稿', async ()=>{
+        const { draft } = await upsertPluginDraft({
+            package_id: packageId,
+            ...identity
+        });
+        if (!draft?.name) throw new Error('草稿保存失败：服务端未返回 name');
+        return draft;
+    });
+    if (draft.ability_id) {
+        await project.updatePluginId(draft.ability_id);
+        terminal_log.success(`应用插件 ID：${draft.ability_id}，已自动保存`);
+    }
+    terminal_log.success(`插件 ${chalk.cyan.bold(draft.name)} 上传成功`);
+    if (project.plugin.id) {
+        const url = new URL(runtime.consoleUrl);
+        url.search = new URLSearchParams({
+            ability: project.plugin.id,
+            resume: '1',
+            step: 'upload'
+        }).toString();
+        terminal_log.info(`平台草稿：${url.href}`);
+    }
+    for (const hook of hooks.afterUpload)try {
+        await hook.callback(ctx, {
+            packageId,
+            draft,
+            version: draft.version ?? plan.version
+        });
+    } catch (error) {
+        terminal_log.warn(`[${hook.pluginName}] 上传已完成，后续处理失败：${errorMessage(error)}\n可从上方平台草稿链接继续处理。`);
+    }
+}
+export { runUpload };