Qoder使用二：内置智能体

浏览器智能体

通过 Browser 智能体，你可以让 Qoder 不仅“读懂你的代码”，还可以“读懂你正在访问的网页”，在同一对话中完成代码编辑与网页操作协同，大幅减少在浏览器和 IDE 之间来回切换的成本。

总结：通过浏览器智能体，进行评论，点赞的自动化实现。

浏览器智能体是在智能体模式下使用浏览器完成任务的能力扩展。它可以在受控环境中打开网页、浏览内容、点击按钮、填写表单、滚动页面，并在必要时截图反馈页面状态，从而帮助你完成「需要实际访问网页」的自动化任务。
只需在智能会话中用自然语言描述你的需求（例如“去官网查一下最新价格并总结差异”），智能体会在需要时自动调度 Browser 智能体，无需你手动切换模式或编写脚本。

浏览器智能体主要具备以下能力：
1，打开与导航网页
2，阅读与提取信息
3，交互与操作页面

• 点击按钮、链接、切换标签页或展开/收起折叠内容。
• 在输入框、搜索框等表单元素中输入文字，并提交表单。
• 通过滚动页面浏览更多内容，避免遗漏关键信息。

4，可视反馈与状态感知

• 在执行复杂步骤时，按需截图当前页面状态，用于后续判断与说明。
• 感知页面是否加载完成、表单是否提交成功、是否跳转到了新的页面等，以便决定下一步操作。

浏览器类型
Browser Agent 支持两种浏览器类型，你可以根据需要切换：

• 内置浏览器：IDE 内置的轻量级浏览器面板，无需额外配置，适合快速预览和简单页面交互。
• Chrome：使用本地 Chrome 浏览器执行，支持更复杂的 Web 应用和需要特定浏览器特性或扩展的页面。

你可以在Browser Agent 设置中切换浏览器类型。

如何在智能体模式中使用
浏览器智能体已内置于智能体模式中,无需单独配置。你可以通过两种方式调用它:

• 自动调用：智能体模式会根据你的请求智能判断何时需要浏览器智能体。
• 显式调用：使用/browser命令显式请求浏览器智能体。

选择使用 /browser 显式调用，或直接用自然语言描述你的需求，例如：

• /browser 打开 https://example.com 并总结主要功能
• /browser 查看 2025 年的定价计划并整理成表格
• /browser 分析这个组件库中的主题自定义选项

规划智能体（如何开启规划智能体）

Planning 功能让智能体模式在修改代码或执行命令之前，前置成一份实施方案与计划。
对于中大型任务（如跨多文件的功能开发、重构或高风险变更），Planning 能提供清晰的可见性、可控的执行流程以及明确的落地路径。
开启 Planning 后，Qoder 会基于你的自然语言需求生成一份结构化的方案与规划。你可以先审阅和调整这份计划，再让智能体按步骤自动执行。
​
适用场景：推荐在以下场景中启用 Planning：

• 处理复杂功能，涉及多个模块或多个文件。
• 预期会经历多轮迭代（设计、实现、测试、清理等）。

对于较小小的改动（例如“修正一个拼写错误”“重命名一个变量”等），你可以直接使用智能体执行，以节省时间，无需使用规划。

如何在智能体模式中使用？
规划智能体已内置于智能体模式中,无需单独配置。你可以通过两种方式调用它:

• 自动调用：智能体模式会根据你的请求智能判断何时需要进行规划。
• 显式调用：使用 /plan 命令显式请求规划智能体。

详细使用步骤如下：

1. 描述你的任务
选择使用 /plan 显式调用，或直接用自然语言描述你的需求。在描述时，建议包含以下信息：

• 变更的目标或要实现的功能。
• 任何限制条件（例如”不能破坏现有 API""对于旧版路径需保持当前行为”等）。
• 可选：提及重要的文件或模块路径。

你的描述越清晰、越具体，生成的计划就会越贴合实际需求。
​
2. 生成计划
当会话中启用 Planning 时，Qoder 会：

• 分析你的需求以及相关工程上下文。
• 根据需求为您生成一份完整的规划，包含目标、技术方案、技术栈、实施计划等内容。

此阶段不会修改任何文件，也不会执行任何命令——产出仅是一份可审阅的计划。
​
3. 审阅并调整计划
在执行开始前，你可以根据自己的预期对计划做修改，例如：

• 编辑方案内容，使其更加精确、易懂。
• 补充 AI 未覆盖但你认为重要的步骤。

你也可以直接通过自然语言和 Qoder 协作调整计划，例如：“最后加一步更新文档”。
​
4. 启动执行
当你确认计划无误后，可以启动执行：

• 智能体会像普通 Agent 模式那样读取文件、修改代码、运行命令，或调用 MCP 工具。
• 待办事项的状态会在聊天底部实时更新（未开始/进行中/已完成）。

根据你的设置，某些操作（尤其是终端命令或 MCP 工具调用）在执行前可能仍需要你手动确认。

5. 执行过程中的调整
在计划执行过程中：

• 你可以随时查看每个待办事项的状态变化。
• 若发现计划本身或执行结果有问题，可以暂停、在聊天中说明新的要求，然后让 Qoder 更新计划后继续。
• 对于阻塞性问题（例如测试失败、依赖缺失等），Qoder 会在对话中明确指出，并规划相应的下一步。

这样，你始终保持决策权，而智能体负责具体的机械工作。
​
6. 收尾与回顾
当所有待办事项执行完毕（或你主动终止执行）后：

• Qoder 可以按步骤总结本次执行中完成了哪些工作（例如每个 To-do 具体修改了哪些文件）。
• 你可以结合 diff 视图、本地测试或 PR 流程，对最终结果进行正常的代码评审。
• 如有后续工作需求，可以再次开启一个新的 Planning 流程，继续迭代。

最佳实践

• 清晰描述目标：像给同事派任务那样写你的第一个提示词，说明范围、限制条件和验收标准。

• 对高风险任务默认开启 Planning：例如重构、接口调整、涉及核心路径的改动等。

• 迭代优化计划：如果第一版计划不理想，可以让 Qoder 调整，例如“更关注测试部分”“尽量减少对公共接口的改动”等。

• 保持每一步足够小：一个好的待办事项，应该能在一个较小的 diff 中看清它的影响范围。

借助 Planning，你可以在保持智能体高效率的同时，获得一份经过认真设计的实施方案，在安全与效率之间取得更好的平衡。

总结：对旧项目代码重构，可以主动激活规划智能体，先生成一个符合目标的重构文档，再开始AI生成代码。

Code Review 智能体

Code Review 智能体是 Agent 模式下对代码进行自动化审查的内置能力。它可以针对你指定的范围——整个项目、特定文件、Git diff 或 Pull Request——进行深度代码审查，从代码质量、潜在缺陷、安全风险、性能隐患、可读性与最佳实践等多个维度给出改进建议。

在智能会话中使用/code-review命令或用自然语言描述审查需求，智能体会自动分析目标代码并生成结构化的审查报告。

核心能力

• 多维度审查：检测逻辑缺陷、安全漏洞（SQL 注入、XSS 等）、性能瓶颈、代码风格问题

• 灵活的审查范围：支持全项目扫描、指定文件、Git diff 变更、Pull Request 审查

• 结构化报告：按严重等级（错误、警告、建议）分类，提供具体代码位置、问题描述和修复建议

如何使用

Code Review 智能体已内置于 Agent 模式中，无需单独配置。打开聊天面板并切换到 Agent 模式，使用/code-review命令并根据需要指定审查范围即可。

对于大型变更，建议按模块分批审查以获得更精细的反馈。如果变更涉及特定业务逻辑，在请求中简要说明背景有助于获得更贴合实际的建议。

使用总结：

原提示词：/code-review 针对此工具类进行代码审查

qoder优化后提示词：

请对 AddressValidatorUtil 工具类进行详细的代码审查。该工具类位于 D:\dwcode\wa-manage-server\src\main\java\com\thinkive\base\wa\manage\util\AddressValidatorUtil.java，主要用于券商联系地址的校验功能。审查应涵盖以下方面： 1. 代码结构和可读性：评估类的整体架构、方法组织、命名规范等 2. 功能完整性：验证所有验证规则是否正确实现（长度、特殊字符、行政区划、顺序等） 3. 性能考虑：检查是否存在性能瓶颈，特别是正则表达式和字符串操作 4. 错误处理：评估异常处理机制和错误信息反馈 5. 代码质量：识别潜在的bug、安全漏洞或最佳实践问题 6. 可维护性：评估代码的扩展性和维护难度 7. 日志记录：检查日志输出是否恰当 8. 常量管理：评估常量定义的合理性和使用情况 请提供具体的改进建议和优化方案，并说明每个问题的影响程度。同时，请参考该工具类在项目中的实际使用场景，如在 AuditServiceImpl.java 中第1180-1181行的调用方式：AddressValidatorUtil.validate(cuAddr, regFlowNo, addressLength)。

生成一份Code Review报告