tezign-ai-appstore-sdk 0.2.2 → 0.2.4

package/dist/open-api/cli.js

@@ -6,7 +6,7 @@ import { clearOpenApiCliStoredKey, readOpenApiCliCurrentEnvironment, readOpenApi
 import { createOpenApiClient, OpenApiError } from './client.js';
 import { findOpenApiProjectLocalConfig, writeOpenApiProjectLocalConfig, } from './project-local-config.js';
 import { createOpenApiSourceArchive, inspectOpenApiSourceArchive } from './source-archive.js';
-import { OPEN_API_CLI_STDOUT_TYPESCRIPT_HELP, } from './cli-output-types.js';
+import { OPEN_API_CLI_STDOUT_TYPESCRIPT_HELP, toDeploymentRuntimeLogsStdout, } from './cli-output-types.js';
 import { OPEN_API_CLI_INPUT_TYPESCRIPT_HELP } from './cli-input-help.js';
 class CliUsageError extends Error {
     helpText;
@@ -68,12 +68,16 @@ const DAILY_WORKFLOW_HELP = [
         flag: '5. deploy',
         description: '触发部署并等待结果：tezign-ai-appstore project deploy',
     },
+    {
+        flag: '6. project deploy-html',
+        description: '为 STATIC_SITE 项目直接发布单个 HTML：tezign-ai-appstore project deploy-html --file ./landing.html',
+    },
 ];
 const COMMAND_GROUP_HELP = {
     auth: '登录、退出和查看本地 Open API CLI 认证状态',
     env: '管理 baseUrl 对应的环境别名',
-    project: '创建、绑定、更新、上传源码、部署项目及管理自定义访问域名',
-    deployment: '查询部署状态',
+    project: '创建、绑定、更新、上传源码、部署项目及管理自定义访问域名 / 环境变量',
+    deployment: '查询部署状态及 WEB_SERVICE 运行时日志',
 };
 const FINAL_DEPLOYMENT_STATUS = new Set(['READY', 'FAILED', 'SUCCEEDED']);
 const FAILED_DEPLOYMENT_STATUS = new Set(['FAILED']);
@@ -467,9 +471,45 @@ async function resolveProjectIdForCommand(options, commandKey, io) {
     }
     throw createCliUsageError(`${commandKey} requires --projectId，或先在当前目录执行 \`tezign-ai-appstore project init\` 绑定项目`, commandKey);
 }
+function readRequiredDeploymentIdOption(options, commandKey) {
+    const deploymentId = readStringOption(options, 'deploymentId') || readStringOption(options, 'id');
+    if (!deploymentId) {
+        throw createCliUsageError(`${commandKey} requires --deploymentId or --id`, commandKey);
+    }
+    return deploymentId;
+}
+function readExplicitDeploymentIdOption(options) {
+    return readStringOption(options, 'deploymentId') || readStringOption(options, 'id') || null;
+}
+async function resolveDeploymentIdForRuntimeLogs(options, commandKey, io, client) {
+    const explicitDeploymentId = readExplicitDeploymentIdOption(options);
+    if (explicitDeploymentId) {
+        return explicitDeploymentId;
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const projects = await client.listProjects();
+    const project = projects.find((item) => item.id === projectId);
+    if (!project) {
+        throw createCliUsageError(`项目 ${projectId} 不在当前账号可操作列表中`, commandKey);
+    }
+    const activeDeploymentId = project.activeDeploymentId;
+    if (!activeDeploymentId) {
+        throw createCliUsageError(`项目 ${projectId} 尚无生效部署（activeDeploymentId 为空），请先执行 project deploy 或显式传入 --deploymentId`, commandKey);
+    }
+    return activeDeploymentId;
+}
 const PROJECT_LIST_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config']);
 const PROJECT_UPDATE_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config', 'input', 'projectId', 'id']);
 const PROJECT_DEPLOY_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config', 'projectId', 'id']);
+const PROJECT_DEPLOY_HTML_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+    'file',
+    'remark',
+]);
 const PROJECT_INIT_ALLOWED_OPTION_KEYS = new Set([
     'env',
     'baseUrl',
@@ -491,6 +531,32 @@ const PROJECT_UPLOAD_SOURCE_ALLOWED_OPTION_KEYS = new Set([
     'remark',
     'dry-run',
 ]);
+const PROJECT_GET_ENV_VARS_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+]);
+const PROJECT_SET_ENV_VARS_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+    'input',
+    'replace',
+    'clear',
+]);
+const PROJECT_UNSET_ENV_VARS_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+    'key',
+    'keys',
+]);
 const PROJECT_LIST_DOMAINS_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config', 'projectId', 'id']);
 const PROJECT_ADD_DOMAIN_ALLOWED_OPTION_KEYS = new Set([
     'env',
@@ -510,28 +576,72 @@ const PROJECT_REMOVE_DOMAIN_ALLOWED_OPTION_KEYS = new Set([
     'id',
     'domain-id',
 ]);
-function buildUpdateProjectInput(options) {
-    const commandKey = 'project update';
-    for (const key of Object.keys(options)) {
-        if (!PROJECT_UPDATE_ALLOWED_OPTION_KEYS.has(key)) {
-            throw createCliUsageError(`project update 不再支持 --${key}，请使用 --input 传入更新请求体 JSON（与 Open API 更新项目接口一致）`, commandKey);
-        }
-    }
-    const raw = readStringOption(options, 'input');
+const DEPLOYMENT_RUNTIME_LOGS_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'deploymentId',
+    'id',
+    'projectId',
+]);
+function parseRequiredJsonObjectOption(options, name, commandKey) {
+    const raw = readStringOption(options, name);
     if (!raw) {
-        throw createCliUsageError('project update 需要 --input <json>，内容为更新项目的请求体', commandKey);
+        throw createCliUsageError(`${commandKey} 需要 --${name} <json>`, commandKey);
     }
     let parsed;
     try {
         parsed = JSON.parse(raw);
     }
     catch {
-        throw createCliUsageError('Invalid JSON value for --input', commandKey);
+        throw createCliUsageError(`Invalid JSON value for --${name}`, commandKey);
     }
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw createCliUsageError('--input must be a JSON object', commandKey);
+        throw createCliUsageError(`--${name} must be a JSON object`, commandKey);
     }
-    const input = parsed;
+    return parsed;
+}
+function normalizeEnvVarsRecord(input, commandKey) {
+    const envVars = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (typeof value !== 'string') {
+            throw createCliUsageError(`${commandKey} 的 --input 里环境变量 ${key} 的值必须是字符串`, commandKey);
+        }
+        envVars[key] = value;
+    }
+    return envVars;
+}
+function readEnvVarKeysToUnset(options, commandKey) {
+    const rawSingleKey = readStringOption(options, 'key');
+    const rawMultiKeys = readStringOption(options, 'keys');
+    if (!rawSingleKey && !rawMultiKeys) {
+        throw createCliUsageError(`${commandKey} 需要 --key <name> 或 --keys <a,b,c>`, commandKey);
+    }
+    const keys = [];
+    if (rawSingleKey) {
+        const key = rawSingleKey.trim();
+        if (!key) {
+            throw createCliUsageError(`Invalid value for --key: ${rawSingleKey}`, commandKey);
+        }
+        keys.push(key);
+    }
+    if (rawMultiKeys) {
+        const items = rawMultiKeys.split(',').map((item) => item.trim());
+        if (items.some((item) => !item)) {
+            throw createCliUsageError(`${commandKey} 的 --keys 必须是逗号分隔的非空 key 列表`, commandKey);
+        }
+        keys.push(...items);
+    }
+    return [...new Set(keys)];
+}
+function buildUpdateProjectInput(options) {
+    const commandKey = 'project update';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_UPDATE_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`project update 不再支持 --${key}，请使用 --input 传入更新请求体 JSON（与 Open API 更新项目接口一致）`, commandKey);
+        }
+    }
+    const input = parseRequiredJsonObjectOption(options, 'input', commandKey);
     if (Object.keys(input).length === 0) {
         throw createCliUsageError('project update 的 --input 须为非空对象（至少包含一个要更新的字段）', commandKey);
     }
@@ -562,6 +672,14 @@ function parseOptionArgs(argv, commandKey) {
     }
     return options;
 }
+function normalizeCommandArgs(commandKey, argv) {
+    if (commandKey === 'project deploy-html' &&
+        argv.length > 0 &&
+        !argv[0].startsWith('--')) {
+        return ['--file', argv[0], ...argv.slice(1)];
+    }
+    return argv;
+}
 async function resolveCliTarget(options, commandKey, io, behavior = {}) {
     const configPath = readStringOption(options, 'config');
     const explicitEnvName = readStringOption(options, 'env');
@@ -989,6 +1107,92 @@ async function handleProjectUpdate(options, io) {
     const project = await client.updateProject(projectId, buildUpdateProjectInput(options));
     printJson(project, io);
 }
+async function handleProjectGetEnvVars(options, io) {
+    const commandKey = 'project get-env-vars';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_GET_ENV_VARS_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project get-env-vars: --${key}`, commandKey);
+        }
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const payload = await client.getProjectEnvVars(projectId);
+    printJson(payload, io);
+}
+function buildSetProjectEnvVarsRequest(options, currentEnvVars) {
+    const commandKey = 'project set-env-vars';
+    const shouldReplace = readBooleanOption(options, 'replace', commandKey) ?? false;
+    const shouldClear = readBooleanOption(options, 'clear', commandKey) ?? false;
+    if (shouldClear) {
+        if (readStringOption(options, 'input')) {
+            throw createCliUsageError('project set-env-vars 传入 --clear 时不能同时传 --input；请二选一', commandKey);
+        }
+        if (shouldReplace) {
+            throw createCliUsageError('project set-env-vars 传入 --clear 时不需要再传 --replace', commandKey);
+        }
+        return { envVars: null };
+    }
+    const input = parseRequiredJsonObjectOption(options, 'input', commandKey);
+    const normalizedInput = normalizeEnvVarsRecord(input, commandKey);
+    if (shouldReplace) {
+        return {
+            envVars: Object.keys(normalizedInput).length > 0 ? normalizedInput : null,
+        };
+    }
+    return {
+        envVars: {
+            ...(currentEnvVars ?? {}),
+            ...normalizedInput,
+        },
+    };
+}
+async function handleProjectSetEnvVars(options, io) {
+    const commandKey = 'project set-env-vars';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_SET_ENV_VARS_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project set-env-vars: --${key}`, commandKey);
+        }
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const current = await client.getProjectEnvVars(projectId);
+    const requestBody = buildSetProjectEnvVarsRequest(options, current.envVars);
+    const payload = await client.setProjectEnvVars(projectId, requestBody);
+    printJson(payload, io);
+}
+async function handleProjectUnsetEnvVars(options, io) {
+    const commandKey = 'project unset-env-vars';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_UNSET_ENV_VARS_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project unset-env-vars: --${key}`, commandKey);
+        }
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const keysToUnset = readEnvVarKeysToUnset(options, commandKey);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const current = await client.getProjectEnvVars(projectId);
+    const currentEnvVars = current.envVars ?? {};
+    const nextEnvVars = Object.fromEntries(Object.entries(currentEnvVars).filter(([key]) => !keysToUnset.includes(key)));
+    const missingKeys = keysToUnset.filter((key) => !Object.prototype.hasOwnProperty.call(currentEnvVars, key));
+    if (Object.keys(nextEnvVars).length === Object.keys(currentEnvVars).length) {
+        if (missingKeys.length > 0) {
+            io.stderr(`以下环境变量不存在，已跳过：${missingKeys.join(', ')}`);
+        }
+        io.stderr('未发生环境变量变更。');
+        printJson(current, io);
+        return;
+    }
+    const payload = await client.setProjectEnvVars(projectId, {
+        envVars: Object.keys(nextEnvVars).length > 0 ? nextEnvVars : null,
+    });
+    if (missingKeys.length > 0) {
+        io.stderr(`以下环境变量不存在，已跳过：${missingKeys.join(', ')}`);
+    }
+    printJson(payload, io);
+}
 async function handleProjectDeploy(options, io) {
     const commandKey = 'project deploy';
     for (const key of Object.keys(options)) {
@@ -1016,6 +1220,48 @@ async function handleProjectDeploy(options, io) {
             : `部署成功。应用访问链接：\n${urls.map((u) => `  • ${u}`).join('\n')}`);
     }
 }
+async function handleProjectDeployHtml(options, io) {
+    const commandKey = 'project deploy-html';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_DEPLOY_HTML_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project deploy-html: --${key}`, commandKey);
+        }
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const filePath = readStringOption(options, 'file');
+    if (!filePath) {
+        throw createCliUsageError('project deploy-html requires <html-file> or --file <path>', commandKey);
+    }
+    const filename = basename(filePath);
+    if (!filename.toLowerCase().endsWith('.html') && !filename.toLowerCase().endsWith('.htm')) {
+        throw createCliUsageError('project deploy-html requires a .html or .htm file', commandKey);
+    }
+    const htmlBuffer = await readFile(resolve(filePath)).catch((error) => {
+        throw new Error(`读取 HTML 文件失败：${error instanceof Error ? error.message : String(error || 'unknown error')}`);
+    });
+    const deployment = await client.deployProjectHtml(projectId, {
+        file: new Blob([htmlBuffer], { type: 'text/html' }),
+        filename,
+        remark: readStringOption(options, 'remark') || null,
+    });
+    const finalDeployment = await waitForDeploymentCompletion(deployment, client, cliOptions, io);
+    printJson(finalDeployment, io);
+    if (isFailedDeploymentStatus(finalDeployment.status)) {
+        throw new Error(`部署失败（deploymentId: ${finalDeployment.deploymentId || finalDeployment.id}）`);
+    }
+    const urls = Array.isArray(finalDeployment.accessUrls) && finalDeployment.accessUrls.length > 0
+        ? finalDeployment.accessUrls
+        : typeof finalDeployment.accessUrl === 'string' && finalDeployment.accessUrl.length > 0
+            ? [finalDeployment.accessUrl]
+            : [];
+    if (urls.length > 0) {
+        io.stderr(urls.length === 1
+            ? `HTML 发布成功。应用访问链接：${urls[0]}`
+            : `HTML 发布成功。应用访问链接：\n${urls.map((u) => `  • ${u}`).join('\n')}`);
+    }
+}
 async function handleProjectUploadSource(options, io) {
     const commandKey = 'project upload-source';
     for (const key of Object.keys(options)) {
@@ -1171,15 +1417,25 @@ async function handleProjectRemoveDomain(options, io) {
 }
 async function handleDeploymentGet(options, io) {
     const commandKey = 'deployment get';
-    const deploymentId = readStringOption(options, 'deploymentId') || readStringOption(options, 'id');
-    if (!deploymentId) {
-        throw createCliUsageError('deployment get requires --deploymentId or --id', commandKey);
-    }
+    const deploymentId = readRequiredDeploymentIdOption(options, commandKey);
     const cliOptions = await resolveCliOptions(options, commandKey, io);
     const client = createOpenApiCliClient(cliOptions);
     const deployment = await client.getDeployment(deploymentId);
     printJson(deployment, io);
 }
+async function handleDeploymentRuntimeLogs(options, io) {
+    const commandKey = 'deployment runtime-logs';
+    for (const key of Object.keys(options)) {
+        if (!DEPLOYMENT_RUNTIME_LOGS_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for deployment runtime-logs: --${key}`, commandKey);
+        }
+    }
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const deploymentId = await resolveDeploymentIdForRuntimeLogs(options, commandKey, io, client);
+    const runtimeLogs = await client.getDeploymentRuntimeLogs(deploymentId);
+    printJson(toDeploymentRuntimeLogsStdout(runtimeLogs), io);
+}
 function commandDefinitions() {
     return [
         {
@@ -1415,6 +1671,98 @@ function commandDefinitions() {
             ],
             handler: handleProjectUpdate,
         },
+        {
+            key: 'project get-env-vars',
+            group: 'project',
+            action: 'get-env-vars',
+            summary: '读取项目当前环境变量（返回真实值，请谨慎处理）',
+            usage: [
+                'tezign-ai-appstore project get-env-vars [--env test | --baseUrl https://platform.example.com] [--projectId proj_123]',
+            ],
+            options: [...TARGET_CLI_OPTION_HELP, PROJECT_ID_CLI_OPTION_HELP],
+            notes: [
+                '返回真实环境变量值，可能包含 API Key、Token 等敏感信息；请避免直接贴到日志、工单或公开聊天中。',
+                '需要 Open API scope `project:update`。',
+                '未传 --projectId / --id 时，读取当前目录 .tezign/open-api-project.json 绑定。',
+            ],
+            examples: [
+                'tezign-ai-appstore project get-env-vars',
+                'tezign-ai-appstore project get-env-vars --projectId proj_123',
+            ],
+            handler: handleProjectGetEnvVars,
+        },
+        {
+            key: 'project set-env-vars',
+            group: 'project',
+            action: 'set-env-vars',
+            summary: '写入项目环境变量；默认按 key 合并，支持整表替换或清空',
+            usage: [
+                'tezign-ai-appstore project set-env-vars [--env test | --baseUrl https://platform.example.com] [--projectId proj_123] --input \'{"OPENAI_API_KEY":"sk-xxx"}\'',
+                'tezign-ai-appstore project set-env-vars [--projectId proj_123] --replace --input \'{"FEATURE_FLAG":"true"}\'',
+                'tezign-ai-appstore project set-env-vars [--projectId proj_123] --clear',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                PROJECT_ID_CLI_OPTION_HELP,
+                {
+                    flag: '--input <json>',
+                    description: '可选。环境变量 JSON 对象，value 必须为字符串；默认以 key 为单位合并到现有环境变量中。',
+                },
+                {
+                    flag: '--replace <bool>',
+                    description: '可选。为 true 时，用 --input 整体替换当前环境变量集合；可写 --replace 或 --replace true。',
+                },
+                {
+                    flag: '--clear <bool>',
+                    description: '可选。清空当前项目全部环境变量；可写 --clear 或 --clear true。传入时不能同时传 --input。',
+                },
+            ],
+            notes: [
+                '默认行为是“合并更新”：只覆盖 --input 中给出的 key，未给出的现有 key 会保留。',
+                '如需精确控制最终结果，请先执行 project get-env-vars 查看当前值，再用 --replace 提交完整目标集合。',
+                '保存后需要重新部署，新的环境变量才会注入到运行中的 Web Service 实例。',
+                '需要 Open API scope `project:update`。',
+            ],
+            examples: [
+                `tezign-ai-appstore project set-env-vars --projectId proj_123 --input '{"OPENAI_API_KEY":"sk-xxx","FEATURE_FLAG":"true"}'`,
+                `tezign-ai-appstore project set-env-vars --projectId proj_123 --replace --input '{"ONLY_THIS":"1"}'`,
+                'tezign-ai-appstore project set-env-vars --projectId proj_123 --clear',
+            ],
+            handler: handleProjectSetEnvVars,
+        },
+        {
+            key: 'project unset-env-vars',
+            group: 'project',
+            action: 'unset-env-vars',
+            summary: '删除指定环境变量 key，支持单个或多个 key',
+            usage: [
+                'tezign-ai-appstore project unset-env-vars [--env test | --baseUrl https://platform.example.com] [--projectId proj_123] --key OPENAI_API_KEY',
+                'tezign-ai-appstore project unset-env-vars [--projectId proj_123] --keys OPENAI_API_KEY,FEATURE_FLAG',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                PROJECT_ID_CLI_OPTION_HELP,
+                {
+                    flag: '--key <name>',
+                    description: '可选。删除单个环境变量 key。',
+                },
+                {
+                    flag: '--keys <a,b,c>',
+                    description: '可选。删除多个环境变量 key，使用英文逗号分隔。',
+                },
+            ],
+            notes: [
+                '支持 --key 和 --keys 同时传入；CLI 会合并后去重处理。',
+                '如果指定的 key 当前不存在，命令会跳过并在 stderr 提示。',
+                '保存后需要重新部署，新的环境变量才会注入到运行中的 Web Service 实例。',
+                '需要 Open API scope `project:update`。',
+            ],
+            examples: [
+                'tezign-ai-appstore project unset-env-vars --key OPENAI_API_KEY',
+                'tezign-ai-appstore project unset-env-vars --projectId proj_123 --keys OPENAI_API_KEY,FEATURE_FLAG',
+            ],
+            handler: handleProjectUnsetEnvVars,
+        },
         {
             key: 'project deploy',
             group: 'project',
@@ -1439,6 +1787,41 @@ function commandDefinitions() {
             ],
             handler: handleProjectDeploy,
         },
+        {
+            key: 'project deploy-html',
+            group: 'project',
+            action: 'deploy-html',
+            summary: '为 STATIC_SITE 项目直接上传单个 HTML 并发布',
+            usage: [
+                'tezign-ai-appstore project deploy-html <html-file>',
+                'tezign-ai-appstore project deploy-html [--env test | --baseUrl https://platform.example.com] [--projectId proj_123] --file ./landing.html',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                PROJECT_ID_CLI_OPTION_HELP,
+                {
+                    flag: '--file <path>',
+                    description: '必填。本地 .html / .htm 文件路径；也可将文件路径作为第一个位置参数传入。',
+                },
+                {
+                    flag: '--remark <text>',
+                    description: '可选。发布备注，会记录到源码包历史中。',
+                },
+            ],
+            notes: [
+                '未传 --projectId / --id 时，必须先在当前目录执行 project init 生成项目绑定。',
+                '当用户的网站只有单个 .html / .htm 文件时使用。',
+                '仅 STATIC_SITE 类型项目支持此命令；非 STATIC_SITE 项目会返回业务错误。',
+                '仅支持单个 .html / .htm 文件，会以 index.html 形式直接发布，跳过构建。',
+                'CLI 会自动等待最终状态；成功时 stdout JSON 含 accessUrls（及 accessUrl 首项）。',
+            ],
+            examples: [
+                'tezign-ai-appstore project deploy-html ./landing.html',
+                'tezign-ai-appstore project deploy-html --env test --projectId proj_123 --file ./build/index.html',
+                'tezign-ai-appstore project deploy-html --projectId proj_123 --file ./landing.htm --remark "promo page"',
+            ],
+            handler: handleProjectDeployHtml,
+        },
         {
             key: 'project upload-source',
             group: 'project',
@@ -1573,6 +1956,39 @@ function commandDefinitions() {
             ],
             handler: handleDeploymentGet,
         },
+        {
+            key: 'deployment runtime-logs',
+            group: 'deployment',
+            action: 'runtime-logs',
+            summary: '查看 WEB_SERVICE deployment 的运行时日志快照',
+            usage: [
+                'tezign-ai-appstore deployment runtime-logs [--env test | --baseUrl https://platform.example.com] [--deploymentId dep_123]',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                {
+                    flag: '--deploymentId <id>',
+                    description: '可选。部署 ID；也可用 --id <id>。未传时从 --projectId 或当前目录绑定项目解析，并取该项目 activeDeploymentId（当前生效部署）。',
+                },
+                {
+                    flag: '--projectId <id>',
+                    description: '未传 --deploymentId 时可用；也可用 --id <id>。未传且当前目录已绑定项目时，自动使用绑定项目。',
+                },
+            ],
+            notes: [
+                '仅适用于 WEB_SERVICE deployment；STATIC_SITE 会返回业务错误。',
+                '返回的是当前相关实例的 stdout/stderr 日志尾部快照，不是实时流式 follow。',
+                '未传 --deploymentId / --id 时，会调用 project list 取绑定项目的 activeDeploymentId。',
+                '未传 --env / --baseUrl 时，按目标平台解析顺序选择查询环境。',
+            ],
+            examples: [
+                'tezign-ai-appstore deployment runtime-logs --env test --deploymentId dep_123',
+                'tezign-ai-appstore deployment runtime-logs --deploymentId dep_123',
+                'tezign-ai-appstore deployment runtime-logs',
+                'tezign-ai-appstore deployment runtime-logs --projectId proj_123',
+            ],
+            handler: handleDeploymentRuntimeLogs,
+        },
     ];
 }
 function formatCliError(error) {
@@ -1637,7 +2053,7 @@ export async function runOpenApiCli(argv = typeof process !== 'undefined' ? proc
             output.stdout(renderCommandHelp(command.key));
             return;
         }
-        await command.handler(parseOptionArgs(restArgs, command.key), output);
+        await command.handler(parseOptionArgs(normalizeCommandArgs(command.key, restArgs), command.key), output);
     }
     catch (error) {
         output.stderr(formatCliError(error));