@allbluecn/database 0.8.0 → 0.9.0

package/schema.sqlite.prisma

@@ -18,39 +18,40 @@ datasource db {
 model SystemSetting {
   id        String   @id @default(cuid())
   key       String   @unique
-  value     String  
+  value     String
   category  String   @default("general") // 配置分类
-  desc      String?  // 说明
+  desc      String? // 说明
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
-  
+
   @@index([category])
   @@map("system_settings")
 }
 
 // 用户表
 model User {
-  id        String   @id @default(cuid())
-  email     String   @unique
-  username  String   @unique
-  password  String
-  role      String   @default("USER")
-  status    String     @default("ACTIVE")
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  id          String    @id @default(cuid())
+  email       String    @unique
+  username    String    @unique
+  password    String
+  role        String    @default("USER")
+  status      String    @default("ACTIVE")
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
   lastLoginAt DateTime?
 
   avatarConfig Json?
-  bgShape     String?
-  bgColor     String?
+  bgShape      String?
+  bgColor      String?
 
-  aiProvider  String?  // "openrouter" | "openai"
-  aiApiKey    String?  // 用户 AI API Key（TODO: 加密存储）
-  aiModel     String?  // 默认 "openai/gpt-4o-mini"
-  locale     String?  // 用户语言偏好（zh / en），null 表示未设置
+  aiProvider String? // "openrouter" | "openai"
+  aiApiKey   String? // 用户 AI API Key（TODO: 加密存储）
+  aiModel    String? // 默认 "openai/gpt-4o-mini"
+  aiSourceMode String? // 模型来源模式：hosted | local-agent | byok；null = 未选择（默认 byok 行为）
+  locale     String? // 用户语言偏好（zh / en），null 表示未设置
 
   sketchApiToken String?
-  timezone       String?  // 用户全局时区，如 "Asia/Shanghai"。null = 浏览器时区
+  timezone       String? // 用户全局时区，如 "Asia/Shanghai"。null = 浏览器时区
 
   /// 用户偏好的计费币种（子项目 3 新增）
   preferredCurrency String @default("usd")
@@ -58,78 +59,83 @@ model User {
   /// 用户默认 workspace ID（B3 精确化）
   defaultWorkspaceId String?
 
-  invitationUses InvitationUse[]
-  loginLogs     LoginLog[]
-  passwordResetTokens PasswordResetToken[]
-  emailVerificationTokens EmailVerificationToken[]
-  emailPreference EmailPreference?
-  notificationPreference NotificationPreference?
-  prds          PRD[]
-  tags          Tag[]
-  knowledgeBases KnowledgeBase[]
-  knowledgeDocuments KnowledgeDocument[]
-  knowledgeShares        KnowledgeShareRecord[]
-  legalRegulations       LegalRegulation[]
-  industryCompliances    IndustryCompliance[]
-  dictionaryTerms        DictionaryTerm[]
-  websiteBookmarks       WebsiteBookmark[]
-  bookmarkCategories     BookmarkCategory[]
-  articleFavorites       ArticleFavorite[]
-  anyhubApps                      AnyHubApp[]
-  anyhubMarketApps                AnyHubMarketApp[]
-  reviewedAnyhubRecommendations   AnyHubRecommendation[] @relation("reviewedAnyhubRecommendations")
-  anyhubRecommenders              AnyHubRecommender[]
-  prdVersions         PRDVersion[]
-  reviewComments      ReviewComment[]
-  comments            Comment[]
-  commentIgnores      CommentIgnore[]
-  reviews             Review[]        @relation("reviewer")
-  designProjects      DesignProject[]
-  chatThreads       ChatThread[]
-  aiProviderConfigs   AiProviderConfig[]
-  agentConversations  AgentConversation[]
-  ownedProjects       Project[]        @relation("projectOwner")
-   projectMemberships  ProjectMember[]
-   iterationsCreated   Iteration[]           @relation("iterationCreator")
-   storiesCreated      Story[]                @relation("storyCreator")
-   storiesAssigned     Story[]                @relation("storyAssignee")
-   storiesEdited       Story[]                @relation("storyEditor")
-   projectActivities   ProjectActivity[]
-  ownedWorkspaces     Workspace[]        @relation("workspaceOwner")
-  workspaceMemberships TeamMembership[]   @relation("teamOwner")
-  teamJoined           TeamMembership?    @relation("teamMember")
-  sentInvitations      TeamInvitation[]   @relation("invitationOwner")
-  ownedJoinRequests    TeamJoinRequest[]  @relation("joinRequestOwner")
-  applicantJoinRequests TeamJoinRequest[] @relation("joinRequestApplicant")
-  aiUsageLogs          AiUsageLog[]
-  agents               UserAgent[]
-  skills               UserSkill[]
-  subscription         Subscription?
-  createdQuickDocs     WorkspaceQuickDoc[]
+  invitationUses                InvitationUse[]
+  loginLogs                     LoginLog[]
+  passwordResetTokens           PasswordResetToken[]
+  emailVerificationTokens       EmailVerificationToken[]
+  emailPreference               EmailPreference?
+  notificationPreference        NotificationPreference?
+  prds                          PRD[]
+  tags                          Tag[]
+  knowledgeBases                KnowledgeBase[]
+  knowledgeDocuments            KnowledgeDocument[]
+  knowledgeShares               KnowledgeShareRecord[]
+  legalRegulations              LegalRegulation[]
+  industryCompliances           IndustryCompliance[]
+  dictionaryTerms               DictionaryTerm[]
+  websiteBookmarks              WebsiteBookmark[]
+  bookmarkCategories            BookmarkCategory[]
+  articleFavorites              ArticleFavorite[]
+  anyhubApps                    AnyHubApp[]
+  anyhubMarketApps              AnyHubMarketApp[]
+  reviewedAnyhubRecommendations AnyHubRecommendation[]   @relation("reviewedAnyhubRecommendations")
+  anyhubRecommenders            AnyHubRecommender[]
+  prdVersions                   PRDVersion[]
+  reviewComments                ReviewComment[]
+  comments                      Comment[]
+  commentIgnores                CommentIgnore[]
+  reviews                       Review[]                 @relation("reviewer")
+  designProjects                DesignProject[]
+  chatThreads                   ChatThread[]
+  aiProviderConfigs             AiProviderConfig[]
+  agentConversations            AgentConversation[]
+  ownedProjects                 Project[]                @relation("projectOwner")
+  projectMemberships            ProjectMember[]
+  iterationsCreated             Iteration[]              @relation("iterationCreator")
+  storiesCreated                Story[]                  @relation("storyCreator")
+  storiesAssigned               Story[]                  @relation("storyAssignee")
+  storiesEdited                 Story[]                  @relation("storyEditor")
+  projectActivities             ProjectActivity[]
+  ownedWorkspaces               Workspace[]              @relation("workspaceOwner")
+  workspaceMemberships          TeamMembership[]         @relation("teamOwner")
+  teamJoined                    TeamMembership?          @relation("teamMember")
+  sentInvitations               TeamInvitation[]         @relation("invitationOwner")
+  ownedJoinRequests             TeamJoinRequest[]        @relation("joinRequestOwner")
+  applicantJoinRequests         TeamJoinRequest[]        @relation("joinRequestApplicant")
+  aiUsageLogs                   AiUsageLog[]
+  agents                        UserAgent[]
+  skills                        UserSkill[]
+  subscription                  Subscription?
+  createdQuickDocs              WorkspaceQuickDoc[]
+  plugins                       HarnessPlugin[]
+  harnessWorkspaces             HarnessWorkspace[]
+  agentBindings                 BusinessAgentBinding[]
+  codeSnippets                  CodeSnippet[]
+  blobs                         Blob[]
 
   @@map("users")
 }
 
 // 项目
 model Project {
-  id          String   @id @default(cuid())
-  displayId   String?  // 用户层项目ID，全大写字母数字，1-10位
-  name        String
-  description String?
-  icon        String   @default("folder")
-  timezone    String?  // 项目时区，null = 跟随用户全局时区
-  ownerId     String
-  owner       User     @relation("projectOwner", fields: [ownerId], references: [id])
-  workspaceId String?
-  workspace   Workspace? @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
-   members     ProjectMember[]
-   activities  ProjectActivity[]
-    knowledgeBases ProjectKnowledgeBase[]
-     iterations      Iteration[]
-     iterationAutoSchedule IterationAutoSchedule?
-     stories         Story[]
-    createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  id                    String                 @id @default(cuid())
+  displayId             String? // 用户层项目ID，全大写字母数字，1-10位
+  name                  String
+  description           String?
+  icon                  String                 @default("folder")
+  timezone              String? // 项目时区，null = 跟随用户全局时区
+  ownerId               String
+  owner                 User                   @relation("projectOwner", fields: [ownerId], references: [id])
+  workspaceId           String?
+  workspace             Workspace?             @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
+  members               ProjectMember[]
+  activities            ProjectActivity[]
+  knowledgeBases        ProjectKnowledgeBase[]
+  iterations            Iteration[]
+  iterationAutoSchedule IterationAutoSchedule?
+  stories               Story[]
+  createdAt             DateTime               @default(now())
+  updatedAt             DateTime               @updatedAt
 
   @@unique([ownerId, displayId])
   @@index([ownerId])
@@ -155,20 +161,20 @@ model ProjectMember {
 
 // 工作空间（项目的上一级容器）
 model Workspace {
-  id          String   @id @default(cuid())
-  name        String
-  icon        String   @default("folder")
-  description String?
-  pinnedToSidebar Boolean @default(false)
-  ownerId     String
-  owner       User     @relation("workspaceOwner", fields: [ownerId], references: [id])
-  projects             Project[]
-  workspaceKbLinks     WorkspaceKnowledgeBase[]
-  quickDocs            WorkspaceQuickDoc[]
-  usageRecords         UsageRecord[]
-  aiUsageLogs          AiUsageLog[]
-  createdAt            DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  id               String                   @id @default(cuid())
+  name             String
+  icon             String                   @default("folder")
+  description      String?
+  pinnedToSidebar  Boolean                  @default(false)
+  ownerId          String
+  owner            User                     @relation("workspaceOwner", fields: [ownerId], references: [id])
+  projects         Project[]
+  workspaceKbLinks WorkspaceKnowledgeBase[]
+  quickDocs        WorkspaceQuickDoc[]
+  usageRecords     UsageRecord[]
+  aiUsageLogs      AiUsageLog[]
+  createdAt        DateTime                 @default(now())
+  updatedAt        DateTime                 @updatedAt
 
   @@index([ownerId])
   @@map("workspaces")
@@ -176,13 +182,14 @@ model Workspace {
 
 // 团队隶属关系
 model TeamMembership {
-  id        String   @id @default(cuid())
-  ownerId   String
-  owner     User     @relation("teamOwner", fields: [ownerId], references: [id], onDelete: Cascade)
-  memberId  String
-  member    User     @relation("teamMember", fields: [memberId], references: [id], onDelete: Cascade)
-  seatType  String   @default("member")
-  joinedAt  DateTime @default(now())
+  id       String   @id @default(cuid())
+  ownerId  String
+  owner    User     @relation("teamOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  memberId String
+  member   User     @relation("teamMember", fields: [memberId], references: [id], onDelete: Cascade)
+  seatType String   @default("member")
+  joinedAt DateTime @default(now())
+
   @@unique([memberId])
   @@index([ownerId])
   @@map("team_memberships")
@@ -190,20 +197,21 @@ model TeamMembership {
 
 // 团队邀请
 model TeamInvitation {
-  id             String    @id @default(cuid())
+  id             String            @id @default(cuid())
   ownerId        String
-  owner          User      @relation("invitationOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  owner          User              @relation("invitationOwner", fields: [ownerId], references: [id], onDelete: Cascade)
   email          String?
-  seatType       String    @default("member")
-  token          String    @unique
-  channel        String    @default("email")
-  status         String    @default("pending")
+  seatType       String            @default("member")
+  token          String            @unique
+  channel        String            @default("email")
+  status         String            @default("pending")
   expiresAt      DateTime
-  createdAt      DateTime  @default(now())
+  createdAt      DateTime          @default(now())
   acceptedBy     String?
   applicantEmail String?
   message        String?
   joinRequests   TeamJoinRequest[]
+
   @@unique([ownerId, email])
   @@index([ownerId])
   @@index([email])
@@ -223,6 +231,7 @@ model TeamJoinRequest {
   seatType     String         @default("member")
   createdAt    DateTime       @default(now())
   processedAt  DateTime?
+
   @@unique([invitationId, email])
   @@index([ownerId, status])
   @@map("team_join_requests")
@@ -235,8 +244,8 @@ model ProjectActivity {
   project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
   userId     String
   user       User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  action     String   // created | updated | deleted | member_invited | member_joined | member_removed | role_changed | module_viewed
-  targetType String?  // project | member | requirement | prd | design | testcase | bug | acceptance
+  action     String // created | updated | deleted | member_invited | member_joined | member_removed | role_changed | module_viewed
+  targetType String? // project | member | requirement | prd | design | testcase | bug | acceptance
   targetId   String?
   metadata   Json?
   createdAt  DateTime @default(now())
@@ -246,20 +255,23 @@ model ProjectActivity {
 }
 
 model ChatThread {
-  id         String   @id @default(cuid())
-  userId     String
-  title      String?
-  isArchived Boolean  @default(false)
-  createdAt  DateTime @default(now())
-  updatedAt  DateTime @updatedAt
+  id            String   @id @default(cuid())
+  userId        String
+  title         String?
+  isArchived    Boolean  @default(false)
+  sandboxPolicy String   @default("readonly")
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
 
-  user        User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user        User            @relation(fields: [userId], references: [id], onDelete: Cascade)
   messages    ChatMessage[]
   runs        ChatRun[]
   interrupts  ChatInterrupt[]
   generations GenerationRun[]
   agentId     String?
-  agent       UserAgent? @relation(fields: [agentId], references: [id])
+  agent       UserAgent?      @relation(fields: [agentId], references: [id])
+  workspaceId String?
+  workspace   HarnessWorkspace? @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
 
   @@index([userId, updatedAt])
   @@map("chat_threads")
@@ -269,10 +281,11 @@ model ChatMessage {
   id         String   @id @default(cuid())
   threadId   String
   role       String
-  content    String
+  content    Json?
   parts      Json?
   thinking   String?
   citations  Json?
+  toolCallId String?
   createdAt  DateTime @default(now())
 
   thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
@@ -282,15 +295,18 @@ model ChatMessage {
 }
 
 model ChatRun {
-  id            String   @id @default(cuid())
-  threadId      String
-  userId        String
-  status        String
-  startedAt     DateTime @default(now())
-  finishedAt    DateTime?
-  detachedSince DateTime?
-  usage         Json?
-  error         String?
+  id              String    @id @default(cuid())
+  threadId        String
+  userId          String
+  status          String
+  startedAt       DateTime  @default(now())
+  finishedAt      DateTime?
+  detachedSince   DateTime?
+  usage           Json?
+  error           String?
+  sandboxKey      String?
+  cancelRequested Boolean?
+  driverEpoch     Int?
 
   thread     ChatThread      @relation(fields: [threadId], references: [id], onDelete: Cascade)
   interrupts ChatInterrupt[]
@@ -301,19 +317,20 @@ model ChatRun {
 }
 
 model ChatInterrupt {
-  id         String   @id @default(cuid())
-  runId      String
-  threadId   String
-  userId     String
-  kind       String
-  toolName   String?
-  state      String
-  payload    Json?
-  resolution Json?
-  createdAt  DateTime @default(now())
-  resolvedAt DateTime?
+  id          String    @id @default(cuid())
+  runId       String
+  threadId    String
+  userId      String
+  kind        String
+  toolName    String?
+  state       String
+  payload     Json?
+  resolution  Json?
+  requestedAt DateTime  @default(now())
+  createdAt   DateTime  @default(now())
+  resolvedAt  DateTime?
 
-  run ChatRun @relation(fields: [runId], references: [id], onDelete: Cascade)
+  run    ChatRun    @relation(fields: [runId], references: [id], onDelete: Cascade)
   thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
 
   @@index([runId])
@@ -321,8 +338,100 @@ model ChatInterrupt {
   @@map("chat_interrupts")
 }
 
-model GenerationRun {
+model ChatPersistenceMeta {
+  namespace String
+  key       String
+  value     Json
+  updatedAt DateTime @updatedAt
+
+  @@unique([namespace, key])
+  @@map("chat_persistence_meta")
+}
+
+// dsh（DeepSeek-Harness）兼容插件（设计 v8 ADR 21：插件定义 DB 持久化，运行态随页面）
+model HarnessPlugin {
   id         String   @id @default(cuid())
+  userId     String
+  name       String
+  purpose    String
+  codeHost   String?
+  codeClient String?
+  // plugin_define 求值后插件经 harness.defineTool 上报的工具定义（JSON Schema 数组）
+  tools      Json     @default(dbgenerated("'[]'"))
+  version    Int      @default(1)
+  // defined | running | stopped | error
+  status     String   @default("defined")
+  lastError  String?
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+  isDeleted  Boolean  @default(false)
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, name])
+  @@index([userId])
+  @@map("harness_plugins")
+}
+
+// P2 提示词平台：系统提示词模板（DB 版本化，服务端唯一来源）
+model SystemPromptTemplate {
+  id          String                @id @default(cuid())
+  key         String                @unique
+  name        String
+  description String?
+  sections    Json                  @default(dbgenerated("'[]'"))
+  variables   Json                  @default(dbgenerated("'[]'"))
+  version     Int                   @default(1)
+  isActive    Boolean               @default(true)
+  isProtected Boolean               @default(false)
+  updatedBy   String?
+  createdAt   DateTime              @default(now())
+  updatedAt   DateTime              @updatedAt
+  versions    SystemPromptVersion[]
+
+  @@map("system_prompt_templates")
+}
+
+// P2 提示词平台：系统提示词模板的历史版本快照。
+// 设计取舍：仅快照 sections（真正发给 LLM 的提示词主体）；variables 作为
+// 元数据随模板演进不纳入版本管理——回滚只还原提示词文本，变量声明由模板表当前值兜底。
+model SystemPromptVersion {
+  id         String               @id @default(cuid())
+  templateId String
+  template   SystemPromptTemplate @relation(fields: [templateId], references: [id], onDelete: Cascade)
+  version    Int
+  sections   Json
+  note       String?
+  createdBy  String?
+  createdAt  DateTime             @default(now())
+
+  @@unique([templateId, version])
+  @@map("system_prompt_versions")
+}
+
+// P2 异构多智能体：板块 agent 绑定（三级链第①级：板块绑定 > 用户默认 > 系统默认）。
+// 设计取舍：① 硬删（无独立业务生命周期，upsert/deleteMany 管理）而非 isDeleted 软删；
+// ② workspaceId 为跨工作区绑定的预留字段，当前不建 relation——bizKey 已表达业务作用域，
+//    工作区级绑定待 P3 启用时再补 relation + 索引。
+model BusinessAgentBinding {
+  id          String   @id @default(cuid())
+  userId      String
+  bizKey      String
+  agentId     String
+  workspaceId String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  agent UserAgent @relation(fields: [agentId], references: [id], onDelete: Cascade)
+  user  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, bizKey])
+  @@index([userId])
+  @@map("business_agent_bindings")
+}
+
+model GenerationRun {
+  id         String    @id @default(cuid())
   threadId   String
   userId     String
   kind       String
@@ -330,9 +439,15 @@ model GenerationRun {
   input      Json?
   result     Json?
   artifactId String?
+  activity   String?
+  provider   String?
+  model      String?
+  artifacts  Json?
+  usage      Json?
   error      String?
-  startedAt  DateTime @default(now())
+  startedAt  DateTime  @default(now())
   finishedAt DateTime?
+  linkedTarget Json?
 
   thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
 
@@ -347,55 +462,55 @@ model LoginLog {
   userId    String
   ip        String?
   userAgent String?
-  location  String?  // 地理位置，如 "北京, 中国"；开发环境为 "本地"
+  location  String? // 地理位置，如 "北京, 中国"；开发环境为 "本地"
   success   Boolean  @default(true)
-  message   String?  // 失败原因（中文），成功时为 null
+  message   String? // 失败原因（中文），成功时为 null
   createdAt DateTime @default(now())
-  
-  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
   @@map("login_logs")
 }
 
 // 邀请码
 model InvitationCode {
-  id        String    @id @default(cuid())
-  code     String    @unique
-  maxUses  Int       @default(1)
-  usedCount Int      @default(0)
-  expiresAt DateTime
-  createdAt DateTime  @default(now())
+  id          String    @id @default(cuid())
+  code        String    @unique
+  maxUses     Int       @default(1)
+  usedCount   Int       @default(0)
+  expiresAt   DateTime
+  createdAt   DateTime  @default(now())
   createdById String?
-  disabledAt DateTime?
+  disabledAt  DateTime?
 
-  uses     InvitationUse[]
+  uses InvitationUse[]
 
   @@map("invitation_codes")
 }
 
 // 邀请码使用记录
 model InvitationUse {
-  id        String   @id @default(cuid())
-  codeId    String
-  userId    String
-  usedAt    DateTime @default(now())
-  
-  code     InvitationCode @relation(fields: [codeId], references: [id], onDelete: Cascade)
-  user     User          @relation(fields: [userId], references: [id], onDelete: Cascade)
-  
+  id     String   @id @default(cuid())
+  codeId String
+  userId String
+  usedAt DateTime @default(now())
+
+  code InvitationCode @relation(fields: [codeId], references: [id], onDelete: Cascade)
+  user User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+
   @@map("invitation_uses")
 }
 
 // 密码重置令牌
 model PasswordResetToken {
-  id        String   @id @default(cuid())
-  token     String   @unique
+  id        String    @id @default(cuid())
+  token     String    @unique
   userId    String
   expiresAt DateTime
-  usedAt   DateTime?
-  createdAt DateTime @default(now())
+  usedAt    DateTime?
+  createdAt DateTime  @default(now())
 
-  user     User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
 
   @@map("password_reset_tokens")
 }
@@ -408,7 +523,8 @@ model EmailVerificationToken {
   expiresAt DateTime
   usedAt    DateTime?
   createdAt DateTime  @default(now())
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
   @@map("email_verification_tokens")
 }
 
@@ -426,6 +542,7 @@ model EmailLog {
   userId      String?
   createdAt   DateTime  @default(now())
   sentAt      DateTime?
+
   @@index([to, createdAt])
   @@index([userId, createdAt])
   @@index([status])
@@ -438,7 +555,8 @@ model EmailPreference {
   unsubscribedAll        Boolean @default(false)
   unsubscribedCategories Json    @default(dbgenerated("'[]'"))
   suppressed             Boolean @default(false)
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user                   User    @relation(fields: [userId], references: [id], onDelete: Cascade)
+
   @@map("email_preferences")
 }
 
@@ -447,7 +565,7 @@ model OAuthProviderConfig {
   id           String   @id @default(cuid())
   provider     String   @unique
   clientId     String
-  clientSecret String   // AES-256-GCM 密文
+  clientSecret String // AES-256-GCM 密文
   enabled      Boolean  @default(false)
   extra        Json?
   createdAt    DateTime @default(now())
@@ -475,25 +593,25 @@ model EmailSubscriber {
 
 // 知识库
 model KnowledgeBase {
-  id               String   @id @default(cuid())
-  name             String
-  description      String?
-  icon             String   @default("notebook")
-  tags             Json     @default(dbgenerated("'[]'"))
-  visibility       String   @default("private")
-  userId           String
-  pinnedToSidebar  Boolean  @default(false)
-  isDeleted        Boolean  @default(false)
-  createdAt        DateTime @default(now())
-  updatedAt        DateTime @updatedAt
+  id              String   @id @default(cuid())
+  name            String
+  description     String?
+  icon            String   @default("notebook")
+  tags            Json     @default(dbgenerated("'[]'"))
+  visibility      String   @default("private")
+  userId          String
+  pinnedToSidebar Boolean  @default(false)
+  isDeleted       Boolean  @default(false)
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
 
-   user        User                @relation(fields: [userId], references: [id], onDelete: Cascade)
-    documents  KnowledgeDocument[]
-     projectLinks ProjectKnowledgeBase[]
-    workspaceLinks WorkspaceKnowledgeBase[]
+  user           User                     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  documents      KnowledgeDocument[]
+  projectLinks   ProjectKnowledgeBase[]
+  workspaceLinks WorkspaceKnowledgeBase[]
 
-     @@index([userId])
-    @@map("knowledge_bases")
+  @@index([userId])
+  @@map("knowledge_bases")
 }
 
 // 项目关联知识库（join 表；关联时仅允许 visibility=team，general 全局可见无需关联，private 跨用户不可读）
@@ -570,10 +688,10 @@ model KnowledgeDocument {
   createdAt  DateTime @default(now())
   updatedAt  DateTime @updatedAt
 
-  kb         KnowledgeBase       @relation(fields: [kbId], references: [id], onDelete: Cascade)
-  parent     KnowledgeDocument?  @relation("DocumentTree", fields: [parentId], references: [id], onDelete: SetNull)
-  children   KnowledgeDocument[] @relation("DocumentTree")
-  creator    User                @relation(fields: [createdBy], references: [id], onDelete: Cascade)
+  kb                 KnowledgeBase       @relation(fields: [kbId], references: [id], onDelete: Cascade)
+  parent             KnowledgeDocument?  @relation("DocumentTree", fields: [parentId], references: [id], onDelete: SetNull)
+  children           KnowledgeDocument[] @relation("DocumentTree")
+  creator            User                @relation(fields: [createdBy], references: [id], onDelete: Cascade)
   workspaceQuickDocs WorkspaceQuickDoc[]
 
   @@index([kbId])
@@ -584,24 +702,24 @@ model KnowledgeDocument {
 
 // PRD 文档表
 model PRD {
-  id          String   @id @default(cuid())
-  icon        String   @default("file") // 图标名称
-  name        String   // PRD 名称
-  description String?  // 介绍
-  settings    Json?              // 文档设置（布局、主题等）
-  userId      String   // 所属用户
+  id          String    @id @default(cuid())
+  icon        String    @default("file") // 图标名称
+  name        String // PRD 名称
+  description String? // 介绍
+  settings    Json? // 文档设置（布局、主题等）
+  userId      String // 所属用户
   isDeleted   Boolean   @default(false)
   deletedAt   DateTime?
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
 
-  user        User        @relation(fields: [userId], references: [id], onDelete: Cascade)
-  pages       PRDPage[]
-  versions    PRDVersion[]
-  reviews     Review[]
-  comments    Comment[]
-  shares      Share[]
-  prdTags     PRDTag[]
+  user               User                @relation(fields: [userId], references: [id], onDelete: Cascade)
+  pages              PRDPage[]
+  versions           PRDVersion[]
+  reviews            Review[]
+  comments           Comment[]
+  shares             Share[]
+  prdTags            PRDTag[]
   agentConversations AgentConversation[]
 
   @@index([userId])
@@ -617,8 +735,8 @@ model AgentConversation {
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  user     User            @relation(fields: [userId], references: [id], onDelete: Cascade)
-  prd      PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  user     User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  prd      PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
   messages AgentMessage[]
 
   @@index([userId, prdId])
@@ -629,9 +747,9 @@ model AgentConversation {
 model AgentMessage {
   id             String   @id @default(cuid())
   conversationId String
-  role           String   // "user" | "assistant"
-  content        String   // 消息文本
-  components     Json?    // AI 生成的组件数据（assistant 消息）
+  role           String // "user" | "assistant"
+  content        String // 消息文本
+  components     Json? // AI 生成的组件数据（assistant 消息）
   isError        Boolean  @default(false)
   createdAt      DateTime @default(now())
 
@@ -643,33 +761,33 @@ model AgentMessage {
 
 // 基础组件表（后台维护）
 model Component {
-  id           String   @id @default(cuid())
-  name         String
-  description  String?  // 组件描述
-  type         String   // "component" | "block" | "template"
-  category     String?  // 分类
-  subCategory  String?  // 子分类
-  path         String?  // 树形分组路径（如 "基础组件/表单/输入框"）
+  id            String   @id @default(cuid())
+  name          String
+  description   String? // 组件描述
+  type          String // "component" | "block" | "template"
+  category      String? // 分类
+  subCategory   String? // 子分类
+  path          String? // 树形分组路径（如 "基础组件/表单/输入框"）
   defaultWidth  Int      @default(200)
   defaultHeight Int      @default(40)
-  prototypeKey  String?  // unique key for registry lookup (e.g. "text", "button")
-  config       Json                   // 属性描述 schema（props定义、slots、events）
-  defaultProps Json?                  // 默认属性值
-  defaultStyle Json?                  // 默认样式
-  preview      String?  // 预览图URL
-  version      Int      @default(1)
-  sortOrder    Int      @default(0)  // 排序权重（越大越前）
-  source       String   @default("manual") // "npm" | "file" | "manual"
-  sourceId     String?  // npm 包名 / 文件名
-  isHidden     Boolean  @default(false) // 隐藏/显示
-  isDeleted    Boolean  @default(false)
-  createdAt    DateTime @default(now())
-  updatedAt    DateTime @updatedAt
+  prototypeKey  String? // unique key for registry lookup (e.g. "text", "button")
+  config        Json // 属性描述 schema（props定义、slots、events）
+  defaultProps  Json? // 默认属性值
+  defaultStyle  Json? // 默认样式
+  preview       String? // 预览图URL
+  version       Int      @default(1)
+  sortOrder     Int      @default(0) // 排序权重（越大越前）
+  source        String   @default("manual") // "npm" | "file" | "manual"
+  sourceId      String? // npm 包名 / 文件名
+  isHidden      Boolean  @default(false) // 隐藏/显示
+  isDeleted     Boolean  @default(false)
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
 
-  blockItems      BlockComponent[]    @relation("componentRef")
-  instances       ComponentInstance[] @relation("componentRef")
-  componentTags   ComponentTag[]
-  tags            Json            @default(dbgenerated("'[]'"))
+  blockItems    BlockComponent[]    @relation("componentRef")
+  instances     ComponentInstance[] @relation("componentRef")
+  componentTags ComponentTag[]
+  tags          Json                @default(dbgenerated("'[]'"))
 
   @@index([type, category])
   @@index([isDeleted])
@@ -688,8 +806,8 @@ model Block {
   createdAt   DateTime @default(now())
   updatedAt   DateTime @updatedAt
 
-  items        BlockComponent[]
-  instances    BlockInstance[]   @relation("blockRef")
+  items         BlockComponent[]
+  instances     BlockInstance[]  @relation("blockRef")
   templateItems TemplateBlock[]  @relation("templateBlockRef")
 
   @@index([isDeleted])
@@ -698,16 +816,16 @@ model Block {
 
 // 区块内组件布局
 model BlockComponent {
-  id            String  @id @default(cuid())
+  id            String @id @default(cuid())
   blockId       String
   componentId   String
-  x             Float   @default(0)
-  y             Float   @default(0)
-  width         Float   @default(100)
-  height        Float   @default(100)
-  zIndex        Int     @default(0)
-  propsOverride Json?             // 局部覆写属性
-  styleOverride Json?             // 局部覆写样式
+  x             Float  @default(0)
+  y             Float  @default(0)
+  width         Float  @default(100)
+  height        Float  @default(100)
+  zIndex        Int    @default(0)
+  propsOverride Json? // 局部覆写属性
+  styleOverride Json? // 局部覆写样式
 
   block     Block     @relation(fields: [blockId], references: [id], onDelete: Cascade)
   component Component @relation("componentRef", fields: [componentId], references: [id])
@@ -733,12 +851,12 @@ model Template {
 
 // 模板内区块排布
 model TemplateBlock {
-  id         String  @id @default(cuid())
+  id         String @id @default(cuid())
   templateId String
   blockId    String
-  order      Int     @default(0)  // 排布顺序
-  x          Float?  @default(0)
-  y          Float?  @default(0)
+  order      Int    @default(0) // 排布顺序
+  x          Float? @default(0)
+  y          Float? @default(0)
   width      Float?
   height     Float?
 
@@ -752,22 +870,22 @@ model TemplateBlock {
 model PRDPage {
   id        String   @id @default(cuid())
   prdId     String
-  parentId  String?  // 父节点，构建树形结构（null = 根级）
+  parentId  String? // 父节点，构建树形结构（null = 根级）
   name      String
-  order     Int      @default(0)  // 排序
+  order     Int      @default(0) // 排序
   type      String   @default("page") // "page" | "folder"
-  canvas    Json?              // 原型画板数据
-  content   Json?              // PRD 文档内容
+  canvas    Json? // 原型画板数据
+  content   Json? // PRD 文档内容
   version   Int      @default(1) // 页面版本号
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  prd          PRD                 @relation(fields: [prdId], references: [id], onDelete: Cascade)
-  parent       PRDPage?            @relation("PageHierarchy", fields: [parentId], references: [id], onDelete: Cascade)
-  children     PRDPage[]           @relation("PageHierarchy")
+  prd                PRD                 @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  parent             PRDPage?            @relation("PageHierarchy", fields: [parentId], references: [id], onDelete: Cascade)
+  children           PRDPage[]           @relation("PageHierarchy")
   componentInstances ComponentInstance[]
   blockInstances     BlockInstance[]
-  pageVersions      PageVersion[]
+  pageVersions       PageVersion[]
 
   @@index([prdId, order])
   @@map("prd_pages")
@@ -775,24 +893,24 @@ model PRDPage {
 
 // 组件实例（画布上）
 model ComponentInstance {
-  id            String  @id @default(cuid())
-  pageId        String
-  componentId   String? // null = 已解绑的游离副本
+  id              String   @id @default(cuid())
+  pageId          String
+  componentId     String? // null = 已解绑的游离副本
   blockInstanceId String? // 所属区块实例
-  name          String? // 实例别名
-  x             Float   @default(0)
-  y             Float   @default(0)
-  width         Float   @default(100)
-  height        Float   @default(100)
-  zIndex        Int     @default(0)
-  props         Json?             // 局部覆写属性
-  style         Json?             // 局部覆写样式
-  createdAt     DateTime @default(now())
-  updatedAt     DateTime @updatedAt
+  name            String? // 实例别名
+  x               Float    @default(0)
+  y               Float    @default(0)
+  width           Float    @default(100)
+  height          Float    @default(100)
+  zIndex          Int      @default(0)
+  props           Json? // 局部覆写属性
+  style           Json? // 局部覆写样式
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
 
-  page         PRDPage          @relation(fields: [pageId], references: [id], onDelete: Cascade)
-  component    Component?       @relation("componentRef", fields: [componentId], references: [id])
-  blockInstance BlockInstance?  @relation(fields: [blockInstanceId], references: [id])
+  page          PRDPage        @relation(fields: [pageId], references: [id], onDelete: Cascade)
+  component     Component?     @relation("componentRef", fields: [componentId], references: [id])
+  blockInstance BlockInstance? @relation(fields: [blockInstanceId], references: [id])
 
   @@index([pageId])
   @@map("component_instances")
@@ -800,17 +918,17 @@ model ComponentInstance {
 
 // 区块实例（画布上）
 model BlockInstance {
-  id      String  @id @default(cuid())
-  pageId  String
-  blockId String? // null = 已解绑的游离副本
-  name    String? // 实例别名
-  x       Float   @default(0)
-  y       Float   @default(0)
-  width   Float   @default(400)
-  height  Float   @default(300)
-  zIndex  Int     @default(0)
-  props   Json?             // 局部覆写属性
-  style   Json?             // 局部覆写样式
+  id        String   @id @default(cuid())
+  pageId    String
+  blockId   String? // null = 已解绑的游离副本
+  name      String? // 实例别名
+  x         Float    @default(0)
+  y         Float    @default(0)
+  width     Float    @default(400)
+  height    Float    @default(300)
+  zIndex    Int      @default(0)
+  props     Json? // 局部覆写属性
+  style     Json? // 局部覆写样式
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
@@ -824,42 +942,42 @@ model BlockInstance {
 
 // PRD 版本（手动发布创建）
 model PRDVersion {
-  id            String   @id @default(cuid())
+  id            String    @id @default(cuid())
   prdId         String
-  major         Int      @default(1)
-  minor         Int      @default(0)
-  patch         Int      @default(0)
-  versionLabel  String   // 如 "v1", "v1.1", "v1.1.1"
-  parentVersion String?  // 上一版本ID（版本链）
-  pageVersions  Json                 // [{ pageId, pageName, version, canvas, content }]
-  notes         String?  // 发版说明
+  major         Int       @default(1)
+  minor         Int       @default(0)
+  patch         Int       @default(0)
+  versionLabel  String // 如 "v1", "v1.1", "v1.1.1"
+  parentVersion String? // 上一版本ID（版本链）
+  pageVersions  Json // [{ pageId, pageName, version, canvas, content }]
+  notes         String? // 发版说明
   userId        String
-  createdAt     DateTime @default(now())
+  createdAt     DateTime  @default(now())
   updatedAt     DateTime?
 
-  prd      PRD      @relation(fields: [prdId], references: [id], onDelete: Cascade)
-  user     User     @relation(fields: [userId], references: [id])
-  reviews  Review[]
+  prd           PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  user          User           @relation(fields: [userId], references: [id])
+  reviews       Review[]
   shareVersions ShareVersion[]
 
-   @@index([prdId, createdAt])
-   @@index([userId])
-   @@map("prd_versions")
- }
+  @@index([prdId, createdAt])
+  @@index([userId])
+  @@map("prd_versions")
+}
 
 // 页面版本（独立的页面级别版本历史）
 model PageVersion {
-  id              String   @id @default(cuid())
-  pageId          String
-  version         Int      // 整数版本号，自增
-  notes           String?  // 版本说明（用户可编辑）
-  canvas          Json?              // 原型快照
-  content         Json?              // 文档快照
+  id                  String   @id @default(cuid())
+  pageId              String
+  version             Int // 整数版本号，自增
+  notes               String? // 版本说明（用户可编辑）
+  canvas              Json? // 原型快照
+  content             Json? // 文档快照
   restoredFromVersion Int? // 从哪个版本号还原而来（null 表示非还原版本）
-  fromPRDVersionId String? // 来源：从哪个 PRD 版本创建（可选标记）
-  createdAt       DateTime @default(now())
+  fromPRDVersionId    String? // 来源：从哪个 PRD 版本创建（可选标记）
+  createdAt           DateTime @default(now())
 
-  page  PRDPage  @relation(fields: [pageId], references: [id], onDelete: Cascade)
+  page PRDPage @relation(fields: [pageId], references: [id], onDelete: Cascade)
 
   @@index([pageId, createdAt])
   @@index([pageId, version])
@@ -871,15 +989,15 @@ model Review {
   id          String    @id @default(cuid())
   prdId       String
   versionId   String
-  status      String @default("PENDING")
+  status      String    @default("PENDING")
   reviewerId  String?
   notes       String?
   createdAt   DateTime  @default(now())
   completedAt DateTime?
 
-  prd      PRD           @relation(fields: [prdId], references: [id], onDelete: Cascade)
-  version  PRDVersion    @relation(fields: [versionId], references: [id])
-  reviewer User?         @relation("reviewer", fields: [reviewerId], references: [id])
+  prd      PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  version  PRDVersion      @relation(fields: [versionId], references: [id])
+  reviewer User?           @relation("reviewer", fields: [reviewerId], references: [id])
   comments ReviewComment[]
 
   @@unique([prdId, versionId])
@@ -894,15 +1012,15 @@ model ReviewComment {
   id        String   @id @default(cuid())
   reviewId  String
   userId    String
-  content   String  
-  pageId    String?  // 关联页面
-  elementId String?  // 关联具体元素
-  parentId  String?  // 回复上级留言
+  content   String
+  pageId    String? // 关联页面
+  elementId String? // 关联具体元素
+  parentId  String? // 回复上级留言
   createdAt DateTime @default(now())
 
-  review     Review         @relation(fields: [reviewId], references: [id], onDelete: Cascade)
-  user       User           @relation(fields: [userId], references: [id])
-  parent     ReviewComment? @relation("ReviewCommentReplies", fields: [parentId], references: [id])
+  review  Review          @relation(fields: [reviewId], references: [id], onDelete: Cascade)
+  user    User            @relation(fields: [userId], references: [id])
+  parent  ReviewComment?  @relation("ReviewCommentReplies", fields: [parentId], references: [id])
   replies ReviewComment[] @relation("ReviewCommentReplies")
 
   @@index([reviewId])
@@ -915,21 +1033,21 @@ model ReviewComment {
 model Comment {
   id        String   @id @default(cuid())
   prdId     String
-  pageId    String?  // 可选：针对某页面
-  elementId String?  // 可选：针对某元素（组件/区块实例ID）
+  pageId    String? // 可选：针对某页面
+  elementId String? // 可选：针对某元素（组件/区块实例ID）
   userId    String
-  content   String  
-  parentId  String?  // 回复上级评论
-  position  Json?    // 文本选区位置 { from: number, to: number }
+  content   String
+  parentId  String? // 回复上级评论
+  position  Json? // 文本选区位置 { from: number, to: number }
   resolved  Boolean  @default(false)
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  prd      PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
-  user     User            @relation(fields: [userId], references: [id])
-  parent   Comment?        @relation("CommentReplies", fields: [parentId], references: [id])
-  replies  Comment[]       @relation("CommentReplies")
-  ignores  CommentIgnore[]
+  prd     PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  user    User            @relation(fields: [userId], references: [id])
+  parent  Comment?        @relation("CommentReplies", fields: [parentId], references: [id])
+  replies Comment[]       @relation("CommentReplies")
+  ignores CommentIgnore[]
 
   @@index([prdId])
   @@index([userId])
@@ -955,18 +1073,18 @@ model CommentIgnore {
 
 // 分享链接
 model Share {
-  id         String    @id @default(cuid())
-  prdId      String
-  token      String    @unique
-  type       String    @default("prd") // "prd" | 预留扩展
-  status     String @default("ACTIVE")
-  password   String?   // 加密分享密码（4位，数字+大写+小写字母）
-  hasPassword Boolean  @default(false)
-  expiresAt  DateTime?
-  createdAt  DateTime  @default(now())
-  updatedAt  DateTime  @updatedAt
+  id          String    @id @default(cuid())
+  prdId       String
+  token       String    @unique
+  type        String    @default("prd") // "prd" | 预留扩展
+  status      String    @default("ACTIVE")
+  password    String? // 加密分享密码（4位，数字+大写+小写字母）
+  hasPassword Boolean   @default(false)
+  expiresAt   DateTime?
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
 
-  prd PRD @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  prd           PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
   shareVersions ShareVersion[]
 
   @@index([token])
@@ -1028,12 +1146,12 @@ model ComponentTag {
 }
 
 model Reference {
-  id              String   @id @default(uuid())
-  sourceModule    String
-  sourceEntityId  String
-  targetModule    String
-  targetEntityId  String
-  createdAt       DateTime @default(now())
+  id             String   @id @default(uuid())
+  sourceModule   String
+  sourceEntityId String
+  targetModule   String
+  targetEntityId String
+  createdAt      DateTime @default(now())
 
   @@index([sourceModule, sourceEntityId])
   @@index([targetModule, targetEntityId])
@@ -1045,8 +1163,8 @@ model ShareVersion {
   shareId   String
   versionId String
 
-  share     Share      @relation(fields: [shareId], references: [id], onDelete: Cascade)
-  version   PRDVersion @relation(fields: [versionId], references: [id], onDelete: Cascade)
+  share   Share      @relation(fields: [shareId], references: [id], onDelete: Cascade)
+  version PRDVersion @relation(fields: [versionId], references: [id], onDelete: Cascade)
 
   @@unique([shareId, versionId])
   @@index([shareId])
@@ -1060,7 +1178,7 @@ model AnyHubApp {
   id            String   @id @default(cuid())
   name          String   @unique
   displayName   String
-  description   String? 
+  description   String?
   version       String   @default("0.1.0")
   source        String
   url           String?
@@ -1074,7 +1192,7 @@ model AnyHubApp {
   createdAt     DateTime @default(now())
   updatedAt     DateTime @updatedAt
 
-  user        User              @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user        User               @relation(fields: [userId], references: [id], onDelete: Cascade)
   permissions AnyHubPermission[]
 
   @@index([userId])
@@ -1097,26 +1215,26 @@ model AnyHubPermission {
 }
 
 model AnyHubMarketApp {
-  id               String                @id @default(cuid())
+  id               String    @id @default(cuid())
   name             String
   displayName      String
-  description      String?              
+  description      String?
   entryUrl         String
   icon             String?
-  iconType         String              @default("ICON")
+  iconType         String    @default("ICON")
   logo             String?
   category         String?
-  tags             String?              
-  downloads        Int                   @default(0)
+  tags             String?
+  downloads        Int       @default(0)
   capabilities     Json
-  status           String  @default("DRAFT")
+  status           String    @default("DRAFT")
   publishedAt      DateTime?
   userId           String
-  recommendationId String?               @unique
-  createdAt        DateTime              @default(now())
-  updatedAt        DateTime              @updatedAt
+  recommendationId String?   @unique
+  createdAt        DateTime  @default(now())
+  updatedAt        DateTime  @updatedAt
 
-  user           User                @relation(fields: [userId], references: [id])
+  user           User                  @relation(fields: [userId], references: [id])
   recommendation AnyHubRecommendation? @relation("anyhubRecommendation", fields: [recommendationId], references: [id])
 
   @@index([status])
@@ -1128,7 +1246,7 @@ model AnyHubRecommendation {
   githubUrl        String    @unique
   name             String?
   displayName      String?
-  description      String?  
+  description      String?
   status           String    @default("pending")
   reviewedBy       String?
   reviewedAt       DateTime?
@@ -1136,8 +1254,8 @@ model AnyHubRecommendation {
   createdAt        DateTime  @default(now())
   updatedAt        DateTime  @updatedAt
 
-  marketplaceApp AnyHubMarketApp?     @relation("anyhubRecommendation")
-  reviewer       User?                @relation("reviewedAnyhubRecommendations", fields: [reviewedBy], references: [id])
+  marketplaceApp AnyHubMarketApp?    @relation("anyhubRecommendation")
+  reviewer       User?               @relation("reviewedAnyhubRecommendations", fields: [reviewedBy], references: [id])
   recommenders   AnyHubRecommender[]
 
   @@index([status])
@@ -1151,43 +1269,43 @@ model AnyHubRecommender {
   createdAt        DateTime @default(now())
 
   recommendation AnyHubRecommendation @relation(fields: [recommendationId], references: [id], onDelete: Cascade)
-  user            User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user           User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
 
   @@unique([recommendationId, userId])
 }
 
 // 设计稿
 model DesignProject {
-  id          String   @id @default(cuid())
-  name        String
-  documentId  String?
-  sketchName  String?
-  version     Int      @default(1)
-  userId      String
-  user        User     @relation(fields: [userId], references: [id])
-  artboards   Artboard[]
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  id         String     @id @default(cuid())
+  name       String
+  documentId String?
+  sketchName String?
+  version    Int        @default(1)
+  userId     String
+  user       User       @relation(fields: [userId], references: [id])
+  artboards  Artboard[]
+  createdAt  DateTime   @default(now())
+  updatedAt  DateTime   @updatedAt
 
   @@index([userId])
   @@map("design_projects")
 }
 
 model Artboard {
-  id              String        @id @default(cuid())
-  projectId       String
-  project         DesignProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
-  name            String
-  pageName        String?
-  width           Int
-  height          Int
-  pngPath         String
-  svgPath         String?
-  annotationJson  Json?
-  layerCount      Int?
-  sortOrder       Int           @default(0)
-  createdAt       DateTime      @default(now())
-  exports         ArtboardExport[]
+  id             String           @id @default(cuid())
+  projectId      String
+  project        DesignProject    @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  name           String
+  pageName       String?
+  width          Int
+  height         Int
+  pngPath        String
+  svgPath        String?
+  annotationJson Json?
+  layerCount     Int?
+  sortOrder      Int              @default(0)
+  createdAt      DateTime         @default(now())
+  exports        ArtboardExport[]
 
   @@index([projectId])
   @@map("design_artboards")
@@ -1208,25 +1326,26 @@ model ArtboardExport {
   @@unique([artboardId, layerId, scale])
   @@map("design_artboard_exports")
 }
+
 // AI 服务商元数据（admin 维护）
 model AiProvider {
   id             String   @id @default(cuid())
   providerId     String   @unique // 业务标识 "openai" "anthropic"，用于 adapter 路由与 AiProviderConfig 软关联
   displayName    String
   brandName      String
-  description    String  
+  description    String
   category       String   @default("popular") // recommended|popular|local
-  adapterKind    String   // openai|anthropic|gemini|groq|grok|openrouter|ollama|openai-compatible
+  adapterKind    String // openai|anthropic|gemini|groq|grok|openrouter|ollama|openai-compatible
   defaultBaseUrl String?
   keyUrl         String?
   docsUrl        String?
   keyPlaceholder String?
   iconSlug       String?
   brandColor     String   @default("#6467F2")
-  badge          String?  // 卡片角标文案（如「推荐」「热门」「NEW」），admin 可配
+  badge          String? // 卡片角标文案（如「推荐」「热门」「NEW」），admin 可配
   isLocal        Boolean  @default(false)
   enabled        Boolean  @default(true) // 平台级开关：停用后未配置用户看不到，已配置用户继续可用
-  models         Json     // AiModelMeta[]（admin 可编辑）
+  models         Json // AiModelMeta[]（admin 可编辑）
   sortOrder      Int      @default(0)
   createdAt      DateTime @default(now())
   updatedAt      DateTime @updatedAt
@@ -1238,12 +1357,15 @@ model AiProvider {
 model AiProviderConfig {
   id           String   @id @default(cuid())
   userId       String
-  providerId   String   // 业务 providerId，软关联 AiProvider.providerId（不设外键 cascade，避免 admin 删除丢失用户配置）
-  apiKey       String?  // 加密存储 TODO
+  providerId   String // 业务 providerId，软关联 AiProvider.providerId（不设外键 cascade，避免 admin 删除丢失用户配置）
+  apiKey       String? // 加密存储 TODO
   baseUrl      String?
+  voiceApiKey  String? // BytePlus Voice 独立 API key（speech/transcription 用，与 Ark apiKey 分开）
+  voiceBaseUrl String? // BytePlus Voice Base URL（默认 fallback 到 baseUrl）
   enabled      Boolean  @default(false) // 用户级开关：是否在对话模型选择器中暴露
-  models       Json?    // string[] 用户启用的模型 ID（有序，顺序 = 模型选择器展示顺序）
-  customModels Json?    // AiModelMeta[] 用户私有的自定义/刷新获取的模型元数据，与 AiProvider.models 取并集按 id 去重
+  models       Json? // string[] 用户启用的模型 ID（有序，顺序 = 模型选择器展示顺序）
+  customModels Json? // AiModelMeta[] 用户私有的自定义/刷新获取的模型元数据，与 AiProvider.models 取并集按 id 去重
+  agentMeta Json? // 模式2 本地 Agent 元数据：{ binary, resolvedPath, version, auth, workspaceDir, detectedAt }；不存任何密钥
   createdAt    DateTime @default(now())
   updatedAt    DateTime @updatedAt
 
@@ -1258,21 +1380,21 @@ model AiProviderConfig {
 // 第三方依赖版本管理（admin 决策是否升级）
 // currentVersion 实时读 monorepo 各 package.json，不存 DB；latestVersion 缓存自 npm registry
 model ThirdPartyDependency {
-  id            String   @id @default(cuid())
-  name          String   @unique // npm 包名，如 "@tiptap/core" / "mind-elixir"
-  displayName   String? // 展示名（默认取 name）
-  description   String?  // 依赖用途说明（admin 可编辑）
-  homepage      String? // 官网 / 仓库
-  category      String   @default("other") // framework|ui|editor|ai|state|tool|other
-  isWatched     Boolean  @default(true) // 是否置顶「关注列表」
-  priority      String   @default("normal") // high|normal|low
-  latestVersion String? // 缓存的 npm registry latest 版本
+  id              String    @id @default(cuid())
+  name            String    @unique // npm 包名，如 "@tiptap/core" / "mind-elixir"
+  displayName     String? // 展示名（默认取 name）
+  description     String? // 依赖用途说明（admin 可编辑）
+  homepage        String? // 官网 / 仓库
+  category        String    @default("other") // framework|ui|editor|ai|state|tool|other
+  isWatched       Boolean   @default(true) // 是否置顶「关注列表」
+  priority        String    @default("normal") // high|normal|low
+  latestVersion   String? // 缓存的 npm registry latest 版本
   latestChangelog String? // 最新版本的更新日志（来自 GitHub Releases，markdown）
-  lastSyncAt    DateTime? // 最后一次成功同步 npm registry 的时间
-  notes         String?  // 备注（升级注意事项等）
-  sortOrder     Int      @default(0)
-  createdAt     DateTime @default(now())
-  updatedAt     DateTime @updatedAt
+  lastSyncAt      DateTime? // 最后一次成功同步 npm registry 的时间
+  notes           String? // 备注（升级注意事项等）
+  sortOrder       Int       @default(0)
+  createdAt       DateTime  @default(now())
+  updatedAt       DateTime  @updatedAt
 
   @@index([category])
   @@index([isWatched])
@@ -1290,8 +1412,8 @@ model LegalRegulation {
   category         String
   issuingAuthority String?
   effectiveDate    DateTime?
-  summary          String?  
-  content          String?  
+  summary          String?
+  content          String?
   sourceUrl        String?
   likeCount        Int       @default(0)
   tags             Json      @default(dbgenerated("'[]'"))
@@ -1310,23 +1432,23 @@ model LegalRegulation {
 }
 
 model IndustryCompliance {
-  id             String    @id @default(cuid())
+  id             String   @id @default(cuid())
   canonicalId    String
   title          String
   industry       String
   regulatoryBody String?
   region         String?
-  summary        String?  
-  content        String?  
-  requirements   Json      @default(dbgenerated("'[]'"))
+  summary        String?
+  content        String?
+  requirements   Json     @default(dbgenerated("'[]'"))
   sourceUrl      String?
-  likeCount        Int       @default(0)
-  tags             Json      @default(dbgenerated("'[]'"))
-  visibility       String    @default("private")
-  userId           String
-  isDeleted        Boolean   @default(false)
-  createdAt        DateTime  @default(now())
-  updatedAt        DateTime  @updatedAt
+  likeCount      Int      @default(0)
+  tags           Json     @default(dbgenerated("'[]'"))
+  visibility     String   @default("private")
+  userId         String
+  isDeleted      Boolean  @default(false)
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
 
   user User @relation(fields: [userId], references: [id], onDelete: Cascade)
 
@@ -1337,20 +1459,20 @@ model IndustryCompliance {
 }
 
 model DictionaryTerm {
-  id           String    @id @default(cuid())
+  id           String   @id @default(cuid())
   canonicalId  String
   title        String
   industry     String
-  definition   String?  
-  aliases      Json      @default(dbgenerated("'[]'"))
-  examples     Json      @default(dbgenerated("'[]'"))
+  definition   String?
+  aliases      Json     @default(dbgenerated("'[]'"))
+  examples     Json     @default(dbgenerated("'[]'"))
   referenceUrl String?
-  tags         Json      @default(dbgenerated("'[]'"))
-  visibility   String    @default("private")
+  tags         Json     @default(dbgenerated("'[]'"))
+  visibility   String   @default("private")
   userId       String
-  isDeleted    Boolean   @default(false)
-  createdAt    DateTime  @default(now())
-  updatedAt    DateTime  @updatedAt
+  isDeleted    Boolean  @default(false)
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
 
   user User @relation(fields: [userId], references: [id], onDelete: Cascade)
 
@@ -1366,7 +1488,7 @@ model WebsiteBookmark {
   title               String
   url                 String
   categoryId          String?
-  summary             String?  
+  summary             String?
   faviconUrl          String?
   faviconSyncedAt     DateTime?
   isGithub            Boolean   @default(false)
@@ -1384,7 +1506,7 @@ model WebsiteBookmark {
   createdAt           DateTime  @default(now())
   updatedAt           DateTime  @updatedAt
 
-  user     User             @relation(fields: [userId], references: [id], onDelete: Cascade)
+  user     User              @relation(fields: [userId], references: [id], onDelete: Cascade)
   category BookmarkCategory? @relation(fields: [categoryId], references: [id], onDelete: SetNull)
 
   @@index([canonicalId, visibility])
@@ -1467,12 +1589,15 @@ model Plan {
   providerPriceIdUsdYearly String?
   providerPriceIdCnyYearly String?
 
-  seatPriceMonthly Int?
+  seatPriceMonthly       Int?
   providerSeatPriceIdUsd String?
   providerSeatPriceIdCny String?
 
-  agentQuota Int?
-  skillQuota Int?
+  agentQuota            Int?
+  skillQuota            Int?
+  sandboxMinutesMonthly Int?
+  mediaGenerationsMonthly Int?
+  galleryStorageMb        Int?
 
   subscriptions Subscription[]
 
@@ -1481,28 +1606,28 @@ model Plan {
 
 /// 订阅记录（User 级，一人一订阅）
 model Subscription {
-  id          String    @id @default(cuid())
-  userId      String    @unique
-  user        User        @relation(fields: [userId], references: [id])
-  planId               String
-  plan                 Plan      @relation(fields: [planId], references: [id])
-  status               String    @default("ACTIVE")
-  addonSeats Int @default(0)
-
-  provider                 String    @default("creem")
-  providerCustomerId       String?
-  providerSubscriptionId   String?   @unique
-  providerPriceId          String?
+  id         String @id @default(cuid())
+  userId     String @unique
+  user       User   @relation(fields: [userId], references: [id])
+  planId     String
+  plan       Plan   @relation(fields: [planId], references: [id])
+  status     String @default("ACTIVE")
+  addonSeats Int    @default(0)
+
+  provider                   String  @default("creem")
+  providerCustomerId         String?
+  providerSubscriptionId     String? @unique
+  providerPriceId            String?
   providerSeatSubscriptionId String?
 
-  currentPeriodStart   DateTime?
-  currentPeriodEnd     DateTime?
-  cancelAtPeriodEnd    Boolean  @default(false)
-  canceledAt           DateTime?
-  trialEndsAt          DateTime?
+  currentPeriodStart DateTime?
+  currentPeriodEnd   DateTime?
+  cancelAtPeriodEnd  Boolean   @default(false)
+  canceledAt         DateTime?
+  trialEndsAt        DateTime?
 
-  createdAt            DateTime  @default(now())
-  updatedAt            DateTime  @updatedAt
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
 
   /// 关联发票（子项目 3 新增）
   invoices Invoice[]
@@ -1512,16 +1637,16 @@ model Subscription {
 
 /// 用量记录（按月聚合，用于额度判断）
 model UsageRecord {
-  id          String   @id @default(cuid())
+  id          String    @id @default(cuid())
   workspaceId String
   workspace   Workspace @relation(fields: [workspaceId], references: [id])
   metric      String
   period      String
-  count       Int      @default(0)
+  count       Int       @default(0)
   resetAt     DateTime
 
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
 
   @@unique([workspaceId, metric, period])
   @@index([workspaceId, metric])
@@ -1530,22 +1655,23 @@ model UsageRecord {
 
 /// AI 用量明细（按次扣减 + 成本审计）
 model AiUsageLog {
-  id           String   @id @default(cuid())
-  workspaceId  String
-  workspace    Workspace @relation(fields: [workspaceId], references: [id])
+  id           String    @id @default(cuid())
+  workspaceId  String?
+  workspace    Workspace? @relation(fields: [workspaceId], references: [id], onDelete: Restrict)
   userId       String
-  user         User     @relation(fields: [userId], references: [id])
-  source       String   @default("byok")
+  user         User      @relation(fields: [userId], references: [id])
+  source       String    @default("byok")
+  activity     String?
   provider     String
   model        String
-  inputTokens  Int      @default(0)
-  outputTokens Int      @default(0)
+  inputTokens  Int       @default(0)
+  outputTokens Int       @default(0)
   costUsd      String?
-  success      Boolean  @default(true)
+  success      Boolean   @default(true)
   errorMessage String?
   durationMs   Int?
 
-  createdAt    DateTime @default(now())
+  createdAt DateTime @default(now())
 
   @@index([workspaceId, createdAt])
   @@index([userId, createdAt])
@@ -1558,22 +1684,22 @@ model AiUsageLog {
 
 /// 账单记录（Webhook 同步）
 model Invoice {
-  id               String       @id @default(cuid())
-  subscriptionId   String
-  subscription     Subscription @relation(fields: [subscriptionId], references: [id])
-  providerInvoiceId  String      @unique
-  providerEventId    String?
-  amountDue        Int
-  amountPaid       Int
-  currency         String       @default("usd")
-  status           String
-  pdfUrl           String?
-  hostedInvoiceUrl String?
-  periodStart      DateTime
-  periodEnd        DateTime
-  paidAt           DateTime?
-
-  createdAt        DateTime     @default(now())
+  id                String       @id @default(cuid())
+  subscriptionId    String
+  subscription      Subscription @relation(fields: [subscriptionId], references: [id])
+  providerInvoiceId String       @unique
+  providerEventId   String?
+  amountDue         Int
+  amountPaid        Int
+  currency          String       @default("usd")
+  status            String
+  pdfUrl            String?
+  hostedInvoiceUrl  String?
+  periodStart       DateTime
+  periodEnd         DateTime
+  paidAt            DateTime?
+
+  createdAt DateTime @default(now())
 
   @@index([subscriptionId, createdAt])
   @@map("invoices")
@@ -1581,15 +1707,15 @@ model Invoice {
 
 /// Provider Webhook 事件幂等记录
 model ProviderEvent {
-  id              String   @id @default(cuid())
-  providerEventId String   @unique
+  id              String    @id @default(cuid())
+  providerEventId String    @unique
   type            String
-  status          String   @default("processing")
+  status          String    @default("processing")
   payload         Json?
   errorMessage    String?
   processedAt     DateTime?
 
-  createdAt       DateTime @default(now())
+  createdAt DateTime @default(now())
 
   @@index([type, createdAt])
   @@map("provider_events")
@@ -1598,17 +1724,17 @@ model ProviderEvent {
 // ==================== 子项目 5：企业治理模型（sqlite 降级版）====================
 
 model LicenseKey {
-  id            String              @id @default(cuid())
-  key           String              @unique
+  id            String    @id @default(cuid())
+  key           String    @unique
   signature     String
-  payload       String              @default(dbgenerated("'{}'"))
+  payload       String    @default(dbgenerated("'{}'"))
   customerId    String
   customerName  String
   customerEmail String
-  plan          String              @default("enterprise")
+  plan          String    @default("enterprise")
   seats         Int
-  features      String              @default(dbgenerated("'{}'"))
-  issuedAt      DateTime            @default(now())
+  features      String    @default(dbgenerated("'{}'"))
+  issuedAt      DateTime  @default(now())
   expiresAt     DateTime?
   revokedAt     DateTime?
   issuedById    String?
@@ -1617,11 +1743,11 @@ model LicenseKey {
 }
 
 model LicenseActivation {
-  id          String     @id @default(cuid())
+  id          String    @id @default(cuid())
   licenseId   String
-  instanceId  String     @unique
+  instanceId  String    @unique
   fingerprint String
-  activatedAt DateTime   @default(now())
+  activatedAt DateTime  @default(now())
   lastSeenAt  DateTime?
   revokedAt   DateTime?
 
@@ -1647,50 +1773,50 @@ model AuditLog {
 }
 
 model SsoProvider {
-  id           String      @id @default(cuid())
-  workspaceId  String
-  type         String
-  name         String
-  config       String      @default(dbgenerated("'{}'"))
-  domain       String?
-  enabled      Boolean     @default(true)
-  createdAt    DateTime    @default(now())
-  updatedAt    DateTime    @updatedAt
+  id          String   @id @default(cuid())
+  workspaceId String
+  type        String
+  name        String
+  config      String   @default(dbgenerated("'{}'"))
+  domain      String?
+  enabled     Boolean  @default(true)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
 
   @@unique([workspaceId, type, domain])
   @@map("sso_providers")
 }
 
 model SsoMapping {
-  id         String      @id @default(cuid())
+  id         String   @id @default(cuid())
   providerId String
   externalId String
   userId     String
   email      String?
-  createdAt  DateTime    @default(now())
+  createdAt  DateTime @default(now())
 
   @@unique([providerId, externalId])
   @@map("sso_mappings")
 }
 
 model CustomRole {
-  id          String          @id @default(cuid())
+  id          String   @id @default(cuid())
   workspaceId String
   name        String
-  permissions String          @default(dbgenerated("'{}'"))
-  isSystem    Boolean         @default(false)
-  createdAt   DateTime        @default(now())
-  updatedAt   DateTime        @updatedAt
+  permissions String   @default(dbgenerated("'{}'"))
+  isSystem    Boolean  @default(false)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
 
   @@unique([workspaceId, name])
   @@map("custom_roles")
 }
 
 model RoleAssignment {
-  id        String    @id @default(cuid())
+  id        String   @id @default(cuid())
   roleId    String
   userId    String
-  createdAt DateTime  @default(now())
+  createdAt DateTime @default(now())
 
   @@unique([roleId, userId])
   @@map("role_assignments")
@@ -1730,9 +1856,12 @@ model UserAgent {
   createdAt        DateTime @default(now())
   updatedAt        DateTime @updatedAt
   isDeleted        Boolean  @default(false)
+  isDefault        Boolean  @default(false)
+  harnessKind      String?
 
-  user    User         @relation(fields: [userId], references: [id], onDelete: Cascade)
-  threads ChatThread[]
+  user          User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  threads       ChatThread[]
+  agentBindings BusinessAgentBinding[]
 
   @@index([userId])
   @@map("user_agents")
@@ -1774,33 +1903,33 @@ model DeveloperLog {
 
 // 需求（简化版，与 psql schema 对齐）
 model Story {
-  id          String   @id @default(cuid())
+  id          String     @id @default(cuid())
   sequenceId  Int
-  boardOrder  Int      @default(0)
+  boardOrder  Int        @default(0)
   identifier  String
   projectId   String
-  project     Project  @relation(fields: [projectId], references: [id], onDelete: Restrict)
+  project     Project    @relation(fields: [projectId], references: [id], onDelete: Restrict)
   name        String
   description String?
-  state       String   @default("backlog")
-  priority    String   @default("none")
-  archived    Boolean  @default(false)
+  state       String     @default("backlog")
+  priority    String     @default("none")
+  archived    Boolean    @default(false)
   archivedAt  DateTime?
   assigneeId  String?
-  assignee    User?    @relation("storyAssignee", fields: [assigneeId], references: [id], onDelete: SetNull)
+  assignee    User?      @relation("storyAssignee", fields: [assigneeId], references: [id], onDelete: SetNull)
   startDate   DateTime?
   targetDate  DateTime?
   createdById String
-  createdBy   User     @relation("storyCreator", fields: [createdById], references: [id])
+  createdBy   User       @relation("storyCreator", fields: [createdById], references: [id])
   updatedById String?
-  updatedBy   User?    @relation("storyEditor", fields: [updatedById], references: [id], onDelete: SetNull)
+  updatedBy   User?      @relation("storyEditor", fields: [updatedById], references: [id], onDelete: SetNull)
   parentId    String?
-  parent      Story?   @relation("StoryHierarchy", fields: [parentId], references: [id], onDelete: SetNull)
-  children    Story[]  @relation("StoryHierarchy")
+  parent      Story?     @relation("StoryHierarchy", fields: [parentId], references: [id], onDelete: SetNull)
+  children    Story[]    @relation("StoryHierarchy")
   iterationId String?
   iteration   Iteration? @relation(fields: [iterationId], references: [id], onDelete: SetNull)
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  createdAt   DateTime   @default(now())
+  updatedAt   DateTime   @updatedAt
 
   @@unique([projectId, identifier])
   @@index([projectId, sequenceId])
@@ -1836,16 +1965,16 @@ model Iteration {
 
 // 迭代自动排期配置（一项目一行）
 model IterationAutoSchedule {
-  projectId    String  @id
-  project      Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
-  enabled      Boolean @default(false)
-  title        String  @default("迭代")
-  durationDays Int     @default(14)
-  cooldownDays Int     @default(0)
+  projectId    String   @id
+  project      Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  enabled      Boolean  @default(false)
+  title        String   @default("迭代")
+  durationDays Int      @default(14)
+  cooldownDays Int      @default(0)
   startsOn     DateTime
-  futureCount  Int     @default(2)
-  autoRollover Boolean @default(false)
-  lastSeq      Int     @default(0)
+  futureCount  Int      @default(2)
+  autoRollover Boolean  @default(false)
+  lastSeq      Int      @default(0)
 
   @@map("iteration_auto_schedules")
 }
@@ -1862,3 +1991,107 @@ model NotificationPreference {
 
   @@map("notification_preferences")
 }
+
+// 编排模式可复用片段：用户保存的跨请求编排逻辑。运行时经 getSnippetBindings
+// 暴露为 snippet_<name> 绑定，片段函数体在嵌套沙箱内执行并可调用 external_* 工具。
+model CodeSnippet {
+  id          String   @id @default(cuid())
+  userId      String
+  name        String
+  title       String
+  description String
+  params      Json     @default(dbgenerated("'{}'"))
+  code        String
+  enabled     Boolean  @default(true)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+  isDeleted   Boolean  @default(false)
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, name])
+  @@index([userId, enabled, isDeleted])
+  @@map("code_snippets")
+}
+
+model SandboxInstance {
+  key               String   @id
+  provider          String
+  providerSandboxId String
+  latestSnapshotId  String?
+  threadId          String
+  latestRunId       String?
+  updatedAt         BigInt
+  createdAt         DateTime @default(now())
+
+  @@index([threadId])
+  @@map("sandbox_instances")
+}
+
+model AiStreamChunk {
+  id        BigInt   @id @default(autoincrement())
+  runId     String
+  chunk     Json
+  createdAt DateTime @default(now())
+
+  @@index([runId, id])
+  @@map("ai_stream_chunks")
+}
+
+model DesktopSetting {
+  key   String @id // "aiSourceMode" | "localAgentConfig"
+  value Json
+
+  @@map("desktop_settings")
+}
+
+/// Harness 工作区（云端持久化文件区 + 业务数据视图入口）
+model HarnessWorkspace {
+  id          String   @id @default(cuid())
+  name        String
+  ownerId     String
+  kind        String   @default("cloud") // "cloud" | "local-meta"（本地挂载只存元数据）
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  owner       User           @relation(fields: [ownerId], references: [id], onDelete: Cascade)
+  files       WorkspaceFile[]
+  threads     ChatThread[]
+
+  @@index([ownerId, updatedAt])
+  @@map("harness_workspaces")
+}
+
+/// 工作区文件（上传文件 + AI 生成物 + 沙箱产出）
+model WorkspaceFile {
+  id          String   @id @default(cuid())
+  workspaceId String
+  path        String   // 相对路径，如 "src/index.ts"
+  mimeType    String   @default("application/octet-stream")
+  size        Int      @default(0)
+  content     String?  // sqlite 无 @db.Text，降级为普通 String
+  source      String   @default("upload") // "upload" | "ai-generated" | "sandbox"
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  workspace   HarnessWorkspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+
+  @@unique([workspaceId, path])
+  @@index([workspaceId])
+  @@map("workspace_files")
+}
+
+// AI 附件二进制存储（P5 Wave 2）
+model Blob {
+  id        String   @id @default(cuid())
+  mimeType  String
+  bytes     Bytes
+  size      Int
+  userId    String
+  createdAt DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("blobs")
+}