codebuddy在apple silicon mac上卡顿等问题，主因是未运行原生arm64版本或缺失系统权限；需验证架构、清除隔离属性、授予辅助功能/完全磁盘访问/屏幕录制权限，并确保npu加速启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在搭载 Apple Silicon 芯片（M1/M2）的 Mac 上运行腾讯云代码助手 CodeBuddy，但出现卡顿、AI 推理延迟高、屏幕录制失败或自动化模块无法启动等问题，则很可能是由于应用未以原生 ARM64 架构运行，或系统权限未正确授予。以下是针对性的兼容性验证与优化步骤：
一、确认是否为原生 ARM64 版本
CodeBuddy 必须以原生 arm64 架构运行，否则将强制经 Rosetta 2 翻译执行，导致 AI 推理性能下降、辅助功能与屏幕录制权限不可用——这是 macOS 系统级限制，而非软件 Bug。
1、下载完成后，打开「访达」，右键 CodeBuddy.app → 「显示简介」→ 查看「通用」标签页中「种类」是否显示为应用程序(ARM)。
2、若显示为「应用程序(Intel)」，说明安装包错误；此时请立即删除，并前往官方唯一可信入口重新下载：https://www.php.cn/link/34a167480f1ee9328cf6f555ef1b7940。
3、终端验证：在「终端」中执行 file /Applications/CodeBuddy.app/Contents/MacOS/CodeBuddy，输出内容中必须包含 arm64 字样才表示架构正确。
二、清除 Gatekeeper 隔离属性
macOS 对首次安装的第三方签名应用自动添加 com.apple.quarantine 属性，触发「已损坏，无法打开」提示。该提示并非病毒警告，而是 Gatekeeper 的默认拦截行为，需手动移除隔离标识才能正常启动。
1、将 CodeBuddy.app 拖入「应用程序」文件夹。
2、打开「终端」，粘贴并执行：xattr -d com.apple.quarantine /Applications/CodeBuddy.app。
3、若返回 Operation not permitted，请立即前往「系统设置 → 隐私与安全性 → 安全性」，在底部点击「仍要打开」完成放行。
使用 inotes CLI 从终端管理 Apple Notes。当需要在 macOS 的 Notes.app 中列出、读取、创建、编辑、删除或搜索备忘录时使用。
三、授予三项必需系统权限
CodeBuddy 的 AI 自动化（Claw）、屏幕内容理解与交互操作依赖 macOS 底层权限支持。只有原生 ARM64 应用才能被授予以下三项权限，缺一不可。
1、打开「系统设置 → 隐私与安全性 → 辅助功能」，点击左下角锁图标解锁，勾选 CodeBuddy。
2、同路径进入「完全磁盘访问」，点击「+」号添加 CodeBuddy.app。
3、同路径进入「屏幕录制」，同样添加 CodeBuddy.app 并确保其处于启用状态。
四、验证 NPU 加速能力与任务延迟
CodeBuddy 的多步任务规划、跨文件分析与本地文档处理高度依赖芯片神经网络引擎（NPU）。M1 与 M2 在 NPU 算力与调度机制上存在代际差异，直接影响响应速度与稳定性。
1、在 CodeBuddy 中执行「读取 50 个 Excel 表 → 匹配字段 → 生成可视化报告」任务，观察 task_plan_delay 数值：M1 通常 >4.2 秒，M2 约 2.7 秒，M2 连续触发易出现 claw_sync_timeout 报错。
2、检查主界面右下角状态栏是否显示 NPU: Active；若显示 NPU: Fallback，说明当前会话未启用硬件加速，需重启应用并重试权限授予流程。
3、执行 PDF 发票提取（extract_invoice_pdf）时，若 CPU 温度持续 >85°C 或磁盘 I/O 等待占比 >30%，表明未进入高效能通路，应核查是否运行于 macOS 12 及以上版本且未启用 Rosetta。
