Compare commits

...

10 Commits

Author SHA1 Message Date
macrocc bf7e0f5dc0 feat(版本更新): 1. 将 minicpm-convert、minicpm-core 和 minicpm-inference 的版本更新至 0.2.0 2. 更新 README 文件以反映新版本信息 2026-07-08 15:27:48 +08:00
macrocc 564b1e4a09 feat(转换工具): 1. 更新依赖库 burn,启用 wgpu、fusion 和 autotune 特性 2. 修改主程序以使用 Wgpu 设备进行模型转换 3. 更新输出信息以反映 GPU 加速 2026-07-08 15:22:00 +08:00
macrocc e235edee4a feat(转换工具): 1. 添加模型转换示例 2. 更新 Cargo.toml 文件以包含新依赖 3. 删除过时的模型指南文档 4. 更新 README 文件以反映项目结构和使用说明 2026-07-08 15:13:57 +08:00
macrocc 3f952c5fe9 chore(代码变更): 1. 清理无用代码 2. 更新依赖库 3. 优化项目结构 4. 修复小型bug 5. 增加注释以提高可读性 2026-07-08 15:07:21 +08:00
macrocc d88afb5fe7 chore(代码变更): 1. 清理无用代码 2. 更新依赖库 3. 优化项目结构 4. 修复小型bug 5. 增加注释以提高可读性 2026-07-08 10:44:32 +08:00
macrocc 4b342ef62f feat(crates): 升级 minicpm 相关包版本到 0.1.2 2026-07-01 17:54:56 +08:00
macrocc faeeaf7409 feat(inference): 添加流式输出功能,支持实时解码文本 2026-07-01 17:54:18 +08:00
macrocc 18a5ca103c feat(crates): 升级 minicpm crates 版本到 0.1.1 并调整依赖 2026-07-01 16:23:03 +08:00
macrocc ccf362aa8a feat(crates): 发布 minicpm crates 到 Gitea Cargo Registry 2026-07-01 15:45:58 +08:00
macrocc 69b37ced07 refactor(项目结构) 重构为 workspace 多成员项目
- 将项目拆分为三个 crate:minicpm-core(核心模型)、minicpm-convert(转换功能)、minicpm-inference(推理功能)
- 添加两个示例:minimal-inference(最小推理)和 convert(模型转换)
- 转换后自动拷贝 config.json 和 tokenizer.json 到 model 目录
- 更新 README 说明 workspace 结构和使用方式
2026-07-01 14:33:28 +08:00
41 changed files with 655251 additions and 2431 deletions
+35
View File
@@ -0,0 +1,35 @@
# 2026-07-01
## 发布 minicpm crates 到 Gitea Cargo Registry
- 修改了三个 crate 的 `Cargo.toml`:添加 `publish = ["gitea"]`,并为 `minicpm-convert``minicpm-inference``minicpm-core` 依赖添加 `version = "0.1.0", registry = "gitea"`
- Gitea registry: `sparse+http://macrocc.com:3000/api/packages/macrocc/cargo/`registry 名称为 `gitea`
- `minicpm-core@0.1.0` 已存在于 registry,跳过发布
- `minicpm-convert@0.1.0` 发布成功
- `minicpm-inference@0.1.0` 发布成功
## burn 最小依赖 + 重发布 (0.1.1)
- burn 改为 `default-features = false, features = ["std"]`,移除 `wgpu`wgpu 交给下游 binary 选择)
- 三个 crate 版本升级到 0.1.1convert/inference 的 minicpm-core 依赖也更新到 0.1.1
- 发布顺序:`cargo publish --allow-dirty --registry gitea -p minicpm-core``minicpm-convert``minicpm-inference`
- 全部发布成功
## 添加流式输出
- `minicpm-inference/src/lib.rs`: 新增 `generate_stream` 函数和 `MiniCPM::generate_stream` 方法,每 token 通过回调 `impl FnMut(&str)` 输出解码文本
- `examples/minimal-inference/src/main.rs`: 改为流式调用,`print!` + `flush` 实时输出
## 升级 0.1.2 重新发布(含流式功能)
- minicpm-core, minicpm-convert, minicpm-inference 全部升级到 0.1.2
- 发布全部成功
## Q8 量化导出和加载
- `minicpm-convert`: 新增 `export_model_q8`2D 权重 per-tensor INT8 量化(scale = max(|f|)/127),1D norm 权重存 F16;输出 `model.q8.json` + `model.q8.bin`
- `minicpm-inference`: 新增 `MiniCPM::load_q8`,加载 Q8 模型并在内存中反量化为 f32 推理;新增依赖 `memmap2``serde``serde_json`
- `examples/convert`: 支持 Q8 导出
- `examples/minimal-inference`: 支持 `--full|--half|--q8` 三种模式
- 量化方式:`q = clamp(round(f / scale), -127, 127)``f' = q * scale`
Generated
+115 -1742
View File
File diff suppressed because it is too large Load Diff
+13 -23
View File
@@ -1,24 +1,14 @@
[package] [workspace]
name = "minicpm-burn" members = [
version = "0.1.0" "crates/minicpm-core",
edition = "2021" "crates/minicpm-convert",
"crates/minicpm-inference",
"examples/convert",
"examples/wgpu-backend",
]
resolver = "2"
[lib] [profile.release]
name = "minicpm_burn_lib" opt-level = 3
path = "src/lib.rs" lto = true
codegen-units = 1
[[bin]]
name = "minicpm-burn"
path = "src/main.rs"
[dependencies]
burn = { version = "0.21", features = ["std", "wgpu"] }
tokenizers = "0.20"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
rand = "0.8"
memmap2 = "0.9"
clap = { version = "4.5", features = ["derive"] }
[dev-dependencies]
+13
View File
@@ -0,0 +1,13 @@
[package]
name = "minicpm-convert"
version = "0.2.0"
edition = "2021"
publish = ["gitea"]
[dependencies]
minicpm-core = { path = "../minicpm-core", version = "0.2.0", registry = "gitea" }
burn = { version = "0.21", default-features = false, features = ["std"] }
memmap2 = "0.9"
anyhow = "1.0"
serde_json = "1.0"
serde = { version = "1.0", features = ["derive"] }
+31
View File
@@ -0,0 +1,31 @@
use burn::module::Module;
use burn::record::{FullPrecisionSettings, NamedMpkFileRecorder};
use burn::tensor::backend::Backend;
use std::path::Path;
use crate::loader::{load_into_model, TensorStore};
use minicpm_core::config::LlamaConfig;
use minicpm_core::model::LlamaForCausalLM;
/// 导出全精度模型(f32
pub fn export<B: Backend>(
store: &TensorStore,
config: &LlamaConfig,
output_dir: &Path,
device: &B::Device,
) -> anyhow::Result<()> {
println!("创建模型结构...");
let model = LlamaForCausalLM::<B>::new(config.clone(), device);
println!("加载 safetensors 权重...");
let model = load_into_model(model, store, device);
println!("保存为 MPK 格式(全精度)...");
std::fs::create_dir_all(output_dir)?;
let output_path = output_dir.join("model");
let recorder = NamedMpkFileRecorder::<FullPrecisionSettings>::new();
model.save_file(&output_path, &recorder)?;
println!("全精度模型已导出到: {:?}", output_dir);
Ok(())
}
+44
View File
@@ -0,0 +1,44 @@
pub mod full;
/// 导出格式
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Format {
/// 全精度 f32
Full,
}
impl Format {
pub fn name(&self) -> &'static str {
match self {
Format::Full => "全精度",
}
}
pub fn dir_name(&self) -> &'static str {
match self {
Format::Full => "model",
}
}
}
/// 导出任务配置
pub struct ExportTask {
pub format: Format,
pub output_dir: String,
}
impl ExportTask {
pub fn new(format: Format) -> Self {
Self {
output_dir: format.dir_name().to_string(),
format,
}
}
pub fn with_dir(format: Format, output_dir: impl Into<String>) -> Self {
Self {
output_dir: output_dir.into(),
format,
}
}
}
+46
View File
@@ -0,0 +1,46 @@
pub mod format;
pub mod loader;
pub mod utils;
pub use format::{ExportTask, Format};
pub use loader::TensorStore;
use burn::tensor::backend::Backend;
use std::path::Path;
use minicpm_core::config::LlamaConfig;
/// 执行导出任务
pub fn run_export<B: Backend>(
safetensors_path: &Path,
config_path: &Path,
tokenizer_path: &Path,
tasks: &[ExportTask],
device: &B::Device,
) -> anyhow::Result<()> {
println!("开始转换 MiniCPM 模型...");
println!("源文件: {:?}", safetensors_path);
println!("加载配置文件...");
let config = LlamaConfig::from_json(config_path.to_str().unwrap())?;
println!("解析 safetensors 文件...");
let store = TensorStore::from_file(safetensors_path)?;
for task in tasks {
println!("\n--- 导出 {} ---", task.format.name());
let output_dir = Path::new(&task.output_dir);
match task.format {
Format::Full => {
format::full::export::<B>(&store, &config, output_dir, device)?;
}
}
std::fs::copy(config_path, output_dir.join("config.json"))?;
std::fs::copy(tokenizer_path, output_dir.join("tokenizer.json"))?;
}
println!("\n所有导出任务完成!");
Ok(())
}
+3
View File
@@ -0,0 +1,3 @@
pub mod safetensors;
pub use safetensors::{load_into_model, TensorStore};
@@ -0,0 +1,185 @@
use burn::module::{Module, Param};
use burn::nn::{EmbeddingRecord, LinearRecord};
use burn::tensor::backend::Backend;
use burn::tensor::{Float, Shape, Tensor, TensorData};
use memmap2::Mmap;
use std::collections::HashMap;
use std::path::Path;
use crate::utils::convert_to_f32;
use minicpm_core::model::LlamaForCausalLM;
/// 从 safetensors 文件解析出的张量数据
pub struct TensorStore {
tensors: HashMap<String, Vec<u8>>,
shapes: HashMap<String, Vec<usize>>,
dtypes: HashMap<String, String>,
}
impl TensorStore {
/// 从 safetensors 文件加载所有张量
pub fn from_file(path: &Path) -> anyhow::Result<Self> {
let file = std::fs::File::open(path)?;
let mmap = unsafe { Mmap::map(&file)? };
let header_len = u64::from_le_bytes(mmap[..8].try_into().unwrap()) as usize;
let header_bytes = &mmap[8..8 + header_len];
let header: serde_json::Value = serde_json::from_slice(header_bytes)?;
let mut tensors = HashMap::new();
let mut shapes = HashMap::new();
let mut dtypes = HashMap::new();
let data_offset = 8 + header_len;
if let Some(obj) = header.as_object() {
for (name, info) in obj {
if name == "__metadata__" {
continue;
}
if let Some(info_obj) = info.as_object() {
if let Some(offsets) = info_obj.get("data_offsets") {
if let Some(arr) = offsets.as_array() {
let start = arr[0].as_u64().unwrap() as usize;
let end = arr[1].as_u64().unwrap() as usize;
let data = &mmap[data_offset + start..data_offset + end];
tensors.insert(name.clone(), data.to_vec());
}
}
if let Some(shape) = info_obj.get("shape") {
if let Some(arr) = shape.as_array() {
let shape_vec: Vec<usize> = arr
.iter()
.map(|v| v.as_u64().unwrap() as usize)
.collect();
shapes.insert(name.clone(), shape_vec);
}
}
if let Some(dtype) = info_obj.get("dtype") {
if let Some(s) = dtype.as_str() {
dtypes.insert(name.clone(), s.to_string());
}
}
}
}
}
Ok(Self {
tensors,
shapes,
dtypes,
})
}
/// 加载 2D 张量
pub fn load_2d<B: Backend>(&self, name: &str, device: &B::Device) -> Option<Tensor<B, 2, Float>> {
let data = self.tensors.get(name)?;
let shape = self.shapes.get(name)?;
let dtype = self.dtypes.get(name)?;
assert_eq!(shape.len(), 2, "期望 2D 张量: {name}");
let f32_data = convert_to_f32(data, dtype);
let shape_arr: [usize; 2] = [shape[0], shape[1]];
let tensor_data = TensorData::new(f32_data, Shape::new(shape_arr));
Some(Tensor::from_data(tensor_data, device))
}
/// 加载 1D 张量
pub fn load_1d<B: Backend>(&self, name: &str, device: &B::Device) -> Option<Tensor<B, 1, Float>> {
let data = self.tensors.get(name)?;
let shape = self.shapes.get(name)?;
let dtype = self.dtypes.get(name)?;
assert_eq!(shape.len(), 1, "期望 1D 张量: {name}");
let f32_data = convert_to_f32(data, dtype);
let shape_arr: [usize; 1] = [shape[0]];
let tensor_data = TensorData::new(f32_data, Shape::new(shape_arr));
Some(Tensor::from_data(tensor_data, device))
}
/// 获取原始字节数据
pub fn raw(&self, name: &str) -> Option<&[u8]> {
self.tensors.get(name).map(|v| v.as_slice())
}
pub fn shape(&self, name: &str) -> Option<&Vec<usize>> {
self.shapes.get(name)
}
pub fn dtype(&self, name: &str) -> Option<&String> {
self.dtypes.get(name)
}
pub fn names(&self) -> impl Iterator<Item = &String> {
self.tensors.keys()
}
}
/// 将 safetensors 权重加载到模型中
pub fn load_into_model<B: Backend>(
model: LlamaForCausalLM<B>,
store: &TensorStore,
device: &B::Device,
) -> LlamaForCausalLM<B> {
let mut model = model;
if let Some(w) = store.load_2d("model.embed_tokens.weight", device) {
let record = EmbeddingRecord {
weight: Param::from_tensor(w),
};
model.model.embed_tokens = model.model.embed_tokens.clone().load_record(record);
}
for i in 0..model.config.num_hidden_layers {
let prefix = format!("model.layers.{i}");
load_linear(&mut model, store, device, i, &format!("{prefix}.self_attn.q_proj.weight"), |m| &mut m.model.layers[i].self_attn.q_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.self_attn.k_proj.weight"), |m| &mut m.model.layers[i].self_attn.k_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.self_attn.v_proj.weight"), |m| &mut m.model.layers[i].self_attn.v_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.self_attn.o_proj.weight"), |m| &mut m.model.layers[i].self_attn.o_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.mlp.gate_proj.weight"), |m| &mut m.model.layers[i].mlp.gate_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.mlp.up_proj.weight"), |m| &mut m.model.layers[i].mlp.up_proj);
load_linear(&mut model, store, device, i, &format!("{prefix}.mlp.down_proj.weight"), |m| &mut m.model.layers[i].mlp.down_proj);
if let Some(w) = store.load_1d(&format!("{prefix}.input_layernorm.weight"), device) {
model.model.layers[i].input_layernorm.weight = Param::from_tensor(w);
}
if let Some(w) = store.load_1d(&format!("{prefix}.post_attention_layernorm.weight"), device) {
model.model.layers[i].post_attention_layernorm.weight = Param::from_tensor(w);
}
}
if let Some(w) = store.load_1d("model.norm.weight", device) {
model.model.norm.weight = Param::from_tensor(w);
}
if let Some(w) = store.load_2d("lm_head.weight", device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.lm_head = model.lm_head.clone().load_record(record);
} else if model.config.tie_word_embeddings {
let embed_weight = model.model.embed_tokens.weight.val();
let record = LinearRecord { weight: Param::from_tensor(embed_weight.transpose()), bias: None };
model.lm_head = model.lm_head.clone().load_record(record);
}
model
}
fn load_linear<B: Backend, F>(
model: &mut LlamaForCausalLM<B>,
store: &TensorStore,
device: &B::Device,
_layer_idx: usize,
name: &str,
get_field: F,
) where
F: FnOnce(&mut LlamaForCausalLM<B>) -> &mut burn::nn::Linear<B>,
{
if let Some(w) = store.load_2d(name, device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
let field = get_field(model);
*field = field.clone().load_record(record);
}
}
+84
View File
@@ -0,0 +1,84 @@
/// BF16 → F32
pub fn bf16_to_f32(bf16: u16) -> f32 {
let f32_bits = (bf16 as u32) << 16;
f32::from_bits(f32_bits)
}
/// F16 → F32
pub fn f16_to_f32(f16: u16) -> f32 {
let sign = (f16 >> 15) & 1;
let exp = (f16 >> 10) & 0x1F;
let mant = f16 & 0x3FF;
if exp == 0 {
if mant == 0 {
return if sign == 0 { 0.0 } else { -0.0 };
}
let mut m = mant as u32;
let mut e = 0u32;
while (m & 0x400) == 0 {
m <<= 1;
e += 1;
}
m &= 0x3FF;
let f32_exp = 127 - 14 - e;
let f32_bits = ((sign as u32) << 31) | (f32_exp << 23) | ((m as u32) << 13);
return f32::from_bits(f32_bits);
}
if exp == 0x1F {
let f32_bits = ((sign as u32) << 31) | (0xFFu32 << 23) | ((mant as u32) << 13);
return f32::from_bits(f32_bits);
}
let f32_exp = (exp as u32) + 127 - 15;
let f32_bits = ((sign as u32) << 31) | (f32_exp << 23) | ((mant as u32) << 13);
f32::from_bits(f32_bits)
}
/// F32 → F16 位表示
pub fn f32_to_f16_bits(v: f32) -> u16 {
let bits = v.to_bits();
let sign = bits >> 31;
let exp = (bits >> 23) & 0xFF;
let mant = bits & 0x7FFFFF;
let res: u32 = if exp == 0xFF {
let f16_exp = 0x1F;
let f16_mant = if mant == 0 { 0 } else { 0x3FF };
(sign << 15) | (f16_exp << 10) | f16_mant
} else if exp < 103 {
0
} else {
let new_exp = (exp as i32) - 127 + 15;
if new_exp >= 31 {
(sign << 15) | (0x1F << 10)
} else if new_exp <= 0 {
let mant_new = (mant | 0x800000) >> (113 - new_exp);
(sign << 15) | (mant_new & 0x3FF)
} else {
let f16_mant = mant >> 13;
(sign << 15) | ((new_exp as u32) << 10) | f16_mant
}
};
res as u16
}
/// 将原始字节按 dtype 转换为 f32 向量
pub fn convert_to_f32(data: &[u8], dtype: &str) -> Vec<f32> {
match dtype {
"BF16" => data
.chunks_exact(2)
.map(|chunk| bf16_to_f32(u16::from_le_bytes(chunk.try_into().unwrap())))
.collect(),
"F16" => data
.chunks_exact(2)
.map(|chunk| f16_to_f32(u16::from_le_bytes(chunk.try_into().unwrap())))
.collect(),
"F32" => data
.chunks_exact(4)
.map(|chunk| f32::from_le_bytes(chunk.try_into().unwrap()))
.collect(),
_ => panic!("不支持的 dtype: {dtype}"),
}
}
+15
View File
@@ -0,0 +1,15 @@
[package]
name = "minicpm-core"
version = "0.2.0"
edition = "2021"
publish = ["gitea"]
[features]
default = ["avx2"]
avx2 = []
[dependencies]
burn = { version = "0.21", default-features = false, features = ["std"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
+5
View File
@@ -0,0 +1,5 @@
pub mod config;
pub mod model;
pub use config::{EosTokenId, LlamaConfig};
pub use model::{LlamaForCausalLM, LlamaKVCache};
@@ -129,7 +129,6 @@ impl<B: Backend> Attention<B> {
let q = rope.apply(q, offset); let q = rope.apply(q, offset);
let k = rope.apply(k, offset); let k = rope.apply(k, offset);
// 合并 KV Cache
let (k_full, v_full) = match cache { let (k_full, v_full) = match cache {
Some(cache) => { Some(cache) => {
let k_full = Tensor::cat(vec![cache.k.clone(), k], 2); let k_full = Tensor::cat(vec![cache.k.clone(), k], 2);
@@ -4,15 +4,15 @@ use burn::tensor::{Float, Tensor};
use super::attention::{Attention, KVCache}; use super::attention::{Attention, KVCache};
use super::ffn::FeedForward; use super::ffn::FeedForward;
use super::norm::RmsNorm; use super::norm::RMSNorm;
use super::rope::RoPE; use super::rope::RoPE;
#[derive(Module, Debug)] #[derive(Module, Debug)]
pub struct DecoderLayer<B: Backend> { pub struct DecoderLayer<B: Backend> {
pub self_attn: Attention<B>, pub self_attn: Attention<B>,
pub mlp: FeedForward<B>, pub mlp: FeedForward<B>,
pub input_layernorm: RmsNorm<B>, pub input_layernorm: RMSNorm<B>,
pub post_attention_layernorm: RmsNorm<B>, pub post_attention_layernorm: RMSNorm<B>,
} }
impl<B: Backend> DecoderLayer<B> { impl<B: Backend> DecoderLayer<B> {
@@ -27,8 +27,8 @@ impl<B: Backend> DecoderLayer<B> {
) -> Self { ) -> Self {
let self_attn = Attention::new(hidden_size, n_heads, n_kv_heads, head_dim, device); let self_attn = Attention::new(hidden_size, n_heads, n_kv_heads, head_dim, device);
let mlp = FeedForward::new(hidden_size, intermediate_size, device); let mlp = FeedForward::new(hidden_size, intermediate_size, device);
let input_layernorm = RmsNorm::new(hidden_size, rms_norm_eps, device); let input_layernorm = RMSNorm::new(hidden_size, rms_norm_eps, device);
let post_attention_layernorm = RmsNorm::new(hidden_size, rms_norm_eps, device); let post_attention_layernorm = RMSNorm::new(hidden_size, rms_norm_eps, device);
Self { Self {
self_attn, self_attn,
@@ -5,5 +5,4 @@ pub mod model;
pub mod norm; pub mod norm;
pub mod rope; pub mod rope;
pub use attention::KVCache; pub use model::{LlamaForCausalLM, LlamaKVCache};
pub use model::{LlamaForCausalLM, LlamaKVCache};
@@ -6,7 +6,7 @@ use burn::tensor::{Float, Int, Tensor};
use super::attention::KVCache; use super::attention::KVCache;
use crate::config::LlamaConfig; use crate::config::LlamaConfig;
use super::decoder::DecoderLayer; use super::decoder::DecoderLayer;
use super::norm::RmsNorm; use super::norm::RMSNorm;
use super::rope::RoPE; use super::rope::RoPE;
#[derive(Debug, Clone)] #[derive(Debug, Clone)]
@@ -26,7 +26,7 @@ impl<B: Backend> LlamaKVCache<B> {
pub struct LlamaModel<B: Backend> { pub struct LlamaModel<B: Backend> {
pub embed_tokens: Embedding<B>, pub embed_tokens: Embedding<B>,
pub layers: Vec<DecoderLayer<B>>, pub layers: Vec<DecoderLayer<B>>,
pub norm: RmsNorm<B>, pub norm: RMSNorm<B>,
pub rope: RoPE, pub rope: RoPE,
} }
@@ -58,7 +58,7 @@ impl<B: Backend> LlamaForCausalLM<B> {
)); ));
} }
let norm = RmsNorm::new(config.hidden_size, config.rms_norm_eps, device); let norm = RMSNorm::new(config.hidden_size, config.rms_norm_eps, device);
let lm_head = LinearConfig::new(config.hidden_size, config.vocab_size).init(device); let lm_head = LinearConfig::new(config.hidden_size, config.vocab_size).init(device);
@@ -4,12 +4,12 @@ use burn::tensor::backend::Backend;
use burn::tensor::{Float, Tensor}; use burn::tensor::{Float, Tensor};
#[derive(Module, Debug)] #[derive(Module, Debug)]
pub struct RmsNorm<B: Backend> { pub struct RMSNorm<B: Backend> {
pub weight: Param<Tensor<B, 1, Float>>, pub weight: Param<Tensor<B, 1, Float>>,
pub eps: f64, pub eps: f64,
} }
impl<B: Backend> RmsNorm<B> { impl<B: Backend> RMSNorm<B> {
pub fn new(dim: usize, eps: f64, device: &B::Device) -> Self { pub fn new(dim: usize, eps: f64, device: &B::Device) -> Self {
let weight = Initializer::Ones.init([dim], device); let weight = Initializer::Ones.init([dim], device);
Self { Self {
+14
View File
@@ -0,0 +1,14 @@
[package]
name = "minicpm-inference"
version = "0.2.0"
edition = "2021"
publish = ["gitea"]
[dependencies]
minicpm-core = { path = "../minicpm-core", version = "0.2.0", registry = "gitea" }
burn = { version = "0.21", default-features = false, features = ["std", "autotune"] }
tokenizers = "0.20"
rand = "0.8"
anyhow = "1.0"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
+16
View File
@@ -0,0 +1,16 @@
#[derive(Debug, Clone)]
pub struct GenerationConfig {
pub max_new_tokens: Option<usize>,
pub temperature: f32,
pub top_p: f32,
}
impl Default for GenerationConfig {
fn default() -> Self {
Self {
max_new_tokens: None,
temperature: 1.0,
top_p: 1.0,
}
}
}
+132
View File
@@ -0,0 +1,132 @@
use burn::tensor::backend::Backend;
use burn::tensor::{Int, Tensor};
use minicpm_core::config::EosTokenId;
use minicpm_core::model::{LlamaForCausalLM, LlamaKVCache};
use crate::config::GenerationConfig;
use crate::sampling::{CachedSampler, sample_last};
pub struct TokenStream<'a, B: Backend> {
model: &'a LlamaForCausalLM<B>,
config: &'a GenerationConfig,
eos_token_id: &'a EosTokenId,
device: &'a B::Device,
cache: Option<LlamaKVCache<B>>,
last_token: Option<u32>,
count: usize,
finished: bool,
first_step: bool,
input_ids: Vec<u32>,
sampler: CachedSampler,
}
impl<'a, B: Backend> TokenStream<'a, B> {
pub fn new(
model: &'a LlamaForCausalLM<B>,
input_ids: &[u32],
config: &'a GenerationConfig,
eos_token_id: &'a EosTokenId,
device: &'a B::Device,
) -> Self {
Self {
model,
config,
eos_token_id,
device,
cache: None,
last_token: None,
count: 0,
finished: false,
first_step: true,
input_ids: input_ids.to_vec(),
sampler: CachedSampler::new(),
}
}
}
impl<'a, B: Backend> Iterator for TokenStream<'a, B> {
type Item = u32;
fn next(&mut self) -> Option<Self::Item> {
if self.finished {
return None;
}
if let Some(max) = self.config.max_new_tokens {
if self.count >= max {
self.finished = true;
return None;
}
}
let next_token = if self.first_step {
self.first_step = false;
self.step_first()
} else {
self.step_next()
};
match next_token {
Some(token) => {
self.count += 1;
self.last_token = Some(token);
if self.eos_token_id.contains(token) {
self.finished = true;
}
Some(token)
}
None => {
self.finished = true;
None
}
}
}
}
impl<'a, B: Backend> TokenStream<'a, B> {
fn step_first(&mut self) -> Option<u32> {
let input_ints: Vec<i64> = self.input_ids.iter().map(|&x| x as i64).collect();
let input_tensor =
Tensor::<B, 1, Int>::from_ints(input_ints.as_slice(), self.device)
.unsqueeze::<2>();
let (logits, new_cache) = self.model.forward_with_cache(input_tensor, self.cache.as_ref());
self.cache = Some(new_cache);
Some(sample_last(&logits, self.config.temperature, self.config.top_p))
}
fn step_next(&mut self) -> Option<u32> {
let last_token = self.last_token?;
let input_ints: Vec<i64> = vec![last_token as i64];
let input_tensor =
Tensor::<B, 1, Int>::from_ints(input_ints.as_slice(), self.device)
.unsqueeze::<2>();
let (logits, new_cache) = self.model.forward_with_cache(input_tensor, self.cache.as_ref());
self.cache = Some(new_cache);
let vocab_size = self.model.config.vocab_size;
let next_token_logits = logits
.slice([0..1, 0..1, 0..vocab_size])
.reshape([vocab_size]);
let data = next_token_logits.to_data();
let values: Vec<f32> = data.as_slice().unwrap().to_vec();
Some(self.sampler.sample(&values, self.config.temperature, self.config.top_p))
}
}
pub fn generate_tokens<B: Backend>(
model: &LlamaForCausalLM<B>,
input_ids: &[u32],
config: &GenerationConfig,
eos_token_id: &EosTokenId,
device: &B::Device,
) -> Vec<u32> {
let stream = TokenStream::new(model, input_ids, config, eos_token_id, device);
stream.collect()
}
+123
View File
@@ -0,0 +1,123 @@
pub mod config;
pub mod generator;
pub mod loader;
pub mod sampling;
pub mod tokenizer;
pub use config::GenerationConfig;
pub use generator::{TokenStream};
pub use minicpm_core::config::{EosTokenId, LlamaConfig};
pub use minicpm_core::model::{LlamaForCausalLM, LlamaKVCache};
pub use tokenizer::TokenizerWrapper;
use burn::tensor::backend::Backend;
use loader::load_model;
pub struct MiniCPM<B: Backend> {
model: LlamaForCausalLM<B>,
config: LlamaConfig,
tokenizer: TokenizerWrapper,
device: B::Device,
}
impl<B: Backend> MiniCPM<B> {
pub fn load(
model_path: &str,
config_path: &str,
tokenizer_path: &str,
device: &B::Device,
) -> anyhow::Result<Self> {
let config = LlamaConfig::from_json(config_path)?;
let tokenizer = TokenizerWrapper::from_file(tokenizer_path)?;
let model = load_model::<B>(model_path, &config, device)?;
Ok(Self {
model,
config,
tokenizer,
device: device.clone(),
})
}
pub fn generate(
&self,
prompt: &str,
think: bool,
config: &GenerationConfig,
) -> anyhow::Result<String> {
let input_ids = self.tokenizer.apply_chat_template(prompt, think)?;
let output_ids = generator::generate_tokens(
&self.model,
&input_ids,
config,
&self.config.eos_token_id,
&self.device,
);
let new_ids = &output_ids[input_ids.len()..];
self.tokenizer.decode(new_ids, true)
}
pub fn generate_stream<'a>(
&'a self,
prompt: &str,
think: bool,
config: &'a GenerationConfig,
) -> anyhow::Result<TextStream<'a, B>> {
let input_ids = self.tokenizer.apply_chat_template(prompt, think)?;
let token_stream = TokenStream::new(
&self.model,
&input_ids,
config,
&self.config.eos_token_id,
&self.device,
);
Ok(TextStream {
token_stream,
tokenizer: &self.tokenizer,
buffer: Vec::new(),
})
}
pub fn config(&self) -> &LlamaConfig {
&self.config
}
pub fn tokenizer(&self) -> &TokenizerWrapper {
&self.tokenizer
}
pub fn inner_model(&self) -> &LlamaForCausalLM<B> {
&self.model
}
}
pub struct TextStream<'a, B: Backend> {
token_stream: TokenStream<'a, B>,
tokenizer: &'a TokenizerWrapper,
buffer: Vec<u32>,
}
impl<'a, B: Backend> Iterator for TextStream<'a, B> {
type Item = String;
fn next(&mut self) -> Option<Self::Item> {
match self.token_stream.next() {
Some(token) => {
self.buffer.push(token);
match self.tokenizer.decode(&[token], true) {
Ok(text) => Some(text),
Err(_) => Some(String::new()),
}
}
None => None,
}
}
}
impl<'a, B: Backend> TextStream<'a, B> {
pub fn all_tokens(&self) -> &[u32] {
&self.buffer
}
}
@@ -0,0 +1,17 @@
use burn::module::Module;
use burn::record::{FullPrecisionSettings, NamedMpkFileRecorder};
use burn::tensor::backend::Backend;
use minicpm_core::config::LlamaConfig;
use minicpm_core::model::LlamaForCausalLM;
pub fn load_model<B: Backend>(
model_path: &str,
config: &LlamaConfig,
device: &B::Device,
) -> anyhow::Result<LlamaForCausalLM<B>> {
let model = LlamaForCausalLM::<B>::new(config.clone(), device);
let recorder = NamedMpkFileRecorder::<FullPrecisionSettings>::new();
let model = model.load_file(model_path, &recorder, device)?;
Ok(model)
}
+163
View File
@@ -0,0 +1,163 @@
use burn::tensor::backend::Backend;
use burn::tensor::{Float, Tensor};
use rand::{rngs::ThreadRng, Rng};
struct Sampler {
rng: ThreadRng,
}
impl Sampler {
fn new() -> Self {
Self {
rng: rand::thread_rng(),
}
}
fn sample(&mut self, logits: &[f32], temperature: f32, top_p: f32) -> u32 {
if temperature <= 0.001 {
let mut max_idx = 0;
let mut max_val = f32::NEG_INFINITY;
for (i, &val) in logits.iter().enumerate() {
if val > max_val {
max_val = val;
max_idx = i;
}
}
return max_idx as u32;
}
let max_val = logits.iter().cloned().fold(f32::NEG_INFINITY, f32::max);
let exp_sum: f32 = logits.iter().map(|&v| (v - max_val).exp()).sum();
let mut probs: Vec<f32> = logits.iter().map(|&v| (v - max_val).exp() / exp_sum).collect();
if top_p < 1.0 {
let mut indexed: Vec<(usize, f32)> = probs.iter().enumerate().map(|(i, &p)| (i, p)).collect();
indexed.sort_by(|a, b| b.1.partial_cmp(&a.1).unwrap());
let mut cumsum = 0.0;
let mut cutoff = indexed.len();
for (i, &(_, p)) in indexed.iter().enumerate() {
cumsum += p;
if cumsum > top_p {
cutoff = i + 1;
break;
}
}
let keep: std::collections::HashSet<usize> = indexed[..cutoff].iter().map(|(i, _)| *i).collect();
for (i, p) in probs.iter_mut().enumerate() {
if !keep.contains(&i) {
*p = 0.0;
}
}
let sum: f32 = probs.iter().sum();
if sum > 0.0 {
for p in probs.iter_mut() {
*p /= sum;
}
}
}
let r: f32 = self.rng.gen();
let mut cumsum = 0.0;
for (i, &p) in probs.iter().enumerate() {
cumsum += p;
if r < cumsum {
return i as u32;
}
}
probs.len() as u32 - 1
}
}
pub struct CachedSampler {
sampler: std::cell::RefCell<Sampler>,
}
impl CachedSampler {
pub fn new() -> Self {
Self {
sampler: std::cell::RefCell::new(Sampler::new()),
}
}
pub fn sample(&self, logits: &[f32], temperature: f32, top_p: f32) -> u32 {
self.sampler.borrow_mut().sample(logits, temperature, top_p)
}
}
pub fn sample_last<B: Backend>(logits: &Tensor<B, 3, Float>, temperature: f32, top_p: f32) -> u32 {
let shape = logits.shape();
let dims: [usize; 3] = shape.dims();
let seq_len = dims[1];
let vocab_size = dims[2];
let last_logits = logits
.clone()
.slice([0..1, seq_len - 1..seq_len, 0..vocab_size])
.reshape([vocab_size]);
sample(&last_logits, temperature, top_p)
}
pub fn sample<B: Backend>(logits: &Tensor<B, 1, Float>, temperature: f32, top_p: f32) -> u32 {
let data = logits.clone().to_data();
let values: Vec<f32> = data.as_slice().unwrap().to_vec();
if temperature <= 0.001 {
let mut max_idx = 0;
let mut max_val = f32::NEG_INFINITY;
for (i, &val) in values.iter().enumerate() {
if val > max_val {
max_val = val;
max_idx = i;
}
}
return max_idx as u32;
}
let max_val = values.iter().cloned().fold(f32::NEG_INFINITY, f32::max);
let exp_sum: f32 = values.iter().map(|&v| (v - max_val).exp()).sum();
let mut probs: Vec<f32> = values.iter().map(|&v| (v - max_val).exp() / exp_sum).collect();
if top_p < 1.0 {
let mut indexed: Vec<(usize, f32)> = probs.iter().enumerate().map(|(i, &p)| (i, p)).collect();
indexed.sort_by(|a, b| b.1.partial_cmp(&a.1).unwrap());
let mut cumsum = 0.0;
let mut cutoff = indexed.len();
for (i, &(_, p)) in indexed.iter().enumerate() {
cumsum += p;
if cumsum > top_p {
cutoff = i + 1;
break;
}
}
let keep: std::collections::HashSet<usize> = indexed[..cutoff].iter().map(|(i, _)| *i).collect();
for (i, p) in probs.iter_mut().enumerate() {
if !keep.contains(&i) {
*p = 0.0;
}
}
let sum: f32 = probs.iter().sum();
if sum > 0.0 {
for p in probs.iter_mut() {
*p /= sum;
}
}
}
let mut rng = rand::thread_rng();
let r: f32 = rng.gen();
let mut cumsum = 0.0;
for (i, &p) in probs.iter().enumerate() {
cumsum += p;
if r < cumsum {
return i as u32;
}
}
probs.len() as u32 - 1
}
@@ -7,7 +7,7 @@ pub struct TokenizerWrapper {
impl TokenizerWrapper { impl TokenizerWrapper {
pub fn from_file(path: &str) -> anyhow::Result<Self> { pub fn from_file(path: &str) -> anyhow::Result<Self> {
let tokenizer = Tokenizer::from_file(path) let tokenizer = Tokenizer::from_file(path)
.map_err(|e| anyhow::anyhow!("Failed to load tokenizer: {}", e))?; .map_err(|e| anyhow::anyhow!("加载 tokenizer 失败: {}", e))?;
Ok(Self { tokenizer }) Ok(Self { tokenizer })
} }
@@ -15,7 +15,7 @@ impl TokenizerWrapper {
let encoding = self let encoding = self
.tokenizer .tokenizer
.encode(text, add_special_tokens) .encode(text, add_special_tokens)
.map_err(|e| anyhow::anyhow!("Failed to encode: {}", e))?; .map_err(|e| anyhow::anyhow!("编码失败: {}", e))?;
Ok(encoding.get_ids().to_vec()) Ok(encoding.get_ids().to_vec())
} }
@@ -23,7 +23,7 @@ impl TokenizerWrapper {
let text = self let text = self
.tokenizer .tokenizer
.decode(ids, skip_special_tokens) .decode(ids, skip_special_tokens)
.map_err(|e| anyhow::anyhow!("Failed to decode: {}", e))?; .map_err(|e| anyhow::anyhow!("解码失败: {}", e))?;
Ok(text) Ok(text)
} }
@@ -31,7 +31,6 @@ impl TokenizerWrapper {
self.tokenizer.get_vocab_size(true) self.tokenizer.get_vocab_size(true)
} }
/// 应用 MiniCPM5 chat template
pub fn apply_chat_template(&self, user_msg: &str, enable_thinking: bool) -> anyhow::Result<Vec<u32>> { pub fn apply_chat_template(&self, user_msg: &str, enable_thinking: bool) -> anyhow::Result<Vec<u32>> {
let prompt = if enable_thinking { let prompt = if enable_thinking {
format!( format!(
@@ -46,4 +45,4 @@ impl TokenizerWrapper {
}; };
self.encode(&prompt, false) self.encode(&prompt, false)
} }
} }
+13
View File
@@ -0,0 +1,13 @@
[package]
name = "convert"
version = "0.1.0"
edition = "2021"
[[bin]]
name = "convert"
path = "src/main.rs"
[dependencies]
minicpm-convert = { path = "../../crates/minicpm-convert" }
burn = { version = "0.21", default-features = false, features = ["std", "wgpu", "fusion", "autotune"] }
anyhow = "1.0"
+20
View File
@@ -0,0 +1,20 @@
use burn::backend::{wgpu::WgpuDevice, Wgpu};
use minicpm_convert::{run_export, ExportTask, Format};
use std::path::Path;
fn main() -> anyhow::Result<()> {
let safetensors_path = Path::new("MiniCPM5-1B/model-00000-of-00001.safetensors");
let config_path = Path::new("MiniCPM5-1B/config.json");
let tokenizer_path = Path::new("MiniCPM5-1B/tokenizer.json");
println!("模型转换工具 (Wgpu GPU 加速)");
println!("源文件: {:?}", safetensors_path);
println!();
let device = WgpuDevice::default();
let tasks = vec![ExportTask::new(Format::Full)];
run_export::<Wgpu>(safetensors_path, config_path, tokenizer_path, &tasks, &device)?;
Ok(())
}
+9
View File
@@ -0,0 +1,9 @@
[package]
name = "wgpu-backend"
version = "0.1.0"
edition = "2021"
[dependencies]
minicpm-inference = { path = "../../crates/minicpm-inference" }
burn = { version = "0.21", default-features = false, features = ["std", "wgpu", "fusion", "autotune"] }
anyhow = "1.0"
+50
View File
@@ -0,0 +1,50 @@
use burn::backend::{wgpu::WgpuDevice, Wgpu};
use minicpm_inference::{GenerationConfig, MiniCPM};
use std::io::Write;
use std::time::Instant;
fn main() -> anyhow::Result<()> {
let args: Vec<String> = std::env::args().collect();
let think = args.iter().any(|s| s == "--think");
println!("========================================");
println!("后端: Wgpu (GPU 加速)");
println!("模型目录: model");
if think {
println!("思考模式: 开启");
} else {
println!("思考模式: 关闭");
}
println!("========================================");
let start = Instant::now();
let device = WgpuDevice::default();
let model = MiniCPM::<Wgpu>::load("model/model", "MiniCPM5-1B/config.json", "MiniCPM5-1B/tokenizer.json", &device)?;
println!("模型加载完成,耗时: {:.2?}", start.elapsed());
let prompt = "需要处理生成一个河南的旅游计划,要求如下:\n1. 旅游计划为三天两夜的行程安排。\n2. 每天的行程安排包括景点、餐饮和住宿建议。\n3. 景点安排要考虑交通便利性和时间合理性。\n请生成详细的旅游计划,包含每天的行程安排、景点介绍、餐饮推荐和住宿建议。\n";
println!("\n用户: {prompt}");
print!("Assistant: ");
std::io::stdout().flush()?;
let config = GenerationConfig {
max_new_tokens: Some(1200),
temperature: 0.7,
top_p: 0.95,
};
let start = Instant::now();
let stream = model.generate_stream(prompt, think, &config)?;
for text in stream {
print!("{text}");
std::io::stdout().flush().ok();
}
let elapsed = start.elapsed();
println!();
println!("\n生成耗时: {:.2?}", elapsed);
Ok(())
}
+30
View File
@@ -0,0 +1,30 @@
{
"_name_or_path": "openbmb/MiniCPM5-1B",
"architectures": [
"LlamaForCausalLM"
],
"bos_token_id": 0,
"eos_token_id": [
1,
130073
],
"pad_token_id": 1,
"hidden_act": "silu",
"hidden_size": 1536,
"initializer_range": 0.02,
"intermediate_size": 4608,
"max_position_embeddings": 131072,
"model_type": "llama",
"num_attention_heads": 16,
"num_hidden_layers": 24,
"num_key_value_heads": 2,
"head_dim": 128,
"rms_norm_eps": 1e-06,
"rope_theta": 5000000,
"rope_scaling": null,
"tie_word_embeddings": false,
"torch_dtype": "bfloat16",
"transformers_version": "5.6.2",
"use_cache": true,
"vocab_size": 130560
}
BIN
View File
Binary file not shown.
+653947
View File
File diff suppressed because it is too large Load Diff
+113 -94
View File
@@ -1,107 +1,126 @@
# MiniCPM5-1B Burn # MiniCPM5-1B-rust (v0.2.0)
使用 [Burn](https://github.com/tracel-ai/burn) 框架从零实现的 MiniCPM5-1B 模型 MiniCPM5-1B 模型的 Rust 推理实现,基于 [Burn](https://github.com/tracel-ai/burn) 框架。
## 功能 ## 特性
- **模型转换**:将 safetensors 格式转换为 Burn 原生 bincode 格式 - 🔥 **Wgpu GPU 加速**:支持 CUDA / Metal / Vulkan / DX12 等多种 GPU 后端
- **模型推理**:使用 WGPU 后端运行 MiniCPM5-1B 进行文本生成,支持无上限输出 - 🚀 **算子融合**:启用 fusion + autotune 优化,自动选择最优 kernel
- **独立输出**:转换后的模型文件放在 `model/` 目录,方便移植到其他项目 - 📝 **流式输出**:实时生成文本,支持逐字输出
- 🧠 **思考模式**:支持开启模型的推理思考过程
## 架构 - 📦 **纯 Rust**:无 C/C++ 依赖,跨平台编译简单
- 24 层 Transformer
- GQA16 个查询头,2 个 KV 头
- RoPE 旋转位置编码(rope_theta = 5000000
- RMSNorm 归一化
- SiLU 激活函数(FFN: gate + up + down
- KV Cache 优化
## 使用
### 准备模型
将 MiniCPM5-1B 模型放到 `MiniCPM5-1B/` 目录:
```
MiniCPM5-1B/
├── config.json
├── tokenizer.json
└── model-00000-of-00001.safetensors
```
### 1. 转换模型
```bash
# 默认输出到 model/model.bin
cargo run --release -- convert
# 指定输出路径
cargo run --release -- convert --output my_model/model.bin
```
### 2. 运行推理
```bash
# 无上限生成(直到遇到 eos token)
cargo run --release -- run --text "你好"
# 限制最大生成 token 数
cargo run --release -- run --text "你好" --max-tokens 100
```
## 移植到其他项目
转换后的文件:
```
model/
└── model.bin # Burn bincode 格式模型
```
在其他项目中加载:
```rust
use burn::record::{BinFileRecorder, FullPrecisionSettings};
use minicpm_burn_lib::{LlamaConfig, LlamaForCausalLM};
let config = LlamaConfig::from_json("config.json")?;
let model = LlamaForCausalLM::<Backend>::new(config, &device);
let model = model.load_file("model/model.bin", &BinFileRecorder::<FullPrecisionSettings>::new())?;
```
## 项目结构 ## 项目结构
``` ```
src/ MiniCPM5-1B-rust/
├── lib.rs # 库入口 ├── crates/
├── main.rs # CLI 工具 ├── minicpm-core/ # 核心模型实现(Transformer、Attention、FFN
├── config.rs # 模型配置 │ ├── minicpm-inference/ # 推理引擎(生成、采样、tokenizer)
├── exporter.rs # 模型转换 │ └── minicpm-convert/ # 模型转换
── model/ # 模型架构 ── examples/
├── mod.rs ├── convert/ # 模型转换示例(safetensors → Burn 格式)
── attention.rs # GQA 注意力 + KV Cache ── wgpu-backend/ # Wgpu GPU 推理示例
│ ├── decoder.rs # 解码器层
│ ├── ffn.rs # 前馈网络
│ ├── model.rs # LlamaForCausalLM
│ ├── norm.rs # RMSNorm
│ └── rope.rs # RoPE 位置编码
└── inference/ # 推理工具
├── mod.rs
├── generation.rs # 文本生成(greedy + KV Cache
├── loader.rs # safetensors 加载器
└── tokenizer.rs # 分词器封装
``` ```
## 快速开始
### 1. 准备模型
将 MiniCPM5-1B safetensors 模型放到 `MiniCPM5-1B/` 目录:
```
MiniCPM5-1B/
├── model-00000-of-00001.safetensors
├── config.json
└── tokenizer.json
```
### 2. 转换模型
```bash
cargo run --release -p convert
```
转换完成后会生成 `model/` 目录(全精度 f32,Burn mpk 格式)。
### 3. 运行推理
```bash
# 普通模式
cargo run --release -p wgpu-backend
# 开启思考模式
cargo run --release -p wgpu-backend -- --think
```
## 使用说明
### wgpu-backend 命令行参数
| 参数 | 说明 |
|------|------|
| `--think` | 开启思考模式,模型会在回答前进行推理思考 |
### GenerationConfig
```rust
GenerationConfig {
max_new_tokens: Some(1200), // 最大生成 token 数
temperature: 0.7, // 温度,越高越随机
top_p: 0.95, // nucleus sampling 参数
}
```
### 作为库使用
```rust
use burn::backend::{wgpu::WgpuDevice, Wgpu};
use minicpm_inference::{GenerationConfig, MiniCPM};
let device = WgpuDevice::default();
let model = MiniCPM::<Wgpu>::load(
"model/model",
"config.json",
"tokenizer.json",
&device,
)?;
let config = GenerationConfig {
max_new_tokens: Some(500),
temperature: 0.7,
top_p: 0.95,
};
// 流式生成
let stream = model.generate_stream("你好", false, &config)?;
for text in stream {
print!("{}", text);
}
```
## 发布构建
```bash
# Release 构建(启用 LTO + 最高优化级别)
cargo build --release
# 发布到 gitea registry
cargo publish -p minicpm-core --registry gitea
cargo publish -p minicpm-inference --registry gitea
cargo publish -p minicpm-convert --registry gitea
```
Release profile 配置:
- `opt-level = 3`:最高优化级别
- `lto = true`:链接时优化
- `codegen-units = 1`:单代码生成单元,最大化优化
## 依赖 ## 依赖
- `burn` 0.21 - 深度学习框架(WGPU 后端) - Rust 1.75+
- `burn-store` - safetensors 支持 - 支持 Wgpu 的 GPUCUDA / Metal / Vulkan / DX12
- `tokenizers` - HuggingFace 分词器
- `clap` - CLI 参数解析
## 性能 ## License
- WGPU Vulkan 后端:约 10 tokens/s MIT
- 模型大小:约 4.0 GBF32
## 许可证
MIT
-34
View File
@@ -1,34 +0,0 @@
use crate::config::LlamaConfig;
use crate::inference::load_safetensors;
use crate::model::LlamaForCausalLM;
use burn::module::Module;
use burn::record::{FullPrecisionSettings, NamedMpkFileRecorder};
use burn::tensor::backend::Backend;
use std::path::Path;
pub fn export_model<B: Backend>(
safetensors_path: &Path,
config_path: &Path,
output_dir: &Path,
device: &B::Device,
) -> anyhow::Result<()> {
println!("开始转换 MiniCPM 模型为 Burn 格式...");
println!("加载配置文件: {:?}", config_path);
let config = LlamaConfig::from_json(config_path.to_str().unwrap())?;
println!("创建模型结构...");
let model = LlamaForCausalLM::<B>::new(config, device);
println!("加载 safetensors 权重...");
let model = load_safetensors(model, safetensors_path, device)?;
println!("保存为 MPK 格式...");
std::fs::create_dir_all(output_dir)?;
let output_path = output_dir.join("model");
let recorder = NamedMpkFileRecorder::<FullPrecisionSettings>::new();
model.save_file(&output_path, &recorder)?;
println!("模型已成功导出到: {:?}", output_dir);
Ok(())
}
-169
View File
@@ -1,169 +0,0 @@
use burn::tensor::backend::Backend;
use burn::tensor::{Float, Int, Tensor};
use rand::Rng;
use crate::config::EosTokenId;
use crate::model::{LlamaForCausalLM, LlamaKVCache};
pub struct GenerationConfig {
pub max_new_tokens: Option<usize>,
pub temperature: f32,
pub top_p: f32,
}
impl Default for GenerationConfig {
fn default() -> Self {
Self {
max_new_tokens: None,
temperature: 1.0,
top_p: 1.0,
}
}
}
pub fn generate_with_cache<B: Backend>(
model: &LlamaForCausalLM<B>,
input_ids: &[u32],
config: &GenerationConfig,
eos_token_id: &EosTokenId,
device: &B::Device,
) -> Vec<u32> {
let mut output_ids = input_ids.to_vec();
let mut cache: Option<LlamaKVCache<B>> = None;
// 第一步:输入完整 prompt,建立初始 cache
{
let input_ints: Vec<i64> = input_ids.iter().map(|&x| x as i64).collect();
let input_tensor =
Tensor::<B, 1, Int>::from_ints(input_ints.as_slice(), device)
.unsqueeze::<2>();
let (logits, new_cache) = model.forward_with_cache(input_tensor, cache.as_ref());
cache = Some(new_cache);
let next_token = sample_last(&logits, config.temperature, config.top_p);
output_ids.push(next_token);
if eos_token_id.contains(next_token) {
return output_ids;
}
}
// 后续步骤:每次只输入 1 个 token,使用 cache
let mut count = 1;
loop {
if let Some(max) = config.max_new_tokens {
if count >= max {
break;
}
}
let last_token = output_ids[output_ids.len() - 1];
let input_ints: Vec<i64> = vec![last_token as i64];
let input_tensor =
Tensor::<B, 1, Int>::from_ints(input_ints.as_slice(), device)
.unsqueeze::<2>();
let (logits, new_cache) = model.forward_with_cache(input_tensor, cache.as_ref());
cache = Some(new_cache);
let vocab_size = model.config.vocab_size;
let next_token_logits = logits
.clone()
.slice([0..1, 0..1, 0..vocab_size])
.reshape([vocab_size]);
let next_token = sample(&next_token_logits, config.temperature, config.top_p);
output_ids.push(next_token);
if eos_token_id.contains(next_token) {
break;
}
count += 1;
}
output_ids
}
fn sample_last<B: Backend>(logits: &Tensor<B, 3, Float>, temperature: f32, top_p: f32) -> u32 {
let shape = logits.shape();
let dims: [usize; 3] = shape.dims();
let seq_len = dims[1];
let vocab_size = dims[2];
let last_logits = logits
.clone()
.slice([0..1, seq_len - 1..seq_len, 0..vocab_size])
.reshape([vocab_size]);
sample(&last_logits, temperature, top_p)
}
fn sample<B: Backend>(logits: &Tensor<B, 1, Float>, temperature: f32, top_p: f32) -> u32 {
let data = logits.clone().to_data();
let values: Vec<f32> = data.as_slice().unwrap().to_vec();
// temperature = 0 时退化为 greedy
if temperature <= 0.001 {
let mut max_idx = 0;
let mut max_val = f32::NEG_INFINITY;
for (i, &val) in values.iter().enumerate() {
if val > max_val {
max_val = val;
max_idx = i;
}
}
return max_idx as u32;
}
// 应用 temperature
let scaled: Vec<f32> = values.iter().map(|&v| v / temperature).collect();
// softmax
let max_val = scaled.iter().cloned().fold(f32::NEG_INFINITY, f32::max);
let exp_sum: f32 = scaled.iter().map(|&v| (v - max_val).exp()).sum();
let mut probs: Vec<f32> = scaled.iter().map(|&v| (v - max_val).exp() / exp_sum).collect();
// top_p 过滤
if top_p < 1.0 {
let mut indexed: Vec<(usize, f32)> = probs.iter().enumerate().map(|(i, &p)| (i, p)).collect();
indexed.sort_by(|a, b| b.1.partial_cmp(&a.1).unwrap());
let mut cumsum = 0.0;
let mut cutoff = indexed.len();
for (i, &(_, p)) in indexed.iter().enumerate() {
cumsum += p;
if cumsum > top_p {
cutoff = i + 1;
break;
}
}
let keep: std::collections::HashSet<usize> = indexed[..cutoff].iter().map(|(i, _)| *i).collect();
for (i, p) in probs.iter_mut().enumerate() {
if !keep.contains(&i) {
*p = 0.0;
}
}
let sum: f32 = probs.iter().sum();
if sum > 0.0 {
for p in probs.iter_mut() {
*p /= sum;
}
}
}
// 多项式采样
let mut rng = rand::thread_rng();
let r: f32 = rng.gen();
let mut cumsum = 0.0;
for (i, &p) in probs.iter().enumerate() {
cumsum += p;
if r < cumsum {
return i as u32;
}
}
probs.len() as u32 - 1
}
-226
View File
@@ -1,226 +0,0 @@
use std::collections::HashMap;
use crate::model::LlamaForCausalLM;
use burn::module::{Module, Param};
use burn::nn::{EmbeddingRecord, LinearRecord};
use burn::tensor::backend::Backend;
use burn::tensor::{Float, Shape, Tensor, TensorData};
use memmap2::Mmap;
use std::path::Path;
pub fn load_safetensors<B: Backend>(
model: LlamaForCausalLM<B>,
path: &Path,
device: &B::Device,
) -> anyhow::Result<LlamaForCausalLM<B>> {
let file = std::fs::File::open(path)?;
let mmap = unsafe { Mmap::map(&file)? };
let header_len = u64::from_le_bytes(mmap[..8].try_into().unwrap()) as usize;
let header_bytes = &mmap[8..8 + header_len];
let header: serde_json::Value = serde_json::from_slice(header_bytes)?;
let mut tensors = HashMap::new();
let mut shapes = HashMap::new();
let mut dtypes = HashMap::new();
let data_offset = 8 + header_len;
if let Some(obj) = header.as_object() {
for (name, info) in obj {
if name == "__metadata__" {
continue;
}
if let Some(info_obj) = info.as_object() {
if let Some(offsets) = info_obj.get("data_offsets") {
if let Some(arr) = offsets.as_array() {
let start = arr[0].as_u64().unwrap() as usize;
let end = arr[1].as_u64().unwrap() as usize;
let data = &mmap[data_offset + start..data_offset + end];
tensors.insert(name.clone(), data.to_vec());
}
}
if let Some(shape) = info_obj.get("shape") {
if let Some(arr) = shape.as_array() {
let shape_vec: Vec<usize> = arr
.iter()
.map(|v| v.as_u64().unwrap() as usize)
.collect();
shapes.insert(name.clone(), shape_vec);
}
}
if let Some(dtype) = info_obj.get("dtype") {
if let Some(s) = dtype.as_str() {
dtypes.insert(name.clone(), s.to_string());
}
}
}
}
}
let mut model = model;
if let Some(weight) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, "model.embed_tokens.weight", device) {
let record = EmbeddingRecord {
weight: Param::from_tensor(weight),
};
model.model.embed_tokens = model.model.embed_tokens.clone().load_record(record);
}
for i in 0..model.config.num_hidden_layers {
let prefix = format!("model.layers.{i}");
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.self_attn.q_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].self_attn.q_proj = model.model.layers[i].self_attn.q_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.self_attn.k_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].self_attn.k_proj = model.model.layers[i].self_attn.k_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.self_attn.v_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].self_attn.v_proj = model.model.layers[i].self_attn.v_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.self_attn.o_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].self_attn.o_proj = model.model.layers[i].self_attn.o_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.mlp.gate_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].mlp.gate_proj = model.model.layers[i].mlp.gate_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.mlp.up_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].mlp.up_proj = model.model.layers[i].mlp.up_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.mlp.down_proj.weight"), device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.model.layers[i].mlp.down_proj = model.model.layers[i].mlp.down_proj.clone().load_record(record);
}
if let Some(w) = load_tensor_1d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.input_layernorm.weight"), device) {
model.model.layers[i].input_layernorm.weight = Param::from_tensor(w);
}
if let Some(w) = load_tensor_1d::<B>(&tensors, &shapes, &dtypes, &format!("{prefix}.post_attention_layernorm.weight"), device) {
model.model.layers[i].post_attention_layernorm.weight = Param::from_tensor(w);
}
}
if let Some(w) = load_tensor_1d::<B>(&tensors, &shapes, &dtypes, "model.norm.weight", device) {
model.model.norm.weight = Param::from_tensor(w);
}
if let Some(w) = load_tensor_2d::<B>(&tensors, &shapes, &dtypes, "lm_head.weight", device) {
let record = LinearRecord { weight: Param::from_tensor(w.transpose()), bias: None };
model.lm_head = model.lm_head.clone().load_record(record);
} else if model.config.tie_word_embeddings {
let embed_weight = model.model.embed_tokens.weight.val();
let record = LinearRecord { weight: Param::from_tensor(embed_weight.transpose()), bias: None };
model.lm_head = model.lm_head.clone().load_record(record);
}
Ok(model)
}
fn load_tensor_2d<B: Backend>(
tensors: &HashMap<String, Vec<u8>>,
shapes: &HashMap<String, Vec<usize>>,
dtypes: &HashMap<String, String>,
name: &str,
device: &B::Device,
) -> Option<Tensor<B, 2, Float>> {
let data = tensors.get(name)?;
let shape = shapes.get(name)?;
let dtype = dtypes.get(name)?;
assert_eq!(shape.len(), 2, "Expected 2D tensor for {name}");
let f32_data = convert_to_f32(data, dtype);
let shape_arr: [usize; 2] = [shape[0], shape[1]];
let tensor_data = TensorData::new(f32_data, Shape::new(shape_arr));
Some(Tensor::from_data(tensor_data, device))
}
fn load_tensor_1d<B: Backend>(
tensors: &HashMap<String, Vec<u8>>,
shapes: &HashMap<String, Vec<usize>>,
dtypes: &HashMap<String, String>,
name: &str,
device: &B::Device,
) -> Option<Tensor<B, 1, Float>> {
let data = tensors.get(name)?;
let shape = shapes.get(name)?;
let dtype = dtypes.get(name)?;
assert_eq!(shape.len(), 1, "Expected 1D tensor for {name}");
let f32_data = convert_to_f32(data, dtype);
let shape_arr: [usize; 1] = [shape[0]];
let tensor_data = TensorData::new(f32_data, Shape::new(shape_arr));
Some(Tensor::from_data(tensor_data, device))
}
fn convert_to_f32(data: &[u8], dtype: &str) -> Vec<f32> {
match dtype {
"BF16" => data
.chunks_exact(2)
.map(|chunk| {
let bytes: [u8; 2] = chunk.try_into().unwrap();
bf16_to_f32(u16::from_le_bytes(bytes))
})
.collect(),
"F16" => data
.chunks_exact(2)
.map(|chunk| {
let bytes: [u8; 2] = chunk.try_into().unwrap();
f16_to_f32(u16::from_le_bytes(bytes))
})
.collect(),
"F32" => data
.chunks_exact(4)
.map(|chunk| {
let bytes: [u8; 4] = chunk.try_into().unwrap();
f32::from_le_bytes(bytes)
})
.collect(),
_ => panic!("Unsupported dtype: {dtype}"),
}
}
fn bf16_to_f32(bf16: u16) -> f32 {
let f32_bits = (bf16 as u32) << 16;
f32::from_bits(f32_bits)
}
fn f16_to_f32(f16: u16) -> f32 {
let sign = (f16 >> 15) & 1;
let exp = (f16 >> 10) & 0x1F;
let mant = f16 & 0x3FF;
if exp == 0 {
if mant == 0 {
return if sign == 0 { 0.0 } else { -0.0 };
}
let mut m = mant as u32;
let mut e = 0u32;
while (m & 0x400) == 0 {
m <<= 1;
e += 1;
}
m &= 0x3FF;
let f32_exp = 127 - 14 - e;
let f32_bits = ((sign as u32) << 31) | (f32_exp << 23) | ((m as u32) << 13);
return f32::from_bits(f32_bits);
}
if exp == 0x1F {
let f32_bits = ((sign as u32) << 31) | (0xFFu32 << 23) | ((mant as u32) << 13);
return f32::from_bits(f32_bits);
}
let f32_exp = (exp as u32) + 127 - 15;
let f32_bits = ((sign as u32) << 31) | (f32_exp << 23) | ((mant as u32) << 13);
f32::from_bits(f32_bits)
}
-7
View File
@@ -1,7 +0,0 @@
pub mod generation;
pub mod loader;
pub mod tokenizer;
pub use generation::{GenerationConfig, generate_with_cache};
pub use loader::load_safetensors;
pub use tokenizer::TokenizerWrapper;
-9
View File
@@ -1,9 +0,0 @@
pub mod config;
pub mod exporter;
pub mod model;
pub mod inference;
pub use config::{LlamaConfig, EosTokenId};
pub use model::LlamaForCausalLM;
pub use inference::{GenerationConfig, generate_with_cache, load_safetensors, TokenizerWrapper};
pub use exporter::export_model;
-109
View File
@@ -1,109 +0,0 @@
use anyhow::Result;
use burn::backend::Wgpu;
use clap::Parser;
use minicpm_burn_lib::{
config::LlamaConfig,
inference::{generation, GenerationConfig, load_safetensors, TokenizerWrapper},
model::LlamaForCausalLM,
};
type Backend = Wgpu;
#[derive(Parser, Debug)]
#[command(name = "minicpm-burn")]
#[command(version = "0.1.0")]
enum Command {
/// 模型推理
Run {
/// 输入文本
#[arg(short, long)]
text: String,
/// 最大生成 token 数(不指定则无上限)
#[arg(short, long)]
max_tokens: Option<usize>,
/// 启用思考模式(temperature=0.9
#[arg(long, default_value_t = false)]
think: bool,
},
/// 转换模型为 Burn MPK 格式
Convert {
/// 输出目录
#[arg(short, long, default_value = "model")]
output: String,
},
}
fn main() -> Result<()> {
let cmd = Command::parse();
match cmd {
Command::Run { text, max_tokens, think } => run_inference(&text, max_tokens, think),
Command::Convert { output } => run_convert(&output),
}
}
fn run_inference(text: &str, max_tokens: Option<usize>, think: bool) -> Result<()> {
use std::time::Instant;
println!("MiniCPM5-1B 推理 [{}]", if think { "思考模式" } else { "直接回答" });
let device = burn::backend::wgpu::WgpuDevice::default();
burn::backend::wgpu::init_setup::<burn::backend::wgpu::graphics::Vulkan>(
&device,
Default::default(),
);
let config = LlamaConfig::from_json("MiniCPM5-1B/config.json")?;
let tokenizer = TokenizerWrapper::from_file("MiniCPM5-1B/tokenizer.json")?;
let model = LlamaForCausalLM::<Backend>::new(config.clone(), &device);
let model = load_safetensors(model, std::path::Path::new("MiniCPM5-1B/model-00000-of-00001.safetensors"), &device)?;
let input_ids = tokenizer.apply_chat_template(text, think)?;
let gen_config = GenerationConfig {
max_new_tokens: max_tokens,
temperature: if think { 0.9 } else { 0.7 },
top_p: 0.95,
};
let start = Instant::now();
let output_ids = generation::generate_with_cache(
&model,
&input_ids,
&gen_config,
&config.eos_token_id,
&device,
);
let elapsed = start.elapsed();
let new_ids = &output_ids[input_ids.len()..];
if !new_ids.is_empty() {
println!("\n输出: {}", tokenizer.decode(new_ids, true)?);
}
println!("\n耗时: {:.2}s", elapsed.as_secs_f64());
println!("速度: {:.2} tokens/s", (output_ids.len() - input_ids.len()) as f64 / elapsed.as_secs_f64());
Ok(())
}
fn run_convert(output: &str) -> Result<()> {
println!("MiniCPM5-1B 模型转换");
let device = burn::backend::wgpu::WgpuDevice::default();
burn::backend::wgpu::init_setup::<burn::backend::wgpu::graphics::Vulkan>(
&device,
Default::default(),
);
minicpm_burn_lib::export_model::<Backend>(
std::path::Path::new("MiniCPM5-1B/model-00000-of-00001.safetensors"),
std::path::Path::new("MiniCPM5-1B/config.json"),
std::path::Path::new(output),
&device,
)?;
println!("\n转换完成!输出目录: {}", output);
Ok(())
}