用途:帮助用户通过引导式流程配置 OpenCode,主要涉及两类文件——配置文件 opencode.json(模型、工具、权限、主题等)与规则文件 AGENTS.md(面向所有代理的项目指令,类似 CLAUDE.md 或 Cursor rules)。
文件位置与优先级:全局配置为 ~/.config/opencode/opencode.json,项目配置为 ./opencode.json;规则文件全局为 ~/.config/opencode/AGENTS.md,项目为 ./AGENTS.md。项目优先于全局,且配置为合并而非替换。
主要能力:设置默认模型(model)、轻量任务模型(small_model)、主题(theme)、自动更新(autoupdate)、会话共享(share);通过 permission 字段控制编辑、bash、webfetch、skill 等操作的审批,支持 allow/ask/deny 及通配符模式匹配;通过 instructions 引入额外指令文件。规则文件可用 /init 自动生成,或手动编写项目结构、代码规范与常用命令。
使用方式:先询问用户要配置什么,再引导进入对应部分。支持 JSONC(带注释的 JSON),建议注释掉而非删除未用配置。修改 opencode.json 后必须运行校验命令:opencode run "test",以便发现 JSONC 语法错误(如缺少逗号、多余逗号、括号未闭合)。遇到旧版字段(如 tools、maxSteps)应改为现代的 permission 与 steps。
适用场景:提供方设置、权限变更、模型配置、格式化规则、环境相关配置,以及项目级规则编写。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;完整配置项需参考 references/config-schema.md。