dootask/resources/ai-kb/zh/faq/electron-client/logs.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
electron-client.logs.faq	桌面端日志在哪 / 闪退排查	faq	electron-client	end-user	zh	桌面端日志 客户端崩溃 桌面端闪退 客户端打不开 客户端报错 日志路径 log 在哪 客户端卡死				日志文件存在用户目录的应用日志路径下,客户端不内嵌日志查看器 没有「一键导出诊断包」功能,需要用户手动取日志 业务侧错误(发消息失败、接口超时)写在主进程日志,而非渲染进程	v1.7.90

桌面端日志在哪 / 闪退排查

问题

DooTask 桌面端启动后白屏、闪退、卡死,需要查看日志判断原因。

日志路径

桌面端使用 electron-log 写日志,默认路径(app-name 为 DooTask):

• macOS:~/Library/Logs/DooTask/main.log
• Windows:%USERPROFILE%\AppData\Roaming\DooTask\logs\main.log
• Linux:~/.config/DooTask/logs/main.log

主要日志文件:

• main.log:主进程 + 业务事件(网络、更新、托盘、IPC)
• renderer.log:渲染进程(网页内)异常(部分版本)
• 历史日志会按大小滚动归档为 main.old.log 等

常见原因与排查

1. 启动直接闪退

• 检查日志末尾是否有 JavaScript exception 或 Uncaught
• 升级 / 降级到对应系统兼容的版本(electron-client.platforms.concept)
• macOS 13 之前的旧系统可能不兼容 Electron 38

2. 白屏 / 卡在 loading

• 多半是无法连接服务器
• 临时退出 → 启动前先确认浏览器能打开服务器域名
• 检查 electron-client.proxy.concept 代理设置

3. 收不到通知 / 没有红点

• 见 electron-client.notify.concept 的授权排查
• 日志搜 notification 关键字

4. 更新失败

• 日志搜 update 关键字看 electron-updater 报错
• 通常是更新源不可达,改用 electron-client.update.howto 手动升级

提交反馈

向开发 / 运维提反馈时附上:

1. main.log 最后 200 行
2. 系统版本、客户端版本(关于页查看)
3. 复现步骤
4. 截图(若是 UI 问题)

不支持

• 客户端 UI 不内嵌日志查看 / 上传(需用户手动取文件)
• 日志不会自动上传到服务器(隐私考虑)
• 不支持远程实时日志(只能事后分析)