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）