# trial-dataset-workbench

**Repository Path**: asascoder/trial-dataset-workbench

## Basic Information

- **Project Name**: trial-dataset-workbench
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Trial Dataset Workbench

**Trial Dataset Workbench** 是一个面向临床研究数据会话式探索场景的 VS Code 扩展。  
它让你可以直接在 VS Code 里打开并浏览常见临床数据文件，并围绕本地解析、缓存、分页和导出工作流持续处理数据，不需要先导入到 SAS 里。


## 更新日志

###　0.2.4

- SAS 格式规范化

### 0.2.3

- 修复导出数据问题

### 0.2.1

- 增加复制数据功能

### 0.2.0

- 规范项目结构
- 增加默认打开方式设置
- 优化性能设置：设置缓存上限、内存上限、线程数、前端批大小、进度节流间隔
- 性能日志
- 增加语言设置跟随vscode/系统
- 减少没必要的打包项，优化打包文件vsix大小

### 0.1.3

- 增加界面语言设置
- 增加变量显示模式：仅显示变量名、显示变量标签、显示变量名+标签

### 0.1.2

- 优化对sas数据集大文件的支持
- 优化对sas数据集大文件的响应时间

### 0.1.1

- 增加对json和csv的支持

### 0.1.0

- 解析sas数据集和xpt

## 这个扩展适合谁

- 需要快速查看 `SAS7BDAT`、`XPT`、`Dataset-JSON`、`NDJSON`、`CSV` 数据内容的统计程序员
- 需要核对变量、记录数和字段值的数据管理人员
- 需要对临床数据做快速浏览、抽查和导出的团队成员

如果你的主要需求是“先打开看看数据长什么样”，这个扩展就是为这个场景设计的。

## 你可以用它做什么

- 直接打开临床数据文件并在表格中浏览
- 查看超大文件而不容易把 VS Code 内存吃满
- 按列筛选数据
- 按需要切换字符编码，处理乱码问题
- 在变量名、变量标签、变量名加标签之间切换显示方式
- 导出当前数据到 Excel (`.xlsx`) 或 Dataset-JSON
- 在活动栏中查看最近打开的文件并快速重新打开
- 在本地完成解析和缓存，不上传数据到云端

## 支持的文件类型

- `*.sas7bdat`
- `*.xpt`
- `*.json`
  适用于 Dataset-JSON、`{ columns, rows }` 结构，或常见 JSON 数组数据
- `*.ndjson`
- `*.csv`
  默认将第一行作为表头

## 安装方式

目前推荐通过 VSIX 安装。

1. 打开 VS Code
2. 按 `Ctrl+Shift+P`（macOS 为 `Cmd+Shift+P`）
3. 输入并执行 `Extensions: Install from VSIX...`
4. 选择 [trial-dataset-workbench-0.2.2.vsix]
5. 安装完成后重启 VS Code

## 快速开始

### 方式一：从资源管理器打开

1. 在 VS Code 文件资源管理器中找到数据文件
2. 右键文件
3. 选择 `Open with Trial Dataset Workbench`

### 方式二：从命令面板打开

1. 按 `Ctrl+Shift+P`
2. 输入 `Trial Dataset: Open Dataset...`
3. 选择要打开的文件

### 方式三：从最近会话重新打开

1. 点击 VS Code 活动栏中的 `Trial Dataset Workbench` 图标
2. 在 `Sessions` 视图中选择最近打开过的文件

## 常用操作

### 1. 浏览大文件

这个扩展专门针对大文件做了优化。  
遇到特别大的数据集时，界面可能会先尽快显示字段结构和基础信息，再按需继续载入内容，以减少卡顿。

如果你打开文件后先只看到表头或预览状态，可以点击顶部工具栏里的 `Load Full Data` 继续加载完整数据。

### 2. 数据筛选

打开文件后：

1. 点击表格上方的 `Add Filter`
2. 选择列名
3. 选择筛选条件
4. 输入筛选值
5. 点击 `Apply`

适合做快速抽查，例如：

- 筛选某个受试者
- 查看某个访视的数据
- 查找某个字段包含特定关键词的记录

### 3. 导出数据

打开数据后，点击顶部工具栏中的 `Export`，可导出为：

- Excel (`.xlsx`)
- Dataset-JSON

如果你打开的是超大文件，且当前仍处于仅预览结构或按需浏览状态，建议先点击 `Load Full Data`，再执行导出。

### 4. 切换编码

如果文件打开后出现乱码，可以在顶部工具栏切换编码重新加载。  
当前界面支持的常用编码包括：

- `UTF-8`
- `GBK`
- `Shift_JIS`
- `EUC-KR`
- `ISO-8859-1`
- `Windows-1252`
- `Big5`

### 5. 打开整个文件夹

点击顶部工具栏中的文件夹按钮，可以加载一个目录中的数据文件列表，方便在同一个文件夹里连续查看多个数据集。

## 推荐设置

在 VS Code 设置中搜索 `Trial Dataset Workbench`，通常最常用的是下面几项：

- `trialDatasetWorkbench.useAsDefaultEditorInWorkspace`
  在当前工作区里，将 `.sas7bdat` 和 `.xpt` 默认用本扩展打开
- `trialDatasetWorkbench.variableDisplayMode`
  切换变量显示方式：
  - 仅变量名
  - 仅变量标签
  - 变量名和变量标签上下显示
- `trialDatasetWorkbench.cacheEnabled`
  是否启用本地缓存。通常建议保持开启，可加快再次打开同一文件时的速度
- `trialDatasetWorkbench.maxCacheSize`
  本地缓存容量上限，默认 `5120 MB`
- `trialDatasetWorkbench.language`
  界面语言，可跟随系统或手动选择 `English`、`简体中文`、`Français`、`日本語`

## 常见问题

### 打开后乱码

优先尝试在顶部工具栏切换编码重新加载文件。

### 大文件打开后先只看到表头

这是为了优先保证打开速度和稳定性。
点击 `Load Full Data` 即可继续加载完整内容。

### 想让 `.sas7bdat` 或 `.xpt` 默认都用这个扩展打开

在设置中启用 `trialDatasetWorkbench.useAsDefaultEditorInWorkspace`。

### 遇到白屏或异常

可以先尝试：

1. 关闭当前查看页后重新打开文件
2. 执行 `Developer: Reload Window`

## 隐私与数据安全

所有解析、缓存和导出都在本地完成。  
扩展不会主动把你的临床数据上传到外部服务。

## 联系方式

ACoder Team  
eMail: `albert.huan@outlook.com`