zcf 3.3.1 → 3.3.3

package/README.md

@@ -27,6 +27,22 @@
 [![Sponsor AI API](./src/assets/302.ai-en.jpg)](https://share.302.ai/gAT9VG)
 [302.AI](https://share.302.ai/gAT9VG) is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.
 
+---
+
+[![GLM](./src/assets/GLM-en.png)](https://z.ai/subscribe?ic=8JVLJQFSKB)
+This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.
+GLM CODING PLAN is a subscription service designed for AI coding, starting at just $3/month. It provides access to their flagship GLM-4.6 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences.
+Get 10% OFF GLM CODING PLAN：https://z.ai/subscribe?ic=8JVLJQFSKB
+
+---
+
+<table>
+<tr>
+<td width="180"><a href="https://www.packyapi.com/register?aff=zcf"><img src="./src/assets/packycode.png" alt="PackyCode" width="150"></a></td>
+<td>Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using  <a href="https://www.packyapi.com/register?aff=zcf">this link</a>  and enter the "zcf" promo code during recharge to get 10% off.</td>
+</tr>
+</table>
+
 ## 🚀 Quick Start
 
 ### 🎯 Recommended: Use Interactive Menu (v2.0 New)
@@ -154,7 +170,8 @@ ZCF now supports API provider presets that automatically configure baseUrl and m
 
 **Supported Providers:**
 - `302ai` - [302.AI](https://share.302.ai/gAT9VG) API Service
-- `glm` - GLM (z.ai)
+- `packycode` - [PackyCode](https://www.packyapi.com/register?aff=zcf) API Service
+- `glm` - [GLM](https://z.ai/subscribe?ic=8JVLJQFSKB) API Service
 - `minimax` - MiniMax API Service
 - `kimi` - Kimi (Moonshot AI)
 - `custom` - Custom API endpoint (requires manual URL configuration)
@@ -167,6 +184,9 @@ npx zcf i --skip-prompt --provider 302ai --api-key "sk-xxx"
 # or shorthand
 npx zcf i -s -p 302ai -k "sk-xxx"
 
+# Using PackyCode provider
+npx zcf i -s -p packycode -k "sk-xxx"
+
 # Using GLM provider
 npx zcf i -s -p glm -k "sk-xxx"
 
@@ -197,7 +217,7 @@ When using `--skip-prompt`, the following parameters are available:
 | Parameter                    | Description                                              | Values                                                                                             | Required                               | Default                                                                                                                          |
 | ---------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
 | `--skip-prompt, -s`          | Skip all interactive prompts                             | -                                                                                                  | Yes (for non-interactive mode)         | -                                                                                                                                |
-| `--provider, -p`             | API provider preset (v3.3.0+ New)                        | `302ai`, `glm`, `minimax`, `kimi`, `custom`                                                        | No                                     | - (Simplifies configuration by auto-filling baseUrl and models)                                                                  |
+| `--provider, -p`             | API provider preset (v3.3.0+ New)                        | `302ai`, `packycode`, `glm`, `minimax`, `kimi`, `custom`                                           | No                                     | - (Simplifies configuration by auto-filling baseUrl and models)                                                                  |
 | `--lang, -l`                 | ZCF display language (applies to all commands)           | `zh-CN`, `en`                                                                                      | No                                     | `en` or user's saved preference                                                                                                  |
 | `--config-lang, -c`          | Configuration language (template files language)         | `zh-CN`, `en`                                                                                      | No                                     | `en`                                                                                                                             |
 | `--ai-output-lang, -a`       | AI output language                                       | `zh-CN`, `en`, custom string                                                                       | No                                     | `en`                                                                                                                             |
@@ -289,7 +309,7 @@ ZCF now supports customizable AI output styles to personalize your Claude Code e
 
 <p align="center">
 <a href="https://github.com/Haleclipse">
-<img src="./src/assets/Haleclipse.gif" alt="Halley-chan" width="200"/>
+<img src="./src/assets/Haleclipse.webp" alt="Halley-chan" width="200"/>
 </a>
 <div align="center">Tsundere <a href="https://github.com/Haleclipse">Halley-chan</a> Ojou-sama (￣▽￣)ゞ</div>
 </p>
@@ -473,6 +493,7 @@ ZCF provides flexible API configuration options for both Claude Code and Codex:
 
 Choose from popular API providers with pre-configured settings:
 - **302.AI** - Pay-as-you-go AI service with comprehensive model support
+- **PackyCode** - PackyCode API Service
 - **GLM (智谱AI)** - Zhipu AI's GLM models
 - **MiniMax** - MiniMax AI service
 - **Kimi (Moonshot AI)** - Moonshot's Kimi models
@@ -930,6 +951,8 @@ If you find this project helpful, please consider sponsoring its development. Yo
 
 A huge thank you to all our sponsors for their generous support!
 - [302.AI](https://share.302.ai/gAT9VG) (first corporate sponsorship 🤠)
+- [GLM](https://z.ai/subscribe?ic=8JVLJQFSKB) (first AI model sponsorship 🤖)
+- [PackyCode](https://www.packyapi.com/register?aff=zcf) (first API proxy service sponsor 🧝🏻‍♀️)
 - Tc (first sponsor)
 - Argolinhas (first ko-fi sponsor ٩(•̤̀ᵕ•̤́๑))
 - r\*r (first anonymous sponsor 🤣)
@@ -939,6 +962,7 @@ A huge thank you to all our sponsors for their generous support!
 - [chamo101](https://github.com/chamo101) (first GitHub issue sponsor 🎉)
 - 初屿贤 (first Codex user sponsor 🙅🏻‍♂️)
 - Protein (first 1688 sponsor 😏)
+- [musistudio](https://github.com/musistudio) (first open source project author sponsor, the author of [CCR](https://github.com/musistudio/claude-code-router) 🤩)
 - [BeatSeat](https://github.com/BeatSeat) (community expert 😎, provided $1000 Claude credits)
 - [wenwen](https://github.com/wenwen12345) (community expert 🤓, provided daily $100 Claude&GPT credits)
 - 16°C coffee (My best friend 🤪, offered ChatGPT Pro $200 package)

package/dist/chunks/api-providers.mjs

@@ -13,6 +13,20 @@ const API_PROVIDER_PRESETS = [
     },
     description: "302.AI API Service"
   },
+  {
+    id: "packycode",
+    name: "PackyCode",
+    supportedCodeTools: ["claude-code", "codex"],
+    claudeCode: {
+      baseUrl: "https://www.packyapi.com",
+      authType: "auth_token"
+    },
+    codex: {
+      baseUrl: "https://www.packyapi.com/v1",
+      wireApi: "responses"
+    },
+    description: "PackyCode API Service"
+  },
   {
     id: "glm",
     name: "GLM",
@@ -49,14 +63,13 @@ const API_PROVIDER_PRESETS = [
     name: "Kimi",
     supportedCodeTools: ["claude-code", "codex"],
     claudeCode: {
-      baseUrl: "https://api.moonshot.cn/anthropic",
-      authType: "auth_token",
-      defaultModels: ["kimi-k2-0905-preview", "kimi-k2-turbo-preview"]
+      baseUrl: "https://api.kimi.com/coding/",
+      authType: "auth_token"
     },
     codex: {
-      baseUrl: "https://api.moonshot.cn/v1",
+      baseUrl: "https://api.kimi.com/coding/v1",
       wireApi: "chat",
-      defaultModel: "kimi-k2-0905-preview"
+      defaultModel: "kimi-for-coding"
     },
     description: "Kimi (Moonshot AI)"
   }

package/dist/chunks/claude-code-incremental-manager.mjs

@@ -103,11 +103,13 @@ ${i18n.t("multi-config:addingNewProfile")}`));
   }]);
   let prefilledBaseUrl;
   let prefilledAuthType;
+  let prefilledDefaultModels;
   if (selectedProvider !== "custom") {
     const provider = providers.find((p) => p.id === selectedProvider);
     if (provider?.claudeCode) {
       prefilledBaseUrl = provider.claudeCode.baseUrl;
       prefilledAuthType = provider.claudeCode.authType;
+      prefilledDefaultModels = provider.claudeCode.defaultModels;
       console.log(ansis.gray(i18n.t("api:providerSelected", { name: provider.name })));
     }
   }
@@ -208,6 +210,13 @@ ${i18n.t("multi-config:addingNewProfile")}`));
     if (modelConfig.fastModel.trim()) {
       profile.fastModel = modelConfig.fastModel.trim();
     }
+  } else if (prefilledDefaultModels?.length) {
+    if (prefilledDefaultModels[0]?.trim()) {
+      profile.primaryModel = prefilledDefaultModels[0].trim();
+    }
+    if (prefilledDefaultModels[1]?.trim()) {
+      profile.fastModel = prefilledDefaultModels[1].trim();
+    }
   }
   const existingProfile = ClaudeCodeConfigManager.getProfileByName(profile.name);
   if (existingProfile) {

package/dist/chunks/simple-config.mjs

@@ -1,4 +1,5 @@
-import { existsSync, readFileSync, mkdirSync, copyFileSync, writeFileSync, rmSync, rmdirSync, readdirSync, statSync, unlinkSync, renameSync } from 'node:fs';
+import * as nodeFs from 'node:fs';
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, rmSync, rmdirSync, readdirSync, statSync, unlinkSync, renameSync } from 'node:fs';
 import process from 'node:process';
 import ansis from 'ansis';
 import inquirer from 'inquirer';
@@ -16,7 +17,7 @@ import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 import i18next from 'i18next';
 import Backend from 'i18next-fs-backend';
 
-const version = "3.3.1";
+const version = "3.3.3";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -523,7 +524,7 @@ function getPlatform() {
   return "linux";
 }
 function isTermux() {
-  return !!(process.env.PREFIX && process.env.PREFIX.includes("com.termux")) || !!process.env.TERMUX_VERSION || existsSync("/data/data/com.termux/files/usr");
+  return !!(process.env.PREFIX && process.env.PREFIX.includes("com.termux")) || !!process.env.TERMUX_VERSION || nodeFs.existsSync("/data/data/com.termux/files/usr");
 }
 function getTermuxPrefix() {
   return process.env.PREFIX || "/data/data/com.termux/files/usr";
@@ -535,16 +536,16 @@ function isWSL() {
   if (process.env.WSL_DISTRO_NAME) {
     return true;
   }
-  if (existsSync("/proc/version")) {
+  if (nodeFs.existsSync("/proc/version")) {
     try {
-      const version = readFileSync("/proc/version", "utf8");
+      const version = nodeFs.readFileSync("/proc/version", "utf8");
       if (version.includes("Microsoft") || version.includes("WSL")) {
         return true;
       }
     } catch {
     }
   }
-  if (existsSync("/mnt/c")) {
+  if (nodeFs.existsSync("/mnt/c")) {
     return true;
   }
   return false;
@@ -553,9 +554,9 @@ function getWSLDistro() {
   if (process.env.WSL_DISTRO_NAME) {
     return process.env.WSL_DISTRO_NAME;
   }
-  if (existsSync("/etc/os-release")) {
+  if (nodeFs.existsSync("/etc/os-release")) {
     try {
-      const osRelease = readFileSync("/etc/os-release", "utf8");
+      const osRelease = nodeFs.readFileSync("/etc/os-release", "utf8");
       const nameMatch = osRelease.match(/^PRETTY_NAME="(.+)"$/m);
       if (nameMatch) {
         return nameMatch[1];
@@ -570,9 +571,9 @@ function getWSLInfo() {
     return null;
   }
   let version = null;
-  if (existsSync("/proc/version")) {
+  if (nodeFs.existsSync("/proc/version")) {
     try {
-      version = readFileSync("/proc/version", "utf8").trim();
+      version = nodeFs.readFileSync("/proc/version", "utf8").trim();
     } catch {
     }
   }
@@ -599,6 +600,71 @@ function getSystemRoot() {
     systemRoot = env.SystemRoot;
   return systemRoot.replace(/\\+/g, "/").replace(/\/+/g, "/");
 }
+function shouldUseSudoForGlobalInstall() {
+  if (isTermux())
+    return false;
+  if (getPlatform() !== "linux")
+    return false;
+  const npmPrefix = getGlobalNpmPrefix();
+  if (npmPrefix) {
+    if (isPathInsideHome(npmPrefix) || canWriteToPath(npmPrefix))
+      return false;
+  }
+  const getuid = process.getuid;
+  if (typeof getuid !== "function")
+    return false;
+  try {
+    return getuid() !== 0;
+  } catch {
+    return false;
+  }
+}
+function wrapCommandWithSudo(command, args) {
+  if (shouldUseSudoForGlobalInstall()) {
+    return {
+      command: "sudo",
+      args: [command, ...args],
+      usedSudo: true
+    };
+  }
+  return {
+    command,
+    args,
+    usedSudo: false
+  };
+}
+const WRITE_CHECK_FLAG = 2;
+function normalizePath(path) {
+  return path.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+function isPathInsideHome(path) {
+  const home = process.env.HOME;
+  if (!home)
+    return false;
+  const normalizedHome = normalizePath(home);
+  const normalizedPath = normalizePath(path);
+  return normalizedPath === normalizedHome || normalizedPath.startsWith(`${normalizedHome}/`);
+}
+function canWriteToPath(path) {
+  try {
+    nodeFs.accessSync(path, WRITE_CHECK_FLAG);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getGlobalNpmPrefix() {
+  const env = process.env;
+  const envPrefix = env.npm_config_prefix || env.NPM_CONFIG_PREFIX || env.PREFIX;
+  if (envPrefix)
+    return envPrefix;
+  const execPath = process.execPath;
+  if (execPath) {
+    const binDir = dirname(execPath);
+    return dirname(binDir);
+  }
+  return null;
+}
 async function commandExists(command) {
   try {
     const cmd = getPlatform() === "windows" ? "where" : "which";
@@ -616,7 +682,7 @@ async function commandExists(command) {
       `/data/data/com.termux/files/usr/bin/${command}`
     ];
     for (const path of possiblePaths) {
-      if (existsSync(path)) {
+      if (nodeFs.existsSync(path)) {
         return true;
       }
     }
@@ -629,7 +695,7 @@ async function commandExists(command) {
       `${process.env.HOME}/.local/bin/${command}`
     ];
     for (const path of commonPaths) {
-      if (existsSync(path)) {
+      if (nodeFs.existsSync(path)) {
         return true;
       }
     }
@@ -1360,11 +1426,6 @@ function switchToOfficialLogin$1() {
       delete vscConfig.primaryApiKey;
       writeJsonConfig(CLAUDE_VSC_CONFIG_FILE, vscConfig);
     }
-    const mcpConfig = readMcpConfig();
-    if (mcpConfig) {
-      delete mcpConfig.hasCompletedOnboarding;
-      writeMcpConfig(mcpConfig);
-    }
     console.log(i18n.t("api:officialLoginConfigured"));
     return true;
   } catch (error) {
@@ -2224,7 +2285,12 @@ async function installCcr() {
   }
   console.log(ansis.cyan(`\u{1F4E6} ${i18n.t("ccr:installingCcr")}`));
   try {
-    await execAsync$1("npm install -g @musistudio/claude-code-router --force");
+    const installArgs = ["install", "-g", "@musistudio/claude-code-router", "--force"];
+    const { command, args, usedSudo } = wrapCommandWithSudo("npm", installArgs);
+    if (usedSudo) {
+      console.log(ansis.yellow(`\u2139 ${i18n.t("installation:usingSudo")}`));
+    }
+    await execAsync$1([command, ...args].join(" "));
     console.log(ansis.green(`\u2714 ${i18n.t("ccr:ccrInstallSuccess")}`));
   } catch (error) {
     if (error.message?.includes("EEXIST")) {
@@ -2943,7 +3009,10 @@ async function executeCodexInstallation(isUpdate) {
   } else {
     console.log(ansis.cyan(i18n.t("codex:installingCli")));
   }
-  const result = await x("npm", ["install", "-g", "@openai/codex"]);
+  const { command, args, usedSudo } = wrapCommandWithSudo("npm", ["install", "-g", "@openai/codex"]);
+  if (usedSudo)
+    console.log(ansis.yellow(i18n.t("codex:usingSudo")));
+  const result = await x(command, args);
   if (result.exitCode !== 0) {
     throw new Error(`Failed to ${action} codex CLI: exit code ${result.exitCode}`);
   }
@@ -3975,7 +4044,10 @@ async function runCodexUpdate(force = false, skipPrompt = false) {
 async function runCodexUninstall() {
   ensureI18nInitialized();
   const { CodexUninstaller } = await import('./codex-uninstaller.mjs');
-  const uninstaller = new CodexUninstaller("en");
+  const zcfConfig = readZcfConfig();
+  const preferredLang = zcfConfig?.preferredLang;
+  const uninstallLang = preferredLang && SUPPORTED_LANGS.includes(preferredLang) ? preferredLang : "en";
+  const uninstaller = new CodexUninstaller(uninstallLang);
   const { mode } = await inquirer.prompt([{
     type: "list",
     name: "mode",
@@ -4289,12 +4361,20 @@ async function isCometixLineInstalled() {
 }
 async function installCometixLine() {
   ensureI18nInitialized();
+  const runInstallCommand = async () => {
+    const installArgs = ["install", "-g", COMETIX_PACKAGE_NAME];
+    const { command, args, usedSudo } = wrapCommandWithSudo("npm", installArgs);
+    if (usedSudo) {
+      console.log(ansis.yellow(`\u2139 ${i18n.t("installation:usingSudo")}`));
+    }
+    await execAsync([command, ...args].join(" "));
+  };
   const isInstalled = await isCometixLineInstalled();
   if (isInstalled) {
     console.log(ansis.green(`\u2714 ${i18n.t("cometix:cometixAlreadyInstalled")}`));
     try {
       console.log(ansis.blue(`${i18n.t("cometix:installingOrUpdating")}`));
-      await execAsync(COMETIX_COMMANDS.INSTALL);
+      await runInstallCommand();
       console.log(ansis.green(`\u2714 ${i18n.t("cometix:installUpdateSuccess")}`));
     } catch (error) {
       console.log(ansis.yellow(`\u26A0 ${i18n.t("cometix:installUpdateFailed")}: ${error}`));
@@ -4313,7 +4393,7 @@ async function installCometixLine() {
   }
   try {
     console.log(ansis.blue(`${i18n.t("cometix:installingCometix")}`));
-    await execAsync(COMETIX_COMMANDS.INSTALL);
+    await runInstallCommand();
     console.log(ansis.green(`\u2714 ${i18n.t("cometix:cometixInstallSuccess")}`));
     try {
       addCCometixLineConfig();
@@ -4794,7 +4874,11 @@ async function installClaudeCode() {
   }
   console.log(i18n.t("installation:installing"));
   try {
-    await exec("npm", ["install", "-g", "@anthropic-ai/claude-code"]);
+    const { command, args, usedSudo } = wrapCommandWithSudo("npm", ["install", "-g", "@anthropic-ai/claude-code"]);
+    if (usedSudo) {
+      console.log(ansis.yellow(`\u2139 ${i18n.t("installation:usingSudo")}`));
+    }
+    await exec(command, args);
     console.log(`\u2714 ${i18n.t("installation:installSuccess")}`);
     await setInstallMethod("npm");
     if (isTermux()) {

package/dist/i18n/locales/en/codex.json

@@ -1,6 +1,7 @@
 {
   "installingCli": "🚀 Installing Codex CLI...",
   "installSuccess": "✔ Codex CLI installed",
+  "usingSudo": "⚠️ Detected non-root Linux user. Using sudo for Codex CLI installation (password prompt may appear).",
   "alreadyInstalled": "⚠️ Codex CLI already installed, skipping installation",
   "updatingCli": "🔄 Updating Codex CLI...",
   "updateSuccess": "✔ Codex CLI updated",

package/dist/i18n/locales/en/installation.json

@@ -4,6 +4,7 @@
   "installPrompt": "Claude Code not found. Install automatically?",
   "installSuccess": "Claude Code installed successfully",
   "installing": "Installing Claude Code...",
+  "usingSudo": "Detected non-root Linux user. Elevating with sudo for global installation (password prompt may appear).",
   "termuxDetected": "Termux environment detected",
   "termuxEnvironmentInfo": "Termux environment provides Node.js and npm through pkg manager",
   "termuxInstallHint": "In Termux, please run first: pkg install nodejs or pkg install nodejs-lts",

package/dist/i18n/locales/zh-CN/codex.json

@@ -1,6 +1,7 @@
 {
   "installingCli": "🚀 正在安装 Codex CLI...",
   "installSuccess": "✔ Codex CLI 安装完成",
+  "usingSudo": "⚠️ 检测到 Linux 非 root 用户，正在使用 sudo 安装 Codex CLI（可能需要输入密码）。",
   "alreadyInstalled": "⚠️ Codex CLI 已安装，跳过安装步骤",
   "updatingCli": "🔄 正在更新 Codex CLI...",
   "updateSuccess": "✔ Codex CLI 更新完成",

package/dist/i18n/locales/zh-CN/installation.json

@@ -4,6 +4,7 @@
   "installPrompt": "检测到 Claude Code 未安装，是否自动安装？",
   "installSuccess": "Claude Code 安装成功",
   "installing": "正在安装 Claude Code...",
+  "usingSudo": "检测到 Linux 非 root 用户，正在使用 sudo 提升权限进行全局安装（可能需要输入密码）。",
   "termuxDetected": "检测到 Termux 环境",
   "termuxEnvironmentInfo": "Termux 环境通过 pkg 管理器提供 Node.js 和 npm",
   "termuxInstallHint": "在 Termux 中，请先运行: pkg install nodejs 或 pkg install nodejs-lts",

package/dist/index.d.mts

@@ -173,7 +173,6 @@ declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | strin
  * Switch to official login mode - remove all third-party API configurations
  * Removes: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY from settings.json
  * Removes: primaryApiKey from ~/.claude/config.json
- * Removes: hasCompletedOnboarding from ~/.claude.json
  */
 declare function switchToOfficialLogin(): boolean;
 /**

package/dist/index.d.ts

@@ -173,7 +173,6 @@ declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | strin
  * Switch to official login mode - remove all third-party API configurations
  * Removes: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY from settings.json
  * Removes: primaryApiKey from ~/.claude/config.json
- * Removes: hasCompletedOnboarding from ~/.claude.json
  */
 declare function switchToOfficialLogin(): boolean;
 /**

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.3.1",
-  "description": "Zero-Config Code Flow - One-click configuration tool for Claude Code",
+  "version": "3.3.3",
+  "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
   "author": {
     "name": "Miao Da",
     "email": "ufo025174@gmail.com",
@@ -18,12 +18,15 @@
   "keywords": [
     "claude",
     "claude-code",
+    "codex",
     "config",
     "cli",
     "setup",
     "zero-config",
     "zcf",
     "anthropic",
+    "openai",
+    "ChatGPT",
     "ai",
     "automation",
     "mcp"
@@ -99,6 +102,9 @@
     "update:deps": "pnpx taze major -r -w",
     "release": "pnpm build && changeset publish",
     "commitlint": "commitlint",
-    "commitlint:check": "commitlint --from HEAD~1 --to HEAD --verbose"
+    "commitlint:check": "commitlint --from HEAD~1 --to HEAD --verbose",
+    "docs:dev": "pnpm -F @zcf/docs dev",
+    "docs:build": "pnpm -F @zcf/docs build",
+    "docs:preview": "pnpm -F @zcf/docs preview"
   }
 }