安装 OpenCode,和 Agent 说上第一句话
你可以先不会 Lua。只要能在蛋仔编辑器里搭场景、设置组件,能说明自己想做什么,就可以跟着这篇开始。
这一篇只装一个软件,发一条消息。先不用买套餐,也不用碰地图代码。
第 1 章 先知道眼前这几个词
Agent(代理) 可以读文件、改代码,也能运行工具。你把地图效果说给它听,它会尝试把事情做出来。它也会理解错,所以做完还要由你试玩。
OpenCode 是本教程使用的 Agent 软件。安装软件之后,还需要给它选择一个模型。
模型负责理解你的话、生成回答。软件里可能列出好几种模型,先选一种能正常对话的就行。
提示词就是发给 Agent 的话。不需要写得像命令公文,把事情交代清楚就够了。
Skill(技能) 是一份给 Agent 按需阅读的做事说明。后面安装的蛋仔技能包会提醒它查接口、保护蛋码绑定、留下开发记录。装了也要检查结果,不能当成保证书。
工作区就是你让 Agent 打开的文件夹。它能接触哪些文件,和打开的位置、授予的权限有关。
这些词先认得就够用。Token、反代、拼车放在“了解 AI”栏目,不影响你继续安装。
第 2 章 装好 OpenCode
- 打开 OpenCode 下载页。选择 Windows 桌面版;不清楚选哪个安装包时,先看电脑“设置 → 系统 → 系统信息”里的系统类型。
- 运行下载的安装程序,按提示安装。不要下载页面旁边广告里的软件。
- 启动 OpenCode。出现打开项目或文件夹的界面后,先停在这里。
接着在资源管理器里新建一个文件夹,叫“蛋仔创作”。它以后用来放多张地图和公共技能。磁盘位置自己选,尽量不要放进网盘自动同步目录。
在 OpenCode 里点击打开文件夹,选中刚建的“蛋仔创作”。窗口里能看到这个文件夹名,就可以继续。
如果安装失败,截图保留完整报错。先不要照着网上一长串命令随便修,可以到交流群发图问问。
第 3 章 完成第一次对话
点击输入框附近的模型名称,打开模型列表。先看有没有标着 Free(免费)的可用项,有的话可以用它试这一步。没有免费项就先停下,不需要为了继续阅读立刻付款。
下面是之前保存的界面示例,图中的名称不需要逐字照选。
选好模型后,把下面这段发给它。
我刚开始学习用 Agent 做蛋仔地图,不会 Lua。请用中文回复。
先告诉我你现在打开的工作区名称,再只回复“可以开始”。
这次不要创建、修改或删除文件,也不要安装软件和运行命令。
能收到中文回答,而且工作区名称对得上,就完成了第一次对话。回答里夸自己能做多少事,不算这一步的结果。
一直转圈、提示余额不足或无法连接时,记下模型名称和完整提示。先处理对话问题,暂时不要把正式地图交给它。
第 4 章 开始前看懂权限提示
Agent 要运行命令或写入文件时,软件可能让你确认。看不懂就问它,不必一律点允许。
这一步要改哪个文件或安装什么?请用我能看懂的中文说明。
会不会删除、覆盖已有内容,或者需要付款?先解释,等我确认。
第一次用时按次确认。刚才只是聊天,不需要给整台电脑永久放开权限。
下一篇会让 Agent 检查需要的软件,安装蛋仔技能包,再找到你的地图工程。你不需要现在自己去装一整套编程工具。
操作依据见 OpenCode 入门说明 和 模型选择说明。
添加理由写 加群
