Quick Start

快速入门

1. 安装

Windows

# 下载最新 release
# https://github.com/Linxira-OS/linxira-bio-sdk/releases

# 或从源码构建
git clone https://github.com/Linxira-OS/linxira-bio-sdk.git
cd linxira-bio-sdk
cargo build --release -p linxira-bio-cli

Debian / Arch Linux

git clone https://github.com/Linxira-OS/linxira-bio-sdk.git
cd linxira-bio-sdk
cargo build --release -p linxira-bio-cli

2. 环境检测

运行环境检测，查看本地已安装的工具：

linxira-bio environment audit --json

输出示例：

{
  "arch": "x86_64",
  "os": "windows",
  "tools": [
    {"name": "rustc", "available": true, "version": "1.97.1"},
    {"name": "python", "available": true, "version": "3.10.11"},
    {"name": "r", "available": true, "version": "4.6.1"},
    {"name": "samtools", "available": false}
  ]
}

3. 第一个分析

序列统计

linxira-bio sequence stats your_sequences.fa --json

返回：

{
  "schema_version": "1",
  "capability": "sequence.stats.v1",
  "status": "ok",
  "result": {
    "sequence_count": 150,
    "total_bases": 45000,
    "min_length": 100,
    "max_length": 500,
    "mean_length": 300.0,
    "n50": 350,
    "gc_percent": 48.5
  }
}

4. 导出结果

# 导出为 Excel
linxira-bio export table result.json result.xlsx

# 导出为 CSV
linxira-bio export table result.json result.csv

# 导出为 TSV
linxira-bio export table result.json result.tsv

5. 使用桌面应用

cargo run -p linxira-bio-ui

桌面应用提供 4 步工作流：

1. 导入数据 — 拖拽或选择文件
2. 数据检查 — 自动检测格式和统计
3. 选择分析 — 从 50+ 能力中选择
4. 查看结果 — 表格、图表、结构查看