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

输出示例（简化为代表性字段）：

{
  "schema_version": "1",
  "job_id": "environment-audit",
  "capability": "environment.audit.v1",
  "status": "ok",
  "result": {
    "platform": {"os": "windows", "arch": "x86_64", "supported": true},
    "tools": [
      {"id": "rustc", "display_name": "Rust", "category": "compiler", "available": true, "version": "1.97.1"},
      {"id": "python", "display_name": "Python", "category": "runtime", "available": true, "version": "3.10.11"},
      {"id": "r", "display_name": "R", "category": "runtime", "available": true, "version": "4.6.1"},
      {"id": "samtools", "display_name": "SAMtools", "category": "native-tool", "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. 选择分析 — 从 115 项能力中选择
4. 查看结果 — 表格、图表、结构查看