Runtime2026-06-305 min
本地助手如何让 Agent 处理私有文件和内网任务？
Maya 的本地助手把执行平面放到用户自己的电脑或服务器上，让 Agent 在可控边界内访问私有文件、项目目录、内部网络和本机 CLI，同时让状态、审批和产物回到工作台。
Short answer
Maya 的 API Server 是控制平面，不直接读取用户本机文件。需要私有文件或内网资源时，由已连接的本地助手认领 Task 并回报状态和 Artifact。
控制平面和执行平面分离
Maya Web 负责创建 Goal、Task、Approval 和 Artifact 记录。本地助手负责真实执行：读取项目目录、调用本机 CLI、访问内网服务，并把结果回报给工作台。
适合哪些场景
本地助手适合处理不能上传到云端的代码仓库、财务表格、内部系统、私有网络、客户资料和本机工具链。
- 需要访问本地项目目录。
- 需要使用用户机器上的 CLI 或文档转换工具。
- 需要连接公司内网或敏感数据源。
可见性仍然留在工作台
即使任务在本地执行，用户仍能在 Maya 里看到队列状态、执行日志、Approval 请求和 Artifact 结果。这样私有执行和团队协作不会割裂。
FAQ
API Server 会直接读取我的本机目录吗？
不会。Maya 的控制平面只保存资源指针和状态，真实文件访问由本地助手在用户授权的机器上执行。
本地助手离线时还能分配任务吗？
不应该。Maya 会在创建任务或目标时过滤不可执行的 Agent，并保留 API 的硬边界。