OpenCode 常见问题索引

来自 GitHub Issues（anomalyco/opencode）和社区帖子的真实问题与解决方案，经语义去重整理。

GitHub Issues

• Ubuntu 24 安装后命令找不到（PATH 未生效）（#11319）
• DeepSeek 思考模式多轮对话报 reasoning_content 错误（#24104）
• 插件加载失败：ENOENT 找不到 package.json（cache 目录结构不一致）（#23502）
• Desktop App 启动时 health check 失败导致 IDE 扩展不稳定（#24142）
• openai-compatible provider 无法调用 Responses API（Codex / GPT-5 等模型）（#9628）
• 自适应主题始终显示深色模式（亮色终端背景无效）（#23810）
• VS Code 集成终端中小键盘（Numpad）按键完全无响应（#16100）
• Task 子 Agent 无法执行 MCP 工具（权限未从父 Agent 继承）（#16491）
• /connect 界面无法粘贴 API Key（Ctrl+V 和右键粘贴均失效）（#9922）
• Plan Mode 下模型意外直接修改文件（应只规划不执行）（#7292）
• 模型绕过 ask 权限直接执行 git commit（未经用户确认）（#14593）

社区经验