AgentX: Command for Claude Code

RAG 发布功能需求规划

1. 核心设计原则

1.1 快照机制设计

• 完整快照：rag_versions 表包含完整的文件数据快照，不依赖原始数据
• 数据独立：版本快照创建后，原始数据的任何变更都不会影响快照
• 文件复制：发布时需要复制所有文件内容、向量数据、文档单元等

1.2 审核机制设计

• 必须审核：知识库发布到市场必须经过管理员审核
• 内容审核：需要审核知识库的内容是否合规
• 审核状态：审核中、已发布、拒绝、已下架

2. 数据库设计

2.1 RAG 版本表 (rag_versions) - 完整快照

CREATE TABLE rag_versions (
    id VARCHAR(36) PRIMARY KEY,
    
    -- 基本信息（快照时的数据）
    name VARCHAR(255) NOT NULL,                 -- 快照时的名称
    icon VARCHAR(255),                          -- 快照时的图标
    description TEXT,                           -- 快照时的描述
    user_id VARCHAR(36) NOT NULL,               -- 创建者
    
    -- 版本信息
    version VARCHAR(50) NOT NULL,               -- 版本号 (如 "1.0.0")
    change_log TEXT,                            -- 更新日志
    labels JSONB,                               -- 标签
    
    -- 原始数据集信息（仅用于标识，不依赖）
    original_rag_id VARCHAR(36) NOT NULL,       -- 原始RAG数据集ID（仅标识用）
    original_rag_name VARCHAR(255),             -- 原始RAG名称（快照时）
    
    -- 快照统计信息
    file_count INTEGER DEFAULT 0,               -- 文件数量
    total_size BIGINT DEFAULT 0,                -- 总大小
    document_count INTEGER DEFAULT 0,           -- 文档单元数量
    
    -- 发布状态（需要审核）
    publish_status INTEGER DEFAULT 1,           -- 1:审核中, 2:已发布, 3:拒绝, 4:已下架
    reject_reason TEXT,                         -- 审核拒绝原因
    review_time TIMESTAMP,                      -- 审核时间
    published_at TIMESTAMP,                     -- 发布时间
    
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

2.2 RAG 版本文件表 (rag_version_files) - 文件快照

CREATE TABLE rag_version_files (
    id VARCHAR(36) PRIMARY KEY,
    rag_version_id VARCHAR(36) NOT NULL,        -- 关联RAG版本
    
    -- 文件信息快照
    original_file_id VARCHAR(36) NOT NULL,      -- 原始文件ID（仅标识）
    file_name VARCHAR(255) NOT NULL,            -- 文件名
    file_size BIGINT DEFAULT 0,                 -- 文件大小
    file_type VARCHAR(50),                      -- 文件类型
    file_path VARCHAR(500),                     -- 文件存储路径
    
    -- 处理状态快照
    process_status INTEGER,                     -- 处理状态
    embedding_status INTEGER,                   -- 向量化状态
    
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);