WorkBuddy 日志是定位任务无响应、中断或异常的关键依据，默认记录指令解析、文件访问、模型调用等核心操作；可通过默认路径查找、自定义参数指定、UI快捷入口查看，并按MSGTYPE/IP/Msg三段式解析，必要时启用DEBUG级别获取完整执行链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中遇到任务无响应、执行中断或结果异常等情况，日志文件是定位问题根源的关键依据。WorkBuddy 的运行日志默认记录所有核心操作行为，包括指令解析、文件访问、模型调用及远程控制交互等。以下是查看与分析日志的具体方法：
一、定位默认日志文件路径
WorkBuddy 未显式指定日志路径时，自动将日志写入启动目录下的 RemoteAgentDeployerUpdater_Log.txt 文件中。该路径取决于安装方式与首次运行位置。
1、Windows 用户：打开安装目录（默认为 C:\Program Files\WorkBuddy\ 或用户自定义路径），查找 RemoteAgentDeployerUpdater_Log.txt 文件。
2、macOS 用户：前往应用程序中右键 WorkBuddy.app →「显示包内容」→ 进入 Contents → Resources 目录，查找 RemoteAgentDeployerUpdater_Log.txt。
3、若通过命令行启动，日志文件位于执行命令时所在的当前工作目录下。
二、启用自定义日志路径
通过启动参数强制指定日志输出位置，便于集中管理与快速检索，尤其适用于多实例部署或自动化任务场景。
1、Windows 命令提示符中，进入 WorkBuddy 安装目录后执行：WorkBuddy.exe --logFile "D:\logs\workbuddy_debug.log"
2、macOS 终端中，切换至应用可执行文件所在路径后执行：./WorkBuddy --logFile "/Users/username/logs/wb_trace.log"
3、日志文件将按指定路径实时生成，格式统一为 [MSGTYPE] [IP address/MachineName] [Msg]，例如：[INFO] 192.168.1.105 [Task received: merge Excel files]
三、通过 UI 界面快捷访问日志
WorkBuddy 桌面客户端内置日志查看入口，无需手动查找文件，支持实时刷新与关键词过滤，适合快速排查即时问题。
1、点击右上角个人头像 → 选择「系统设置」→ 切换至「诊断与日志」页签。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
2、点击「打开日志目录」按钮，系统自动打开包含 RemoteAgentDeployerUpdater_Log.txt 的文件夹。
3、点击「实时查看日志」按钮，弹出独立窗口并持续滚动最新日志条目；支持 Ctrl+F 输入关键词（如 error、fail、timeout）高亮匹配行。
四、解析关键日志字段含义
理解日志结构是高效定位问题的前提。每条日志严格遵循三段式格式，各字段具有明确语义，不可忽略任一部分。
1、[MSGTYPE] 表示消息级别：INFO（常规流程）、WARN（潜在风险）、ERROR（执行失败）、DEBUG（调试细节，需开启高级日志模式）。
2、[IP address/MachineName] 标识操作来源：本地任务显示本机名或 127.0.0.1；企业微信远程指令则显示企微服务器出口 IP 或机器人标识名。
3、[Msg] 为具体事件描述：包含任务ID、文件路径、模型名称、耗时毫秒数等，例如：[ERROR] DESKTOP-ABC123 [Failed to read D:\data\report.xlsx: access denied]
五、启用 DEBUG 级别详细日志
当默认日志无法提供足够线索时，需提升日志详细程度，捕获指令解析、Agent 调度、沙箱执行等内部环节的完整链路。
1、关闭正在运行的 WorkBuddy 进程（任务管理器或活动监视器中确认无残留）。
2、Windows 下以管理员身份运行 CMD，执行：WorkBuddy.exe --logLevel debug --logFile "C:\wb_debug_full.log"
3、macOS 下在终端执行：./WorkBuddy --logLevel debug --logFile "/tmp/wb_debug_full.log"
4、复现问题后，立即停止 WorkBuddy，打开对应日志文件，搜索最近的 [DEBUG] 块，重点关注 task_id、agent_name、sandbox_status 字段值。
