> ## Documentation Index
> Fetch the complete documentation index at: https://octop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Octop 数据目录：~/.octop/ 中的文件与文件夹

> Octop 存储的所有内容——数据库、专家工作区、密钥、日志和插件——都位于 ~/.octop/ 下。了解每个文件和文件夹的作用。

Octop 存储的一切——数据库、专家工作区、密钥、日志和插件——都位于 `~/.octop/` 下。了解每个文件和文件夹的作用。

## 目录结构

```text theme={null}
~/.octop/
├── config.json           # 服务器配置
├── env                   # 可选 dotenv（OCTOP_DATABASE_*、API 密钥等）；服务器启动时加载
├── octop.db              # 主 SQLite 数据库
├── venv/                 # 隔离的 Python 环境
├── bin/                  # octop CLI 可执行文件
├── secrets/
│   └── jwt_secret        # 32 字节随机 JWT 密钥
├── agents/
│   └── <agent-name>/     # 每个专家的工作区
├── logs/                 # 服务日志与 harness 运行时诊断（行内带 `[agent=…]`）
│   └── octop.log
├── plugins/
│   └── <plugin-name>/    # 已安装的插件
├── backups/              # 手动与自动备份
├── embedding_models/     # 本地 ONNX 嵌入缓存
└── published_experts/    # 已发布专家快照
```

`env` 为 dotenv 格式，在加载 `config.json` 之前生效。适合进程环境难以设置的场景（例如 Docker 卷挂载）。页面中的**环境变量**以及部分工具也会读写该文件。

## 字段详解

| 路径 | 描述 |
| - | - |
| `config.json` | 服务器级别的配置（参见[配置文件](https://octop.mintlify.site/zh/configuration/config-file.md)） |
| `env` | 可选 dotenv；启动时注入 `OCTOP_DATABASE_*`、API 密钥等 |
| `octop.db` | 存储用户、专家、渠道、对话历史和定时任务的主数据库 |
| `venv/` | 安装时创建的隔离 Python 虚拟环境 |
| `bin/` | 包含 `octop` 可执行文件，添加到用户 PATH |
| `secrets/jwt_secret` | 用于签发和验证 JWT 访问令牌的密钥 |
| `agents/<name>/` | 每个专家的专属工作区，存放它生成或处理的文件 |
| `logs/` | 服务日志与 harness 诊断日志（与 `octop.log` 并排） |
| `plugins/<name>/` | 已安装的插件代码 |

> [!WARNING]
>
> 不要手动编辑 `octop.db`。若需修改数据，请使用 `octop` CLI 命令或页面。

> [!TIP]
>
> 将整个 `~/.octop/` 目录复制到另一台机器，就可以迁移您的完整 Octop 安装——参阅[备份与恢复](https://octop.mintlify.site/zh/guides/backup-restore.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.