qzl/social-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: 清理opencode技能文件、旧设计文档并更新配置文档

Browse Source
This commit is contained in:
qzl
2026-03-03 17:29:01 +08:00
parent 30a4a1af5d
commit a4f684466c
48 changed files with 134 additions and 72641 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/runtime/runtime-database.md
+129 -21
View File
@@ -30,8 +30,11 @@
| `todo_sources` | 待办与日程来源关联 |
| `automation_jobs` | 定时任务 |
| `sessions` | Agent 对话会话 |
| `llm_factories` | LLM 工厂配置 |
| `messages` | 会话消息记录 |
| `llm_factory` | LLM 工厂配置 |
| `llms` | LLM 模型实例 |
| `user_agent_catalog` | Agent 类型目录 |
| `invite_codes` | 邀请码 |
---
@@ -44,14 +47,17 @@
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | PK，`auth.users.id` |
| `username` | VARCHAR(50) | 用户名 |
| `username` | VARCHAR(30) | 用户名 |
| `avatar_url` | TEXT | 头像 URL |
| `bio` | TEXT | 个人简介 |
| `bio` | VARCHAR(200) | 个人简介 |
| `settings` | JSONB | 用户设置 |
| `referred_by` | UUID | 邀请人 ID |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `username` 唯一
**settings JSONB 默认结构：**
```json
{
@@ -75,15 +81,19 @@
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | PK |
| `user_id` | UUID | 用户 ID（唯一） |
| `user_id` | UUID | 用户 ID |
| `llm_id` | UUID | 关联的 LLM 模型 |
| `agent_type` | VARCHAR(20) | 枚举：`INTENT_RECOGNITION`, `TASK_EXECUTION`, `RESULT_REPORTING` |
| `config` | JSONB | Agent 配置参数 |
| `status` | VARCHAR(20) | 状态：`active`, `paused`, `migrating` |
| `created_by` | UUID | 创建者 |
| `updated_by` | UUID | 更新者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `(user_id, agent_type)` 唯一
---
### memories
@@ -130,8 +140,11 @@
| `requested_at` | TIMESTAMPTZ | 请求时间 |
| `accepted_at` | TIMESTAMPTZ | 接受时间 |
| `blocked_by` | UUID | 阻止者用户 ID |
| `created_by` | UUID | 创建者 |
| `updated_by` | UUID | 更新者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `user_low_id < user_high_id`，`(user_low_id, user_high_id)` 唯一
@@ -148,6 +161,8 @@
| `description` | TEXT | 群组描述 |
| `owner_id` | UUID | 创建者 ID |
| `status` | VARCHAR(20) | 状态：`active`, `archived` |
| `created_by` | UUID | 创建者 |
| `updated_by` | UUID | 更新者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
@@ -167,10 +182,13 @@
| `join_source` | VARCHAR(20) | 加入方式：`invited`, `joined` |
| `invited_by` | UUID | 邀请人 ID |
| `joined_at` | TIMESTAMPTZ | 加入时间 |
| `removed_at` | TIMESTAMPTZ | 移除时间 |
| `status` | VARCHAR(20) | 状态：`active`, `muted`, `removed` |
| `created_by` | UUID | 创建者 |
| `updated_by` | UUID | 更新者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `removed_at` | TIMESTAMPTZ | 移除时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `(group_id, user_id)` 唯一
@@ -190,11 +208,13 @@
| `end_at` | TIMESTAMPTZ | 结束时间 |
| `timezone` | VARCHAR(50) | 时区 |
| `metadata` | JSONB | 扩展字段 |
| `recurrence_rule` | VARCHAR(100) | 循环规则 |
| `recurrence_rule` | VARCHAR(255) | 循环规则 |
| `source_type` | VARCHAR(20) | 来源：`manual`, `imported`, `agent_generated` |
| `status` | VARCHAR(20) | 状态：`active`, `completed`, `canceled`, `archived` |
| `created_by` | UUID | 创建者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**metadata JSONB 默认结构：**
```json
@@ -231,10 +251,12 @@
| `id` | UUID | PK |
| `item_id` | UUID | 日程事项 ID |
| `subscriber_id` | UUID | 订阅者 ID |
| `permission` | INTEGER | 权限位图（view=1, invite=2, edit=4） |
| `notify_level` | VARCHAR(20) | 通知级别：`all`, `mentions`, `none` |
| `status` | VARCHAR(20) | 状态：`active`, `paused`, `unsubscribed` |
| `permission` | INTEGER | 权限位图（view=1, invite=2, edit=4），默认 1 |
| `notify_level` | VARCHAR(20) | 通知级别：`all`, `mentions`, `none`，默认 `all` |
| `status` | VARCHAR(20) | 状态：`active`, `paused`, `unsubscribed`，默认 `active` |
| `created_by` | UUID | 创建者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
**约束：** `(item_id, subscriber_id)` 唯一，`permission BETWEEN 0 AND 7`
@@ -254,9 +276,11 @@
| `schedule_item_id` | UUID | 日程关联（calendar 时必填） |
| `group_id` | UUID | 群组关联（group 时必填） |
| `content` | TEXT | 消息内容（system 用） |
| `is_read` | BOOLEAN | 是否已读 |
| `is_read` | BOOLEAN | 是否已读，默认 false |
| `status` | VARCHAR(20) | 状态：`pending`, `accepted`, `rejected`, `dismissed` |
| `created_by` | UUID | 创建者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
**message_type 与业务字段对应：**
| message_type | 必填字段 |
@@ -266,6 +290,8 @@
| system | 全部可空 |
| group | group_id |
**sender 约束：** system 类型 sender_id 为空，其他类型 sender_id 必填
---
### todos
@@ -277,12 +303,17 @@
| `id` | UUID | PK |
| `owner_id` | UUID | 所有者 ID |
| `title` | VARCHAR(255) | 标题 |
| `description` | TEXT | 描述 |
| `description` | VARCHAR(1000) | 描述 |
| `due_at` | TIMESTAMPTZ | 截止时间 |
| `priority` | INTEGER | 优先级（1=重要且紧急, 2=重要不紧急, 3=紧急不重要, 4=不重要不紧急） |
| `priority` | INTEGER | 优先级（1-4，1=重要且紧急） |
| `status` | VARCHAR(20) | 状态：`pending`, `done`, `canceled` |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `completed_at` | TIMESTAMPTZ | 完成时间 |
| `created_by` | UUID | 创建者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `priority BETWEEN 1 AND 4`
---
@@ -296,6 +327,7 @@
| `todo_id` | UUID | 待办 ID |
| `schedule_item_id` | UUID | 日程事项 ID |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
**约束：** `(todo_id, schedule_item_id)` 唯一
@@ -317,8 +349,12 @@
| `timezone` | VARCHAR(50) | 时区 |
| `last_run_at` | TIMESTAMPTZ | 最近运行时间 |
| `status` | VARCHAR(20) | 状态：`active`, `disabled` |
| `created_by` | UUID | 创建者 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `(id, owner_id)` 唯一
---
@@ -332,14 +368,48 @@ Agent 对话会话。
| `user_id` | UUID | 用户 ID |
| `session_type` | VARCHAR(20) | 会话类型：`chat`, `automation` |
| `job_id` | UUID | 自动化任务 ID（automation 时必填） |
| `title` | VARCHAR(255) | 会话标题 |
| `status` | VARCHAR(20) | 状态：`pending`, `running`, `completed`, `failed` |
| `last_activity_at` | TIMESTAMPTZ | 最后活跃时间 |
| `message_count` | INTEGER | 消息计数，默认 0 |
| `total_tokens` | INTEGER | 总 token 数，默认 0 |
| `total_cost` | NUMERIC(12,6) | 总费用，默认 0 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `session_type='chat' → job_id IS NULL`, `session_type='automation' → job_id IS NOT NULL`
---
### llm_factories
### messages
会话消息记录。
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | PK |
| `session_id` | UUID | 会话 ID |
| `seq` | INTEGER | 消息序号 |
| `role` | VARCHAR(20) | 角色：`user`, `assistant`, `system`, `tool` |
| `content` | TEXT | 消息内容 |
| `model_code` | VARCHAR(50) | 模型标识 |
| `tool_name` | VARCHAR(100) | 工具名称 |
| `input_tokens` | INTEGER | 输入 token 数，默认 0 |
| `output_tokens` | INTEGER | 输出 token 数，默认 0 |
| `cost` | NUMERIC(12,6) | 费用，默认 0 |
| `currency` | VARCHAR(3) | 货币，默认 USD |
| `latency_ms` | INTEGER | 延迟（毫秒） |
| `metadata` | JSONB | 扩展字段 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `(session_id, seq)` 唯一
---
### llm_factory
LLM 工厂配置。
@@ -347,11 +417,13 @@ LLM 工厂配置。
|------|------|------|
| `id` | UUID | PK |
| `name` | VARCHAR(50) | 工厂名称 |
| `base_url` | TEXT | API 基础 URL |
| `api_key` | TEXT | API 密钥 |
| `enabled` | BOOLEAN | 是否启用 |
| `request_url` | VARCHAR(255) | API 请求 URL |
| `avatar` | TEXT | 头像 URL |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `name` 唯一
---
@@ -363,12 +435,48 @@ LLM 模型实例。
|------|------|------|
| `id` | UUID | PK |
| `factory_id` | UUID | 工厂 ID |
| `model_id` | VARCHAR(50) | 模型标识 |
| `name` | VARCHAR(100) | 显示名称 |
| `context_window` | INTEGER | 上下文窗口大小 |
| `enabled` | BOOLEAN | 是否启用 |
| `model_code` | VARCHAR(50) | 模型标识 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
| `deleted_at` | TIMESTAMPTZ | 软删时间 |
**约束：** `model_code` 唯一
---
### user_agent_catalog
Agent 类型目录。
| 字段 | 类型 | 说明 |
|------|------|------|
| `agent_type` | VARCHAR(20) | PK，Agent 类型 |
| `llm_id` | UUID | 关联的 LLM 模型 |
| `status` | VARCHAR(20) | 状态：`active`, `paused`, `migrating` |
| `config` | JSONB | Agent 配置参数 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
---
### invite_codes
邀请码。
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | PK |
| `code` | VARCHAR(8) | 邀请码（8 位大写字母数字） |
| `owner_id` | UUID | 拥有者 ID |
| `status` | VARCHAR(20) | 状态：`active`, `disabled`, `expired` |
| `used_count` | INTEGER | 已使用次数，默认 0 |
| `max_uses` | INTEGER | 最大使用次数 |
| `expires_at` | TIMESTAMPTZ | 过期时间 |
| `reward_config` | JSONB | 奖励配置 |
| `created_at` | TIMESTAMPTZ | 创建时间 |
| `updated_at` | TIMESTAMPTZ | 更新时间 |
**约束：** `code` 唯一，`code` 符合 `[ABCDEFGHJKMNPQRSTUVWXYZ23456789]{8}`，`used_count >= 0`
---