# BamZap

**Repository Path**: snoware/bamzap

## Basic Information

- **Project Name**: BamZap
- **Description**: 包管理器+部署工具+审计工具等
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BamZap — Soup 伴生孵化项目（包管理 · 分发）

**独立仓库**（snoware/bamzap）：soup 主仓内保留本目录作为副本/镜像源。

内容寻址对象池 + 后量子签名（soupq）+ HTTPS 分发 + 声明式部署（HetuFile）。
半独立于 Soup：一个 `bamzap.sar` 即完整客户端，仅需 `soupx`（+ `soup55b.dll`）运行。

## 别名

- `sk` = bamzap
- `soupkg` = bamzap（兼容旧名）

## 构建（soupmake）

```bash
soupmake            # 打包 bamzap.sar（用 Soupfile 或 LanTuFile.sml）
soupmake test       # 端到端自测（e2e_test.py）
```

## 快速开始

```bash
soupx bamzap.sar keygen myorg
soupx bamzap.sar trust add <fp> "myorg release key"
export SOUPKG_SIGN_ID=myorg
soupx bamzap.sar pool register myapp ./myapp/
soupx bamzap.sar verify myapp
soupx bamzap.sar bare run myapp Alice
```

## 能力

- 内容寻址对象池（sha256，跨版本去重）
- content-defined chunking（平均 ~1MiB，断点下载）
- 后量子签名 soupq（SPHINCS+ 风格，底层 SM3）
- deny-by-default 信任库
- HTTPS 对象空间分发（curl，凭据走环境变量）
- HetuFile.sml 声明式部署 + LanTuFile.sml 构建配置

## 目录

- `bamzap.soup` 客户端入口（`main.lua` 为 .sar 归档入口）
- `lib/` 核心模块（pool/ref/remote/verify/sign/trust/bare/chunk/sml/…）
- `bin/` 启动器（bamzap / sk / soupkg 别名）
- `docs/` 使用文档
- `e2e_test.py` 端到端自测

## 依赖

- `soupx` + `soup55b.dll`（Soup 运行时）
- `soupq.dll`（后量子签名，可选；缺则回退 smx/openssl）
- `termctl.dll`（终端美化，可选）

## License

MulanPSL-2.0