Qoder配置JSON参数详解：功能解析与优化建议
Qoder配置问题大多源于JSON文件的结构或参数错误。字段拼写、嵌套层级、数据类型或关键参数缺失是常见根源。以下将系统解析Qoder配置文件的核心参数，助你精准定位问题。
一、核心运行参数：model、timeout、max_retries
这组参数定义了Qoder调用大模型的基础行为，直接影响响应质量与执行稳定性。model指定推理引擎，timeout控制单次请求的等待上限，max_retries则设定失败后的重试次数。
首先，确保model字段的值是Qoder官方支持的合法模型标识符，例如“qwen3”、“lingma-pro”或“qoder-llm-v2”。拼写错误或使用未注册的别名将导致调用失败。
其次，timeout字段必须为纯整数。正确格式为“timeout”: 45，而非“timeout”: “45”。若误设为字符串，超时机制将失效。
最后，max_retries的值应介于0到5之间。超出此范围，系统将自动回退至默认值3，负值则会被直接忽略。
二、安全与权限控制参数：safe_mode、allow_unsafe_tools、trusted_hosts
这组参数为Qoder的执行环境划定信任边界，尤其在启用高危工具时至关重要。safe_mode是全局开关，allow_unsafe_tools进行细粒度工具授权，trusted_hosts则限制网络调用的目标地址。
如需启用安全模式，将safe_mode设为true。此时，所有未在allow_unsafe_tools中明确列出的工具将被自动禁用。
若业务需临时使用rm或curl等命令，必须在allow_unsafe_tools中以字符串数组形式声明，例如[“bash”, “curl”]。关键点在于：不支持正则表达式或通配符，必须精确指定工具名。
为防范SSRF攻击，trusted_hosts必须配置为精确的域名或IP列表，如[“api.example.com”, “10.0.1.5”]。若配置为空数组[]，则意味着禁止所有外部网络连接。
三、上下文与记忆参数：context_window、memory_enabled、memory_path
这组参数共同管理Qoder对项目上下文的感知深度与长期记忆策略。context_window限制单次交互可处理的token容量，memory_enabled控制是否启用记忆功能，memory_path则指定AGENTS.md文件的存储位置。
context_window建议设置在2048至8192之间，且最好为2的幂次方。低于2048可能导致跨文件引用失败；高于8192则可能触发模型服务的限流策略。
启用记忆功能需同时满足两个条件：一是将memory_enabled设为true，二是确保memory_path指向一个可写目录。注意路径末尾不应带斜杠，正确格式为“data/memory”，而非“data/memory/”。
需特别注意，若memory_path指向的目录不存在，Qoder不会自动创建父目录。你需要手动执行mkdir -p等命令，确保路径可达。
四、MCP服务集成参数：mcp_servers、mcp_timeout、mcp_protocol
这组参数定义了Qoder与外部MCP（Model Context Protocol）服务的连接方式及容错策略。mcp_servers列出已注册的服务端点，mcp_timeout控制连接握手阶段的超时阈值，mcp_protocol则指定通信协议类型。
mcp_servers必须是一个对象数组，每个对象需包含name和endpoint字段。endpoint的值必须以http://或https://开头，且不能包含路径部分。示例：{“name”:”db-mcp”, “endpoint”:”http://localhost:8080”}。
mcp_timeout的单位是毫秒，应填写整数。推荐值在3000到10000之间。设置过短易误判服务离线，过长则会拖慢整体响应。
mcp_protocol仅接受两个字符串值：“stdio”或“sse”。该字段大小写敏感，切勿写成“STDIO”或“SSE”。
五、日志与调试参数：log_level、log_path、debug_dump
这组参数控制Qoder运行时诊断信息的输出粒度与存储方式，对问题排查和性能分析至关重要。log_level定义日志级别，log_path指定日志文件路径，debug_dump决定是否保存原始请求快照。
log_level仅支持四个级别：“error”、“warn”、“info”、“debug”。该字段不区分大小写，但应避免使用全大写形式如“DEBUG”。
log_path必须为绝对路径，或相对于Qoder启动目录的相对路径。禁止使用波浪号~表示家目录，应明确写出如“/home/user/qoder/logs”的完整路径。
debug_dump为布尔字段。启用后将生成二进制请求快照。此功能通常仅在排查Hook或MCP通信故障时开启，日常使用请保持为false，以避免产生大量冗余数据。