• 简体中文

      • 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 安装——参阅备份与恢复。