opencode基础使用教程--从安装到使用（03）

目录4.6init命令4.6.1使用建议与注意事项4.6.2编辑4.6.3使用4.7new命令4.8 sessions命令4.9文件引用4.10 bush命令1bash命令的作用与约束2手动执行你主动发起AI 配合3自动调用AI 主动规划并执行4工具结果是什么4.11卸载​编辑4.12其他命令1例如share2undo和redo3theme4.6init命令a文件位置:在你选择的调用opencode的文件目录之中b打开后可以在里面输入想要的设定如图c在前段文字下方填入提示词4.6.1使用建议与注意事项a提交到版本控制生成的AGENTS.md文件建议提交到 Git 仓库这样团队所有成员都能共享相同的项目上下文确保 AI 助手的表现一致b了解文件层级opencode 支持从多个位置读取规则。除了项目根目录的AGENTS.md你还可以创建全局规则文件~/.config/opencode/AGENTS.md用于存放适用于你所有项目的个人偏好设置c手动编辑AGENTS.md本质上是一个 Markdown 文件你可以随时手动编辑它添加或修改你认为 AI 需要知道的任何项目特定信息。4.6.2编辑(a)AGENTS.md本质上就是一个Markdown 纯文本文件所以不需要特定软件任何能编辑纯文本的编辑器都可以。例如vs code,记事本等(b)直接右键该文件选择打开方式打开即可最好不要使用WPSword等富文本编辑器容易引入其他东西c编辑提示词文本建议1保存为 UTF-8 编码避免乱码。2用 Markdown 结构比如标题、列表AI 更容易理解。3指令写明确、可执行不要含糊。4可以使用中文例如# 项目 AI 规则- 始终使用简体中文回答。- 代码注释使用中文。- 变量名、函数名保持英文。- 修改代码前先说明修改计划。- 提交信息使用英文。- 不要自动格式化整个文件只改相关部分。4.6.3使用a提示词修改好了以后就可以直接用它对某个文件进行你想要的修改了4.7new命令4.8 sessions命令a输入/sessions;b此时会显示当前会话下的所有历史会话点击即可跳转回历史会话4.9文件引用a例如此例4.10 bush命令1bash命令的作用与约束a作用AI 自动调用赋予 AI 操作系统的能力这是 opencode 的核心功能之一。opencode 内置了一个名为bash的工具它允许 AI 模型LLM在你的项目环境中执行终端命令例如npm install、git status或任何其他 shell 命令。效果AI 可以根据你的指令自主运行命令来完成安装依赖、运行测试、查看 Git 状态等任务。命令的输出会返回给 AI作为它后续决策的参考。b控制控制出于安全考虑你可以在项目根目录的opencode.json文件中通过permission字段来精细控制 bash 工具的权限。ask每次执行 bash 命令前都会询问你是否批准。这是平衡安全与效率的推荐设置。allow允许 AI无需询问直接执行命令。deny禁止AI 执行任何 bash 命令。c手动执行在 opencode 的终端界面TUI中你可以手动快速执行命令并将结果作为上下文提供给 AI。使用方法在输入框中以!开头输入你的命令例如!ls -la然后回车。效果命令会在你的项目目录下立即执行其输出结果会自动作为一条“工具结果”添加到当前对话中让 AI 能“看到”命令的执行结果并据此继续回答。快捷键在 TUI 中你还可以使用快捷键ctrlx c来快速进入 bash 命令模式。2手动执行你主动发起AI 配合当你已经明确知道要运行什么命令时手动执行能绕过 AI 的推理环节直接将结果作为上下文提供给 AI。场景一快速查看项目状态在 TUI 输入框中以!开头输入命令例如!git status或!ls -la。命令会立即在终端执行其输出stdout/stderr会自动作为一条“工具结果”添加到当前对话中让 AI 能“看到”当前状态并据此继续回答。场景二在自定义命令中动态注入上下文你可以在.opencode/command/目录下创建自定义命令如commit.md并在其中使用!反引号语法来内联执行 shell 命令。例如opencode 官方的commit命令就使用了!git diff和 !git status --short来实时获取工作区改动并将真实输出内联进发送给模型的提示词中让 AI 基于实际 diff 生成提交信息。3自动调用AI 主动规划并执行这是 opencode 作为 AI 编程 Agent 的核心能力。你只需给出目标AI 会自主规划步骤、调用bash工具执行命令并根据输出结果决定下一步。场景一安装依赖并运行测试你输入“帮我安装依赖并跑一下测试”。AI 会自动调用bash工具执行npm install成功后接着执行npm test最后将测试结果反馈给你。这是最基础的“操作闭环”。场景二并行执行后台任务借助async-bash-mcp这类工具AI 可以并行启动多个耗时任务。例如你要求“在后台启动构建同时并行跑测试完成后告诉我”AI 就能同时 spawn 两个 bash 进程并独立追踪各自的进度。场景三Git 冲突检测与通知在自定义命令中可以通过提示词约束 AI 的自动行为。例如官方commit命令里明确写道“if there are conflicts DO NOT FIX THEM. notify me and I will fix them”。这样 AI 在自动执行git commit遇到冲突时会停下来通知你而不是自作主张解决。4工具结果是什么以 bash 为例工具结果一般包括stdout命令的正常输出比如ls列出的文件stderr错误输出比如command not found退出码 / 成功失败状态比如退出码 0 表示成功非 0 表示失败有时还有执行时间、是否被截断等元信息工具结果就是外部工具真实执行后返回的事实4.11卸载4.12其他命令1例如shareashare可以用来分享你的会话b使用share后剪切板会自动生成一个链接在浏览器打开链接就可以查看会话2undo和redo(a)undo可以撤销一次对话即你对一次输出的结果不满意想要修改就可以输入/undo返回上一条对话bredo则是撤销undo返回你原来的对话3theme/theme可以修改opencode的页面等更美观下一篇将更新在vs code上使用opencode