故障排除

日志文件

VMark 会写入日志文件以帮助诊断问题。日志包含来自 Rust 后端和前端的警告与错误信息。

日志文件位置

平台	路径
macOS	~/Library/Logs/app.vmark/
Windows	%APPDATA%\app.vmark\logs\
Linux	~/.local/share/app.vmark/logs/

日志级别

级别	记录内容	生产环境	开发环境
Error	失败、崩溃	是	是
Warn	可恢复的问题、降级处理	是	是
Info	关键节点、状态变化	是	是
Debug	详细跟踪信息	否	是

日志轮转

• 最大文件大小：5 MB
• 轮转策略：保留一个历史日志文件
• 旧日志会被自动替换

报告 Bug

报告 Bug 时，请包含以下信息：

1. VMark 版本 — 显示在导航栏徽章或"关于"对话框中
2. 操作系统 — macOS 版本、Windows 版本号或 Linux 发行版
3. 复现步骤 — 问题发生前你做了什么操作
4. 日志文件 — 附上或粘贴相关的日志条目

日志条目带有时间戳并按模块标记（例如 [HotExit]、[MCP Bridge]、[Export]），便于查找相关内容。

查找相关日志

1. 根据上表打开日志目录
2. 打开最新的 .log 文件
3. 搜索问题发生时间附近的 ERROR 或 WARN 条目
4. 复制相关行并附在你的 Bug 报告中

常见问题

应用在 Windows 上启动缓慢

VMark 针对 macOS 进行了优化。在 Windows 上，由于 WebView2 初始化，启动可能较慢。请确保：

• WebView2 Runtime 已更新到最新版本
• 杀毒软件没有对应用数据目录进行实时扫描

切换语言后菜单栏仍显示英文

如果在设置中切换语言后菜单栏仍然显示英文，请重启 VMark。菜单会在下次启动时使用已保存的语言重新构建。

终端不接受中日韩标点符号

已在 v0.6.5+ 中修复，请更新到最新版本。