workbuddy导出报表出现字体缺失、乱码等问题，主因是系统缺少中文字体或未正确加载字体库：一、windows需手动安装noto sans cjk sc字体并重启；二、macos需配置字体映射路径；三、启用嵌入字体导出模式；四、替换模板中硬编码的不可用字体。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy安装完成后尝试导出Excel或PDF格式报表时出现“字体缺失”“乱码”“导出失败”或“样式错位”等错误，通常是因为系统缺少中文字体支持，或WorkBuddy未正确加载本地字体库。以下是解决此问题的具体方法：
一、手动安装系统级中文字体（Windows）
WorkBuddy依赖系统字体渲染中文内容，Windows默认不包含完整GB18030兼容字体，需补充安装常用开源中文字体以确保报表导出正常。
1、访问GitHub开源项目Noto CJK字体仓库，下载最新版NotoSansCJKsc-Regular.otf（简体中文版）。
2、右键该字体文件 → 选择“为所有用户安装”。
3、打开“控制面板 → 外观和个性化 → 字体”，确认“Noto Sans CJK SC”已出现在字体列表中。
4、重启WorkBuddy客户端，再次尝试导出报表。
二、配置WorkBuddy字体映射路径（macOS）
macOS虽预装完整中文字体，但WorkBuddy可能因沙箱机制无法自动发现字体目录，需显式指定字体搜索路径。
1、打开访达，前往/System/Library/Fonts与/Library/Fonts，确认存在PingFang.ttc、STHeiti.ttc或Hiragino Sans GB.ttc。
2、在终端执行：mkdir -p ~/Library/Application\ Support/WorkBuddy/fonts。
3、将上述任一ttc字体文件复制一份至该目录（如：cp /System/Library/Fonts/PingFang.ttc ~/Library/Application\ Support/WorkBuddy/fonts/）。
4、启动WorkBuddy后，在设置菜单中进入“高级配置 → 字体路径”，输入：~/Library/Application Support/WorkBuddy/fonts。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、启用嵌入字体导出模式（通用方案）
该模式强制将字体数据打包进导出文件，绕过系统字体依赖，适用于临时应急及跨平台分发场景。
1、在WorkBuddy主界面右上角点击齿轮图标，进入“设置”。
2、切换至“导出设置”标签页。
3、勾选“导出PDF时嵌入中文字体”与“导出Excel时使用备用字体回退”两项。
4、点击“保存并重启服务”，等待状态栏显示“导出引擎已重载”。
四、替换默认报表模板字体（高级用户）
若仅特定模板报错，说明模板内硬编码了不可用字体（如“SimSun”“NSimSun”），需直接修改模板定义文件。
1、定位模板路径：C:\Users\[用户名]\WorkBuddy\Claw\templates\（Windows）或~/WorkBuddy/Claw/templates/（macOS）。
2、用文本编辑器打开对应报表的.json或.yaml配置文件。
3、查找字段"fontFamily"，将其值由"SimSun"或"Microsoft YaHei"统一替换为"Noto Sans CJK SC"或"PingFang SC"。
4、保存文件，刷新WorkBuddy模板缓存：在命令行输入workbuddy-cli --reload-templates。
