MNN LLM 手机上内存不足时如何用 use_mmap、kvcache_mmap 和 chunk 规避溢出【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN在手机端用 MNN-LLM 跑量化 LLM 时有两类内存压力源一是llm.mnn.weight权重文件加载进内存二是推理过程中持续增长的 KV Cache。当设备可用内存吃不下这两部分时进程可能因内存溢出被系统杀死。MNN 的 LLM 引擎在运行时配置文件config.json中提供了三个针对内存占用的配置项use_mmap权重不足时转写磁盘、kvcache_mmapKV Cache 不足时转写磁盘和chunkprompt 分块运行三者可以组合使用把峰值内存压到设备可承受的范围。前提是你已经能按官方 LLM 文档完成模型导出和引擎编译模型目录model_dir下包含推理所需的全部文件config.json、llm_config.json、llm.mnn、llm.mnn.weight、tokenizer.mtok以及可能的embeddings_bf16.bin编译引擎时打开了-DMNN_BUILD_LLMON。以 Android 为例的编译方式官方文档给出的命令cd project/android mkdir build_64 ../build_64.sh -DMNN_BUILD_LLMON -DMNN_OPENCLON -DMNN_USE_LOGCATONmac / Linux 下则是make build cd build cmake ../ -DMNN_BUILD_LLMON make -j16编译产物中会生成llm_demo工具下面的配置和验证都围绕它展开。在 config.json 中开启三个内存配置项三个配置项的文档定义如下见 docs/transformers/llm.md 的推理配置一节英文文档 transformers/README.md 有相同说明配置项默认值作用use_mmapfalse使用 mmap 方式在内存不足时将权重写入磁盘避免溢出。手机上建议设成truekvcache_mmapfalse使用 mmap 方式在内存不足时将 KV Cache 写入磁盘避免溢出chunk无限制每次最大处理的 token 数高于此值将分块运行以减少内存占用如chunk: 128chunk_limits无限制每次处理的 token 数不在此范围内将分拆或者补零处理如chunk_limits: [128, 1]。存在chunk_limits时chunk配置无效tmp_path无启用 mmap 相关功能时写入磁盘的缓存目录三点需要注意use_mmap保护的是权重加载与驻留阶段kvcache_mmap保护的是推理过程中的 KV Cache 增长两者针对的是不同时刻的内存峰值长 prompt 或多轮对话场景下通常都要评估。chunk影响的是单次处理 prompt 的长度超过阈值的 prompt 会被分块运行。它降低的是 prefill 阶段的峰值内存代价是分块计算文档没有给出对应的性能损耗数据。tmp_path是 mmap 落盘目录磁盘上要有足够空间存放被换出的权重/KV 数据。iOS 上文档给出了创建并设置临时目录的示例Objective-CNSString *tempDirectory NSTemporaryDirectory(); llm-set_config({\tmp_path\:\ std::string([tempDirectory UTF8String]) \});仓库中有一个可直接参考的 mmap 示例配置 mmap_config.json其中use_mmap设为true。结合文档中的config.json示例一个面向手机内存受限场景的完整配置示例配置tmp_path需替换为设备上的实际可写目录Android 文档中的运行目录示例是/data/local/tmp/MNN/{ backend_type: cpu, thread_num: 4, precision: low, memory: low, use_mmap: true, kvcache_mmap: true, chunk: 128, tmp_path: /data/local/tmp/MNN/cache }其中precision: low表示尽量使用 fp16、memory: low表示开启运行时量化二者是文档给出的默认内存/精度策略与 mmap 配置相互独立保留即可。运行 llm_demo 并验证效果配置好config.json后用llm_demo验证用法见文档推理用法一节# 交互式聊天 ./llm_demo model_dir/config.json # 针对 prompt.txt 中的每行进行回复 ./llm_demo model_dir/config.json prompt.txt判断是否解决溢出问题的依据是同一模型、同一 prompt未开启 mmap/chunk 时会内存不足导致进程被杀或加载失败开启后能正常完成一次完整生成并输出回复。文档没有给出专门的mmap 已生效日志验证以能否跑通并正常输出为准。在 Android 设备上文档给出的运行方式是经过testCommon.sh推送并在设备上执行project/android/testCommon.sh ./llm_demo model/config.json如果你还想定量对比开启 mmap 前后的性能影响可以用llm_bench的-mmp--mmap参数做 A/B 测试该参数指定模型加载时是否使用 mmap 技术只接受一个值0或1# 关闭 mmap ./llm_bench -m ./model/config.json -a cpu -p 512 -n 128 -rep 3 -mmp 0 # 开启 mmap ./llm_bench -m ./model/config.json -a cpu -p 512 -n 128 -rep 3 -mmp 1文档对这一参数有一处明确结论-mmp对模型推理性能无影响即 mmap 换内存的方式本身不以推理速度为代价。边界与相关选项chunk_limits与chunk互斥配置了chunk_limits: [128, 1]之后chunk不再生效。chunk_limits的语义是把每次处理的 token 数约束在给定范围内范围外分拆或补零如果你需要固定块大小用chunk即可不要两个同时配。KV Cache 还有第二条减内存路径attention_mode可以开启 KV Cache 量化例如10为 FlashAttention KV-INT8文档标注精度几乎无损、14为 FlashAttention KV-TQ4文档标注内存节省超过 30%推荐 4B 模型使用小模型精度损失较大。它与kvcache_mmap不冲突一个减少 KV Cache 的体积一个在剩余空间仍不足时把它换出到磁盘。磁盘目录不可用时tmp_path指向的目录是权重与 KV Cache 的落盘位置如果目录不可写mmap 功能无法落盘。iOS 上建议按上文用NSTemporaryDirectory()获取系统临时目录Android 上可参考文档 Hexagon 一节的运行目录习惯/data/local/tmp/MNN/。三个配置项都收敛在config.json里改动后重新运行llm_demo即可生效如果目标设备内存仍然紧张下一步的文档化方向是换更小的量化模型或更小的模型规格如用llmexport.py的--quant_bit 4重新导出 4bit 模型而不是继续调这三个参数。【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
