故障排查指南

{
  // 限制上下文长度
  "contextLimit": 8000,
  
  // 禁用不必要的工具描述
  "mcp": {
    "unused": { "enabled": false }
  },
  
  // 使用轻量模型做简单任务
  "models": {
    "default": "anthropic/claude-sonnet-4-5",
    "quick": "openai/gpt-4o-mini"
  }
}

# OpenCode 日志
~/.local/share/opencode/logs/
 
# 系统日志（systemd）
journalctl -u opencode --since "1 hour ago"
 
# Docker 日志
docker logs opencode-container --tail 200
 
# K8s 日志
kubectl logs -l app=opencode --tail 200

# 环境变量调试
DEBUG=opencode opencode
 
# 或
OPENCODE_DEBUG=1 opencode server
 
# 详细网络日志
DEBUG=opencode,http opencode

# 查找错误
grep -i "error\|fail\|timeout" ~/.local/share/opencode/logs/latest.log
 
# 统计 Token 消耗
jq -r '.token_usage' ~/.local/share/opencode/logs/*.log | awk '{sum+=$1} END{print sum}'
 
# 查找慢请求
jq 'select(.duration > 10)' ~/.local/share/opencode/logs/*.log

#!/bin/bash
# opencode-doctor.sh
 
echo "=== OpenCode 诊断 ==="
 
# 版本
echo -n "版本: "
opencode --version 2>/dev/null || echo "未安装"
 
# PATH
echo -n "安装路径: "
which opencode 2>/dev/null || echo "不在 PATH 中"
 
# Node.js
echo -n "Node.js: "
node --version 2>/dev/null || echo "未安装"
 
# 配置
echo -n "全局配置: "
test -f ~/.config/opencode/opencode.json && echo "存在" || echo "不存在"
 
# API 密钥
echo -n "API 密钥: "
test -f ~/.local/share/opencode/auth.json && echo "已配置" || echo "未配置"
 
# 终端
echo "终端: $TERM"
echo "终端大小: $(stty size 2>/dev/null || echo 'unknown')"
 
# 网络
echo -n "网络: "
ping -c 1 opencode.ai >/dev/null 2>&1 && echo "正常" || echo "异常"

## 环境
- OS: Ubuntu 22.04
- OpenCode: 1.2.3
- Terminal: WezTerm
- Node.js: 20.11.0
 
## 问题描述
启动后界面显示乱码
 
## 复现步骤
1. 运行 `opencode`
2. 界面中文显示为方块
 
## 已尝试
- [x] 更换终端
- [ ] 更换字体
 
## 日志

# 重置配置（保留密钥）
mv ~/.config/opencode/opencode.json ~/.config/opencode/opencode.json.bak
 
# 重置所有数据（谨慎！）
rm -rf ~/.config/opencode
rm -rf ~/.local/share/opencode
 
# 重新初始化
opencode
/connect
/init

# 安装特定版本
npm install -g [email protected]