gamealgo-cli 0.1.2 → 0.1.3

package/README.md

@@ -40,7 +40,7 @@ gamealgo key create --name <runtime-name> --json
 gamealgo key reveal --name <runtime-name> --json
 ```
 
-安装和更新 CLI 都使用 `npm install -g gamealgo-cli@latest`，不需要拉取 GameAlgo Client 仓库。`gamealgo docs` 从当前 Admin Host 获取最新 AI 文档；登录前显式传 `--host`，登录后 CLI 会使用已保存的 Host。需要网页阅读时使用 `gamealgo docs --open`。
+安装和更新 CLI 都使用 `npm install -g gamealgo-cli@latest`，不需要拉取 GameAlgo Client 仓库。请在每个游戏项目根目录执行 `gamealgo login`，凭据保存在项目的 `.gamealgo/cli.json`，不同游戏互不覆盖。`gamealgo docs` 从当前 Admin Host 获取最新 AI 文档；登录前显式传 `--host`，登录后 CLI 会使用已保存的 Host。需要网页阅读时使用 `gamealgo docs --open`。
 
 如果已有可用 Client Game Key，就复用或 reveal；如果没有，就创建。Client Game Key 格式为 `ga_live_*`，用于游戏运行时拉配置、拉配置文件、上报事件。
 

package/cli/README.md

@@ -56,7 +56,9 @@ gamealgo login \
   --admin-key ga_admin_xxx
 ```
 
-登录信息会写入本机 `~/.gamealgo/cli.json`，CLI 会把文件权限设置为 `600`。也可以通过环境变量临时传入：
+请在游戏项目根目录执行登录。登录信息会写入当前目录的 `.gamealgo/cli.json`，CLI 会把文件权限设置为 `600`，并自动忽略整个 `.gamealgo/` 目录，避免密钥被提交到 Git。后续命令会从当前目录逐级向上查找该文件，因此可以在项目子目录执行；不同游戏仓库的登录信息互不覆盖。
+
+旧版的 `~/.gamealgo/cli.json` 仍可作为未找到项目级配置时的兜底。也可以通过环境变量临时传入：
 
 ```bash
 GAMEALGO_ADMIN_HOST=<admin-host>

package/dist/gamealgo.js

@@ -7,7 +7,9 @@ import { homedir } from "node:os";
 import { createHash } from "node:crypto";
 import { spawn } from "node:child_process";
 import YAML from "yaml";
-const CONFIG_PATH = join(homedir(), ".gamealgo", "cli.json");
+const GLOBAL_CONFIG_PATH = join(homedir(), ".gamealgo", "cli.json");
+const PROJECT_CONFIG_DIR = ".gamealgo";
+const PROJECT_CONFIG_FILE = "cli.json";
 const DOCS_CACHE_ROOT = join(homedir(), ".gamealgo", "docs");
 const SCRIPT_EXTENSIONS = new Set([".js", ".lua"]);
 const FILE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]*$/;
@@ -135,12 +137,13 @@ async function login(args, global) {
     if (session.principal.type !== "game_admin" || !session.principal.gameId) {
         throw new Error("admin key is not scoped to a game");
     }
-    await saveConfig({ host, adminKey });
+    const configPath = await saveConfig({ host, adminKey });
     await printResult({
         ok: true,
         host,
         gameId: session.principal.gameId,
         keyName: session.principal.keyName,
+        configPath,
     }, global);
 }
 async function handleDocs(args, global) {
@@ -1398,18 +1401,59 @@ function requireFlagValue(args, index, flag) {
     return value;
 }
 async function loadConfig() {
-    try {
-        return JSON.parse(await readFile(CONFIG_PATH, "utf8"));
+    const localPath = await findProjectConfigPath(process.cwd());
+    const paths = localPath && localPath !== GLOBAL_CONFIG_PATH
+        ? [localPath, GLOBAL_CONFIG_PATH]
+        : [GLOBAL_CONFIG_PATH];
+    for (const configPath of paths) {
+        try {
+            return JSON.parse(await readFile(configPath, "utf8"));
+        }
+        catch {
+            // Try the next supported config location.
+        }
     }
-    catch {
-        return null;
+    return null;
+}
+async function findProjectConfigPath(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const candidate = join(currentDir, PROJECT_CONFIG_DIR, PROJECT_CONFIG_FILE);
+        try {
+            await readFile(candidate, "utf8");
+            return candidate;
+        }
+        catch {
+            const parentDir = dirname(currentDir);
+            if (parentDir === currentDir)
+                return null;
+            currentDir = parentDir;
+        }
     }
 }
 async function saveConfig(config) {
-    await mkdir(dirname(CONFIG_PATH), { recursive: true, mode: 0o700 });
-    await chmod(dirname(CONFIG_PATH), 0o700).catch(() => undefined);
-    await writeFile(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => undefined);
+    const configDir = join(process.cwd(), PROJECT_CONFIG_DIR);
+    const configPath = join(configDir, PROJECT_CONFIG_FILE);
+    await mkdir(configDir, { recursive: true, mode: 0o700 });
+    await chmod(configDir, 0o700).catch(() => undefined);
+    await ensureProjectConfigIgnored(configDir);
+    await writeFile(configPath, JSON.stringify(config, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
+    await chmod(configPath, 0o600).catch(() => undefined);
+    return configPath;
+}
+async function ensureProjectConfigIgnored(configDir) {
+    const ignorePath = join(configDir, ".gitignore");
+    try {
+        const existing = await readFile(ignorePath, "utf8");
+        const rules = existing.split(/\r?\n/).map((line) => line.trim());
+        if (rules.includes("*") || rules.includes(PROJECT_CONFIG_FILE) || rules.includes(`/${PROJECT_CONFIG_FILE}`))
+            return;
+        const separator = existing && !existing.endsWith("\n") ? "\n" : "";
+        await writeFile(ignorePath, `${existing}${separator}${PROJECT_CONFIG_FILE}\n`, { encoding: "utf8", mode: 0o600 });
+    }
+    catch {
+        await writeFile(ignorePath, "*\n", { encoding: "utf8", mode: 0o600 });
+    }
 }
 async function readObjectFile(filePath, label) {
     const text = await readFile(filePath, "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gamealgo-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "GameAlgo command-line client for AI agents and game developers",
   "type": "module",
   "bin": {