diff --git a/docs/zh/_toc.yaml b/docs/zh/_toc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..32226043bd93f94f88311ab0e1dff1ca8b97efb9 --- /dev/null +++ b/docs/zh/_toc.yaml @@ -0,0 +1,12 @@ +label: Roo Code概述 +isManual: true +description: Roo Code是vscodium中的AI代理插件 +sections: + - label: roo-code概述 + href: ./index.md + - label: 安装卸载指导 + href: ./install/install-and-remove.md + - label: 设置API秘钥和语言 + href: ./manual/setting-api-key-and-language.md + - label: 创建你的第一个任务 + href: ./manual/create-your-first-task.md diff --git a/docs/zh/index.md b/docs/zh/index.md new file mode 100644 index 0000000000000000000000000000000000000000..3736fe95d5493de03f4adca627849cf2d82677a1 --- /dev/null +++ b/docs/zh/index.md @@ -0,0 +1,14 @@ +# roo-code概述 + +## 简介 + +Roo Code是vscodium中的AI代理插件,有以下功能: + +- 通过自然语言描述生成代码; +- 重构和调试现有代码; +- 编写和更新文档; +- 回答关于代码库的问题; +- 自动化重复任务; +- 创建新文件和项目。 + +本文档简要介绍openEuler系统中Roo Code安装卸载及使用指导。若要了解更多内容,可参考[官方文档](https://docs.roocode.com)。 diff --git a/docs/zh/install/install-and-remove.md b/docs/zh/install/install-and-remove.md new file mode 100644 index 0000000000000000000000000000000000000000..0a2371e13d92b2795f7a901e87f6b31f3f812c84 --- /dev/null +++ b/docs/zh/install/install-and-remove.md @@ -0,0 +1,26 @@ +# 安装卸载指导 + +## 环境要求 + +- 操作系统:openEuler 25.03/24.03-LTS-SP2; +- 已安装桌面系统并能够正常进入桌面。 + +## 安装 + +openEuler系统已引入Roo Code,可通过dnf安装: + +```bash +sudo dnf clean all +sudo dnf makecache +sudo dnf install roo-code +``` + +安装完成后重新打开vscodium,点击侧边栏root-code图标,如下所示: + +![安装](./pic/1-install.png) + +## 卸载 + +```bash +sudo dnf remove roo-code +``` diff --git a/docs/zh/manual/create-your-first-task.md b/docs/zh/manual/create-your-first-task.md new file mode 100644 index 0000000000000000000000000000000000000000..e6f197b68c417c9e03d5d5a20dee670310fa335f --- /dev/null +++ b/docs/zh/manual/create-your-first-task.md @@ -0,0 +1,41 @@ +# 创建你的第一个任务 + +## 1. 打开Roo Code面板 + +在vscodium点击Roo Code图标。 + +![打开](./pic/6-start.png) + +## 2. 输入任务 + +在底部输入栏,输入任务描述,如: + +- 创建一个名为hello.txt的文件,并写入 "Hello world!"; +- 用Python语言写一个能够计算两个数字之和的函数; +- 设计一个网页版的扫雷游戏,使用html,css和js,放在目录minesweeper下。 + +![输入](./pic/7-input-task.png) + +## 3. 发送任务 + +点击右下角发送按钮,即可发送任务。 + +## 4. 审核和批准操作 + +Roo Code会分析你的请求,并提出具体操作,这些操作包括: + +- 读取文件: 显示它需要访问的文件内容; +- 编辑文件: 显示建议更改的差异(新增行用绿色表示,删除行用红色); +- 运行命令: 显示在终端中执行的命令; +- 使用浏览器: 显示浏览器操作(点击、输入等); +- 请求澄清: 在需要时请求澄清以继续操作。 + +![保存](./pic/8-save.png) + +每个操作都需要你的批准(除非启用了auto-approval)。 + +## 5. 交互 + +Roo Code可与用户交互,在每个操作之后,他会等待您的反馈,然后提出下一步,直到您的任务完成。 + +![交互](./pic/9-iterate.png) diff --git a/docs/zh/manual/pic/1-install.png b/docs/zh/manual/pic/1-install.png new file mode 100644 index 0000000000000000000000000000000000000000..5bf50631625f692e4194e84b9e01c525d75a9e40 Binary files /dev/null and b/docs/zh/manual/pic/1-install.png differ diff --git a/docs/zh/manual/pic/2-create-key.png b/docs/zh/manual/pic/2-create-key.png new file mode 100644 index 0000000000000000000000000000000000000000..e5ca599d420091ed7d1a27b921683dadf97cd3af Binary files /dev/null and b/docs/zh/manual/pic/2-create-key.png differ diff --git a/docs/zh/manual/pic/3-api-key.png b/docs/zh/manual/pic/3-api-key.png new file mode 100644 index 0000000000000000000000000000000000000000..bf1267b278008cbe2c12fd79db8bfc4fbd485687 Binary files /dev/null and b/docs/zh/manual/pic/3-api-key.png differ diff --git a/docs/zh/manual/pic/4-settings.png b/docs/zh/manual/pic/4-settings.png new file mode 100644 index 0000000000000000000000000000000000000000..7053ebbcac8d9dcdf5977e57cabe140014877c2a Binary files /dev/null and b/docs/zh/manual/pic/4-settings.png differ diff --git a/docs/zh/manual/pic/5-chinese.png b/docs/zh/manual/pic/5-chinese.png new file mode 100644 index 0000000000000000000000000000000000000000..0d7fc67d8d12ceec14d1b4dfd3907e7376b010c2 Binary files /dev/null and b/docs/zh/manual/pic/5-chinese.png differ diff --git a/docs/zh/manual/pic/6-start.png b/docs/zh/manual/pic/6-start.png new file mode 100644 index 0000000000000000000000000000000000000000..b78392560d502bf654424ad273ec2c8f96e505b6 Binary files /dev/null and b/docs/zh/manual/pic/6-start.png differ diff --git a/docs/zh/manual/pic/7-input-task.png b/docs/zh/manual/pic/7-input-task.png new file mode 100644 index 0000000000000000000000000000000000000000..38d475618ccac3b6958bf361677f6f7ecf5ded7d Binary files /dev/null and b/docs/zh/manual/pic/7-input-task.png differ diff --git a/docs/zh/manual/pic/8-save.png b/docs/zh/manual/pic/8-save.png new file mode 100644 index 0000000000000000000000000000000000000000..89a2a438b0917d7a5d665c03184e6ccfc0272cd5 Binary files /dev/null and b/docs/zh/manual/pic/8-save.png differ diff --git a/docs/zh/manual/pic/9-iterate.png b/docs/zh/manual/pic/9-iterate.png new file mode 100644 index 0000000000000000000000000000000000000000..0fc7bae99d0975024c4f9a412205d95a236ef211 Binary files /dev/null and b/docs/zh/manual/pic/9-iterate.png differ diff --git a/docs/zh/manual/setting-api-key-and-language.md b/docs/zh/manual/setting-api-key-and-language.md new file mode 100644 index 0000000000000000000000000000000000000000..c620f52ad16e6b1314d830b82325d2d17a6197af --- /dev/null +++ b/docs/zh/manual/setting-api-key-and-language.md @@ -0,0 +1,33 @@ +# 设置API秘钥和语言 + +Roo Code需要通过API秘钥访问大模型,用户在使用前,需先申请秘钥。Roo Code支持的API提供商有openAI、DeepSeek等十余种,本文以硅基流动(SiliconFlow)为例进行介绍。 + +## 获取秘钥 + +1. 进入[SiliconFlow官网](https://siliconflow.cn/zh-cn/); +2. 使用你的账号登录; +3. 进入[API秘钥](https://cloud.siliconflow.cn/account/ak)页面,点击新建API秘钥,输入秘钥描述后,点击新建秘钥; +4. 秘钥创建成功后,复制秘钥。 + +![AIP秘钥](./pic/2-create-key.png) + +## 在Roo Code中设置API秘钥 + +1. 打开Roo Code; +2. API Provider栏选择OpenAI Compatible; +3. Base URL中输入SiliconFlow接口网址,如下图所示; +4. OpenAI API Key中输入复制的API秘钥; +5. Model栏输入使用的模型,本文使用Pro/deepseek-ai/DeepSeek-R1; +6. 输入完成后,点击Let's go,秘钥设置完成。 + +![AIP秘钥](./pic/3-api-key.png) + +## 设置语言为中文 + +Roo Code语言默认显示为英文,点击右上角设置按钮,页面拉到最下面,在language栏选择简体中文。 + +![设置](./pic/4-settings.png) + +选取成功后点击save按钮,语言修改为中文。 + +![中文](./pic/5-chinese.png) diff --git a/roo-code.spec b/roo-code.spec index 45f45557b0ae8924cdbe5bb0ec88aa9d984db357..7e99de381d116ab82179c5809d76adef2e386014 100644 --- a/roo-code.spec +++ b/roo-code.spec @@ -2,7 +2,7 @@ Name: roo-code Version: 3.10.5 -Release: 1 +Release: 2 Summary: Roo Code (prev. Roo Cline) gives you a whole dev team of AI agents in your code editor. License: Apache-2.0 URL: https://github.com/RooVetGit/Roo-Code @@ -47,5 +47,8 @@ mv extension %{buildroot}%{_datadir}/vscodium/resources/app/extensions/%{name} %changelog +* Thu Mar 27 2025 wangkui - 3.10.5-2 +- add docs + * Thu Mar 27 2025 wangkui - 3.10.5-1 - init