wehub-resource-sync
112 lines
4.4 KiB
Plaintext
112 lines
4.4 KiB
Plaintext
# OpenHands 入门指南
|
|
|
|
您已经[安装了 OpenHands](./installation)并且
|
|
[设置了您的 LLM](./installation#setup)。接下来呢？
|
|
|
|
OpenHands 可以帮助您处理各种工程任务。但这项技术
|
|
仍然很新,我们还有很长的路要走,才能拥有无需任何指导就能承担大型、复杂
|
|
工程任务的智能体。因此,了解智能体擅长什么,以及
|
|
它可能需要什么帮助非常重要。
|
|
|
|
## Hello World
|
|
|
|
您可能想尝试的第一件事是一个简单的 "hello world" 示例。
|
|
这可能比听起来更复杂!
|
|
|
|
尝试提示智能体:
|
|
> 请编写一个 bash 脚本 hello.sh,打印 "hello world!"
|
|
|
|
您应该看到,智能体不仅编写了脚本,还设置了正确的
|
|
权限并运行脚本以检查输出。
|
|
|
|
您可以继续提示智能体优化您的代码。这是一个很好的
|
|
与智能体合作的方式。从简单开始,然后迭代。
|
|
|
|
> 请修改 hello.sh,使其接受一个名称作为第一个参数,但默认为 "world"
|
|
|
|
您还可以使用任何需要的语言,尽管智能体可能需要花一些
|
|
时间来设置它的环境!
|
|
|
|
> 请将 hello.sh 转换为 Ruby 脚本,并运行它
|
|
|
|
## 从头开始构建
|
|
|
|
智能体在 "绿地" 任务(不需要
|
|
任何关于现有代码库的上下文的任务)方面表现得非常出色,它们可以直接从头开始。
|
|
|
|
最好从一个简单的任务开始,然后迭代它。最好也要
|
|
尽可能具体地说明您想要什么,技术栈应该是什么,等等。
|
|
|
|
例如,我们可以构建一个 TODO 应用:
|
|
|
|
> 请在 React 中构建一个基本的 TODO 列表应用。它应该只有前端,所有状态
|
|
> 应该保存在 localStorage 中。
|
|
|
|
一旦骨架搭建好,我们就可以继续迭代应用:
|
|
|
|
> 请允许为每个任务添加一个可选的截止日期
|
|
|
|
就像正常开发一样,经常提交和推送代码是很好的做法。
|
|
这样,如果智能体偏离轨道,您总是可以恢复到旧的状态。
|
|
您可以要求智能体为您提交和推送:
|
|
|
|
> 请提交更改并将其推送到名为 "feature/due-dates" 的新分支
|
|
|
|
|
|
## 添加新代码
|
|
|
|
OpenHands 还可以很好地将新代码添加到现有代码库中。
|
|
|
|
例如,您可以要求 OpenHands 向您的项目添加一个新的 GitHub action
|
|
来检查您的代码。OpenHands 可能会查看您的代码库以确定应该使用什么语言,
|
|
但随后它可以直接将一个新文件放入 `./github/workflows/lint.yml`
|
|
|
|
> 请添加一个 GitHub action 来检查此仓库中的代码
|
|
|
|
某些任务可能需要更多上下文。虽然 OpenHands 可以使用 `ls` 和 `grep`
|
|
在您的代码库中搜索,但提前提供上下文可以让它移动得更快、
|
|
更准确。而且这会让您花费更少的 token!
|
|
|
|
> 请修改 ./backend/api/routes.js 以添加一个新路由,返回所有任务的列表
|
|
|
|
> 请在 ./frontend/components 目录中添加一个新的 React 组件,用于显示 Widget 列表。
|
|
> 它应该使用现有的 Widget 组件。
|
|
|
|
## 重构
|
|
|
|
OpenHands 在重构现有代码方面表现出色,尤其是在小块中。
|
|
您可能不想尝试重新构建整个代码库,但拆分
|
|
长文件和函数、重命名变量等往往效果很好。
|
|
|
|
> 请重命名 ./app.go 中的所有单字母变量
|
|
|
|
> 请将 widget.php 中的函数 `build_and_deploy_widgets` 拆分为两个函数:`build_widgets` 和 `deploy_widgets`
|
|
|
|
> 请将 ./api/routes.js 拆分为每个路由的单独文件
|
|
|
|
## Bug 修复
|
|
|
|
OpenHands 还可以帮助您跟踪和修复代码中的错误。但是,任何
|
|
开发人员都知道,修复错误可能非常棘手,通常 OpenHands 需要更多上下文。
|
|
如果您已经诊断出错误,但希望 OpenHands 找出逻辑,这会有所帮助。
|
|
|
|
> 目前 `/subscribe` 端点中的电子邮件字段拒绝 .io 域名。请修复这个问题。
|
|
|
|
> ./app.py 中的 `search_widgets` 函数正在执行区分大小写的搜索。请使其不区分大小写。
|
|
|
|
在使用智能体进行错误修复时,进行测试驱动开发通常很有帮助。
|
|
您可以要求智能体编写一个新测试,然后迭代直到修复错误:
|
|
|
|
> `hello` 函数在空字符串上崩溃。请编写一个测试来重现此错误,然后修复代码以通过测试。
|
|
|
|
## 更多
|
|
|
|
OpenHands 能够在几乎任何编码任务上提供帮助。但需要一些练习
|
|
才能充分利用它。请记住:
|
|
* 保持任务简单
|
|
* 尽可能具体
|
|
* 提供尽可能多的上下文
|
|
* 经常提交和推送
|
|
|
|
有关如何充分利用 OpenHands 的更多提示,请参阅[提示最佳实践](./prompting/prompting-best-practices)。
|