@quicktvui/ai-cli 0.1.3 → 1.1.2

package/README.md

@@ -8,6 +8,15 @@ QuickTVUI skill runtime CLI.
 npm install -g @quicktvui/ai-cli @quicktvui/ai-skills
 ```
 
+Starting from `@quicktvui/ai-cli@1.1.2`, global install/upgrade auto-runs
+`quicktvui-ai update` to sync:
+
+- `~/.agents/skills/quicktvui`
+- `~/.gemini/GEMINI.md` bridge block
+- `~/.gemini/settings.json` context file names
+
+Set `QUICKTVUI_AI_SKIP_POSTINSTALL=1` to disable auto-sync.
+
 ## Commands
 
 ```bash
@@ -41,18 +50,18 @@ quicktvui-aicreate-project quick-tv-app
 - `--skip-install`: skip dependency install for `create-project`
 - `--strict`: fail on doctor check issues
 - `--lang <code>`: prompt language for `prompt` command (`zh` or `en`)
+- `--gemini-dir <path>`: custom Gemini config directory (default `~/.gemini`, or `$GEMINI_CLI_HOME/.gemini`)
+- `--skip-gemini-config`: skip updating Gemini bridge config during `init`/`update`
 - `--node-major <n>`: target Node.js LTS major for `setup-vue-env` (default `20`)
 - `--skip-node-install`: skip Node.js install stage in `setup-vue-env`
 - `--force-node-install`: force Node.js install stage in `setup-vue-env`
 - `--skip-yarn-install`: skip yarn global install in `setup-vue-env`
-- `--skip-quicktvui-cli-install`: skip `@quicktvui/cli` global install in `setup-vue-env`
 - `--skip-project-install`: skip project dependency install in `setup-vue-env`
 - `--auto-emulator <true|false>`: auto create/start emulator when no adb device
 - `--adb-path <path>`: custom adb path/command (or use env `QUICKTVUI_ADB_PATH`)
 - `--device-ip <ip[:port]>`: preferred real device endpoint for `adb connect`
 - `--avd-name <name>`: custom AVD name for `setup-android-env`
 - `--headless`: start emulator with `-no-window -no-audio`
-- `--runtime-setup-mode <direct|qui>`: runtime setup mode (default `direct`)
 - `--runtime-version <version>`: pin runtime version in `direct` mode
 - `--runtime-url <url>`: use custom runtime apk url in `direct` mode
 - `--server-host <ip>`: override debug server host IP
@@ -76,6 +85,12 @@ quicktvui-ai doctor
 
 Then reload your AI agent so it rescans local skills.
 
+`init`/`update` also auto-maintains Gemini global context files:
+
+- updates `~/.gemini/GEMINI.md` with QuickTVUI `@.../SKILL.md` bridge block
+- ensures `~/.gemini/settings.json` contains `context.fileName` entries:
+  `GEMINI.md`, `AGENTS.md`, `SKILL.md`, `CONTEXT.md`
+
 ## Create project with network fallback
 
 ```bash
@@ -110,12 +125,6 @@ This command:
 10. Installs runtime APK and configures debug server host (direct mode by default).
 11. Launches runtime app and waits it enters running state.
 
-To use official interactive setup flow instead of direct mode:
-
-```bash
-quicktvui-ai setup-android-env --project ./quick-tv-app --runtime-setup-mode qui
-```
-
 ## Configure Vue env (Node + package manager)
 
 ```bash
@@ -125,7 +134,7 @@ quicktvui-ai setup-vue-env --project ./quick-tv-app
 This command:
 
 1. Ensures Node.js LTS (macOS/Windows auto install).
-2. Ensures `yarn` and `@quicktvui/cli` are installed globally.
+2. Ensures `yarn` is installed globally.
 3. Installs project dependencies (`yarn install` or `npm install` fallback).
 
 ## Configure All Dev Envs

package/lib/index.js

@@ -7,7 +7,13 @@ const https = require("https");
 const net = require("net");
 const { spawnSync, spawn } = require("child_process");
 
-const PACKAGE_VERSION = "0.1.2";
+const PACKAGE_VERSION = (() => {
+  try {
+    return require("../package.json").version || "0.0.0";
+  } catch (error) {
+    return "0.0.0";
+  }
+})();
 const DEFAULT_INSTALL_DIR = path.join(
   os.homedir(),
   ".agents",
@@ -33,9 +39,19 @@ const REQUIRED_SKILL_FILES = [
   "SKILL.md",
   path.join("references", "scaffold-checklist.md"),
   path.join("references", "create-project-checklist.md"),
+  path.join("references", "dev-env-checklist.md"),
+  path.join("references", "esapp-protocol-cheatsheet.md"),
   path.join("references", "lookup-checklist.md"),
   path.join("references", "bug-report-template.md"),
 ];
+const QUICKTVUI_GEMINI_BRIDGE_START = "<!-- QUICKTVUI_SKILL_BRIDGE_START -->";
+const QUICKTVUI_GEMINI_BRIDGE_END = "<!-- QUICKTVUI_SKILL_BRIDGE_END -->";
+const DEFAULT_GEMINI_CONTEXT_FILENAMES = [
+  "GEMINI.md",
+  "AGENTS.md",
+  "SKILL.md",
+  "CONTEXT.md",
+];
 
 function exists(filePath) {
   return fs.existsSync(filePath);
@@ -65,6 +81,21 @@ function removeDirectoryIfExists(dirPath) {
   }
 }
 
+function backupFile(filePath) {
+  if (!exists(filePath)) return null;
+  const backupPath = `${filePath}.bak`;
+  try {
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+  } catch (error) {
+    return null;
+  }
+}
+
+function escapeRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 function needsWindowsShell(command) {
   return process.platform === "win32" && /\.(bat|cmd)$/i.test(String(command));
 }
@@ -1760,10 +1791,6 @@ async function runSetupVueEnv(args) {
   );
   const skipNodeInstall = toBooleanFlag(args["skip-node-install"], false);
   const skipYarnInstall = toBooleanFlag(args["skip-yarn-install"], false);
-  const skipQuicktvuiCliInstall = toBooleanFlag(
-    args["skip-quicktvui-cli-install"],
-    false,
-  );
   const skipProjectInstall = toBooleanFlag(args["skip-project-install"], false);
 
   if (
@@ -1795,13 +1822,6 @@ async function runSetupVueEnv(args) {
     runCommand("npm", ["install", "-g", "yarn"], { stdio: "inherit" });
   }
 
-  if (!skipQuicktvuiCliInstall && !commandCanRun("qui", ["--help"])) {
-    console.log("Installing @quicktvui/cli globally...");
-    runCommand("npm", ["install", "-g", "@quicktvui/cli@latest"], {
-      stdio: "inherit",
-    });
-  }
-
   if (!skipProjectInstall) {
     if (!exists(path.join(projectRoot, "package.json"))) {
       throw new Error(`Missing package.json in project root: ${projectRoot}`);
@@ -1842,10 +1862,6 @@ async function runSetupAndroidEnv(args) {
   const projectRoot = args.project ? path.resolve(args.project) : process.cwd();
   const skipRuntimeSetup = toBooleanFlag(args["skip-runtime-setup"], false);
   const autoEmulator = toBooleanFlag(args["auto-emulator"], true);
-  const runtimeSetupMode =
-    typeof args["runtime-setup-mode"] === "string"
-      ? String(args["runtime-setup-mode"]).trim().toLowerCase()
-      : "direct";
   const avdName =
     typeof args["avd-name"] === "string" && args["avd-name"].trim()
       ? args["avd-name"].trim()
@@ -2002,23 +2018,12 @@ async function runSetupAndroidEnv(args) {
 
   let hostIp = getLocalIPv4Address();
   if (!skipRuntimeSetup) {
-    if (runtimeSetupMode === "qui") {
-      if (!commandCanRun("qui", ["--help"])) {
-        throw new Error(
-          "QuickTVUI CLI 'qui' is unavailable. Run: npm install -g @quicktvui/cli@latest",
-        );
-      }
-      console.log("Running 'qui setup' to configure runtime APK...");
-      runCommand("qui", ["setup"], { cwd: projectRoot });
-      hostIp = getLocalIPv4Address();
-    } else {
-      const runtimeResult = await ensureRuntimeInstalledAndConfigured(
-        adbPath,
-        targetSerial,
-        args,
-      );
-      hostIp = runtimeResult.hostIp;
-    }
+    const runtimeResult = await ensureRuntimeInstalledAndConfigured(
+      adbPath,
+      targetSerial,
+      args,
+    );
+    hostIp = runtimeResult.hostIp;
   } else {
     console.log("Skip runtime setup due to --skip-runtime-setup.");
   }
@@ -2193,34 +2198,155 @@ async function runRunEsapp(args) {
   console.log("ES app launch command sent.");
 }
 
-function resolveSkillsSource() {
+function parseVersionSegments(version) {
+  const normalized = String(version || "0.0.0")
+    .trim()
+    .split("-")[0];
+  const parts = normalized ? normalized.split(".") : [];
+  if (parts.length === 0) return [0, 0, 0];
+
+  return parts.map((part) => {
+    const parsed = Number.parseInt(part, 10);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+  });
+}
+
+function compareVersionStrings(left, right) {
+  const leftParts = parseVersionSegments(left);
+  const rightParts = parseVersionSegments(right);
+  const total = Math.max(leftParts.length, rightParts.length);
+  for (let i = 0; i < total; i += 1) {
+    const leftValue = leftParts[i] || 0;
+    const rightValue = rightParts[i] || 0;
+    if (leftValue > rightValue) return 1;
+    if (leftValue < rightValue) return -1;
+  }
+  return 0;
+}
+
+function buildSkillsSourceCandidateFromPackageRoot(packageRoot, sourceLabel) {
+  if (!packageRoot) return null;
+  const resolvedPackageRoot = path.resolve(packageRoot);
+  const sourceDir = path.join(resolvedPackageRoot, "skills", "quicktvui");
+  if (!exists(sourceDir)) return null;
+
+  let version = "0.0.0";
+  const packageJsonPath = path.join(resolvedPackageRoot, "package.json");
+  if (exists(packageJsonPath)) {
+    try {
+      const packageJson = readJsonFile(packageJsonPath);
+      if (
+        packageJson &&
+        typeof packageJson.version === "string" &&
+        packageJson.version.trim()
+      ) {
+        version = packageJson.version.trim();
+      }
+    } catch (error) {
+      // Ignore parse errors; keep default version for ordering.
+    }
+  }
+
+  return {
+    sourceLabel,
+    sourceDir,
+    packageRoot: resolvedPackageRoot,
+    version,
+  };
+}
+
+function buildSkillsSourceCandidateFromRequire() {
   try {
-    // Preferred: installed dependency
     const { getSkillsRoot } = require("@quicktvui/ai-skills");
-    const resolved = path.join(getSkillsRoot(), "quicktvui");
-    if (exists(resolved)) return resolved;
+    if (typeof getSkillsRoot !== "function") return null;
+    const resolvedSkillsRoot = getSkillsRoot();
+    const sourceDir = path.join(resolvedSkillsRoot, "quicktvui");
+    if (!exists(sourceDir)) return null;
+
+    let packageRoot = null;
+    let version = "0.0.0";
+    try {
+      const packageJsonPath =
+        require.resolve("@quicktvui/ai-skills/package.json");
+      packageRoot = path.dirname(packageJsonPath);
+      const packageJson = readJsonFile(packageJsonPath);
+      if (
+        packageJson &&
+        typeof packageJson.version === "string" &&
+        packageJson.version.trim()
+      ) {
+        version = packageJson.version.trim();
+      }
+    } catch (error) {
+      // Keep fallback metadata if package.json cannot be resolved.
+    }
+
+    return {
+      sourceLabel: "dependency-resolved",
+      sourceDir: path.resolve(sourceDir),
+      packageRoot: packageRoot ? path.resolve(packageRoot) : null,
+      version,
+    };
   } catch (error) {
-    // Fallback for monorepo local development
+    return null;
   }
+}
 
-  const localFallback = path.resolve(
+function resolveSkillsSource() {
+  const candidates = [];
+  const seenSourceDirs = new Set();
+
+  function addCandidate(candidate) {
+    if (!candidate || !candidate.sourceDir) return;
+    const key = path.resolve(candidate.sourceDir);
+    if (seenSourceDirs.has(key)) return;
+    seenSourceDirs.add(key);
+    candidates.push(candidate);
+  }
+
+  // Prefer globally upgraded sibling package if present.
+  const globalSiblingPackageRoot = path.resolve(
+    __dirname,
+    "..",
+    "..",
+    "ai-skills",
+  );
+  addCandidate(
+    buildSkillsSourceCandidateFromPackageRoot(
+      globalSiblingPackageRoot,
+      "global-sibling",
+    ),
+  );
+
+  // Dependency resolution keeps compatibility when only @quicktvui/ai-cli is installed.
+  addCandidate(buildSkillsSourceCandidateFromRequire());
+
+  // Monorepo fallback for local development.
+  const monorepoPackageRoot = path.resolve(
     __dirname,
     "..",
     "..",
     "..",
     "packages",
     "quicktvui-ai-skills",
-    "skills",
-    "quicktvui",
+  );
+  addCandidate(
+    buildSkillsSourceCandidateFromPackageRoot(monorepoPackageRoot, "monorepo"),
   );
 
-  if (!exists(localFallback)) {
+  if (candidates.length === 0) {
     throw new Error(
       "Unable to locate QuickTVUI skill assets. Install @quicktvui/ai-skills or use repository local layout.",
     );
   }
 
-  return localFallback;
+  candidates.sort((left, right) => {
+    const versionOrder = compareVersionStrings(right.version, left.version);
+    if (versionOrder !== 0) return versionOrder;
+    return left.sourceDir.localeCompare(right.sourceDir);
+  });
+
+  return candidates[0].sourceDir;
 }
 
 function getInstallDir(args) {
@@ -2272,7 +2398,7 @@ Commands:
   validate   Strict check for required skill files (non-zero exit if missing)
   update     Reinstall skill assets to target directory
   create-project  Create a QuickTVUI project (remote clone, local fallback)
-  setup-vue-env  Setup Vue development environment (Node/yarn/quicktvui cli)
+  setup-vue-env  Setup Vue development environment (Node/yarn)
   setup-android-env  Configure Android device/emulator + runtime environment
   setup-all-env  Setup both Vue and Android development environments
   run-dev    Run project dev command (optionally checks Android env first)
@@ -2288,20 +2414,20 @@ Options:
   --skip-install    Skip dependency install in create-project
   --strict          Non-zero exit in doctor when checks fail
   --lang <code>     Prompt language for 'prompt' command: zh | en
+  --gemini-dir <path> Gemini config directory (default: ~/.gemini or $GEMINI_CLI_HOME/.gemini)
+  --skip-gemini-config Skip updating Gemini bridge files during init/update
   --yes             Non-interactive mode; accept default prompts
   --no-interactive  Disable interactive prompts
   --node-major <n>  Target Node.js LTS major for setup-vue-env (default: 20)
   --skip-node-install  Skip Node.js auto-install stage in setup-vue-env
   --force-node-install Force Node.js auto-install even if current version is ok
   --skip-yarn-install Skip yarn global install in setup-vue-env
-  --skip-quicktvui-cli-install Skip @quicktvui/cli global install in setup-vue-env
   --skip-project-install Skip project dependency install in setup-vue-env
   --auto-emulator <true|false>  Auto create/start emulator when no adb device
   --adb-path <path> Custom adb binary path/command (or set QUICKTVUI_ADB_PATH)
   --device-ip <ip[:port]> Preferred real device endpoint for adb connect
   --avd-name <name> Custom AVD name for setup-android-env
   --headless        Start emulator with -no-window -no-audio
-  --runtime-setup-mode <direct|qui> Runtime setup mode in setup-android-env (default: direct)
   --runtime-version <version> Pin runtime version when direct mode is used
   --runtime-url <url> Use custom runtime apk url in direct mode
   --server-host <ip> Override local debug server host IP
@@ -2401,6 +2527,191 @@ function installSkills(installDir) {
   return { installDir, sourceDir };
 }
 
+function resolveGeminiConfigDir(args) {
+  if (typeof args["gemini-dir"] === "string" && args["gemini-dir"].trim()) {
+    return path.resolve(args["gemini-dir"].trim());
+  }
+
+  const customGeminiHome = process.env.GEMINI_CLI_HOME
+    ? String(process.env.GEMINI_CLI_HOME).trim()
+    : "";
+  if (customGeminiHome) {
+    const resolved = path.resolve(customGeminiHome);
+    if (path.basename(resolved).toLowerCase() === ".gemini") {
+      return resolved;
+    }
+    return path.join(resolved, ".gemini");
+  }
+
+  return path.join(os.homedir(), ".gemini");
+}
+
+function buildGeminiBridgeImportPaths(installDir) {
+  const preferredFiles = [
+    "SKILL.md",
+    path.join("references", "create-project-checklist.md"),
+    path.join("references", "dev-env-checklist.md"),
+    path.join("references", "esapp-protocol-cheatsheet.md"),
+  ];
+
+  const importPaths = [];
+  for (const relPath of preferredFiles) {
+    const absolutePath = path.join(installDir, relPath);
+    if (exists(absolutePath)) {
+      importPaths.push(absolutePath);
+    }
+  }
+
+  if (importPaths.length === 0) {
+    importPaths.push(path.join(installDir, "SKILL.md"));
+  }
+
+  return importPaths;
+}
+
+function updateGeminiBridgeConfig(args, installDir) {
+  if (toBooleanFlag(args["skip-gemini-config"], false)) {
+    return {
+      skipped: true,
+      reason: "flag",
+    };
+  }
+
+  const geminiDir = resolveGeminiConfigDir(args);
+  ensureDir(geminiDir);
+
+  const geminiMdPath = path.join(geminiDir, "GEMINI.md");
+  const settingsPath = path.join(geminiDir, "settings.json");
+  const importPaths = buildGeminiBridgeImportPaths(installDir);
+
+  const bridgeBlock = [
+    QUICKTVUI_GEMINI_BRIDGE_START,
+    "QuickTVUI global skill bridge (managed by quicktvui-ai assistant).",
+    ...importPaths.map((importPath) => `@${importPath}`),
+    QUICKTVUI_GEMINI_BRIDGE_END,
+  ].join("\n");
+
+  const beforeGeminiMd = exists(geminiMdPath)
+    ? fs.readFileSync(geminiMdPath, "utf8")
+    : "";
+  const bridgePattern = new RegExp(
+    `${escapeRegExp(QUICKTVUI_GEMINI_BRIDGE_START)}[\\s\\S]*?${escapeRegExp(QUICKTVUI_GEMINI_BRIDGE_END)}`,
+    "m",
+  );
+  let nextGeminiMd;
+  if (bridgePattern.test(beforeGeminiMd)) {
+    nextGeminiMd = beforeGeminiMd.replace(bridgePattern, bridgeBlock);
+  } else {
+    const trimmed = beforeGeminiMd.replace(/\s*$/, "");
+    nextGeminiMd = trimmed
+      ? `${trimmed}\n\n${bridgeBlock}\n`
+      : `${bridgeBlock}\n`;
+  }
+
+  let geminiMdUpdated = false;
+  let geminiMdBackup = null;
+  if (nextGeminiMd !== beforeGeminiMd) {
+    geminiMdBackup = backupFile(geminiMdPath);
+    fs.writeFileSync(geminiMdPath, nextGeminiMd, "utf8");
+    geminiMdUpdated = true;
+  }
+
+  const result = {
+    skipped: false,
+    geminiDir,
+    geminiMdPath,
+    settingsPath,
+    importPaths,
+    geminiMdUpdated,
+    geminiMdBackup,
+    settingsUpdated: false,
+    settingsBackup: null,
+    settingsParseError: null,
+  };
+
+  let settings = {};
+  const beforeSettings = exists(settingsPath)
+    ? fs.readFileSync(settingsPath, "utf8")
+    : "";
+  if (beforeSettings.trim()) {
+    try {
+      settings = JSON.parse(beforeSettings);
+    } catch (error) {
+      result.settingsParseError = error.message;
+      return result;
+    }
+  }
+
+  if (!settings || typeof settings !== "object" || Array.isArray(settings)) {
+    settings = {};
+  }
+  if (!settings.context || typeof settings.context !== "object") {
+    settings.context = {};
+  }
+
+  const current = settings.context.fileName;
+  const normalizedList = Array.isArray(current)
+    ? current
+        .map((item) => String(item).trim())
+        .filter((item) => item.length > 0)
+    : typeof current === "string" && current.trim()
+      ? [current.trim()]
+      : [];
+
+  const lowerSet = new Set(normalizedList.map((item) => item.toLowerCase()));
+  for (const fileName of DEFAULT_GEMINI_CONTEXT_FILENAMES) {
+    if (!lowerSet.has(fileName.toLowerCase())) {
+      normalizedList.push(fileName);
+      lowerSet.add(fileName.toLowerCase());
+    }
+  }
+  settings.context.fileName = normalizedList;
+
+  const nextSettings = `${JSON.stringify(settings, null, 2)}\n`;
+  if (nextSettings !== beforeSettings) {
+    result.settingsBackup = backupFile(settingsPath);
+    fs.writeFileSync(settingsPath, nextSettings, "utf8");
+    result.settingsUpdated = true;
+  }
+
+  return result;
+}
+
+function printGeminiBridgeResult(state) {
+  if (!state) return;
+  if (state.error) {
+    console.log(`- Gemini config: failed (${state.error})`);
+    console.log(
+      `  Hint: rerun with --skip-gemini-config or fix filesystem permission.`,
+    );
+    return;
+  }
+  if (state.skipped) {
+    console.log(`- Gemini config: skipped (--skip-gemini-config)`);
+    return;
+  }
+
+  console.log(`- Gemini config dir: ${state.geminiDir}`);
+  console.log(
+    `- Gemini bridge block: ${state.geminiMdUpdated ? "updated" : "already up to date"}`,
+  );
+  console.log(
+    `- Gemini context.fileName: ${
+      state.settingsParseError
+        ? "skipped (settings.json parse failed)"
+        : state.settingsUpdated
+          ? "updated"
+          : "already up to date"
+    }`,
+  );
+  if (state.settingsParseError) {
+    console.log(`  Warning: ${state.settingsParseError}`);
+    console.log(
+      `  Hint: fix ${state.settingsPath} JSON and rerun 'quicktvui-ai init'.`,
+    );
+  }
+}
+
 function printDoctorReport(skillState, projectState, projectRoot) {
   console.log(`Skill dir: ${skillState.installDir}`);
   console.log(`- Directory exists: ${skillState.exists ? "yes" : "no"}`);
@@ -2428,9 +2739,16 @@ function printDoctorReport(skillState, projectState, projectRoot) {
 async function runInit(args) {
   const installDir = getInstallDir(args);
   const result = installSkills(installDir);
+  let geminiState;
+  try {
+    geminiState = updateGeminiBridgeConfig(args, result.installDir);
+  } catch (error) {
+    geminiState = { error: error.message };
+  }
   console.log(`Installed QuickTVUI skill assets.`);
   console.log(`- source: ${result.sourceDir}`);
   console.log(`- target: ${result.installDir}`);
+  printGeminiBridgeResult(geminiState);
   console.log(`Next: restart/reload your AI agent so it can rescan skills.`);
 }
 
@@ -2484,9 +2802,16 @@ async function runValidate(args) {
 async function runUpdate(args) {
   const installDir = getInstallDir(args);
   const result = installSkills(installDir);
+  let geminiState;
+  try {
+    geminiState = updateGeminiBridgeConfig(args, result.installDir);
+  } catch (error) {
+    geminiState = { error: error.message };
+  }
   console.log(`Updated QuickTVUI skill assets.`);
   console.log(`- source: ${result.sourceDir}`);
   console.log(`- target: ${result.installDir}`);
+  printGeminiBridgeResult(geminiState);
 }
 
 function cloneTemplateProject(targetDir) {
@@ -2547,7 +2872,7 @@ async function runCreateProject(args) {
     "- ensured: package.json name/version updated and @quicktvui/ai added to devDependencies",
   );
   console.log(
-    "- next: if not configured, run 'npm install -g @quicktvui/cli@latest' and 'qui setup'",
+    "- next: run 'quicktvui-ai setup-all-env --project <project-path>' to prepare development and runtime environments",
   );
 }
 
@@ -2571,6 +2896,7 @@ npm install @quicktvui/ai --save-dev
 \`\`\`
 
 安装完成后请提醒用户重启或 reload AI Agent，以便重新扫描 ~/.agents/skills/quicktvui。
+并提示：quicktvui-ai init 会自动更新 ~/.gemini/GEMINI.md 与 ~/.gemini/settings.json 的 QuickTVUI bridge 配置。
 
 创建项目时优先使用：
 \`\`\`bash
@@ -2606,6 +2932,7 @@ npm install @quicktvui/ai --save-dev
 \`\`\`
 
 After installation, ask the user to restart or reload the AI Agent so it rescans ~/.agents/skills/quicktvui.
+Also note that quicktvui-ai init auto-updates QuickTVUI bridge config in ~/.gemini/GEMINI.md and ~/.gemini/settings.json.
 
 When creating a project, prefer:
 \`\`\`bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicktvui/ai-cli",
-  "version": "0.1.3",
+  "version": "1.1.2",
   "description": "CLI for installing and validating QuickTVUI AI skills",
   "bin": {
     "quicktvui-ai": "bin/quicktvui-ai.js",
@@ -8,6 +8,9 @@
     "quicktvui-aicreate-project": "bin/quicktvui-aicreate-project.js"
   },
   "main": "lib/index.js",
+  "scripts": {
+    "postinstall": "node scripts/postinstall-sync.js"
+  },
   "files": [
     "bin",
     "lib",
@@ -25,6 +28,6 @@
   "author": "QuickTVUI",
   "license": "MIT",
   "dependencies": {
-    "@quicktvui/ai-skills": "^0.1.0"
+    "@quicktvui/ai-skills": "^1.1.1"
   }
 }

package/scripts/install

@@ -41,4 +41,5 @@ else
   quicktvui-ai doctor --strict --dir "$INSTALL_DIR"
 fi
 
-echo "Done. Reload your AI agent to rescan local skills."
+echo "Done. quicktvui-ai init also updated Gemini bridge config under ~/.gemini."
+echo "Reload your AI agent to rescan local skills."

package/scripts/install.ps1

@@ -25,4 +25,5 @@ if ($Project -and $Project.Length -gt 0) {
   quicktvui-ai doctor --strict --dir $Dir
 }
 
-Write-Host "Done. Reload your AI agent to rescan local skills." -ForegroundColor Green
+Write-Host "Done. quicktvui-ai init also updated Gemini bridge config under ~/.gemini." -ForegroundColor Green
+Write-Host "Reload your AI agent to rescan local skills." -ForegroundColor Green

package/scripts/postinstall-sync.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+const { runCli } = require("../lib/index");
+
+function isTruthy(value) {
+  return value === true || value === "true" || value === "1";
+}
+
+function isGlobalInstall() {
+  if (isTruthy(process.env.npm_config_global)) return true;
+  return process.env.npm_config_location === "global";
+}
+
+async function main() {
+  if (isTruthy(process.env.QUICKTVUI_AI_SKIP_POSTINSTALL)) {
+    return;
+  }
+  if (!isGlobalInstall()) {
+    return;
+  }
+
+  try {
+    await runCli(["update"]);
+    console.log(
+      "[quicktvui-ai] postinstall: synced latest skill files into ~/.agents/skills/quicktvui.",
+    );
+  } catch (error) {
+    console.warn(
+      `[quicktvui-ai] postinstall: unable to auto-sync skill files (${error.message}). Run 'quicktvui-ai update' manually.`,
+    );
+  }
+}
+
+main();