> 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/env-dependencies.md).

# 環境依賴

環境依賴用嚟 **管理 Cherry Studio 運行部分進階功能所需嘅二進制工具同運行時**。例如 [MCP 服務](/docs/zhong-wen-fan-ti/advanced-basic/extensions/mcp.md)、[技能](/docs/zhong-wen-fan-ti/advanced-basic/extensions/skills.md)、[Agent](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) 嘅一啲能力，底層要調用 `uv`、`bun` 等命令列工具。Cherry Studio 將佢哋集中喺呢度，等你唔使手動去命令列安裝配置。

打開 `設定 → 環境依賴`：

<figure><img src="/files/4bf36b7cb556de0572a692ce461ff5693c3a0669" alt=""><figcaption><p>環境依賴：內置同可安裝嘅工具</p></figcaption></figure>

### 內置同可安裝

每個工具以卡片形式展示，並標注狀態：

* 標有 <mark style="color:blue;">**內置**</mark> 嘅工具會隨 Cherry Studio 一齊分發，開箱即用，唔使操作。
* 未安裝嘅工具卡片上會出現 **安裝** 按鈕，撳落就可以由 Cherry Studio 自動下載並安裝到應用目錄，唔會污染你嘅系統環境。
* 卡片上提供源碼倉庫、官方文件連結，同埋打開本地安裝目錄嘅入口。

常見工具一覽：

| 工具               | 作用                                      |
| ---------------- | --------------------------------------- |
| **uv**           | 用於 MCP 服務同依賴安裝嘅 Python 套件管理工具           |
| **Bun**          | MCP 服務及相關工具鏈使用嘅 JavaScript 運行時          |
| **fd**           | 快速檔案查找工具，`find` 嘅替代品                    |
| **ripgrep (rg)** | 快速文本搜索工具，`grep` 嘅替代品                    |
| **RTK**          | 壓縮終端輸出、減少 LLM token 消耗嘅 CLI 代理工具        |
| **Lark CLI**     | 飛書官方 CLI，覆蓋消息 / 文檔 / 多維表格 / 日曆等 200+ 命令 |

頁面仲以卡片列出 `gh`（GitHub CLI）、`ntn`（Notion CLI）、`pi` 等工具，可按需一鍵安裝。（編程類 CLI 如 Claude Code / Codex 喺 [編碼拍檔](/docs/zhong-wen-fan-ti/cherry-studio/preview/code-cli.md) 頁管理，唔喺呢一頁。）

### 新增工具

頁面右上角嘅「**新增工具**」可用 mise 工具鍵，加入內置清單以外嘅工具（例如 `github:sharkdp/fd`、`uv`、`bun`）。

### 高級安裝設定

撳右上角嘅設定圖示打開「**高級安裝設定**」，微調工具嘅下載方式（欄位都可以留空用預設）：

* **GitHub 鏡像**：畀 GitHub Release 下載加代理前綴（如 `https://ghfast.top`），直連唔順暢時用。
* **GitHub 令牌**：提高工具查詢時嘅 GitHub API 速率限制（明文儲存在本地）。
* **npm 鏡像源 / pip 索引地址**：畀 `npm:` / `pipx:` 類工具設定鏡像（留空就喺中國大陸自動揀鏡像）。
* **校驗工具簽名**：校驗工具嘅 Sigstore / SLSA 簽名，一般保持開啟。

{% hint style="info" %}
普通用戶一般唔使喺呢度操作——需要某個工具時，相關功能（如安裝某個 MCP 服務）通常會引導你返嚟呢度一鍵安裝。呢個頁面更似係一個「運行環境體檢同補齊」嘅入口。
{% endhint %}

{% hint style="warning" %}
如果某個 MCP 服務或技能報錯提示「搵唔到 uv / bun / 命令唔存在」，先嚟呢度確認對應工具係咪已安裝或者係「內置」狀態（安裝狀態會自動刷新；右上角嗰個按鈕係 **檢查更新**，用嚟拉取工具嘅最新版本）。
{% 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/env-dependencies.md?ask=<question>&goal=<endgoal>
```

`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.