管理数据
在 PuppyOne 中创建、编辑、组织你的数据。
为什么需要管理数据
导入的原始数据可能需要：
- 清理 — 删除无关字段、修正错误
- 重组 — 调整 JSON 结构，便于 Agent 查询
- 补充 — 添加元数据、标签
PuppyOne 数据模型
PuppyOne 的数据以 Content Node 树形式组织，类似文件系统：
Project（项目）
├── 📁 products/ ← 文件夹节点
│ ├── 📄 catalog.json ← JSON 节点
│ └── 📄 intro.md ← Markdown 节点
├── 📁 docs/
│ ├── 📄 readme.md
│ └── 📁 api/
│ └── 📄 endpoints.json
└── 📎 logo.png ← 文件节点| 节点类型 | 说明 |
|---|---|
| Folder | 文件夹，用于组织层级结构 |
| JSON | 结构化数据，支持对象、数组、嵌套 |
| Markdown | 富文本内容，适合文档、知识库 |
| File | 二进制文件（图片、PDF 等） |
每个 Content Node 都有独立的路径、权限控制、版本历史。
了解更多请参考 核心概念 — Content Node。
核心功能
JSON 树编辑器
可视化编辑 JSON 数据：
- 树形导航嵌套结构
- 点击即可编辑任意值
- 添加新字段或数组项
- 删除不需要的节点
版本控制
每次修改都会自动保存版本：
- 查看修改历史
- 对比不同版本（Diff）
- 一键回滚到任意版本
- 文件夹级快照
数据结构建议
为了让 Agent 更高效地使用数据，建议：
推荐的结构
{
"products": [
{
"id": "SKU-001",
"name": "Widget Pro",
"price": 99.99,
"category": "电子产品"
}
],
"categories": ["电子产品", "配件", "服务"]
}特点：扁平化、字段名清晰、类型一致
不推荐的结构
{
"data": {
"items": {
"group1": {
"subgroup": {
"products": [...]
}
}
}
}
}问题：嵌套过深，Agent 难以准确定位