@demogo-cn/cli 0.4.0 → 0.5.0

package/README.md

@@ -1,82 +1,99 @@
-# DemoGo CLI
-
-DemoGo CLI lets AI coding tools publish a local project to DemoGo and return a shareable trial link.
-
-## Local Install
-
-Current MVP delivery uses a local install package.
-
-1. Unzip `demogo-cli-v0.4.0.zip`.
-2. Open a terminal in the extracted folder.
-3. Run:
-
-```bash
-npm install -g .
-```
-
-4. Verify:
-
-```bash
-demogo --version
-```
-
-## Configure
-
-```bash
-demogo config set --api https://demogo.cn --token <DemoGo AI publish token>
-demogo doctor
-```
-
-The token is reusable. Do not reset it for every deployment.
-Reset it only when it is lost, invalid, or exposed in chat/logs.
-
-## Deploy
-
-Run the command from a clean project folder. Do not run it directly from Desktop, Downloads, Documents, or the user home folder.
-
-Use without installing:
-
-```bash
-npx --yes @demogo-cn/cli deploy --api https://demogo.cn --token <DemoGo AI publish token>
-```
-
-Or use the installed command:
-
-```bash
-demogo deploy
-```
-
-For a specific folder or project name:
-
-```bash
-demogo deploy --dir <project-folder> --name <project-name>
-```
-
-If you only have one HTML file, put that file in a clean folder and publish that folder. You do not need to rename the file to `index.html`.
-
-Project names are used for display in the DemoGo workbench. Every first publish receives an automatically assigned trial link path. Lite and Pro users can later customize the `/d/...` path in the workbench. Pro users can apply for a `xxx.demogo.cn` subdomain.
-
-## Current Boundary
-
+# DemoGo CLI
+
+DemoGo CLI lets AI coding tools publish a local project to DemoGo and return a shareable trial link.
+
+## Local Install
+
+Current MVP delivery uses a local install package.
+
+1. Unzip `demogo-cli-v0.5.0.zip`.
+2. Open a terminal in the extracted folder.
+3. Run:
+
+```bash
+npm install -g .
+```
+
+4. Verify:
+
+```bash
+demogo --version
+```
+
+## Configure
+
+```bash
+demogo config set --api https://demogo.cn --token <DemoGo AI publish token>
+demogo doctor
+```
+
+The token is reusable. Do not reset it for every deployment.
+Reset it only when it is lost, invalid, or exposed in chat/logs.
+
+## Deploy
+
+Run the command from a clean project folder. Do not run it directly from Desktop, Downloads, Documents, or the user home folder.
+
+Use without installing:
+
+```bash
+npx --yes @demogo-cn/cli deploy --api https://demogo.cn --token <DemoGo AI publish token>
+```
+
+Or use the installed command:
+
+```bash
+demogo deploy
+```
+
+For a specific folder or project name:
+
+```bash
+demogo deploy --dir <project-folder> --name <project-name>
+```
+
+After a successful first publish, the CLI stores a small local record in `.demogo/project.json`. If the same project folder is published again with `demogo deploy`, DemoGo updates the original trial link by default. This does not consume a new Demo slot, but it does consume one publish/update count.
+
+To force a brand-new trial link from the same folder:
+
+```bash
+demogo deploy --new
+```
+
+To update an existing link from another folder or another machine:
+
+```bash
+demogo update --id https://demogo.cn/d/try-xxxxxx/
+```
+
+If you only have one HTML file, put that file in a clean folder and publish that folder. You do not need to rename the file to `index.html`.
+
+Project names are used for display in the DemoGo workbench. Every first publish receives an automatically assigned trial link path. Lite and Pro users can later customize the `/d/...` path in the workbench. Pro users can apply for a `xxx.demogo.cn` subdomain.
+
+## Current Boundary
+
 DemoGo supports static pages, single HTML pages, built frontend output, frontend source projects that can build static output, and Node.js single-service trial projects when the platform reports that the Node runtime is available. Node.js projects must provide a start command and listen on `process.env.PORT`.
 
-DemoGo can allocate an empty MySQL trial database for supported Node.js single-service projects. It does not currently run Redis, MongoDB, PostgreSQL, multi-service apps, WebSocket, or SSR runtimes such as Next/Nuxt/Remix server mode.
-
-## npm / npx Status
-
-AI coding tools can run:
-
-```bash
-npx --yes @demogo-cn/cli deploy --api https://demogo.cn --token <DemoGo AI publish token>
-```
-
-Or install it globally:
-
-```bash
-npm install -g @demogo-cn/cli
-demogo deploy
-```
+DemoGo can classify common frontend, backend, database, and environment-variable signals, including Next.js, TanStack Start, Nuxt, SvelteKit, Astro, Express, Fastify, Hono, Supabase, Postgres, MySQL, Prisma, and Drizzle.
 
-The package name is `@demogo-cn/cli`; the installed command remains `demogo`.
-If an AI coding tool cannot run `demogo` or `npx @demogo-cn/cli`, it should explain why and then use DemoGo MCP or the Agent API fallback.
+DemoGo can allocate an empty MySQL trial database for supported Node.js single-service projects. It does not currently run Redis, MongoDB, PostgreSQL, multi-service apps, WebSocket, or SSR runtimes such as Next/Nuxt/Remix/TanStack Start/SvelteKit/Astro server mode.
+
+## npm / npx Status
+
+AI coding tools can run:
+
+```bash
+npx --yes @demogo-cn/cli deploy --api https://demogo.cn --token <DemoGo AI publish token>
+```
+
+Or install it globally:
+
+```bash
+npm install -g @demogo-cn/cli
+demogo deploy
+```
+
+The package name is `@demogo-cn/cli`; the installed command remains `demogo`.
+If an AI coding tool cannot run `demogo` or `npx @demogo-cn/cli`, it should explain why and then use DemoGo MCP or the Agent API fallback.
+
 

package/bin/demogo.js

@@ -16,7 +16,8 @@ import {
   checkApiHealth,
   normalizeApiBase,
   safeArchiveName,
-  summarizeProject
+  summarizeProject,
+  updateArchive
 } from "../lib/core.js";
 
 const CONFIG_DIR = path.join(os.homedir(), ".demogo");
@@ -51,6 +52,11 @@ async function main() {
     return;
   }
 
+  if (command === "update") {
+    await handleUpdate(rest);
+    return;
+  }
+
   if (command === "doctor") {
     await handleDoctor(rest);
     return;
@@ -100,6 +106,62 @@ async function handleConfig(args) {
 
 async function handleDeploy(args) {
   const options = parseOptions(args);
+  const { apiBase, token, projectDir, projectName } = await resolvePublishContext(options, "deploy");
+  const existingProject = await readProjectRecord(projectDir);
+  if (existingProject?.demoRef && !options.new) {
+    console.log("DemoGo 发现当前项目目录已有发布记录，本次将更新原试用链接。");
+    console.log(`原访问链接：${existingProject.publicUrl || existingProject.demoRef}`);
+    await publishUpdate({
+      apiBase,
+      token,
+      projectDir,
+      projectName,
+      demoRef: existingProject.demoRef,
+      source: "cli"
+    });
+    return;
+  }
+
+  const archivePath = path.join(await mkdtemp(path.join(os.tmpdir(), "demogo-cli-")), `${safeArchiveName(projectName)}.tar.gz`);
+  try {
+    const archiveStats = await packProject(projectDir, archivePath);
+    console.log(`项目包已生成：${formatBytes(archiveStats.size)}`);
+    console.log("DemoGo 正在生成试用链接...");
+    const result = await deployArchive({ apiBase, token, archivePath, projectName, source: "cli" });
+    printDeployResult(result);
+    await writeProjectRecord(projectDir, result);
+  } finally {
+    await rm(path.dirname(archivePath), { recursive: true, force: true });
+  }
+}
+
+async function handleUpdate(args) {
+  const options = parseOptions(args);
+  const demoRef = String(options.id || options.demo || options.slug || options.url || "").trim();
+  if (!demoRef) {
+    fail("缺少要更新的项目。请使用：demogo update --id <Demo ID 或原试用链接>");
+  }
+
+  const { apiBase, token, projectDir, projectName } = await resolvePublishContext(options, "update");
+  await publishUpdate({ apiBase, token, projectDir, projectName, demoRef, source: "cli" });
+}
+
+async function publishUpdate({ apiBase, token, projectDir, projectName, demoRef, source }) {
+  const archivePath = path.join(await mkdtemp(path.join(os.tmpdir(), "demogo-cli-")), `${safeArchiveName(projectName || demoRef)}.tar.gz`);
+  try {
+    console.log("DemoGo 正在准备更新已有试用链接...");
+    const archiveStats = await packProject(projectDir, archivePath);
+    console.log(`项目包已生成：${formatBytes(archiveStats.size)}`);
+    console.log("DemoGo 正在更新试用项目，原链接会保持不变...");
+    const result = await updateArchive({ apiBase, token, archivePath, demoRef, source });
+    printDeployResult(result, { action: "update" });
+    await writeProjectRecord(projectDir, result);
+  } finally {
+    await rm(path.dirname(archivePath), { recursive: true, force: true });
+  }
+}
+
+async function resolvePublishContext(options, action = "deploy") {
   const config = await readConfig();
   const apiBase = normalizeApiBase(options.api || config.apiBase || process.env.DEMOGO_API_BASE);
   const token = String(options.token || config.token || process.env.DEMOGO_AGENT_TOKEN || "").trim();
@@ -110,7 +172,7 @@ async function handleDeploy(args) {
     fail([
       "缺少 DemoGo 平台地址。",
       "可以直接运行：",
-      "demogo deploy --api <DemoGo平台地址> --token <你的AI发布口令>"
+      `demogo ${action} --api <DemoGo平台地址> --token <你的AI发布口令>`
     ].join("\n"));
   }
 
@@ -118,35 +180,31 @@ async function handleDeploy(args) {
     fail([
       "缺少 DemoGo AI 发布口令。",
       "可以直接运行：",
-      `demogo deploy --api ${apiBase || "<DemoGo平台地址>"} --token <你的AI发布口令>`
+      `demogo ${action} --api ${apiBase || "<DemoGo平台地址>"} --token <你的AI发布口令>`
     ].join("\n"));
   }
 
   await assertDirectory(projectDir);
   assertSafeProjectDirectory(projectDir);
+  return { apiBase, token, projectDir, projectName };
+}
+
+async function packProject(projectDir, archivePath) {
   const fileList = await collectFiles(projectDir);
   if (!fileList.length) fail("当前目录没有可发布文件。");
 
-  const archivePath = path.join(await mkdtemp(path.join(os.tmpdir(), "demogo-cli-")), `${safeArchiveName(projectName)}.tar.gz`);
-  try {
-    console.log("DemoGo 正在准备当前项目...");
-    printProjectSummary(summarizeProject(projectDir, fileList));
-    console.log("DemoGo 正在打包项目...");
-    await createProjectArchive(projectDir, fileList, archivePath);
-    const archiveStats = await stat(archivePath);
-    if (archiveStats.size > MAX_BYTES) {
-      fail([
-        `打包后文件超过 50MB，当前约 ${formatBytes(archiveStats.size)}。`,
-        "你可能在错误目录执行了发布。请切换到真正的项目目录，或使用 --dir 指定干净项目文件夹。"
-      ].join("\n"));
-    }
-    console.log(`项目包已生成：${formatBytes(archiveStats.size)}`);
-    console.log("DemoGo 正在生成试用链接...");
-    const result = await deployArchive({ apiBase, token, archivePath, projectName, source: "cli" });
-    printDeployResult(result);
-  } finally {
-    await rm(path.dirname(archivePath), { recursive: true, force: true });
+  console.log("DemoGo 正在准备当前项目...");
+  printProjectSummary(summarizeProject(projectDir, fileList));
+  console.log("DemoGo 正在打包项目...");
+  await createProjectArchive(projectDir, fileList, archivePath);
+  const archiveStats = await stat(archivePath);
+  if (archiveStats.size > MAX_BYTES) {
+    fail([
+      `打包后文件超过 50MB，当前约 ${formatBytes(archiveStats.size)}。`,
+      "你可能在错误目录执行了发布。请切换到真正的项目目录，或使用 --dir 指定干净项目文件夹。"
+    ].join("\n"));
   }
+  return archiveStats;
 }
 
 async function handleDoctor(args) {
@@ -213,11 +271,41 @@ async function clearConfig() {
   });
 }
 
-function printDeployResult(result) {
+async function readProjectRecord(projectDir) {
+  try {
+    const record = JSON.parse(await readFile(projectRecordPath(projectDir), "utf8"));
+    const demoRef = String(record.demoId || record.id || record.publicUrl || record.slug || "").trim();
+    return demoRef ? { ...record, demoRef } : null;
+  } catch {
+    return null;
+  }
+}
+
+async function writeProjectRecord(projectDir, result) {
+  if (!result?.id && !result?.publicUrl) return;
+  const record = {
+    demoId: result.id || "",
+    slug: result.slug || "",
+    publicUrl: result.publicUrl || "",
+    projectName: result.projectName || result.name || "",
+    version: result.version || null,
+    updatedAt: new Date().toISOString()
+  };
+  const recordPath = projectRecordPath(projectDir);
+  await mkdir(path.dirname(recordPath), { recursive: true });
+  await writeFile(recordPath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+}
+
+function projectRecordPath(projectDir) {
+  return path.join(projectDir, ".demogo", "project.json");
+}
+
+function printDeployResult(result, options = {}) {
   console.log("");
-  console.log("DemoGo 试用链接已生成。");
+  console.log(options.action === "update" ? "DemoGo 试用项目已更新，原链接保持不变。" : "DemoGo 试用链接已生成。");
   console.log(`项目名称：${result.projectName || result.name || result.slug || "-"}`);
   console.log(`访问链接：${result.publicUrl || "-"}`);
+  if (result.version) console.log(`当前版本：v${result.version}`);
   console.log(`发布方式：${result.deploySourceLabel || "DemoGo CLI"}`);
   console.log(`页面类型：${result.detectedType || "-"}`);
   console.log(`内容检查：${result.contentReview?.statusLabel || result.contentReviewStatus || "已通过"}`);
@@ -247,8 +335,11 @@ DemoGo CLI ${VERSION}
   demogo config clear
   demogo doctor
   demogo deploy
+  demogo deploy --new
+  demogo update --id <Demo ID 或原试用链接>
   demogo deploy --api <DemoGo地址> --token <AI发布口令>
   demogo deploy --name <项目名称> --dir <项目目录>
+  demogo update --id <Demo ID 或原试用链接> --dir <项目目录>
 
 本地安装：
   解压 dist/demogo-cli-v${VERSION}.zip 后，在解压目录执行 npm install -g .
@@ -261,6 +352,8 @@ DemoGo CLI ${VERSION}
 示例：
   demogo config set --api https://your-demogo.example.com --token dmg_xxx_xxx
   demogo deploy --api https://your-demogo.example.com --token dmg_xxx_xxx
+  demogo deploy --new
+  demogo update --id https://your-demogo.example.com/d/try-xxxxxx/ --dir ./my-project
   demogo deploy --name 我的报名页
 `.trim());
 }

package/lib/core.js

@@ -1,22 +1,24 @@
 import { gzipSync } from "node:zlib";
 import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { readFileSync } from "node:fs";
 import path from "node:path";
 
-export const VERSION = "0.4.0";
-export const MAX_FILES = 800;
-export const MAX_BYTES = 50 * 1024 * 1024;
-
-export const unsafeProjectDirectoryNames = new Set([
-  "desktop",
-  "downloads",
-  "documents",
-  "onedrive",
-  "桌面",
-  "下载",
-  "文档"
-]);
+export const VERSION = readVersion();
+export const MAX_FILES = 800;
+export const MAX_BYTES = 50 * 1024 * 1024;
+
+export const unsafeProjectDirectoryNames = new Set([
+  "desktop",
+  "downloads",
+  "documents",
+  "onedrive",
+  "桌面",
+  "下载",
+  "文档"
+]);
 
 const EXCLUDED_DIRS = new Set([
+  ".demogo",
   ".git",
   ".hg",
   ".svn",
@@ -52,36 +54,53 @@ const SENSITIVE_EXTENSIONS = [
   ".cer"
 ];
 
-export async function assertDirectory(dir) {
-  try {
-    const stats = await stat(dir);
-    if (!stats.isDirectory()) throw new Error(`不是项目目录：${dir}`);
-  } catch {
-    throw new Error(`找不到项目目录：${dir}`);
-  }
-}
-
-export function assertSafeProjectDirectory(dir) {
-  const resolved = path.resolve(dir);
-  const home = path.resolve(process.env.USERPROFILE || process.env.HOME || "");
-  const baseName = path.basename(resolved).toLowerCase();
-
-  if (home && resolved === home) {
-    throw new Error([
-      "当前目录像是用户主目录，不适合直接发布。",
-      "请新建一个干净文件夹，只放要发布的项目文件，然后在该文件夹里运行发布命令。",
-      "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
-    ].join("\n"));
-  }
-
-  if (unsafeProjectDirectoryNames.has(baseName)) {
-    throw new Error([
-      `当前目录是 ${path.basename(resolved)}，通常会包含很多无关文件，不适合直接发布。`,
-      "请新建一个干净文件夹，只放要发布的项目文件；如果只有一个 HTML 文件，也可以让 AI 先创建临时目录再发布。",
-      "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
-    ].join("\n"));
-  }
-}
+function readVersion() {
+  const candidates = [
+    path.resolve(process.cwd(), "VERSION"),
+    path.resolve(process.cwd(), "..", "VERSION"),
+    path.resolve(process.cwd(), "..", "..", "VERSION"),
+    path.resolve(path.dirname(new URL(import.meta.url).pathname), "..", "VERSION")
+  ];
+  for (const filePath of candidates) {
+    try {
+      return readFileSync(filePath, "utf8").trim();
+    } catch {
+      // Try the next packaged or repository-level VERSION file.
+    }
+  }
+  return "0.5.0";
+}
+
+export async function assertDirectory(dir) {
+  try {
+    const stats = await stat(dir);
+    if (!stats.isDirectory()) throw new Error(`不是项目目录：${dir}`);
+  } catch {
+    throw new Error(`找不到项目目录：${dir}`);
+  }
+}
+
+export function assertSafeProjectDirectory(dir) {
+  const resolved = path.resolve(dir);
+  const home = path.resolve(process.env.USERPROFILE || process.env.HOME || "");
+  const baseName = path.basename(resolved).toLowerCase();
+
+  if (home && resolved === home) {
+    throw new Error([
+      "当前目录像是用户主目录，不适合直接发布。",
+      "请新建一个干净文件夹，只放要发布的项目文件，然后在该文件夹里运行发布命令。",
+      "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
+    ].join("\n"));
+  }
+
+  if (unsafeProjectDirectoryNames.has(baseName)) {
+    throw new Error([
+      `当前目录是 ${path.basename(resolved)}，通常会包含很多无关文件，不适合直接发布。`,
+      "请新建一个干净文件夹，只放要发布的项目文件；如果只有一个 HTML 文件，也可以让 AI 先创建临时目录再发布。",
+      "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
+    ].join("\n"));
+  }
+}
 
 export async function collectFiles(rootDir) {
   const files = [];
@@ -101,24 +120,24 @@ export async function collectFiles(rootDir) {
       if (!entry.isFile()) continue;
       const stats = await stat(fullPath);
       totalBytes += stats.size;
-      if (files.length >= MAX_FILES) throw new Error(projectTooLargeMessage(`项目文件超过 ${MAX_FILES} 个。`));
-      if (totalBytes > MAX_BYTES) throw new Error(projectTooLargeMessage("项目文件超过 50MB。"));
+      if (files.length >= MAX_FILES) throw new Error(projectTooLargeMessage(`项目文件超过 ${MAX_FILES} 个。`));
+      if (totalBytes > MAX_BYTES) throw new Error(projectTooLargeMessage("项目文件超过 50MB。"));
       files.push({ fullPath, relativePath, size: stats.size });
     }
   }
 
-  await walk(rootDir);
-  return files;
-}
-
-export function projectTooLargeMessage(reason) {
-  return [
-    `${reason}你可能在桌面、下载、文档或用户根目录执行了发布。`,
-    "请切换到真正的项目目录，或新建一个干净文件夹，只放要发布的项目文件。",
-    "如果只有一个 HTML 文件，不需要改名为 index.html，可以把它单独放进干净目录后发布。",
-    "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
-  ].join("\n");
-}
+  await walk(rootDir);
+  return files;
+}
+
+export function projectTooLargeMessage(reason) {
+  return [
+    `${reason}你可能在桌面、下载、文档或用户根目录执行了发布。`,
+    "请切换到真正的项目目录，或新建一个干净文件夹，只放要发布的项目文件。",
+    "如果只有一个 HTML 文件，不需要改名为 index.html，可以把它单独放进干净目录后发布。",
+    "也可以使用：npx --yes @demogo-cn/cli deploy --dir <项目目录>"
+  ].join("\n");
+}
 
 export function summarizeProject(projectDir, files) {
   const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
@@ -206,7 +225,7 @@ export async function deployArchive({ apiBase, token, archivePath, projectName,
   return payload;
 }
 
-export async function checkApiHealth(apiBase) {
+export async function checkApiHealth(apiBase) {
   let response;
   try {
     response = await fetch(`${normalizeApiBase(apiBase)}/api/health`, {
@@ -221,31 +240,74 @@ export async function checkApiHealth(apiBase) {
   if (!response.ok || !payload?.ok) {
     throw new Error(`DemoGo 平台地址不可用：HTTP ${response.status}`);
   }
-  return payload;
-}
-
-export async function checkAgentToken(apiBase, token, userAgent = `demogo-cli/${VERSION}`) {
-  let response;
-  try {
-    response = await fetch(`${normalizeApiBase(apiBase)}/api/agent/token-check`, {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${token}`,
-        "User-Agent": userAgent
-      }
-    });
-  } catch {
-    throw new Error(`无法连接 DemoGo：${normalizeApiBase(apiBase)}。请检查平台地址。`);
-  }
-  const text = await response.text();
-  const payload = parseJson(text);
-  if (!response.ok || !payload?.ok) {
-    throw new Error(payload?.error || readableHttpError(response.status, text));
-  }
-  return payload;
-}
-
-export function normalizeApiBase(value) {
+  return payload;
+}
+
+export async function updateArchive({ apiBase, token, archivePath, demoRef, source = "cli", userAgent = `demogo-cli/${VERSION}` }) {
+  const formData = new FormData();
+  formData.set("source", source);
+  formData.set("demoId", demoRef);
+  formData.set(
+    "project",
+    new Blob([await readFile(archivePath)], { type: "application/gzip" }),
+    path.basename(archivePath)
+  );
+
+  let response;
+  try {
+    response = await fetch(`${normalizeApiBase(apiBase)}/api/agent/update`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "User-Agent": userAgent,
+        "X-DemoGo-Deploy-Source": source
+      },
+      body: formData
+    });
+  } catch {
+    throw new Error(`无法连接 DemoGo：${normalizeApiBase(apiBase)}。请检查 API 地址是否正确，或稍后再试。`);
+  }
+
+  return parseDeploymentResponse(response);
+}
+
+async function parseDeploymentResponse(response) {
+  const text = await response.text();
+  const payload = parseJson(text);
+  if (!response.ok) {
+    const message = payload?.error || readableHttpError(response.status, text);
+    const shouldShowFixPrompt = response.status === 400 || payload?.inspection?.canPublish === false;
+    const fixPrompt = shouldShowFixPrompt
+      ? payload?.inspection?.fixPrompt || payload?.inspection?.ruleReport?.fixPrompt || ""
+      : "";
+    const details = fixPrompt ? `\n\n给 AI 工具的修改建议：\n${fixPrompt}` : "";
+    throw new Error(`${message}${details}`);
+  }
+  return payload;
+}
+
+export async function checkAgentToken(apiBase, token, userAgent = `demogo-cli/${VERSION}`) {
+  let response;
+  try {
+    response = await fetch(`${normalizeApiBase(apiBase)}/api/agent/token-check`, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "User-Agent": userAgent
+      }
+    });
+  } catch {
+    throw new Error(`无法连接 DemoGo：${normalizeApiBase(apiBase)}。请检查平台地址。`);
+  }
+  const text = await response.text();
+  const payload = parseJson(text);
+  if (!response.ok || !payload?.ok) {
+    throw new Error(payload?.error || readableHttpError(response.status, text));
+  }
+  return payload;
+}
+
+export function normalizeApiBase(value) {
   return String(value || "").trim().replace(/\/+$/, "");
 }
 
@@ -373,5 +435,6 @@ function readableHttpError(status, text) {
   if (status === 400) return "项目暂时不能发布，请根据 DemoGo 返回的提示修改后再试。";
   if (text?.trim().startsWith("<")) return "服务器返回了异常页面，本次发布没有完成。";
   return `DemoGo 发布失败：HTTP ${status}`;
-}
+}
+
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demogo-cn/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "DemoGo CLI for generating shareable trial links from AI-built pages.",
   "type": "module",
   "bin": {
@@ -14,4 +14,5 @@
     "node": ">=18.0.0"
   },
   "license": "UNLICENSED"
-}
+}
+