主题开发
2 张表的结构与字段说明。
本页由
docs:sync从数据库结构生成，请勿手工编辑。
theme_dev_logs
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
id |
bigint unsigned | 否 | — | — |
site_id |
bigint unsigned | 否 | — | 站点 |
user_id |
bigint unsigned | 是 | — | 操作者（CLI 场景可空） |
operator |
varchar(200) | 否 | — | 操作者标识（邮箱快照，防账号删除后失联） |
action |
varchar(40) | 否 | — | 动作：sync/rollback/dev-mode-on/file-save/file-upload/file-rename/file-delete/file-restore |
detail |
varchar(500) | 否 | — | 目标/说明（文件路径、版本说明、指纹等） |
created_at |
timestamp | 否 | — | 发生时间 |
theme_diagnostics
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
id |
bigint unsigned | 否 | — | — |
tenant_id |
bigint unsigned | 否 | — | 租户（隔离红线） |
site_id |
bigint unsigned | 否 | — | 站点 |
kind |
varchar(24) | 否 | — | 来源：preview_build / front_render / dry_run / publish_build |
check_id |
varchar(40) | 否 | — | 检测/事件编号（前台展示给访客的编号，与本记录对账） |
context |
json | 否 | — | 结构化错误：stage/url/locale/device/file/line/line_kind/code/message/suggestion |
created_at |
timestamp | 是 | — | — |
updated_at |
timestamp | 是 | — | — |
fingerprint |
varchar(64) | 是 | — | 稳定故障指纹（site+kind+code+file+line+locale+device+模板版本）——相同故障合并计数；旧行为 null（不参与合并） |
occurrences |
int unsigned | 否 | 1 |
相同故障累计次数（CAS 原子累加） |
last_seen_at |
timestamp | 是 | — | 最近一次发生（60s 节流窗 CAS 判定列） |