WorkBuddy启动失败或技能包无法加载时，需安装.NET Core 3.1或6.0 Runtime：Windows/macOS用户分别下载对应安装包，安装后验证dotnet --list-runtimes输出，并删除plugin_dependencies.lock文件重启扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地运行WorkBuddy，但软件启动失败或AI技能包无法加载，则可能是由于系统缺少必要的.NET Core运行时支持。WorkBuddy自身不直接依赖.NET Core，但其部分第三方插件、自定义技能包（尤其是基于ASP.NET Core构建的Web API类扩展）需由对应版本的.NET Core Runtime承载执行。以下是满足兼容性要求的具体方案：
一、确认所需.NET Core版本
WorkBuddy官方未强制绑定特定.NET Core版本，但根据已验证的插件生态与技能市场主流包结构，必须安装.NET Core 3.1 Runtime或.NET 6.0 Runtime（任选其一）。其中.NET Core 3.1为长期支持（LTS）版本，兼容绝大多数旧版技能；.NET 6.0 Runtime则适配新发布的Claw-Enhanced插件及OpenAPI集成模块。不可使用.NET Core 2.2或更早版本，亦不可仅安装SDK而遗漏Runtime。
1、访问微软官方.NET下载页：https://dotnet.microsoft.com/zh-cn/download/dotnet
2、在页面中定位「.NET Core 3.1」或「.NET 6.0」栏目，点击「Runtime」标签页
3、选择与当前操作系统匹配的安装包：Windows x64、macOS x64/ARM64 或 Linux x64
二、Windows平台Runtime安装步骤
该方法适用于Windows 10/11系统，安装后自动注册全局环境变量，无需手动配置PATH。
1、双击下载的dotnet-runtime-3.1.x-win-x64.exe或dotnet-runtime-6.0.x-win-x64.exe文件
2、在安装向导中保持默认选项，点击「安装」
3、安装完成后，打开命令提示符（CMD），输入dotnet --list-runtimes，确认输出中包含"Microsoft.AspNetCore.App 3.1.x"或"Microsoft.NETCore.App 6.0.x"
4、若未显示，重启命令提示符或重新登录系统账户
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、macOS平台Runtime安装步骤
该方法通过pkg安装包完成系统级注册，确保WorkBuddy插件进程可调用原生运行时。
1、双击下载的dotnet-runtime-3.1.x-osx-x64.pkg或dotnet-runtime-6.0.x-osx-arm64.pkg文件
2、按提示输入管理员密码，全程点击「继续」「安装」直至完成
3、打开终端，执行dotnet --list-runtimes，验证输出含对应版本条目
4、如提示command not found，执行export PATH=$PATH:/usr/local/share/dotnet并写入~/.zshrc
四、验证WorkBuddy插件兼容性
安装Runtime后需触发WorkBuddy重新扫描技能依赖，否则已有插件仍可能报“无法加载主机运行时”错误。
1、关闭WorkBuddy主程序（包括系统托盘进程）
2、打开WorkBuddy安装目录下的Claw子文件夹（Windows路径为C:\Program Files\WorkBuddy\Claw，macOS路径为~/Library/Application Support/WorkBuddy/Claw）
3、删除其中名为plugin_dependencies.lock的文件
4、重新启动WorkBuddy，进入「技能市场」→「我的技能」，点击右上角刷新按钮
