@demogo-cn/cli 0.2.5

package/README.md

@@ -0,0 +1,67 @@
+# 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.2.5.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
+
+```bash
+demogo deploy
+```
+
+For a specific folder or project name:
+
+```bash
+demogo deploy --dir <project-folder> --name <project-name>
+```
+
+## Current Boundary
+
+DemoGo supports static pages, single HTML pages, built frontend output, and frontend source projects that can build static output. It does not host long-running backend services, databases, payment systems, login systems, WebSocket services, or SSR runtimes.
+
+## npm / npx Status
+
+After npm publication, AI coding tools can run:
+
+```bash
+npx @demogo-cn/cli deploy
+```
+
+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

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+import { mkdir, mkdtemp, readFile, rm, unlink, writeFile, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import {
+  MAX_BYTES,
+  VERSION,
+  assertDirectory,
+  collectFiles,
+  createProjectArchive,
+  deployArchive,
+  formatBytes,
+  checkApiHealth,
+  normalizeApiBase,
+  safeArchiveName,
+  summarizeProject
+} from "../lib/core.js";
+
+const CONFIG_DIR = path.join(os.homedir(), ".demogo");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+
+main().catch((error) => {
+  fail(error instanceof Error ? error.message : "DemoGo CLI 执行失败。");
+});
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const rest = args.slice(1);
+
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+
+  if (command === "version" || command === "--version" || command === "-v") {
+    console.log(VERSION);
+    return;
+  }
+
+  if (command === "config") {
+    await handleConfig(rest);
+    return;
+  }
+
+  if (command === "deploy") {
+    await handleDeploy(rest);
+    return;
+  }
+
+  if (command === "doctor") {
+    await handleDoctor(rest);
+    return;
+  }
+
+  fail(`未知命令：${command}\n运行 demogo help 查看可用命令。`);
+}
+
+async function handleConfig(args) {
+  const subcommand = args[0];
+  if (subcommand === "set") {
+    const options = parseOptions(args.slice(1));
+    const current = await readConfig();
+    const next = {
+      ...current,
+      ...(options.api ? { apiBase: normalizeApiBase(options.api) } : {}),
+      ...(options.token ? { token: String(options.token).trim() } : {})
+    };
+    await writeConfig(next);
+    console.log("DemoGo CLI 配置已保存。");
+    console.log(`API 地址：${next.apiBase || "未配置"}`);
+    console.log(`AI 发布口令：${next.token ? maskToken(next.token) : "未配置"}`);
+    return;
+  }
+
+  if (subcommand === "show") {
+    const config = await readConfig();
+    const token = config.token || process.env.DEMOGO_AGENT_TOKEN || "";
+    console.log(`API 地址：${config.apiBase || process.env.DEMOGO_API_BASE || "未配置"}`);
+    console.log(`AI 发布口令：${token ? maskToken(token) : "未配置"}`);
+    return;
+  }
+
+  if (subcommand === "clear") {
+    await clearConfig();
+    console.log("DemoGo CLI 本机配置已清除。");
+    return;
+  }
+
+  if (subcommand === "test") {
+    await handleDoctor(args.slice(1));
+    return;
+  }
+
+  fail("用法：demogo config set --api <地址> --token <AI发布口令>、demogo config show、demogo config clear，或 demogo doctor");
+}
+
+async function handleDeploy(args) {
+  const options = parseOptions(args);
+  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();
+  const projectDir = path.resolve(String(options.dir || "."));
+  const projectName = String(options.name || path.basename(projectDir)).trim();
+
+  if (!apiBase) {
+    fail([
+      "缺少 DemoGo 平台地址。",
+      "请先在 DemoGo 工作台复制平台地址，然后运行：",
+      "demogo config set --api <DemoGo平台地址> --token <你的AI发布口令>"
+    ].join("\n"));
+  }
+
+  if (!token) {
+    fail([
+      "缺少 DemoGo AI 发布口令。",
+      "请先在 DemoGo 工作台生成口令，然后运行：",
+      `demogo config set --api ${apiBase || "<DemoGo平台地址>"} --token <你的AI发布口令>`
+    ].join("\n"));
+  }
+
+  await assertDirectory(projectDir);
+  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)}。`);
+    }
+    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 });
+  }
+}
+
+async function handleDoctor(args) {
+  const options = parseOptions(args);
+  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();
+
+  if (!apiBase) {
+    fail("缺少 DemoGo 平台地址。请先运行 demogo config set --api <DemoGo地址> --token <AI发布口令>。");
+  }
+
+  console.log("DemoGo 正在检查平台地址...");
+  const health = await checkApiHealth(apiBase);
+  console.log(`平台连接正常：${health.service || "demogo-server"} ${health.version || ""}`.trim());
+  console.log(`AI 发布口令：${token ? "已配置" : "未配置"}`);
+  if (!token) {
+    console.log("提示：没有 AI 发布口令时只能检查平台地址，不能直接发布项目。");
+  }
+}
+
+function parseOptions(args) {
+  const options = {};
+  for (let index = 0; index < args.length; index += 1) {
+    const item = args[index];
+    if (!item.startsWith("--")) continue;
+    const key = item.slice(2);
+    const next = args[index + 1];
+    if (!next || next.startsWith("--")) {
+      options[key] = true;
+      continue;
+    }
+    options[key] = next;
+    index += 1;
+  }
+  return options;
+}
+
+async function readConfig() {
+  try {
+    return JSON.parse(await readFile(CONFIG_FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+async function writeConfig(value) {
+  await mkdir(CONFIG_DIR, { recursive: true });
+  await writeFile(CONFIG_FILE, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+async function clearConfig() {
+  await unlink(CONFIG_FILE).catch((error) => {
+    if (error?.code !== "ENOENT") throw error;
+  });
+}
+
+function printDeployResult(result) {
+  console.log("");
+  console.log("DemoGo 试用链接已生成。");
+  console.log(`项目名称：${result.projectName || result.name || result.slug || "-"}`);
+  console.log(`访问链接：${result.publicUrl || "-"}`);
+  console.log(`发布方式：${result.deploySourceLabel || "DemoGo CLI"}`);
+  console.log(`页面类型：${result.detectedType || "-"}`);
+  console.log(`内容检查：${result.contentReview?.statusLabel || result.contentReviewStatus || "已通过"}`);
+  console.log(`报名/留言收集：${result.autoFormEnabled || result.inspection?.autoFormEnabled ? "已自动开启" : "未自动开启"}`);
+  if (result.nextStep) console.log(`下一步：${result.nextStep}`);
+}
+
+function printProjectSummary(summary) {
+  console.log(`项目目录：${summary.projectDir}`);
+  console.log(`准备上传：${summary.fileCount} 个文件，约 ${formatBytes(summary.totalBytes)}`);
+  console.log(`页面入口：${summary.hasReadyPage ? "已发现" : (summary.singleHtmlEntry ? `已发现单页 ${summary.singleHtmlEntry}` : "未直接发现，DemoGo 会继续检测")}`);
+  if (summary.hasPackageJson) console.log("源码项目：已发现 package.json");
+}
+
+function maskToken(token) {
+  const value = String(token || "");
+  if (value.length <= 14) return "已配置";
+  return `${value.slice(0, 10)}...${value.slice(-4)}`;
+}
+
+function printHelp() {
+  console.log(`
+DemoGo CLI ${VERSION}
+
+常用命令：
+  demogo config set --api <DemoGo地址> --token <AI发布口令>
+  demogo config show
+  demogo config clear
+  demogo doctor
+  demogo deploy
+  demogo deploy --name <项目名称> --dir <项目目录>
+
+本地安装：
+  解压 dist/demogo-cli-v${VERSION}.zip 后，在解压目录执行 npm install -g .
+  安装完成后运行 demogo --version 验证。
+
+环境变量：
+  DEMOGO_API_BASE       DemoGo API 地址
+  DEMOGO_AGENT_TOKEN    DemoGo AI 发布口令
+
+示例：
+  demogo config set --api https://your-demogo.example.com --token dmg_xxx_xxx
+  demogo deploy --name 我的报名页
+`.trim());
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}

package/lib/core.js

@@ -0,0 +1,315 @@
+import { gzipSync } from "node:zlib";
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+export const VERSION = "0.2.5";
+export const MAX_FILES = 800;
+export const MAX_BYTES = 50 * 1024 * 1024;
+
+const EXCLUDED_DIRS = new Set([
+  ".git",
+  ".hg",
+  ".svn",
+  ".next",
+  ".nuxt",
+  ".output",
+  ".cache",
+  ".turbo",
+  ".vite",
+  "node_modules",
+  "coverage",
+  "tmp",
+  "temp"
+]);
+
+const EXCLUDED_FILES = new Set([
+  ".env",
+  ".env.local",
+  ".env.development",
+  ".env.production",
+  ".npmrc",
+  ".yarnrc",
+  ".DS_Store",
+  "Thumbs.db"
+]);
+
+const SENSITIVE_EXTENSIONS = [
+  ".pem",
+  ".key",
+  ".p12",
+  ".pfx",
+  ".crt",
+  ".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 async function collectFiles(rootDir) {
+  const files = [];
+  let totalBytes = 0;
+
+  async function walk(currentDir, relativeDir = "") {
+    const entries = await readdir(currentDir, { withFileTypes: true });
+    entries.sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+      const relativePath = toPosixPath(path.join(relativeDir, entry.name));
+      if (shouldExclude(entry, relativePath)) continue;
+      if (entry.isDirectory()) {
+        await walk(fullPath, relativePath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const stats = await stat(fullPath);
+      totalBytes += stats.size;
+      if (files.length >= MAX_FILES) throw new Error(`项目文件超过 ${MAX_FILES} 个，请精简后再发布。`);
+      if (totalBytes > MAX_BYTES) throw new Error("项目文件超过 50MB，请删除大文件后再发布。");
+      files.push({ fullPath, relativePath, size: stats.size });
+    }
+  }
+
+  await walk(rootDir);
+  return files;
+}
+
+export function summarizeProject(projectDir, files) {
+  const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
+  const hasReadyPage = files.some((file) => [
+    "index.html",
+    "dist/index.html",
+    "build/index.html",
+    "out/index.html",
+    "public/index.html"
+  ].includes(file.relativePath));
+  const singleHtmlEntry = inferSingleHtmlEntry(files)?.relativePath || "";
+  const hasPackageJson = files.some((file) => file.relativePath === "package.json");
+  return {
+    projectDir,
+    fileCount: files.length,
+    totalBytes,
+    hasReadyPage,
+    singleHtmlEntry,
+    hasPackageJson
+  };
+}
+
+export async function createProjectArchive(rootDir, fileList, archivePath) {
+  const chunks = [];
+  const htmlEntry = inferSingleHtmlEntry(fileList);
+  for (const file of fileList) {
+    const data = await readFile(file.fullPath);
+    const archivePathName = htmlEntry && file.relativePath === htmlEntry.relativePath ? "index.html" : file.relativePath;
+    chunks.push(...createTarHeaders(archivePathName, data.length, 0o644));
+    chunks.push(data);
+    chunks.push(Buffer.alloc(padLength(data.length)));
+  }
+  chunks.push(Buffer.alloc(1024));
+  await mkdir(path.dirname(archivePath), { recursive: true });
+  await writeFile(archivePath, gzipSync(Buffer.concat(chunks)));
+}
+
+function inferSingleHtmlEntry(files) {
+  const hasIndex = files.some((file) => file.relativePath === "index.html");
+  if (hasIndex) return null;
+  const rootHtmlFiles = files.filter((file) => (
+    /^[^/]+\.html?$/i.test(file.relativePath) &&
+    !/^admin\.html$/i.test(file.relativePath) &&
+    !/^login\.html$/i.test(file.relativePath)
+  ));
+  return rootHtmlFiles.length === 1 ? rootHtmlFiles[0] : null;
+}
+
+export async function deployArchive({ apiBase, token, archivePath, projectName, source = "cli", userAgent = `demogo-cli/${VERSION}` }) {
+  const formData = new FormData();
+  formData.set("name", projectName);
+  formData.set("source", source);
+  formData.set(
+    "project",
+    new Blob([await readFile(archivePath)], { type: "application/gzip" }),
+    path.basename(archivePath)
+  );
+
+  let response;
+  try {
+    response = await fetch(`${normalizeApiBase(apiBase)}/api/agent/deploy`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "User-Agent": userAgent,
+        "X-DemoGo-Deploy-Source": source
+      },
+      body: formData
+    });
+  } catch {
+    throw new Error(`无法连接 DemoGo：${normalizeApiBase(apiBase)}。请检查 API 地址是否正确，或稍后再试。`);
+  }
+
+  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 checkApiHealth(apiBase) {
+  let response;
+  try {
+    response = await fetch(`${normalizeApiBase(apiBase)}/api/health`, {
+      method: "GET",
+      headers: { "User-Agent": `demogo-cli/${VERSION}` }
+    });
+  } catch {
+    throw new Error(`无法连接 DemoGo：${normalizeApiBase(apiBase)}。请检查平台地址。`);
+  }
+  const text = await response.text();
+  const payload = parseJson(text);
+  if (!response.ok || !payload?.ok) {
+    throw new Error(`DemoGo 平台地址不可用：HTTP ${response.status}`);
+  }
+  return payload;
+}
+
+export function normalizeApiBase(value) {
+  return String(value || "").trim().replace(/\/+$/, "");
+}
+
+export function safeArchiveName(value) {
+  return String(value || "demogo-project").replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "demogo-project";
+}
+
+export function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+
+function shouldExclude(entry, relativePath) {
+  const name = entry.name;
+  if (entry.isDirectory() && EXCLUDED_DIRS.has(name)) return true;
+  if (EXCLUDED_FILES.has(name)) return true;
+  if (name.endsWith(".log")) return true;
+  if (SENSITIVE_EXTENSIONS.some((extension) => name.toLowerCase().endsWith(extension))) return true;
+  if (relativePath.startsWith("dist/") && relativePath.includes("/server-package/")) return true;
+  return false;
+}
+
+function createTarHeaders(name, size, mode) {
+  const normalizedName = toPosixPath(name);
+  const ustarPath = splitUstarPath(normalizedName);
+  if (ustarPath && isAscii(normalizedName)) {
+    return [createTarHeader({ name: ustarPath.name, prefix: ustarPath.prefix, size, mode })];
+  }
+
+  const paxBody = Buffer.from(createPaxRecord("path", normalizedName), "utf8");
+  const fallbackName = safeTarName(normalizedName);
+  return [
+    createTarHeader({ name: `PaxHeaders/${fallbackName}`.slice(0, 100), size: paxBody.length, mode: 0o644, type: "x" }),
+    paxBody,
+    Buffer.alloc(padLength(paxBody.length)),
+    createTarHeader({ name: fallbackName, size, mode })
+  ];
+}
+
+function createTarHeader({ name, size, mode, type = "0", prefix = "" }) {
+  const buffer = Buffer.alloc(512, 0);
+  writeString(buffer, name, 0, 100);
+  writeOctal(buffer, mode, 100, 8);
+  writeOctal(buffer, 0, 108, 8);
+  writeOctal(buffer, 0, 116, 8);
+  writeOctal(buffer, size, 124, 12);
+  writeOctal(buffer, Math.floor(Date.now() / 1000), 136, 12);
+  buffer.fill(0x20, 148, 156);
+  buffer[156] = type.charCodeAt(0);
+  writeString(buffer, "ustar", 257, 6);
+  writeString(buffer, "00", 263, 2);
+  writeString(buffer, prefix, 345, 155);
+  const checksum = buffer.reduce((sum, value) => sum + value, 0);
+  writeOctal(buffer, checksum, 148, 8);
+  return buffer;
+}
+
+function writeString(buffer, value, offset, length) {
+  const data = Buffer.from(String(value), "utf8");
+  data.subarray(0, length).copy(buffer, offset);
+}
+
+function writeOctal(buffer, value, offset, length) {
+  const text = value.toString(8).padStart(length - 1, "0").slice(0, length - 1);
+  buffer.write(text, offset, length - 1, "ascii");
+  buffer[offset + length - 1] = 0;
+}
+
+function padLength(size) {
+  return (512 - (size % 512)) % 512;
+}
+
+function toPosixPath(value) {
+  return value.split(path.sep).join("/");
+}
+
+function splitUstarPath(name) {
+  if (Buffer.byteLength(name, "utf8") <= 100) return { name, prefix: "" };
+  const parts = name.split("/");
+  for (let index = parts.length - 1; index > 0; index -= 1) {
+    const prefix = parts.slice(0, index).join("/");
+    const entryName = parts.slice(index).join("/");
+    if (Buffer.byteLength(entryName, "utf8") <= 100 && Buffer.byteLength(prefix, "utf8") <= 155) {
+      return { name: entryName, prefix };
+    }
+  }
+  return null;
+}
+
+function createPaxRecord(key, value) {
+  let record = ` ${key}=${value}\n`;
+  let length = Buffer.byteLength(record, "utf8") + String(Buffer.byteLength(record, "utf8")).length;
+  while (true) {
+    const next = `${length}${record}`;
+    const nextLength = Buffer.byteLength(next, "utf8");
+    if (nextLength === length) return next;
+    length = nextLength;
+  }
+}
+
+function safeTarName(value) {
+  const baseName = path.posix.basename(String(value || "file")) || "file";
+  const safe = safeArchiveName(baseName) || "file";
+  if (Buffer.byteLength(safe, "utf8") <= 100) return safe;
+  return safe.slice(0, 80) || "file";
+}
+
+function isAscii(value) {
+  return /^[\x00-\x7F]*$/.test(value);
+}
+
+function parseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+function readableHttpError(status, text) {
+  if (status === 401) return "AI 发布口令无效或已被重置。";
+  if (status === 403) return "当前账号额度不足，无法生成新的试用链接。";
+  if (status === 413) return "项目包太大，请压缩或删除大文件后重试。";
+  if (status === 400) return "项目暂时不能发布，请根据 DemoGo 返回的提示修改后再试。";
+  if (text?.trim().startsWith("<")) return "服务器返回了异常页面，本次发布没有完成。";
+  return `DemoGo 发布失败：HTTP ${status}`;
+}
+

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@demogo-cn/cli",
+  "version": "0.2.5",
+  "description": "DemoGo CLI for generating shareable trial links from AI-built pages.",
+  "type": "module",
+  "bin": {
+    "demogo": "bin/demogo.js"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "UNLICENSED"
+}