@playcraft/cli 0.0.39 → 0.0.41

package/dist/commands/tools-project.js

@@ -0,0 +1,400 @@
+import { AgentApiClient } from '../utils/agent-api-client.js';
+import { researchCommand, fetchUrlCommand } from './tools-research.js';
+import { writeResult, handleError } from './tools-utils.js';
+export function registerProjectCommands(tools) {
+    // ─── Project Pipeline ───────────────────────────────────────
+    tools.command('save-to-git')
+        .description('同步沙箱内容到 Git 仓库')
+        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
+        .requiredOption('--message <text>', '提交信息')
+        .option('--branch <name>', '分支名', 'main')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.post('/save-to-git', {
+                projectId: opts.projectId,
+                branch: opts.branch,
+                commitMessage: opts.message,
+            });
+            if (result.success) {
+                console.log(`Saved to git: commit ${result.commitHash ?? 'unknown'}`);
+            }
+            else if (result.conflict) {
+                console.log(`Conflict detected in ${result.conflictFiles?.length ?? 0} file(s)`);
+                if (result.conflictFiles?.length) {
+                    for (const f of result.conflictFiles)
+                        console.log(`  - ${f}`);
+                }
+                process.exit(1);
+            }
+            else {
+                console.error(`Error: ${result.error ?? 'Save failed'}`);
+                process.exit(1);
+            }
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('build-project')
+        .description('在沙箱中执行项目构建')
+        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
+        .option('--branch <name>', '分支名', 'main')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.post('/build-project', {
+                projectId: opts.projectId,
+                branch: opts.branch,
+            });
+            if (result.success === false) {
+                if (result.output) {
+                    const logPath = writeResult('build', { output: result.output, error: result.error });
+                    console.error(`Build failed. Log: ${logPath}`);
+                }
+                else {
+                    console.error(`Error: ${result.error ?? 'Build failed'}`);
+                }
+                process.exit(1);
+            }
+            if (result.output) {
+                const logPath = writeResult('build', result);
+                console.log(`Build succeeded`);
+                console.log(`Log: ${logPath}`);
+            }
+            else {
+                console.log('Build succeeded');
+            }
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('publish')
+        .description('将构建产物上传到 COS，获取预览 URL')
+        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
+        .option('--branch <name>', '分支名', 'main')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.post('/publish-to-cos', {
+                projectId: opts.projectId,
+                branch: opts.branch,
+            });
+            if (result.success === false) {
+                console.error(`Error: ${result.error ?? 'Publish failed'}`);
+                process.exit(1);
+            }
+            if (result.previewUrl) {
+                console.log(`Published: ${result.previewUrl}`);
+            }
+            else {
+                console.log('Published successfully');
+            }
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('create-remix')
+        .description('基于项目创建 Remix 分支')
+        .requiredOption('--project-id <id>', '项目数字 ID')
+        .requiredOption('--name <name>', 'Remix 显示名称')
+        .option('--source-branch <name>', '源分支', 'main')
+        .option('--description <text>', '描述')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const projectId = Number(opts.projectId);
+            if (!Number.isInteger(projectId) || projectId <= 0) {
+                console.error(`Error: --project-id must be a positive integer, got: ${opts.projectId}`);
+                process.exit(1);
+            }
+            const result = await client.post('/create-remix', {
+                projectId,
+                sourceBranch: opts.sourceBranch,
+                name: opts.name,
+                description: opts.description,
+            });
+            if (result.success === false) {
+                console.error(`Error: ${result.error ?? 'Create remix failed'}`);
+                process.exit(1);
+            }
+            console.log(`Remix created: ${opts.name} (project ${result.projectId}, branch ${result.branchName})`);
+            if (result.editorUrl)
+                console.log(`Editor: ${result.editorUrl}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    // ─── Queries ────────────────────────────────────────────────
+    tools.command('list-templates')
+        .description('列出可用项目模板')
+        .option('--tag <filter>', '按标签过滤')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const params = {};
+            if (opts.tag)
+                params.tagFilter = opts.tag;
+            const result = await client.get('/list-templates', params);
+            const detailsPath = writeResult('list-templates', result);
+            if (opts.tag) {
+                console.log(`Found ${result.templateCount} templates matching "${opts.tag}" (${result.totalCount} total)`);
+            }
+            else {
+                console.log(`Found ${result.templateCount} templates`);
+            }
+            console.log(`Details: ${detailsPath}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('list-assets')
+        .description('列出项目资产')
+        .requiredOption('--project-id <id>', '项目数字 ID')
+        .option('--branch <name>', '分支名')
+        .option('--types <list>', '资产类型，逗号分隔（texture,script,audio,model...）')
+        .option('--search <keyword>', '名称搜索')
+        .option('--limit <n>', '最大数量', '30')
+        .option('--skip <n>', '偏移', '0')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const params = { projectId: opts.projectId };
+            if (opts.branch)
+                params.branch = opts.branch;
+            if (opts.types)
+                params.types = opts.types;
+            if (opts.search)
+                params.search = opts.search;
+            if (opts.limit)
+                params.limit = opts.limit;
+            if (opts.skip)
+                params.skip = opts.skip;
+            const result = await client.get('/list-project-assets', params);
+            const detailsPath = writeResult('list-assets', result);
+            const typeSummary = Object.entries(result.byTypeCount)
+                .map(([k, v]) => `${k}: ${v}`)
+                .join(', ');
+            console.log(`Found ${result.total} assets (${typeSummary})`);
+            console.log(`Details: ${detailsPath}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('list-remixes')
+        .description('列出可访问的 Remix 项目')
+        .option('--scope <scope>', 'my 或 gallery', 'my')
+        .option('--search <keyword>', '搜索')
+        .option('--limit <n>', '最大数量', '20')
+        .option('--page <n>', '页码', '1')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const params = {};
+            if (opts.scope)
+                params.scope = opts.scope;
+            if (opts.search)
+                params.search = opts.search;
+            if (opts.limit)
+                params.limit = opts.limit;
+            if (opts.page)
+                params.page = opts.page;
+            const result = await client.get('/list-remixes', params);
+            const detailsPath = writeResult('list-remixes', result);
+            console.log(`Found ${result.total} remixes (page ${result.page}/${result.totalPages})`);
+            console.log(`Details: ${detailsPath}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    // ─── Publish ────────────────────────────────────────────────
+    tools.command('publish-prefab')
+        .description('发布 Remixable Prefab 到资产库')
+        .requiredOption('--remix-project-id <id>', 'Remix 项目 ID', parseInt)
+        .requiredOption('--template <name>', '模板名')
+        .requiredOption('--variant <name>', '变体名')
+        .requiredOption('--prefab <name>', '预制件名')
+        .requiredOption('--staging-root <path>', 'Staging 目录路径')
+        .option('--visibility <v>', 'public 或 team', 'team')
+        .option('--team-id <id>', '团队 ID')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.post('/publish-prefab', {
+                remixProjectId: opts.remixProjectId,
+                templateName: opts.template,
+                variantName: opts.variant,
+                prefabName: opts.prefab,
+                stagingRoot: opts.stagingRoot,
+                visibility: opts.visibility,
+                teamId: opts.teamId,
+            });
+            if (result.success === false) {
+                console.error(`Error: ${result.error ?? 'Publish prefab failed'}`);
+                process.exit(1);
+            }
+            console.log(`Prefab published: ${result.bundlePath} (${result.uploaded} files)`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    // ─── Builds ─────────────────────────────────────────────────
+    tools.command('list-builds')
+        .description('查看云端构建列表')
+        .option('--project-id <id>', '项目数字 ID（不填则查看当前用户所有项目）')
+        .option('--branch <name>', '按分支过滤')
+        .option('--status <status>', '按状态过滤 (queued|running|success|failed)')
+        .option('--platform <platform>', '按平台过滤 (facebook|snapchat|playcraft...)')
+        .option('--search <keyword>', '按名称/提交信息搜索')
+        .option('--limit <n>', '最大数量', '20')
+        .option('--skip <n>', '偏移', '0')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const params = {};
+            if (opts.projectId)
+                params.projectId = opts.projectId;
+            if (opts.branch)
+                params.branchName = opts.branch;
+            if (opts.status)
+                params.status = opts.status;
+            if (opts.platform)
+                params.platform = opts.platform;
+            if (opts.search)
+                params.search = opts.search;
+            if (opts.limit)
+                params.limit = opts.limit;
+            if (opts.skip)
+                params.skip = opts.skip;
+            const result = await client.get('/list-builds', params);
+            const detailsPath = writeResult('list-builds', result);
+            const statusCounts = {};
+            for (const item of result.items) {
+                statusCounts[item.status] = (statusCounts[item.status] ?? 0) + 1;
+            }
+            const statusSummary = Object.entries(statusCounts).map(([s, n]) => `${s}: ${n}`).join(', ');
+            console.log(`Found ${result.total} builds (${statusSummary || 'none'})`);
+            console.log(`Details: ${detailsPath}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('get-build')
+        .description('查看单次构建详情（状态、产物、校验结果等）')
+        .requiredOption('--id <buildId>', '构建 ID')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.get('/get-build', { id: opts.id });
+            if ('error' in result && result.error) {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            const detailsPath = writeResult('get-build', result);
+            const statusLine = result.status === 'running' && result.progress != null
+                ? `${result.status} (${result.progress}%)`
+                : result.status;
+            const sizeMB = result.outputSize ? `${(result.outputSize / 1024 / 1024).toFixed(2)}MB` : 'unknown size';
+            const nameLabel = result.name ? ` "${result.name}"` : '';
+            console.log(`Build ${result.id}${nameLabel}: ${statusLine} [${result.platform}/${result.format}] ${sizeMB}`);
+            if (result.error)
+                console.log(`Error: ${result.error}`);
+            if (result.downloadUrl)
+                console.log(`Download: ${result.downloadUrl}`);
+            if (result.previewUrl)
+                console.log(`Preview: ${result.previewUrl}`);
+            if (result.validationPassed === false) {
+                const errors = (result.validationWarnings ?? []).filter((w) => w.severity === 'error');
+                console.log(`Validation: FAILED (${errors.length} error(s))`);
+            }
+            else if (result.validationPassed === true) {
+                console.log(`Validation: PASSED`);
+            }
+            console.log(`Details: ${detailsPath}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('get-build-download')
+        .description('获取构建产物下载地址')
+        .requiredOption('--id <buildId>', '构建 ID')
+        .action(async (opts) => {
+        try {
+            const client = new AgentApiClient();
+            const result = await client.get('/get-build-download', { id: opts.id });
+            if (result.error) {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            console.log(`Download URL: ${result.downloadUrl}`);
+            if (result.previewUrl)
+                console.log(`Preview URL: ${result.previewUrl}`);
+            const sizeMB = result.size ? ` (${(result.size / 1024 / 1024).toFixed(2)}MB)` : '';
+            console.log(`Platform: ${result.platform}/${result.format}${sizeMB}`);
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    // ─── Research & Fetch ───────────────────────────────────────
+    tools.command('research')
+        .description('使用 AI 搜索网络研究游戏设计、艺术风格、技术实现等主题（基于 Gemini + Google Search）')
+        .requiredOption('--query <query>', '研究问题或搜索关键词')
+        .option('--focus <focus>', '研究领域：gameplay | visual | audio | code | compliance')
+        .option('--json', '输出 JSON 格式（供 Agent 消费）')
+        .action(async (opts) => {
+        try {
+            const result = await researchCommand({ query: opts.query, focus: opts.focus });
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log('\n' + result.answer);
+                if (result.citations?.length) {
+                    console.log('\n--- Sources ---');
+                    for (const c of result.citations) {
+                        console.log(`• ${c.title || c.url}`);
+                        console.log(`  ${c.url}`);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+    tools.command('fetch-url')
+        .description('让 AI 读取并理解指定 URL 的内容（官方文档、教程、GitHub 页面等）')
+        .requiredOption('--url <url>', '要读取的 URL')
+        .option('--query <query>', '对该 URL 内容的具体问题（可选）')
+        .option('--json', '输出 JSON 格式（供 Agent 消费）')
+        .action(async (opts) => {
+        try {
+            const result = await fetchUrlCommand({ url: opts.url, query: opts.query });
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log('\n' + result.answer);
+                if (result.citations?.length) {
+                    console.log('\n--- Sources ---');
+                    for (const c of result.citations) {
+                        console.log(`• ${c.title || c.url}: ${c.url}`);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            handleError(e);
+        }
+    });
+}

package/dist/commands/tools-research.js

@@ -0,0 +1,37 @@
+/**
+ * tools research / fetch-url 命令的核心逻辑
+ *
+ * 提取为独立函数，方便单元测试和 Commander 注册。
+ */
+import { AgentApiClient } from '../utils/agent-api-client.js';
+/** 为测试注入自定义凭据的轻量 AgentApiClient 工厂 */
+function makeClient(opts) {
+    if (opts.apiUrl || opts.token) {
+        if (opts.apiUrl)
+            process.env.PLAYCRAFT_API_URL = opts.apiUrl;
+        if (opts.token)
+            process.env.PLAYCRAFT_SANDBOX_TOKEN = opts.token;
+    }
+    return new AgentApiClient();
+}
+/**
+ * 调用 POST /api/agent/tools/research，返回研究结果。
+ * 测试时通过 apiUrl / token 注入，生产时从环境变量 / .playcraft.json 读取。
+ */
+export async function researchCommand(opts) {
+    const client = makeClient({ apiUrl: opts.apiUrl, token: opts.token });
+    return client.post('/research', {
+        query: opts.query,
+        focus: opts.focus,
+    });
+}
+/**
+ * 调用 POST /api/agent/tools/fetch-url，返回 URL 内容摘要。
+ */
+export async function fetchUrlCommand(opts) {
+    const client = makeClient({ apiUrl: opts.apiUrl, token: opts.token });
+    return client.post('/fetch-url', {
+        url: opts.url,
+        query: opts.query,
+    });
+}

package/dist/commands/tools-research.test.js

@@ -0,0 +1,216 @@
+/**
+ * playcraft tools research / fetch-url 命令测试
+ *
+ * 覆盖：
+ * - 正确路径：research 返回 answer + citations
+ * - 正确路径：fetch-url 返回 answer + citations
+ * - focus 参数透传
+ * - query 参数透传
+ * - 后端返回 4xx / 5xx 时抛出错误
+ * - 鉴权头：sandbox JWT → X-Sandbox-Token；PAT → Authorization: Bearer
+ * - citation 为空时不崩溃
+ */
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from 'vitest';
+import http from 'node:http';
+import { researchCommand, fetchUrlCommand } from './tools-research.js';
+// ─── Mock loadGlobalConfig ─────────────────────────────────────────────────────
+vi.mock('../config.js', () => ({
+    loadGlobalConfig: vi.fn(() => ({})),
+    saveGlobalConfig: vi.fn(),
+    loadConfig: vi.fn(),
+}));
+let server;
+let baseUrl;
+let lastRequest = null;
+let responseStatus = 200;
+let responseBody = {
+    answer: 'Test answer from Gemini',
+    citations: [],
+};
+beforeAll(async () => {
+    server = http.createServer((req, res) => {
+        let body = '';
+        req.on('data', (chunk) => { body += chunk.toString(); });
+        req.on('end', () => {
+            lastRequest = {
+                url: req.url ?? '',
+                method: req.method ?? '',
+                headers: req.headers,
+                body,
+            };
+            res.writeHead(responseStatus, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(responseBody));
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(0, '127.0.0.1', () => resolve());
+    });
+    const addr = server.address();
+    baseUrl = `http://127.0.0.1:${addr.port}`;
+});
+afterAll(async () => {
+    await new Promise((resolve) => server.close(() => resolve()));
+});
+beforeEach(() => {
+    lastRequest = null;
+    responseStatus = 200;
+    responseBody = { answer: 'Test answer', citations: [] };
+    delete process.env.PLAYCRAFT_API_URL;
+    delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
+});
+afterEach(() => {
+    delete process.env.PLAYCRAFT_API_URL;
+    delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
+});
+// ─── Helper ───────────────────────────────────────────────────────────────────
+/** 解析测试服务器收到的请求 body */
+function parseBody() {
+    return JSON.parse(lastRequest?.body ?? '{}');
+}
+// ─── researchCommand ──────────────────────────────────────────────────────────
+describe('researchCommand', () => {
+    it('发送 POST 到 /api/agent/tools/research', async () => {
+        const result = await researchCommand({
+            query: 'match-3 level design',
+            apiUrl: baseUrl,
+            token: 'test-sandbox-token',
+        });
+        expect(lastRequest?.url).toBe('/api/agent/tools/research');
+        expect(lastRequest?.method).toBe('POST');
+        expect(result.answer).toBe('Test answer');
+    });
+    it('将 query 和 focus 正确写入请求 body', async () => {
+        await researchCommand({
+            query: 'pixel art color palette',
+            focus: 'visual',
+            apiUrl: baseUrl,
+            token: 'test-sandbox-token',
+        });
+        const body = parseBody();
+        expect(body.query).toBe('pixel art color palette');
+        expect(body.focus).toBe('visual');
+    });
+    it('不传 focus 时 body 中 focus 为 undefined（不发送该字段）', async () => {
+        await researchCommand({
+            query: 'game mechanics',
+            apiUrl: baseUrl,
+            token: 'test-sandbox-token',
+        });
+        const body = parseBody();
+        expect(body.query).toBe('game mechanics');
+        expect(body.focus).toBeUndefined();
+    });
+    it('所有 focus 枚举值均可正常透传', async () => {
+        const focuses = ['gameplay', 'visual', 'audio', 'code', 'compliance'];
+        for (const focus of focuses) {
+            await researchCommand({ query: 'test', focus, apiUrl: baseUrl, token: 'tok' });
+            expect(parseBody().focus).toBe(focus);
+        }
+    });
+    it('返回包含 citations 的完整结果', async () => {
+        responseBody = {
+            answer: 'Answer with citations',
+            citations: [
+                { url: 'https://example.com/1', title: 'Source 1' },
+                { url: 'https://example.com/2', title: 'Source 2', excerpt: 'excerpt text' },
+            ],
+        };
+        const result = await researchCommand({
+            query: 'test query',
+            apiUrl: baseUrl,
+            token: 'test-token',
+        });
+        expect(result.answer).toBe('Answer with citations');
+        expect(result.citations).toHaveLength(2);
+        expect(result.citations[0].url).toBe('https://example.com/1');
+        expect(result.citations[1].excerpt).toBe('excerpt text');
+    });
+    it('citations 为空数组时不崩溃', async () => {
+        responseBody = { answer: 'No citations answer', citations: [] };
+        const result = await researchCommand({
+            query: 'test',
+            apiUrl: baseUrl,
+            token: 'test-token',
+        });
+        expect(result.citations).toEqual([]);
+    });
+    it('使用沙箱 JWT 时发送 X-Sandbox-Token 头', async () => {
+        await researchCommand({ query: 'test', apiUrl: baseUrl, token: 'sandbox-jwt-eyJ...' });
+        expect(lastRequest?.headers['x-sandbox-token']).toBe('sandbox-jwt-eyJ...');
+        expect(lastRequest?.headers['authorization']).toBeUndefined();
+    });
+    it('使用 PAT 时发送 Authorization: Bearer 头', async () => {
+        await researchCommand({ query: 'test', apiUrl: baseUrl, token: 'playcraft_pat_abc123' });
+        expect(lastRequest?.headers['authorization']).toBe('Bearer playcraft_pat_abc123');
+        expect(lastRequest?.headers['x-sandbox-token']).toBeUndefined();
+    });
+    it('后端返回 400 时抛出错误', async () => {
+        responseStatus = 400;
+        responseBody = { error: 'query is required' };
+        await expect(researchCommand({ query: 'test', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/400/);
+    });
+    it('后端返回 500 时抛出错误', async () => {
+        responseStatus = 500;
+        responseBody = { error: 'Internal server error' };
+        await expect(researchCommand({ query: 'test', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/500/);
+    });
+});
+// ─── fetchUrlCommand ──────────────────────────────────────────────────────────
+describe('fetchUrlCommand', () => {
+    it('发送 POST 到 /api/agent/tools/fetch-url', async () => {
+        const result = await fetchUrlCommand({
+            url: 'https://phaser.io/docs/3.60.0',
+            apiUrl: baseUrl,
+            token: 'test-token',
+        });
+        expect(lastRequest?.url).toBe('/api/agent/tools/fetch-url');
+        expect(lastRequest?.method).toBe('POST');
+        expect(result.answer).toBe('Test answer');
+    });
+    it('将 url 和 query 正确写入请求 body', async () => {
+        await fetchUrlCommand({
+            url: 'https://phaser.io/docs/3.60.0',
+            query: 'how does TileMap collision work',
+            apiUrl: baseUrl,
+            token: 'test-token',
+        });
+        const body = parseBody();
+        expect(body.url).toBe('https://phaser.io/docs/3.60.0');
+        expect(body.query).toBe('how does TileMap collision work');
+    });
+    it('不传 query 时请求 body 中 query 为 undefined', async () => {
+        await fetchUrlCommand({
+            url: 'https://example.com',
+            apiUrl: baseUrl,
+            token: 'tok',
+        });
+        const body = parseBody();
+        expect(body.url).toBe('https://example.com');
+        expect(body.query).toBeUndefined();
+    });
+    it('返回包含 citations 的完整结果', async () => {
+        responseBody = {
+            answer: 'Content from URL',
+            citations: [{ url: 'https://phaser.io/docs', title: 'Phaser Docs' }],
+        };
+        const result = await fetchUrlCommand({
+            url: 'https://phaser.io/docs',
+            apiUrl: baseUrl,
+            token: 'tok',
+        });
+        expect(result.answer).toBe('Content from URL');
+        expect(result.citations[0].title).toBe('Phaser Docs');
+    });
+    it('使用 PAT 时发送 Authorization: Bearer 头', async () => {
+        await fetchUrlCommand({
+            url: 'https://example.com',
+            apiUrl: baseUrl,
+            token: 'playcraft_pat_xyz',
+        });
+        expect(lastRequest?.headers['authorization']).toBe('Bearer playcraft_pat_xyz');
+    });
+    it('后端返回 400 时抛出错误', async () => {
+        responseStatus = 400;
+        await expect(fetchUrlCommand({ url: 'https://example.com', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/400/);
+    });
+});