外观
记录列表 ...common.data.PluginRecords
结构化列表(历史记录、收藏、名单……):一条记录一行 JSON,表结构 id / payload / sort_order / updated_at,排序 sort_order ASC, updated_at DESC。
kotlin
import com.hualuo.zhinian.box.common.data.PluginRecords
private const val T_HISTORY = "history"
// 读:按顺序返回每行的 JSON 字符串(解析失败的行自动跳过)
val rows: List<String> = PluginRecords.loadJson(context, DB, T_HISTORY)
PluginRecords.count(context, DB, T_HISTORY)
// 写:
PluginRecords.saveJson(context, DB, T_HISTORY, rows) // 全量替换(事务,行号当主键)
PluginRecords.upsertHead(context, DB, T_HISTORY, id, json, MAX) // 头插(同 id 覆盖)+ 截断,适合"最近使用"
PluginRecords.upsertTail(context, DB, T_HISTORY, id, json, MAX) // 尾插,适合"按时间追加"
// 管理:
PluginRecords.delete(context, DB, T_HISTORY, id) // 删一条
PluginRecords.clear(context, DB, T_HISTORY) // 清空表
PluginRecords.trim(context, DB, T_HISTORY, MAX) // 截断到 max 条