Merge branch 'PingChuan' into shiy-login

2025-12-01 12:40:22 +08:00
parent c43485ec27 0c1b81cfb2
commit c9e0d5abba
41 changed files with 4494 additions and 1075 deletions
@@ -1,13 +1,13 @@
 /**
- * Dify 服务端基础 API 模块
+ * Dify Chat 服务端 API 模块
 *
 * 提供 Node.js 服务端调用 FastAPI 后端的基础功能
- * 包括配置管理和基础请求函数
+ * Dify 的 API_KEY 和 APP_ID 由 FastAPI 后端管理，前端只负责转发请求
 *
 * 调用链路：
- * Remix Server → FastAPI /dify/* → Dify
+ * Remix Server → FastAPI /dify_chat/* → Dify
 *
- * @module api/dify/client.server
+ * @module api/dify-chat/client.server
 */

 import { API_BASE_URL } from '~/config/api-config';
@@ -17,45 +17,25 @@ import { API_BASE_URL } from '~/config/api-config';
 // ============================================================================

 /**
- * 获取环境变量的服务端函数
+ * Dify Chat API 代理地址
+ * 通过 FastAPI 后端的 /dify_chat 路由代理访问 Dify
+ * Dify 的认证（API_KEY）由 FastAPI 后端处理
 */
-const getServerEnvVar = (name: string, defaultValue: string = ''): string => {
-    return process.env[name] || defaultValue;
-};
-
-/**
- * Dify API 客户端配置
- * 通过 FastAPI 后端的 /dify 路由代理访问 Dify
- */
-const DIFY_CONFIG = {
-    API_URL: `${API_BASE_URL}/dify_chat`,
-    API_KEY: getServerEnvVar('NEXT_PUBLIC_APP_KEY', ''),
-    APP_ID: (() => {
-        const rawAppId = getServerEnvVar('NEXT_PUBLIC_APP_ID', '');
-        const match = rawAppId.match(/\/app\/([a-f0-9-]{36})/);
-        return match ? match[1] : rawAppId;
-    })(),
-};
-
-console.log('[Dify Server] 配置:', {
-    apiUrl: DIFY_CONFIG.API_URL,
-    apiBaseUrl: API_BASE_URL,
-    appId: DIFY_CONFIG.APP_ID,
-    configComplete: !!(DIFY_CONFIG.API_URL && DIFY_CONFIG.APP_ID)
-});
+const DIFY_CHAT_API_URL = `${API_BASE_URL}/dify_chat`;

 // ============================================================================
 // 基础请求函数
 // ============================================================================

 /**
- * Dify API 基础请求函数
+ * Dify Chat API 基础请求函数
 *
- * 使用 JWT 认证通过 FastAPI 代理访问 Dify
+ * 使用用户 JWT 认证通过 FastAPI 代理访问 Dify
+ * FastAPI 后端会验证 JWT 并添加 Dify API_KEY
 *
 * @param endpoint - API 端点路径
 * @param options - fetch 请求选项
- * @param jwt - JWT 认证令牌
+ * @param jwt - 用户 JWT 认证令牌
 * @returns Response 对象
 */
 export async function difyFetch(
@@ -63,7 +43,7 @@ export async function difyFetch(
    options: RequestInit = {},
    jwt?: string
 ): Promise<Response> {
-    const url = `${DIFY_CONFIG.API_URL}/${endpoint.replace(/^\//, '')}`;
+    const url = `${DIFY_CHAT_API_URL}/${endpoint.replace(/^\//, '')}`;

    const headers: HeadersInit = {
        'Content-Type': 'application/json',
@@ -73,7 +53,7 @@ export async function difyFetch(
    if (jwt) {
        (headers as Record<string, string>)['Authorization'] = `Bearer ${jwt}`;
    } else {
-        console.warn('[Dify Server] 没有提供 JWT，转发fastapi请求可能失败');
+        console.warn('[Dify Chat] 没有提供 JWT，FastAPI 请求可能失败');
    }

    const response = await fetch(url, {
@@ -83,7 +63,7 @@ export async function difyFetch(

    if (!response.ok) {
        const errorText = await response.text();
-        console.error('[Dify Server] API 转发错误:', {
+        console.error('[Dify Chat] API 转发错误:', {
            status: response.status,
            statusText: response.statusText,
            error: errorText
@@ -99,19 +79,5 @@ export async function difyFetch(
    return response;
 }

-// ============================================================================
-// 工具函数
-// ============================================================================
-
-/**
- * Dify 工具函数
- */
-export const difyUtils = {
-    /**
-     * 获取 Dify 配置
-     */
-    getConfig: () => DIFY_CONFIG,
-};
-
 // 重新导出 chat 模块的 difyClient
 export { difyClient } from './chat';
@@ -0,0 +1,78 @@
+/**
+ * Dify Dataset 知识库 API 模块
+ *
+ * 提供浏览器端调用 Dify 知识库管理 API 的函数
+ *
+ * @module api/dify-dataset/api/datasetApi
+ */
+
+import axios from 'axios';
+import type { Dataset, DatasetsResponse } from '../type';
+
+/**
+ * API 基础 URL
+ */
+const API_URL = '/api/dataset';
+
+/**
+ * 获取知识库列表
+ *
+ * @param page - 页码，默认 1
+ * @param limit - 每页数量，默认 20
+ * @returns 知识库列表响应
+ */
+export async function fetchDatasets(
+    page: number = 1,
+    limit: number = 20
+): Promise<DatasetsResponse> {
+    const params = new URLSearchParams({
+        page: page.toString(),
+        limit: limit.toString(),
+    });
+
+    const response = await axios.get<DatasetsResponse>(
+        `${API_URL}/datasets?${params}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 获取单个知识库详情
+ *
+ * @param datasetId - 知识库 ID
+ * @returns 知识库详情
+ */
+export async function fetchDataset(datasetId: string): Promise<Dataset> {
+    const response = await axios.get<Dataset>(
+        `${API_URL}/datasets/${datasetId}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 更新知识库名称
+ *
+ * 注意：仅允许修改知识库名称，其他字段不开放修改
+ *
+ * @param datasetId - 知识库 ID
+ * @param name - 新的知识库名称
+ * @returns 更新后的知识库详情
+ */
+export async function updateDatasetName(
+    datasetId: string,
+    name: string
+): Promise<Dataset> {
+    console.log('[Dataset Client] 更新知识库名称:', { datasetId, name });
+
+    const response = await axios.patch<Dataset>(
+        `${API_URL}/datasets/${datasetId}`,
+        { name },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
@@ -1,76 +1,25 @@
 /**
- * Dify Dataset 客户端 API 模块
+ * Dify Dataset 文档 API 模块
 *
- * 提供浏览器端调用 Dify 知识库 API 的函数
- * 通过 Remix API Routes 代理请求
+ * 提供浏览器端调用 Dify 文档管理 API 的函数
 *
- * @module api/dify-dataset/client
+ * @module api/dify-dataset/api/documentApi
 */

 import axios from 'axios';
 import type {
-    DatasetsResponse,
-    DocumentsResponse,
-    SegmentsResponse,
    Document,
+    DocumentsResponse,
+    IndexingStatusResponse,
+    UploadFileInfo,
    OperationResult,
-} from './types';
-
-// ============================================================================
-// 基础配置
-// ============================================================================
+} from '../type';

 /**
 * API 基础 URL
- * 指向 Remix API Routes（/api/dataset/*）
 */
 const API_URL = '/api/dataset';

-// ============================================================================
-// 知识库 API
-// ============================================================================
-
-/**
- * 获取知识库列表
- *
- * @param page - 页码，默认 1
- * @param limit - 每页数量，默认 20
- * @returns 知识库列表响应
- */
-export async function fetchDatasets(
-    page: number = 1,
-    limit: number = 20
-): Promise<DatasetsResponse> {
-    const params = new URLSearchParams({
-        page: page.toString(),
-        limit: limit.toString(),
-    });
-
-    const response = await axios.get<DatasetsResponse>(
-        `${API_URL}/datasets?${params}`,
-        { withCredentials: true }
-    );
-    return response.data;
-}
-
-/**
- * 获取单个知识库详情
- *
- * @param datasetId - 知识库 ID
- * @returns 知识库详情
- */
-export async function fetchDataset(datasetId: string): Promise<any> {
-    const response = await axios.get(
-        `${API_URL}/datasets/${datasetId}`,
-        { withCredentials: true }
-    );
-    return response.data;
-}
-
-// ============================================================================
-// 文档 API
-// ============================================================================
-
 /**
 * 获取知识库文档列表
 *
@@ -144,6 +93,8 @@ export async function deleteDocument(

 /**
 * 启用/禁用文档
+ * Dify API: PATCH /datasets/{dataset_id}/documents/status/{action}
+ * action: enable / disable / archive / un_archive
 *
 * @param datasetId - 知识库 ID
 * @param documentId - 文档 ID
@@ -155,11 +106,12 @@ export async function toggleDocumentStatus(
    documentId: string,
    enabled: boolean
 ): Promise<OperationResult> {
-    console.log('[Dataset Client] 切换文档状态:', { datasetId, documentId, enabled });
+    const action = enabled ? 'enable' : 'disable';
+    console.log('[Dataset Client] 切换文档状态:', { datasetId, documentId, action });

    const response = await axios.patch<OperationResult>(
-        `${API_URL}/datasets/${datasetId}/documents/${documentId}/status`,
-        { enabled },
+        `${API_URL}/datasets/${datasetId}/documents/status/${action}`,
+        { document_ids: [documentId] },
        {
            headers: { 'Content-Type': 'application/json' },
            withCredentials: true,
@@ -168,97 +120,6 @@ export async function toggleDocumentStatus(
    return response.data;
 }

-// ============================================================================
-// 文档分段 API
-// ============================================================================
-
-/**
- * 获取文档分段列表
- *
- * @param datasetId - 知识库 ID
- * @param documentId - 文档 ID
- * @param page - 页码，默认 1
- * @param limit - 每页数量，默认 20
- * @param keyword - 搜索关键词
- * @returns 分段列表响应
- */
-export async function fetchSegments(
-    datasetId: string,
-    documentId: string,
-    page: number = 1,
-    limit: number = 20,
-    keyword?: string
-): Promise<SegmentsResponse> {
-    const params = new URLSearchParams({
-        page: page.toString(),
-        limit: limit.toString(),
-    });
-
-    if (keyword) {
-        params.append('keyword', keyword);
-    }
-
-    console.log('[Dataset Client] 获取分段列表:', { datasetId, documentId, page, limit });
-
-    const response = await axios.get<SegmentsResponse>(
-        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments?${params}`,
-        { withCredentials: true }
-    );
-    return response.data;
-}
-
-/**
- * 删除分段
- *
- * @param datasetId - 知识库 ID
- * @param documentId - 文档 ID
- * @param segmentId - 分段 ID
- * @returns 操作结果
- */
-export async function deleteSegment(
-    datasetId: string,
-    documentId: string,
-    segmentId: string
-): Promise<OperationResult> {
-    console.log('[Dataset Client] 删除分段:', { datasetId, documentId, segmentId });
-
-    const response = await axios.delete<OperationResult>(
-        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`,
-        { withCredentials: true }
-    );
-    return response.data;
-}
-
-/**
- * 启用/禁用分段
- *
- * @param datasetId - 知识库 ID
- * @param documentId - 文档 ID
- * @param segmentId - 分段 ID
- * @param enabled - 是否启用
- * @returns 操作结果
- */
-export async function toggleSegmentStatus(
-    datasetId: string,
-    documentId: string,
-    segmentId: string,
-    enabled: boolean
-): Promise<OperationResult> {
-    const response = await axios.patch<OperationResult>(
-        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/status`,
-        { enabled },
-        {
-            headers: { 'Content-Type': 'application/json' },
-            withCredentials: true,
-        }
-    );
-    return response.data;
-}
-
-// ============================================================================
-// 文件上传 API
-// ============================================================================
-
 /**
 * 上传文件到知识库
 *
@@ -284,7 +145,7 @@ export async function uploadDocument(
    console.log('[Dataset Client] 上传文档:', { datasetId, fileName: file.name });

    const response = await axios.post(
-        `${API_URL}/datasets/${datasetId}/documents/create-by-file`,
+        `${API_URL}/datasets/${datasetId}/documents`,
        formData,
        {
            withCredentials: true,
@@ -298,3 +159,96 @@ export async function uploadDocument(
    );
    return response.data;
 }
+
+/**
+ * 获取文档嵌入状态（索引进度）
+ *
+ * @param datasetId - 知识库 ID
+ * @param batch - 上传文档的批次号
+ * @returns 索引状态列表
+ */
+export async function fetchIndexingStatus(
+    datasetId: string,
+    batch: string
+): Promise<IndexingStatusResponse> {
+    console.log('[Dataset Client] 获取索引状态:', { datasetId, batch });
+
+    const response = await axios.get<IndexingStatusResponse>(
+        `${API_URL}/datasets/${datasetId}/documents/${batch}/indexing-status`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 获取文档上传文件信息
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @returns 上传文件信息
+ */
+export async function fetchUploadFileInfo(
+    datasetId: string,
+    documentId: string
+): Promise<UploadFileInfo> {
+    console.log('[Dataset Client] 获取上传文件信息:', { datasetId, documentId });
+
+    const response = await axios.get<UploadFileInfo>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/upload-file`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 文档处理规则配置
+ */
+export interface ProcessRule {
+    mode: 'automatic' | 'custom';
+    rules?: {
+        pre_processing_rules?: Array<{
+            id: 'remove_extra_spaces' | 'remove_urls_emails';
+            enabled: boolean;
+        }>;
+        segmentation?: {
+            separator: string;
+            max_tokens: number;
+        };
+    };
+}
+
+/**
+ * 更新文档设置参数
+ */
+export interface UpdateDocumentSettings {
+    indexing_technique?: 'high_quality' | 'economy';
+    process_rule?: ProcessRule;
+}
+
+/**
+ * 更新文档设置并重新处理
+ * 注意：Dify API 不直接支持修改已有文档的分段设置
+ * 此函数尝试通过更新接口应用新设置
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param settings - 更新设置
+ * @returns 操作结果
+ */
+export async function updateDocumentWithSettings(
+    datasetId: string,
+    documentId: string,
+    settings: UpdateDocumentSettings
+): Promise<OperationResult> {
+    console.log('[Dataset Client] 更新文档设置:', { datasetId, documentId, settings });
+
+    const response = await axios.post<OperationResult>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/update-settings`,
+        settings,
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
@@ -0,0 +1,38 @@
+/**
+ * Dify Dataset API 客户端统一导出
+ *
+ * @module api/dify-dataset/api
+ */
+
+// 知识库 API
+export {
+    fetchDatasets,
+    fetchDataset,
+    updateDatasetName,
+} from './datasetApi';
+
+// 文档 API
+export {
+    fetchDocuments,
+    fetchDocument,
+    deleteDocument,
+    toggleDocumentStatus,
+    uploadDocument,
+    fetchIndexingStatus,
+    fetchUploadFileInfo,
+} from './documentApi';
+
+// 分段、子分段、检索 API
+export {
+    fetchSegments,
+    fetchSegment,
+    createSegments,
+    updateSegment,
+    deleteSegment,
+    toggleSegmentStatus,
+    fetchChildChunks,
+    createChildChunk,
+    updateChildChunk,
+    deleteChildChunk,
+    retrieveDataset,
+} from './segmentApi';
@@ -0,0 +1,359 @@
+/**
+ * Dify Dataset 分段、子分段、检索 API 模块
+ *
+ * 提供浏览器端调用 Dify 分段管理和检索 API 的函数
+ *
+ * @module api/dify-dataset/api/segmentApi
+ */
+
+import axios from 'axios';
+import type {
+    Segment,
+    SegmentsResponse,
+    CreateSegmentRequest,
+    UpdateSegmentRequest,
+    CreateSegmentsResponse,
+    ChildChunk,
+    ChildChunksResponse,
+    CreateChildChunkResponse,
+    RetrieveRequest,
+    RetrieveResponse,
+    OperationResult,
+} from '../type';
+
+/**
+ * API 基础 URL
+ */
+const API_URL = '/api/dataset';
+
+// ============================================================================
+// 分段 API
+// ============================================================================
+
+/**
+ * 获取文档分段列表
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param page - 页码，默认 1
+ * @param limit - 每页数量，默认 20
+ * @param keyword - 搜索关键词
+ * @returns 分段列表响应
+ */
+export async function fetchSegments(
+    datasetId: string,
+    documentId: string,
+    page: number = 1,
+    limit: number = 20,
+    keyword?: string
+): Promise<SegmentsResponse> {
+    const params = new URLSearchParams({
+        page: page.toString(),
+        limit: limit.toString(),
+    });
+
+    if (keyword) {
+        params.append('keyword', keyword);
+    }
+
+    console.log('[Dataset Client] 获取分段列表:', { datasetId, documentId, page, limit });
+
+    const response = await axios.get<SegmentsResponse>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments?${params}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 获取单个分段详情
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @returns 分段详情
+ */
+export async function fetchSegment(
+    datasetId: string,
+    documentId: string,
+    segmentId: string
+): Promise<Segment> {
+    console.log('[Dataset Client] 获取分段详情:', { datasetId, documentId, segmentId });
+
+    const response = await axios.get<{ data: Segment }>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`,
+        { withCredentials: true }
+    );
+    return response.data.data;
+}
+
+/**
+ * 新增分段（批量）
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segments - 分段列表
+ * @returns 创建的分段列表
+ */
+export async function createSegments(
+    datasetId: string,
+    documentId: string,
+    segments: CreateSegmentRequest[]
+): Promise<CreateSegmentsResponse> {
+    console.log('[Dataset Client] 新增分段:', { datasetId, documentId, count: segments.length });
+
+    const response = await axios.post<CreateSegmentsResponse>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments`,
+        { segments },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
+
+/**
+ * 更新分段内容
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param segment - 更新内容
+ * @returns 更新后的分段
+ */
+export async function updateSegment(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    segment: UpdateSegmentRequest
+): Promise<{ data: Segment; doc_form: string }> {
+    console.log('[Dataset Client] 更新分段:', { datasetId, documentId, segmentId, segment });
+
+    const response = await axios.post<{ data: Segment; doc_form: string }>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`,
+        { segment },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
+
+/**
+ * 删除分段
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @returns 操作结果
+ */
+export async function deleteSegment(
+    datasetId: string,
+    documentId: string,
+    segmentId: string
+): Promise<OperationResult> {
+    console.log('[Dataset Client] 删除分段:', { datasetId, documentId, segmentId });
+
+    const response = await axios.delete<OperationResult>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 启用/禁用分段
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}
+ * 通过更新分段的方式来切换状态
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param enabled - 是否启用
+ * @returns 操作结果
+ */
+export async function toggleSegmentStatus(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    enabled: boolean
+): Promise<OperationResult> {
+    console.log('[Dataset Client] 切换分段状态:', { datasetId, documentId, segmentId, enabled });
+
+    const response = await axios.post<OperationResult>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`,
+        { segment: { enabled } },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
+
+// ============================================================================
+// 子分段 API（父子模式）
+// ============================================================================
+
+/**
+ * 获取子分段列表
+ * Dify API: GET /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param page - 页码
+ * @param limit - 每页数量
+ * @param keyword - 搜索关键词
+ * @returns 子分段列表响应
+ */
+export async function fetchChildChunks(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    page: number = 1,
+    limit: number = 20,
+    keyword?: string
+): Promise<ChildChunksResponse> {
+    const params = new URLSearchParams({
+        page: page.toString(),
+        limit: limit.toString(),
+    });
+
+    if (keyword) {
+        params.append('keyword', keyword);
+    }
+
+    console.log('[Dataset Client] 获取子分段列表:', { datasetId, documentId, segmentId, page, limit });
+
+    const response = await axios.get<ChildChunksResponse>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks?${params}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+/**
+ * 新增子分段
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param content - 子分段内容
+ * @returns 创建的子分段
+ */
+export async function createChildChunk(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    content: string
+): Promise<CreateChildChunkResponse> {
+    console.log('[Dataset Client] 新增子分段:', { datasetId, documentId, segmentId });
+
+    const response = await axios.post<CreateChildChunkResponse>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks`,
+        { content },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
+
+/**
+ * 更新子分段
+ * Dify API: PATCH /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks/{child_chunk_id}
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param childChunkId - 子分段 ID
+ * @param content - 更新内容
+ * @returns 更新后的子分段
+ */
+export async function updateChildChunk(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    childChunkId: string,
+    content: string
+): Promise<ChildChunk> {
+    console.log('[Dataset Client] 更新子分段:', { datasetId, documentId, segmentId, childChunkId });
+
+    const response = await axios.patch<{ data: ChildChunk }>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks/${childChunkId}`,
+        { content },
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data.data;
+}
+
+/**
+ * 删除子分段
+ * Dify API: DELETE /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks/{child_chunk_id}
+ *
+ * @param datasetId - 知识库 ID
+ * @param documentId - 文档 ID
+ * @param segmentId - 分段 ID
+ * @param childChunkId - 子分段 ID
+ * @returns 操作结果
+ */
+export async function deleteChildChunk(
+    datasetId: string,
+    documentId: string,
+    segmentId: string,
+    childChunkId: string
+): Promise<OperationResult> {
+    console.log('[Dataset Client] 删除子分段:', { datasetId, documentId, segmentId, childChunkId });
+
+    const response = await axios.delete<OperationResult>(
+        `${API_URL}/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks/${childChunkId}`,
+        { withCredentials: true }
+    );
+    return response.data;
+}
+
+// ============================================================================
+// 检索 API
+// ============================================================================
+
+/**
+ * 检索知识库
+ * Dify API: POST /datasets/{dataset_id}/retrieve
+ *
+ * @param datasetId - 知识库 ID
+ * @param query - 检索关键词
+ * @param retrievalModel - 检索模型配置
+ * @returns 检索结果
+ */
+export async function retrieveDataset(
+    datasetId: string,
+    query: string,
+    retrievalModel?: RetrieveRequest['retrieval_model']
+): Promise<RetrieveResponse> {
+    console.log('[Dataset Client] 检索知识库:', { datasetId, query });
+
+    const requestBody: RetrieveRequest = {
+        query,
+        retrieval_model: retrievalModel,
+    };
+
+    const response = await axios.post<RetrieveResponse>(
+        `${API_URL}/datasets/${datasetId}/retrieve`,
+        requestBody,
+        {
+            headers: { 'Content-Type': 'application/json' },
+            withCredentials: true,
+        }
+    );
+    return response.data;
+}
@@ -0,0 +1,84 @@
+/**
+ * Dify Dataset 服务端 API 模块
+ *
+ * 提供 Node.js 服务端调用 FastAPI 后端的基础功能
+ * Dify 的 DATASET_API_KEY 由 FastAPI 后端管理，前端只负责转发请求
+ *
+ * 调用链路：
+ * Remix Server → FastAPI /dify_dataset/* → Dify Knowledge API
+ *
+ * @module api/dify-dataset/client.server
+ */
+
+import { API_BASE_URL } from '~/config/api-config';
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+/**
+ * Dify Dataset API 代理地址
+ * 通过 FastAPI 后端的 /dify_dataset 路由代理访问 Dify Knowledge API
+ * Dify 的认证（DATASET_API_KEY）由 FastAPI 后端处理
+ */
+const DIFY_DATASET_API_URL = `${API_BASE_URL}/dify_dataset`;
+
+// ============================================================================
+// 基础请求函数
+// ============================================================================
+
+/**
+ * Dify Dataset API 基础请求函数
+ *
+ * 使用用户 JWT 认证通过 FastAPI 代理访问 Dify Knowledge API
+ * FastAPI 后端会验证 JWT 并添加 Dify DATASET_API_KEY
+ *
+ * @param endpoint - API 端点路径
+ * @param options - fetch 请求选项
+ * @param jwt - 用户 JWT 认证令牌
+ * @returns Response 对象
+ */
+export async function difyDatasetFetch(
+    endpoint: string,
+    options: RequestInit = {},
+    jwt?: string
+): Promise<Response> {
+    const url = `${DIFY_DATASET_API_URL}/${endpoint.replace(/^\//, '')}`;
+
+    const headers: HeadersInit = {
+        ...options.headers,
+    };
+
+    // 如果不是 FormData，设置 Content-Type 为 JSON
+    if (!(options.body instanceof FormData)) {
+        (headers as Record<string, string>)['Content-Type'] = 'application/json';
+    }
+
+    if (jwt) {
+        (headers as Record<string, string>)['Authorization'] = `Bearer ${jwt}`;
+    } else {
+        console.warn('[Dify Dataset] 没有提供 JWT，FastAPI 请求可能失败');
+    }
+
+    const response = await fetch(url, {
+        ...options,
+        headers,
+    });
+
+    if (!response.ok) {
+        const errorText = await response.text();
+        console.error('[Dify Dataset] API 转发错误:', {
+            status: response.status,
+            statusText: response.statusText,
+            error: errorText
+        });
+
+        if (response.status === 401) {
+            throw new Error('JWT认证失败，请重新登录');
+        }
+
+        throw new Error(`Dify Dataset API Error: ${response.status} ${response.statusText}`);
+    }
+
+    return response;
+}
@@ -1,36 +1,16 @@
 /**
- * Dify Dataset API 模块统一导出
+ * Dify Dataset API 模块
+ *
+ * 推荐直接从子包导入：
+ * - 类型：import type { ... } from '~/api/dify-dataset/type'
+ * - API：import { ... } from '~/api/dify-dataset/api'
+ * - 服务端：import { ... } from '~/api/dify-dataset/client.server'
 *
 * @module api/dify-dataset
 */

-// 类型导出
-export type {
-    Dataset,
-    DatasetsResponse,
-    Document,
-    DocumentsResponse,
-    Segment,
-    SegmentsResponse,
-    IndexingStatus,
-    OperationResult,
-    CreateDocumentResponse,
-    UploadProgress,
-} from './types';
+// 类型子包重新导出
+export * from './type';

-// 客户端 API 导出
-export {
-    // 知识库
-    fetchDatasets,
-    fetchDataset,
-    // 文档
-    fetchDocuments,
-    fetchDocument,
-    deleteDocument,
-    toggleDocumentStatus,
-    uploadDocument,
-    // 分段
-    fetchSegments,
-    deleteSegment,
-    toggleSegmentStatus,
-} from './client';
+// API 子包重新导出
+export * from './api';
@@ -0,0 +1,13 @@
+/**
+ * Dify Dataset API 通用类型定义
+ *
+ * @module api/dify-dataset/type/commonTypes
+ */
+
+/**
+ * 通用操作结果
+ */
+export interface OperationResult {
+    result: 'success' | 'error';
+    message?: string;
+}
@@ -0,0 +1,66 @@
+/**
+ * Dify Dataset API 知识库类型定义
+ *
+ * @module api/dify-dataset/type/datasetTypes
+ */
+
+/**
+ * 知识库信息
+ */
+export interface Dataset {
+    id: string;
+    name: string;
+    description: string;
+    permission: 'only_me' | 'all_team_members';
+    data_source_type: 'upload_file' | 'notion_import' | 'website_crawl';
+    indexing_technique: 'high_quality' | 'economy';
+    app_count: number;
+    document_count: number;
+    word_count: number;
+    created_by: string;
+    created_at: number;
+    updated_by: string;
+    updated_at: number;
+}
+
+/**
+ * 知识库列表响应
+ */
+export interface DatasetsResponse {
+    data: Dataset[];
+    has_more: boolean;
+    limit: number;
+    total: number;
+    page: number;
+}
+
+/**
+ * 检索模型配置
+ */
+export interface RetrievalModel {
+    search_method: 'keyword_search' | 'semantic_search' | 'full_text_search' | 'hybrid_search';
+    reranking_enable?: boolean;
+    reranking_mode?: string | null;
+    reranking_model?: {
+        reranking_provider_name: string;
+        reranking_model_name: string;
+    };
+    weights?: number | null;
+    top_k?: number;
+    score_threshold_enabled?: boolean;
+    score_threshold?: number | null;
+}
+
+/**
+ * 更新知识库请求参数
+ */
+export interface UpdateDatasetRequest {
+    name?: string;
+    description?: string;
+    indexing_technique?: 'high_quality' | 'economy';
+    permission?: 'only_me' | 'all_team_members' | 'partial_members';
+    embedding_model_provider?: string;
+    embedding_model?: string;
+    retrieval_model?: RetrievalModel;
+    partial_member_list?: string[];
+}
@@ -0,0 +1,116 @@
+/**
+ * Dify Dataset API 文档类型定义
+ *
+ * @module api/dify-dataset/type/documentTypes
+ */
+
+/**
+ * 文档索引状态
+ */
+export type IndexingStatus =
+    | 'waiting'
+    | 'parsing'
+    | 'cleaning'
+    | 'splitting'
+    | 'indexing'
+    | 'paused'
+    | 'error'
+    | 'completed';
+
+/**
+ * 文档信息
+ */
+export interface Document {
+    id: string;
+    position: number;
+    data_source_type: 'upload_file' | 'notion_import' | 'website_crawl';
+    data_source_info: {
+        upload_file_id?: string;
+        notion_page_id?: string;
+        website_url?: string;
+    };
+    dataset_process_rule_id: string;
+    name: string;
+    created_from: string;
+    created_by: string;
+    created_at: number;
+    tokens: number;
+    indexing_status: IndexingStatus;
+    error?: string;
+    enabled: boolean;
+    disabled_at?: number;
+    disabled_by?: string;
+    archived: boolean;
+    display_status: string;
+    word_count: number;
+    hit_count: number;
+    doc_form: string;
+}
+
+/**
+ * 文档列表响应
+ */
+export interface DocumentsResponse {
+    data: Document[];
+    has_more: boolean;
+    limit: number;
+    total: number;
+    page: number;
+}
+
+/**
+ * 创建文档响应
+ */
+export interface CreateDocumentResponse {
+    document: Document;
+    batch: string;
+}
+
+/**
+ * 文档上传进度
+ */
+export interface UploadProgress {
+    loaded: number;
+    total: number;
+    percent: number;
+}
+
+/**
+ * 单个文档的索引状态
+ */
+export interface DocumentIndexingStatus {
+    id: string;
+    indexing_status: IndexingStatus;
+    processing_started_at: number | null;
+    parsing_completed_at: number | null;
+    cleaning_completed_at: number | null;
+    splitting_completed_at: number | null;
+    completed_at: number | null;
+    paused_at: number | null;
+    error: string | null;
+    stopped_at: number | null;
+    completed_segments: number;
+    total_segments: number;
+}
+
+/**
+ * 批量文档索引状态响应
+ */
+export interface IndexingStatusResponse {
+    data: DocumentIndexingStatus[];
+}
+
+/**
+ * 上传文件信息
+ */
+export interface UploadFileInfo {
+    id: string;
+    name: string;
+    size: number;
+    extension: string;
+    url: string;
+    download_url: string;
+    mime_type: string;
+    created_by: string;
+    created_at: number;
+}
@@ -0,0 +1,47 @@
+/**
+ * Dify Dataset API 类型定义统一导出
+ *
+ * @module api/dify-dataset/type
+ */
+
+// 通用类型
+export type { OperationResult } from './commonTypes';
+
+// 知识库类型
+export type {
+    Dataset,
+    DatasetsResponse,
+    RetrievalModel,
+    UpdateDatasetRequest,
+} from './datasetTypes';
+
+// 文档类型
+export type {
+    IndexingStatus,
+    Document,
+    DocumentsResponse,
+    CreateDocumentResponse,
+    UploadProgress,
+    DocumentIndexingStatus,
+    IndexingStatusResponse,
+    UploadFileInfo,
+} from './documentTypes';
+
+// 分段、子分段、检索类型
+export type {
+    Segment,
+    SegmentsResponse,
+    CreateSegmentRequest,
+    UpdateSegmentRequest,
+    CreateSegmentsResponse,
+    ChildChunk,
+    ChildChunksResponse,
+    CreateChildChunkRequest,
+    UpdateChildChunkRequest,
+    CreateChildChunkResponse,
+    MetadataFilterCondition,
+    MetadataFilteringConditions,
+    RetrieveRequest,
+    RetrieveRecord,
+    RetrieveResponse,
+} from './segmentTypes';
@@ -0,0 +1,191 @@
+/**
+ * Dify Dataset API 分段、子分段、检索类型定义
+ *
+ * @module api/dify-dataset/type/segmentTypes
+ */
+
+// ============================================================================
+// 分段类型
+// ============================================================================
+
+/**
+ * 文档分段
+ */
+export interface Segment {
+    id: string;
+    position: number;
+    document_id: string;
+    content: string;
+    answer?: string;
+    word_count: number;
+    tokens: number;
+    keywords: string[];
+    index_node_id: string;
+    index_node_hash: string;
+    hit_count: number;
+    enabled: boolean;
+    disabled_at?: number;
+    disabled_by?: string;
+    status: 'waiting' | 'completed' | 'error' | 'indexing';
+    created_by: string;
+    created_at: number;
+    indexing_at?: number;
+    completed_at?: number;
+    error?: string;
+    stopped_at?: number;
+}
+
+/**
+ * 分段列表响应
+ */
+export interface SegmentsResponse {
+    data: Segment[];
+    has_more: boolean;
+    limit: number;
+    total: number;
+}
+
+/**
+ * 创建分段请求参数
+ */
+export interface CreateSegmentRequest {
+    content: string;
+    answer?: string;
+    keywords?: string[];
+}
+
+/**
+ * 更新分段请求参数
+ */
+export interface UpdateSegmentRequest {
+    content?: string;
+    answer?: string;
+    keywords?: string[];
+    enabled?: boolean;
+}
+
+/**
+ * 创建分段响应
+ */
+export interface CreateSegmentsResponse {
+    data: Segment[];
+    doc_form: string;
+}
+
+// ============================================================================
+// 子分段类型（父子模式）
+// ============================================================================
+
+/**
+ * 子分段信息
+ */
+export interface ChildChunk {
+    id: string;
+    segment_id: string;
+    content: string;
+    word_count: number;
+    tokens: number;
+    index_node_id: string;
+    index_node_hash: string;
+    hit_count: number;
+    created_by: string;
+    created_at: number;
+    updated_by?: string;
+    updated_at?: number;
+    status: 'waiting' | 'completed' | 'error' | 'indexing';
+    error?: string;
+}
+
+/**
+ * 子分段列表响应
+ */
+export interface ChildChunksResponse {
+    data: ChildChunk[];
+    has_more: boolean;
+    limit: number;
+    total: number;
+    page: number;
+}
+
+/**
+ * 创建子分段请求参数
+ */
+export interface CreateChildChunkRequest {
+    content: string;
+}
+
+/**
+ * 更新子分段请求参数
+ */
+export interface UpdateChildChunkRequest {
+    content: string;
+}
+
+/**
+ * 创建子分段响应
+ */
+export interface CreateChildChunkResponse {
+    data: ChildChunk;
+}
+
+// ============================================================================
+// 检索功能类型
+// ============================================================================
+
+/**
+ * 元数据过滤条件
+ */
+export interface MetadataFilterCondition {
+    name: string;
+    comparison_operator: 'contains' | 'not contains' | 'start with' | 'end with' | 'is' | 'is not' | 'empty' | 'not empty' | 'before' | 'after' | '=' | '!=' | '>' | '<' | '>=' | '<=';
+    value?: string | number;
+}
+
+/**
+ * 元数据过滤条件组
+ */
+export interface MetadataFilteringConditions {
+    logical_operator: 'and' | 'or';
+    conditions: MetadataFilterCondition[];
+}
+
+/**
+ * 检索请求参数
+ */
+export interface RetrieveRequest {
+    query: string;
+    retrieval_model?: {
+        search_method: 'keyword_search' | 'semantic_search' | 'full_text_search' | 'hybrid_search';
+        reranking_enable?: boolean;
+        reranking_model?: {
+            reranking_provider_name: string;
+            reranking_model_name: string;
+        };
+        top_k?: number;
+        score_threshold_enabled?: boolean;
+        score_threshold?: number;
+    };
+    metadata_filtering_conditions?: MetadataFilteringConditions;
+}
+
+/**
+ * 检索结果记录
+ */
+export interface RetrieveRecord {
+    segment: Segment;
+    score: number;
+    tsne_position?: {
+        x: number;
+        y: number;
+    };
+}
+
+/**
+ * 检索响应
+ */
+export interface RetrieveResponse {
+    query: {
+        content: string;
+    };
+    records: RetrieveRecord[];
+}
@@ -1,167 +0,0 @@
-/**
- * Dify Dataset API 类型定义
- *
- * @module api/dify-dataset/types
- */
-
-// ============================================================================
-// 知识库类型
-// ============================================================================
-
-/**
- * 知识库信息
- */
-export interface Dataset {
-    id: string;
-    name: string;
-    description: string;
-    permission: 'only_me' | 'all_team_members';
-    data_source_type: 'upload_file' | 'notion_import' | 'website_crawl';
-    indexing_technique: 'high_quality' | 'economy';
-    app_count: number;
-    document_count: number;
-    word_count: number;
-    created_by: string;
-    created_at: number;
-    updated_by: string;
-    updated_at: number;
-}
-
-/**
- * 知识库列表响应
- */
-export interface DatasetsResponse {
-    data: Dataset[];
-    has_more: boolean;
-    limit: number;
-    total: number;
-    page: number;
-}
-
-// ============================================================================
-// 文档类型
-// ============================================================================
-
-/**
- * 文档索引状态
- */
-export type IndexingStatus =
-    | 'waiting'
-    | 'parsing'
-    | 'cleaning'
-    | 'splitting'
-    | 'indexing'
-    | 'paused'
-    | 'error'
-    | 'completed';
-
-/**
- * 文档信息
- */
-export interface Document {
-    id: string;
-    position: number;
-    data_source_type: 'upload_file' | 'notion_import' | 'website_crawl';
-    data_source_info: {
-        upload_file_id?: string;
-        notion_page_id?: string;
-        website_url?: string;
-    };
-    dataset_process_rule_id: string;
-    name: string;
-    created_from: string;
-    created_by: string;
-    created_at: number;
-    tokens: number;
-    indexing_status: IndexingStatus;
-    error?: string;
-    enabled: boolean;
-    disabled_at?: number;
-    disabled_by?: string;
-    archived: boolean;
-    display_status: string;
-    word_count: number;
-    hit_count: number;
-    doc_form: string;
-}
-
-/**
- * 文档列表响应
- */
-export interface DocumentsResponse {
-    data: Document[];
-    has_more: boolean;
-    limit: number;
-    total: number;
-    page: number;
-}
-
-// ============================================================================
-// 文档分段类型
-// ============================================================================
-
-/**
- * 文档分段
- */
-export interface Segment {
-    id: string;
-    position: number;
-    document_id: string;
-    content: string;
-    answer?: string;
-    word_count: number;
-    tokens: number;
-    keywords: string[];
-    index_node_id: string;
-    index_node_hash: string;
-    hit_count: number;
-    enabled: boolean;
-    disabled_at?: number;
-    disabled_by?: string;
-    status: 'waiting' | 'completed' | 'error' | 'indexing';
-    created_by: string;
-    created_at: number;
-    indexing_at?: number;
-    completed_at?: number;
-    error?: string;
-    stopped_at?: number;
-}
-
-/**
- * 分段列表响应
- */
-export interface SegmentsResponse {
-    data: Segment[];
-    has_more: boolean;
-    limit: number;
-    total: number;
-}
-
-// ============================================================================
-// 操作响应类型
-// ============================================================================
-
-/**
- * 通用操作结果
- */
-export interface OperationResult {
-    result: 'success' | 'error';
-    message?: string;
-}
-
-/**
- * 创建文档响应
- */
-export interface CreateDocumentResponse {
-    document: Document;
-    batch: string;
-}
-
-/**
- * 文档上传进度
- */
-export interface UploadProgress {
-    loaded: number;
-    total: number;
-    percent: number;
-}
@@ -0,0 +1,187 @@
+import { useState, useEffect } from 'react';
+import { Form, Input, Button, Card, message, Spin } from 'antd';
+import { SaveOutlined } from '@ant-design/icons';
+import type { Dataset } from '~/api/dify-dataset/type/datasetTypes';
+import { updateDatasetName } from '~/api/dify-dataset/api/datasetApi';
+
+const { TextArea } = Input;
+
+interface DatasetSettingsProps {
+    dataset: Dataset | null;
+    onDatasetUpdated: (dataset: Dataset) => void;
+}
+
+/**
+ * 知识库设置组件
+ * 用于修改知识库名称和描述
+ */
+export default function DatasetSettings({
+    dataset,
+    onDatasetUpdated,
+}: DatasetSettingsProps) {
+    const [form] = Form.useForm();
+    const [saving, setSaving] = useState(false);
+    const [hasChanges, setHasChanges] = useState(false);
+
+    // 初始化表单数据
+    useEffect(() => {
+        if (dataset) {
+            form.setFieldsValue({
+                name: dataset.name,
+                description: dataset.description || '',
+            });
+            setHasChanges(false);
+        }
+    }, [dataset, form]);
+
+    /**
+     * 处理表单值变化
+     */
+    const handleValuesChange = () => {
+        const values = form.getFieldsValue();
+        const changed =
+            values.name !== dataset?.name ||
+            values.description !== (dataset?.description || '');
+        setHasChanges(changed);
+    };
+
+    /**
+     * 保存设置
+     */
+    const handleSave = async () => {
+        if (!dataset) {
+            message.error('知识库不存在');
+            return;
+        }
+
+        try {
+            const values = await form.validateFields();
+            setSaving(true);
+
+            // 目前只支持修改名称
+            const updatedDataset = await updateDatasetName(dataset.id, values.name);
+
+            message.success('保存成功');
+            onDatasetUpdated(updatedDataset);
+            setHasChanges(false);
+        } catch (err: any) {
+            console.error('保存设置失败:', err);
+            message.error(err.message || '保存失败');
+        } finally {
+            setSaving(false);
+        }
+    };
+
+    /**
+     * 重置表单
+     */
+    const handleReset = () => {
+        if (dataset) {
+            form.setFieldsValue({
+                name: dataset.name,
+                description: dataset.description || '',
+            });
+            setHasChanges(false);
+        }
+    };
+
+    if (!dataset) {
+        return (
+            <div className="settings-loading">
+                <Spin size="large" />
+            </div>
+        );
+    }
+
+    return (
+        <div className="dataset-settings-page">
+            {/* 页面标题 */}
+            <div className="page-header">
+                <h1>设置</h1>
+                <p className="page-description">
+                    管理知识库的基本信息
+                </p>
+            </div>
+
+            {/* 设置表单 */}
+            <Card className="settings-card">
+                <Form
+                    form={form}
+                    layout="vertical"
+                    onValuesChange={handleValuesChange}
+                >
+                    <Form.Item
+                        name="name"
+                        label="知识库名称"
+                        rules={[
+                            { required: true, message: '请输入知识库名称' },
+                            { max: 100, message: '名称不能超过100个字符' },
+                        ]}
+                    >
+                        <Input placeholder="请输入知识库名称" maxLength={100} />
+                    </Form.Item>
+
+                    <Form.Item
+                        name="description"
+                        label="知识库描述"
+                        extra="描述知识库的用途和内容（仅展示，暂不支持修改）"
+                    >
+                        <TextArea
+                            placeholder="请输入知识库描述"
+                            rows={4}
+                            maxLength={500}
+                            showCount
+                            disabled
+                        />
+                    </Form.Item>
+
+                    {/* 只读信息 */}
+                    <div className="readonly-info">
+                        <div className="info-item">
+                            <span className="info-label">索引方式：</span>
+                            <span className="info-value">
+                                {dataset.indexing_technique === 'high_quality' ? '高质量' : '经济'}
+                            </span>
+                        </div>
+                        {/* <div className="info-item">
+                            <span className="info-label">Embedding 模型：</span>
+                            <span className="info-value">
+                                {dataset.embedding_model || '默认模型'}
+                            </span>
+                        </div> */}
+                        <div className="info-item">
+                            <span className="info-label">文档数量：</span>
+                            <span className="info-value">{dataset.document_count}</span>
+                        </div>
+                        <div className="info-item">
+                            <span className="info-label">总字符数：</span>
+                            <span className="info-value">{dataset.word_count?.toLocaleString()}</span>
+                        </div>
+                        <div className="info-item">
+                            <span className="info-label">创建时间：</span>
+                            <span className="info-value">
+                                {new Date(dataset.created_at * 1000).toLocaleString('zh-CN')}
+                            </span>
+                        </div>
+                    </div>
+
+                    {/* 操作按钮 */}
+                    <div className="form-actions">
+                        <Button onClick={handleReset} disabled={!hasChanges}>
+                            重置
+                        </Button>
+                        <Button
+                            type="primary"
+                            icon={<SaveOutlined />}
+                            onClick={handleSave}
+                            loading={saving}
+                            disabled={!hasChanges}
+                        >
+                            保存
+                        </Button>
+                    </div>
+                </Form>
+            </Card>
+        </div>
+    );
+}
@@ -0,0 +1,367 @@
+import { useState, useEffect } from 'react';
+import {
+    Input,
+    Button,
+    InputNumber,
+    Checkbox,
+    Select,
+    Card,
+    Empty,
+    Spin,
+    message,
+    Divider,
+    Tooltip,
+} from 'antd';
+import {
+    QuestionCircleOutlined,
+    ReloadOutlined,
+    EyeOutlined,
+} from '@ant-design/icons';
+import type { Document } from '~/api/dify-dataset/type/documentTypes';
+import type { Segment } from '~/api/dify-dataset/type';
+import { fetchSegments } from '~/api/dify-dataset/api/segmentApi';
+import { updateDocumentWithSettings } from '~/api/dify-dataset/api/documentApi';
+
+interface DocumentDetailProps {
+    datasetId: string;
+    document: Document | null;
+}
+
+/**
+ * 分段设置配置
+ * 注意：Dify API 支持的参数有限
+ * - separator: ✅ 支持
+ * - maxTokens: ✅ 支持
+ * - removeExtraSpaces: ✅ 支持
+ * - removeUrlsEmails: ✅ 支持
+ * - useQASegment: ⚠️ 需要 doc_form: "qa_model"
+ */
+interface SegmentationSettings {
+    separator: string;
+    maxTokens: number;
+    removeExtraSpaces: boolean;
+    removeUrlsEmails: boolean;
+    useQASegment: boolean;
+    qaLanguage: string;
+}
+
+/**
+ * 默认分段设置
+ */
+const DEFAULT_SETTINGS: SegmentationSettings = {
+    separator: '\\n\\n',
+    maxTokens: 500,
+    removeExtraSpaces: true,
+    removeUrlsEmails: false,
+    useQASegment: false,
+    qaLanguage: 'Chinese',
+};
+
+/**
+ * 文档详情组件
+ * 显示文档的分段设置，支持修改并重新处理
+ */
+export default function DocumentDetail({
+    datasetId,
+    document,
+}: DocumentDetailProps) {
+    // 分段设置状态
+    const [settings, setSettings] = useState<SegmentationSettings>(DEFAULT_SETTINGS);
+
+    // 预览状态
+    const [previewSegments, setPreviewSegments] = useState<Segment[]>([]);
+    const [previewLoading, setPreviewLoading] = useState(false);
+    const [showPreview, setShowPreview] = useState(false);
+
+    // 保存状态
+    const [saving, setSaving] = useState(false);
+
+    // 当文档变化时重置设置
+    useEffect(() => {
+        if (document) {
+            // 可以从文档中读取已有的设置，这里使用默认值
+            setSettings(DEFAULT_SETTINGS);
+            setPreviewSegments([]);
+            setShowPreview(false);
+        }
+    }, [document?.id]);
+
+    /**
+     * 更新设置
+     */
+    const updateSettings = (key: keyof SegmentationSettings, value: any) => {
+        setSettings(prev => ({ ...prev, [key]: value }));
+    };
+
+    /**
+     * 重置设置
+     */
+    const handleReset = () => {
+        setSettings(DEFAULT_SETTINGS);
+        setPreviewSegments([]);
+        setShowPreview(false);
+    };
+
+    /**
+     * 预览分段
+     */
+    const handlePreview = async () => {
+        if (!document) return;
+
+        setPreviewLoading(true);
+        setShowPreview(true);
+        try {
+            // 获取当前文档的分段作为预览
+            const response = await fetchSegments(datasetId, document.id, 1, 50);
+            setPreviewSegments(response.data || []);
+            if (response.data?.length === 0) {
+                message.info('该文档暂无分段数据');
+            }
+        } catch (err: any) {
+            console.error('预览分段失败:', err);
+            message.error(err.message || '预览失败');
+        } finally {
+            setPreviewLoading(false);
+        }
+    };
+
+    /**
+     * 保存并处理
+     */
+    const handleSaveAndProcess = async () => {
+        if (!document) return;
+
+        setSaving(true);
+        try {
+            await updateDocumentWithSettings(datasetId, document.id, {
+                indexing_technique: 'high_quality',
+                process_rule: {
+                    mode: 'custom',
+                    rules: {
+                        pre_processing_rules: [
+                            { id: 'remove_extra_spaces', enabled: settings.removeExtraSpaces },
+                            { id: 'remove_urls_emails', enabled: settings.removeUrlsEmails },
+                        ],
+                        segmentation: {
+                            separator: settings.separator.replace(/\\n/g, '\n'),
+                            max_tokens: settings.maxTokens,
+                        },
+                    },
+                },
+            });
+            message.success('设置已保存，文档正在重新处理...');
+        } catch (err: any) {
+            console.error('保存设置失败:', err);
+            message.error(err.message || '保存失败');
+        } finally {
+            setSaving(false);
+        }
+    };
+
+    if (!document) {
+        return (
+            <div className="document-detail-empty">
+                <Empty description="请选择一个文档" />
+            </div>
+        );
+    }
+
+    return (
+        <div className="document-detail-page">
+            <div className="document-detail-content">
+                {/* 左侧设置区域 */}
+                <div className="settings-panel">
+                    {/* 分段设置 */}
+                    <div className="settings-section">
+                        <h3 className="section-title">分段设置</h3>
+
+                        {/* 分块模式 */}
+                        <div className="setting-item mode-selector">
+                            <div className="mode-option active">
+                                <div className="mode-icon">
+                                    <i className="ri-text-spacing"></i>
+                                </div>
+                                <div className="mode-info">
+                                    <span className="mode-name">通用</span>
+                                    <span className="mode-desc">通用文本分块模式，检索和召回的块是相同的</span>
+                                </div>
+                            </div>
+                        </div>
+
+                        {/* 分段标识符 */}
+                        <div className="setting-item">
+                            <label className="setting-label">
+                                分段标识符
+                                <Tooltip title="系统会在遇到指定分隔符时自动分段，默认值为 \n\n（按段落分段）">
+                                    <QuestionCircleOutlined className="help-icon" />
+                                </Tooltip>
+                            </label>
+                            <Input
+                                value={settings.separator}
+                                onChange={(e) => updateSettings('separator', e.target.value)}
+                                placeholder="\n\n"
+                                className="setting-input"
+                            />
+                        </div>
+
+                        {/* 分段最大长度 */}
+                        <div className="setting-item">
+                            <label className="setting-label">
+                                分段最大长度
+                                <Tooltip title="指定每个分段允许的最大字符数，超过此限制系统会强制分段">
+                                    <QuestionCircleOutlined className="help-icon" />
+                                </Tooltip>
+                            </label>
+                            <div className="setting-input-with-suffix">
+                                <InputNumber
+                                    value={settings.maxTokens}
+                                    onChange={(value) => updateSettings('maxTokens', value || 500)}
+                                    min={100}
+                                    max={4000}
+                                    className="setting-input-number"
+                                />
+                                <span className="input-suffix">characters</span>
+                            </div>
+                        </div>
+                    </div>
+
+                    <Divider />
+
+                    {/* 文本预处理规则 */}
+                    <div className="settings-section">
+                        <h3 className="section-title">文本预处理规则</h3>
+
+                        <div className="checkbox-group">
+                            <Checkbox
+                                checked={settings.removeExtraSpaces}
+                                onChange={(e) => updateSettings('removeExtraSpaces', e.target.checked)}
+                            >
+                                替换掉连续的空格、换行符和制表符
+                            </Checkbox>
+
+                            <Checkbox
+                                checked={settings.removeUrlsEmails}
+                                onChange={(e) => updateSettings('removeUrlsEmails', e.target.checked)}
+                            >
+                                删除所有 URL 和电子邮件地址
+                            </Checkbox>
+                        </div>
+                    </div>
+
+                    <Divider />
+
+                    {/* Q&A 分段 */}
+                    <div className="settings-section">
+                        <div className="qa-segment-row">
+                            <Checkbox
+                                checked={settings.useQASegment}
+                                onChange={(e) => updateSettings('useQASegment', e.target.checked)}
+                            >
+                                使用 Q&A 分段，语言
+                            </Checkbox>
+                            <Select
+                                value={settings.qaLanguage}
+                                onChange={(value) => updateSettings('qaLanguage', value)}
+                                disabled={!settings.useQASegment}
+                                style={{ width: 120 }}
+                                options={[
+                                    { value: 'Chinese', label: 'Chinese' },
+                                    { value: 'English', label: 'English' },
+                                    { value: 'Japanese', label: 'Japanese' },
+                                    { value: 'Korean', label: 'Korean' },
+                                ]}
+                            />
+                        </div>
+                    </div>
+
+                    {/* 操作按钮 */}
+                    <div className="settings-actions">
+                        <Button
+                            icon={<EyeOutlined />}
+                            onClick={handlePreview}
+                            loading={previewLoading}
+                        >
+                            预览块
+                        </Button>
+                        <Button
+                            icon={<ReloadOutlined />}
+                            onClick={handleReset}
+                        >
+                            重置
+                        </Button>
+                    </div>
+
+                    <Divider />
+
+                    {/* 保存并处理按钮 */}
+                    <div className="save-actions">
+                        <Button
+                            type="primary"
+                            onClick={handleSaveAndProcess}
+                            loading={saving}
+                            block
+                        >
+                            保存并处理
+                        </Button>
+                        <Button block style={{ marginTop: 8 }}>
+                            取消
+                        </Button>
+                    </div>
+                </div>
+
+                {/* 右侧预览区域 */}
+                <div className="preview-panel">
+                    <Card
+                        title={
+                            <div className="preview-header">
+                                <span>预览</span>
+                                <Select
+                                    value={document.name}
+                                    style={{ width: 200 }}
+                                    disabled
+                                    options={[{ value: document.name, label: document.name }]}
+                                />
+                                <span className="segment-count">
+                                    {showPreview ? `${previewSegments.length} 段块` : '0 段块'}
+                                </span>
+                            </div>
+                        }
+                        className="preview-card"
+                    >
+                        {previewLoading ? (
+                            <div className="preview-loading">
+                                <Spin size="large" />
+                                <div className="loading-text">加载中...</div>
+                            </div>
+                        ) : !showPreview ? (
+                            <div className="preview-empty">
+                                <div className="empty-icon">
+                                    <EyeOutlined />
+                                </div>
+                                <p>点击左侧的"预览块"按钮来预览</p>
+                            </div>
+                        ) : previewSegments.length === 0 ? (
+                            <Empty description="暂无分段数据" />
+                        ) : (
+                            <div className="preview-segments">
+                                {previewSegments.map((segment, index) => (
+                                    <div key={segment.id} className="segment-item">
+                                        <div className="segment-header">
+                                            <span className="segment-index">#{index + 1}</span>
+                                            <span className="segment-chars">
+                                                {segment.word_count} 字符
+                                            </span>
+                                        </div>
+                                        <div className="segment-content">
+                                            {segment.content}
+                                        </div>
+                                    </div>
+                                ))}
+                            </div>
+                        )}
+                    </Card>
+                </div>
+            </div>
+        </div>
+    );
+}
@@ -27,9 +27,9 @@ import {
    PauseCircleOutlined,
 } from '@ant-design/icons';
 import type { ColumnsType } from 'antd/es/table';
-import type { Document, IndexingStatus } from '~/api/dify-dataset';
-import { deleteDocument, toggleDocumentStatus, uploadDocument } from '~/api/dify-dataset';
-import '../../styles/components/dify-dataset-manager/document-list.css';
+import type { Document, IndexingStatus } from '~/api/dify-dataset/type/documentTypes';
+import { deleteDocument, toggleDocumentStatus, uploadDocument } from '~/api/dify-dataset/api/documentApi';
+import '../../styles/components/dify-dataset-manager/index.css';

 interface DocumentListProps {
    datasetId: string;
@@ -43,6 +43,7 @@ interface DocumentListProps {
    onDocumentDeleted: (documentId: string) => void;
    onDocumentStatusChanged: (documentId: string, enabled: boolean) => void;
    onRefresh: () => void;
+    onViewDocument?: (document: Document) => void;
 }

 /**
@@ -50,7 +51,6 @@ interface DocumentListProps {
 */
 export default function DocumentList({
    datasetId,
-    datasetName,
    documents,
    loading,
    total,
@@ -60,6 +60,7 @@ export default function DocumentList({
    onDocumentDeleted,
    onDocumentStatusChanged,
    onRefresh,
+    onViewDocument,
 }: DocumentListProps) {
    const [searchValue, setSearchValue] = useState('');
    const [uploading, setUploading] = useState(false);
@@ -238,15 +239,12 @@ export default function DocumentList({
            width: 120,
            render: (_, record) => (
                <Space size="small">
-                    <Tooltip title="查看详情">
+                    <Tooltip title="查看分段">
                        <Button
                            type="text"
                            size="small"
                            icon={<EyeOutlined />}
-                            onClick={() => {
-                                // TODO: 查看文档详情/分段
-                                message.info('功能开发中');
-                            }}
+                            onClick={() => onViewDocument?.(record)}
                        />
                    </Tooltip>
                    <Popconfirm
@@ -273,13 +271,16 @@ export default function DocumentList({
    ];

    return (
-        <div className="dataset-content">
-            {/* 头部区域 */}
-            <div className="dataset-header" style={{ marginBottom: 16, padding: 0, height: 'auto', border: 'none' }}>
-                <h1 style={{ margin: 0 }}>
-                    {datasetName || '请选择知识库'}
-                </h1>
-                <div className="dataset-header-actions">
+        <div className="document-list-page">
+            {/* 页面头部 */}
+            <div className="page-header">
+                <div className="header-left">
+                    <h1>文档</h1>
+                    {/* <p className="page-description">
+                        知识库的所有文件都在这里显示，整个知识库都可以被接到 Dify 引用或通过 Chat 插件进行索引。
+                    </p> */}
+                </div>
+                <div className="header-actions">
                    <Tooltip title="刷新">
                        <Button
                            icon={<ReloadOutlined />}
@@ -299,74 +300,85 @@ export default function DocumentList({
                            loading={uploading}
                            disabled={!datasetId}
                        >
-                            上传文档
+                            添加文件
                        </Button>
                    </Upload>
                </div>
            </div>

-            {/* 工具栏 */}
-            <div className="document-list-toolbar">
+            {/* 搜索栏 */}
+            <div className="document-search-bar">
                <Input
-                    className="document-list-search"
                    placeholder="搜索文档..."
                    prefix={<SearchOutlined />}
                    value={searchValue}
                    onChange={(e) => setSearchValue(e.target.value)}
                    allowClear
+                    style={{ width: 280 }}
                />
-                <div className="document-list-actions">
-                    <span className="text-gray-500 text-sm">
-                        共 {total} 个文档
-                    </span>
-                </div>
            </div>

            {/* 文档表格 */}
-            {!datasetId ? (
-                <div className="dataset-empty">
-                    <Empty description="请先选择一个知识库" />
+            <div className="document-table-wrapper">
+                {loading && documents.length === 0 ? (
+                    <div className="loading-state">
+                        <Spin size="large" />
+                        <div className="loading-text">加载中...</div>
+                    </div>
+                ) : filteredDocuments.length === 0 ? (
+                    <div className="empty-state">
+                        <Empty description={searchValue ? '未找到匹配的文档' : '暂无文档'}>
+                            {!searchValue && (
+                                <Upload
+                                    beforeUpload={handleUpload}
+                                    showUploadList={false}
+                                    accept=".txt,.md,.pdf,.docx,.doc,.csv,.xlsx,.xls"
+                                >
+                                    <Button type="primary" icon={<CloudUploadOutlined />}>
+                                        上传第一个文档
+                                    </Button>
+                                </Upload>
+                            )}
+                        </Empty>
+                    </div>
+                ) : (
+                    <Table
+                        className="document-table"
+                        columns={columns}
+                        dataSource={filteredDocuments}
+                        rowKey="id"
+                        loading={loading}
+                        pagination={false}
+                        size="small"
+                        scroll={{ x: 'max-content' }}
+                    />
+                )}
+            </div>
+
+            {/* 底部分页器 */}
+            {filteredDocuments.length > 0 && (
+                <div className="document-pagination">
+                    <span className="pagination-total">共 {total} 条</span>
+                    <div className="pagination-controls">
+                        <Button
+                            size="small"
+                            disabled={page <= 1}
+                            onClick={() => onPageChange(page - 1)}
+                        >
+                            上一页
+                        </Button>
+                        <span className="pagination-info">
+                            第 {page} 页 / 共 {Math.ceil(total / pageSize)} 页
+                        </span>
+                        <Button
+                            size="small"
+                            disabled={page >= Math.ceil(total / pageSize)}
+                            onClick={() => onPageChange(page + 1)}
+                        >
+                            下一页
+                        </Button>
+                    </div>
                </div>
-            ) : loading && documents.length === 0 ? (
-                <div className="dataset-loading">
-                    <Spin size="large" />
-                    <span className="text-gray-500">加载中...</span>
-                </div>
-            ) : filteredDocuments.length === 0 ? (
-                <div className="dataset-empty">
-                    <Empty
-                        description={searchValue ? '未找到匹配的文档' : '暂无文档'}
-                    >
-                        {!searchValue && (
-                            <Upload
-                                beforeUpload={handleUpload}
-                                showUploadList={false}
-                                accept=".txt,.md,.pdf,.docx,.doc,.csv,.xlsx,.xls"
-                            >
-                                <Button type="primary" icon={<CloudUploadOutlined />}>
-                                    上传第一个文档
-                                </Button>
-                            </Upload>
-                        )}
-                    </Empty>
-                </div>
-            ) : (
-                <Table
-                    className="document-table"
-                    columns={columns}
-                    dataSource={filteredDocuments}
-                    rowKey="id"
-                    loading={loading}
-                    pagination={{
-                        current: page,
-                        pageSize: pageSize,
-                        total: total,
-                        onChange: onPageChange,
-                        showSizeChanger: false,
-                        showTotal: (total) => `共 ${total} 条`,
-                    }}
-                    size="middle"
-                />
            )}
        </div>
    );
@@ -1,30 +1,24 @@
-import { Layout, theme, message } from 'antd';
 import { useEffect, useState } from 'react';
-import DatasetSidebar from './sidebar';
+import { message, Spin } from 'antd';
+import DatasetLayout, { type MenuTab } from './layout';
 import DocumentList from './document-list';
-import type { Dataset, Document } from '~/api/dify-dataset';
-import { fetchDatasets, fetchDocuments } from '~/api/dify-dataset';
+import DocumentDetail from './document-detail';
+import RetrieveTest from './retrieve-test';
+import DatasetSettings from './dataset-settings';
+import type { Dataset } from '~/api/dify-dataset/type/datasetTypes';
+import type { Document } from '~/api/dify-dataset/type/documentTypes';
+import { fetchDatasets } from '~/api/dify-dataset/api/datasetApi';
+import { fetchDocuments } from '~/api/dify-dataset/api/documentApi';
 import '../../styles/components/dify-dataset-manager/index.css';

-const { Content } = Layout;
-
 /**
 * 知识库管理主组件
+ * 带左侧菜单栏的完整布局
 */
 export default function DatasetManager() {
-    // 主题
-    const {
-        token: { colorBgContainer },
-    } = theme.useToken();
-
-    // 侧边栏状态
-    const [sidebarCollapsed, setSidebarCollapsed] = useState(false);
-    const [isMobile, setIsMobile] = useState(false);
-
    // 知识库状态
-    const [datasets, setDatasets] = useState<Dataset[]>([]);
-    const [currentDatasetId, setCurrentDatasetId] = useState<string>('');
-    const [loadingDatasets, setLoadingDatasets] = useState(true);
+    const [dataset, setDataset] = useState<Dataset | null>(null);
+    const [loadingDataset, setLoadingDataset] = useState(true);

    // 文档状态
    const [documents, setDocuments] = useState<Document[]>([]);
@@ -37,30 +31,36 @@ export default function DatasetManager() {
    const [inited, setInited] = useState(false);
    const [error, setError] = useState<string | null>(null);

+    // 菜单状态
+    const [activeTab, setActiveTab] = useState<MenuTab>('documents');
+
+    // 选中的文档（用于查看文档详情）
+    const [selectedDocument, setSelectedDocument] = useState<Document | null>(null);
+
    /**
-     * 加载知识库列表
+     * 加载知识库（获取第一个知识库）
     */
-    const loadDatasets = async () => {
-        setLoadingDatasets(true);
+    const loadDataset = async () => {
+        setLoadingDataset(true);
        try {
-            console.log('[DatasetManager] 加载知识库列表...');
-            const response = await fetchDatasets(1, 100);
-            console.log('[DatasetManager] 知识库列表响应:', response);
+            console.log('[DatasetManager] 加载知识库...');
+            const response = await fetchDatasets(1, 1);
+            console.log('[DatasetManager] 知识库响应:', response);

-            if (response && response.data) {
-                setDatasets(response.data);
-
-                // 如果有知识库，默认选中第一个
-                if (response.data.length > 0 && !currentDatasetId) {
-                    setCurrentDatasetId(response.data[0].id);
-                }
+            if (response && response.data && response.data.length > 0) {
+                const firstDataset = response.data[0];
+                setDataset(firstDataset);
+                // 立即加载文档
+                await loadDocuments(firstDataset.id, 1);
+            } else {
+                setError('未找到知识库，请先在Dify中创建知识库');
            }
        } catch (err: any) {
-            console.error('[DatasetManager] 加载知识库列表失败:', err);
-            setError(err.message || '加载知识库列表失败');
-            message.error('加载知识库列表失败');
+            console.error('[DatasetManager] 加载知识库失败:', err);
+            setError(err.message || '加载知识库失败');
+            message.error('加载知识库失败');
        } finally {
-            setLoadingDatasets(false);
+            setLoadingDataset(false);
            setInited(true);
        }
    };
@@ -90,21 +90,13 @@ export default function DatasetManager() {
        }
    };

-    /**
-     * 处理知识库选择
-     */
-    const handleDatasetSelect = (datasetId: string) => {
-        if (datasetId !== currentDatasetId) {
-            setCurrentDatasetId(datasetId);
-            setDocumentPage(1);
-        }
-    };
-
    /**
     * 处理文档页码变化
     */
    const handlePageChange = (page: number) => {
-        loadDocuments(currentDatasetId, page);
+        if (dataset) {
+            loadDocuments(dataset.id, page);
+        }
    };

    /**
@@ -115,13 +107,12 @@ export default function DatasetManager() {
        setDocumentTotal((prev) => prev - 1);

        // 更新知识库的文档数量
-        setDatasets((prev) =>
-            prev.map((ds) =>
-                ds.id === currentDatasetId
-                    ? { ...ds, document_count: ds.document_count - 1 }
-                    : ds
-            )
-        );
+        if (dataset) {
+            setDataset({
+                ...dataset,
+                document_count: dataset.document_count - 1
+            });
+        }
    };

    /**
@@ -139,50 +130,67 @@ export default function DatasetManager() {
     * 刷新文档列表
     */
    const handleRefresh = () => {
-        loadDocuments(currentDatasetId, documentPage);
+        if (dataset) {
+            loadDocuments(dataset.id, documentPage);
+        }
    };

    /**
-     * 处理侧边栏切换
+     * 查看文档详情（分段管理）
     */
-    const handleSidebarToggle = () => {
-        setSidebarCollapsed(!sidebarCollapsed);
+    const handleViewDocument = (doc: Document) => {
+        console.log('[DatasetManager] 查看文档详情:', doc);
+        setSelectedDocument(doc);
+    };
+
+    /**
+     * 返回文档列表
+     */
+    const handleBackToDocuments = () => {
+        setSelectedDocument(null);
+    };
+
+    /**
+     * 处理菜单切换
+     */
+    const handleTabChange = (tab: MenuTab) => {
+        setActiveTab(tab);
+        // 切换菜单时清除选中的文档
+        if (tab !== 'documents') {
+            setSelectedDocument(null);
+        }
+    };
+
+    /**
+     * 处理知识库更新
+     */
+    const handleDatasetUpdated = (updatedDataset: Dataset) => {
+        setDataset(updatedDataset);
    };

    // 初始化
    useEffect(() => {
-        loadDatasets();
+        loadDataset();
    }, []);

-    // 当选中的知识库变化时，加载文档列表
-    useEffect(() => {
-        if (currentDatasetId) {
-            loadDocuments(currentDatasetId, 1);
-        }
-    }, [currentDatasetId]);
-
-    // 检查屏幕尺寸
-    useEffect(() => {
-        const checkScreenSize = () => {
-            setIsMobile(window.innerWidth < 992);
-        };
-
-        checkScreenSize();
-        window.addEventListener('resize', checkScreenSize);
-
-        return () => {
-            window.removeEventListener('resize', checkScreenSize);
-        };
-    }, []);
-
-    // 获取当前选中的知识库
-    const currentDataset = datasets.find((ds) => ds.id === currentDatasetId);
-
-    // 如果有错误，显示错误页面
-    if (error && !inited) {
+    // 加载中状态
+    if (!inited || loadingDataset) {
        return (
-            <div className="dataset-manager-container">
-                <div className="dataset-empty">
+            <div className="dataset-manager-wrapper">
+                <div className="dataset-loading-state">
+                    <Spin size="large" />
+                    <span className="loading-text">正在加载知识库...</span>
+                </div>
+            </div>
+        );
+    }
+
+    // 错误状态
+    if (error) {
+        return (
+            <div className="dataset-manager-wrapper">
+                <div className="dataset-error-state">
+                    <i className="ri-error-warning-line error-icon"></i>
                    <h3>加载失败</h3>
                    <p>{error}</p>
                </div>
@@ -190,52 +198,69 @@ export default function DatasetManager() {
        );
    }

-    return (
-        <Layout style={{ height: '100%', display: 'flex', flexDirection: 'row' }}>
-            {/* 移动端遮罩层 */}
-            {!sidebarCollapsed && isMobile && (
-                <div
-                    className="fixed inset-0 bg-black bg-opacity-50 z-[999]"
-                    onClick={handleSidebarToggle}
-                />
-            )}
-
-            {/* 侧边栏 */}
-            <DatasetSidebar
-                collapsed={sidebarCollapsed}
-                onToggle={handleSidebarToggle}
-                datasets={datasets}
-                currentDatasetId={currentDatasetId}
-                onDatasetSelect={handleDatasetSelect}
-                loading={loadingDatasets}
-            />
-
-            {/* 主内容区域 */}
-            <Layout style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
-                <Content
-                    style={{
-                        background: colorBgContainer,
-                        display: 'flex',
-                        flexDirection: 'column',
-                        flex: 1,
-                        minHeight: 0,
-                    }}
-                >
-                    <DocumentList
-                        datasetId={currentDatasetId}
-                        datasetName={currentDataset?.name || ''}
-                        documents={documents}
-                        loading={loadingDocuments}
-                        total={documentTotal}
-                        page={documentPage}
-                        pageSize={documentPageSize}
-                        onPageChange={handlePageChange}
-                        onDocumentDeleted={handleDocumentDeleted}
-                        onDocumentStatusChanged={handleDocumentStatusChanged}
-                        onRefresh={handleRefresh}
+    /**
+     * 渲染右侧内容区
+     */
+    const renderContent = () => {
+        // 文档菜单
+        if (activeTab === 'documents') {
+            // 如果选中了文档，显示文档详情
+            if (selectedDocument) {
+                return (
+                    <DocumentDetail
+                        datasetId={dataset?.id || ''}
+                        document={selectedDocument}
                    />
-                </Content>
-            </Layout>
-        </Layout>
+                );
+            }
+            // 否则显示文档列表
+            return (
+                <DocumentList
+                    datasetId={dataset?.id || ''}
+                    datasetName={dataset?.name || ''}
+                    documents={documents}
+                    loading={loadingDocuments}
+                    total={documentTotal}
+                    page={documentPage}
+                    pageSize={documentPageSize}
+                    onPageChange={handlePageChange}
+                    onDocumentDeleted={handleDocumentDeleted}
+                    onDocumentStatusChanged={handleDocumentStatusChanged}
+                    onRefresh={handleRefresh}
+                    onViewDocument={handleViewDocument}
+                />
+            );
+        }
+
+        // 召回测试菜单
+        if (activeTab === 'retrieve') {
+            return <RetrieveTest datasetId={dataset?.id || ''} />;
+        }
+
+        // 设置菜单
+        if (activeTab === 'settings') {
+            return (
+                <DatasetSettings
+                    dataset={dataset}
+                    onDatasetUpdated={handleDatasetUpdated}
+                />
+            );
+        }
+
+        return null;
+    };
+
+    return (
+        <div className="dataset-manager-wrapper">
+            <DatasetLayout
+                dataset={dataset}
+                activeTab={activeTab}
+                onTabChange={handleTabChange}
+                showBackButton={activeTab === 'documents' && !!selectedDocument}
+                onBack={handleBackToDocuments}
+            >
+                {renderContent()}
+            </DatasetLayout>
+        </div>
    );
 }
@@ -0,0 +1,109 @@
+import { ReactNode } from 'react';
+import { Button, Tooltip } from 'antd';
+import {
+    FileTextOutlined,
+    SearchOutlined,
+    SettingOutlined,
+    ArrowLeftOutlined,
+    DatabaseOutlined,
+} from '@ant-design/icons';
+import type { Dataset } from '~/api/dify-dataset/type/datasetTypes';
+
+/**
+ * 菜单项类型
+ */
+export type MenuTab = 'documents' | 'retrieve' | 'settings';
+
+interface DatasetLayoutProps {
+    /** 知识库信息 */
+    dataset: Dataset | null;
+    /** 当前激活的菜单 */
+    activeTab: MenuTab;
+    /** 菜单切换回调 */
+    onTabChange: (tab: MenuTab) => void;
+    /** 是否显示返回按钮（在文档详情页时显示） */
+    showBackButton?: boolean;
+    /** 返回按钮点击回调 */
+    onBack?: () => void;
+    /** 子组件 */
+    children: ReactNode;
+}
+
+/**
+ * 知识库布局组件
+ * 包含左侧菜单栏和右侧内容区
+ */
+export default function DatasetLayout({
+    dataset,
+    activeTab,
+    onTabChange,
+    showBackButton = false,
+    onBack,
+    children,
+}: DatasetLayoutProps) {
+    const menuItems: { key: MenuTab; icon: ReactNode; label: string }[] = [
+        { key: 'documents', icon: <FileTextOutlined />, label: '文档' },
+        { key: 'retrieve', icon: <SearchOutlined />, label: '召回测试' },
+        { key: 'settings', icon: <SettingOutlined />, label: '设置' },
+    ];
+
+    return (
+        <div className="dataset-layout">
+            {/* 左侧侧边栏 */}
+            <aside className="dataset-sidebar">
+                {/* 返回按钮 */}
+                {showBackButton && onBack && (
+                    <div className="sidebar-back">
+                        <Button
+                            type="text"
+                            icon={<ArrowLeftOutlined />}
+                            onClick={onBack}
+                            className="back-btn"
+                        >
+                            返回文档列表
+                        </Button>
+                    </div>
+                )}
+
+                {/* 知识库信息 */}
+                <div className="sidebar-header">
+                    <div className="dataset-icon">
+                        <DatabaseOutlined />
+                    </div>
+                    <div className="dataset-info">
+                        <Tooltip title={dataset?.name} placement="right">
+                            <h2 className="dataset-name">{dataset?.name || '知识库'}</h2>
+                        </Tooltip>
+                        <span className="dataset-type">本地文档</span>
+                    </div>
+                </div>
+
+                {/* 统计信息 */}
+                <div className="sidebar-stats">
+                    <span className="stat-item">
+                        {dataset?.document_count || 0} 个文档
+                    </span>
+                </div>
+
+                {/* 导航菜单 */}
+                <nav className="sidebar-menu">
+                    {menuItems.map((item) => (
+                        <button
+                            key={item.key}
+                            className={`menu-item ${activeTab === item.key ? 'active' : ''}`}
+                            onClick={() => onTabChange(item.key)}
+                        >
+                            <span className="menu-icon">{item.icon}</span>
+                            <span className="menu-label">{item.label}</span>
+                        </button>
+                    ))}
+                </nav>
+            </aside>
+
+            {/* 右侧内容区 */}
+            <main className="dataset-main">
+                {children}
+            </main>
+        </div>
+    );
+}
@@ -0,0 +1,202 @@
+import { useState } from 'react';
+import {
+    Input,
+    Button,
+    Card,
+    Select,
+    Slider,
+    Table,
+    Tag,
+    Empty,
+    Spin,
+    message,
+} from 'antd';
+import { FileSearchOutlined } from '@ant-design/icons';
+import type { ColumnsType } from 'antd/es/table';
+import type { RetrieveRecord } from '~/api/dify-dataset/type';
+import { retrieveDataset } from '~/api/dify-dataset/api/segmentApi';
+
+interface RetrieveTestProps {
+    datasetId: string;
+}
+
+/**
+ * 召回测试组件
+ * 用于测试知识库的检索效果
+ */
+export default function RetrieveTest({ datasetId }: RetrieveTestProps) {
+    const [searchQuery, setSearchQuery] = useState('');
+    const [retrieveResults, setRetrieveResults] = useState<RetrieveRecord[]>([]);
+    const [retrieving, setRetrieving] = useState(false);
+    const [searchMethod, setSearchMethod] = useState<string>('hybrid_search');
+    const [topK, setTopK] = useState<number>(5);
+
+    /**
+     * 执行检索
+     */
+    const handleRetrieve = async () => {
+        if (!searchQuery.trim()) {
+            message.warning('请输入检索关键词');
+            return;
+        }
+
+        if (!datasetId) {
+            message.warning('知识库ID不存在');
+            return;
+        }
+
+        setRetrieving(true);
+        try {
+            const response = await retrieveDataset(datasetId, searchQuery, {
+                search_method: searchMethod as any,
+                top_k: topK,
+            });
+            setRetrieveResults(response.records || []);
+            if (response.records?.length === 0) {
+                message.info('未找到匹配的结果');
+            }
+        } catch (err: any) {
+            console.error('检索失败:', err);
+            message.error(err.message || '检索失败');
+        } finally {
+            setRetrieving(false);
+        }
+    };
+
+    // 检索结果列定义
+    const columns: ColumnsType<RetrieveRecord> = [
+        {
+            title: '相关度',
+            dataIndex: 'score',
+            key: 'score',
+            width: 100,
+            render: (score: number) => (
+                <Tag color={score > 0.8 ? 'green' : score > 0.5 ? 'orange' : 'default'}>
+                    {(score * 100).toFixed(1)}%
+                </Tag>
+            ),
+        },
+        {
+            title: '内容',
+            key: 'content',
+            render: (_, record) => (
+                <div className="retrieve-result-content">
+                    <div className="content-text">
+                        {record.segment.content.length > 300
+                            ? record.segment.content.substring(0, 300) + '...'
+                            : record.segment.content}
+                    </div>
+                    {record.segment.answer && (
+                        <div className="answer-text">
+                            <strong>答案：</strong>
+                            {record.segment.answer.length > 150
+                                ? record.segment.answer.substring(0, 150) + '...'
+                                : record.segment.answer}
+                        </div>
+                    )}
+                </div>
+            ),
+        },
+        {
+            title: '字数',
+            key: 'word_count',
+            width: 80,
+            render: (_, record) => record.segment.word_count,
+        },
+        {
+            title: '命中次数',
+            key: 'hit_count',
+            width: 100,
+            render: (_, record) => record.segment.hit_count,
+        },
+    ];
+
+    return (
+        <div className="retrieve-test-page">
+            {/* 页面标题 */}
+            <div className="page-header">
+                <h1>召回测试</h1>
+                <p className="page-description">
+                    输入查询内容，测试知识库的检索效果
+                </p>
+            </div>
+
+            {/* 检索设置 */}
+            <Card className="retrieve-settings" size="small">
+                <div className="search-row">
+                    <Input
+                        placeholder="输入检索关键词..."
+                        prefix={<FileSearchOutlined />}
+                        value={searchQuery}
+                        onChange={(e) => setSearchQuery(e.target.value)}
+                        onPressEnter={handleRetrieve}
+                        className="search-input"
+                    />
+                    <Button
+                        type="primary"
+                        onClick={handleRetrieve}
+                        loading={retrieving}
+                    >
+                        检索
+                    </Button>
+                </div>
+
+                <div className="options-row">
+                    <div className="option-item">
+                        <span className="option-label">检索方式：</span>
+                        <Select
+                            value={searchMethod}
+                            onChange={setSearchMethod}
+                            style={{ width: 140 }}
+                            options={[
+                                { value: 'keyword_search', label: '关键词搜索' },
+                                { value: 'semantic_search', label: '语义搜索' },
+                                { value: 'full_text_search', label: '全文搜索' },
+                                { value: 'hybrid_search', label: '混合搜索' },
+                            ]}
+                        />
+                    </div>
+                    <div className="option-item">
+                        <span className="option-label">返回数量 (Top K)：</span>
+                        <Slider
+                            value={topK}
+                            onChange={setTopK}
+                            min={1}
+                            max={20}
+                            style={{ width: 120 }}
+                        />
+                        <span className="option-value">{topK}</span>
+                    </div>
+                </div>
+            </Card>
+
+            {/* 检索结果 */}
+            <div className="retrieve-results">
+                {retrieving ? (
+                    <div className="loading-state">
+                        <Spin size="large" />
+                        <div className="loading-text">检索中...</div>
+                    </div>
+                ) : retrieveResults.length === 0 ? (
+                    <Empty
+                        description="请输入关键词进行检索"
+                        className="empty-state"
+                    />
+                ) : (
+                    <>
+                        <div className="results-header">
+                            <span>找到 {retrieveResults.length} 条结果</span>
+                        </div>
+                        <Table
+                            columns={columns}
+                            dataSource={retrieveResults}
+                            rowKey={(record) => record.segment.id}
+                            pagination={false}
+                            size="small"
+                        />
+                    </>
+                )}
+            </div>
+        </div>
+    );
+}
@@ -1,160 +0,0 @@
-import { useState } from 'react';
-import { Button, Layout, Menu, theme, Input, Spin } from 'antd';
-import {
-    MenuFoldOutlined,
-    MenuUnfoldOutlined,
-    DatabaseOutlined,
-    SearchOutlined,
-    FileTextOutlined,
-} from '@ant-design/icons';
-import type { Dataset } from '~/api/dify-dataset';
-import '../../styles/components/dify-dataset-manager/sidebar.css';
-
-const { Sider } = Layout;
-
-interface DatasetSidebarProps {
-    collapsed: boolean;
-    onToggle: () => void;
-    datasets: Dataset[];
-    currentDatasetId: string;
-    onDatasetSelect: (datasetId: string) => void;
-    loading?: boolean;
-}
-
-/**
- * 知识库侧边栏组件
- */
-export default function DatasetSidebar({
-    collapsed,
-    onToggle,
-    datasets,
-    currentDatasetId,
-    onDatasetSelect,
-    loading = false,
-}: DatasetSidebarProps) {
-    const [searchValue, setSearchValue] = useState('');
-    const {
-        token: { colorBgContainer },
-    } = theme.useToken();
-
-    // 过滤知识库列表
-    const filteredDatasets = datasets.filter((ds) =>
-        ds.name.toLowerCase().includes(searchValue.toLowerCase())
-    );
-
-    // 生成菜单项
-    const menuItems = filteredDatasets.map((ds) => ({
-        key: ds.id,
-        icon: <DatabaseOutlined />,
-        label: (
-            <div className="dataset-info">
-                <span className="dataset-info-name" title={ds.name}>
-                    {ds.name}
-                </span>
-                {!collapsed && (
-                    <div className="dataset-info-meta">
-                        <span className="dataset-info-meta-item">
-                            <FileTextOutlined />
-                            {ds.document_count}
-                        </span>
-                    </div>
-                )}
-            </div>
-        ),
-    }));
-
-    return (
-        <Sider
-            trigger={null}
-            collapsible
-            collapsed={collapsed}
-            width={280}
-            collapsedWidth={60}
-            className="dataset-sidebar"
-            style={{
-                background: colorBgContainer,
-                borderRight: '1px solid #f0f0f0',
-                display: 'flex',
-                flexDirection: 'column',
-                height: '100%',
-            }}
-        >
-            {/* 侧边栏头部 */}
-            <div className="dataset-sidebar-header">
-                <div className="dataset-sidebar-title">
-                    <Button
-                        type="text"
-                        icon={collapsed ? <MenuUnfoldOutlined /> : <MenuFoldOutlined />}
-                        onClick={onToggle}
-                        style={{
-                            fontSize: '16px',
-                            width: 32,
-                            height: 32,
-                            color: 'rgb(0, 104, 74)',
-                        }}
-                    />
-                    {!collapsed && (
-                        <h3>知识库</h3>
-                    )}
-                </div>
-
-                {/* 搜索框 */}
-                {!collapsed && (
-                    <Input
-                        placeholder="搜索知识库..."
-                        prefix={<SearchOutlined />}
-                        value={searchValue}
-                        onChange={(e) => setSearchValue(e.target.value)}
-                        allowClear
-                    />
-                )}
-            </div>
-
-            {/* 知识库列表 */}
-            <div className="dataset-sidebar-list">
-                {loading ? (
-                    <div className="flex items-center justify-center py-8">
-                        <Spin size="small" />
-                    </div>
-                ) : (
-                    <>
-                        {!collapsed && filteredDatasets.length === 0 && searchValue && (
-                            <div className="p-4 text-center text-gray-500">
-                                <DatabaseOutlined className="text-2xl mb-2" />
-                                <p>未找到相关知识库</p>
-                            </div>
-                        )}
-
-                        {!collapsed && datasets.length === 0 && !searchValue && (
-                            <div className="p-4 text-center text-gray-500">
-                                <DatabaseOutlined className="text-2xl mb-2" />
-                                <p>暂无知识库</p>
-                            </div>
-                        )}
-
-                        <Menu
-                            mode="inline"
-                            selectedKeys={[currentDatasetId]}
-                            items={menuItems}
-                            onClick={({ key }) => onDatasetSelect(key)}
-                            style={{
-                                border: 'none',
-                                background: 'transparent',
-                            }}
-                            className="dataset-sidebar-menu"
-                        />
-                    </>
-                )}
-            </div>
-
-            {/* 侧边栏底部 */}
-            {!collapsed && datasets.length > 0 && (
-                <div className="dataset-sidebar-footer">
-                    <div className="stats-text">
-                        共 {datasets.length} 个知识库
-                    </div>
-                </div>
-            )}
-        </Sider>
-    );
-}
@@ -214,8 +214,7 @@ export function Sidebar({ onToggle, collapsed, userRole, frontendJWT = '' }: Sid

    // 🔑 如果选择了"智慧法务大模型"，显示 /chat-with-llm 和 /dataset-manager 相关菜单
    if (selectedModuleName === '智慧法务大模型') {
-      return item.path === '/chat-with-llm' || item.path?.startsWith('/chat-with-llm/') ||
-             item.path === '/dataset-manager' || item.path?.startsWith('/dataset-manager/');
+      return item.path === '/chat-with-llm' || item.path?.startsWith('/chat-with-llm/')
    }

    // 🔑 如果选择了包含"合同"的模块
@@ -209,7 +209,7 @@ export default function Index() {
      // console.log('📌 [Index] 合同模块，跳转到:', targetPath);
    } else if (module.name === '智慧法务大模型') {
      // 智慧法务大模型 → 跳转到 AI 对话
-      targetPath = '/chat-with-llm';
+      targetPath = '/chat-with-llm/chat';
      // console.log('📌 [Index] 智慧法务大模型，跳转到:', targetPath);
    } else {
      // console.log('📌 [Index] 其他模块，跳转到:', targetPath);
@@ -0,0 +1,74 @@
+import { type LoaderFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * GET /api/dataset/datasets/:datasetId/documents/:batch/indexing-status
+ * 获取文档嵌入状态（处理进度）
+ *
+ * Dify API: GET /datasets/{dataset_id}/documents/{batch}/indexing-status
+ *
+ * 返回示例:
+ * {
+ *   "data": [{
+ *     "id": "",
+ *     "indexing_status": "indexing",
+ *     "processing_started_at": 1681623462.0,
+ *     "parsing_completed_at": 1681623462.0,
+ *     "cleaning_completed_at": 1681623462.0,
+ *     "splitting_completed_at": 1681623462.0,
+ *     "completed_at": null,
+ *     "paused_at": null,
+ *     "error": null,
+ *     "stopped_at": null,
+ *     "completed_segments": 24,
+ *     "total_segments": 100
+ *   }]
+ * }
+ */
+export async function loader({ request, params }: LoaderFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, batch } = params;
+        if (!datasetId || !batch) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数 (datasetId, batch)' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        console.log('[API] Indexing Status:', { datasetId, batch });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${batch}/indexing-status`;
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Indexing Status - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to get indexing status' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -0,0 +1,93 @@
+import { type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * PATCH /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId/child_chunks/:childChunkId - 更新子分段
+ * DELETE /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId/child_chunks/:childChunkId - 删除子分段
+ *
+ * Dify API:
+ * - PATCH /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks/{child_chunk_id}
+ * - DELETE /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks/{child_chunk_id}
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId, segmentId, childChunkId } = params;
+        if (!datasetId || !documentId || !segmentId || !childChunkId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const method = request.method;
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks/${childChunkId}`;
+
+        if (method === 'DELETE') {
+            console.log('[API] Delete Child Chunk:', { datasetId, documentId, segmentId, childChunkId });
+
+            const response = await fetch(apiUrl, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${frontendJWT}`,
+                },
+            });
+
+            // Dify 删除子分段返回 204 No Content
+            if (response.status === 204) {
+                return new Response(
+                    JSON.stringify({ result: 'success' }),
+                    { status: 200, headers: { 'Content-Type': 'application/json' } }
+                );
+            }
+
+            const data = await response.json();
+            return new Response(JSON.stringify(data), {
+                status: response.status,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+
+        if (method === 'PATCH') {
+            const body = await request.json();
+            console.log('[API] Update Child Chunk:', { datasetId, documentId, segmentId, childChunkId, body });
+
+            const response = await fetch(apiUrl, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${frontendJWT}`,
+                },
+                body: JSON.stringify(body),
+            });
+
+            const data = await response.json();
+            return new Response(JSON.stringify(data), {
+                status: response.status,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+
+        return new Response(
+            JSON.stringify({ error: 'Method not allowed' }),
+            { status: 405, headers: { 'Content-Type': 'application/json' } }
+        );
+
+    } catch (error: any) {
+        console.error('[API] Child Chunk Action - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to process child chunk request' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -0,0 +1,126 @@
+import { type LoaderFunctionArgs, type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * GET /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId/child_chunks - 获取子分段列表
+ * Dify API: GET /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks
+ */
+export async function loader({ request, params }: LoaderFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId, segmentId } = params;
+        if (!datasetId || !documentId || !segmentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        // 获取查询参数
+        const url = new URL(request.url);
+        const page = url.searchParams.get('page') || '1';
+        const limit = url.searchParams.get('limit') || '20';
+        const keyword = url.searchParams.get('keyword') || '';
+
+        console.log('[API] Child Chunks List:', { datasetId, documentId, segmentId, page, limit, keyword });
+
+        // 构建查询参数
+        const queryParams = new URLSearchParams({ page, limit });
+        if (keyword) queryParams.append('keyword', keyword);
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks?${queryParams}`;
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Child Chunks List - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to get child chunks' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
+
+/**
+ * POST /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId/child_chunks - 新增子分段
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}/child_chunks
+ * 请求体: { content: string }
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId, segmentId } = params;
+        if (!datasetId || !documentId || !segmentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        if (request.method !== 'POST') {
+            return new Response(
+                JSON.stringify({ error: 'Method not allowed' }),
+                { status: 405, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const body = await request.json();
+        console.log('[API] Create Child Chunk:', { datasetId, documentId, segmentId });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}/child_chunks`;
+        const response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+            body: JSON.stringify(body),
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Create Child Chunk - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to create child chunk' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -0,0 +1,143 @@
+import { type LoaderFunctionArgs, type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * GET /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId - 获取分段详情
+ * Dify API: GET /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}
+ */
+export async function loader({ request, params }: LoaderFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId, segmentId } = params;
+        if (!datasetId || !documentId || !segmentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        console.log('[API] Segment Detail:', { datasetId, documentId, segmentId });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`;
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Segment Detail - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to get segment' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
+
+/**
+ * DELETE /api/dataset/datasets/:datasetId/documents/:documentId/segments/:segmentId - 删除分段
+ * POST - 更新分段 (Dify用POST更新分段，可传enabled参数切换状态)
+ * Dify API: DELETE/POST /datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId, segmentId } = params;
+        if (!datasetId || !documentId || !segmentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const method = request.method;
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments/${segmentId}`;
+
+        if (method === 'DELETE') {
+            console.log('[API] Delete Segment:', { datasetId, documentId, segmentId });
+
+            const response = await fetch(apiUrl, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${frontendJWT}`,
+                },
+            });
+
+            // Dify删除分段返回 204 No Content
+            if (response.status === 204) {
+                return new Response(
+                    JSON.stringify({ result: 'success' }),
+                    { status: 200, headers: { 'Content-Type': 'application/json' } }
+                );
+            }
+
+            const data = await response.json();
+            return new Response(JSON.stringify(data), {
+                status: response.status,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+
+        if (method === 'POST') {
+            // POST 用于更新分段（包括启用/禁用）
+            const body = await request.json();
+            console.log('[API] Update Segment:', { datasetId, documentId, segmentId, body });
+
+            const response = await fetch(apiUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${frontendJWT}`,
+                },
+                body: JSON.stringify(body),
+            });
+
+            const data = await response.json();
+            return new Response(JSON.stringify(data), {
+                status: response.status,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+
+        return new Response(
+            JSON.stringify({ error: 'Method not allowed' }),
+            { status: 405, headers: { 'Content-Type': 'application/json' } }
+        );
+
+    } catch (error: any) {
+        console.error('[API] Segment Action - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to process segment request' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -0,0 +1,128 @@
+import { type LoaderFunctionArgs, type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * GET /api/dataset/datasets/:datasetId/documents/:documentId/segments - 获取分段列表
+ * Dify API: GET /datasets/{dataset_id}/documents/{document_id}/segments
+ */
+export async function loader({ request, params }: LoaderFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId } = params;
+        if (!datasetId || !documentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        // 获取查询参数
+        const url = new URL(request.url);
+        const page = url.searchParams.get('page') || '1';
+        const limit = url.searchParams.get('limit') || '20';
+        const keyword = url.searchParams.get('keyword') || '';
+        const status = url.searchParams.get('status') || '';
+
+        console.log('[API] Segments List:', { datasetId, documentId, page, limit, keyword, status });
+
+        // 构建查询参数
+        const queryParams = new URLSearchParams({ page, limit });
+        if (keyword) queryParams.append('keyword', keyword);
+        if (status) queryParams.append('status', status);
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments?${queryParams}`;
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Segments List - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to get segments' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
+
+/**
+ * POST /api/dataset/datasets/:datasetId/documents/:documentId/segments - 新增分段（批量）
+ * Dify API: POST /datasets/{dataset_id}/documents/{document_id}/segments
+ * 请求体: { segments: [{ content, answer?, keywords? }] }
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, documentId } = params;
+        if (!datasetId || !documentId) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        if (request.method !== 'POST') {
+            return new Response(
+                JSON.stringify({ error: 'Method not allowed' }),
+                { status: 405, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const body = await request.json();
+        console.log('[API] Create Segments:', { datasetId, documentId, segmentsCount: body.segments?.length });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/segments`;
+        const response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+            body: JSON.stringify(body),
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Create Segments - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to create segments' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -26,7 +26,7 @@ export async function loader({ request, params }: LoaderFunctionArgs) {

        console.log('[API] Document Detail:', { datasetId, documentId });

-        const apiUrl = `${API_BASE_URL}/dify-dataset/datasets/${datasetId}/documents/${documentId}`;
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}`;
        const response = await fetch(apiUrl, {
            method: 'GET',
            headers: {
@@ -79,7 +79,7 @@ export async function action({ request, params }: ActionFunctionArgs) {
        if (method === 'DELETE') {
            console.log('[API] Delete Document:', { datasetId, documentId });

-            const apiUrl = `${API_BASE_URL}/dify-dataset/datasets/${datasetId}/documents/${documentId}`;
+            const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}`;
            const response = await fetch(apiUrl, {
                method: 'DELETE',
                headers: {
@@ -1,10 +1,26 @@
-import { type ActionFunctionArgs } from '@remix-run/node';
+import { type LoaderFunctionArgs } from '@remix-run/node';
 import { API_BASE_URL } from '~/config/api-config';

 /**
- * PATCH /api/dataset/datasets/:datasetId/documents/:documentId/status - 切换文档状态
+ * GET /api/dataset/datasets/:datasetId/documents/:documentId/upload-file
+ * 获取文档上传文件信息
+ *
+ * Dify API: GET /datasets/{dataset_id}/documents/{document_id}/upload-file
+ *
+ * 返回示例:
+ * {
+ *   "id": "file_id",
+ *   "name": "file_name",
+ *   "size": 1024,
+ *   "extension": "txt",
+ *   "url": "preview_url",
+ *   "download_url": "download_url",
+ *   "mime_type": "text/plain",
+ *   "created_by": "user_id",
+ *   "created_at": 1728734540
+ * }
 */
-export async function action({ request, params }: ActionFunctionArgs) {
+export async function loader({ request, params }: LoaderFunctionArgs) {
    try {
        const { getUserSession } = await import("~/api/login/auth.server");
        const { frontendJWT } = await getUserSession(request);
@@ -19,24 +35,21 @@ export async function action({ request, params }: ActionFunctionArgs) {
        const { datasetId, documentId } = params;
        if (!datasetId || !documentId) {
            return new Response(
-                JSON.stringify({ error: '缺少必要参数' }),
+                JSON.stringify({ error: '缺少必要参数 (datasetId, documentId)' }),
                { status: 400, headers: { 'Content-Type': 'application/json' } }
            );
        }

-        const body = await request.json();
-        const { enabled } = body;
+        console.log('[API] Upload File Info:', { datasetId, documentId });

-        console.log('[API] Toggle Document Status:', { datasetId, documentId, enabled });
-
-        const apiUrl = `${API_BASE_URL}/dify-dataset/datasets/${datasetId}/documents/${documentId}/status`;
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/${documentId}/upload-file`;
        const response = await fetch(apiUrl, {
-            method: 'PATCH',
+            method: 'GET',
            headers: {
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${frontendJWT}`,
            },
-            body: JSON.stringify({ enabled }),
        });

        const data = await response.json();
@@ -47,9 +60,9 @@ export async function action({ request, params }: ActionFunctionArgs) {
        });

    } catch (error: any) {
-        console.error('[API] Toggle Document Status - Error:', error.message);
+        console.error('[API] Upload File Info - Error:', error.message);
        return new Response(
-            JSON.stringify({ error: error.message || 'Failed to toggle status' }),
+            JSON.stringify({ error: error.message || 'Failed to get upload file info' }),
            { status: 500, headers: { 'Content-Type': 'application/json' } }
        );
    }
@@ -0,0 +1,75 @@
+import { type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * PATCH /api/dataset/datasets/:datasetId/documents/status/:action - 批量更新文档状态
+ * Dify API: PATCH /datasets/{dataset_id}/documents/status/{action}
+ * action: enable / disable / archive / un_archive
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId, action: statusAction } = params;
+        if (!datasetId || !statusAction) {
+            return new Response(
+                JSON.stringify({ error: '缺少必要参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        // 验证action参数
+        const validActions = ['enable', 'disable', 'archive', 'un_archive'];
+        if (!validActions.includes(statusAction)) {
+            return new Response(
+                JSON.stringify({ error: `无效的action参数，有效值: ${validActions.join(', ')}` }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const body = await request.json();
+        const { document_ids } = body;
+
+        if (!document_ids || !Array.isArray(document_ids) || document_ids.length === 0) {
+            return new Response(
+                JSON.stringify({ error: '缺少 document_ids 参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        console.log('[API] Update Documents Status:', { datasetId, action: statusAction, document_ids });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents/status/${statusAction}`;
+        const response = await fetch(apiUrl, {
+            method: 'PATCH',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+            body: JSON.stringify({ document_ids }),
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Update Documents Status - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to update documents status' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -38,7 +38,7 @@ export async function loader({ request, params }: LoaderFunctionArgs) {
        if (keyword) queryParams.append('keyword', keyword);

        // 转发请求到 FastAPI
-        const apiUrl = `${API_BASE_URL}/dify-dataset/datasets/${datasetId}/documents?${queryParams}`;
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/documents?${queryParams}`;
        const response = await fetch(apiUrl, {
            method: 'GET',
            headers: {
@@ -92,8 +92,8 @@ export async function action({ request, params }: ActionFunctionArgs) {

        console.log('[API] Upload Document:', { datasetId });

-        // 转发请求到 FastAPI
-        const apiUrl = `${API_BASE_URL}/dify-dataset/datasets/${datasetId}/documents/create-by-file`;
+        // 转发请求到 FastAPI (注意：Dify API是 /document/create-by-file，document是单数)
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/document/create-by-file`;
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
@@ -0,0 +1,87 @@
+import { type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * POST /api/dataset/datasets/:datasetId/retrieve - 检索知识库
+ * Dify API: POST /datasets/{dataset_id}/retrieve
+ *
+ * 请求体:
+ * {
+ *   query: string,                          // 检索关键词
+ *   retrieval_model?: {
+ *     search_method: 'keyword_search' | 'semantic_search' | 'full_text_search' | 'hybrid_search',
+ *     reranking_enable?: boolean,
+ *     reranking_model?: {
+ *       reranking_provider_name: string,
+ *       reranking_model_name: string
+ *     },
+ *     top_k?: number,
+ *     score_threshold_enabled?: boolean,
+ *     score_threshold?: number
+ *   },
+ *   metadata_filtering_conditions?: {
+ *     logical_operator: 'and' | 'or',
+ *     conditions: Array<{
+ *       name: string,
+ *       comparison_operator: string,
+ *       value?: string | number
+ *     }>
+ *   }
+ * }
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId } = params;
+        if (!datasetId) {
+            return new Response(
+                JSON.stringify({ error: '缺少知识库ID' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        if (request.method !== 'POST') {
+            return new Response(
+                JSON.stringify({ error: 'Method not allowed' }),
+                { status: 405, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const body = await request.json();
+        console.log('[API] Retrieve Dataset:', { datasetId, query: body.query });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}/retrieve`;
+        const response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+            body: JSON.stringify(body),
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Retrieve Dataset - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to retrieve dataset' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -0,0 +1,141 @@
+import { type LoaderFunctionArgs, type ActionFunctionArgs } from '@remix-run/node';
+import { API_BASE_URL } from '~/config/api-config';
+
+/**
+ * GET /api/dataset/datasets/:datasetId - 获取知识库详情
+ * Dify API: GET /datasets/{dataset_id}
+ */
+export async function loader({ request, params }: LoaderFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId } = params;
+        if (!datasetId) {
+            return new Response(
+                JSON.stringify({ error: '缺少 datasetId 参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        console.log('[API] Dataset Detail:', { datasetId });
+
+        // 转发请求到 FastAPI -> Dify API
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}`;
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${frontendJWT}`,
+            },
+        });
+
+        const data = await response.json();
+
+        return new Response(JSON.stringify(data), {
+            status: response.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+    } catch (error: any) {
+        console.error('[API] Dataset Detail - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to get dataset' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
+
+/**
+ * PATCH /api/dataset/datasets/:datasetId - 修改知识库名称
+ *
+ * Dify API: PATCH /datasets/{dataset_id}
+ *
+ * 请求体: { "name": "新的知识库名称" }
+ *
+ * 注意：
+ * - 仅允许修改知识库名称，其他字段不开放修改
+ * - 删除知识库功能不对外开放
+ */
+export async function action({ request, params }: ActionFunctionArgs) {
+    try {
+        const { getUserSession } = await import("~/api/login/auth.server");
+        const { frontendJWT } = await getUserSession(request);
+
+        if (!frontendJWT) {
+            return new Response(
+                JSON.stringify({ error: 'JWT认证失败，请重新登录' }),
+                { status: 401, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const { datasetId } = params;
+        if (!datasetId) {
+            return new Response(
+                JSON.stringify({ error: '缺少 datasetId 参数' }),
+                { status: 400, headers: { 'Content-Type': 'application/json' } }
+            );
+        }
+
+        const method = request.method;
+
+        if (method === 'PATCH') {
+            const body = await request.json();
+
+            // 只允许修改 name 字段
+            if (!body.name || typeof body.name !== 'string') {
+                return new Response(
+                    JSON.stringify({ error: '请提供有效的知识库名称 (name)' }),
+                    { status: 400, headers: { 'Content-Type': 'application/json' } }
+                );
+            }
+
+            // 只传递 name 字段，忽略其他字段
+            const allowedBody = { name: body.name.trim() };
+
+            if (allowedBody.name.length === 0) {
+                return new Response(
+                    JSON.stringify({ error: '知识库名称不能为空' }),
+                    { status: 400, headers: { 'Content-Type': 'application/json' } }
+                );
+            }
+
+            console.log('[API] Update Dataset Name:', { datasetId, name: allowedBody.name });
+
+            const apiUrl = `${API_BASE_URL}/dify_dataset/datasets/${datasetId}`;
+            const response = await fetch(apiUrl, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${frontendJWT}`,
+                },
+                body: JSON.stringify(allowedBody),
+            });
+
+            const data = await response.json();
+            return new Response(JSON.stringify(data), {
+                status: response.status,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+
+        return new Response(
+            JSON.stringify({ error: 'Method not allowed' }),
+            { status: 405, headers: { 'Content-Type': 'application/json' } }
+        );
+
+    } catch (error: any) {
+        console.error('[API] Dataset Action - Error:', error.message);
+        return new Response(
+            JSON.stringify({ error: error.message || 'Failed to process dataset request' }),
+            { status: 500, headers: { 'Content-Type': 'application/json' } }
+        );
+    }
+}
@@ -30,7 +30,7 @@ export async function loader({ request }: LoaderFunctionArgs) {
        console.log('[API] Dataset List - 获取知识库列表:', { page, limit });

        // 转发请求到 FastAPI
-        const apiUrl = `${API_BASE_URL}/dify-dataset/datasets?page=${page}&limit=${limit}`;
+        const apiUrl = `${API_BASE_URL}/dify_dataset/datasets?page=${page}&limit=${limit}`;
        const response = await fetch(apiUrl, {
            method: 'GET',
            headers: {
@@ -43,7 +43,7 @@ export const meta: MetaFunction = () => {
 export default function ChatWithLLMIndex() {
    return (
        <div className="chat-container" style={{
-            height: '93vh', // 使用视口高度的90%
+            height: '90vh', // 使用视口高度的90%
            borderRadius: '0.5rem',
            marginBottom: '-20px',
            marginTop: '2vh',
@@ -1,7 +1,7 @@
 import DatasetManager from "~/components/dify-dataset-manager";
 import datasetManagerStyles from "~/styles/components/dify-dataset-manager/index.css?url";
-import sidebarStyles from "~/styles/components/dify-dataset-manager/sidebar.css?url";
-import documentListStyles from "~/styles/components/dify-dataset-manager/document-list.css?url";
+// import sidebarStyles from "~/styles/components/dify-dataset-manager/sidebar.css?url";
+// import documentListStyles from "~/styles/components/dify-dataset-manager/document-list.css?url";

 /**
 * 注册样式
@@ -9,8 +9,8 @@ import documentListStyles from "~/styles/components/dify-dataset-manager/documen
 export function links() {
    return [
        { rel: "stylesheet", href: datasetManagerStyles },
-        { rel: "stylesheet", href: sidebarStyles },
-        { rel: "stylesheet", href: documentListStyles },
+        // { rel: "stylesheet", href: sidebarStyles },
+        // { rel: "stylesheet", href: documentListStyles },
    ];
 }

@@ -19,7 +19,7 @@ export function links() {
 */
 export default function DatasetManagerIndex() {
    return (
-        <div className="dataset-manager-page" style={{ height: '93vh', padding: '16px' }}>
+        <div className="dataset-manager-page" style={{ height: '90vh', padding: '16px' }}>
            <DatasetManager />
        </div>
    );
@@ -1,20 +0,0 @@
-import { Outlet } from "@remix-run/react";
-import type { MetaFunction } from "@remix-run/node";
-
-export const meta: MetaFunction = () => {
-    return [
-        { title: "知识库管理 - 智能审核系统" },
-        { name: "description", content: "Dify 知识库文档管理" },
-    ];
-};
-
-export const handle = {
-    breadcrumb: "知识库管理",
-};
-
-/**
- * 知识库管理布局路由
- */
-export default function DatasetManagerLayout() {
-    return <Outlet />;
-}
@@ -1,91 +0,0 @@
-/**
- * åÆ“¡h - ‡ch7
- */
-
-/* åw */
-.document-list-toolbar {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    margin-bottom: 16px;
-    gap: 16px;
-}
-
-.document-list-search {
-    width: 280px;
-}
-
-.document-list-actions {
-    display: flex;
-    align-items: center;
-    gap: 12px;
-}
-
-/* h<7 */
-.document-table {
-    flex: 1;
-}
-
-.document-table .ant-table-thead > tr > th {
-    background-color: #fafafa;
-    font-weight: 600;
-}
-
-.document-table .ant-table-tbody > tr:hover > td {
-    background-color: #f5f5f5;
-}
-
-/* ‡c
-ð */
-.document-name-cell {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-}
-
-.document-name-cell .anticon {
-    color: #999;
-    font-size: 16px;
-}
-
-.document-name-cell span {
-    font-weight: 500;
-}
-
-/* ¶~ */
-.document-status-tag {
-    display: inline-flex;
-    align-items: center;
-    gap: 4px;
-}
-
-/* Í\	® */
-.document-actions {
-    display: flex;
-    align-items: center;
-    gap: 4px;
-}
-
-/* z¶ */
-.document-list-empty {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    justify-content: center;
-    padding: 60px 20px;
-}
-
-/* Í”@ */
-@media (max-width: 991px) {
-    .document-list-toolbar {
-        flex-direction: column;
-        align-items: stretch;
-    }
-
-    .document-list-search {
-        width: 100%;
-    }
-
-    .document-list-actions {
-        justify-content: space-between;
-    }
@@ -1,135 +0,0 @@
-/**
- * 知识库管理器 - 侧边栏样式
- */
-
-.dataset-sidebar {
-    display: flex;
-    flex-direction: column;
-    height: 100%;
-    overflow: hidden;
-}
-
-.dataset-sidebar .ant-layout-sider-children {
-    display: flex;
-    flex-direction: column;
-    height: 100%;
-}
-
-/* 侧边栏头部 */
-.dataset-sidebar-header {
-    display: flex;
-    flex-direction: column;
-    padding: 12px;
-    border-bottom: 1px solid #f0f0f0;
-    gap: 12px;
-}
-
-.dataset-sidebar-title {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-}
-
-.dataset-sidebar-title h3 {
-    font-size: 16px;
-    font-weight: 600;
-    color: #1a1a1a;
-    margin: 0;
-}
-
-/* 知识库列表 */
-.dataset-sidebar-list {
-    flex: 1;
-    overflow-y: auto;
-    overflow-x: hidden;
-}
-
-/* 菜单样式覆盖 */
-.dataset-sidebar-menu.ant-menu {
-    border: none;
-    background: transparent;
-}
-
-.dataset-sidebar-menu .ant-menu-item {
-    margin: 4px 8px;
-    border-radius: 8px;
-    height: auto;
-    line-height: 1.5;
-    padding: 8px 12px !important;
-}
-
-.dataset-sidebar-menu .ant-menu-item-selected {
-    background-color: rgba(0, 104, 74, 0.1) !important;
-}
-
-.dataset-sidebar-menu .ant-menu-item-selected::after {
-    display: none;
-}
-
-.dataset-sidebar-menu .ant-menu-item:hover {
-    background-color: #f5f5f5;
-}
-
-/* 知识库信息 */
-.dataset-info {
-    display: flex;
-    flex-direction: column;
-    gap: 4px;
-    min-width: 0;
-}
-
-.dataset-info-name {
-    font-size: 14px;
-    font-weight: 500;
-    color: #1a1a1a;
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-}
-
-.dataset-info-meta {
-    display: flex;
-    align-items: center;
-    gap: 12px;
-}
-
-.dataset-info-meta-item {
-    display: flex;
-    align-items: center;
-    gap: 4px;
-    font-size: 12px;
-    color: #999;
-}
-
-.dataset-info-meta-item .anticon {
-    font-size: 12px;
-}
-
-/* 侧边栏底部 */
-.dataset-sidebar-footer {
-    padding: 12px 16px;
-    border-top: 1px solid #f0f0f0;
-    background: #fafafa;
-}
-
-.stats-text {
-    font-size: 12px;
-    color: #999;
-    text-align: center;
-}
-
-/* 响应式布局 */
-@media (max-width: 991px) {
-    .dataset-sidebar {
-        position: fixed;
-        left: 0;
-        top: 0;
-        z-index: 1000;
-        height: 100vh;
-        box-shadow: 2px 0 8px rgba(0, 0, 0, 0.15);
-    }
-
-    .dataset-sidebar.ant-layout-sider-collapsed {
-        transform: translateX(-100%);
-    }
-}