131 lines
3.4 KiB
Markdown
131 lines
3.4 KiB
Markdown
# Dashboard Nanobot 数据库设计文档（同步到当前代码）
|
||
|
||
数据库默认使用 SQLite：`data/nanobot_dashboard.db`。
|
||
|
||
## 1. ERD
|
||
|
||
```mermaid
|
||
erDiagram
|
||
BOTINSTANCE ||--o{ CHANNELROUTE : "路由"
|
||
BOTINSTANCE ||--o{ BOTMESSAGE : "消息"
|
||
NANOBOTIMAGE ||--o{ BOTINSTANCE : "被引用"
|
||
|
||
BOTINSTANCE {
|
||
string id PK
|
||
string name
|
||
text system_prompt
|
||
text soul_md
|
||
text agents_md
|
||
text user_md
|
||
text tools_md
|
||
text identity_md
|
||
text tools_config_json
|
||
string llm_provider
|
||
string llm_model
|
||
string api_key
|
||
string api_base
|
||
float temperature
|
||
float top_p
|
||
int max_tokens
|
||
float presence_penalty
|
||
float frequency_penalty
|
||
string workspace_dir UK
|
||
string docker_status
|
||
string image_tag
|
||
string current_state
|
||
text last_action
|
||
datetime created_at
|
||
datetime updated_at
|
||
}
|
||
|
||
BOTMESSAGE {
|
||
int id PK
|
||
string bot_id FK
|
||
string role
|
||
text text
|
||
text media_json
|
||
datetime created_at
|
||
}
|
||
|
||
NANOBOTIMAGE {
|
||
string tag PK
|
||
string image_id
|
||
string version
|
||
string status
|
||
string source_dir
|
||
datetime created_at
|
||
}
|
||
|
||
CHANNELROUTE {
|
||
int id PK
|
||
string bot_id FK
|
||
string channel_type
|
||
string external_app_id
|
||
string app_secret
|
||
text extra_config
|
||
int internal_port
|
||
boolean is_active
|
||
}
|
||
```
|
||
|
||
## 2. 表说明
|
||
|
||
### 2.1 `botinstance`
|
||
|
||
存储机器人实例核心配置与运行参数。
|
||
|
||
- 运行与镜像：`docker_status`、`image_tag`
|
||
- LLM 基础：`llm_provider`、`llm_model`、`api_key`、`api_base`
|
||
- LLM 参数：`temperature`、`top_p`、`max_tokens`
|
||
- Agent Bootstrap 内容：`soul_md`、`agents_md`、`user_md`、`tools_md`、`identity_md`
|
||
- 工具配置：`tools_config_json`
|
||
- 运行态：`current_state`、`last_action`
|
||
|
||
### 2.2 `botmessage`
|
||
|
||
保存 Dashboard 渠道持久化对话消息。
|
||
|
||
- `role`：`user | assistant`
|
||
- `text`：消息正文
|
||
- `media_json`：附件路径列表（JSON 字符串）
|
||
|
||
### 2.3 `nanobotimage`
|
||
|
||
镜像登记表（只记录显式登记镜像）。
|
||
|
||
- `tag`: 如 `nanobot-base:v0.1.4`
|
||
- `status`: `READY | BUILDING | ERROR | UNKNOWN`
|
||
- `source_dir`: 当前手工模式通常为 `manual`
|
||
|
||
### 2.4 `channelroute`
|
||
|
||
渠道路由映射表。
|
||
|
||
- `dashboard` 为内置渠道，不允许删除或禁用。
|
||
- `extra_config` 保存各渠道差异化字段。
|
||
|
||
## 3. 已移除的数据表
|
||
|
||
以下旧表已废弃，并在服务启动时自动删除：
|
||
|
||
- `skillregistry`
|
||
- `botskillmapping`
|
||
|
||
技能管理改为 **workspace 文件系统模式**：
|
||
|
||
- 路径：`workspace/bots/{bot_id}/.nanobot/workspace/skills/`
|
||
- 管理 API：`/api/bots/{bot_id}/skills`、`/api/bots/{bot_id}/skills/upload`、`/api/bots/{bot_id}/skills/{skill_name}`
|
||
|
||
## 4. 启动迁移策略（当前实现）
|
||
|
||
服务启动时自动执行：
|
||
|
||
1. `SQLModel.metadata.create_all(engine)`
|
||
2. 删除旧 skills 表（`DROP TABLE IF EXISTS botskillmapping/skillregistry`）
|
||
3. 针对 `botinstance` 和 `botmessage` 做增量列补齐（`ALTER TABLE ADD COLUMN`）
|
||
|
||
## 5. 安全与一致性
|
||
|
||
- `api_key`、`app_secret` 建议加密存储（当前代码为明文字段，生产需加密层）。
|
||
- 启动 Bot 前，以数据库字段 + 渠道路由重新生成 workspace 文件，确保配置一致性。
|