diff --git a/.gitignore b/.gitignore
index 150ad6b..beff570 100644
--- a/.gitignore
+++ b/.gitignore
@@ -46,3 +46,4 @@ __pycache__/
 *.py[cod]
 .venv/
 venv/
+.env
diff --git a/README.md b/README.md
index eceb767..daa160d 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 | 目录 | 说明 |
 |------|------|
 | [`java/`](java/) | Maven 多模块：`craftlabs-auth-core`、`craftlabs-auth-bitanswer`、`craftlabs-auth-selfhosted`、`craftlabs-auth-tests` |
-| [`native/`](native/) | CMake：`libcraftlabs_auth_bitanswer`（JNI + 比特/自研适配占位） |
+| [`native/`](native/) | **Rust Cargo workspace**：`craft-core` cdylib 导出 `craft_*` C ABI（对齐 `docs/平台架构思路.md`）；旧 C++ CMake 见 `.deprecated-cmake/` |
 | [`schemas/`](schemas/) | `craftlabs-auth-config` JSON Schema |
 | [`examples/`](examples/) | 示例配置与烟测脚本 |
 | [`docs/`](docs/) | 比特对接、创飞平台产品/流程/工程架构文档 |
@@ -21,9 +21,9 @@
 # Java（需 JDK 17+）
 mvn -f java/pom.xml verify
 
-# Native（需 CMake、C++、可选 JDK 用于 JNI）
-cmake -S native -B native/build -DCRAFTLABS_BUILD_JNI=ON
-cmake --build native/build
+# Rust 核心库（需 Rust 1.70+）
+cargo build --manifest-path native/craft-core/Cargo.toml --release
+# 产物：native/target/release/libcraftlabs_auth_bitanswer.{so,dylib,dll}
 ```
 
 ## 发布与完整性（SHA-256 / GPG）