diff --git a/docs/zh/docs/DevStation/roo-code/pic/1-install.png b/docs/zh/docs/DevStation/roo-code/pic/1-install.png new file mode 100644 index 0000000000000000000000000000000000000000..5bf50631625f692e4194e84b9e01c525d75a9e40 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/1-install.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/2-create-key.png b/docs/zh/docs/DevStation/roo-code/pic/2-create-key.png new file mode 100644 index 0000000000000000000000000000000000000000..e5ca599d420091ed7d1a27b921683dadf97cd3af Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/2-create-key.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/3-api-key.png b/docs/zh/docs/DevStation/roo-code/pic/3-api-key.png new file mode 100644 index 0000000000000000000000000000000000000000..bf1267b278008cbe2c12fd79db8bfc4fbd485687 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/3-api-key.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/4-settings.png b/docs/zh/docs/DevStation/roo-code/pic/4-settings.png new file mode 100644 index 0000000000000000000000000000000000000000..7053ebbcac8d9dcdf5977e57cabe140014877c2a Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/4-settings.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/5-chinese.png b/docs/zh/docs/DevStation/roo-code/pic/5-chinese.png new file mode 100644 index 0000000000000000000000000000000000000000..0d7fc67d8d12ceec14d1b4dfd3907e7376b010c2 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/5-chinese.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/6-start.png b/docs/zh/docs/DevStation/roo-code/pic/6-start.png new file mode 100644 index 0000000000000000000000000000000000000000..b78392560d502bf654424ad273ec2c8f96e505b6 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/6-start.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/7-input-task.png b/docs/zh/docs/DevStation/roo-code/pic/7-input-task.png new file mode 100644 index 0000000000000000000000000000000000000000..38d475618ccac3b6958bf361677f6f7ecf5ded7d Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/7-input-task.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/8-save.png b/docs/zh/docs/DevStation/roo-code/pic/8-save.png new file mode 100644 index 0000000000000000000000000000000000000000..89a2a438b0917d7a5d665c03184e6ccfc0272cd5 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/8-save.png differ diff --git a/docs/zh/docs/DevStation/roo-code/pic/9-iterate.png b/docs/zh/docs/DevStation/roo-code/pic/9-iterate.png new file mode 100644 index 0000000000000000000000000000000000000000..0fc7bae99d0975024c4f9a412205d95a236ef211 Binary files /dev/null and b/docs/zh/docs/DevStation/roo-code/pic/9-iterate.png differ diff --git a/docs/zh/docs/DevStation/roo-code/roo-code.md b/docs/zh/docs/DevStation/roo-code/roo-code.md new file mode 100644 index 0000000000000000000000000000000000000000..d49899a939a4f2b9e002351e157c48a071d8b354 --- /dev/null +++ b/docs/zh/docs/DevStation/roo-code/roo-code.md @@ -0,0 +1,14 @@ +# roo-code用户指南 + +## 简介 + +Roo Code是vscodium中的AI代理插件，有以下功能： + +- 通过自然语言描述生成代码 +- 重构和调试现有代码 +- 编写和更新文档 +- 回答关于代码库的问题 +- 自动化重复任务 +- 创建新文件和项目 + +本文档简要介绍openEuler系统中Roo Code安装卸载及使用指导。若要了解更多内容，可参考[官方文档](https://docs.roocode.com)。 diff --git "a/docs/zh/docs/DevStation/roo-code/\345\210\233\345\273\272\344\275\240\347\232\204\347\254\254\344\270\200\344\270\252\344\273\273\345\212\241.md" "b/docs/zh/docs/DevStation/roo-code/\345\210\233\345\273\272\344\275\240\347\232\204\347\254\254\344\270\200\344\270\252\344\273\273\345\212\241.md" new file mode 100644 index 0000000000000000000000000000000000000000..7610526b926b3a9e6f5787608f2be7a4d5b1676e --- /dev/null +++ "b/docs/zh/docs/DevStation/roo-code/\345\210\233\345\273\272\344\275\240\347\232\204\347\254\254\344\270\200\344\270\252\344\273\273\345\212\241.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/docs/DevStation/roo-code/\345\256\211\350\243\205\345\215\270\350\275\275\346\214\207\345\257\274.md" "b/docs/zh/docs/DevStation/roo-code/\345\256\211\350\243\205\345\215\270\350\275\275\346\214\207\345\257\274.md" new file mode 100644 index 0000000000000000000000000000000000000000..aa19561cd253314e0cbdc2b27a00dd6c1feb347f --- /dev/null +++ "b/docs/zh/docs/DevStation/roo-code/\345\256\211\350\243\205\345\215\270\350\275\275\346\214\207\345\257\274.md" @@ -0,0 +1,26 @@ +# 安装卸载指导 + +## 环境要求 + +- 操作系统：openEuler 25.03 +- 已安装桌面系统并能够正常进入桌面 + +## 安装 + +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/docs/DevStation/roo-code/\350\256\276\347\275\256API\347\247\230\351\222\245\345\222\214\350\257\255\350\250\200.md" "b/docs/zh/docs/DevStation/roo-code/\350\256\276\347\275\256API\347\247\230\351\222\245\345\222\214\350\257\255\350\250\200.md" new file mode 100644 index 0000000000000000000000000000000000000000..e1415ddb98f9430c6e8a33bc537d558393ef3b24 --- /dev/null +++ "b/docs/zh/docs/DevStation/roo-code/\350\256\276\347\275\256API\347\247\230\351\222\245\345\222\214\350\257\255\350\250\200.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/docs/zh/menu/index.md b/docs/zh/menu/index.md index 99725f2bac6d96036930c0c2cb2feb6971f967be..73a4c4ba91fb488d62519a40de0a53c9fff2f756 100644 --- a/docs/zh/menu/index.md +++ b/docs/zh/menu/index.md @@ -396,3 +396,7 @@ headless: true - [oeDevPlugin用户指南]({{< relref "./docs/DevStation/oeGitExt/oeGitExt.md" >}}) - [oeDevPlugin用户指南]({{< relref "./docs/DevStation/oeDevPlugin/oeDevPlugin.md" >}}) - [oeDevPlugin使用指导]({{< relref "./docs/DevStation/oeDevPlugin/使用指导.md" >}}) + - [Roo Code用户指南]({{< relref "./docs/DevStation/roo-code/roo-code.md" >}}) + - [安装卸载指导]({{< relref "./docs/DevStation/roo-code/安装卸载指导.md" >}}) + - [设置API秘钥和语言]({{< relref "./docs/DevStation/roo-code/设置API秘钥和语言.md" >}}) + - [创建你的第一个任务]({{< relref "./docs/DevStation/roo-code/创建你的第一个任务.md" >}})