LinkAI 桌面客户端无法连接本地资源——权限与安全机制说明

桌面客户端的安全模型是"工作空间内外有别"——Agent 在自己的工作空间目录内可以自主操作文件、执行终端命令、控制浏览器，但工作空间之外的操作需要你手动确认。理解这个模型能解释大部分"桌面端好像卡了 / 没反应"的现象。

安全模型

桌面客户端安装完成后会在你的用户目录下创建一个独立的工作空间（具体路径在客户端设置里可以看到）。这个目录是 Agent 的"主场"：

当 Agent 想要操作工作空间之外的文件时：

这个机制是为了防止 Agent 误操作你的重要文件（比如误删 Documents 里的文档）。

一个需要理解的点：虽然文件操作在本机执行，但对话内容和 Agent 执行任务时读取的必要上下文仍然会发送给大模型进行推理。这是所有需要大模型能力的 Agent 产品的共同点。

如果你对这一点敏感，可以用自定义模型接入本地部署的模型，但本地模型的能力上限取决于你的硬件资源。

可能原因：

解决：把客户端保持在前台运行、开启系统通知权限。

可能原因：

解决：处理大文件时给 Agent 足够时间，不要中途中断。

最常见原因：电脑关机或休眠了。桌面客户端的渠道接入依赖客户端在本机运行——关机或休眠时：

解决：

说明 XXX 路径不在 Agent 的工作空间里。在弹出的确认对话框里选择"总是允许"可以永久授权该目录。

桌面客户端的数据全部在本机：

以上目录都是标准文件系统，可以直接用系统自带的方式拷贝到备份位置。桌面客户端关闭后备份最安全——避免读写冲突。

桌面客户端的多智能体团队：

桌面客户端和云端托管共享同一个 LinkAI 账号和积分体系，可以同时开——云端助理负责常驻在线任务，桌面助理负责本机文件和开发，互不干扰。