diff --git a/frontend/scripts/regression-dataset-preview.mjs b/frontend/scripts/regression-dataset-preview.mjs
index dec2bd8..97954ae 100644
--- a/frontend/scripts/regression-dataset-preview.mjs
+++ b/frontend/scripts/regression-dataset-preview.mjs
@@ -1,22 +1,67 @@
 import fs from 'node:fs'
 import path from 'node:path'
+import ts from 'typescript'
 
 const root = process.cwd()
 const previewPath = path.join(root, 'src/views/dataset/DatasetPreviewView.vue')
+const apiPath = path.join(root, 'src/api/modules/dataset.ts')
+const adapterPath = path.join(root, 'src/mock/adapter.ts')
 const mockPath = path.join(root, 'src/mock/data.ts')
+const recordsPath = path.join(root, 'src/views/dataset/datasetRecords.ts')
+const versionsPath = path.join(root, 'src/mock/datasetVersions.ts')
 const source = fs.readFileSync(previewPath, 'utf8')
+const apiSource = fs.readFileSync(apiPath, 'utf8')
+const adapterSource = fs.readFileSync(adapterPath, 'utf8')
 const mockSource = fs.readFileSync(mockPath, 'utf8')
+const recordsSource = fs.readFileSync(recordsPath, 'utf8')
+const versionsSource = fs.readFileSync(versionsPath, 'utf8')
+const recordsModuleCode = ts.transpileModule(recordsSource, {
+  compilerOptions: { module: ts.ModuleKind.ESNext, target: ts.ScriptTarget.ES2022 },
+}).outputText
+const { parseDatasetRecords, updateDatasetRecord } = await import(
+  `data:text/javascript;base64,${Buffer.from(recordsModuleCode).toString('base64')}`
+)
+const versionsModuleCode = ts.transpileModule(versionsSource, {
+  compilerOptions: { module: ts.ModuleKind.ESNext, target: ts.ScriptTarget.ES2022 },
+}).outputText
+const {
+  activateDatasetVersion,
+  appendDatasetVersion,
+  createInitialVersionState,
+  getActiveDatasetVersion,
+} = await import(`data:text/javascript;base64,${Buffer.from(versionsModuleCode).toString('base64')}`)
 
 function expect(condition, message) {
   if (!condition) throw new Error(message)
 }
 
-expect(source.includes('class="preview-workspace"'), '预览页应使用文件与内容双栏工作区')
+expect(source.includes('class="preview-workspace"'), '详情页应提供数据文件工作区')
+expect(!source.includes('class="file-pane"'), '单文件数据集详情不应展示文件选择侧栏')
 expect(source.includes('class="code-line"'), '内容查看器应提供逐行展示')
 expect(source.includes('class="line-number"'), '内容查看器应显示行号')
 expect(source.includes('previewLoading'), '切换文件时应提供独立加载状态')
 expect(source.includes('previewError'), '内容加载失败时应提供错误状态')
-expect(source.includes('aria-current'), '文件选中态应向辅助技术暴露')
+expect(source.includes('class="records-viewer"'), '详情页应将结构化文件展示为样本列表')
+expect(source.includes('class="record-table"'), '样本数据应使用企业级表格展示')
+expect(source.includes('fixed="right"'), '逐条编辑操作列应固定在表格右侧')
+expect(source.includes('v-for="fieldKey in tableFieldKeys"'), '企业表格应根据数据结构动态生成字段列')
+expect(source.includes('openRecordEditor(asDatasetRecord(row))'), '每条样本应提供独立编辑入口')
+expect(source.includes('暂存修改'), '单条编辑应先暂存到当前页面')
+expect(source.includes('hasPendingVersionChanges && isViewingActiveVersion'), '存在暂存修改时才应显示保存版本按钮')
+expect(source.includes('保存版本'), '文件工具栏应提供保存版本按钮')
+expect(source.includes('baseVersionContent'), '页面应区分已保存版本与待保存工作副本')
+expect(source.includes('class="version-control-bar"'), '详情页应提供独立版本控制区')
+expect(source.includes('设为当前版本'), '历史版本应支持显式切换为当前版本')
+expect(source.includes('历史版本（只读）'), '历史版本应明确展示只读状态')
+expect(source.includes('loadedVersionId.value'), '下载和展示应绑定正在查看的具体版本')
+expect(source.includes('versionRequestId'), '快速切换历史版本时应防止旧响应覆盖新内容')
+expect(source.includes('v-model:current-page="currentPage"'), '样本列表应支持分页浏览')
+expect(!source.includes('class="content-editor"'), '详情页不应继续提供整文件编辑器')
+expect(source.includes('saveRecord'), '逐条编辑器应提供单条保存动作')
+expect(source.includes('hasUnsavedChanges'), '在线编辑器应跟踪未保存修改')
+expect(source.includes('onBeforeRouteLeave'), '离开页面时应保护未保存修改')
+expect(source.includes("event.key.toLowerCase() === 's'"), '在线编辑器应支持快捷键保存')
+expect(source.includes('loadVersions(selectedFile)'), '版本内容加载失败后应支持重新加载')
 expect(!source.includes('handleDownloadAll'), '页面不应保留整包下载逻辑')
 expect(!source.includes('handleDelete'), '页面不应保留删除逻辑')
 expect(!source.includes('router.back()'), '页面不应保留页头返回逻辑')
@@ -25,5 +70,53 @@ expect(mockSource.includes('mockDatasetPreviews'), 'Mock 数据应包含文件
 expect(mockSource.includes("'mock-jsonl'"), 'Mock 数据应为通用数据集提供模拟样本')
 expect(mockSource.includes("'mock-readme'"), 'Mock 数据应为通用数据集提供模拟说明')
 expect(mockSource.includes('.map((dataset)'), '所有 Mock 数据集都应自动补齐预览文件')
+expect(mockSource.includes(': [{ id: `dataset-${dataset.id}-samples`'), '每个 Mock 数据集应只对应一个数据文件')
+expect(apiSource.includes('createDatasetFileVersion'), '数据集 API 应提供创建新版本方法')
+expect(apiSource.includes('activateDatasetFileVersion'), '数据集 API 应提供切换当前版本方法')
+expect(apiSource.includes('getDatasetFileVersionContent'), '数据集 API 应支持读取历史版本内容')
+expect(apiSource.includes('expected_current_version_id'), '创建和激活版本应携带乐观锁版本指针')
+expect(!apiSource.includes('updateDatasetFileContent'), '数据编辑不应继续覆盖历史版本内容')
+expect(adapterSource.includes('mock:dataset-versions:'), 'Mock 版本历史应支持刷新持久化')
+expect(adapterSource.includes('当前版本已被其他用户更新'), 'Mock 应拒绝基于过期版本的并发覆盖')
+expect(adapterSource.includes('历史版本不可覆盖'), '旧的覆盖保存接口应明确拒绝修改历史版本')
+expect(adapterSource.includes('Mock 存储空间不足'), 'Mock 存储失败时应返回明确错误且保留编辑草稿')
+
+const jsonl = [
+  '{"instruction":"第一条","output":"A"}',
+  '',
+  '{"instruction":"第二条","output":["B","C"]}',
+].join('\n')
+const parsed = parseDatasetRecords(jsonl, 'samples.jsonl')
+expect(parsed.supported && parsed.records.length === 2, 'JSONL 应跳过空行并解析为逐条样本')
+expect(parsed.records[1].sourceIndex === 2, '样本应保留原文件物理行位置')
+const updated = updateDatasetRecord(jsonl, 'samples.jsonl', 2, {
+  instruction: '第二条已修改',
+  output: ['B', 'C'],
+})
+const beforeLines = jsonl.split('\n')
+const afterLines = updated.split('\n')
+expect(afterLines[0] === beforeLines[0] && afterLines[1] === '', '单条保存不得改写其他样本或空行')
+expect(JSON.parse(afterLines[2]).instruction === '第二条已修改', '单条保存应准确更新目标样本')
+expect(Array.isArray(JSON.parse(afterLines[2]).output), '单条保存不应丢失数组等非字符串字段类型')
+const invalid = parseDatasetRecords('{invalid json}', 'samples.jsonl')
+expect(invalid.records[0].kind === 'invalid' && invalid.records[0].error, '非法 JSON 行应被单独标记并给出错误')
+const repairedJson = updateDatasetRecord('{invalid json}', 'samples.json', 0, { repaired: true })
+expect(JSON.parse(repairedJson).repaired === true, '非法 JSON 文件应支持按单条方式修复')
+
+const v1State = createInitialVersionState('A', '2026-07-13T00:00:00Z')
+const v2State = appendDatasetVersion(v1State, 'B', '2026-07-13T01:00:00Z', '修改第一条')
+expect(v2State !== v1State, '创建版本应返回新的不可变状态')
+expect(v1State.versions.length === 1 && v1State.versions[0].content === 'A', '创建新版本不得修改历史版本')
+expect(v2State.versions[1].version === 2 && v2State.active_version_id === 'v2', '新版本编号应递增并自动激活')
+const switchedToV1 = activateDatasetVersion(v2State, 'v1')
+expect(getActiveDatasetVersion(switchedToV1).content === 'A', '切换当前版本后应读取对应历史内容')
+expect(v2State.active_version_id === 'v2' && v2State.versions[1].content === 'B', '切换版本不得污染原状态或历史快照')
+let invalidVersionRejected = false
+try {
+  activateDatasetVersion(v2State, 'missing')
+} catch {
+  invalidVersionRejected = true
+}
+expect(invalidVersionRejected, '不存在的版本不得切换为当前版本')
 
 console.log('dataset preview regression checks passed')
diff --git a/frontend/src/api/modules/dataset.ts b/frontend/src/api/modules/dataset.ts
index 5c65a2e..b40eec8 100644
--- a/frontend/src/api/modules/dataset.ts
+++ b/frontend/src/api/modules/dataset.ts
@@ -1,5 +1,5 @@
 import { get, post, put, del } from '../request'
-import type { DatasetItem } from '@/types'
+import type { DatasetItem, DatasetVersion, DatasetVersionList } from '@/types'
 
 /** 数据集列表 */
 export const getDatasetList = () => get<DatasetItem[]>('/dataset-manage')
@@ -29,11 +29,58 @@ export const uploadDatasetFiles = (datasetId: string | number, files: File[]) =>
 
 /** 预览数据集文件内容 */
 export const previewDatasetFile = (fileId: string | number) =>
-  get<{ content: string }>(`/dataset-manage/preview/${fileId}`)
+  get<{ content: string }>(`/dataset-manage/preview/${encodeURIComponent(fileId)}`)
+
+/** 数据集文件版本列表 */
+export const getDatasetFileVersions = (fileId: string | number) =>
+  get<DatasetVersionList>(`/dataset-manage/versions/${encodeURIComponent(fileId)}`)
+
+/** 读取指定历史版本内容（不改变当前版本） */
+export const getDatasetFileVersionContent = (fileId: string | number, versionId: string) =>
+  get<{ version: DatasetVersion; content: string }>(
+    `/dataset-manage/versions/${encodeURIComponent(fileId)}/${encodeURIComponent(versionId)}`,
+  )
+
+/** 保存为新版本，并自动设为当前版本 */
+export const createDatasetFileVersion = (
+  fileId: string | number,
+  content: string,
+  options: {
+    description?: string
+    baseVersionId: string
+    expectedCurrentVersionId: string
+  },
+) =>
+  post<{ version: DatasetVersion; content: string }>(
+    `/dataset-manage/versions/${encodeURIComponent(fileId)}`,
+    {
+      content,
+      description: options.description || '在线编辑',
+      base_version_id: options.baseVersionId,
+      expected_current_version_id: options.expectedCurrentVersionId,
+    },
+  )
+
+/** 切换当前使用的数据集版本 */
+export const activateDatasetFileVersion = (
+  fileId: string | number,
+  versionId: string,
+  expectedCurrentVersionId: string,
+) =>
+  put<{ version: DatasetVersion; content: string }>(
+    `/dataset-manage/versions/${encodeURIComponent(fileId)}/active`,
+    { version_id: versionId, expected_current_version_id: expectedCurrentVersionId },
+  )
 
 /** 下载文件 URL */
-export const downloadFileUrl = (datasetId: string | number, fileId: string | number) =>
-  `/api/dataset-manage/download/${datasetId}/${fileId}`
+export const downloadFileUrl = (
+  datasetId: string | number,
+  fileId: string | number,
+  versionId?: string,
+) => {
+  const baseUrl = `/api/dataset-manage/download/${datasetId}/${fileId}`
+  return versionId ? `${baseUrl}?version_id=${encodeURIComponent(versionId)}` : baseUrl
+}
 
 /** 打包下载数据集 URL */
 export const downloadDatasetUrl = (datasetId: string | number) =>
diff --git a/frontend/src/mock/adapter.ts b/frontend/src/mock/adapter.ts
index 2fad813..c829df5 100644
--- a/frontend/src/mock/adapter.ts
+++ b/frontend/src/mock/adapter.ts
@@ -22,6 +22,13 @@ import {
   mockTrainingLogFiles,
   mockLogContent,
 } from './data'
+import {
+  activateDatasetVersion,
+  appendDatasetVersion,
+  createInitialVersionState,
+  getActiveDatasetVersion,
+} from './datasetVersions'
+import type { StoredDatasetVersion, StoredDatasetVersionState } from './datasetVersions'
 
 /** 模拟网络延迟 */
 function delay(ms = 200): Promise<void> {
@@ -57,6 +64,41 @@ function stripBaseURL(url: string): string {
   return path
 }
 
+function datasetFallbackContent(fileId: string) {
+  const fallbackKey = fileId.endsWith('-readme') ? 'mock-readme' : 'mock-jsonl'
+  return mockDatasetPreviews[fileId] ?? mockDatasetPreviews[fallbackKey] ?? ''
+}
+
+function versionStorageKey(fileId: string) {
+  return `mock:dataset-versions:${fileId}`
+}
+
+function persistVersionState(fileId: string, state: StoredDatasetVersionState) {
+  localStorage.setItem(versionStorageKey(fileId), JSON.stringify(state))
+}
+
+function getVersionState(fileId: string): StoredDatasetVersionState {
+  const persisted = localStorage.getItem(versionStorageKey(fileId))
+  if (persisted) {
+    try {
+      const state = JSON.parse(persisted) as StoredDatasetVersionState
+      if (state.versions?.length && state.active_version_id) return state
+    } catch {
+      // 版本数据损坏时回退到初始版本
+    }
+  }
+
+  const legacyContent = localStorage.getItem(`mock:dataset-file:${fileId}`)
+  const state = createInitialVersionState(legacyContent ?? datasetFallbackContent(fileId))
+  persistVersionState(fileId, state)
+  return state
+}
+
+function versionMetadata(version: StoredDatasetVersion) {
+  const { content: _content, ...metadata } = version
+  return metadata
+}
+
 /** 通过路径 + method 匹配 mock 响应 */
 async function handleMock(config: AxiosRequestConfig) {
   await delay(150) // 模拟网络延迟
@@ -133,9 +175,77 @@ async function handleMock(config: AxiosRequestConfig) {
   m = url.match(/^\/dataset-manage\/preview\/([^/]+)$/)
   if (m && method === 'get') {
     const fileId = decodeURIComponent(m[1])
-    const fallbackKey = fileId.endsWith('-readme') ? 'mock-readme' : 'mock-jsonl'
-    const content = mockDatasetPreviews[fileId] ?? mockDatasetPreviews[fallbackKey]
-    return ok({ content })
+    return ok({ content: getActiveDatasetVersion(getVersionState(fileId)).content })
+  }
+  if (m && method === 'put') return fail('历史版本不可覆盖，请创建新版本', 405)
+
+  m = url.match(/^\/dataset-manage\/versions\/([^/]+)$/)
+  if (m && method === 'get') {
+    const fileId = decodeURIComponent(m[1])
+    const state = getVersionState(fileId)
+    return ok({
+      versions: state.versions.map(versionMetadata).sort((a, b) => b.version - a.version),
+      active_version_id: state.active_version_id,
+    })
+  }
+  if (m && method === 'post') {
+    const fileId = decodeURIComponent(m[1])
+    if (typeof body.content !== 'string') return fail('文件内容格式不正确', 400)
+    const currentState = getVersionState(fileId)
+    if (body.expected_current_version_id !== currentState.active_version_id) {
+      return fail('当前版本已被其他用户更新，请刷新后重试', 409)
+    }
+    if (body.base_version_id !== currentState.active_version_id) {
+      return fail('只能基于当前版本创建新版本', 409)
+    }
+    if (body.content === getActiveDatasetVersion(currentState).content) {
+      return fail('数据内容没有变化，无需创建新版本', 400)
+    }
+    const nextState = appendDatasetVersion(
+      currentState,
+      body.content,
+      new Date().toISOString(),
+      typeof body.description === 'string' ? body.description : '在线编辑',
+    )
+    try {
+      persistVersionState(fileId, nextState)
+    } catch {
+      return fail('文件内容过大，浏览器 Mock 存储空间不足', 413)
+    }
+    const version = getActiveDatasetVersion(nextState)
+    return ok({ version: versionMetadata(version), content: version.content })
+  }
+
+  m = url.match(/^\/dataset-manage\/versions\/([^/]+)\/active$/)
+  if (m && method === 'put') {
+    const fileId = decodeURIComponent(m[1])
+    const currentState = getVersionState(fileId)
+    if (body.expected_current_version_id !== currentState.active_version_id) {
+      return fail('当前版本已被其他用户更新，请刷新后重试', 409)
+    }
+    let nextState: StoredDatasetVersionState
+    try {
+      nextState = activateDatasetVersion(currentState, String(body.version_id || ''))
+    } catch (error) {
+      return fail(error instanceof Error ? error.message : '版本不存在', 404)
+    }
+    try {
+      persistVersionState(fileId, nextState)
+    } catch {
+      return fail('浏览器 Mock 存储空间不足', 413)
+    }
+    const version = getActiveDatasetVersion(nextState)
+    return ok({ version: versionMetadata(version), content: version.content })
+  }
+
+  m = url.match(/^\/dataset-manage\/versions\/([^/]+)\/([^/]+)$/)
+  if (m && method === 'get') {
+    const fileId = decodeURIComponent(m[1])
+    const versionId = decodeURIComponent(m[2])
+    const version = getVersionState(fileId).versions.find((item) => item.id === versionId)
+    return version
+      ? ok({ version: versionMetadata(version), content: version.content })
+      : fail('数据集版本不存在', 404)
   }
 
   // ==================== 训练任务 ====================
diff --git a/frontend/src/mock/data.ts b/frontend/src/mock/data.ts
index 63ab3c0..ad9edce 100644
--- a/frontend/src/mock/data.ts
+++ b/frontend/src/mock/data.ts
@@ -30,10 +30,14 @@ export const mockHealth: HealthMetrics = {
 }
 
 export const mockSystemInfo: SystemInfo = {
+  timestamp: '2026-07-12T10:30:00+08:00',
   cpu: {
     percent: 32,
     cores: 8,
     percents: [25, 38, 42, 30, 28, 36, 40, 18],
+    model: 'Intel Xeon Gold 6330',
+    frequency_mhz: 2500,
+    load_1m: 2.56,
   },
   memory: {
     used_gb: 9.2,
@@ -46,20 +50,166 @@ export const mockSystemInfo: SystemInfo = {
     used_gb: 230,
     total_gb: 512,
     percent: 45,
+    read_mb_s: 86.4,
+    write_mb_s: 34.8,
   },
   gpu: [
-    { name: 'NVIDIA A800', gpu_percent: 0, memory_used_gb: 0.0, memory_total_gb: 80, temperature: 32, power_w: 38, fan_speed: 0, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 28, memory_used_gb: 22.5, memory_total_gb: 80, temperature: 52, power_w: 165, fan_speed: 32, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 73, memory_used_gb: 58.7, memory_total_gb: 80, temperature: 68, power_w: 320, fan_speed: 58, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 0, memory_used_gb: 0.0, memory_total_gb: 80, temperature: 34, power_w: 42, fan_speed: 0, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 46, memory_used_gb: 36.8, memory_total_gb: 80, temperature: 60, power_w: 210, fan_speed: 42, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 0, memory_used_gb: 0.0, memory_total_gb: 80, temperature: 33, power_w: 40, fan_speed: 0, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 85, memory_used_gb: 68.2, memory_total_gb: 80, temperature: 73, power_w: 365, fan_speed: 62, clock_mhz: 1410, driver_version: '535.86.10' },
-    { name: 'NVIDIA A800', gpu_percent: 15, memory_used_gb: 12.0, memory_total_gb: 80, temperature: 45, power_w: 95, fan_speed: 22, clock_mhz: 1410, driver_version: '535.86.10' },
+    {
+      id: 0,
+      uuid: 'GPU-MOCK-A800-00',
+      name: 'NVIDIA A800',
+      status: 'idle',
+      gpu_percent: 0,
+      memory_used_gb: 0,
+      memory_total_gb: 80,
+      memory_percent: 0,
+      temperature: 32,
+      power_w: 38,
+      power_limit_w: 400,
+      fan_speed: 0,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [],
+    },
+    {
+      id: 1,
+      uuid: 'GPU-MOCK-A800-01',
+      name: 'NVIDIA A800',
+      status: 'busy',
+      gpu_percent: 28,
+      memory_used_gb: 22.5,
+      memory_total_gb: 80,
+      memory_percent: 28.1,
+      temperature: 52,
+      power_w: 165,
+      power_limit_w: 400,
+      fan_speed: 32,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [
+        { pid: 18421, name: 'python', task_name: '指令微调任务', user: 'trainer', memory_used_gb: 18.6 },
+        { pid: 18503, name: 'python', task_name: '训练指标采集', user: 'trainer', memory_used_gb: 3.9 },
+      ],
+    },
+    {
+      id: 2,
+      uuid: 'GPU-MOCK-A800-02',
+      name: 'NVIDIA A800',
+      status: 'busy',
+      gpu_percent: 73,
+      memory_used_gb: 58.7,
+      memory_total_gb: 80,
+      memory_percent: 73.4,
+      temperature: 68,
+      power_w: 320,
+      power_limit_w: 400,
+      fan_speed: 58,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [
+        { pid: 20118, name: 'python', task_name: '大模型推理服务', user: 'inference', memory_used_gb: 56.4 },
+        { pid: 20207, name: 'python', task_name: '推理指标采集', user: 'inference', memory_used_gb: 2.3 },
+      ],
+    },
+    {
+      id: 3,
+      uuid: 'GPU-MOCK-A800-03',
+      name: 'NVIDIA A800',
+      status: 'idle',
+      gpu_percent: 0,
+      memory_used_gb: 0,
+      memory_total_gb: 80,
+      memory_percent: 0,
+      temperature: 34,
+      power_w: 42,
+      power_limit_w: 400,
+      fan_speed: 0,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [],
+    },
+    {
+      id: 4,
+      uuid: 'GPU-MOCK-A800-04',
+      name: 'NVIDIA A800',
+      status: 'busy',
+      gpu_percent: 46,
+      memory_used_gb: 36.8,
+      memory_total_gb: 80,
+      memory_percent: 46,
+      temperature: 60,
+      power_w: 210,
+      power_limit_w: 400,
+      fan_speed: 42,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [
+        { pid: 22680, name: 'python', task_name: '批量评测任务', user: 'evaluation', memory_used_gb: 32 },
+        { pid: 22814, name: 'python', task_name: '模型裁判服务', user: 'evaluation', memory_used_gb: 4.8 },
+      ],
+    },
+    {
+      id: 5,
+      uuid: 'GPU-MOCK-A800-05',
+      name: 'NVIDIA A800',
+      status: 'idle',
+      gpu_percent: 0,
+      memory_used_gb: 0,
+      memory_total_gb: 80,
+      memory_percent: 0,
+      temperature: 33,
+      power_w: 40,
+      power_limit_w: 400,
+      fan_speed: 0,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [],
+    },
+    {
+      id: 6,
+      uuid: 'GPU-MOCK-A800-06',
+      name: 'NVIDIA A800',
+      status: 'warning',
+      gpu_percent: 85,
+      memory_used_gb: 68.2,
+      memory_total_gb: 80,
+      memory_percent: 85.3,
+      temperature: 73,
+      power_w: 365,
+      power_limit_w: 400,
+      fan_speed: 62,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [
+        { pid: 24129, name: 'python', task_name: '全参数训练任务', user: 'trainer', memory_used_gb: 63.5 },
+        { pid: 24211, name: 'python', task_name: '训练检查点保存', user: 'trainer', memory_used_gb: 4.7 },
+      ],
+    },
+    {
+      id: 7,
+      uuid: 'GPU-MOCK-A800-07',
+      name: 'NVIDIA A800',
+      status: 'busy',
+      gpu_percent: 15,
+      memory_used_gb: 12,
+      memory_total_gb: 80,
+      memory_percent: 15,
+      temperature: 45,
+      power_w: 95,
+      power_limit_w: 400,
+      fan_speed: 22,
+      clock_mhz: 1410,
+      driver_version: '535.86.10',
+      processes: [
+        { pid: 25367, name: 'python', task_name: '在线推理服务', user: 'inference', memory_used_gb: 12 },
+      ],
+    },
   ],
   network: {
     download_mb: 1024,
     upload_mb: 256,
+    download_mb_s: 42.6,
+    upload_mb_s: 12.4,
   },
   system: {
     uptime_seconds: 86400 * 3 + 3600 * 7 + 1800,
@@ -112,8 +262,6 @@ export const mockDatasets: DatasetItem[] = [
     create_time: '2025-12-20T08:00:00Z',
     files: [
       { id: 'finance-train-jsonl', name: 'finance_train.jsonl', size: '86.4 MB' },
-      { id: 'finance-validation-jsonl', name: 'finance_validation.jsonl', size: '21.8 MB' },
-      { id: 'dataset-readme', name: 'README.md', size: '4.2 KB' },
     ],
   },
   { id: 2, name: '法律文书-训练集', type: 'train', storage_type: 'local', source: 'upload', size: '256 MB', count: 15230, description: '法律文书数据集', create_time: '2025-12-25T10:30:00Z' },
@@ -129,10 +277,7 @@ export const mockDatasets: DatasetItem[] = [
   ...dataset,
   files: dataset.files?.length
     ? dataset.files
-    : [
-        { id: `dataset-${dataset.id}-samples`, name: 'dataset_samples.jsonl', size: dataset.size || '12.8 MB' },
-        { id: `dataset-${dataset.id}-readme`, name: 'README.md', size: '3.8 KB' },
-      ],
+    : [{ id: `dataset-${dataset.id}-samples`, name: 'dataset_samples.jsonl', size: dataset.size || '12.8 MB' }],
 }))
 
 export const mockDatasetPreviews: Record<string, string> = {
diff --git a/frontend/src/mock/datasetVersions.ts b/frontend/src/mock/datasetVersions.ts
new file mode 100644
index 0000000..88a8472
--- /dev/null
+++ b/frontend/src/mock/datasetVersions.ts
@@ -0,0 +1,64 @@
+export interface StoredDatasetVersion {
+  id: string
+  version: number
+  create_time: string
+  description?: string
+  content: string
+}
+
+export interface StoredDatasetVersionState {
+  versions: StoredDatasetVersion[]
+  active_version_id: string
+}
+
+export function createInitialVersionState(
+  content: string,
+  createTime = '2026-07-13T00:00:00Z',
+): StoredDatasetVersionState {
+  const version: StoredDatasetVersion = {
+    id: 'v1',
+    version: 1,
+    create_time: createTime,
+    description: '初始版本',
+    content,
+  }
+  return { versions: [version], active_version_id: version.id }
+}
+
+/** 追加不可变版本快照，并自动把新版本设为当前版本。 */
+export function appendDatasetVersion(
+  state: StoredDatasetVersionState,
+  content: string,
+  createTime: string,
+  description = '在线编辑',
+): StoredDatasetVersionState {
+  const nextNumber = Math.max(0, ...state.versions.map((item) => item.version)) + 1
+  const version: StoredDatasetVersion = {
+    id: `v${nextNumber}`,
+    version: nextNumber,
+    create_time: createTime,
+    description,
+    content,
+  }
+  return {
+    versions: [...state.versions, version],
+    active_version_id: version.id,
+  }
+}
+
+/** 仅移动当前版本指针，不修改任何历史快照。 */
+export function activateDatasetVersion(
+  state: StoredDatasetVersionState,
+  versionId: string,
+): StoredDatasetVersionState {
+  if (!state.versions.some((item) => item.id === versionId)) {
+    throw new Error('数据集版本不存在')
+  }
+  return { ...state, active_version_id: versionId }
+}
+
+export function getActiveDatasetVersion(state: StoredDatasetVersionState) {
+  const version = state.versions.find((item) => item.id === state.active_version_id)
+  if (!version) throw new Error('当前数据集版本不存在')
+  return version
+}
diff --git a/frontend/src/views/dataset/DatasetListView.vue b/frontend/src/views/dataset/DatasetListView.vue
index 7d4e421..ed7ca5e 100644
--- a/frontend/src/views/dataset/DatasetListView.vue
+++ b/frontend/src/views/dataset/DatasetListView.vue
@@ -118,7 +118,7 @@ onMounted(loadData)
     <template #actions="{ row }">
       <div class="action-buttons">
         <el-button type="primary" link size="small" @click="handlePreview(row)">
-          <i class="fa fa-eye" style="margin-right: 4px" />预览
+          <i class="fa fa-eye" style="margin-right: 4px" />详情
         </el-button>
         <el-button type="success" link size="small" @click="handleDownload(row)">
           <i class="fa fa-download" style="margin-right: 4px" />下载
diff --git a/frontend/src/views/dataset/DatasetPreviewView.vue b/frontend/src/views/dataset/DatasetPreviewView.vue
index c072d23..e861b79 100644
--- a/frontend/src/views/dataset/DatasetPreviewView.vue
+++ b/frontend/src/views/dataset/DatasetPreviewView.vue
@@ -1,10 +1,26 @@
 <script setup lang="ts">
-import { computed, onMounted, ref } from 'vue'
-import { useRoute } from 'vue-router'
+import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { onBeforeRouteLeave, useRoute } from 'vue-router'
+import { ElMessage, ElMessageBox } from 'element-plus'
 import PageCard from '@/components/PageCard.vue'
-import { downloadFileUrl, getDataset, previewDatasetFile } from '@/api/modules/dataset'
+import {
+  activateDatasetFileVersion,
+  createDatasetFileVersion,
+  downloadFileUrl,
+  getDataset,
+  getDatasetFileVersionContent,
+  getDatasetFileVersions,
+} from '@/api/modules/dataset'
 import { DATASET_TYPE_MAP, STORAGE_MAP } from '@/constants'
-import type { DatasetFile, DatasetItem } from '@/types'
+import { parseDatasetRecords, updateDatasetRecord } from './datasetRecords'
+import type { DatasetRecord } from './datasetRecords'
+import type { DatasetFile, DatasetItem, DatasetVersion } from '@/types'
+
+interface EditField {
+  key: string
+  value: string
+  isJson: boolean
+}
 
 const route = useRoute()
 const datasetId = route.params.id as string
@@ -14,13 +30,69 @@ const previewLoading = ref(false)
 const dataset = ref<DatasetItem | null>(null)
 const selectedFileId = ref('')
 const previewContent = ref('')
+const baseVersionContent = ref('')
 const previewError = ref('')
-let previewRequestId = 0
+const searchText = ref('')
+const currentPage = ref(1)
+const pageSize = 10
+const editorVisible = ref(false)
+const editingRecord = ref<DatasetRecord | null>(null)
+const editFields = ref<EditField[]>([])
+const rawDraft = ref('')
+const originalDraft = ref('')
+const savingRecord = ref(false)
+const savingVersion = ref(false)
+const versions = ref<DatasetVersion[]>([])
+const selectedVersionId = ref('')
+const activeVersionId = ref('')
+const loadedVersionId = ref('')
+const versionLoading = ref(false)
+const activatingVersion = ref(false)
+let versionRequestId = 0
 
 const files = computed<DatasetFile[]>(() => dataset.value?.files || [])
 const selectedFile = computed(() => files.value.find((file) => fileKey(file) === selectedFileId.value))
-const previewLines = computed(() => previewContent.value ? previewContent.value.split('\n').slice(0, 100) : [])
 const totalLines = computed(() => previewContent.value ? previewContent.value.split('\n').length : 0)
+const recordResult = computed(() => parseDatasetRecords(previewContent.value, selectedFile.value?.name || ''))
+const isRecordFile = computed(() => recordResult.value.supported)
+const records = computed(() => recordResult.value.records)
+const invalidRecordCount = computed(() => records.value.filter((record) => record.kind === 'invalid').length)
+const allTableFieldKeys = computed(() => {
+  const keys = new Set<string>()
+  records.value.forEach((record) => {
+    if (record.kind !== 'object') return
+    Object.keys(record.value as Record<string, unknown>).forEach((key) => keys.add(key))
+  })
+  const preferred = ['instruction', 'question', 'prompt', 'input', 'context', 'output', 'answer', 'response']
+  return [...keys].sort((a, b) => {
+    const rank = (key: string) => {
+      const index = preferred.indexOf(key)
+      return index === -1 ? preferred.length : index
+    }
+    return rank(a) - rank(b)
+  })
+})
+const tableFieldKeys = computed(() => allTableFieldKeys.value.slice(0, 6))
+const hasExtraTableFields = computed(() => allTableFieldKeys.value.length > tableFieldKeys.value.length)
+const viewedVersion = computed(() => versions.value.find((item) => item.id === loadedVersionId.value))
+const isViewingActiveVersion = computed(() => Boolean(loadedVersionId.value) && loadedVersionId.value === activeVersionId.value)
+const nextVersionNumber = computed(() => Math.max(0, ...versions.value.map((item) => item.version)) + 1)
+const filteredRecords = computed(() => {
+  const query = searchText.value.trim().toLowerCase()
+  if (!query) return records.value
+  return records.value.filter((record) => JSON.stringify(record.value).toLowerCase().includes(query))
+})
+const pagedRecords = computed(() => {
+  const start = (currentPage.value - 1) * pageSize
+  return filteredRecords.value.slice(start, start + pageSize)
+})
+const rawPreviewLines = computed(() => previewContent.value ? previewContent.value.split('\n').slice(0, 100) : [])
+const currentDraft = computed(() => editingRecord.value?.kind === 'object'
+  ? JSON.stringify(editFields.value)
+  : rawDraft.value)
+const hasEditorDraftChanges = computed(() => editorVisible.value && currentDraft.value !== originalDraft.value)
+const hasPendingVersionChanges = computed(() => previewContent.value !== baseVersionContent.value)
+const hasUnsavedChanges = computed(() => hasEditorDraftChanges.value || hasPendingVersionChanges.value)
 const datasetType = computed(() => {
   const value = String(dataset.value?.type || '').toLowerCase()
   return DATASET_TYPE_MAP[value] || dataset.value?.type || '-'
@@ -33,12 +105,45 @@ const createdAt = computed(() => dataset.value?.create_time
   ? new Date(dataset.value.create_time).toLocaleString('zh-CN')
   : '-')
 
+function formatVersionTime(value: string) {
+  return new Date(value).toLocaleString('zh-CN', { hour12: false })
+}
+
+function versionOptionLabel(version: DatasetVersion) {
+  const status = version.id === activeVersionId.value ? '当前版本' : '历史版本'
+  return `V${version.version} · ${status} · ${formatVersionTime(version.create_time)}`
+}
+
 function fileKey(file: DatasetFile) {
   return String(file.id || file.name)
 }
 
-function fileExtension(fileName = '') {
-  return fileName.includes('.') ? fileName.split('.').pop()?.toUpperCase() : 'FILE'
+function formatFieldValue(value: unknown) {
+  if (typeof value === 'string') return value || '（空）'
+  return JSON.stringify(value)
+}
+
+function asDatasetRecord(row: unknown) {
+  return row as DatasetRecord
+}
+
+function recordFieldValue(record: DatasetRecord, key: string) {
+  if (record.kind !== 'object') return record.kind === 'invalid' ? record.raw : formatFieldValue(record.value)
+  const data = record.value as Record<string, unknown>
+  return Object.prototype.hasOwnProperty.call(data, key) ? formatFieldValue(data[key]) : '-'
+}
+
+function extraFieldValue(record: DatasetRecord) {
+  if (record.kind !== 'object') return '-'
+  const data = record.value as Record<string, unknown>
+  return allTableFieldKeys.value
+    .filter((key) => !tableFieldKeys.value.includes(key) && Object.prototype.hasOwnProperty.call(data, key))
+    .map((key) => `${key}: ${formatFieldValue(data[key])}`)
+    .join('；') || '-'
+}
+
+function recordRowClassName({ row }: { row: unknown }) {
+  return asDatasetRecord(row).kind === 'invalid' ? 'record-table-row-invalid' : ''
 }
 
 async function loadDataset() {
@@ -46,104 +151,325 @@ async function loadDataset() {
   try {
     dataset.value = await getDataset(datasetId)
     const firstFile = files.value[0]
-    if (firstFile) await selectFile(firstFile)
+    if (firstFile) {
+      selectedFileId.value = fileKey(firstFile)
+      await loadVersions(firstFile)
+    }
   } finally {
     loading.value = false
   }
 }
 
-async function selectFile(file: DatasetFile) {
-  const nextFileId = fileKey(file)
-  selectedFileId.value = nextFileId
-  previewContent.value = ''
-  previewError.value = ''
+async function loadVersions(file: DatasetFile) {
   previewLoading.value = true
-  const requestId = ++previewRequestId
-
+  previewError.value = ''
+  const requestId = ++versionRequestId
   try {
-    const res = await previewDatasetFile(nextFileId)
-    if (requestId === previewRequestId) previewContent.value = res.content || ''
+    const result = await getDatasetFileVersions(fileKey(file))
+    const activeContent = await getDatasetFileVersionContent(fileKey(file), result.active_version_id)
+    if (requestId !== versionRequestId) return
+    versions.value = result.versions
+    activeVersionId.value = result.active_version_id
+    selectedVersionId.value = result.active_version_id
+    loadedVersionId.value = result.active_version_id
+    previewContent.value = activeContent.content
+    baseVersionContent.value = activeContent.content
   } catch {
-    if (requestId === previewRequestId) previewError.value = '内容加载失败，请稍后重试'
+    if (requestId === versionRequestId) previewError.value = '版本内容加载失败，请稍后重试'
   } finally {
-    if (requestId === previewRequestId) previewLoading.value = false
+    if (requestId === versionRequestId) previewLoading.value = false
   }
 }
 
-function handleDownloadFile(file: DatasetFile) {
-  window.open(downloadFileUrl(datasetId, fileKey(file)), '_blank')
+async function handleViewedVersionChange(nextVersionId: string) {
+  if (!selectedFile.value || nextVersionId === loadedVersionId.value) return
+  const previousVersionId = loadedVersionId.value
+  if (!await confirmDiscardChanges('切换版本后，当前样本的未保存修改将丢失。')) {
+    selectedVersionId.value = previousVersionId
+    return
+  }
+
+  versionLoading.value = true
+  const requestId = ++versionRequestId
+  try {
+    const result = await getDatasetFileVersionContent(fileKey(selectedFile.value), nextVersionId)
+    if (requestId !== versionRequestId) return
+    previewContent.value = result.content
+    baseVersionContent.value = result.content
+    loadedVersionId.value = result.version.id
+    currentPage.value = 1
+    searchText.value = ''
+  } catch {
+    if (requestId === versionRequestId) selectedVersionId.value = previousVersionId
+  } finally {
+    if (requestId === versionRequestId) versionLoading.value = false
+  }
 }
 
-onMounted(loadDataset)
+async function activateViewedVersion() {
+  if (!selectedFile.value || !viewedVersion.value || isViewingActiveVersion.value) return
+  try {
+    await ElMessageBox.confirm(
+      `确定将 V${viewedVersion.value.version} 设为当前版本吗？后续任务将使用该版本。`,
+      '切换当前版本',
+      {
+        type: 'warning',
+        confirmButtonText: '设为当前版本',
+        cancelButtonText: '取消',
+      },
+    )
+  } catch {
+    return
+  }
+
+  activatingVersion.value = true
+  try {
+    const result = await activateDatasetFileVersion(
+      fileKey(selectedFile.value),
+      viewedVersion.value.id,
+      activeVersionId.value,
+    )
+    activeVersionId.value = result.version.id
+    previewContent.value = result.content
+    baseVersionContent.value = result.content
+    ElMessage.success(`已将 V${result.version.version} 设为当前版本`)
+  } finally {
+    activatingVersion.value = false
+  }
+}
+
+function openRecordEditor(record: DatasetRecord) {
+  if (!isViewingActiveVersion.value) {
+    ElMessage.warning('历史版本为只读，请先设为当前版本')
+    return
+  }
+  editingRecord.value = record
+  if (record.kind === 'object') {
+    editFields.value = Object.entries(record.value as Record<string, unknown>).map(([key, value]) => ({
+      key,
+      value: typeof value === 'string' ? value : JSON.stringify(value, null, 2),
+      isJson: typeof value !== 'string',
+    }))
+    rawDraft.value = ''
+  } else {
+    editFields.value = []
+    rawDraft.value = record.raw
+  }
+  editorVisible.value = true
+  originalDraft.value = record.kind === 'object' ? JSON.stringify(editFields.value) : rawDraft.value
+}
+
+async function confirmDiscardChanges(message = '当前存在尚未保存为版本的修改，放弃后将无法恢复。') {
+  if (!hasUnsavedChanges.value) return true
+  try {
+    await ElMessageBox.confirm(message, '确认放弃修改？', {
+      type: 'warning',
+      confirmButtonText: '放弃修改',
+      cancelButtonText: '继续编辑',
+    })
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function confirmEditorDiscardChanges() {
+  if (!hasEditorDraftChanges.value) return true
+  try {
+    await ElMessageBox.confirm('当前样本存在未暂存修改，放弃后将无法恢复。', '确认放弃修改？', {
+      type: 'warning',
+      confirmButtonText: '放弃修改',
+      cancelButtonText: '继续编辑',
+    })
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function closeRecordEditor() {
+  if (savingRecord.value) return
+  if (!await confirmEditorDiscardChanges()) return
+  editorVisible.value = false
+  editingRecord.value = null
+}
+
+async function handleDialogBeforeClose(done: () => void) {
+  if (savingRecord.value) return
+  if (!await confirmEditorDiscardChanges()) return
+  editingRecord.value = null
+  done()
+}
+
+function buildNextRecordValue() {
+  if (editingRecord.value?.kind !== 'object') return JSON.parse(rawDraft.value)
+  const nextValue: Record<string, unknown> = {}
+  for (const field of editFields.value) {
+    nextValue[field.key] = field.isJson ? JSON.parse(field.value) : field.value
+  }
+  return nextValue
+}
+
+async function saveRecord() {
+  if (!selectedFile.value || !editingRecord.value || savingRecord.value) return
+  const record = editingRecord.value
+  let nextValue: unknown
+  try {
+    nextValue = buildNextRecordValue()
+  } catch (error) {
+    ElMessage.error(`JSON 格式校验失败：${error instanceof Error ? error.message : '内容格式不正确'}`)
+    return
+  }
+
+  savingRecord.value = true
+  try {
+    const nextContent = updateDatasetRecord(
+      previewContent.value,
+      selectedFile.value.name,
+      record.sourceIndex,
+      nextValue,
+    )
+    previewContent.value = nextContent
+    originalDraft.value = currentDraft.value
+    editorVisible.value = false
+    editingRecord.value = null
+    ElMessage.success(`第 ${record.displayIndex} 条修改已暂存`)
+  } finally {
+    savingRecord.value = false
+  }
+}
+
+async function saveVersion() {
+  if (
+    !selectedFile.value
+    || !hasPendingVersionChanges.value
+    || !isViewingActiveVersion.value
+    || savingVersion.value
+  ) return
+
+  savingVersion.value = true
+  try {
+    const result = await createDatasetFileVersion(
+      fileKey(selectedFile.value),
+      previewContent.value,
+      {
+        description: '在线编辑数据样本',
+        baseVersionId: loadedVersionId.value,
+        expectedCurrentVersionId: activeVersionId.value,
+      },
+    )
+    previewContent.value = result.content
+    baseVersionContent.value = result.content
+    versions.value = [result.version, ...versions.value]
+    activeVersionId.value = result.version.id
+    selectedVersionId.value = result.version.id
+    loadedVersionId.value = result.version.id
+    ElMessage.success(`V${result.version.version} 创建成功，已设为当前版本`)
+  } finally {
+    savingVersion.value = false
+  }
+}
+
+function handleEditorKeydown(event: KeyboardEvent) {
+  if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
+    event.preventDefault()
+    saveRecord()
+  }
+}
+
+function handleBeforeUnload(event: BeforeUnloadEvent) {
+  if (!hasUnsavedChanges.value) return
+  event.preventDefault()
+  event.returnValue = ''
+}
+
+function handleDownloadFile(file: DatasetFile) {
+  window.open(downloadFileUrl(datasetId, fileKey(file), loadedVersionId.value), '_blank')
+}
+
+onBeforeRouteLeave(() => confirmDiscardChanges())
+onMounted(() => {
+  window.addEventListener('beforeunload', handleBeforeUnload)
+  loadDataset()
+})
+onBeforeUnmount(() => window.removeEventListener('beforeunload', handleBeforeUnload))
 </script>
 
 <template>
   <PageCard class="dataset-preview-page" v-loading="loading">
     <template #header>
-      <div class="page-heading">
-        <div class="heading-icon" aria-hidden="true">
-          <i class="fa fa-database" />
-        </div>
-        <div>
-          <div class="heading-row">
-            <h1>{{ dataset?.name || '数据集预览' }}</h1>
-            <el-tag size="small" type="primary">{{ datasetType }}</el-tag>
-            <el-tag size="small" type="success">{{ storageType }}</el-tag>
+      <div class="page-header">
+        <div class="page-heading">
+          <div class="heading-icon" aria-hidden="true"><i class="fa fa-database" /></div>
+          <div>
+            <div class="heading-row">
+              <h1>{{ dataset?.name || '数据集详情' }}</h1>
+              <el-tag size="small" type="primary">{{ datasetType }}</el-tag>
+              <el-tag size="small" type="success">{{ storageType }}</el-tag>
+            </div>
+            <p>{{ dataset?.description || '逐条查看和修改数据样本' }}</p>
           </div>
-          <p>{{ dataset?.description || '查看数据集文件及内容样本' }}</p>
         </div>
       </div>
     </template>
 
     <section class="dataset-overview" aria-label="数据集概览">
-      <div class="overview-item">
-        <span>数据条数</span>
-        <strong>{{ (dataset?.count || 0).toLocaleString() }}</strong>
-      </div>
-      <div class="overview-item">
-        <span>数据大小</span>
-        <strong>{{ dataset?.size || '-' }}</strong>
-      </div>
-      <div class="overview-item">
-        <span>文件数量</span>
-        <strong>{{ files.length }}</strong>
-      </div>
-      <div class="overview-item overview-item-wide">
-        <span>创建时间</span>
-        <strong>{{ createdAt }}</strong>
-      </div>
+      <div class="overview-item"><span>数据条数</span><strong>{{ (dataset?.count || 0).toLocaleString() }}</strong></div>
+      <div class="overview-item"><span>数据大小</span><strong>{{ dataset?.size || '-' }}</strong></div>
+      <div class="overview-item overview-item-wide"><span>创建时间</span><strong>{{ createdAt }}</strong></div>
     </section>
 
-    <section v-if="files.length" class="preview-workspace" aria-label="数据集文件预览">
-      <aside class="file-pane">
-        <div class="pane-heading">
-          <div>
-            <span class="pane-eyebrow">FILES</span>
-            <h2>数据文件</h2>
-          </div>
-          <span class="file-count">{{ files.length }}</span>
-        </div>
+    <section class="version-control-bar" aria-label="数据集版本控制">
+      <div class="version-selector-group">
+        <label for="dataset-version-select">数据版本</label>
+        <el-select
+          id="dataset-version-select"
+          v-model="selectedVersionId"
+          class="version-select"
+          :loading="versionLoading"
+          :disabled="versionLoading || savingRecord"
+          aria-label="选择要查看的数据集版本"
+          @change="handleViewedVersionChange"
+        >
+          <el-option
+            v-for="version in versions"
+            :key="version.id"
+            :label="versionOptionLabel(version)"
+            :value="version.id"
+          />
+        </el-select>
+      </div>
 
-        <nav class="file-list" aria-label="数据文件列表">
-          <button
-            v-for="file in files"
-            :key="fileKey(file)"
-            type="button"
-            class="file-item"
-            :class="{ 'is-active': fileKey(file) === selectedFileId }"
-            :aria-current="fileKey(file) === selectedFileId ? 'true' : undefined"
-            @click="selectFile(file)"
-          >
-            <span class="file-type" aria-hidden="true">{{ fileExtension(file.name) }}</span>
-            <span class="file-copy">
-              <strong :title="file.name">{{ file.name }}</strong>
-              <small>{{ file.size || '未知大小' }}</small>
-            </span>
-            <i v-if="fileKey(file) === selectedFileId" class="fa fa-angle-right" aria-hidden="true" />
-          </button>
-        </nav>
-      </aside>
+      <div class="version-status" role="status" aria-live="polite">
+        <template v-if="viewedVersion">
+          <el-tag v-if="isViewingActiveVersion" type="success">V{{ viewedVersion.version }} · 当前版本</el-tag>
+          <el-tag v-else type="info">V{{ viewedVersion.version }} · 历史版本（只读）</el-tag>
+          <el-tag v-if="hasPendingVersionChanges" type="warning">有待保存修改</el-tag>
+          <span>{{ viewedVersion.description || '无版本说明' }} · {{ formatVersionTime(viewedVersion.create_time) }}</span>
+        </template>
+      </div>
 
+      <el-button
+        v-if="viewedVersion && !isViewingActiveVersion"
+        type="primary"
+        :loading="activatingVersion"
+        @click="activateViewedVersion"
+      >
+        <i class="fa fa-check-circle" />
+        设为当前版本
+      </el-button>
+    </section>
+
+    <el-alert
+      v-if="viewedVersion && !isViewingActiveVersion"
+      class="historical-version-alert"
+      type="info"
+      :closable="false"
+      show-icon
+      title="你正在查看历史版本，数据默认只读；设为当前版本后才可编辑。"
+    />
+
+    <section v-if="files.length" class="preview-workspace" aria-label="数据集文件详情">
       <div class="content-pane">
         <div class="content-toolbar">
           <div class="content-title">
@@ -151,64 +477,143 @@ onMounted(loadDataset)
             <div>
               <h2>{{ selectedFile?.name }}</h2>
               <p>
-                {{ selectedFile?.size || '未知大小' }}
-                <span aria-hidden="true">·</span>
-                {{ totalLines.toLocaleString() }} 行
-                <span v-if="totalLines > 100" aria-hidden="true">·</span>
-                <span v-if="totalLines > 100">显示前 100 行</span>
+                {{ selectedFile?.size || '未知大小' }} <span aria-hidden="true">·</span>
+                <template v-if="isRecordFile">{{ records.length.toLocaleString() }} 条记录</template>
+                <template v-else>{{ totalLines.toLocaleString() }} 行</template>
               </p>
             </div>
           </div>
-          <el-tooltip content="下载当前文件" placement="top">
+          <div class="toolbar-actions">
             <el-button
-              class="download-button"
-              aria-label="下载当前文件"
-              :disabled="!selectedFile"
-              @click="selectedFile && handleDownloadFile(selectedFile)"
+              v-if="hasPendingVersionChanges && isViewingActiveVersion"
+              type="primary"
+              :loading="savingVersion"
+              @click="saveVersion"
             >
-              <i class="fa fa-download" />
-              下载文件
+              <i class="fa fa-save" />保存版本
             </el-button>
-          </el-tooltip>
+            <el-tooltip content="下载当前文件" placement="top">
+              <el-button class="download-button" aria-label="下载当前文件" :disabled="!selectedFile" @click="selectedFile && handleDownloadFile(selectedFile)">
+                <i class="fa fa-download" />下载文件
+              </el-button>
+            </el-tooltip>
+          </div>
         </div>
 
-        <div class="viewer-shell" :aria-busy="previewLoading">
-          <div v-if="previewLoading" class="viewer-state">
-            <i class="fa fa-circle-o-notch fa-spin" aria-hidden="true" />
-            <span>正在加载文件内容…</span>
-          </div>
-
+        <div class="viewer-shell" v-loading="versionLoading" :aria-busy="previewLoading || versionLoading">
+          <div v-if="previewLoading" class="viewer-state"><i class="fa fa-circle-o-notch fa-spin" aria-hidden="true" /><span>正在加载文件内容…</span></div>
           <div v-else-if="previewError" class="viewer-state viewer-state-error" role="alert">
-            <i class="fa fa-exclamation-circle" aria-hidden="true" />
-            <strong>{{ previewError }}</strong>
-            <el-button size="small" @click="selectedFile && selectFile(selectedFile)">重新加载</el-button>
+            <i class="fa fa-exclamation-circle" aria-hidden="true" /><strong>{{ previewError }}</strong>
+            <el-button size="small" @click="selectedFile && loadVersions(selectedFile)">重新加载</el-button>
           </div>
+          <div v-else-if="!previewContent" class="viewer-state"><i class="fa fa-file-o" aria-hidden="true" /><span>当前文件暂无可预览内容</span></div>
 
-          <div v-else-if="!previewLines.length" class="viewer-state">
-            <i class="fa fa-file-o" aria-hidden="true" />
-            <span>当前文件暂无可预览内容</span>
+          <div v-else-if="isRecordFile" class="records-viewer">
+            <div class="records-toolbar">
+              <div><strong>样本数据</strong><span>共 {{ records.length.toLocaleString() }} 条</span><el-tag v-if="invalidRecordCount" size="small" type="danger">{{ invalidRecordCount }} 条格式错误</el-tag></div>
+              <el-input v-model="searchText" class="record-search" clearable placeholder="搜索样本内容" aria-label="搜索样本内容" @input="currentPage = 1">
+                <template #prefix><i class="fa fa-search" /></template>
+              </el-input>
+            </div>
+
+            <div v-if="!filteredRecords.length" class="viewer-state record-empty-state"><i class="fa fa-search" aria-hidden="true" /><span>没有找到匹配的样本</span></div>
+            <div v-else class="record-table-shell" aria-label="数据样本表格">
+              <el-table
+                :data="pagedRecords"
+                row-key="sourceIndex"
+                stripe
+                border
+                class="record-table"
+                :row-class-name="recordRowClassName"
+              >
+                <el-table-column label="序号" width="76" align="center">
+                  <template #default="{ row }">
+                    <div class="table-index">
+                      <strong>{{ asDatasetRecord(row).displayIndex }}</strong>
+                      <small>第 {{ asDatasetRecord(row).sourceIndex + 1 }} 行</small>
+                    </div>
+                  </template>
+                </el-table-column>
+                <el-table-column v-for="fieldKey in tableFieldKeys" :key="fieldKey" :label="fieldKey" min-width="220">
+                  <template #default="{ row }">
+                    <el-tooltip :content="recordFieldValue(asDatasetRecord(row), fieldKey)" placement="top" :show-after="400">
+                      <div class="table-cell-text">{{ recordFieldValue(asDatasetRecord(row), fieldKey) }}</div>
+                    </el-tooltip>
+                  </template>
+                </el-table-column>
+                <el-table-column v-if="hasExtraTableFields" label="其他字段" min-width="240">
+                  <template #default="{ row }">
+                    <el-tooltip :content="extraFieldValue(asDatasetRecord(row))" placement="top" :show-after="400">
+                      <div class="table-cell-text">{{ extraFieldValue(asDatasetRecord(row)) }}</div>
+                    </el-tooltip>
+                  </template>
+                </el-table-column>
+                <el-table-column label="状态" width="96" align="center">
+                  <template #default="{ row }">
+                    <el-tag v-if="asDatasetRecord(row).kind === 'invalid'" size="small" type="danger">格式错误</el-tag>
+                    <el-tag v-else-if="asDatasetRecord(row).kind === 'primitive'" size="small" type="warning">非对象</el-tag>
+                    <el-tag v-else size="small" type="success">正常</el-tag>
+                  </template>
+                </el-table-column>
+                <el-table-column label="操作" width="96" align="center" fixed="right">
+                  <template #default="{ row }">
+                    <el-button
+                      type="primary"
+                      link
+                      :disabled="!isViewingActiveVersion"
+                      :title="isViewingActiveVersion ? '' : '历史版本为只读，请先设为当前版本'"
+                      :aria-label="`${asDatasetRecord(row).kind === 'invalid' ? '修复' : '编辑'}第 ${asDatasetRecord(row).displayIndex} 条数据`"
+                      @click="openRecordEditor(asDatasetRecord(row))"
+                    >
+                      <i :class="asDatasetRecord(row).kind === 'invalid' ? 'fa fa-wrench' : 'fa fa-pencil'" />
+                      {{ asDatasetRecord(row).kind === 'invalid' ? '修复' : '编辑' }}
+                    </el-button>
+                  </template>
+                </el-table-column>
+              </el-table>
+            </div>
+            <div v-if="filteredRecords.length > pageSize" class="records-pagination">
+              <el-pagination v-model:current-page="currentPage" :page-size="pageSize" :total="filteredRecords.length" layout="prev, pager, next" background />
+            </div>
           </div>
 
           <div v-else class="code-viewer" tabindex="0" :aria-label="`${selectedFile?.name || ''} 文件内容`">
-            <div v-for="(line, index) in previewLines" :key="index" class="code-line">
-              <span class="line-number" aria-hidden="true">{{ index + 1 }}</span>
-              <code>{{ line || ' ' }}</code>
-            </div>
+            <div v-for="(line, index) in rawPreviewLines" :key="index" class="code-line"><span class="line-number" aria-hidden="true">{{ index + 1 }}</span><code>{{ line || ' ' }}</code></div>
           </div>
         </div>
 
-        <div class="viewer-footer">
-          <span><i class="fa fa-eye" aria-hidden="true" /> 只读预览</span>
-          <span>UTF-8</span>
-        </div>
+        <div class="viewer-footer"><span v-if="isRecordFile"><i class="fa fa-list-alt" aria-hidden="true" /> 逐条查看与编辑</span><span v-else><i class="fa fa-eye" aria-hidden="true" /> 文本预览</span><span>UTF-8</span></div>
       </div>
     </section>
 
     <section v-else-if="!loading" class="empty-files" aria-label="空文件列表">
-      <span class="empty-icon" aria-hidden="true"><i class="fa fa-folder-open-o" /></span>
-      <h2>暂无数据文件</h2>
-      <p>该数据集还没有可供预览的文件。</p>
+      <span class="empty-icon" aria-hidden="true"><i class="fa fa-folder-open-o" /></span><h2>暂无数据文件</h2><p>该数据集还没有可供预览的文件。</p>
     </section>
+
+    <el-dialog v-model="editorVisible" class="record-editor-dialog" width="min(720px, 92vw)" :title="editingRecord ? `编辑第 ${editingRecord.displayIndex} 条数据` : '编辑数据'" :close-on-click-modal="false" :close-on-press-escape="!savingRecord" :show-close="!savingRecord" :before-close="handleDialogBeforeClose" destroy-on-close>
+      <div v-if="editingRecord" class="record-editor" @keydown="handleEditorKeydown">
+        <div class="editor-hint">
+          <i class="fa fa-info-circle" aria-hidden="true" />
+          当前修改会先暂存；完成多条修改后，点击文件工具栏中的“保存版本”创建 V{{ nextVersionNumber }}。
+        </div>
+        <el-form v-if="editingRecord.kind === 'object'" label-position="top">
+          <el-form-item v-for="field in editFields" :key="field.key" :label="field.key">
+            <el-input v-model="field.value" type="textarea" :rows="field.isJson ? 5 : 3" :aria-label="`编辑字段 ${field.key}`" :placeholder="field.isJson ? '请输入合法 JSON' : `请输入 ${field.key}`" />
+            <small v-if="field.isJson" class="field-helper">该字段为对象、数组或数值，请保持合法 JSON 格式。</small>
+          </el-form-item>
+        </el-form>
+        <div v-else class="raw-record-editor">
+          <label for="raw-record-draft">{{ editingRecord.kind === 'invalid' ? '修复 JSON 内容' : 'JSON 内容' }}</label>
+          <el-input id="raw-record-draft" v-model="rawDraft" type="textarea" :rows="10" aria-label="编辑当前条 JSON 内容" placeholder="请输入合法 JSON" />
+        </div>
+      </div>
+      <template #footer>
+        <div class="record-editor-actions">
+          <span>{{ hasEditorDraftChanges ? '有未暂存修改' : '尚未修改' }} · Ctrl/⌘ + S 暂存</span>
+          <div><el-button :disabled="savingRecord" @click="closeRecordEditor">取消</el-button><el-button type="primary" :loading="savingRecord" :disabled="!hasEditorDraftChanges" @click="saveRecord">暂存修改</el-button></div>
+        </div>
+      </template>
+    </el-dialog>
   </PageCard>
 </template>
 
@@ -217,6 +622,15 @@ onMounted(loadDataset)
   min-width: 0;
 }
 
+.page-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 20px;
+  width: 100%;
+  min-width: 0;
+}
+
 .page-heading {
   display: flex;
   align-items: center;
@@ -260,7 +674,7 @@ onMounted(loadDataset)
 
 .dataset-overview {
   display: grid;
-  grid-template-columns: repeat(3, minmax(120px, 0.7fr)) minmax(220px, 1.2fr);
+  grid-template-columns: repeat(3, minmax(0, 1fr));
   margin-bottom: 20px;
   padding: 16px 20px;
   border: 1px solid #edf0f5;
@@ -301,9 +715,66 @@ onMounted(loadDataset)
   white-space: nowrap;
 }
 
+.version-control-bar {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  min-height: 64px;
+  margin-bottom: 12px;
+  padding: 10px 14px;
+  box-sizing: border-box;
+  border: 1px solid #dfe5ee;
+  border-radius: 10px;
+  background: #fff;
+}
+
+.version-selector-group {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex: 0 0 auto;
+}
+
+.version-selector-group label {
+  color: #344054;
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.version-select {
+  width: 300px;
+}
+
+.version-status {
+  display: flex;
+  align-items: center;
+  flex: 1;
+  gap: 10px;
+  min-width: 0;
+}
+
+.version-status > span {
+  overflow: hidden;
+  color: #7c8799;
+  font-size: 12px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.version-control-bar > .el-button {
+  min-height: 40px;
+  flex: 0 0 auto;
+}
+
+.version-control-bar > .el-button i {
+  margin-right: 6px;
+}
+
+.historical-version-alert {
+  margin-bottom: 12px;
+}
+
 .preview-workspace {
-  display: grid;
-  grid-template-columns: minmax(240px, 280px) minmax(0, 1fr);
   min-height: 520px;
   overflow: hidden;
   border: 1px solid #e5eaf2;
@@ -311,33 +782,6 @@ onMounted(loadDataset)
   background: #fff;
 }
 
-.file-pane {
-  display: flex;
-  flex-direction: column;
-  min-width: 0;
-  border-right: 1px solid #e5eaf2;
-  background: #f8fafc;
-}
-
-.pane-heading {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  min-height: 68px;
-  padding: 12px 16px;
-  border-bottom: 1px solid #e5eaf2;
-}
-
-.pane-eyebrow {
-  display: block;
-  margin-bottom: 2px;
-  color: #9aa4b5;
-  font-size: 10px;
-  font-weight: 700;
-  letter-spacing: 1.1px;
-}
-
-.pane-heading h2,
 .content-title h2 {
   margin: 0;
   color: #263146;
@@ -345,100 +789,6 @@ onMounted(loadDataset)
   font-weight: 600;
 }
 
-.file-count {
-  display: grid;
-  min-width: 26px;
-  height: 26px;
-  place-items: center;
-  border-radius: 8px;
-  background: #e9edf4;
-  color: #596579;
-  font-size: 12px;
-  font-variant-numeric: tabular-nums;
-  font-weight: 600;
-}
-
-.file-list {
-  flex: 1;
-  min-height: 0;
-  overflow-y: auto;
-  padding: 8px;
-}
-
-.file-item {
-  display: flex;
-  align-items: center;
-  gap: 10px;
-  width: 100%;
-  min-height: 58px;
-  margin: 0 0 4px;
-  padding: 8px 10px;
-  border: 1px solid transparent;
-  border-radius: 9px;
-  background: transparent;
-  color: #526076;
-  cursor: pointer;
-  text-align: left;
-  transition: background-color 0.18s ease, border-color 0.18s ease, color 0.18s ease;
-}
-
-.file-item:hover {
-  border-color: #dce2eb;
-  background: #fff;
-}
-
-.file-item:focus-visible {
-  outline: 2px solid var(--el-color-primary-light-5);
-  outline-offset: 1px;
-}
-
-.file-item.is-active {
-  border-color: #cfd5ff;
-  background: #fff;
-  color: var(--primary-color);
-  box-shadow: 0 5px 16px rgba(79, 70, 229, 0.08);
-}
-
-.file-type {
-  display: grid;
-  flex: 0 0 42px;
-  height: 32px;
-  place-items: center;
-  border-radius: 7px;
-  background: #e9edf4;
-  color: #68758b;
-  font-size: 9px;
-  font-weight: 800;
-  letter-spacing: 0.35px;
-}
-
-.file-item.is-active .file-type {
-  background: #eef2ff;
-  color: var(--primary-color);
-}
-
-.file-copy {
-  display: flex;
-  flex: 1;
-  flex-direction: column;
-  gap: 3px;
-  min-width: 0;
-}
-
-.file-copy strong {
-  overflow: hidden;
-  font-size: 13px;
-  font-weight: 600;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.file-copy small {
-  color: #9aa4b5;
-  font-size: 11px;
-  font-variant-numeric: tabular-nums;
-}
-
 .content-pane {
   display: flex;
   flex-direction: column;
@@ -500,6 +850,16 @@ onMounted(loadDataset)
   margin-right: 6px;
 }
 
+.toolbar-actions {
+  display: flex;
+  align-items: center;
+  flex: 0 0 auto;
+}
+
+.toolbar-actions i {
+  margin-right: 6px;
+}
+
 .viewer-shell {
   position: relative;
   flex: 1;
@@ -508,6 +868,111 @@ onMounted(loadDataset)
   background: #fbfcfe;
 }
 
+.records-viewer {
+  min-height: 468px;
+  padding: 16px;
+  box-sizing: border-box;
+}
+
+.records-toolbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 14px;
+}
+
+.records-toolbar > div {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+
+.records-toolbar strong {
+  color: #253047;
+  font-size: 14px;
+}
+
+.records-toolbar span {
+  color: #8a94a6;
+  font-size: 12px;
+}
+
+.record-search {
+  width: 240px;
+}
+
+.record-table-shell {
+  overflow: hidden;
+  border: 1px solid #e4e9f1;
+  border-radius: 8px;
+}
+
+.record-table {
+  width: 100%;
+}
+
+.record-table :deep(.el-table__header th) {
+  height: 44px;
+  background: #f5f7fa;
+  color: #475467;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.record-table :deep(.el-table__cell) {
+  padding: 10px 0;
+}
+
+.record-table :deep(.record-table-row-invalid td) {
+  background: #fff7f7 !important;
+}
+
+.table-index {
+  display: flex;
+  align-items: center;
+  flex-direction: column;
+  gap: 1px;
+  color: #667085;
+  font-variant-numeric: tabular-nums;
+}
+
+.table-index strong {
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.table-index small {
+  color: #98a2b3;
+  font-size: 10px;
+}
+
+.table-cell-text {
+  display: -webkit-box;
+  overflow: hidden;
+  color: #526076;
+  font-size: 12px;
+  line-height: 1.6;
+  overflow-wrap: anywhere;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+
+.record-table .el-button i {
+  margin-right: 5px;
+}
+
+.records-pagination {
+  display: flex;
+  justify-content: flex-end;
+  margin-top: 16px;
+}
+
+.record-empty-state {
+  min-height: 320px;
+}
+
 .code-viewer {
   height: 100%;
   max-height: 468px;
@@ -592,6 +1057,47 @@ onMounted(loadDataset)
   margin-right: 5px;
 }
 
+.editor-hint {
+  margin-bottom: 18px;
+  padding: 10px 12px;
+  border: 1px solid #dbe2ff;
+  border-radius: 8px;
+  background: #f5f7ff;
+  color: #56627a;
+  font-size: 13px;
+}
+
+.editor-hint i {
+  margin-right: 6px;
+  color: var(--primary-color);
+}
+
+.field-helper {
+  margin-top: 5px;
+  color: #8a94a6;
+  line-height: 1.5;
+}
+
+.raw-record-editor label {
+  display: block;
+  margin-bottom: 8px;
+  color: #344054;
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.record-editor-actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.record-editor-actions > span {
+  color: #8a94a6;
+  font-size: 12px;
+}
+
 .empty-files {
   display: flex;
   align-items: center;
@@ -630,28 +1136,31 @@ onMounted(loadDataset)
 
 @media (max-width: 900px) {
   .dataset-overview {
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    gap: 16px 0;
-  }
-
-  .overview-item:nth-child(2) {
-    border-right: 0;
-  }
-
-  .overview-item:nth-child(3) {
-    padding-left: 0;
-  }
-
-  .preview-workspace {
-    grid-template-columns: 220px minmax(0, 1fr);
+    grid-template-columns: repeat(3, minmax(0, 1fr));
   }
 }
 
 @media (max-width: 680px) {
+  .page-header {
+    align-items: flex-start;
+  }
+
   .dataset-overview {
     grid-template-columns: 1fr;
   }
 
+  .version-control-bar,
+  .version-selector-group,
+  .version-status {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .version-select,
+  .version-control-bar > .el-button {
+    width: 100%;
+  }
+
   .overview-item {
     padding: 0 0 12px;
     border-right: 0;
@@ -663,20 +1172,26 @@ onMounted(loadDataset)
     border-bottom: 0;
   }
 
-  .preview-workspace {
-    grid-template-columns: 1fr;
-  }
-
-  .file-pane {
-    max-height: 240px;
-    border-right: 0;
-    border-bottom: 1px solid #e5eaf2;
-  }
-
   .content-toolbar {
     align-items: flex-start;
   }
 
+  .records-toolbar,
+  .record-editor-actions {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .record-search {
+    width: 100%;
+  }
+
+  .record-editor-actions > div {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 8px;
+  }
+
   .download-button {
     width: 44px;
     padding: 8px;
@@ -690,8 +1205,6 @@ onMounted(loadDataset)
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .file-item {
-    transition: none;
-  }
+  .record-table :deep(.el-table__row) { transition: none; }
 }
 </style>
diff --git a/frontend/src/views/dataset/datasetRecords.ts b/frontend/src/views/dataset/datasetRecords.ts
new file mode 100644
index 0000000..194c5fa
--- /dev/null
+++ b/frontend/src/views/dataset/datasetRecords.ts
@@ -0,0 +1,121 @@
+export type DatasetRecordKind = 'object' | 'primitive' | 'invalid'
+
+export interface DatasetRecord {
+  sourceIndex: number
+  displayIndex: number
+  raw: string
+  kind: DatasetRecordKind
+  value: unknown
+  error?: string
+}
+
+export interface DatasetRecordResult {
+  supported: boolean
+  records: DatasetRecord[]
+  error?: string
+}
+
+function isObjectRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+function parseValue(raw: string, sourceIndex: number, displayIndex: number): DatasetRecord {
+  try {
+    const value: unknown = JSON.parse(raw)
+    return {
+      sourceIndex,
+      displayIndex,
+      raw,
+      kind: isObjectRecord(value) ? 'object' : 'primitive',
+      value,
+    }
+  } catch (error) {
+    return {
+      sourceIndex,
+      displayIndex,
+      raw,
+      kind: 'invalid',
+      value: raw,
+      error: error instanceof Error ? error.message : 'JSON 格式不正确',
+    }
+  }
+}
+
+/** 将 JSONL 或 JSON 文件解析为可逐条编辑的样本，保留原始物理位置。 */
+export function parseDatasetRecords(content: string, fileName: string): DatasetRecordResult {
+  const normalizedName = fileName.toLowerCase()
+  if (normalizedName.endsWith('.jsonl')) {
+    const records: DatasetRecord[] = []
+    content.split('\n').forEach((line, sourceIndex) => {
+      if (!line.trim()) return
+      records.push(parseValue(line, sourceIndex, records.length + 1))
+    })
+    return { supported: true, records }
+  }
+
+  if (normalizedName.endsWith('.json')) {
+    try {
+      const root: unknown = JSON.parse(content)
+      const values = Array.isArray(root) ? root : [root]
+      return {
+        supported: true,
+        records: values.map((value, sourceIndex) => ({
+          sourceIndex,
+          displayIndex: sourceIndex + 1,
+          raw: JSON.stringify(value),
+          kind: isObjectRecord(value) ? 'object' : 'primitive',
+          value,
+        })),
+      }
+    } catch (error) {
+      return {
+        supported: true,
+        records: [{
+          sourceIndex: 0,
+          displayIndex: 1,
+          raw: content,
+          kind: 'invalid',
+          value: content,
+          error: error instanceof Error ? error.message : 'JSON 格式不正确',
+        }],
+      }
+    }
+  }
+
+  return { supported: false, records: [] }
+}
+
+/** 仅替换目标样本；JSONL 中其他行（包括空行和原格式）保持不变。 */
+export function updateDatasetRecord(
+  content: string,
+  fileName: string,
+  sourceIndex: number,
+  nextValue: unknown,
+) {
+  const normalizedName = fileName.toLowerCase()
+  if (normalizedName.endsWith('.jsonl')) {
+    const lines = content.split('\n')
+    if (sourceIndex < 0 || sourceIndex >= lines.length) throw new Error('目标样本不存在')
+    lines[sourceIndex] = JSON.stringify(nextValue)
+    return lines.join('\n')
+  }
+
+  if (normalizedName.endsWith('.json')) {
+    let root: unknown
+    try {
+      root = JSON.parse(content)
+    } catch {
+      if (sourceIndex !== 0) throw new Error('目标样本不存在')
+      return JSON.stringify(nextValue, null, 2)
+    }
+    if (Array.isArray(root)) {
+      if (sourceIndex < 0 || sourceIndex >= root.length) throw new Error('目标样本不存在')
+      root[sourceIndex] = nextValue
+      return JSON.stringify(root, null, 2)
+    }
+    if (sourceIndex !== 0) throw new Error('目标样本不存在')
+    return JSON.stringify(nextValue, null, 2)
+  }
+
+  throw new Error('当前文件不支持逐条编辑')
+}