文件资源管理器

每个智能体的所有配置、记忆和技能都以文件的形式存储在 AgentFS（智能体文件系统）中。资源管理器让你可以直观地浏览和管理这些文件。

AgentFS 文件结构概览

每个智能体的文件存放在 ~/.desirecore/agents/<agent_id>/ 目录下：

<agent_id>/
├── agent.json        # 入口配置
├── persona.md        # 人格设定
├── principles.md     # 行为准则
├── memory/           # 记忆文件
│   └── *.md          # 每条记忆一个文件
├── skills/           # 技能目录
│   └── <skill_id>/   # 每个技能一个目录
│       └── SKILL.md  # 技能说明文档
├── tools/            # 工具注册
├── workflows/        # 工作流定义
├── heartbeat/        # 心跳配置
├── resources/        # 资源文件
├── assets/           # 静态资源
└── .git/             # Git 版本管理

为什么用文件系统？

DesireCore 的设计理念是"一切皆文件"。文件比数据库更透明——你可以直接查看、编辑、备份和版本管理。智能体的每一次变化都记录在 Git 历史中。

浏览智能体的文件

打开资源管理器

进入智能体详情页
点击"文件"标签页
资源管理器以树形结构展示智能体的所有文件

文件预览

点击任意文件可以在右侧预览其内容：

Markdown 文件（.md）：渲染后的富文本预览
JSON 文件（.json）：语法高亮的 JSON 视图
YAML 文件（.yaml）：语法高亮的 YAML 视图

文件编辑

对于 Markdown 和配置文件，你可以在预览界面直接编辑。编辑后保存会自动生成一个 Git commit，记录在版本历史中。

修改配置文件请谨慎

直接编辑 agent.json 等核心配置文件可能影响智能体的正常运行。如果你不确定某个字段的含义，建议通过界面或对话来修改。

上传和管理资源文件

你可以将参考文档、模板、数据文件等上传到智能体的 resources/ 目录，供智能体在工作时引用。

上传文件

在资源管理器中导航到 resources/ 目录
点击"上传"按钮
选择本地文件
文件上传后自动生成 commit

管理文件

重命名：右键点击文件，选择"重命名"
删除：右键点击文件，选择"删除"（会记录在版本历史中，可恢复）
移动：拖拽文件到目标目录

文件类型说明

文件	格式	说明
`agent.json`	JSON	入口配置：名称、版本、描述、分类等元数据
`persona.md`	Markdown	人格设定：语气、风格、回答策略
`principles.md`	Markdown	行为准则：规则、禁区、优先级
`memory/*.md`	Markdown	记忆条目：学到的知识和偏好
`skills/*/SKILL.md`	Markdown	技能文档：技能说明和执行指令
`tools/*.json`	JSON	工具注册：可调用工具的参数定义
`heartbeat/HEARTBEAT.md`	Markdown	心跳配置：自动任务和触发条件
`resources/*`	任意	参考资源：文档、模板、数据文件

下一步

技能管理 — 了解如何为智能体添加和管理技能
版本管理 — 了解智能体的 Git 版本控制

AgentFS 文件结构概览​

浏览智能体的文件​

打开资源管理器​

文件预览​

文件编辑​

上传和管理资源文件​

上传文件​

管理文件​

文件类型说明​

下一步​