PACS/PACS_DICOM处理/数据处理网页端/README.md

DICOM 阅片分类系统

本目录提供本地 DICOM 检查浏览、序列查看和序列分类标注界面。

Docker 启动

本网页端推荐用 Docker Compose 启动。DICOM 数据通过只读 volume 挂载到容器，不会打包进镜像。

cd /home/wkmgc/Desktop/PACS数据处理/PACS_DICOM处理/数据处理网页端
cp .env.example .env
# 编辑 .env，填写本机 PostgreSQL 密码和可选 Kimi API Key
docker compose up -d --build

浏览器打开 http://127.0.0.1:8107。

默认登录账号为 admin，密码为 123456。可以通过 .env 或 docker-compose.yml 中的 PACS_WEB_USER、PACS_WEB_PASSWORD 覆盖。

本机直接启动

先在当前 shell 设置 PostgreSQL 连接信息，再启动 FastAPI：

export PGHOST=192.168.3.3
export PGPORT=5432
export PGUSER=his_user
export PGPASSWORD='请在本机填写'
export PGDATABASE=pacs_db
export PGTABLE=pacs_dicom_files
export PACS_PROCESSED_ROOT=/home/wkmgc/Desktop/Data_Disk_1/PACS数据/DICOM数据/已处理_DICOM数据

cd /home/wkmgc/Desktop/PACS数据处理/PACS_DICOM处理/数据处理网页端
uvicorn app:app --host 127.0.0.1 --port 8107

功能

• 左侧检查列表：来自 PostgreSQL pacs_dicom_files，支持按检查时间或未标注序列数升降序排序、按处理状态筛选，并在后台逐项刷新摘要。
• 中间序列列表：从已处理 DICOM 目录扫描 DICOM 头信息，支持按时间或张数升降序排序；序列读取和缩略图未完成时显示加载状态。
• 右侧查看器：支持轴位原始、矢状位重建、冠状位重建，窗宽窗位、旋转、切片进度条。
• 影像操作：支持鼠标滚轮缩放、拖拽平移、按钮缩放和复位。
• 图像叠层：可显示/隐藏患者、检查、张数、窗宽窗位和缩放信息。
• DICOM 信息：查看患者、检查、序列、像素间距、切片间距等元数据。
• 序列列表：默认按拍摄时间升序排序，可切换时间升降序或张数升降序；略过/不采用序列固定在最下方，并在略过/不采用分组内继续按当前排序规则排列。
• 序列标注：选择略过/不采用、平扫 CT、头颈部、胸部、上腹部、下腹部、盆腔；略过/不采用可与部位共存；DICOM 标识含 CHEST/ABDOMEN 时会自动预选胸部/上腹部；切换界面前会提示保存；上腹部需继续选择动脉期、门静脉期、延迟期或无法判别，胸部需继续选择肺窗、纵隔窗或无法判别。
• AI 识别：配置 Kimi 后，可把序列张数及轴位原始、矢状位重建、冠状位重建代表图像传入 AI，自动给出部位、期相和备注建议。
• 设置：支持用户创建、角色权限展示、数据库状态和 AI 配置查看。
• 标注写入 PostgreSQL 表 pacs_dicom_series_annotations，人工标注和 AI 标注分别记录。

数据安全

网页端代码不提交 DICOM 原始数据、已处理数据、处理结果和 .env。数据库密码请只放在本机环境变量或本机 .env 中。