术语表

PuppyOne 的核心概念和术语解释。

数据层级

Organization（组织）
└── Project（项目）
    └── Content Node（内容节点）
        ├── folder  — 文件夹
        ├── json    — JSON 文件
        ├── markdown — Markdown 文件
        └── file    — 二进制文件

核心术语

Organization（组织）

组织是 PuppyOne 的顶层容器，代表一个团队或公司。

• 管理成员和角色（Owner / Admin / Member）
• 管理计费和配额
• 一个用户可以属于多个组织

Project（项目）

项目是组织下的数据命名空间，用于隔离不同业务场景的数据。

• 每个业务场景对应一个 Project，例如「产品知识库」「客服 FAQ」「研发文档」
• 项目内包含内容节点树、连接、Agent 等资源
• 支持项目级别的成员管理和访问控制

Content Node（内容节点）

内容节点是 PuppyOne 云文件系统的基本数据单位，以树形结构组织。

每个内容节点自动追踪版本历史，支持回滚和对比。

Connection（连接）

连接是 PuppyOne 统一的外部集成抽象。所有类型的外部集成都通过 connections 表管理，使用 provider 和 direction 字段区分类型。

MCP（Model Context Protocol）

MCP 是 Anthropic 提出的开放协议，定义了 AI 模型如何与外部工具和数据源交互。

• PuppyOne 为每个 Agent / MCP 端点生成标准的 MCP 接口
• 支持 Cursor、Claude Desktop、Windsurf 等 MCP 兼容客户端直接连接
• Agent 通过 MCP 协议调用绑定的工具

FLS（File Level Security）

文件级权限控制，精确控制每个 Agent 可以访问哪些内容节点。

• 通过 connection_accesses 表管理 Agent 与内容节点的绑定关系
• 支持只读、读写等权限级别
• 遵循最小权限原则

Tool（工具）

工具是 Agent 可调用的数据操作，绑定到具体的内容节点上。

Access Key（访问凭证）

Access Key 是用于机器和 Agent 认证的凭证，格式通常为 cli_xxx。

• 每个 Agent / MCP 端点 / 沙盒端点都有独立的 Access Key
• 支持重新生成（旧密钥立即失效）
• 用于 CLI 工具和 API 的非交互式认证

同步相关

Sync Connector（数据源同步连接器）

同步连接器负责将外部 SaaS 平台的数据拉取到 PuppyOne 中。

• 支持 Notion、GitHub、Gmail、Google Drive 等 15+ 平台
• 数据同步后转换为结构化的 JSON 或 Markdown 内容节点
• 支持增量同步、定时拉取、手动刷新

OpenClaw

PuppyOne 的本地文件夹双向同步协议。

• 将本地目录与云端 Context File System 实时双向同步
• 通过后台守护进程运行
• CLI 命令：puppyone access up / puppyone access down

协作相关

Checkout / Commit（签出 / 提交）

协作编辑工作流，类似 Git 的操作模式。

• Checkout：签出内容节点的工作副本，获取锁
• Commit：提交变更，自动创建新版本
• 支持冲突检测

Snapshot（快照）

文件夹级别的快照备份。

• 保存文件夹在某个时刻的完整状态
• 支持一键回滚到任意快照
• 适合在批量操作前创建安全备份

Audit Log（审计日志）

操作审计日志，记录所有对内容节点的操作。

• 记录谁（用户 / Agent）在什么时间对哪个节点做了什么操作
• 支持按节点、按时间、按操作人查询
• 完整可追溯

分发方式

MCP Server

为 Cursor、Claude Desktop 等 MCP 兼容客户端提供数据访问服务。

REST API

标准 HTTP API，适合自研 Agent、后端集成和自动化脚本。

Publish Link

公开短链接，任何人可以通过链接访问 JSON 数据（只读，无需认证）。

术语对照表