mingren119 发表于 2025-6-20 17:28:11

手把手教你如何使用Roo Code的上下文压缩及代码库索引！

<p>这篇文章会教会你如何配置 <code>Roo Code</code>的上下文压缩和代码库索引。这对你使用roo-code很有帮助。<br />
文章中使用的是Roo Code 3.21.1版本。</p>
<h2>一、上下文压缩</h2>
<p>有时候模型上下文不高，但代码量很大。经常执行任务时超出上下文，导致Roo Code请求失败。现在我们一起来解决这个问题。<br />
以claude-sonnet-4为例，上下文200000。</p>
<h3>1.1 配置模型的上下文</h3>
<blockquote>
<p>如果用的官方渠道或者OpenRouter，上下文已由插件配置好，可以略过这一步。</p>
</blockquote>
<p>在插件的 <code>设置 -&gt; 供应商 -&gt; 上下文窗口大小</code> 里面设置你的上下文：200000。</p>
<p>模型上下文配置截图</p>
<p><img src="https://images.bigseek.com//forum/202506/20/172716qhrqrwx083bhqdwx.jpeg" alt="3bed16e747c10aee612348ce936a1e232b4dd806.jpeg" title="3bed16e747c10aee612348ce936a1e232b4dd806.jpeg" /></p>
<h3>1.2 配置上下文参数</h3>
<p>在插件的 <code>设置 -&gt; 上下文</code> 中有各项参数设定：</p>
<ul>
<li><code>标签页数量限制</code></li>
<li><code>工作区文件限制</code></li>
<li><code>并发文件读取限制</code></li>
</ul>
<p>这几项根据你的模型上下文自由调整即可，一般不修改默认即可。</p>
<p><strong>重点：</strong></p>
<ul>
<li>开启 <code>自动触发智能上下文压缩</code>功能。</li>
<li>设定 <code>压缩阈值比例</code>，90%左右。（阈值比例根据你的模型上下文，如果上下文小阈值也设置小一点，反之，阈值可以调整稍大。）</li>
<li><code>压缩提示词</code>，默认即可。</li>
</ul>
<p><img src="https://images.bigseek.com//forum/202506/20/172744fnmpzn183dmi5een.webp" alt="c8f7945b30473b7f66510f830846c325e63e1e5c.webp" title="c8f7945b30473b7f66510f830846c325e63e1e5c.webp" /></p>
<p>这样就完成了所有上下文压缩的相关配置。在你使用过程中，如果上下文达到阈值就会使用AI总结压缩提示词，避免请求超出上下文报错。</p>
<h2>二、代码库索引</h2>
<p>目前还是实验性功能。使用RAG给整个代码库创建索引，当你需要搜索文件查找某个功能时，就会使用RAG向量搜索，而不会让Roo Code全文件搜。</p>
<h3>2.1 部署 <code>Qdrant</code></h3>
<p>此功能依赖Qdrant，直接使用 <code>docker-compose.yml</code>部署：</p>
<pre data-code-wrap="yml" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-yaml">services:
qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: always
    ports:
      - &quot;6333:6333&quot;
      - &quot;6334:6334&quot;
    volumes:
      - ./data:/qdrant/storage
</code></pre>
<p>执行命令：<br />
<code>docker compose up -d</code></p>
<blockquote>
<p>具体的docker相关使用教程此处不展开说明。<br />
如果你有现成的Qdrant云服务，也可跳过这一步，后续教程中使用云服务的地址和key即可。</p>
</blockquote>
<h3>2.1 配置插件</h3>
<p>教程以我的公益站今天开放的嵌入模型为例，所以大家先去领一个免费无限制使用的key，具体参考帖子：https://linux.do/t/topic/739820</p>
<p><code>设置 -&gt; 实验性 -&gt; 启用代码库索引</code>，开启选项后，下面是具体的配置：</p>
<ul>
<li><code>嵌入供应商</code>：OpenAI 兼容</li>
<li><code>基础URL</code>：<code>https://tbai.xin/v1</code></li>
<li><code>秘钥</code>：填写你领取到的key</li>
<li><code>模型</code>：<code>qwen3-embedding-8b</code></li>
<li><code>嵌入维度</code>：<code>4096</code></li>
<li><code>Qdrant URL</code>：<code>http://localhost:6333</code></li>
<li><code>Qdrant 密钥：</code> 为空即可（如果你使用的云服务，请正确填写云服务的地址和秘钥）</li>
</ul>
<p>点击顶部的保存，现在就会开始进行向量化代码库索引了。</p>
<p><img src="data/attachment/forum/202506/20/172931sg0g8seehsrvgk2k.webp" alt="7c729a2d3e85c2409d36055f16de0d0e708ac9f5.webp" title="7c729a2d3e85c2409d36055f16de0d0e708ac9f5.webp" /></p>
<blockquote>
<p>由于该实验性功能不稳定，如果索引失败，请重启IDE再试。使用过程中也可能有bug，目前暂供体验。</p>
</blockquote>
<p>如果如截图中显示 <code>Indexed - File watcher started.</code>，那就是成功了。<br />
现在可以愉快的让Roo Code帮你进行查找了。</p>

1qaz 发表于 2025-6-20 17:30:05

第一第一

davie67 发表于 2025-6-20 17:30:12

前来学习

cdlzguo 发表于 2025-6-20 17:30:30

暂时不要用 roocode的索引 非常不稳定

kallen007 发表于 2025-6-20 17:30:58

来学习了，这个相当有用

longxx888 发表于 2025-6-20 17:31:14

roo code 这个索引有bug，容易出错

mingren119 发表于 2025-6-20 17:31:34

longxx888 发表于 2025-6-20 17:31
roo code 这个索引有bug，容易出错

是的，实验性，有点不稳定。

e999 发表于 2025-6-20 17:31:45

longxx888 发表于 2025-6-20 17:31
roo code 这个索引有bug，容易出错

概率大吗？trae 好像有时候也会出错

lihanyue 发表于 2025-6-20 17:32:06

太强了，立即设置

冷白 发表于 2025-8-10 14:30:02

这配置看着挺复杂

冰点精灵 发表于 2025-8-25 22:00:03

这教程看着挺复杂
页: [1]
查看完整版本: 手把手教你如何使用Roo Code的上下文压缩及代码库索引！