ccgx-workflow 1.0.0 → 1.0.2

package/templates/skills/domains/development/rust.md

@@ -1,313 +1,313 @@
----
-name: rust
-description: Rust 开发。系统编程、内存安全、高性能、WebAssembly。当用户提到 Rust、Cargo、tokio、内存安全时使用。
----
-
-# 📜 符箓秘典 · Rust
-
-
-## 基础语法
-
-### 所有权系统
-```rust
-fn main() {
-    // 所有权转移
-    let s1 = String::from("hello");
-    let s2 = s1;  // s1 不再有效
-    // println!("{}", s1);  // 编译错误
-
-    // 借用
-    let s3 = String::from("world");
-    let len = calculate_length(&s3);  // 借用
-    println!("{} has length {}", s3, len);  // s3 仍有效
-
-    // 可变借用
-    let mut s4 = String::from("hello");
-    change(&mut s4);
-}
-
-fn calculate_length(s: &String) -> usize {
-    s.len()
-}
-
-fn change(s: &mut String) {
-    s.push_str(", world");
-}
-```
-
-### 结构体与枚举
-```rust
-// 结构体
-struct User {
-    name: String,
-    email: String,
-    active: bool,
-}
-
-impl User {
-    fn new(name: String, email: String) -> Self {
-        Self { name, email, active: true }
-    }
-
-    fn deactivate(&mut self) {
-        self.active = false;
-    }
-}
-
-// 枚举
-enum Result<T, E> {
-    Ok(T),
-    Err(E),
-}
-
-enum Message {
-    Quit,
-    Move { x: i32, y: i32 },
-    Write(String),
-}
-
-// 模式匹配
-fn handle_message(msg: Message) {
-    match msg {
-        Message::Quit => println!("Quit"),
-        Message::Move { x, y } => println!("Move to ({}, {})", x, y),
-        Message::Write(text) => println!("Write: {}", text),
-    }
-}
-```
-
-### 错误处理
-```rust
-use std::fs::File;
-use std::io::{self, Read};
-
-// Result 处理
-fn read_file(path: &str) -> Result<String, io::Error> {
-    let mut file = File::open(path)?;  // ? 操作符
-    let mut contents = String::new();
-    file.read_to_string(&mut contents)?;
-    Ok(contents)
-}
-
-// 自定义错误
-#[derive(Debug)]
-enum AppError {
-    IoError(io::Error),
-    ParseError(String),
-}
-
-impl From<io::Error> for AppError {
-    fn from(err: io::Error) -> Self {
-        AppError::IoError(err)
-    }
-}
-```
-
-## 异步编程
-
-### Tokio
-```rust
-use tokio;
-
-#[tokio::main]
-async fn main() {
-    let result = fetch_data().await;
-    println!("{:?}", result);
-}
-
-async fn fetch_data() -> Result<String, reqwest::Error> {
-    let resp = reqwest::get("https://api.example.com/data")
-        .await?
-        .text()
-        .await?;
-    Ok(resp)
-}
-
-// 并发执行
-async fn fetch_all(urls: Vec<&str>) -> Vec<String> {
-    let futures: Vec<_> = urls.iter()
-        .map(|url| fetch_url(url))
-        .collect();
-
-    futures::future::join_all(futures).await
-}
-
-// Channel
-use tokio::sync::mpsc;
-
-async fn channel_example() {
-    let (tx, mut rx) = mpsc::channel(32);
-
-    tokio::spawn(async move {
-        tx.send("hello").await.unwrap();
-    });
-
-    while let Some(msg) = rx.recv().await {
-        println!("Received: {}", msg);
-    }
-}
-```
-
-## Web 框架
-
-### Axum
-```rust
-use axum::{
-    routing::{get, post},
-    Router, Json, extract::Path,
-};
-use serde::{Deserialize, Serialize};
-
-#[derive(Serialize, Deserialize)]
-struct User {
-    id: u64,
-    name: String,
-}
-
-async fn get_user(Path(id): Path<u64>) -> Json<User> {
-    Json(User { id, name: "Alice".to_string() })
-}
-
-async fn create_user(Json(user): Json<User>) -> Json<User> {
-    Json(user)
-}
-
-#[tokio::main]
-async fn main() {
-    let app = Router::new()
-        .route("/users/:id", get(get_user))
-        .route("/users", post(create_user));
-
-    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
-        .serve(app.into_make_service())
-        .await
-        .unwrap();
-}
-```
-
-### Actix-web
-```rust
-use actix_web::{web, App, HttpServer, HttpResponse};
-
-async fn get_user(path: web::Path<u64>) -> HttpResponse {
-    HttpResponse::Ok().json(User { id: *path, name: "Alice".to_string() })
-}
-
-#[actix_web::main]
-async fn main() -> std::io::Result<()> {
-    HttpServer::new(|| {
-        App::new()
-            .route("/users/{id}", web::get().to(get_user))
-    })
-    .bind("127.0.0.1:8080")?
-    .run()
-    .await
-}
-```
-
-## CLI 工具
-
-### Clap
-```rust
-use clap::{Parser, Subcommand};
-
-#[derive(Parser)]
-#[command(name = "myapp")]
-#[command(about = "My CLI application")]
-struct Cli {
-    #[command(subcommand)]
-    command: Commands,
-}
-
-#[derive(Subcommand)]
-enum Commands {
-    /// Start the server
-    Serve {
-        #[arg(short, long, default_value = "8080")]
-        port: u16,
-    },
-    /// Run a task
-    Run {
-        #[arg(short, long)]
-        name: String,
-    },
-}
-
-fn main() {
-    let cli = Cli::parse();
-
-    match cli.command {
-        Commands::Serve { port } => {
-            println!("Starting server on port {}", port);
-        }
-        Commands::Run { name } => {
-            println!("Running task: {}", name);
-        }
-    }
-}
-```
-
-## 测试
-
-```rust
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_add() {
-        assert_eq!(add(1, 2), 3);
-    }
-
-    #[test]
-    #[should_panic(expected = "divide by zero")]
-    fn test_divide_by_zero() {
-        divide(1, 0);
-    }
-
-    #[tokio::test]
-    async fn test_async_fetch() {
-        let result = fetch_data().await;
-        assert!(result.is_ok());
-    }
-}
-```
-
-```bash
-cargo test
-cargo test --release
-cargo test -- --nocapture  # 显示输出
-```
-
-## 项目结构
-
-```
-myproject/
-├── Cargo.toml
-├── src/
-│   ├── main.rs
-│   ├── lib.rs
-│   ├── models/
-│   │   └── mod.rs
-│   └── utils/
-│       └── mod.rs
-├── tests/
-│   └── integration_test.rs
-└── benches/
-    └── benchmark.rs
-```
-
-## 常用库
-
-| 库 | 用途 |
-|---|------|
-| tokio | 异步运行时 |
-| axum/actix-web | Web 框架 |
-| serde | 序列化 |
-| reqwest | HTTP 客户端 |
-| sqlx | 数据库 |
-| clap | CLI |
-| tracing | 日志 |
-
----
-
+---
+name: rust
+description: Rust 开发。系统编程、内存安全、高性能、WebAssembly。当用户提到 Rust、Cargo、tokio、内存安全时使用。
+---
+
+# 📜 符箓秘典 · Rust
+
+
+## 基础语法
+
+### 所有权系统
+```rust
+fn main() {
+    // 所有权转移
+    let s1 = String::from("hello");
+    let s2 = s1;  // s1 不再有效
+    // println!("{}", s1);  // 编译错误
+
+    // 借用
+    let s3 = String::from("world");
+    let len = calculate_length(&s3);  // 借用
+    println!("{} has length {}", s3, len);  // s3 仍有效
+
+    // 可变借用
+    let mut s4 = String::from("hello");
+    change(&mut s4);
+}
+
+fn calculate_length(s: &String) -> usize {
+    s.len()
+}
+
+fn change(s: &mut String) {
+    s.push_str(", world");
+}
+```
+
+### 结构体与枚举
+```rust
+// 结构体
+struct User {
+    name: String,
+    email: String,
+    active: bool,
+}
+
+impl User {
+    fn new(name: String, email: String) -> Self {
+        Self { name, email, active: true }
+    }
+
+    fn deactivate(&mut self) {
+        self.active = false;
+    }
+}
+
+// 枚举
+enum Result<T, E> {
+    Ok(T),
+    Err(E),
+}
+
+enum Message {
+    Quit,
+    Move { x: i32, y: i32 },
+    Write(String),
+}
+
+// 模式匹配
+fn handle_message(msg: Message) {
+    match msg {
+        Message::Quit => println!("Quit"),
+        Message::Move { x, y } => println!("Move to ({}, {})", x, y),
+        Message::Write(text) => println!("Write: {}", text),
+    }
+}
+```
+
+### 错误处理
+```rust
+use std::fs::File;
+use std::io::{self, Read};
+
+// Result 处理
+fn read_file(path: &str) -> Result<String, io::Error> {
+    let mut file = File::open(path)?;  // ? 操作符
+    let mut contents = String::new();
+    file.read_to_string(&mut contents)?;
+    Ok(contents)
+}
+
+// 自定义错误
+#[derive(Debug)]
+enum AppError {
+    IoError(io::Error),
+    ParseError(String),
+}
+
+impl From<io::Error> for AppError {
+    fn from(err: io::Error) -> Self {
+        AppError::IoError(err)
+    }
+}
+```
+
+## 异步编程
+
+### Tokio
+```rust
+use tokio;
+
+#[tokio::main]
+async fn main() {
+    let result = fetch_data().await;
+    println!("{:?}", result);
+}
+
+async fn fetch_data() -> Result<String, reqwest::Error> {
+    let resp = reqwest::get("https://api.example.com/data")
+        .await?
+        .text()
+        .await?;
+    Ok(resp)
+}
+
+// 并发执行
+async fn fetch_all(urls: Vec<&str>) -> Vec<String> {
+    let futures: Vec<_> = urls.iter()
+        .map(|url| fetch_url(url))
+        .collect();
+
+    futures::future::join_all(futures).await
+}
+
+// Channel
+use tokio::sync::mpsc;
+
+async fn channel_example() {
+    let (tx, mut rx) = mpsc::channel(32);
+
+    tokio::spawn(async move {
+        tx.send("hello").await.unwrap();
+    });
+
+    while let Some(msg) = rx.recv().await {
+        println!("Received: {}", msg);
+    }
+}
+```
+
+## Web 框架
+
+### Axum
+```rust
+use axum::{
+    routing::{get, post},
+    Router, Json, extract::Path,
+};
+use serde::{Deserialize, Serialize};
+
+#[derive(Serialize, Deserialize)]
+struct User {
+    id: u64,
+    name: String,
+}
+
+async fn get_user(Path(id): Path<u64>) -> Json<User> {
+    Json(User { id, name: "Alice".to_string() })
+}
+
+async fn create_user(Json(user): Json<User>) -> Json<User> {
+    Json(user)
+}
+
+#[tokio::main]
+async fn main() {
+    let app = Router::new()
+        .route("/users/:id", get(get_user))
+        .route("/users", post(create_user));
+
+    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
+        .serve(app.into_make_service())
+        .await
+        .unwrap();
+}
+```
+
+### Actix-web
+```rust
+use actix_web::{web, App, HttpServer, HttpResponse};
+
+async fn get_user(path: web::Path<u64>) -> HttpResponse {
+    HttpResponse::Ok().json(User { id: *path, name: "Alice".to_string() })
+}
+
+#[actix_web::main]
+async fn main() -> std::io::Result<()> {
+    HttpServer::new(|| {
+        App::new()
+            .route("/users/{id}", web::get().to(get_user))
+    })
+    .bind("127.0.0.1:8080")?
+    .run()
+    .await
+}
+```
+
+## CLI 工具
+
+### Clap
+```rust
+use clap::{Parser, Subcommand};
+
+#[derive(Parser)]
+#[command(name = "myapp")]
+#[command(about = "My CLI application")]
+struct Cli {
+    #[command(subcommand)]
+    command: Commands,
+}
+
+#[derive(Subcommand)]
+enum Commands {
+    /// Start the server
+    Serve {
+        #[arg(short, long, default_value = "8080")]
+        port: u16,
+    },
+    /// Run a task
+    Run {
+        #[arg(short, long)]
+        name: String,
+    },
+}
+
+fn main() {
+    let cli = Cli::parse();
+
+    match cli.command {
+        Commands::Serve { port } => {
+            println!("Starting server on port {}", port);
+        }
+        Commands::Run { name } => {
+            println!("Running task: {}", name);
+        }
+    }
+}
+```
+
+## 测试
+
+```rust
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_add() {
+        assert_eq!(add(1, 2), 3);
+    }
+
+    #[test]
+    #[should_panic(expected = "divide by zero")]
+    fn test_divide_by_zero() {
+        divide(1, 0);
+    }
+
+    #[tokio::test]
+    async fn test_async_fetch() {
+        let result = fetch_data().await;
+        assert!(result.is_ok());
+    }
+}
+```
+
+```bash
+cargo test
+cargo test --release
+cargo test -- --nocapture  # 显示输出
+```
+
+## 项目结构
+
+```
+myproject/
+├── Cargo.toml
+├── src/
+│   ├── main.rs
+│   ├── lib.rs
+│   ├── models/
+│   │   └── mod.rs
+│   └── utils/
+│       └── mod.rs
+├── tests/
+│   └── integration_test.rs
+└── benches/
+    └── benchmark.rs
+```
+
+## 常用库
+
+| 库 | 用途 |
+|---|------|
+| tokio | 异步运行时 |
+| axum/actix-web | Web 框架 |
+| serde | 序列化 |
+| reqwest | HTTP 客户端 |
+| sqlx | 数据库 |
+| clap | CLI |
+| tracing | 日志 |
+
+---
+