Qoder日志文件是排查隐蔽系统错误的最终手段，分四类存储：IDE日志在~/.qoder-cn/logs/按日期分层；CLI沙箱日志在项目根目录.qoder-sandbox/logs/；Teams版日志同步至云端归档中心；Reset工具日志存于~/.qoder-reset/audit.log。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder过程中遭遇功能异常、界面无响应或AI行为逻辑断裂，但控制台与IDE界面未显示明显报错，则问题极可能隐藏于未被主动读取的日志文件中。日志文件是系统底层运行状态的原始记录，是深入排查隐蔽系统错误的最终手段。以下是定位Qoder各类日志文件存储位置的详细路径说明：
一、Qoder CN IDE 默认日志目录结构
Qoder CN IDE 将运行时日志按模块与时间维度分层写入用户配置目录，确保调试信息可追溯且不干扰主进程。所有日志均以 UTC 时间戳命名，避免本地时区导致的排序混乱。
1、打开文件管理器，导航至用户主目录下的 ~/.qoder-cn/logs/ 路径（Windows 为 %USERPROFILE%\.qoder-cn\logs\）。
2、进入该目录后，可见子目录按日期组织，例如 2026-05-22/、2026-05-23/。
3、每个日期子目录内包含三类核心日志文件：main.log（主进程生命周期）、agent-execution.log（AI Agent 决策链路）、mcp-protocol.log（MCP 协议握手与消息体）。
4、若需快速定位最近一次崩溃，优先检查 latest.log 符号链接所指向的实际文件，该链接由 IDE 启动时自动更新。
二、Qoder CLI 沙箱环境独立日志路径
当通过 CLI 在 devcontainer 或隔离沙箱中运行 Qoder 时，其日志不复用 IDE 配置目录，而是绑定至当前工作区根目录下的隐藏日志卷，保障环境隔离性与可重现性。
1、在终端中执行 qodercn --status 命令，确认当前会话是否处于 sandbox 模式（输出中含 sandbox: true 字段）。
2、若为沙箱模式，立即进入当前项目根目录，查找 .qoder-sandbox/logs/ 子路径。
3、该路径下存在两个固定文件：sandbox-init.log（容器初始化全过程）与 tool-invoke-trace.log（所有外部工具调用的完整 stdin/stdout/stderr 快照）。
4、注意：该目录在沙箱退出后默认保留 72 小时，超时后由清理守护进程自动删除，如需长期保存，请手动复制至外部位置。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
三、Qoder Teams 版本专属日志归档中心
Qoder Teams 用户的日志不仅本地存储，还会同步至云端归档中心并生成结构化索引。该机制专为跨设备协同排障设计，支持通过任务 ID 反向检索全链路日志快照。
1、登录 Qoder Teams Web 控制台，点击右上角头像，选择【团队设置】→【日志归档】。
2、在归档页面顶部搜索栏输入目标 Quest 的唯一 ID（格式为 qst_abc123xyz），点击搜索。
3、结果列表中将显示该任务关联的所有日志桶（log bucket），每个桶对应一个执行阶段（如 context-load、code-gen、review-loop）。
4、点击任意桶右侧的【下载原始日志】按钮，将获取一个 ZIP 包，内含该阶段全部日志文件及 trace_metadata.json 描述文件。
四、Qoder Reset 工具触发的指纹重置日志
当使用 bunnysayzz/qoder-reset 工具执行本地身份清除操作时，所有关键动作均被写入专用审计日志，用于验证重置完整性及排查残留项。
1、重置完成后，打开终端，执行 cat ~/.qoder-reset/audit.log 查看完整操作流水。
2、该日志严格按时间顺序记录每一项删除动作，包括：deleted: /Users/alice/.config/Qoder/machine-id、forged: IOPlatformUUID → 8a2f1c9e-4d5b-3a7f-8c1e-2b9a4d6c8e1f 等精确路径与伪造值。
3、若发现某路径未被标记为 deleted，说明该位置未被 reset 工具覆盖，需手动检查其所属权限组（如是否位于受 macOS SIP 保护的系统目录下）。
4、审计日志末尾包含 SHA256 校验和字段 checksum: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855，可用于比对日志完整性。
