---
# System prepended metadata

title: 如何使用NCAIC CLI Toolkit
tags: [NCAIC 2022]

---

---
disqus: ncaic
---

# 如何使用NCAIC CLI Toolkit

https://github.com/NCAIC/Toolkit

Toolkit 可以幫助你測試程式能否在競賽系統上運行

## 安裝

有很多種方法可以使用Toolkit

### NPM

環境需求: Node.js

```sh
npm i -g ncaic
```

### `npx` or `pnpm dlx`

環境需求: Node.js, PNPM (optional)




```sh
npx -y ncaic
```

or

```sh
pnpm dlx ncaic #Windows系統建議使用這個
```

### 使用 Docker Image

需求: Docker


```sh
docker run --rm jacoblincool/ncaic
```

你可以這樣使用指令:

```sh
docker run --rm jacoblincool/ncaic check
```

> Note: Images are hosted on Docker Hub: [jacoblincool/ncaic](https://hub.docker.com/r/jacoblincool/ncaic/)

## 指令

### 查看指令說明

```sh
ncaic --help
```

你可以輸入 `ncaic <command> --help` 查看特定指令的說明

### 檢查你的系統支援哪些語言

```sh
ncaic check
```

### 驗證 `team.json` 

```sh
ncaic verify
```

### 測試你的程式是否正確輸入與輸出

```sh
ncaic test
```
輸入為規則提供的範例輸入，輸出檢測是否下在合法的格子內

### 創建與初始化config檔

```sh
ncaic init
```
`config.yml`設定請參見[Toolkit設定檔](/@NCAIC/toolkit-config)
### 運行本地的競賽系統

**必須先做過`ncaic init`**
```sh
ncaic run
```

### 運行效能測試

會顯示目前你的電腦運行我們的測試程式需要跑多久，這可以幫助你估計在我們的主機中，你的程式會需要跑多久。

```sh
ncaic perf
```
NCAIC官方主機參考效能：
```
  JavaScript : 795.34 ms
  TypeScript : 793.67 ms
           C : 50.67 ms
         C++ : 48.50 ms
      Python : 1128.84 ms
          Go : 62.17 ms
        Rust : 57.50 ms
```
###### tags: `NCAIC 2022`