# fast

**Repository Path**: yanghaijin/fast

## Basic Information

- **Project Name**: fast
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# fast

瘦壳 + 按需插件。`build.sh` 只负责构建并上传到 OSS，不安装到本机。

同事装壳（无需克隆仓库）：

```bash
curl -fsSL https://gardens.oss-cn-beijing.aliyuncs.com/fast/install.sh | sh
```

装好后使用 `fast`。仓库里也可以跑 `./fast.sh`，它会转到 `install.sh`。

## 前置

- macOS
- Python 3
- `plugins/manifest.json` 已填写 `source.oss`、`source.base`、`source.ak`

脚本会自动检查并重建仓库内 `.venv`。

## 用法

```bash
./build.sh [目标] [--no-bump]
```

目标和 `--no-bump` 顺序不限。

| 命令 | 做什么 | 版本怎么加 |
|------|--------|------------|
| `./build.sh` | 打壳 + 全部轻量插件，上传全部 zip 和 manifest | 只给壳 +1 |
| `./build.sh all` | 上面再加上 `atlas.gui` | 壳和全部插件 +1 |
| `./build.sh atlas-gui` | 只打 `atlas.gui`（会装 PySide6，体积大） | 只给 `atlas.gui` +1 |
| `./build.sh cc` | 只打并上传该插件 | 只给该插件 +1 |
| `./build.sh --no-bump` | 同上，但不改版本号 | 不 +1 |
| `./build.sh -h` | 打印帮助 | — |

插件名可用清单里的 id，也可用别名，例如 `cut-ttf`、`atlas-cli`。

当前插件：`cc`、`stat`、`xor`、`xlsx`、`audio`、`json`、`atlas`、`atlas.gui`、`bmfont`、`ttf`、`alioss`、`apk`、`pngyu`、`lanhu`。

## 蓝湖

```bash
fast lanhu set
fast lanhu --url "<蓝湖 detailDetach 链接>" --out <目录>
fast lanhu --url "<蓝湖 detailDetach 链接>" --out <目录> --pngyu
fast lanhu --url "<蓝湖 detailDetach 链接>" --out <目录> --cookie <Cookie>
```

`fast lanhu set` 会在终端询问并保存全局 Cookie（存到 `~/fast/config/lanhu.json`）。下载时不传 `--cookie` 则用已保存的；首次未保存也会在终端询问。`--pngyu` 会压缩整个输出目录里的 PNG（含切图和效果图）。

开发测试（仓库内，绝对路径）：

```bash
/Users/shinet/Documents/ai/fast/.venv/bin/python /Users/shinet/Documents/ai/fast/fast.py lanhu set

/Users/shinet/Documents/ai/fast/.venv/bin/python /Users/shinet/Documents/ai/fast/fast.py lanhu \
  --url "https://lanhuapp.com/web/#/item/project/detailDetach?pid=<pid>&tid=<tid>&image_id=<image_id>" \
  --out /Users/shinet/Documents/ai/fast/tmp/lanhu-test

/Users/shinet/Documents/ai/fast/.venv/bin/python /Users/shinet/Documents/ai/fast/fast.py lanhu \
  --url "https://lanhuapp.com/web/#/item/project/detailDetach?pid=<pid>&tid=<tid>&image_id=<image_id>" \
  --out /Users/shinet/Documents/ai/fast/tmp/lanhu-test \
  --pngyu
```

## Play / apk

```bash
fast apk /path/to/app.apk
fast apk "https://jenkins.../job/..."
fast apk "https://play.google.com/store/apps/details?id=<包名>"
fast apk "https://play.google.com/store/apps/details?id=<包名>" --force
```

已下载则跳过；`--force` 强制重下。有授权安卓设备才安装。

## 版本

默认每次构建会给对应目标做 patch +1，并写入 `plugins/manifest.json` 的 `version` / `versions`。打壳时同步 `VERSION`。

正式发固定版本（例如全员 1.0.0）时不要自动加号：

```bash
./build.sh --no-bump
./build.sh atlas-gui --no-bump
```

## 产物

- 壳：`dist/fast/`，再打成 `dist/plugins/fast-<version>.zip`
- 轻量插件：`dist/plugins/<插件>-<version>.zip`
- `atlas.gui`：`dist/atlas-gui/`，再打成 `dist/plugins/atlas.gui-<version>.zip`

上传地址由 `plugins/manifest.json` 的 `source.oss` 决定。公开下载前缀是 `source.base`。

指定插件时只上传该插件 zip 和 manifest，不会把 `dist/plugins` 里其它旧包一并传上去。

## 注意

- 默认构建不含 `atlas.gui`，需要单独跑或用 `all`
- 构建不拷贝到 `~/fast`，也不清本地缓存
- 同事安装：`curl -fsSL https://gardens.oss-cn-beijing.aliyuncs.com/fast/install.sh | sh`（只换壳，保留 cache / config / plugins）