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

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

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

​

目录结构

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

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

将整个 ~/.octop/ 目录复制到另一台机器，就可以迁移您的完整 Octop 安装——参阅备份与恢复。