@demogo-cn/cli 0.2.5 → 0.2.7

package/README.md

@@ -6,7 +6,7 @@ DemoGo CLI lets AI coding tools publish a local project to DemoGo and return a s
 
 Current MVP delivery uses a local install package.
 
-1. Unzip `demogo-cli-v0.2.5.zip`.
+1. Unzip `demogo-cli-v0.2.7.zip`.
 2. Open a terminal in the extracted folder.
 3. Run:
 
@@ -32,6 +32,16 @@ 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
+```
+
+Or use the installed command:
+
 ```bash
 demogo deploy
 ```
@@ -42,16 +52,18 @@ For a specific folder or project name:
 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`.
+
 ## 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:
+AI coding tools can run:
 
 ```bash
-npx @demogo-cn/cli deploy
+npx --yes @demogo-cn/cli deploy
 ```
 
 Or install it globally:

package/bin/demogo.js

@@ -7,6 +7,7 @@ import {
   MAX_BYTES,
   VERSION,
   assertDirectory,
+  assertSafeProjectDirectory,
   collectFiles,
   createProjectArchive,
   deployArchive,
@@ -121,6 +122,7 @@ async function handleDeploy(args) {
   }
 
   await assertDirectory(projectDir);
+  assertSafeProjectDirectory(projectDir);
   const fileList = await collectFiles(projectDir);
   if (!fileList.length) fail("当前目录没有可发布文件。");
 
@@ -132,7 +134,10 @@ async function handleDeploy(args) {
     await createProjectArchive(projectDir, fileList, archivePath);
     const archiveStats = await stat(archivePath);
     if (archiveStats.size > MAX_BYTES) {
-      fail(`打包后文件超过 50MB，请减少大文件后重试。当前约 ${formatBytes(archiveStats.size)}。`);
+      fail([
+        `打包后文件超过 50MB，当前约 ${formatBytes(archiveStats.size)}。`,
+        "你可能在错误目录执行了发布。请切换到真正的项目目录，或使用 --dir 指定干净项目文件夹。"
+      ].join("\n"));
     }
     console.log(`项目包已生成：${formatBytes(archiveStats.size)}`);
     console.log("DemoGo 正在生成试用链接...");

package/lib/core.js

@@ -2,9 +2,19 @@
 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;
+export const VERSION = "0.2.7";
+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([
   ".git",
@@ -42,14 +52,36 @@ 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 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 = [];
@@ -69,15 +101,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(`项目文件超过 ${MAX_FILES} 个，请精简后再发布。`);
-      if (totalBytes > MAX_BYTES) throw new Error("项目文件超过 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;
-}
+  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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demogo-cn/cli",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "DemoGo CLI for generating shareable trial links from AI-built pages.",
   "type": "module",
   "bin": {