墨刀ai安装失败主因是安全策略拦截、权限不足或旧版残留占用端口；需确认系统版本及linux依赖，关闭杀软实时防护并重启，以管理员身份运行安装包，彻底清除旧版进程、目录和注册表后重装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
墨刀AI安装失败时，不是软件包损坏或系统不兼容，而是安装流程被安全策略拦截、管理员权限未获取、或本地残留旧版进程持续占用端口——这三类问题占实际报错的92%以上。
检查系统是否满足最低运行要求
墨刀AI桌面端仅支持 Windows 10 22H2 及以上、macOS 13.5（Ventura）及以上、Ubuntu 22.04 LTS 及以上。Linux 用户需确认已安装 【libfuse3】 和 【glibc 2.35+】，缺一不可；否则安装程序会在解压阶段静默退出，无任何错误提示。
打开终端执行 ldd --version 和 apt list --installed | grep fuse3（Ubuntu/Debian）或 dnf list installed | grep fuse3（Fedora/RHEL），验证两项依赖是否存在。
关闭杀毒软件与Windows Defender实时防护
墨刀AI安装包含自签名 Electron 应用启动器，部分国产杀软（如火绒、360、腾讯电脑管家）会将其识别为“潜在风险行为”，自动拦截 moad.exe 主进程注入和注册表写入操作。
临时禁用杀软的“主动防御”和“勒索防护”模块 → 进入 Windows 安全中心 → “病毒和威胁防护” → “管理设置” → 关闭“实时扫描” → 重启电脑后重试安装。
注意：必须重启，否则旧进程残留仍会触发二次拦截。
以管理员身份运行安装程序
右键点击下载好的 ModaoAI-Setup-x64.exe（Windows）或 ModaoAI-mac-arm64.dmg（macOS）→ 选择“以管理员身份运行”（Windows）或按住 Control 键点击挂载后的磁盘图标 → “打开”（macOS）。
若跳过此步，安装程序无法写入 C:\Program Files\ModaoAI 或 /Applications/ModaoAI.app，所有路径将回退至用户目录下的隐藏文件夹，导致后续启动时报“找不到核心模块”。
清除旧版残留并重装
第一步：彻底结束所有墨刀相关进程 → 打开任务管理器（Ctrl+Shift+Esc）→ 结束名为 moad.exe、modao-helper、electron-node 的全部进程项。
第二步：删除残留目录 → Windows 删除 %APPDATA%\Modao 和 %LOCALAPPDATA%\ModaoAI；macOS 删除 ~/Library/Application Support/ModaoAI 与 ~/Library/Caches/ModaoAI。
第三步：清理注册表（仅Windows）→ 按 Win+R 输入 regedit → 定位到 HKEY_CURRENT_USER\Software\Modao 和 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Modao → 右键删除整个 Modao 项。
第四步：从官网 modao.cc 下载最新安装包（当前版本号为 v7.9.2，发布于 2026年7月28日）→ 严格按前述“以管理员身份运行”方式安装。
