tezign-ai-appstore-sdk 0.2.0 → 0.2.2

package/dist/open-api/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/open-api/cli.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAanF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAA;AAEzE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,8BAA8B,CAAA;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAq2BD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBrF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAKhF;AAshCD,wBAAsB,aAAa,CACjC,IAAI,GAAE,MAAM,EAAgE,EAC5E,EAAE,GAAE,YAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAmEf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/open-api/cli.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAsCnF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAA;AAEzE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,8BAA8B,CAAA;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA+3BD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBrF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAKhF;AAoqCD,wBAAsB,aAAa,CACjC,IAAI,GAAE,MAAM,EAAgE,EAC5E,EAAE,GAAE,YAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/open-api/cli.js

@@ -6,6 +6,8 @@ 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_INPUT_TYPESCRIPT_HELP } from './cli-input-help.js';
 class CliUsageError extends Error {
     helpText;
     constructor(message, helpText) {
@@ -24,7 +26,7 @@ const ENV_TARGET_CLI_OPTION_HELP = {
 };
 const BASE_URL_TARGET_CLI_OPTION_HELP = {
     flag: '--baseUrl <url>',
-    description: '可选。直接指定平台地址，例如 https://ops.static.tezign.com。未传 --env 时使用；会去掉末尾斜杠。',
+    description: '可选。直接指定平台地址。未传 --env 时使用；会去掉末尾斜杠。',
 };
 const TARGET_CLI_OPTION_HELP = [
     ENV_TARGET_CLI_OPTION_HELP,
@@ -59,7 +61,7 @@ const DAILY_WORKFLOW_HELP = [
         description: '在项目目录中新建或绑定平台项目：tezign-ai-appstore project init --env test --mode create --input \'{"name":"Demo"}\'',
     },
     {
-        flag: '4. upload-source',
+        flag: '4. project upload-source',
         description: '先 dry-run 预览，再上传源码：tezign-ai-appstore project upload-source --dry-run',
     },
     {
@@ -70,7 +72,7 @@ const DAILY_WORKFLOW_HELP = [
 const COMMAND_GROUP_HELP = {
     auth: '登录、退出和查看本地 Open API CLI 认证状态',
     env: '管理 baseUrl 对应的环境别名',
-    project: '创建、绑定、更新、上传源码和部署项目',
+    project: '创建、绑定、更新、上传源码、部署项目及管理自定义访问域名',
     deployment: '查询部署状态',
 };
 const FINAL_DEPLOYMENT_STATUS = new Set(['READY', 'FAILED', 'SUCCEEDED']);
@@ -97,12 +99,22 @@ function renderGlobalHelp() {
         '  tezign-ai-appstore <group> --help',
         '  tezign-ai-appstore <group> <action> --help',
         '',
+        'Help command:',
+        '  tezign-ai-appstore help                      查看全局帮助与推荐工作流',
+        '  tezign-ai-appstore help <group>              查看某个命令组下有哪些 action',
+        '  tezign-ai-appstore help <group> <action>     查看具体命令的参数、说明和示例',
+        '',
+        'Equivalent forms:',
+        '  tezign-ai-appstore help project              == tezign-ai-appstore project --help',
+        '  tezign-ai-appstore help project init         == tezign-ai-appstore project init --help',
+        '',
         'Command groups:',
     ];
     for (const [group, description] of Object.entries(COMMAND_GROUP_HELP)) {
         lines.push(`  ${group.padEnd(11)}${description}`);
     }
-    lines.push('', 'Recommended workflow:', ...DAILY_WORKFLOW_HELP.map((item) => `  ${item.flag.padEnd(16)}${item.description}`), '', 'More help:', '  tezign-ai-appstore help project', '  tezign-ai-appstore project --help', '  tezign-ai-appstore help project upload-source', '  tezign-ai-appstore project create --help');
+    lines.push('', '通用规则:', ...TARGET_RESOLUTION_HELP.map((line) => `  - ${line}`));
+    lines.push('', 'Recommended workflow:', ...DAILY_WORKFLOW_HELP.map((item) => `  ${item.flag.padEnd(16)}${item.description}`), '', 'More help:', '  tezign-ai-appstore help project', '  tezign-ai-appstore project --help', '  tezign-ai-appstore help project upload-source', '  tezign-ai-appstore project init --help');
     return lines.join('\n');
 }
 function renderGroupHelp(group) {
@@ -114,13 +126,25 @@ function renderGroupHelp(group) {
         '',
         'Commands:',
     ];
+    const omitUsageLines = group === 'project' || group === 'env';
     for (const command of commands) {
         lines.push(`  ${command.action.padEnd(15)}${command.summary}`);
-        for (const usage of command.usage) {
-            lines.push(`    ${usage}`);
+        if (!omitUsageLines) {
+            for (const usage of command.usage) {
+                lines.push(`    ${usage}`);
+            }
         }
     }
-    lines.push('', `Run \`tezign-ai-appstore ${group} <action> --help\` to see command options, parameter rules, and examples.`);
+    if (group === 'env') {
+        lines.push('', '说明:', '  • 其它命令（auth / project / deployment 等）可传 `--env <name>` 显式指定使用的环境别名。', '  • 不显式传 `--env` / `--baseUrl` 时，按全局「通用规则」解析目标平台；通常会使用配置文件中的默认当前环境（`currentEnvironment`），或由目录绑定等规则推断。', '  • 查看当前默认环境别名：执行 `tezign-ai-appstore env list`，输出 JSON 的 `currentEnvironment`（未设置时为 null）；也可参考 `auth status` 中的 `currentEnvironment`。');
+    }
+    const simplifiedFooter = group === 'project'
+        ? '子命令详情请执行：tezign-ai-appstore project <action> --help（含选项、--input/stdout 形状与示例）。'
+        : group === 'env'
+            ? '子命令详情请执行：tezign-ai-appstore env <action> --help（含选项与示例）。'
+            : null;
+    lines.push('', simplifiedFooter ??
+        `Run \`tezign-ai-appstore ${group} <action> --help\` to see command options, parameter rules, and examples.`);
     return lines.join('\n');
 }
 function renderCommandHelp(commandKey) {
@@ -140,6 +164,16 @@ function renderCommandHelp(commandKey) {
         lines.push('', 'Options:');
         lines.push(...command.options.map((option) => `  ${option.flag.padEnd(24)}${option.description}`));
     }
+    const inputTypescriptHelp = OPEN_API_CLI_INPUT_TYPESCRIPT_HELP[command.key];
+    if (inputTypescriptHelp) {
+        lines.push('', '--input JSON（TypeScript 形状）:');
+        lines.push(...inputTypescriptHelp.split('\n').map((line) => `  ${line}`));
+    }
+    const stdoutTypescriptHelp = OPEN_API_CLI_STDOUT_TYPESCRIPT_HELP[command.key];
+    if (stdoutTypescriptHelp) {
+        lines.push('', 'Stdout (JSON 对应的 TypeScript 形状):');
+        lines.push(...stdoutTypescriptHelp.split('\n').map((line) => `  ${line}`));
+    }
     if (command.notes && command.notes.length > 0) {
         lines.push('', 'Notes:');
         lines.push(...command.notes.map((note) => `  - ${note}`));
@@ -433,7 +467,6 @@ async function resolveProjectIdForCommand(options, commandKey, io) {
     }
     throw createCliUsageError(`${commandKey} requires --projectId，或先在当前目录执行 \`tezign-ai-appstore project init\` 绑定项目`, commandKey);
 }
-const PROJECT_CREATE_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config', 'input']);
 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']);
@@ -458,33 +491,25 @@ const PROJECT_UPLOAD_SOURCE_ALLOWED_OPTION_KEYS = new Set([
     'remark',
     'dry-run',
 ]);
-function buildCreateProjectInput(options) {
-    const commandKey = 'project create';
-    for (const key of Object.keys(options)) {
-        if (!PROJECT_CREATE_ALLOWED_OPTION_KEYS.has(key)) {
-            throw createCliUsageError(`project create 不再支持 --${key}，请使用 --input 传入完整 JSON 请求体（与 Open API 创建项目接口一致）`, commandKey);
-        }
-    }
-    const raw = readStringOption(options, 'input');
-    if (!raw) {
-        throw createCliUsageError('project create 需要 --input <json>，内容为创建项目的请求体', commandKey);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw createCliUsageError('Invalid JSON value for --input', commandKey);
-    }
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw createCliUsageError('--input must be a JSON object', commandKey);
-    }
-    const input = parsed;
-    if (typeof input.name !== 'string' || !input.name.trim()) {
-        throw createCliUsageError('project create 需要 --input 中含有非空字符串字段 name', commandKey);
-    }
-    return input;
-}
+const PROJECT_LIST_DOMAINS_ALLOWED_OPTION_KEYS = new Set(['env', 'baseUrl', 'config', 'projectId', 'id']);
+const PROJECT_ADD_DOMAIN_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+    'subdomain',
+    'full-domain',
+    'use-full-domain',
+]);
+const PROJECT_REMOVE_DOMAIN_ALLOWED_OPTION_KEYS = new Set([
+    'env',
+    'baseUrl',
+    'config',
+    'projectId',
+    'id',
+    'domain-id',
+]);
 function buildUpdateProjectInput(options) {
     const commandKey = 'project update';
     for (const key of Object.keys(options)) {
@@ -652,7 +677,7 @@ async function handleAuthLogin(options, io) {
         message: cliOptions.environmentName
             ? `Open API CLI 已登录到环境 ${cliOptions.environmentName}，后续命令会自动复用本地保存的 key。`
             : 'Open API CLI 登录完成，后续命令会自动复用本地保存的 key。',
-        environment: cliOptions.environmentName,
+        environment: cliOptions.environmentName ?? null,
         baseUrl: cliOptions.baseUrl,
         currentEnvironment,
         configPath: resolveOpenApiCliConfigPath(cliOptions.configPath),
@@ -674,7 +699,7 @@ async function handleAuthLogout(options, io) {
         message: removed
             ? '本地保存的 Open API Key 已移除。'
             : '当前 baseUrl 没有本地保存的 Open API Key。',
-        environment: cliOptions.environmentName,
+        environment: cliOptions.environmentName ?? null,
         baseUrl: cliOptions.baseUrl,
         currentEnvironment,
         removed,
@@ -697,7 +722,7 @@ async function handleAuthStatus(options, io) {
             ? '当前 Open API CLI 已认证。'
             : '当前 Open API CLI 尚未认证，请先执行 auth login。',
         source: storedKey ? 'config' : 'none',
-        environment: cliOptions.environmentName,
+        environment: cliOptions.environmentName ?? null,
         baseUrl: cliOptions.baseUrl,
         currentEnvironment,
         configPath: resolveOpenApiCliConfigPath(cliOptions.configPath),
@@ -778,13 +803,6 @@ async function handleEnvironmentRemove(options, io) {
         configPath: resolveOpenApiCliConfigPath(configPath),
     }, io);
 }
-async function handleProjectCreate(options, io) {
-    const commandKey = 'project create';
-    const cliOptions = await resolveCliOptions(options, commandKey, io);
-    const client = createOpenApiCliClient(cliOptions);
-    const project = await client.createProject(buildCreateProjectInput(options));
-    printJson(project, io);
-}
 async function handleProjectList(options, io) {
     const commandKey = 'project list';
     for (const key of Object.keys(options)) {
@@ -808,15 +826,19 @@ function readProjectInitMode(options) {
     }
     throw createCliUsageError('project init 不再支持交互式向导，请传入 --mode create 或 --mode link', commandKey);
 }
-function buildProjectInitCreateInput(options) {
+function requireProjectInitCreateFlowOptions(options) {
     const commandKey = 'project init';
-    const raw = readStringOption(options, 'input');
-    if (!raw) {
+    const input = readStringOption(options, 'input');
+    if (!input) {
         throw createCliUsageError('project init --mode create 需要 --input <json>，内容为创建项目的请求体', commandKey);
     }
+    return { input };
+}
+function buildProjectInitCreateInput(options) {
+    const commandKey = 'project init';
     let parsed;
     try {
-        parsed = JSON.parse(raw);
+        parsed = JSON.parse(options.input);
     }
     catch {
         throw createCliUsageError('Invalid JSON value for --input', commandKey);
@@ -828,6 +850,9 @@ function buildProjectInitCreateInput(options) {
     if (typeof input.name !== 'string' || !input.name.trim()) {
         throw createCliUsageError('project init --mode create 需要 --input 中含有非空字符串字段 name', commandKey);
     }
+    if (!Object.prototype.hasOwnProperty.call(input, 'requireAuth')) {
+        input.requireAuth = false;
+    }
     return input;
 }
 async function runProjectInitCreateFlow(client, options) {
@@ -902,7 +927,7 @@ async function handleProjectInit(options, io) {
     const mode = readProjectInitMode(options);
     const client = createOpenApiCliClient(cliOptions);
     const project = mode === 'create'
-        ? await runProjectInitCreateFlow(client, options)
+        ? await runProjectInitCreateFlow(client, requireProjectInitCreateFlowOptions(options))
         : await runProjectInitLinkFlow(client, options);
     const binding = await writeOpenApiProjectLocalConfig({
         version: 1,
@@ -980,6 +1005,16 @@ async function handleProjectDeploy(options, 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
+            ? `部署成功。应用访问链接：${urls[0]}`
+            : `部署成功。应用访问链接：\n${urls.map((u) => `  • ${u}`).join('\n')}`);
+    }
 }
 async function handleProjectUploadSource(options, io) {
     const commandKey = 'project upload-source';
@@ -1077,11 +1112,68 @@ async function handleProjectUploadSource(options, io) {
         }
     }
 }
+async function handleProjectListDomains(options, io) {
+    const commandKey = 'project list-domains';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_LIST_DOMAINS_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project list-domains: --${key}`, commandKey);
+        }
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const list = await client.listProjectDomains(projectId);
+    printJson(list, io);
+}
+async function handleProjectAddDomain(options, io) {
+    const commandKey = 'project add-domain';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_ADD_DOMAIN_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project add-domain: --${key}`, commandKey);
+        }
+    }
+    const subdomain = readStringOption(options, 'subdomain');
+    const fullDomain = readStringOption(options, 'full-domain');
+    const useFullDomain = readBooleanOption(options, 'use-full-domain', commandKey) ?? false;
+    if (!subdomain && !fullDomain) {
+        throw createCliUsageError('project add-domain 需要 --subdomain <label>（绑定为平台 SERVICE_DOMAIN 下的二级域名）或 --full-domain <hostname>（仅密钥所属用户为超级管理员时可用）', commandKey);
+    }
+    if (subdomain && fullDomain) {
+        throw createCliUsageError('project add-domain 不能同时传入 --subdomain 与 --full-domain', commandKey);
+    }
+    const body = subdomain
+        ? { subdomain }
+        : useFullDomain
+            ? { fullDomain, useFullDomain: true }
+            : { fullDomain };
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const created = await client.addProjectDomain(projectId, body);
+    printJson(created, io);
+}
+async function handleProjectRemoveDomain(options, io) {
+    const commandKey = 'project remove-domain';
+    for (const key of Object.keys(options)) {
+        if (!PROJECT_REMOVE_DOMAIN_ALLOWED_OPTION_KEYS.has(key)) {
+            throw createCliUsageError(`Unknown option for project remove-domain: --${key}`, commandKey);
+        }
+    }
+    const domainId = readStringOption(options, 'domain-id');
+    if (!domainId) {
+        throw createCliUsageError('project remove-domain 需要 --domain-id <id>', commandKey);
+    }
+    const projectId = await resolveProjectIdForCommand(options, commandKey, io);
+    const cliOptions = await resolveCliOptions(options, commandKey, io);
+    const client = createOpenApiCliClient(cliOptions);
+    const removed = await client.removeProjectDomain(projectId, domainId);
+    printJson(removed, 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', commandKey);
+        throw createCliUsageError('deployment get requires --deploymentId or --id', commandKey);
     }
     const cliOptions = await resolveCliOptions(options, commandKey, io);
     const client = createOpenApiCliClient(cliOptions);
@@ -1134,7 +1226,6 @@ function commandDefinitions() {
             usage: ['tezign-ai-appstore auth status [--env test | --baseUrl https://platform.example.com]'],
             options: [...TARGET_CLI_OPTION_HELP],
             notes: [
-                '输出 JSON，包含 authenticated、environment、baseUrl、currentEnvironment、configPath 和 keyPrefix。',
                 '未传 --env / --baseUrl 时，按目标平台解析顺序检查当前可用环境。',
             ],
             examples: [
@@ -1154,7 +1245,7 @@ function commandDefinitions() {
                 ENV_NAME_CLI_OPTION_HELP,
                 {
                     flag: '--baseUrl <url>',
-                    description: '必填。平台地址，例如 https://ops.static.tezign.com；保存时会规范化并去掉末尾斜杠。',
+                    description: '必填。平台地址。保存时会规范化并去掉末尾斜杠。',
                 },
                 CONFIG_CLI_OPTION_HELP,
                 {
@@ -1179,10 +1270,6 @@ function commandDefinitions() {
             summary: '列出当前所有环境别名',
             usage: ['tezign-ai-appstore env list'],
             options: [CONFIG_CLI_OPTION_HELP],
-            notes: [
-                '输出 JSON，包含 environments、currentEnvironment 和 configPath。',
-                '每个环境会标记是否为当前环境，以及该环境是否已有本地 key。',
-            ],
             examples: ['tezign-ai-appstore env list'],
             handler: handleEnvironmentList,
         },
@@ -1207,14 +1294,14 @@ function commandDefinitions() {
             key: 'env remove',
             group: 'env',
             action: 'remove',
-            summary: '删除环境别名，不影响已保存的 key 记录',
+            summary: '删除本机该环境的整条配置（别名、baseUrl、本地保存的 Open API Key）',
             usage: ['tezign-ai-appstore env remove --env test'],
             options: [
                 ENV_NAME_CLI_OPTION_HELP,
                 CONFIG_CLI_OPTION_HELP,
             ],
             notes: [
-                '只删除环境别名 profile，不主动撤销平台 key。',
+                '会从 CLI 配置文件中移除该环境的 profile（含本地缓存的 key）；不会在平台上吊销或删除 Open API Key。',
                 '如果删除的是当前环境，后续命令需要重新 env use 或显式传 --env / --baseUrl。',
             ],
             examples: ['tezign-ai-appstore env remove --env test'],
@@ -1237,7 +1324,7 @@ function commandDefinitions() {
                 },
                 {
                     flag: '--input <json>',
-                    description: 'mode=create 时必填。创建项目请求体 JSON 对象，字段与 Open API 创建项目接口一致；至少包含非空 name。',
+                    description: 'mode=create 时必填。创建项目请求体 JSON；字段形状见下方「--input JSON（TypeScript 形状）」；至少包含非空 name。',
                 },
                 PROJECT_ID_CLI_OPTION_HELP,
                 {
@@ -1248,11 +1335,15 @@ function commandDefinitions() {
             notes: [
                 '在当前工作目录写入 .tezign/open-api-project.json，用于记录绑定的项目 ID、项目名和平台环境。',
                 '该命令不再进入交互式向导，所有初始化信息都必须通过参数传入。',
-                'mode=create 会调用创建项目接口；mode=link 会通过项目列表校验 --projectId 并绑定匹配项目。',
+                'mode=create 会调用创建项目接口；创建字段均放入 --input JSON，不再支持 --name、--appType 等拆散参数。',
+                'mode=create 时若 --input 未包含 requireAuth，CLI 会先写入 requireAuth: false 再请求接口（默认匿名访问）；需要登录校验时请显式传 requireAuth: true 并提供 tenantId。',
+                'mode=link 会通过项目列表校验 --projectId 并绑定匹配项目。',
+                'mode=create 时 --input 字段形状见前文「--input JSON（TypeScript 形状）」。',
+                'JSON 参数建议用单引号包裹，例如 --input \'{"name":"Demo"}\'；在 PowerShell 中也可用双引号并转义内部引号。',
                 '如果当前目录已有绑定，必须传入 --force 才会覆盖。',
             ],
             examples: [
-                `tezign-ai-appstore project init --env test --mode create --input '{"name":"Marketing Portal","appType":"STATIC_SITE","requireAuth":false}'`,
+                `tezign-ai-appstore project init --env test --mode create --input '{"name":"Marketing Portal","appType":"STATIC_SITE"}'`,
                 'tezign-ai-appstore project init --env test --mode link --projectId proj_123',
                 `tezign-ai-appstore project init --baseUrl https://platform.example.com --mode create --input '{"name":"Ops Console"}' --force`,
             ],
@@ -1268,7 +1359,6 @@ function commandDefinitions() {
             ],
             options: [...TARGET_CLI_OPTION_HELP],
             notes: [
-                '输出 JSON 项目数组，包含 id、name、appType、requireAuth 等字段。',
                 '绑定已有项目前，先执行 project list，把项目列表展示给用户选择，再用选中的 projectId 执行 project init --mode link。',
             ],
             examples: [
@@ -1291,7 +1381,6 @@ function commandDefinitions() {
             ],
             notes: [
                 '只读取当前目录项目绑定和全局 CLI 配置，不发起 Open API 请求。',
-                '输出 JSON，bound=false 表示当前目录还没有执行 project init。',
             ],
             examples: [
                 'tezign-ai-appstore project status',
@@ -1299,33 +1388,6 @@ function commandDefinitions() {
             ],
             handler: handleProjectStatus,
         },
-        {
-            key: 'project create',
-            group: 'project',
-            action: 'create',
-            summary: '创建一个新的 Open API 项目',
-            usage: [
-                'tezign-ai-appstore project create [--env test | --baseUrl https://platform.example.com] --input \'{"name":"Demo"}\'',
-            ],
-            options: [
-                ...TARGET_CLI_OPTION_HELP,
-                {
-                    flag: '--input <json>',
-                    description: '必填。创建项目请求体 JSON 对象，字段与 Open API 创建项目接口一致；至少包含非空 name。',
-                },
-            ],
-            notes: [
-                '不再支持 --name、--appType、--buildCommand 等拆散参数；所有创建字段都放入 --input JSON。',
-                '常用字段包括 name、appType、requireAuth、buildCommand、outputDir、tenantId；实际以 Open API 创建项目接口为准。',
-                '创建成功后只返回项目 JSON，不会自动写入当前目录绑定；如需绑定目录，使用 project init。',
-            ],
-            examples: [
-                `tezign-ai-appstore project create --env test --input '{"name":"Marketing Portal","requireAuth":false}'`,
-                `tezign-ai-appstore project create --input '{"name":"Ops Console","appType":"STATIC_SITE","requireAuth":false}'`,
-                `tezign-ai-appstore project create --input '{"name":"SaaS Portal","tenantId":"ten_1"}'`,
-            ],
-            handler: handleProjectCreate,
-        },
         {
             key: 'project update',
             group: 'project',
@@ -1339,12 +1401,13 @@ function commandDefinitions() {
                 PROJECT_ID_CLI_OPTION_HELP,
                 {
                     flag: '--input <json>',
-                    description: '必填。更新项目请求体 JSON 对象，字段与 Open API 更新项目接口一致；至少包含一个要更新的字段。',
+                    description: '必填。更新项目请求体 JSON；字段形状见下方「--input JSON（TypeScript 形状）」；至少包含一个要更新的字段。',
                 },
             ],
             notes: [
                 '未传 --projectId / --id 时，必须先在当前目录执行 project init 生成项目绑定。',
                 '不再支持 --name、--buildCommand、--outputDir 等拆散参数；所有更新字段都放入 --input JSON。',
+                '字段形状见前文「--input JSON（TypeScript 形状）」。',
             ],
             examples: [
                 `tezign-ai-appstore project update --env test --projectId proj_123 --input '{"buildCommand":"npm run build","outputDir":"dist"}'`,
@@ -1368,6 +1431,7 @@ function commandDefinitions() {
                 '未传 --projectId / --id 时，必须先在当前目录执行 project init 生成项目绑定。',
                 '部署是异步的；CLI 会通过返回的 webSocketUrl 自动追踪构建日志和最终状态。',
                 '如果最终状态为 FAILED，命令会以失败退出；可用 deployment get 查询部署详情。',
+                '成功时 stdout JSON 含 accessUrls（及 accessUrl 首项）；stderr 会列出全部访问链接。',
             ],
             examples: [
                 'tezign-ai-appstore project deploy --env test --projectId proj_123',
@@ -1410,6 +1474,80 @@ function commandDefinitions() {
             ],
             handler: handleProjectUploadSource,
         },
+        {
+            key: 'project list-domains',
+            group: 'project',
+            action: 'list-domains',
+            summary: '列出项目已绑定的自定义访问域名',
+            usage: [
+                'tezign-ai-appstore project list-domains [--env test | --baseUrl https://platform.example.com] [--projectId proj_123]',
+            ],
+            options: [...TARGET_CLI_OPTION_HELP, PROJECT_ID_CLI_OPTION_HELP],
+            notes: [
+                '需要 Open API scope `project:read`。',
+                '未传 --projectId / --id 时，读取当前目录 .tezign/open-api-project.json 绑定。',
+            ],
+            examples: [
+                'tezign-ai-appstore project list-domains',
+                'tezign-ai-appstore project list-domains --projectId proj_123',
+            ],
+            handler: handleProjectListDomains,
+        },
+        {
+            key: 'project add-domain',
+            group: 'project',
+            action: 'add-domain',
+            summary: '为项目绑定新的自定义域名（子域名或完整域名）',
+            usage: [
+                'tezign-ai-appstore project add-domain [--env test | --baseUrl ...] [--projectId proj_123] --subdomain my-app',
+                'tezign-ai-appstore project add-domain [--projectId proj_123] --full-domain app.example.com [--use-full-domain]',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                PROJECT_ID_CLI_OPTION_HELP,
+                {
+                    flag: '--subdomain <label>',
+                    description: '与 SERVICE_DOMAIN 拼接为完整域名（例如 my-app.example.com）；不能与 --full-domain 同时使用。',
+                },
+                {
+                    flag: '--full-domain <hostname>',
+                    description: '完整域名（需在白名单内）；通常仅超级管理员可用；不能与 --subdomain 同时使用。',
+                },
+                {
+                    flag: '--use-full-domain <bool>',
+                    description: '可选。与 --full-domain 联用时显式声明完整域名模式；也可仅写 --use-full-domain 等价 true。',
+                },
+            ],
+            notes: [
+                '需要 Open API scope `project:update`。',
+                '校验规则与控制台「绑定域名」一致（保留字、白名单、管理前缀冲突等）。',
+            ],
+            examples: [
+                'tezign-ai-appstore project add-domain --subdomain my-demo-app',
+                'tezign-ai-appstore project add-domain --projectId proj_123 --full-domain portal.internal.example --use-full-domain',
+            ],
+            handler: handleProjectAddDomain,
+        },
+        {
+            key: 'project remove-domain',
+            group: 'project',
+            action: 'remove-domain',
+            summary: '移除项目下的一条域名绑定',
+            usage: [
+                'tezign-ai-appstore project remove-domain [--env test | --baseUrl ...] [--projectId proj_123] --domain-id dom_uuid',
+            ],
+            options: [
+                ...TARGET_CLI_OPTION_HELP,
+                PROJECT_ID_CLI_OPTION_HELP,
+                {
+                    flag: '--domain-id <id>',
+                    description: '必填。域名记录 ID（来自 project list-domains 的 JSON）。',
+                },
+            ],
+            notes: ['需要 Open API scope `project:update`。'],
+            examples: ['tezign-ai-appstore project remove-domain --domain-id abc-def-123'],
+            handler: handleProjectRemoveDomain,
+        },
         {
             key: 'deployment get',
             group: 'deployment',