症状：

• 错误如 Missing env var ...

修复：

1. 导出你的提供商 env_api_key 引用的环境变量。
2. 检查 config.toml 中的 current_provider 和提供商条目。
3. 从设置了环境变量的同一 shell 重启 Memo。

症状：

• 在管道模式下写入/执行操作被拒绝

原因：

• 纯文本模式没有交互式审批 UI

修复：

1. 运行交互式 TUI：memo
2. 或在受控环境中使用 memo --dangerous
3. 或保持任务只读

症状：

• search_files 没有匹配结果，或者结果过多

修复：

• 使用相对于输入 path 的 glob 模式（例如 **/*.ts）
• 使用 excludePatterns 缩小范围（例如 node_modules/**）

检查环境开关：

• MEMO_SHELL_TOOL_TYPE
• MEMO_FS_ALLOWED_ROOTS
• MEMO_ENABLE_MEMORY_TOOL
• MEMO_ENABLE_COLLAB_TOOLS

症状：

• 最终消息指示提示/上下文令牌超出限制

修复：

1. 使用 /new 重置会话上下文
2. 缩小任务范围并分小块继续
3. 如有需要，设置 model_profiles.<model>.context_window（或 model_profiles."provider:model".context_window）为更大的值

症状：

• memo mcp list 显示配置，但当前 TUI 会话未反映

修复：

1. 用 /mcp 检查
2. 在 MCP 配置更改后创建新会话（/new）或重启 Memo

检查项：

1. 目标 server 必须是 streamable_http（stdio server 不支持 OAuth 登录）。
2. 远程 URL 在当前网络下可达。
3. 回调端口可用（必要时在 config.toml 设置 mcp_oauth_callback_port）。

回退方案：

• 使用 --bearer-token-env-var 的令牌认证方式。

spawn_agent 并发错误

原因：

• 运行子代理达到 MEMO_SUBAGENT_MAX_AGENTS

修复：

• 增加限制
• 关闭已完成/未使用的代理
• 减少并行分散

send_input 忙碌错误

修复：

• 等待当前提交完成，或
• 使用 interrupt=true 发送

wait 持续超时

修复：

• 验证 MEMO_SUBAGENT_COMMAND 可执行
• 增加 timeout_ms（有效范围 10000 到 300000）
• 简化子代理任务范围

症状：

• 工具结果被 <system_hint ... tool_output_omitted ...> 消息替换

原因：

• 工具输出超出 MEMO_TOOL_RESULT_MAX_CHARS

修复：

1. 缩小查询范围（路径、模式、限制）
2. 将工作拆分为更小的调用
3. 仅在必要时增加 MEMO_TOOL_RESULT_MAX_CHARS

症状：

• No previous session found for current directory.

修复：

1. 先在同一目录运行一次普通会话。
2. 确认 ~/.memo/sessions/ 下已生成该项目路径对应的历史文件。
3. 再次执行 memo --prev。