Question 1

PuppyOne 是什么？

Accepted Answer

PuppyOne 是为 AI Agent 打造的基于文件的工作区。它将你的 SaaS 数据（Notion、Slack、Gmail、Postgres 等）聚合到统一的文件系统中，让多个 Agent 通过细粒度权限协同工作，并以 Git 式版本控制记录每一次变更。可以把它理解为你的 AI 流水线从未拥有过的共享、版本化「硬盘」。

Question 2

为什么 AI Agent 需要 PuppyOne？

Accepted Answer

三个理由。第一，Agent 会产出有价值的内容——研究报告、代码、分析结果——但大多数运行时在会话结束后全部丢失。PuppyOne 在每一份内容写入的瞬间就完成备份，不会丢失任何东西。第二，当你同时运行多个 Agent（用 Claude 做调研、GPT 写文档、自定义 Agent 做数据处理），它们需要共享文件而不互相干扰。PuppyOne 在同一个工作区为每个 Agent 设置独立权限。第三，你的上下文散落在 Notion、Slack、Gmail、数据库等各处——PuppyOne 把它们全部聚合到一个基于文件的工作区，Agent 可以直接用 cat、grep、ls 读取。备份、协同、聚合——这就是 Agent 需要 PuppyOne 的原因。

Question 3

Agent 会话结束或崩溃后，所有输出都丢失了。PuppyOne 如何防止数据丢失？

Accepted Answer

这正是 PuppyOne 解决的核心问题。Agent 写入的每个文件都会立即提交到版本化工作区——而不是仅保留在会话内存中。会话结束或 Agent 崩溃后，每一份输出都完好保存，并附有完整的变更记录。无需再重跑流水线来恢复丢失的工作。你还可以在高风险操作前创建检查点，并在毫秒内回滚到任意历史状态。

Question 4

哪些 Agent 和工具可以接入 PuppyOne？（n8n、OpenAI、Claude、Cursor、Manus……）

Accepted Answer

只要工具能发送 HTTP 请求或支持 MCP，就可以接入 PuppyOne。已验证的集成包括：n8n（通过 HTTP Request 节点）、OpenAI Assistants API 和 Agents SDK、Claude / Anthropic（原生 MCP）、Cursor（MCP）、LangChain 和 LangGraph、CrewAI、AutoGen（微软）以及 Manus。每个集成都获得独立的 Access Point 和作用域权限——多个工具可以安全共享同一工作区，互不干扰。

Question 5

多个 Agent 如何协作而不互相覆盖？

Accepted Answer

每个 Agent 获得一个 Access Point——对工作区的作用域访问入口，包含明确的读写路径。Agent A 可以对 /finance 有写权限，对 /shared 只读；Agent B 则拥有 /docs。路径隔离防止冲突；对于协调写入，Agent 可以在独立分支上工作，完成后通过 API 合并。

Question 6

我可以为不同的 Agent 设置不同的权限级别吗？

Accepted Answer

可以——这是 PuppyOne 的核心功能。每个 Access Point 定义 Agent 可以读哪些路径、写哪些路径，以及哪些路径完全不可见。不受信任的外部 Agent 可以被限制为对单个文件夹的只读权限；内部编排器可以拥有完整工作区访问权限。权限变更立即生效，无需重新部署。

Question 7

我可以将哪些 SaaS 数据源同步到 PuppyOne？

Accepted Answer

目前支持的连接器包括：Notion、Slack、Gmail、Google Sheets、Postgres、MongoDB、Linear、Jira 和 Airtable，后续持续新增。数据经过同步、清洗后以结构化文件（.json、.md、文件夹）形式写入，任何 Agent 都可通过 Bash、MCP 或 API 读取。如果你的数据源暂未列出，也可以通过 API 直接推送。

Question 8

Agent 生成的文件如何进行版本控制？

Accepted Answer

每次写操作都会创建一个带有 Agent 身份、时间戳和差异内容的提交。你可以通过类似 git log 的 API 查看完整历史、在高风险操作前创建分支、完成后合并分支。版本图可查询——例如「昨天下午 2 点到 4 点，agent-b 在 /finance 改了什么」，可以得到精确答案。

Question 9

如果 Agent 删除或损坏了文件怎么办？

Accepted Answer

工作区的每个状态都被保留。打开审计日志，找到最后一个已知良好的提交，使用该提交哈希调用回滚 API。工作区会在毫秒内恢复到那个精确状态。你也可以只回滚单个文件，而不影响工作区的其他部分。

Question 10

Agent 实际上如何访问工作区？

Accepted Answer

三种访问方式：(1) Bash / Shell——在容器中运行的 Agent 可以像使用普通文件系统一样 cat、grep、ls 和写文件。(2) MCP——为 Claude、Cursor 及所有兼容 MCP 的客户端提供原生 Model Context Protocol 服务器。(3) REST API——与语言无关，任何 HTTP 客户端均可使用。三种方式共享同一套权限模型和版本历史。

Question 11

PuppyOne 和给 Agent 一个共享文件夹或 Dropbox 有什么区别？

Accepted Answer

共享文件夹没有 Agent 身份识别、无法对每个 Agent 设置权限，也没有结构化版本历史。Dropbox 没有 Bash 访问、不支持 MCP、没有 SaaS 数据聚合管道，也没有分支/合并语义。PuppyOne 专为多 Agent 流水线构建：每次操作都归属于特定 Agent，每个路径都可以对每个 Agent 单独设置权限，整个工作区从第一天起就是 Git 版本化的。

Question 12

我可以私有化部署 PuppyOne 吗？数据会离开我的 VPC 吗？

Accepted Answer

可以。我们为企业环境提供自托管 Docker 部署方案。在自托管模式下，所有文件存储、元数据和版本历史完全保留在你的基础设施内，不会向我们的服务器发送任何数据。你可以选择接入控制平面用于监控和更新，但这不是必须的。完全数据主权，零锁定。

Question 13

如何获得支持或联系团队？

Accepted Answer

直接发邮件给创始人：guantum@puppyone.ai，或在 Twitter 私信我们：https://x.com/puppyone_ai，也可以加入我们的 Discord 社区获得实时支持并分享你正在构建的东西。我们会认真阅读每一条消息。

常见问题