[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-RooCodeInc--Roo-Code":3,"tool-RooCodeInc--Roo-Code":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",160784,2,"2026-04-19T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":102,"forks":103,"last_commit_at":104,"license":105,"difficulty_score":42,"env_os":106,"env_gpu":107,"env_ram":107,"env_deps":108,"category_tags":113,"github_topics":77,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":114,"updated_at":115,"faqs":116,"releases":146},9809,"RooCodeInc\u002FRoo-Code","Roo-Code","Roo Code gives you a whole dev team of AI agents in your code editor.","Roo Code 是一款集成在代码编辑器中的智能开发助手，旨在将强大的 AI 代理团队直接带入您的编程环境。它不仅能根据自然语言描述生成代码、重构现有逻辑或排查错误，还能编写文档、解答项目疑问并自动化重复性任务，有效解决了开发者在编码过程中上下文切换频繁、重复劳动多以及复杂问题定位难等痛点。\n\n这款工具特别适合软件工程师、全栈开发者及技术团队使用。其核心亮点在于灵活的“模式”系统：用户可根据当前需求切换至“编码模式”进行日常开发，“架构师模式”规划系统设计，“调试模式”追踪根因，或是“提问模式”快速获取解释。此外，Roo Code 支持自定义模式以适应特定工作流，并兼容 MCP 服务器及多种主流 AI 模型提供商（如 Poe、xAI 等），让开发者能够在一个界面内高效调度不同的 AI 能力，如同拥有一支随时待命的虚拟开发团队，显著提升研发效率与代码质量。","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=RooVeterinaryInc.roo-cline\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code_Marketplace-007ACC?style=flat&logo=visualstudiocode&logoColor=white\" alt=\"VS Code Marketplace\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fx.com\u002Froocode\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Froocode-000000?style=flat&logo=x&logoColor=white\" alt=\"X\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fyoutube.com\u002F@roocodeyt?feature=shared\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-FF0000?style=flat&logo=youtube&logoColor=white\" alt=\"YouTube\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Froocode\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20Discord-5865F2?style=flat&logo=discord&logoColor=white\" alt=\"Join Discord\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20r%2FRooCode-FF4500?style=flat&logo=reddit&logoColor=white\" alt=\"Join r\u002FRooCode\">\u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Cem>Get help fast → \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Froocode\">Join Discord\u003C\u002Fa> • Prefer async? → \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F\">Join r\u002FRooCode\u003C\u002Fa>\u003C\u002Fem>\n\u003C\u002Fp>\n\n# Roo Code\n\n> Your AI-Powered Dev Team, Right in Your Editor\n\n## What's New in v3.52.0\n\n- Add Poe as an AI provider so you can access Poe models directly in Roo Code.\n- Improve the xAI provider with a Responses API migration, reusable transform utilities, and updated Grok-4.20 defaults.\n- Fix MiniMax model listings and context window handling for more reliable setup.\n\n\u003Cdetails>\n  \u003Csummary>🌐 Available languages\u003C\u002Fsummary>\n\n- [English](README.md)\n- [Català](locales\u002Fca\u002FREADME.md)\n- [Deutsch](locales\u002Fde\u002FREADME.md)\n- [Español](locales\u002Fes\u002FREADME.md)\n- [Français](locales\u002Ffr\u002FREADME.md)\n- [हिंदी](locales\u002Fhi\u002FREADME.md)\n- [Bahasa Indonesia](locales\u002Fid\u002FREADME.md)\n- [Italiano](locales\u002Fit\u002FREADME.md)\n- [日本語](locales\u002Fja\u002FREADME.md)\n- [한국어](locales\u002Fko\u002FREADME.md)\n- [Nederlands](locales\u002Fnl\u002FREADME.md)\n- [Polski](locales\u002Fpl\u002FREADME.md)\n- [Português (BR)](locales\u002Fpt-BR\u002FREADME.md)\n- [Русский](locales\u002Fru\u002FREADME.md)\n- [Türkçe](locales\u002Ftr\u002FREADME.md)\n- [Tiếng Việt](locales\u002Fvi\u002FREADME.md)\n- [简体中文](locales\u002Fzh-CN\u002FREADME.md)\n- [繁體中文](locales\u002Fzh-TW\u002FREADME.md)\n- ...\n  \u003C\u002Fdetails>\n\n---\n\n## What Can Roo Code Do For YOU?\n\n- Generate Code from natural language descriptions and specs\n- Adapt with Modes: Code, Architect, Ask, Debug, and Custom Modes\n- Refactor & Debug existing code\n- Write & Update documentation\n- Answer Questions about your codebase\n- Automate repetitive tasks\n- Utilize MCP Servers\n\n## Modes\n\nRoo Code adapts to how you work:\n\n- Code Mode: everyday coding, edits, and file ops\n- Architect Mode: plan systems, specs, and migrations\n- Ask Mode: fast answers, explanations, and docs\n- Debug Mode: trace issues, add logs, isolate root causes\n- Custom Modes: build specialized modes for your team or workflow\n\nLearn more: [Using Modes](https:\u002F\u002Fdocs.roocode.com\u002Fbasic-usage\u002Fusing-modes) • [Custom Modes](https:\u002F\u002Fdocs.roocode.com\u002Fadvanced-usage\u002Fcustom-modes)\n\n## Tutorial & Feature Videos\n\n\u003Cdiv align=\"center\">\n\n|                                                                                                                                                                           |                                                                                                                                                                            |                                                                                                                                                                          |\n| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=Mcq3r1EPZ-4\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_0daa9cced969.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Installing Roo Code\u003C\u002Fb> | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ZBML8h5cCgo\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_0d417d93f38d.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Configuring Profiles\u003C\u002Fb> | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=r1bpod1VWhg\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_2fd221b6d428.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Codebase Indexing\u003C\u002Fb>  |\n|    \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=iiAv1eKOaxk\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_3122a54d70ab.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Custom Modes\u003C\u002Fb>     |     \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=Ho30nyY332E\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_d6f5597b0776.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Checkpoints\u003C\u002Fb>      | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=HmnNSasv7T8\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_135e25c6bacf.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>Context Management\u003C\u002Fb> |\n\n\u003C\u002Fdiv>\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fdocs.roocode.com\u002Ftutorial-videos\">More quick tutorial and feature videos...\u003C\u002Fa>\n\u003C\u002Fp>\n\n## Resources\n\n- **[Documentation](https:\u002F\u002Fdocs.roocode.com):** The official guide to installing, configuring, and mastering Roo Code.\n- **[YouTube Channel](https:\u002F\u002Fyoutube.com\u002F@roocodeyt?feature=shared):** Watch tutorials and see features in action.\n- **[Discord Server](https:\u002F\u002Fdiscord.gg\u002Froocode):** Join the community for real-time help and discussion.\n- **[Reddit Community](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode):** Share your experiences and see what others are building.\n- **[GitHub Issues](https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues):** Report bugs and track development.\n- **[Feature Requests](https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fdiscussions\u002Fcategories\u002Ffeature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop):** Have an idea? Share it with the developers.\n\n---\n\n## Local Setup & Development\n\n1. **Clone** the repo:\n\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code.git\n```\n\n2. **Install dependencies**:\n\n```sh\npnpm install\n```\n\n3. **Run the extension**:\n\nThere are several ways to run the Roo Code extension:\n\n### Development Mode (F5)\n\nFor active development, use VSCode's built-in debugging:\n\nPress `F5` (or go to **Run** → **Start Debugging**) in VSCode. This will open a new VSCode window with the Roo Code extension running.\n\n- Changes to the webview will appear immediately.\n- Changes to the core extension will also hot reload automatically.\n\n### Automated VSIX Installation\n\nTo build and install the extension as a VSIX package directly into VSCode:\n\n```sh\npnpm install:vsix [-y] [--editor=\u003Ccommand>]\n```\n\nThis command will:\n\n- Ask which editor command to use (code\u002Fcursor\u002Fcode-insiders) - defaults to 'code'\n- Uninstall any existing version of the extension.\n- Build the latest VSIX package.\n- Install the newly built VSIX.\n- Prompt you to restart VS Code for changes to take effect.\n\nOptions:\n\n- `-y`: Skip all confirmation prompts and use defaults\n- `--editor=\u003Ccommand>`: Specify the editor command (e.g., `--editor=cursor` or `--editor=code-insiders`)\n\n### Manual VSIX Installation\n\nIf you prefer to install the VSIX package manually:\n\n1.  First, build the VSIX package:\n    ```sh\n    pnpm vsix\n    ```\n2.  A `.vsix` file will be generated in the `bin\u002F` directory (e.g., `bin\u002Froo-cline-\u003Cversion>.vsix`).\n3.  Install it manually using the VSCode CLI:\n    ```sh\n    code --install-extension bin\u002Froo-cline-\u003Cversion>.vsix\n    ```\n\n---\n\nWe use [changesets](https:\u002F\u002Fgithub.com\u002Fchangesets\u002Fchangesets) for versioning and publishing. Check our `CHANGELOG.md` for release notes.\n\n---\n\n## Disclaimer\n\n**Please note** that Roo Code, Inc does **not** make any representations or warranties regarding any code, models, or other tools provided or made available in connection with Roo Code, any associated third-party tools, or any resulting outputs. You assume **all risks** associated with the use of any such tools or outputs; such tools are provided on an **\"AS IS\"** and **\"AS AVAILABLE\"** basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and\u002For personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof).\n\n---\n\n## Contributing\n\nWe love community contributions! Get started by reading our [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n## License\n\n[Apache 2.0 © 2025 Roo Code, Inc.](.\u002FLICENSE)\n\n---\n\n**Enjoy Roo Code!** Whether you keep it on a short leash or let it roam autonomously, we can’t wait to see what you build. If you have questions or feature ideas, drop by our [Reddit community](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F) or [Discord](https:\u002F\u002Fdiscord.gg\u002Froocode). Happy coding!\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=RooVeterinaryInc.roo-cline\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code_Marketplace-007ACC?style=flat&logo=visualstudiocode&logoColor=white\" alt=\"VS Code Marketplace\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fx.com\u002Froocode\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Froocode-000000?style=flat&logo=x&logoColor=white\" alt=\"X\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fyoutube.com\u002F@roocodeyt?feature=shared\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-FF0000?style=flat&logo=youtube&logoColor=white\" alt=\"YouTube\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Froocode\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20Discord-5865F2?style=flat&logo=discord&logoColor=white\" alt=\"Join Discord\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20r%2FRooCode-FF4500?style=flat&logo=reddit&logoColor=white\" alt=\"Join r\u002FRooCode\">\u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Cem>快速获得帮助 → \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Froocode\">加入 Discord\u003C\u002Fa> • 更喜欢异步交流？→ \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F\">加入 r\u002FRooCode\u003C\u002Fa>\u003C\u002Fem>\n\u003C\u002Fp>\n\n# Roo Code\n\n> 您的 AI 驱动开发团队，就在您的编辑器中\n\n## v3.52.0 版本更新内容\n\n- 新增 Poe 作为 AI 提供商，您现在可以直接在 Roo Code 中使用 Poe 的模型。\n- 改进了 xAI 提供商，包括 Responses API 的迁移、可复用的转换工具以及更新后的 Grok-4.20 默认设置。\n- 修复了 MiniMax 模型的列表显示及上下文窗口处理问题，使配置更加可靠。\n\n\u003Cdetails>\n  \u003Csummary>🌐 可用语言\u003C\u002Fsummary>\n\n- [English](README.md)\n- [Català](locales\u002Fca\u002FREADME.md)\n- [Deutsch](locales\u002Fde\u002FREADME.md)\n- [Español](locales\u002Fes\u002FREADME.md)\n- [Français](locales\u002Ffr\u002FREADME.md)\n- [हिंदी](locales\u002Fhi\u002FREADME.md)\n- [Bahasa Indonesia](locales\u002Fid\u002FREADME.md)\n- [Italiano](locales\u002Fit\u002FREADME.md)\n- [日本語](locales\u002Fja\u002FREADME.md)\n- [한국어](locales\u002Fko\u002FREADME.md)\n- [Nederlands](locales\u002Fnl\u002FREADME.md)\n- [Polski](locales\u002Fpl\u002FREADME.md)\n- [Português (BR)](locales\u002Fpt-BR\u002FREADME.md)\n- [Русский](locales\u002Fru\u002FREADME.md)\n- [Türkçe](locales\u002Ftr\u002FREADME.md)\n- [Tiếng Việt](locales\u002Fvi\u002FREADME.md)\n- [简体中文](locales\u002Fzh-CN\u002FREADME.md)\n- [繁體中文](locales\u002Fzh-TW\u002FREADME.md)\n- ...\n  \u003C\u002Fdetails>\n\n---\n\n## Roo Code 能为您做些什么？\n\n- 根据自然语言描述和规范生成代码\n- 通过多种模式灵活适应：代码模式、架构模式、提问模式、调试模式以及自定义模式\n- 重构和调试现有代码\n- 编写和更新文档\n- 回答关于代码库的问题\n- 自动化重复性任务\n- 利用 MCP 服务器\n\n## 模式\n\nRoo Code 可以根据您的工作方式灵活调整：\n\n- 代码模式：日常编码、编辑和文件操作\n- 架构模式：规划系统、规格说明和迁移方案\n- 提问模式：快速解答问题、提供解释和文档\n- 调试模式：追踪问题、添加日志并定位根本原因\n- 自定义模式：为您的团队或工作流程构建专用模式\n\n了解更多：[使用模式](https:\u002F\u002Fdocs.roocode.com\u002Fbasic-usage\u002Fusing-modes) • [自定义模式](https:\u002F\u002Fdocs.roocode.com\u002Fadvanced-usage\u002Fcustom-modes)\n\n## 教程与功能视频\n\n\u003Cdiv align=\"center\">\n\n|                                                                                                                                                                           |                                                                                                                                                                            |                                                                                                                                                                          |\n| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=Mcq3r1EPZ-4\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_0daa9cced969.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>安装 Roo Code\u003C\u002Fb> | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ZBML8h5cCgo\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_0d417d93f38d.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>配置个人资料\u003C\u002Fb> | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=r1bpod1VWhg\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_2fd221b6d428.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>代码库索引\u003C\u002Fb>  |\n|    \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=iiAv1eKOaxk\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_3122a54d70ab.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>自定义模式\u003C\u002Fb>     |     \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=Ho30nyY332E\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_d6f5597b0776.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>检查点\u003C\u002Fb>      | \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=HmnNSasv7T8\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_readme_135e25c6bacf.jpg\" width=\"100%\">\u003C\u002Fa>\u003Cbr>\u003Cb>上下文管理\u003C\u002Fb> |\n\n\u003C\u002Fdiv>\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fdocs.roocode.com\u002Ftutorial-videos\">更多快速教程和功能视频...\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 资源\n\n- **[文档](https:\u002F\u002Fdocs.roocode.com)：** 官方指南，助您安装、配置并精通 Roo Code。\n- **[YouTube 频道](https:\u002F\u002Fyoutube.com\u002F@roocodeyt?feature=shared)：** 观看教程，了解功能的实际应用。\n- **[Discord 服务器](https:\u002F\u002Fdiscord.gg\u002Froocode)：** 加入社区，获取实时帮助与讨论。\n- **[Reddit 社区](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode)：** 分享您的经验，看看其他人正在构建什么。\n- **[GitHub 问题](https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues)：** 报告错误并跟踪开发进度。\n- **[功能请求](https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fdiscussions\u002Fcategories\u002Ffeature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop)：** 有想法吗？与开发者分享吧。\n\n---\n\n## 本地搭建与开发\n\n1. **克隆**仓库：\n\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code.git\n```\n\n2. **安装依赖**：\n\n```sh\npnpm install\n```\n\n3. **运行扩展**：\n\n运行 Roo Code 扩展有多种方式：\n\n### 开发模式 (F5)\n\n对于活跃的开发工作，可以使用 VSCode 内置的调试功能：\n\n在 VSCode 中按下 `F5`（或进入 **Run** → **Start Debugging**）。这将打开一个新的 VSCode 窗口，其中运行着 Roo Code 扩展。\n\n- 对 Webview 的更改会立即生效。\n- 对核心扩展的更改也会自动热重载。\n\n### 自动化 VSIX 安装\n\n要构建扩展并将其作为 VSIX 包直接安装到 VSCode 中：\n\n```sh\npnpm install:vsix [-y] [--editor=\u003Ccommand>]\n```\n\n此命令将执行以下操作：\n\n- 提示选择要使用的编辑器命令（code\u002Fcursor\u002Fcode-insiders），默认为 'code'。\n- 卸载已存在的扩展版本。\n- 构建最新的 VSIX 包。\n- 安装新构建的 VSIX。\n- 提示您重启 VSCode 以使更改生效。\n\n选项：\n\n- `-y`：跳过所有确认提示并使用默认值。\n- `--editor=\u003Ccommand>`：指定编辑器命令（例如 `--editor=cursor` 或 `--editor=code-insiders`）。\n\n### 手动 VSIX 安装\n\n如果您更倾向于手动安装 VSIX 包：\n\n1. 首先，构建 VSIX 包：\n   ```sh\n   pnpm vsix\n   ```\n2. 将会在 `bin\u002F` 目录下生成一个 `.vsix` 文件（例如 `bin\u002Froo-cline-\u003Cversion>.vsix`）。\n3. 使用 VSCode CLI 手动安装：\n   ```sh\n   code --install-extension bin\u002Froo-cline-\u003Cversion>.vsix\n   ```\n\n---\n\n我们使用 [changesets](https:\u002F\u002Fgithub.com\u002Fchangesets\u002Fchangesets) 进行版本管理和发布。请查看我们的 `CHANGELOG.md` 以获取发布说明。\n\n---\n\n## 免责声明\n\n**请注意**，Roo Code, Inc 对于与 Roo Code 相关、任何第三方工具或由此产生的任何输出所涉及的代码、模型或其他工具不作任何陈述或保证。您需自行承担使用此类工具或输出所产生的全部风险；此类工具均按“现状”和“可获得性”提供。相关风险可能包括但不限于知识产权侵权、网络安全漏洞或攻击、偏见、不准确、错误、缺陷、病毒、服务中断、财产损失或损坏以及人身伤害等。您应对使用此类工具或输出的行为全权负责（包括但不限于其合法性、适当性及其结果）。\n\n---\n\n## 贡献\n\n我们非常欢迎社区贡献！请阅读我们的 [CONTRIBUTING.md](CONTRIBUTING.md)，开始您的贡献之旅。\n\n---\n\n## 许可证\n\n[Apache 2.0 © 2025 Roo Code, Inc.](.\u002FLICENSE)\n\n---\n\n**尽情享受 Roo Code 吧！** 无论您是将其严格控制在有限范围内，还是让它自主运行，我们都迫不及待地想看看您能创造出什么。如果您有任何问题或功能建议，欢迎访问我们的 [Reddit 社区](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRooCode\u002F) 或 [Discord](https:\u002F\u002Fdiscord.gg\u002Froocode)。祝编码愉快！","# Roo Code 快速上手指南\n\nRoo Code 是一款集成在 VS Code 中的 AI 驱动开发助手，能够根据你的自然语言描述生成代码、重构项目、调试错误以及管理文档。它支持多种工作模式（如编码、架构设计、调试等），是你的智能结对编程伙伴。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n- **操作系统**：Windows、macOS 或 Linux\n- **编辑器**：[Visual Studio Code](https:\u002F\u002Fcode.visualstudio.com\u002F) (推荐最新稳定版)\n- **网络环境**：由于需要连接 AI 模型服务，请确保网络畅通。如需访问 Discord 社区或特定模型接口，可能需要配置网络代理。\n- **前置依赖（仅针对本地开发\u002F贡献者）**：\n  - [Node.js](https:\u002F\u002Fnodejs.org\u002F) (建议 LTS 版本)\n  - [pnpm](https:\u002F\u002Fpnpm.io\u002F) 包管理器\n\n> **注意**：普通用户直接使用 VS Code 插件市场安装即可，无需安装 Node.js 和 pnpm。以下步骤主要针对想要从源码构建或参与开发的开发者。\n\n## 安装步骤\n\n### 方式一：通过 VS Code 市场安装（推荐普通用户）\n\n1. 打开 Visual Studio Code。\n2. 点击左侧活动栏的 **扩展 (Extensions)** 图标（或按 `Ctrl+Shift+X` \u002F `Cmd+Shift+X`）。\n3. 在搜索框中输入 `Roo Code`。\n4. 找到由 `Roo Veterinary Inc` 发布的插件，点击 **安装 (Install)**。\n5. 安装完成后，点击侧边栏出现的 Roo Code 图标即可启动。\n\n### 方式二：从源码构建安装（适合开发者）\n\n如果你希望体验最新版本或参与贡献，可以通过以下命令从 GitHub 克隆并构建：\n\n1. **克隆仓库**：\n   ```sh\n   git clone https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code.git\n   cd Roo-Code\n   ```\n\n2. **安装依赖**：\n   ```sh\n   pnpm install\n   ```\n   *(国内用户若下载依赖缓慢，可配置 pnpm 使用国内镜像源：`pnpm config set registry https:\u002F\u002Fregistry.npmmirror.com`)*\n\n3. **运行扩展（开发模式）**：\n   在 VS Code 中打开该项目文件夹，按下 `F5` 键（或选择 **运行 (Run)** -> **启动调试 (Start Debugging)**）。\n   - 这将启动一个新的 VS Code 窗口，其中已加载正在开发的 Roo Code 扩展。\n   - 代码修改会自动热重载。\n\n4. **打包安装（可选）**：\n   若需生成 `.vsix` 安装包手动安装到正式版 VS Code：\n   ```sh\n   pnpm vsix\n   ```\n   生成的文件位于 `bin\u002F` 目录下，随后使用命令行安装：\n   ```sh\n   code --install-extension bin\u002Froo-cline-\u003Cversion>.vsix\n   ```\n\n## 基本使用\n\n安装完成后，Roo Code 会出现在 VS Code 的侧边栏。以下是快速开始的核心流程：\n\n### 1. 配置 AI 提供商\n首次使用时，你需要配置 AI 模型提供商（如 OpenAI, Anthropic, xAI, Poe 等）：\n- 点击 Roo Code 图标打开面板。\n- 进入 **设置 (Settings)**，选择你拥有的 API 密钥对应的服务商。\n- 输入 API Key 并保存。\n- *注：v3.52.0+ 版本已支持直接接入 Poe 模型。*\n\n### 2. 选择工作模式 (Modes)\nRoo Code 提供多种预设模式以适应不同任务，点击模式切换按钮进行选择：\n- **Code Mode**：日常编码、文件编辑和操作（默认推荐）。\n- **Architect Mode**：用于系统规划、规格说明和迁移方案。\n- **Ask Mode**：快速获取代码解释、文档查询。\n- **Debug Mode**：追踪问题、添加日志、定位根因。\n- **Custom Modes**：自定义专属工作流。\n\n### 3. 发起第一个任务\n在对话框中输入自然语言指令，例如：\n\n```text\n请在当前目录下创建一个名为 utils.js 的文件，并导出一个用于格式化日期的函数 formatDate(date)。\n```\n\n或者让 AI 分析当前打开的文件：\n\n```text\n解释一下这个函数的逻辑，并指出是否有潜在的性能问题。\n```\n\nRoo Code 将自动读取上下文，生成代码或提供建议。你可以直接点击 **Apply** 按钮将更改应用到文件中，或在对话框中继续迭代修改。\n\n### 4. 进阶功能\n- **代码库索引 (Codebase Indexing)**：启用后可让 AI 理解整个项目结构，回答跨文件的问题。\n- **MCP 服务器**：连接外部工具和数据源，扩展 AI 能力边界。\n- **检查点 (Checkpoints)**：随时回滚到之前的对话状态或代码版本。\n\n现在，你可以在 VS Code 中享受高效的 AI 辅助开发体验了！","某初创团队的后端工程师需要在两天内将单体架构中的用户模块重构为微服务，并同步更新 API 文档与单元测试。\n\n### 没有 Roo-Code 时\n- **上下文切换频繁**：开发者需在不同标签页间反复跳转，手动查阅旧代码逻辑、编写新架构方案，再回到编辑器敲代码，思路极易被打断。\n- **多角色负担重**：一人分饰架构师、程序员和测试员，既要设计服务拆分边界，又要处理繁琐的样板代码，还要手动补全测试用例，精力严重分散。\n- **调试效率低下**：遇到迁移后的接口报错，需人工逐行添加日志、定位根因，往往花费数小时才找到隐蔽的空指针异常。\n- **文档滞后**：代码修改后，忘记同步更新 Swagger 文档或 README，导致前后端联调时因接口定义不一致而反复沟通。\n\n### 使用 Roo-Code 后\n- **工作流无缝衔接**：在 VS Code 中直接启用\"Architect Mode\"规划拆分方案，随即切换\"Code Mode\"自动生成迁移代码，全程无需离开编辑器。\n- **智能团队协作**：Roo-Code 像一支虚拟开发团队，自动根据架构设计生成符合规范的微服务代码，并主动创建覆盖边缘情况的单元测试文件。\n- **精准快速排错**：遭遇报错时，\"Debug Mode\"自动分析堆栈、插入诊断日志并隔离根因，将原本数小时的排查过程缩短至几分钟。\n- **文档实时同步**：代码重构完成后，Roo-Code 立即扫描变更并自动更新 API 文档与技术注释，确保文档与代码始终一致。\n\nRoo-Code 通过将多角色 AI 代理深度集成至编辑器，把原本需要多人协作数天的重构任务压缩为单人一天的高质量交付。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRooCodeInc_Roo-Code_0daa9cce.jpg","RooCodeInc","Roo Code","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FRooCodeInc_e04b9928.png","A whole dev team of AI agents in your editor",null,"support@roocode.com","roo_code","https:\u002F\u002Froocode.com","https:\u002F\u002Fgithub.com\u002FRooCodeInc",[83,87,91,94,98],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",98.8,{"name":88,"color":89,"percentage":90},"CSS","#663399",0.5,{"name":92,"color":93,"percentage":90},"JavaScript","#f1e05a",{"name":95,"color":96,"percentage":97},"Shell","#89e051",0.3,{"name":99,"color":100,"percentage":101},"HTML","#e34c26",0,23203,3007,"2026-04-19T13:57:36","Apache-2.0","Windows, macOS, Linux","未说明",{"notes":109,"python":107,"dependencies":110},"Roo Code 是一个 VS Code 扩展插件，并非独立的本地 AI 模型运行工具。它本身不消耗大量 GPU 或内存资源，而是作为客户端连接外部 AI 服务（如 Poe、xAI\u002FGrok、MiniMax 等）或用户自行配置的 API。运行环境主要要求是安装 Visual Studio Code 编辑器以及 Node.js 包管理工具 pnpm（用于开发或手动安装）。具体的计算资源需求取决于用户所连接的后端 AI 模型服务商。",[111,112],"Visual Studio Code","pnpm",[35,13,45],"2026-03-27T02:49:30.150509","2026-04-20T07:16:15.237950",[117,122,127,132,137,142],{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},44047,"使用 VS Code LM API (Copilot) 调用 Claude 3.7 Sonnet 时提示 \"Model is not supported\" 错误怎么办？","该问题通常与 VS Code Insider 版本或扩展字段变更有关。用户反馈在升级后仍遇到此问题，且发现 `x-onbehalf-extension-id` 字段已不再存在。建议检查是否使用了最新版的 VS Code Insider，并确认 Copilot 扩展是否为最新版本。如果问题持续，可能是第三方扩展被暂时限制，需等待官方修复或回退到稳定版 VS Code 尝试。","https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues\u002F1203",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},44048,"如何正确配置连接到 Azure AI Foundry (Azure OpenAI Service) 的模型？","在 Roo Code 中选择 \"OpenAI Compatible\" 作为 API 提供商，并勾选 \"Use Azure\" 选项。端点 URL (Endpoint URL) 应填写资源地址（例如：`https:\u002F\u002F\u003Cmyresource>.openai.azure.com\u002F`），并在模型选择器中指定具体的部署名称（如 `o1-mini` 或 `gpt-4o-mini`）。如果仍然报 404 错误，请确保 API 版本参数正确（如 `api-version=2025-01-01-preview`），或者尝试直接在设置中填入完整的模型目标端点 URL。注意：部分用户反馈在特定版本（如 v3.25.15 或 v3.46）中可能存在兼容性问题，若无法连接请尝试更新插件或检查相关 PR 的合并状态。","https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues\u002F1334",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},44049,"Roo Code 扩展出现灰屏\u002F黑屏\u002F界面卡死无法操作怎么办？","这是一个已知问题，通常由任务历史记录 (`taskHistory`) 数据过大导致内存溢出引起。临时解决方法是重启 VS Code。为了收集更多诊断信息，请以 `code --verbose` 命令启动 VS Code，当屏幕变灰时，复制终端输出和控制台错误日志（帮助 > 切换开发人员工具 > 控制台）。根本原因可能是历史数据存储在 VS Code 全局状态中且无上限，建议在后续版本中关注针对 SQLite 存储或历史查询优化的修复。如果频繁发生，尝试清理任务历史或减少并发实例数。","https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues\u002F5601",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},44050,"执行终端操作后 Roo Code 持续冻结或无响应如何解决？","该问题可能与终端提示符控制设置有关。解决方案是安装包含修复补丁的构建版本（如 `roo-cline-3.11.12-fix-misc-terminal-issues.vsix`），并在设置中启用 \"ZDOTDIR\" 选项或调整 \"Terminal Prompt control\" 相关配置。用户反馈启用这些选项后，连续执行终端任务时不再需要反复重启 VS Code。如果问题是在版本升级后出现的，检查设置中的终端相关选项是否被重置。","https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues\u002F2205",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},44051,"配置 Qdrant 进行代码库索引时出现 \"TypeError: fetch failed\" 错误但网络连通性正常，如何处理？","即使外部网络连接正常，Qdrant 连接失败通常是由于 Docker 容器网络配置、反向代理（如 Traefik）设置或 CORS 策略引起的。请检查 Qdrant 是否正确暴露在本地端口，并确保 VS Code 扩展能够直接访问该端口（避免通过复杂的反向代理链路，除非已正确配置转发）。如果是通过 Coolify 等工具部署，请验证容器间的网络通信规则。此外，确认使用的嵌入模型（如 `text-embedding-3-small`）与 Qdrant 版本兼容。","https:\u002F\u002Fgithub.com\u002FRooCodeInc\u002FRoo-Code\u002Fissues\u002F4092",{"id":143,"question_zh":144,"answer_zh":145,"source_url":131},44052,"在多窗口环境下运行 Roo Code 时，为什么有时黑屏有时正常？","这种行为不一致通常与资源竞争或特定窗口的状态管理有关。单窗口运行较长时间（1-2 小时）后容易触发灰屏\u002F黑屏，而多窗口环境下表现随机。这进一步印证了内存泄漏或状态存储过载的可能性。建议在长时间使用前保存工作进度，并定期重启 VS Code 以释放资源。如果遇到黑屏，右上角按钮将无法点击，必须完全重启软件才能恢复。",[147,152,157,162,167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242],{"id":148,"version":149,"summary_zh":150,"released_at":151},351571,"cli-v0.1.9","## What's New\n\n\n### Fixed\n\n- **Stdin Stream Cancel Race**: Fixed a race condition during startup cancellation in stdin-stream mode that could cause unexpected behavior when canceling tasks immediately after starting them.\n\n### Tests\n\n- **Integration Test Suite**: Added comprehensive integration test suite for stdin-stream protocol covering cancel, followup, multi-message queue, and shutdown scenarios.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.9 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\nc9d4f359ceb0e226da7a24eb055c3fb4fc4741199f50944e2e84267b949cbec5  roo-cli-darwin-arm64.tar.gz\na5fb4cd77a6f5e22b24f485b52c6194a22b16bca31adb7211c8bb7ae59f3c47f  roo-cli-linux-arm64.tar.gz\n7ee4ab328771df429cdd69cb8a23d493b7d5dfb5c6ef4407ec18af04d5eec69b  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T06:33:07",{"id":153,"version":154,"summary_zh":155,"released_at":156},351572,"cli-v0.1.8","## What's New\n\n\n### Changed\n\n- **Command Execution Timeout**: Increased timeout for command execution to improve reliability for long-running operations.\n\n### Fixed\n\n- **Stdin Stream Queue Handling**: Fixed stdin stream queued messages and command output streaming to ensure messages are properly processed.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.8 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\nd2608f3ce0f05fa9fa2b505c2ff1ad2ab01a65f6b00348a5785e55e93e00bde7  roo-cli-darwin-arm64.tar.gz\ne23bfa12a790f9792fe14fe64cab4ba3feb12fdab06ec9ba472defddcb9c33cc  roo-cli-linux-arm64.tar.gz\n280c8d1c3ef37de70ecc1339f5a79a6e756cf8a201047b211540264b34a64e4c  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T04:03:42",{"id":158,"version":159,"summary_zh":160,"released_at":161},351573,"cli-v0.1.7","## What's New\n\n\n### Fixed\n\n- **Stdin Stream Control Flow**: Gracefully handle control-flow errors in stdin-stream mode to prevent unexpected crashes during cancellation and shutdown sequences.\n\n### Changed\n\n- **Type Definitions**: Refactored and simplified JSON event type definitions for better type safety.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.7 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n96c4d0f19f06d918884d3ec0f6f5c769ed88bff2b6cf2a2c940f07484fe47171  roo-cli-darwin-arm64.tar.gz\n745440a9fd878e1c4dbff951c3d6d413ed5fae44240cec3a16b7cffbc6634cfe  roo-cli-linux-arm64.tar.gz\n45c26affd127296c1f1630ec6cf5e4467701da3b954d01f16b13e93b9c12ed3e  roo-cli-linux-x64.tar.gz\n```\n","2026-03-01T20:07:25",{"id":163,"version":164,"summary_zh":165,"released_at":166},351574,"cli-v0.1.6","## What's New\n\n\n### Added\n\n- **Consecutive Mistake Limit**: New `--mistake-limit` flag to configure the maximum number of consecutive mistakes before the agent pauses for intervention.\n\n### Changed\n\n- **Workspace-Scoped Sessions**: The `list sessions` command and `--resume` flag now only show and resume sessions from the current workspace directory.\n\n### Fixed\n\n- **Task Configuration Forwarding**: Task configuration (custom modes, disabled tools, etc.) passed via the stdin-prompt-stream protocol is now correctly forwarded to the extension host instead of being silently dropped.\n- **Stream Error Recovery**: Improved recovery from streaming errors to prevent task interruption.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.6 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n7e8ce71d5c25277a1bae54be202151d9236405dc7de7a53da51684a8c87a6fe4  roo-cli-darwin-arm64.tar.gz\n63cd3da918b013b140e20e948fc65f046208ff070b833ea39050b23ac724d0cd  roo-cli-linux-arm64.tar.gz\nf7265cba7f663060777353c44a59be849814fe8454db2c4def57a722447c6f8a  roo-cli-linux-x64.tar.gz\n```\n","2026-02-27T05:49:42",{"id":168,"version":169,"summary_zh":170,"released_at":171},351575,"cli-v0.1.5","## What's New\n\n\n### Added\n\n- **Session History**: New `list sessions` subcommand to view recent CLI sessions with task IDs, timestamps, and initial prompts.\n- **Session Resume**: New `--resume \u003CtaskId>` flag to continue a previous session from where it left off.\n- **Upgrade Command**: New `upgrade` command to check for and install the latest CLI version.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.5 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n7b72f3b76960abcc7fb74f50cf7d4bbdd33da884bc679d1a6bed8a7eba29b380  roo-cli-darwin-arm64.tar.gz\n50df8931d84fd5de80982c78103b74bd57b569e379d75e8451a650210fca3bb4  roo-cli-linux-arm64.tar.gz\n2aad64715772d669eed6e855c3ea926bee9a82753da70d8ce86362475bafeaa0  roo-cli-linux-x64.tar.gz\n```\n","2026-02-26T23:53:43",{"id":173,"version":174,"summary_zh":175,"released_at":176},351576,"cli-v0.1.4","## What's New\n\n\n### Fixed\n\n- **Exception Handling**: Improved recovery from unhandled exceptions in the CLI to prevent unexpected crashes.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.4 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n8e0e816f9af501a05d3230b70ee6a431dad707e4f3a6b8e490597f5502eccacc  roo-cli-darwin-arm64.tar.gz\n6d82116c26e0228d88d0ba59485dd15ec26542d4b32e10e4363f3f5fb7d7dbf0  roo-cli-linux-arm64.tar.gz\n2b757425c06e1c312f806f11c7947e5e0d3299ed456e2d4d1b7abddf149fb2c6  roo-cli-linux-x64.tar.gz\n```\n","2026-02-26T06:54:34",{"id":178,"version":179,"summary_zh":180,"released_at":181},351577,"cli-v0.1.3","## What's New\n\n\n### Fixed\n\n- **Task Resumption**: Fixed an issue where resuming a previously suspended task could fail due to state initialization timing in the extension host.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.3 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n2b056cd503255be4b9650931d29d76385587c7be86b5f6afe45abb1f348f9483  roo-cli-darwin-arm64.tar.gz\n0f3611c13808eabaf7562ca30e002da152468f827b6dffc60f46d7e8ac32943c  roo-cli-linux-arm64.tar.gz\n9978dd30dea2c2264352c172a1c3180b89ceb17206893c3f7d276ea2a0198ed8  roo-cli-linux-x64.tar.gz\n```\n","2026-02-25T09:30:44",{"id":183,"version":184,"summary_zh":185,"released_at":186},351578,"cli-v0.1.2","## What's New\n\n\n### Changed\n\n- **Streaming Deltas**: Tool use ask messages (command, tool, mcp) are now streamed as structured deltas instead of full snapshots in json-event-emitter for improved efficiency.\n- **Task ID Propagation**: Task ID is now generated upfront and propagated through runTask\u002FcreateTask so currentTaskId is available in extension state immediately.\n- **Custom Tools**: Enabled customTools experiment in extension host.\n\n### Fixed\n\n- **Cancel Recovery**: Wait for resumable state after cancel before processing follow-up messages to prevent race conditions in stdin-stream.\n- **Custom Tool Schema**: Provide valid empty JSON Schema for custom tools without parameters to fix strict-mode API validation.\n- **Path Handling**: Skip paths outside cwd in RooProtectedController to avoid RangeError.\n- **Retry Handling**: Silently handle abort during exponential backoff retry countdown.\n- Fixed spelling\u002Fgrammar and casing inconsistencies.\n\n### Added\n\n- **Telemetry Control**: Added `ROO_CODE_DISABLE_TELEMETRY=1` environment variable to disable cloud telemetry.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.2 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\nc8919cc89bc99c42d10e21d4a44166ec8ad214d63a9417e558c42154bdfe593c  roo-cli-darwin-arm64.tar.gz\nb8ca68de226f8941917e3af04c7d0e9e41d941d074e0b5cdfde2b6a7b0ca0b43  roo-cli-linux-arm64.tar.gz\n32309b4cf6d6176d479e44e43be66d7b35014710e91b87048f8db3c6af28c338  roo-cli-linux-x64.tar.gz\n```\n","2026-02-25T07:35:26",{"id":188,"version":189,"summary_zh":190,"released_at":191},351567,"cli-v0.1.13","## 新增内容\n\n\n### 新增\n\n- **技能作为斜杠命令**：技能现在可以作为斜杠命令使用，因此您可以直接从命令式输入调用技能工作流。\n- **技能回退执行**：当斜杠命令与命令文件不匹配但与技能别名匹配时，CLI 可以解析并执行该技能路径。\n\n### 变更\n\n- **斜杠命令解析优先级**：保留了命令的优先级顺序，只有在未找到匹配的斜杠命令时才会使用技能回退机制。\n\n### 测试\n\n- 添加并更新了斜杠命令 + 技能回退行为的测试，包括命令优先级和重复技能别名的处理。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装特定版本：\n```bash\nROO_VERSION=0.1.13 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n此版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\n7bf51a35dfd113b9d18b5c285c4c1d4c4e31a86c2a057fc0207f549944f4088f  roo-cli-darwin-arm64.tar.gz\ned6a4bba176568b47ff5fa20fdd53168483f21c63a323c75df4fa3e6e1f4ca5c  roo-cli-linux-arm64.tar.gz\nfb7c4e82888e084c75102d9ce4e0a3ff6f6ef4ed08ca5c212ca6c4c951d61f58  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T23:22:06",{"id":193,"version":194,"summary_zh":195,"released_at":196},351568,"cli-v0.1.12","## 新增内容\n\n\n### 修复\n\n- **命令超时处理**：CLI 运行时现在会正确忽略模型提供的后台超时设置，确保命令的生命周期仅由 `--timeout` 参数控制。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装指定版本：\n```bash\nROO_VERSION=0.1.12 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n本版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\n45b28f7c578e555a6c3a679977a744e9783c3ebb30a0c1dfec5fa886cac36337  roo-cli-darwin-arm64.tar.gz\nedf29223fd44628d93426ce981ef3df04c846d886c352fc99523bf789820bc8c  roo-cli-linux-arm64.tar.gz\n35f98a13e507331050fb1ad697aa81845fa5d54703d657de12f886ae743bae47  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T21:46:33",{"id":198,"version":199,"summary_zh":200,"released_at":201},351569,"cli-v0.1.11","## What's New\n\n\n### Added\n\n- **Image Support in Stdin Stream**: The `start` and `message` commands in stdin-stream mode now support an optional `images` field (array of base64 data URIs) to attach images to prompts.\n\n### Fixed\n\n- **Upgrade Version Detection**: Fixed version detection in the `upgrade` command to correctly identify when updates are available.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.11 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n3f0b87ea0eab5a153bf580e2c091608fe71cb3d172cd1a9d19dfb6ea0326cc27  roo-cli-darwin-arm64.tar.gz\n51685e02a604cbaa1e640f131b704200f3d313a510c19b25e21761363c3e7f9a  roo-cli-linux-arm64.tar.gz\n32b5afce8edad0b060c2eac0d4b42fb04e737c17d12b05b3875d916cc53b138c  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T21:07:46",{"id":203,"version":204,"summary_zh":205,"released_at":206},351570,"cli-v0.1.10","## What's New\n\n\n### Added\n\n- **Command Exit Code in Events**: The `tool_result` event for command executions now includes an `exitCode` field, allowing CLI consumers to programmatically distinguish between successful and failed command executions without parsing output text.\n\n## Installation\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\nOr install a specific version:\n```bash\nROO_VERSION=0.1.10 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## Requirements\n\n- Node.js 20 or higher\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4), Linux x64, or Linux ARM64\n\n## Usage\n\n```bash\n# Run a task\nroo \"What is this project?\"\n\n# See all options\nroo --help\n```\n\n## Platform Support\n\nThis release includes binaries for:\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## Checksums\n\n```\n1a59a75f9765ec205db464339aa643cb365aaa18e03494e40afb4fab635e0d1d  roo-cli-darwin-arm64.tar.gz\nf67f4962811e2ed53338ffd21e5eb9e00afdf9f77a7d78f1b8a658b64cf9ca63  roo-cli-linux-arm64.tar.gz\n014d06e609bdef715c5dddc3b7f5d694e2b45a3c302c2560da28faa2ef4aa7e4  roo-cli-linux-x64.tar.gz\n```\n","2026-03-02T17:47:04",{"id":208,"version":209,"summary_zh":210,"released_at":211},351559,"v3.52.1","发布 v3.52.1","2026-04-13T22:33:01",{"id":213,"version":214,"summary_zh":215,"released_at":216},351560,"v3.52.0","发布 v3.52.0","2026-04-08T21:18:42",{"id":218,"version":219,"summary_zh":220,"released_at":221},351561,"v3.51.1","发布 v3.51.1","2026-03-08T02:25:17",{"id":223,"version":224,"summary_zh":225,"released_at":226},351562,"v3.51.0","发布 v3.51.0","2026-03-05T22:09:14",{"id":228,"version":229,"summary_zh":230,"released_at":231},351563,"cli-v0.1.17","## 新增内容\n\n\n### 新增功能\n\n- **自定义会话 ID 支持**：新增 `--create-with-session-id` 标志，允许在创建任务时指定自定义的 UUID 会话 ID。现在，无论是创建还是恢复操作，以及在标准输入流模式下的 `start.taskId`，都会对会话 ID 进行 UUID 格式验证。\n\n### 测试\n\n- 增加了集成测试覆盖率，确保创建并恢复任务时能够正确加载会话。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装特定版本：\n```bash\nROO_VERSION=0.1.17 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行一个任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n此版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\ncf3c1612cd6cd1e50d3db005548a071a634f17a62ca8e8b1ead5a6e832763537  roo-cli-darwin-arm64.tar.gz\nd22cf06ccbaf3e9eaed8a9ccebbc4df700e00469390381dfcb33e6af5c672d53  roo-cli-linux-arm64.tar.gz\n4f007b9016bb0792943680890f5aa0b52279ee168437100b9f4d32240be5b538  roo-cli-linux-x64.tar.gz\n```\n","2026-03-04T20:33:01",{"id":233,"version":234,"summary_zh":235,"released_at":236},351564,"cli-v0.1.16","## 新增内容\n\n\n### 新增\n\n- **自定义 Shell 选择**：新增 `--terminal-shell` 标志，用于指定在内联命令执行时使用的 Shell。Shell 路径将在 CLI 层进行验证，并通过标准的配置机制传递。\n\n### 测试\n\n- 增加了对标准输入流路由和竞态不变量的集成测试覆盖。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装特定版本：\n```bash\nROO_VERSION=0.1.16 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行一个任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n本版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\n3fecad24f9a8c0cc16c4701bd03ca1eb4e59704d25af74dbfb9075f156378530  roo-cli-darwin-arm64.tar.gz\n879b3e3365d8cc87a0d935f5f27a9bdf190a478ce4bd4bd255d412a0cd50441f  roo-cli-linux-arm64.tar.gz\n9b126dbc9228c8f943d833b1b053e0a3da4492ce9836cd967d04d3e18252250c  roo-cli-linux-x64.tar.gz\n```\n","2026-03-04T07:42:40",{"id":238,"version":239,"summary_zh":240,"released_at":241},351565,"cli-v0.1.15","## 新增内容\n\n\n### 修复\n\n- **完成询问的后续路由**：修复了在 stdin 流模式下，客服人员请求澄清（ask_followup_question）时，后续消息的路由问题。现在，在完成询问之后发送的消息会正确地传递给客服人员，而不会被放入队列。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装特定版本：\n```bash\nROO_VERSION=0.1.15 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行一个任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n此版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\nd216522eb88e036b83889bed36d91cc9330fb9a2900f257d29b269d3cc04bbe5  roo-cli-darwin-arm64.tar.gz\nc37047031a684b4b2a2bb51a0b8e37b46573d7ef317590587734765cbcca36e3  roo-cli-linux-arm64.tar.gz\n8854ba9d52291f61ce01a306c8a022f71bf500c7152032a4238d29ddf0b71f3e  roo-cli-linux-x64.tar.gz\n```\n","2026-03-03T07:10:39",{"id":243,"version":244,"summary_zh":245,"released_at":246},351566,"cli-v0.1.14","## 新增内容\n\n\n### 修复\n\n- **命令输出流式传输**：确保在 `done` 事件发出之前，完整地流式传输所有命令输出，从而避免在标准输入流模式下出现输出截断的问题。\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n或者安装指定版本：\n```bash\nROO_VERSION=0.1.14 curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FRooCodeInc\u002FRoo-Code\u002Fmain\u002Fapps\u002Fcli\u002Finstall.sh | sh\n```\n\n## 系统要求\n\n- Node.js 20 或更高版本\n- macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)、Linux x64 或 Linux ARM64\n\n## 使用方法\n\n```bash\n# 运行一个任务\nroo \"这个项目是什么？\"\n\n# 查看所有选项\nroo --help\n```\n\n## 平台支持\n\n此版本包含以下平台的二进制文件：\n- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1\u002FM2\u002FM3)\n- `roo-cli-linux-x64.tar.gz` - Linux x64\n- `roo-cli-linux-arm64.tar.gz` - Linux ARM64\n\n## 校验和\n\n```\nc6cbbd3041187b2dcd4570180fc2a9cba6bf63f812280f64004f609207e56a22  roo-cli-darwin-arm64.tar.gz\ncba14598aa7baaa6cf6bbf22a955ad9803793f18c5d44d9c9d50884f87565068  roo-cli-linux-arm64.tar.gz\nd13e7091270185c0acd7c7fabd0d464f17bcd03bd5b37eedb8100b0e0955c0dd  roo-cli-linux-x64.tar.gz\n```\n","2026-03-03T05:59:37"]