kie-ai-cli 1.0.0

package/dist/image-repl.js

@@ -0,0 +1,525 @@
+import path from 'path';
+import readline from 'readline';
+import chalk from 'chalk';
+import ora from 'ora';
+import { sendChatMessage } from './api.js';
+import { readMultilineFromEditor } from './editor.js';
+import { buildAssistSystemPrompt, ensureAssistSystemMessage, looksLikeAssistRefusal, parseDraftFromAssistReply, resolveImageAssistModel, setImageAssistModel, } from './image-assist.js';
+import { formatImageModelLabel, printImageModelPickerMenu, resolveImageModel, resolveImageModelPick, setImageModel, } from './image-models.js';
+import { runImageGeneration } from './image.js';
+import { applyTemplate, printTemplateList, resolveTemplatePick, } from './image-templates.js';
+import { createImageSessionId, emptyDraft, getActiveImageSessionId, loadImageSession, saveImageSession, setActiveImageSessionId, } from './image-session.js';
+import { isAbortError } from './kie-http.js';
+import { formatModelLabel, printModelPickerMenu, resolveModelPickInput, } from './models.js';
+const IMAGE_SLASH_ALIASES = {
+    '/h': '/help',
+    '/g': '/gen',
+    '/t': '/tpl',
+    '/a': '/assist',
+};
+function normalizeSlashInput(input) {
+    const space = input.indexOf(' ');
+    const cmd = (space === -1 ? input : input.slice(0, space)).toLowerCase();
+    const alias = IMAGE_SLASH_ALIASES[cmd];
+    if (!alias)
+        return input;
+    return alias + (space === -1 ? '' : input.slice(space));
+}
+function printImageReplHelp() {
+    console.log(chalk.cyan('\nImage 工作台指令:\n'));
+    const rows = [
+        ['/help', '显示帮助'],
+        ['/new', '新建 image 会话'],
+        ['/model [id|序号]', '切换图片生成模型'],
+        ['/assist [id|序号]', '切换提示词助手模型（与 kie chat 同款列表）'],
+        ['/draft', '查看当前草稿'],
+        ['/set <prompt>', '直接写入草稿（不经助手，可写中文）'],
+        ['/system', '查看助手系统提示词（当前会话上下文）'],
+        ['/tpl [id] [主体]', '模板列表或应用内置模板'],
+        ['/optimize [说明]', '优化当前草稿'],
+        ['/image-url <url>', '添加图生图参考图'],
+        ['/ratio <1:1|2:3|3:2|auto>', '设置宽高比'],
+        ['/quality <medium|high>', '设置质量（支持的模型）'],
+        ['/gen', '按草稿提交生成并下载'],
+        ['/clear', '清空草稿与助手对话'],
+        ['/edit', '用编辑器编辑草稿 prompt'],
+        ['直接输入', '与助手对话，自动更新 DRAFT'],
+        ['Ctrl+C', '取消生成；空闲时连按两次退出'],
+        ['exit / quit', '退出并保存'],
+    ];
+    for (const [cmd, desc] of rows) {
+        console.log(`  ${chalk.white(cmd.padEnd(24))} ${chalk.gray(desc)}`);
+    }
+    console.log();
+}
+function printDraftBar(session) {
+    const d = session.draft;
+    const promptPreview = d.prompt.length > 60 ? `${d.prompt.slice(0, 57)}...` : d.prompt || '(空)';
+    console.log(chalk.gray(`\n  草稿: ${chalk.white(promptPreview)} | 生成: ${formatImageModelLabel(session.generationModel)} | 助手: ${formatModelLabel(session.assistModel)} | 参考图: ${d.imageUrls.length} | 比例: ${d.aspectRatio ?? '-'} | /gen 出图\n`));
+}
+export async function runImageRepl(options) {
+    const { config, apiKey, baseUrl } = options;
+    let sessionId = getActiveImageSessionId(config);
+    let session = loadImageSession(config, sessionId);
+    if (!session.generationModel) {
+        session.generationModel = resolveImageModel(config);
+    }
+    if (!session.assistModel) {
+        session.assistModel = resolveImageAssistModel(config);
+    }
+    const persist = () => saveImageSession(config, session);
+    console.log(chalk.magenta('=================================================='));
+    console.log(chalk.magenta(' 🎨 Kie 出图工作台 (助手润色 → /gen 生成) '));
+    console.log(chalk.magenta('=================================================='));
+    console.log(chalk.gray(`会话: ${sessionId}`));
+    printDraftBar(session);
+    console.log(chalk.gray('输入 /help 查看指令 | /tpl 模板 | 退出: exit 或连按两次 Ctrl+C\n' +
+        '说明: 退出后回到 PS/CMD 是正常的；草稿保存在 image-sessions/，再运行 kie image 可继续\n'));
+    return new Promise((resolve) => {
+        let exiting = false;
+        let isProcessing = false;
+        let replMode = 'chat';
+        let multilineBuffer = [];
+        let activeAbort = null;
+        let lastIdleSigintAt = 0;
+        const PROMPT = '(Image) > ';
+        const PROMPT_PICK = '序号 > ';
+        const PROMPT_MULTILINE = '... > ';
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true,
+            prompt: PROMPT,
+        });
+        const showPrompt = () => rl.prompt();
+        const resetInputMode = () => {
+            replMode = 'chat';
+            multilineBuffer = [];
+            rl.setPrompt(PROMPT);
+        };
+        const runAssist = async (userText, opts) => {
+            const systemContent = buildAssistSystemPrompt(session.generationModel, session.draft);
+            const userContent = opts?.optimizeOnly
+                ? `请优化当前草稿的英文绘图 prompt。${userText ? `补充要求: ${userText}` : ''}`
+                : userText;
+            session.assistMessages.push({ role: 'user', content: userContent });
+            session.assistMessages = ensureAssistSystemMessage(session.assistMessages, systemContent);
+            const spinner = ora({
+                text: `助手思考中 (${session.assistModel})...`,
+                discardStdin: false,
+            }).start();
+            let full = '';
+            let wroteHeader = false;
+            const ac = new AbortController();
+            activeAbort = ac;
+            try {
+                await sendChatMessage({
+                    apiKey,
+                    baseUrl,
+                    model: session.assistModel,
+                    messages: session.assistMessages,
+                    signal: ac.signal,
+                    onChunk: (text) => {
+                        if (!text || ac.signal.aborted)
+                            return;
+                        if (!wroteHeader) {
+                            spinner.stop();
+                            process.stdout.write(chalk.blue.bold('\n助手: '));
+                            wroteHeader = true;
+                        }
+                        process.stdout.write(chalk.white(text));
+                        full += text;
+                    },
+                });
+                if (!wroteHeader)
+                    spinner.stop();
+                else
+                    console.log('\n');
+                session.assistMessages.push({ role: 'assistant', content: full });
+                const parsed = parseDraftFromAssistReply(full);
+                if (parsed.displayText) {
+                    /* already streamed */
+                }
+                if (parsed.draftPrompt) {
+                    session.draft.prompt = parsed.draftPrompt;
+                    console.log(chalk.green('✅ 草稿已更新\n'));
+                }
+                else if (parsed.keepDraft) {
+                    console.log(chalk.gray('(草稿保持不变)\n'));
+                }
+                else if (looksLikeAssistRefusal(full)) {
+                    console.log(chalk.yellow('⚠️ 助手未改写草稿（可能触发了模型安全策略）。可尝试：\n' +
+                        '   · 换说法（如 anime-style young adult female character）\n' +
+                        '   · /assist 换模型（如 Sonnet）\n' +
+                        '   · /set <描述> 直接写入草稿，或 /edit 编辑\n'));
+                }
+                else if (parsed.displayText) {
+                    console.log(chalk.gray('(未解析到 DRAFT 行，草稿未变更；可用 /set 直接写入)\n'));
+                }
+                persist();
+                printDraftBar(session);
+            }
+            catch (err) {
+                spinner.stop();
+                const last = session.assistMessages[session.assistMessages.length - 1];
+                if (last?.role === 'user' && last.content === userContent) {
+                    session.assistMessages.pop();
+                }
+                if (isAbortError(err)) {
+                    console.log(chalk.yellow('\n(已取消)\n'));
+                }
+                else {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(chalk.red(`\n❌ ${msg}\n`));
+                }
+            }
+            finally {
+                activeAbort = null;
+                isProcessing = false;
+            }
+        };
+        const runGenerate = async () => {
+            if (!session.draft.prompt.trim()) {
+                console.log(chalk.yellow('⚠️ 草稿为空，请先描述画面或 /tpl 应用模板。\n'));
+                return;
+            }
+            isProcessing = true;
+            const ac = new AbortController();
+            activeAbort = ac;
+            try {
+                const result = await runImageGeneration({
+                    config,
+                    apiKey,
+                    baseUrl,
+                    prompt: session.draft.prompt,
+                    model: session.generationModel,
+                    aspectRatio: session.draft.aspectRatio,
+                    quality: session.draft.quality,
+                    imageUrls: session.draft.imageUrls,
+                    outputDir: path.join(process.cwd(), 'kie-image'),
+                    download: true,
+                    signal: ac.signal,
+                });
+                session.tasks.push({
+                    taskId: result.taskId,
+                    prompt: session.draft.prompt,
+                    model: session.generationModel,
+                    createdAt: new Date().toISOString(),
+                    savedPaths: result.savedPaths,
+                });
+                persist();
+                printDraftBar(session);
+            }
+            catch (err) {
+                if (!isAbortError(err)) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(chalk.red(`\n❌ ${msg}\n`));
+                }
+                else {
+                    console.log(chalk.yellow('\n(已取消)\n'));
+                }
+            }
+            finally {
+                activeAbort = null;
+                isProcessing = false;
+            }
+        };
+        const leaveRepl = (reason) => {
+            if (exiting)
+                return;
+            exiting = true;
+            persist();
+            if (reason === 'sigint') {
+                console.log(chalk.gray(`\n👋 已退出 Image 工作台（草稿已保存，会话 ${sessionId}）`));
+            }
+            else if (reason === 'exit') {
+                console.log(chalk.gray(`\n👋 再见！草稿已保存 (${sessionId})`));
+            }
+            else {
+                console.log(chalk.gray('\n工作台已关闭（输入流结束）'));
+            }
+            console.log(chalk.gray('重新进入: kie image\n'));
+            rl.close();
+        };
+        rl.on('close', () => {
+            if (exiting)
+                resolve();
+        });
+        rl.on('SIGINT', () => {
+            if (activeAbort) {
+                activeAbort.abort();
+                return;
+            }
+            if (replMode !== 'chat') {
+                resetInputMode();
+                console.log(chalk.gray('\n已取消。\n'));
+                showPrompt();
+                return;
+            }
+            const now = Date.now();
+            if (now - lastIdleSigintAt < 1500) {
+                leaveRepl('sigint');
+                return;
+            }
+            lastIdleSigintAt = now;
+            console.log(chalk.gray('\n再按一次 Ctrl+C 将退出工作台（回到 PS/CMD）\n'));
+            showPrompt();
+        });
+        rl.on('line', async (line) => {
+            const input = normalizeSlashInput(line.trim());
+            if (isProcessing) {
+                if (input)
+                    console.log(chalk.gray('\n请等待完成（Ctrl+C 可取消）...\n'));
+                showPrompt();
+                return;
+            }
+            if (replMode === 'pick_gen_model') {
+                replMode = 'chat';
+                rl.setPrompt(PROMPT);
+                const picked = resolveImageModelPick(input);
+                if (picked) {
+                    session.generationModel = picked;
+                    setImageModel(config, picked);
+                    console.log(chalk.green(`✅ 生成模型: ${formatImageModelLabel(picked)}\n`));
+                    persist();
+                }
+                else
+                    console.log(chalk.gray('已取消。\n'));
+                printDraftBar(session);
+                showPrompt();
+                return;
+            }
+            if (replMode === 'pick_assist_model') {
+                replMode = 'chat';
+                rl.setPrompt(PROMPT);
+                const picked = resolveModelPickInput(input);
+                if (picked) {
+                    session.assistModel = picked;
+                    setImageAssistModel(config, picked);
+                    console.log(chalk.green(`✅ 助手模型: ${formatModelLabel(picked)}\n`));
+                    persist();
+                }
+                else
+                    console.log(chalk.gray('已取消。\n'));
+                showPrompt();
+                return;
+            }
+            if (replMode === 'chat' && input.endsWith('\\') && input.length > 1) {
+                multilineBuffer = [input.slice(0, -1)];
+                replMode = 'multiline';
+                rl.setPrompt(PROMPT_MULTILINE);
+                console.log(chalk.gray('多行模式：空行发送\n'));
+                showPrompt();
+                return;
+            }
+            if (replMode === 'multiline') {
+                if (!input) {
+                    const text = multilineBuffer.join('\n').trim();
+                    resetInputMode();
+                    if (!text) {
+                        showPrompt();
+                        return;
+                    }
+                    isProcessing = true;
+                    await runAssist(text);
+                    showPrompt();
+                    return;
+                }
+                multilineBuffer.push(input.endsWith('\\') ? input.slice(0, -1) : input);
+                showPrompt();
+                return;
+            }
+            if (!input) {
+                showPrompt();
+                return;
+            }
+            if (input.toLowerCase() === 'exit' || input.toLowerCase() === 'quit') {
+                leaveRepl('exit');
+                return;
+            }
+            if (input === '/help') {
+                printImageReplHelp();
+                showPrompt();
+                return;
+            }
+            if (input === '/new') {
+                persist();
+                sessionId = createImageSessionId();
+                setActiveImageSessionId(config, sessionId);
+                session = loadImageSession(config, sessionId);
+                session.generationModel = resolveImageModel(config);
+                session.assistModel = resolveImageAssistModel(config);
+                console.log(chalk.green(`✅ 新会话: ${sessionId}\n`));
+                printDraftBar(session);
+                showPrompt();
+                return;
+            }
+            if (input === '/draft') {
+                console.log(chalk.cyan('\n当前草稿:\n'));
+                console.log(chalk.white(session.draft.prompt || '(空)'));
+                if (session.draft.imageUrls.length) {
+                    console.log(chalk.gray('\n参考图:'));
+                    session.draft.imageUrls.forEach((u) => console.log(chalk.cyan(`  ${u}`)));
+                }
+                console.log();
+                showPrompt();
+                return;
+            }
+            if (input.startsWith('/set ')) {
+                const text = input.slice(5).trim();
+                if (!text) {
+                    console.log(chalk.yellow('用法: /set <提示词>\n'));
+                }
+                else {
+                    session.draft.prompt = text;
+                    persist();
+                    console.log(chalk.green('✅ 已直接写入草稿（未经助手）\n'));
+                    printDraftBar(session);
+                }
+                showPrompt();
+                return;
+            }
+            if (input === '/system') {
+                console.log(chalk.cyan('\n--- 助手系统提示词（动态，含当前草稿）---\n'));
+                console.log(chalk.gray(buildAssistSystemPrompt(session.generationModel, session.draft)));
+                console.log();
+                showPrompt();
+                return;
+            }
+            if (input === '/clear') {
+                session.draft = emptyDraft();
+                session.assistMessages = [];
+                persist();
+                console.log(chalk.green('✅ 已清空草稿与助手对话。\n'));
+                showPrompt();
+                return;
+            }
+            if (input === '/model' || input.startsWith('/model ')) {
+                const arg = input.slice(6).trim();
+                if (!arg) {
+                    printImageModelPickerMenu(session.generationModel);
+                    replMode = 'pick_gen_model';
+                    rl.setPrompt(PROMPT_PICK);
+                    showPrompt();
+                    return;
+                }
+                session.generationModel = arg;
+                setImageModel(config, arg);
+                console.log(chalk.green(`✅ 生成模型: ${formatImageModelLabel(arg)}\n`));
+                persist();
+                printDraftBar(session);
+                showPrompt();
+                return;
+            }
+            if (input === '/assist' || input.startsWith('/assist ')) {
+                const arg = input.slice(7).trim();
+                if (!arg) {
+                    printModelPickerMenu(session.assistModel);
+                    replMode = 'pick_assist_model';
+                    rl.setPrompt(PROMPT_PICK);
+                    showPrompt();
+                    return;
+                }
+                session.assistModel = arg;
+                setImageAssistModel(config, arg);
+                console.log(chalk.green(`✅ 助手模型: ${formatModelLabel(arg)}\n`));
+                persist();
+                showPrompt();
+                return;
+            }
+            if (input === '/tpl' || input.startsWith('/tpl ')) {
+                const rest = input.slice(4).trim();
+                if (!rest) {
+                    printTemplateList();
+                    showPrompt();
+                    return;
+                }
+                const parts = rest.split(/\s+/);
+                const tplId = resolveTemplatePick(parts[0]) ?? parts[0];
+                const subject = parts.slice(1).join(' ');
+                try {
+                    const { template, draft } = applyTemplate(tplId, subject);
+                    session.draft.prompt = draft.prompt ?? session.draft.prompt;
+                    if (draft.aspectRatio)
+                        session.draft.aspectRatio = draft.aspectRatio;
+                    if (draft.quality)
+                        session.draft.quality = draft.quality;
+                    if (template.suggestedModel) {
+                        console.log(chalk.gray(`提示: 此模板建议使用 ${template.suggestedModel}，可用 /model 切换`));
+                    }
+                    persist();
+                    console.log(chalk.green(`✅ 已应用模板「${template.label}」\n`));
+                    printDraftBar(session);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.log(chalk.red(`❌ ${msg}\n`));
+                }
+                showPrompt();
+                return;
+            }
+            if (input === '/optimize' || input.startsWith('/optimize ')) {
+                const hint = input.slice(9).trim();
+                isProcessing = true;
+                await runAssist(hint || '请让 prompt 更具体、更可生成', { optimizeOnly: true });
+                showPrompt();
+                return;
+            }
+            if (input.startsWith('/image-url ')) {
+                const url = input.slice(10).trim();
+                if (url) {
+                    session.draft.imageUrls.push(url);
+                    persist();
+                    console.log(chalk.green(`✅ 已添加参考图 (${session.draft.imageUrls.length})\n`));
+                }
+                showPrompt();
+                return;
+            }
+            if (input.startsWith('/ratio ')) {
+                session.draft.aspectRatio = input.slice(6).trim();
+                persist();
+                console.log(chalk.green(`✅ aspect_ratio = ${session.draft.aspectRatio}\n`));
+                showPrompt();
+                return;
+            }
+            if (input.startsWith('/quality ')) {
+                const q = input.slice(8).trim();
+                if (q === 'medium' || q === 'high') {
+                    session.draft.quality = q;
+                    persist();
+                    console.log(chalk.green(`✅ quality = ${q}\n`));
+                }
+                else {
+                    console.log(chalk.red('❌ 仅支持 medium 或 high\n'));
+                }
+                showPrompt();
+                return;
+            }
+            if (input === '/edit') {
+                const edited = readMultilineFromEditor(session.draft.prompt);
+                if (edited !== null) {
+                    session.draft.prompt = edited;
+                    persist();
+                    console.log(chalk.green('✅ 草稿已更新\n'));
+                    printDraftBar(session);
+                }
+                showPrompt();
+                return;
+            }
+            if (input === '/gen') {
+                await runGenerate();
+                showPrompt();
+                return;
+            }
+            if (input.startsWith('/')) {
+                console.log(chalk.yellow(`❌ 未知指令，输入 /help\n`));
+                showPrompt();
+                return;
+            }
+            isProcessing = true;
+            await runAssist(input);
+            showPrompt();
+        });
+        showPrompt();
+    });
+}

package/dist/image-session.js

@@ -0,0 +1,75 @@
+import fs from 'fs';
+import path from 'path';
+const DEFAULT_IMAGE_SESSION_ID = 'image-default';
+export function getImageSessionsDir(config) {
+    const dir = path.join(path.dirname(config.path), 'image-sessions');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+function sessionPath(config, sessionId) {
+    const safeId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    return path.join(getImageSessionsDir(config), `${safeId}.json`);
+}
+export function getActiveImageSessionId(config) {
+    return config.get('activeImageSessionId') || DEFAULT_IMAGE_SESSION_ID;
+}
+export function setActiveImageSessionId(config, sessionId) {
+    config.set('activeImageSessionId', sessionId);
+}
+export function createImageSessionId() {
+    return `image-${Date.now()}`;
+}
+export function emptyDraft() {
+    return { prompt: '', imageUrls: [] };
+}
+export function loadImageSession(config, sessionId) {
+    const filePath = sessionPath(config, sessionId);
+    if (!fs.existsSync(filePath)) {
+        return {
+            id: sessionId,
+            updatedAt: new Date().toISOString(),
+            generationModel: '',
+            assistModel: '',
+            draft: emptyDraft(),
+            assistMessages: [],
+            tasks: [],
+        };
+    }
+    try {
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        return {
+            id: raw.id || sessionId,
+            updatedAt: raw.updatedAt || '',
+            generationModel: raw.generationModel || '',
+            assistModel: raw.assistModel || '',
+            draft: {
+                prompt: raw.draft?.prompt ?? '',
+                imageUrls: Array.isArray(raw.draft?.imageUrls) ? raw.draft.imageUrls : [],
+                aspectRatio: raw.draft?.aspectRatio,
+                quality: raw.draft?.quality,
+            },
+            assistMessages: Array.isArray(raw.assistMessages) ? raw.assistMessages : [],
+            tasks: Array.isArray(raw.tasks) ? raw.tasks : [],
+        };
+    }
+    catch {
+        return {
+            id: sessionId,
+            updatedAt: new Date().toISOString(),
+            generationModel: '',
+            assistModel: '',
+            draft: emptyDraft(),
+            assistMessages: [],
+            tasks: [],
+        };
+    }
+}
+export function saveImageSession(config, session) {
+    const data = {
+        ...session,
+        updatedAt: new Date().toISOString(),
+    };
+    fs.writeFileSync(sessionPath(config, session.id), JSON.stringify(data, null, 2), 'utf-8');
+}

package/dist/image-templates.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+export const BUILTIN_IMAGE_TEMPLATES = [
+    {
+        id: 'portrait',
+        label: '人像摄影',
+        description: '写实棚拍人像，柔和布光',
+        aspectRatio: '2:3',
+        quality: 'high',
+        prompt: 'Professional studio portrait of {{subject}}, soft key light, shallow depth of field, 85mm lens, natural skin texture, neutral background, photorealistic, high detail',
+    },
+    {
+        id: 'product',
+        label: '白底商品图',
+        description: '电商白底产品照',
+        aspectRatio: '1:1',
+        quality: 'medium',
+        prompt: 'Professional product photography of {{subject}} on pure white background, soft studio lighting, centered composition, sharp focus, commercial e-commerce style, no text, no watermark',
+    },
+    {
+        id: 'cyberpunk',
+        label: '赛博朋克场景',
+        description: '霓虹夜景、电影感',
+        aspectRatio: '3:2',
+        prompt: 'Cinematic cyberpunk scene of {{subject}}, neon lights, rain-soaked streets, volumetric fog, high contrast, detailed environment, 35mm film look, moody atmosphere',
+    },
+    {
+        id: 'logo',
+        label: '简约 Logo',
+        description: '扁平矢量风格标志',
+        aspectRatio: '1:1',
+        prompt: 'Minimal flat vector logo design for {{subject}}, simple geometric shapes, limited color palette, clean lines, white background, modern brand identity, no photorealism',
+    },
+    {
+        id: 'i2i-edit',
+        label: '图生图编辑',
+        description: '在参考图基础上按描述修改',
+        aspectRatio: 'auto',
+        suggestedModel: 'gpt-image-2-image-to-image',
+        prompt: 'Edit the input image: {{subject}}. Preserve the main subject likeness and composition where appropriate. Match lighting and color temperature to the original. Photorealistic integration, no pasted-on look.',
+    },
+];
+export function findTemplate(id) {
+    const key = id.trim().toLowerCase();
+    return BUILTIN_IMAGE_TEMPLATES.find((t) => t.id === key || t.id.toLowerCase() === key);
+}
+export function applyTemplate(templateId, subject) {
+    const template = findTemplate(templateId);
+    if (!template) {
+        throw new Error(`未知模板: ${templateId}，使用 /tpl 查看列表`);
+    }
+    const sub = subject.trim() || 'the subject';
+    const prompt = template.prompt.replace(/\{\{subject\}\}/g, sub);
+    const draft = {
+        prompt,
+        aspectRatio: template.aspectRatio,
+        quality: template.quality,
+    };
+    return { template, draft };
+}
+export function printTemplateList() {
+    console.log(chalk.cyan('\n内置提示词模板:\n'));
+    BUILTIN_IMAGE_TEMPLATES.forEach((t, i) => {
+        console.log(`  ${chalk.cyan(String(i + 1).padStart(2))}. ${chalk.bold(t.id.padEnd(12))} ${t.label} — ${chalk.dim(t.description)}`);
+    });
+    console.log(chalk.gray('\n用法: /tpl <id> [主体描述]   例: /tpl product 无线蓝牙耳机\n'));
+}
+export function resolveTemplatePick(input) {
+    const trimmed = input.trim();
+    if (!trimmed || trimmed === '0')
+        return null;
+    const n = parseInt(trimmed, 10);
+    if (!Number.isNaN(n) && n >= 1 && n <= BUILTIN_IMAGE_TEMPLATES.length) {
+        return BUILTIN_IMAGE_TEMPLATES[n - 1].id;
+    }
+    return trimmed;
+}