gamealgo-cli 0.1.2 → 0.1.4

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>
@@ -227,7 +229,8 @@ type: managed
 platform: ios
 objectiveTemplate: ltv_proxy@1
 baselineVariantId: alpha
-cycleDays: 7
+minWindowDays: 7
+maxWindowDays: 14
 maxVariantsPerRound: 3
 # 可选：仅托管实验支持。最近 24 小时同时满足两个门槛后才开始首轮。
 startCondition:
@@ -244,15 +247,17 @@ variants:
 
 `minCoverage` 表示指定平台最近 24 小时内，实验接入版本达到 Strategy `requiredIntegrationVersion` 的去重用户占比；`minUsers` 表示同一窗口内的非 Debug 去重用户数。两项可单独配置，同时配置时必须同时满足。等待期间 Strategy 继续下发默认参数，满足门槛后平台才生成首轮时间窗并开始分流。手动实验不支持 `startCondition`，托管实验不配置时仍会立即启动。`experiment run show` 返回 `startConditionSnapshot`，可查看当前用户数、覆盖率和最近检查时间。
 
-托管实验只执行候选组数量决定的计划轮次，不会因为结果不显著而自动追加轮次。每轮结束都会生成正式报告；最后一轮只有在证据足够明确时才更新默认参数。没有明确胜出组时，实验正常完成，Strategy 默认参数保持不变。
+托管实验只执行候选组数量决定的计划轮次，不会自动增加复赛轮次。每轮至少运行 `minWindowDays` 天；达到参考周期后若证据仍不明确，平台逐日延长，最长运行到 `maxWindowDays`。`minWindowDays` 支持 1～30 天，`maxWindowDays` 支持到 60 天且不能小于参考周期。达到最长周期仍无明确胜出组时结束本轮，Strategy 默认参数保持不变。
 
 `ltv_proxy@1` 的标准口径为：
 
 ```text
-LTV Proxy = DAU ARPU * (1 + D1 + D2 + D3 + D4 + D5)
+LTV Proxy (Dk) = STANDARDIZED_DAY_VALUE_D0 + ... + STANDARDIZED_DAY_VALUE_Dk
 ```
 
-其中 DAU ARPU 是实验窗口内总收入除以活跃用户天数；Dx 留存只使用截至评估时已经成熟的 cohort，并按 cohort 用户数加权。平台不会等待最后一天用户的 D5 成熟后再结束实验。
+`STANDARDIZED_DAY_VALUE_Dx` 使用所有在 Dx 已成熟的实验进入用户作为分母，未回访用户当日价值按 0 计入。广告曝光按广告类型和用户本地日内曝光序号分桶，每个桶使用本轮所有参与组在实验窗口内共同计算的参考 CPM，再加实际内购收入。
+
+所有实验组使用同一个 `k`。平台按参考周期固定 `k 上限 = min(14, minWindowDays - 3)`，再选择不超过上限、且每个参与组都至少有 10 个成熟进入用户的最大连续 Dx。延长只增加样本，不改变评分口径。平台用本轮真实用户和线上 MurmurHash 分流规则模拟大量随机 seed，估计当前游戏用户结构下的自然组间波动，并校正多实验组与逐日重复评估。实际收入、实际 ARPU、新用户留存和新用户 LTV 只作为诊断指标，不参与主指标计算。
 
 所有会修改线上状态的实验命令都必须显式传 `--yes`。
 

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) {
@@ -395,9 +398,20 @@ async function handleExperimentRun(client, args, global) {
         if (!optionalString(body.baselineVariantId)) {
             throw new Error("experiment run requires explicit baselineVariantId");
         }
-        if ((optionalString(body.type) || "manual") !== "managed" && body.startCondition !== undefined) {
+        const runType = optionalString(body.type) || "manual";
+        if (runType !== "managed" && body.startCondition !== undefined) {
             throw new Error("experiment run startCondition is supported only when type is managed");
         }
+        if (runType === "managed") {
+            const minWindowDays = Number(body.minWindowDays);
+            const maxWindowDays = Number(body.maxWindowDays);
+            if (!Number.isInteger(minWindowDays) || minWindowDays < 1 || minWindowDays > 30) {
+                throw new Error("managed experiment run requires minWindowDays between 1 and 30");
+            }
+            if (!Number.isInteger(maxWindowDays) || maxWindowDays < minWindowDays || maxWindowDays > 60) {
+                throw new Error("managed experiment run requires maxWindowDays between minWindowDays and 60");
+            }
+        }
         await printResult(await client.createExperimentV2Run(strategyKey, body), global);
         return;
     }
@@ -1398,18 +1412,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.4",
   "description": "GameAlgo command-line client for AI agents and game developers",
   "type": "module",
   "bin": {