用途：处理 10x Genomics Visium 或 Xenium 空间转录组数据，把基因表达投影回组织切片图像，生成“基因空间”分布图，适用于基因表达可视化、空间聚类分析与形态特征相关性研究。
主要能力：支持 Visium（Space Ranger 输出，如 filtered_feature_bc_matrix.h5、spatial/tissue_positions_list.csv、低分辨率 H&E 图）与 Xenium（.h5、transcripts.parquet、nucleus_boundaries.parquet 等）两类数据；可映射指定基因表达、多基因联合可视化、显示 Seurat/Scanpy 聚类结果的空间分布，并支持高分辨率图像导出。
使用方式：依赖 Python 3.10+，安装命令 pip install scanpy squidpy matplotlib seaborn pillow numpy pandas h5py，可选 pyarrow dask 及 opencv-python scikit-image。校验与运行命令：python -m py_compile scripts/main.py；python scripts/main.py --help。典型运行：python scripts/main.py --platform visium --data-dir /path/to/spaceranger/outs/ --gene PIK3CA --output ./output/。主要参数包括 --platform、--data-dir、--gene/--genes、--mode、--cluster-file、--output、--dpi、--cmap、--spot-size、--alpha、--min-count、--crop 等。输出含单基因空间图、热图、多基因叠加图、聚类空间图与 combined_report.html。
适用场景与限制：面向已具备上述格式输入数据的空间转录组分析任务，运行本地脚本，不调用外部 API，结果为可复现的受控输出；Visium 默认使用低分辨率图像，大样本可用 --crop 或降采样；缺失输入需先补齐，脚本失败应报告失败点并给出人工回退路径。价格、平台覆盖范围等未提供。