AI 与知识库

本页由 docs:sync 从数据库结构生成，请勿手工编辑。

ai_conversations

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
user_id	bigint unsigned	否	—	—
surface	varchar(20)	否	builder	会话所属界面：builder=建站助手 / cockpit=运营参谋
title	varchar(255)	是	—	—
status	varchar(20)	否	active	active / archived
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

ai_messages

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
conversation_id	bigint unsigned	否	—	—
role	varchar(20)	否	—	user / assistant / tool
content	text	是	—	—
tool_calls	json	是	—	本条助手消息发起的 tool 调用原文
blocks	json	是	—	该消息的完整内容块（Anthropic 消息格式），用于多轮对话重放
usage	json	是	—	本次模型调用的 token 用量
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

ai_operations

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
batch_id	bigint unsigned	否	—	—
action	varchar(60)	否	—	操作名，OperationRegistry 白名单内
target	json	是	—	—
params	json	是	—	—
target_ref	json	是	—	目标版本指纹 {model,id,updated_at}
before_snapshot	json	是	—	确认前结构化 diff
after_snapshot	json	是	—	执行后结构化 diff
reason	varchar(500)	是	—	AI 对本操作的说明
risk_level	varchar(5)	否	—	R0/R1/R2/R3
status	varchar(30)	否	pending	pending / awaiting_confirmation / executed / rejected / failed
error	json	是	—	失败时的错误码与详情
result	json	是	—	执行结果（查询类为返回数据摘要）
executed_at	timestamp	是	—	—
acted_by_admin_id	bigint unsigned	是	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

ai_operation_batches

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
user_id	bigint unsigned	否	—	—
conversation_id	bigint unsigned	是	—	—
protocol_version	varchar(10)	否	1.0	—
surface	varchar(20)	否	builder	调用面 builder|cockpit，服务端生成不可变
status	varchar(30)	否	pending	pending / awaiting_confirmation / executed / rejected / failed
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

ai_page_templates

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
source	json	否	—	AI 模板源码 {html,css,js}，上下文多一个当前实体对象(product/article/case/category)
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
channel_id	bigint unsigned	是	—	所属栏目（重键后页型按栏目挂载；每栏目 list/detail 各一份）
slot	varchar(10)	是	—	页型槽位：list=列表页 / detail=详情页

ai_settings

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
default_provider	varchar(20)	是	—	默认模型驱动：deepseek/anthropic
builder_providers	varchar(100)	是	—	建站助手模型链（逗号分隔按序降级，须支持 tool-use）
widget_providers	varchar(100)	是	—	客服挂件模型链（纯文本可用更便宜档位）
deepseek_api_key	text	是	—	加密
deepseek_model	varchar(60)	是	—	—
deepseek_base_url	varchar(200)	是	—	—
anthropic_api_key	text	是	—	加密
anthropic_model	varchar(60)	是	—	—
anthropic_base_url	varchar(200)	是	—	—
embedding_driver	varchar(20)	是	—	知识库向量化：none/dashscope
dashscope_api_key	text	是	—	加密
embedding_model	varchar(60)	是	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
qwen_api_key	text	是	—	加密（DashScope 兼容模式）
qwen_model	varchar(60)	是	—	—
qwen_base_url	varchar(200)	是	—	—
extra_drivers	json	是	—	OpenAI 兼容驱动注册表（增量驱动；api_key 逐项加密）
service_base_url	varchar(300)	是	—	AI 服务请求地址（空=乐兮网关默认 {gateway.url}/gateway/v1；可填第三方 OpenAI 兼容端点）
service_api_key	text	是	—	AI 服务密钥（加密存储；乐兮=sk-lexi-*，第三方=其自有密钥）
service_model	varchar(100)	是	—	模型名（空=default，乐兮网关按服务端路由；第三方须填真实模型名）
service_byo_confirmed_at	timestamp	是	—	第三方端点免责确认时间（BYO：内容审核与生成质量自担）
service_byo_confirmed_by	bigint unsigned	是	—	确认操作人 user id
thinking_features	json	是	—	按功能的思考开关，如 {"chat":true,"cockpit":false}；缺省按内置默认

ai_usage_records

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	是	—	—
user_id	bigint unsigned	是	—	—
feature	varchar(20)	否	—	用途：chat 建站助手 / widget 客服挂件 / builder 建站生成 / content 内容生成 / translate 翻译
model	varchar(80)	是	—	模型标识（计量口径审计用）
input_tokens	int unsigned	否	0	输入 token（含缓存命中）
output_tokens	int unsigned	否	0	输出 token（含思考）
created_at	timestamp	否	—	只追加流水，无更新

knowledge_documents

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
title	varchar(255)	否	—	展示名，默认取文件名
filename	varchar(255)	是	—	—
disk	varchar(20)	否	local	存储磁盘（私有，不对外暴露）
path	varchar(255)	是	—	—
mime_type	varchar(100)	是	—	—
size	bigint unsigned	否	—	文件大小（字节）
status	varchar(20)	否	pending	pending/processing/ready/failed
error	varchar(500)	是	—	解析失败原因
chunks_count	int unsigned	否	0	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
source_type	varchar(10)	否	file	来源：file 上传文件 / entry 在线条目
category	varchar(30)	是	—	资料分类（常见问答/报价指南等，自由文本）
visibility	varchar(20)	否	public	public=客服与建站助手都可引用 / internal=仅内部（建站助手/内容引擎）
content	text	是	—	在线条目正文（file 类型为空，正文在磁盘文件里）

knowledge_chunks

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
document_id	bigint unsigned	否	—	—
seq	int unsigned	否	—	切片在文档中的顺序
content	text	否	—	—
embedding	json	是	—	向量（预留；接入 Embedding 服务后填充，生产换 pgvector）
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

widget_sessions

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
visitor_token	varchar(64)	否	—	访客端生成的匿名标识（localStorage）
visitor_meta	json	是	—	UA、来源页等
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

widget_messages

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
session_id	bigint unsigned	否	—	—
role	varchar(20)	否	—	user / assistant
content	text	否	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—