跳到主要内容

# KVDB 与 TableDB

除了设备控制，XXTLanControl 还内置了两套可以直接在界面中操作的数据系统：KVDB 和 TableDB。

## KVDB​

KVDB 适合保存轻量共享状态，包含两类结构：

- `queue`：队列，适合做任务分发、消费游标、待处理列表
- `dict`：词典，适合做配置、标记、计数器和共享变量

当前 KVDB 管理界面支持：

- 新建、重命名、删除队列 / 词典
- 队列推入、弹出、清空、按值删除、统计
- 词典写入、复制、移动、自增、删除、读取全部
- 整库备份 / 恢复

脚本或计划任务需要读取这里的状态时，也可以通过 `LCC.kvdb` 直接使用这些数据。

## TableDB​

TableDB 适合保存结构化表格数据，例如账号列表、任务结果、设备业务数据等。

当前 TableDB 管理界面支持：

- 创建新表
- 编辑表结构
- 新增、修改、删除行
- 清空表、删除表
- 按列排序、搜索、分页查看
- 按列统计
- 单表导入 / 导出 `JSON`、`CSV`、`XLSX`
- 整库备份 / 恢复

脚本或计划任务需要读写这里的表格数据时，也可以通过 `LCC.db` 直接操作。

## 什么时候用哪一个​

- 需要简单状态、计数器、消息队列 → 用 `KVDB`
- 需要表格结构、批量导入导出、筛选排序 → 用 `TableDB`
- 如果流程既涉及脚本又涉及计划任务，可以按数据形态来选：状态和队列更适合 `KVDB`，表格类业务数据更适合 `TableDB`