From 5ac01d0f4a5431766c6afca4651c51abc5492d08 Mon Sep 17 00:00:00 2001
From: Tw93 <tw93@qq.com>
Date: Sun, 16 Nov 2025 19:56:17 +0800
Subject: [PATCH] update faq

---
 CONTRIBUTING.md |  2 +-
 README.md       |  2 +-
 docs/faq.md     | 50 +++++++++++++++++++++++++++++++++++++++++++++++++
 docs/faq_CN.md  | 50 +++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 102 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index db9a9ff..ace09a8 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,7 +22,7 @@ graph LR
 ### Prerequisites
 
 - Node.js ≥22.0.0 (recommended LTS, older versions ≥16.0.0 may work)
-- Rust ≥1.89.0 (recommended stable, older versions ≥1.78.0 may work)
+- Rust ≥1.85.0 (required for edition2024 support in dependencies)
 - Platform-specific build tools:
   - **macOS**: Xcode Command Line Tools (`xcode-select --install`)
   - **Windows**: Visual Studio Build Tools with MSVC
diff --git a/README.md b/README.md
index aef7a74..e416fca 100644
--- a/README.md
+++ b/README.md
@@ -173,7 +173,7 @@ First-time packaging requires environment setup and may be slower, subsequent bu
 
 ## Development
 
-Requires Rust `>=1.89` and Node `>=22`. For detailed installation guide, see [Tauri documentation](https://tauri.app/start/prerequisites/). If unfamiliar with development environment, use the CLI tool instead.
+Requires Rust `>=1.85` and Node `>=22`. For detailed installation guide, see [Tauri documentation](https://tauri.app/start/prerequisites/). If unfamiliar with development environment, use the CLI tool instead.
 
 ```bash
 # Install dependencies
diff --git a/docs/faq.md b/docs/faq.md
index 8f3b940..221fa26 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -6,6 +6,56 @@ Common issues and solutions when using Pake.
 
 ## Build Issues
 
+### Rust Version Error: "feature 'edition2024' is required"
+
+**Problem:**
+When building Pake or using the CLI, you encounter an error like:
+
+```txt
+error: failed to parse manifest
+Caused by:
+  feature `edition2024` is required
+  this Cargo does not support nightly features, but if you switch to nightly channel you can add `cargo-features = ["edition2024"]`
+  to enable this feature
+```
+
+**Why This Happens:**
+
+Pake's dependencies require Rust edition2024 support, which is only available in Rust 1.85.0 or later. Specifically:
+
+- The dependency chain includes: `tauri` → `image` → `moxcms` → `pxfm v0.1.25` (requires edition2024)
+- Rust edition2024 became stable in Rust 1.85.0 (released February 2025)
+- If your Rust version is older (e.g., 1.82.0 from August 2024), you'll see this error
+
+**Solution:**
+
+Update your Rust toolchain to version 1.85.0 or later:
+
+```bash
+# Update to the latest stable Rust version
+rustup update stable
+
+# Or install the latest stable version
+rustup install stable
+
+# Verify the update
+rustc --version
+# Should show: rustc 1.85.0 or higher
+```
+
+After updating, retry your build command.
+
+**For Development Setup:**
+
+If you're setting up a development environment, ensure:
+
+- Rust ≥1.85.0 (check with `rustc --version`)
+- Node.js ≥22.0.0 (check with `node --version`)
+
+See [CONTRIBUTING.md](../CONTRIBUTING.md) for complete prerequisites.
+
+---
+
 ### Windows: Installation Timeout During First Build
 
 **Problem:**
diff --git a/docs/faq_CN.md b/docs/faq_CN.md
index fc3c960..7ecb866 100644
--- a/docs/faq_CN.md
+++ b/docs/faq_CN.md
@@ -6,6 +6,56 @@
 
 ## 构建问题
 
+### Rust 版本错误："feature 'edition2024' is required"
+
+**问题描述：**
+在构建 Pake 或使用 CLI 时，遇到如下错误：
+
+```txt
+error: failed to parse manifest
+Caused by:
+  feature `edition2024` is required
+  this Cargo does not support nightly features, but if you switch to nightly channel you can add `cargo-features = ["edition2024"]`
+  to enable this feature
+```
+
+**原因分析：**
+
+Pake 的依赖项需要 Rust edition2024 支持，该特性仅在 Rust 1.85.0 或更高版本中可用。具体来说：
+
+- 依赖链包括：`tauri` → `image` → `moxcms` → `pxfm v0.1.25`（需要 edition2024）
+- Rust edition2024 在 Rust 1.85.0（2025 年 2 月发布）中成为稳定版
+- 如果您的 Rust 版本较旧（例如 2024 年 8 月的 1.82.0），就会看到此错误
+
+**解决方案：**
+
+将 Rust 工具链更新到 1.85.0 或更高版本：
+
+```bash
+# 更新到最新稳定版 Rust
+rustup update stable
+
+# 或者安装最新稳定版
+rustup install stable
+
+# 验证更新
+rustc --version
+# 应显示：rustc 1.85.0 或更高版本
+```
+
+更新后，重新执行构建命令。
+
+**对于开发环境设置：**
+
+如果您正在设置开发环境，请确保：
+
+- Rust ≥1.85.0（使用 `rustc --version` 检查）
+- Node.js ≥22.0.0（使用 `node --version` 检查）
+
+详见 [CONTRIBUTING.md](../CONTRIBUTING.md) 获取完整的前置条件。
+
+---
+
 ### Windows：首次构建时安装超时
 
 **问题描述：**