> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/settings/local-models.md).
# 本地模型
本地模型係 Cherry Studio 內置、**下載後就可以離線運行** 嘅細模型：唔會經任何服務商 API，亦都唔需要填 API Key。佢哋體積細、喺你自己部電腦上跑，專門用嚟兜底一啲「唔值得為咗佢單獨配一個雲端模型」嘅基礎能力。
打開 `設定 → 本地模型` 就可以管理：
而家內置兩類本地模型：
| 本地模型 | 底層 | 大小 | 用途 |
| ------------- | -------------------- | -------- | ---------------------------------------------------------------------------------- |
| **本地嵌入模型** | Qwen3 Embedding 0.6B | 約 614 MB | 將文字轉成向量，用於 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md) 檢索、召回等場景 |
| **本地 OCR 模型** | PaddleOCR PP-OCRv6 | 約 140 MB | 離線識別圖片／掃描件入面嘅文字，供 [OCR](/docs/zhong-wen-fan-ti/pre-basic/settings/ocr.md) 功能調用 |
### 下載同狀態
* 模型名稱旁邊會顯示狀態徽章：未下載嘅卡片 **底部** 有一條全寬「**下載**」按鈕，撳落去就開始下載；下載完成後徽章會變成 **已就緒**。
* 已就緒嘅模型可以撳右邊嘅 **刪除** 圖標移除，釋放磁碟空間；需要時可以再下載。（如果嵌入模型仲畀知識庫使用，刪除會被拒絕、權重會保留。）
* 少數平台／架構唔支援本地推理時，面板會顯示「**當前平台唔支援本地模型**」，呢個時候唔會提供下載。
下載嗰陣如果有一個鏡像唔可用，Cherry Studio 會自動試其他下載來源。下載完成後，本地嵌入模型嘅推理過程會喺本機運行，唔需要上網。
{% hint style="warning" %}
如果頁面提示【模型文件不完整，請重新下載修復。】，即係話本地快取缺少必要文件。刪除或者重新下載該模型就可以修復；唔好手動拼接模型文件。
{% endhint %}
{% hint style="info" %}
本地模型係 **可選項**。如果你已經喺 [模型服務](/docs/zhong-wen-fan-ti/pre-basic/providers/providers.md) 入面配置咗雲端嵌入模型，或者用系統自帶 OCR 已經夠用，可以唔下載佢哋。
{% endhint %}
### 咩時候用本地模型
* **冇雲端嵌入模型／唔想為知識庫單獨付費**：下載本地嵌入模型，知識庫就可以喺完全離線嘅情況下建立索引同檢索。
* **需要離線 OCR**：喺冇網絡、或者唔希望圖片上傳畀第三方嘅場景，下載本地 OCR 模型，配合 [OCR 設定](/docs/zhong-wen-fan-ti/pre-basic/settings/ocr.md) 揀「本地 PaddleOCR」就得。
* **隱私優先**：所有計算都喺本機完成，內容唔會離開你部電腦。
{% hint style="warning" %}
本地模型係「夠用就好」嘅輕量方案。如果對檢索精度或者識別準確率要求好高，雲端嘅 [嵌入模型](/docs/zhong-wen-fan-ti/knowledge-base/emb-models-info.md)、更強嘅 OCR 服務通常效果會更好。
{% endhint %}
***
### 攞幫助同提交意見
如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/settings/local-models.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.