diff --git a/docs/zh/_toc.yaml b/docs/zh/_toc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..7cbfba173fc831e17486be00844219f7e159adfd --- /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/install/pic/1-install.png b/docs/zh/install/pic/1-install.png new file mode 100644 index 0000000000000000000000000000000000000000..798b4517ec2fd1a62a32fcf9c71ec0feb96a962a Binary files /dev/null and b/docs/zh/install/pic/1-install.png differ 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..b6433f71224a7e1d2023ffb07dbca393b6d85dcc --- /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/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..08699cb553ad315eb97881d0e8a35f0cc974b0d5 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..ff22004421efc271ed3d82e5f67960da0307718c 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..10882720c15ffbf60a7d503e421964cb11a1def5 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..737f7c9bb1110d6363106ee101fd573a62180e51 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..bb6865e386df733f5f70e0e99b0922daf7341cce 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..2467117554b17aec574d0a71b6a83dd5db67acf7 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..301ba9f8a2095da7b4653f093990e9232db59a2b 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..d4444f728884b4649df39c14241aa64f6d1ca001 --- /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按钮,在language栏选择简体中文。 + +![设置](./pic/4-settings.png) + +选取成功后点击save按钮,语言修改为中文,点击完成,可返回主页。 + +![中文](./pic/5-chinese.png) diff --git a/ripgrep.patch b/ripgrep.patch new file mode 100644 index 0000000000000000000000000000000000000000..d2269a39dcf19ef3664f3b6dba58a955b63bb571 --- /dev/null +++ b/ripgrep.patch @@ -0,0 +1,14 @@ +diff --git a/src/services/ripgrep/index.ts b/src/services/ripgrep/index.ts +index 01e2c26f..5ffd42df 100644 +--- a/src/services/ripgrep/index.ts ++++ b/src/services/ripgrep/index.ts +@@ -92,7 +92,8 @@ export async function getBinPath(vscodeAppRoot: string): Promise= 20.18.1 npm jq unzip libsecret-devel -Requires: vscodium +BuildRequires: nodejs-yarn nodejs-devel >= 20.18.2 npm jq unzip libsecret-devel +Requires: vscodium rust-ripgrep + + +Patch0: ripgrep.patch %description @@ -22,22 +25,21 @@ Roo Code (prev. Roo Cline) gives you a whole dev team of AI agents in your code %prep %setup -q -T -b 0 -c -n Roo-Code-%{version} -find . -name "package-lock.json" -exec sed -i 's|https://registry.yarnpkg.com/|https://mirrors.huaweicloud.com/repository/npm/|g' {} + -find . -name "package-lock.json" -exec sed -i 's|https://registry.npmjs.org/|https://mirrors.huaweicloud.com/repository/npm/|g' {} + -find . -name ".npmrc" -exec sed -i 's|https://registry.npmjs.org/|https://mirrors.huaweicloud.com/repository/npm/|g' {} + - +%autopatch -p1 -M 0 %build +npm config set registry https://mirrors.huaweicloud.com/repository/npm/ yarn config set registry https://mirrors.huaweicloud.com/repository/npm/ yarn config set tarball %{SOURCE1} -yarn add vsce -yarn run install:all -yarn run compile -yarn run build +sed -i 's|20.19.2|>=20.18.2|g' package.json +yarn run install +sed -i 's|require("brace-expansion")|import("brace-expansion")|' ./node_modules/.pnpm/minimatch@10.0.1/node_modules/minimatch/dist/commonjs/index.js +sed -i "s|require('brace-expansion')|import('brace-expansion')|" ./node_modules/.pnpm/minimatch@3.1.2/node_modules/minimatch/minimatch.js +./node_modules/.bin/pnpm vsix %install -unzip bin/$( jq -r '.name' "package.json" )-%{version}.vsix +unzip bin/roo-cline-%{version}.vsix mkdir -p %{buildroot}%{_datadir}/vscodium/resources/app/extensions/ mv extension %{buildroot}%{_datadir}/vscodium/resources/app/extensions/%{name} @@ -47,5 +49,17 @@ mv extension %{buildroot}%{_datadir}/vscodium/resources/app/extensions/%{name} %changelog -* Thu Mar 27 2025 wangkui - 3.10.5-1 +* Mon Jul 28 2025 wangkui35 - 3.25.14-1 +- update to 3.25.14-1 + +* Mon Jun 16 2025 wangkui35 - 3.19.3-1 +- update to 3.19.3-1 + +* Tue Jun 10 2025 wu-donger - 3.10.5-3 +- revise docs formatting guidelines + +* Thu Mar 27 2025 wangkui - 3.10.5-2 +- add docs + +* Thu Mar 27 2025 wangkui - 3.10.5-1 - init diff --git a/v3.10.5.tar.gz b/v3.10.5.tar.gz deleted file mode 100644 index 7edbd10240cc9742960de9bd2ecae64b8aaf5265..0000000000000000000000000000000000000000 Binary files a/v3.10.5.tar.gz and /dev/null differ diff --git a/v3.25.14.tar.gz b/v3.25.14.tar.gz new file mode 100644 index 0000000000000000000000000000000000000000..58d179db58c3dc8c7991c91bbe3cdae224169297 Binary files /dev/null and b/v3.25.14.tar.gz differ