# Astar-Tools

**Repository Path**: astro-byte/astar-tools

## Basic Information

- **Project Name**: Astar-Tools
- **Description**: 面向星载存储、在轨验证、地面联调与工程交付的一体化工具仓库。 
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Astar-tools

**Astar 星载工程工具集**

面向星载存储、在轨验证、地面联调与工程交付的一体化工具仓库。  
这里不只是脚本清单，而是把「测得到、对得上、交得出」的工程能力沉淀成可复用的资产。

---

## 定位

Astar-tools 服务整条星载工程链路：

| 阶段 | 目标 |
|------|------|
| **选型与验收** | 器件/介质是否满足星载与地面指标 |
| **地面联调** | 协议、链路、过境与业务逻辑是否闭环 |
| **在轨验证** | 长稳、抖动、异常与可观测性是否够用 |
| **交付归档** | 结果可复现、报告可对账、资产可交接 |

一句话：让星载相关的测试、验证与交付，从「个人终端里的临时命令」变成「团队可继承的工程底座」。

---

## 能力版图（规划）

```
Astar-tools
├── storage/          存储介质验收（NVMe / 文件系统 / NFS / 未来扩展）
├── link/             链路与接口（地面站侧、调试链路、吞吐与时延）
├── mission/          任务与过境相关验证辅助
├── report/           规范化报告与结果归档
├── common/           公共运行时（权限、环境探测、结果目录约定）
└── docs/             规格、报告模板与工程说明
```

当前已落地的是 **存储验收** 与 **报告归档** 的第一批能力；其余目录随项目推进逐步补齐。仓库结构允许演进，但不改变「可复现、可对比、可交付」的原则。

---

## 设计原则

1. **指标对齐规格**  
   测试项尽量能映射到器件规格书 / 产品指标，而不是只跑“看起来很快”的用例。

2. **结果即产物**  
   每次运行产出结构化目录：环境摘要、原始数据、规范化 `RESULT.md` / `summary.json`，方便对比与归档。

3. **同一套方法，多目标复用**  
   同一套套件可切不同 DUT（星载盘、本机盘、NFS 等），避免“换盘就换脚本”。

4. **先工程、后花活**  
   优先保证可跑通、可解释、可交接；自动化与可视化在稳定基线上叠加。

5. **历史可追溯**  
   旧结果目录可保留；新结果写入统一 `results/`，脚本与数据生命周期分离。

---

## 当前可用

> 以下为已落地入口；完整版图见上文「能力版图」。

### 存储验收（`nvme/` · `nfs/`）

```bash
cd ~/work/Astar-tools

# NVMe 完整套件（规格 / 带宽 / 延迟抖动 / 流水线）
./nvme/run_full_nvme_bench.sh

# 快速规格对照
./nvme/run_full_nvme_bench.sh --quick

# 本机盘对照
./nvme/run_compare_local.sh

# NFS 测速（规范化 RESULT.md）
./nfs/run_nfs_bench.sh
```

默认结果目录：`./results/<TAG>/`  
也可用环境变量覆盖挂载点、DUT、输出根目录等（详见各脚本 `--help`）。

### 文档与报告（`docs/`）

沉淀规格对照报告、综合测试结论与长稳观察说明，作为交付与复盘材料，而不是一次性聊天记录。

---

## 使用约定

- **入口在仓库内**：以 `Astar-tools` 为工作根，不依赖个人机器上散落的历史路径。
- **结果进 `results/`**：原始 fio/日志与汇总报告同次归档；对比时用 TAG，不用“记得大概哪天跑过”。
- **公共辅助在 `common/`**：如 askpass 等本地敏感辅助，不进入业务逻辑脚本本身。
- **兼容旧路径**：`~/nvme_bench/` 下同名脚本可软链至本仓库，历史结果目录可继续保留。

---

## 谁适合用

- 做星载存储 / 地面验收的硬件与系统工程师  
- 需要把联调结果固化成可交付报告的项目成员  
- 希望把“能跑一次”升级成“团队标准流程”的负责人  

---

## 路线图（简）

- [x] NVMe 完整验收套件 + 规范化汇总  
- [x] NFS 测速脚本化与 RESULT 规范化  
- [x] 本机盘对照入口  
- [ ] 更统一的结果 schema（跨套件对比一键生成）  
- [ ] 链路 / 任务侧验证工具接入同一报告体系  
- [ ] CI 或定时任务触发的回归烟测  

---

## 许可证与归属

内部工程工具仓库，默认仅限 Astar / 项目相关协作使用。  
对外分发与开源策略以项目约定为准。

---

**Astar-tools —— 把星载工程里反复要用的能力，收成一套拿得出手的工具。**