# anasaki-code CLI

> ดึง Site Code มาแก้ใน VS Code พร้อม type ครบ แล้ว push, watch และ publish จาก terminal — ตั้งแต่สร้างโทเค็นจนถึงแก้ conflict

ที่มา: https://anasaki.live/docs/developers/cli

`anasaki-code` เก็บ Site Code ของเว็บไว้ในโฟลเดอร์ในเครื่อง ให้คุณแก้ใน VS Code (มี type จาก `anasaki.d.ts`) แล้วซิงก์ / ดู log / เผยแพร่จาก terminal ต้องใช้ **Node.js ≥ 20** ไม่มี dependency เพิ่ม

## ติดตั้ง

CLI อยู่ในโฟลเดอร์ `cli/` ของ repository Anasaki Studio:

```sh
git clone https://github.com/Kiroriya/AnasakiStudioOfficial.git
npm install -g ./AnasakiStudioOfficial/cli     # ได้คำสั่ง anasaki-code
anasaki-code --help
```

หรือรันตรงโดยไม่ติดตั้ง: `node AnasakiStudioOfficial/cli/bin/anasaki-code.mjs --help`

> [!NOTE]
> เมื่อแพ็กเกจ `anasaki-code` เผยแพร่บน npm แล้ว จะใช้ `npx anasaki-code …` ได้เลยโดยไม่ต้อง clone

## 1. สร้างโทเค็น

1. ในหลังบ้าน: **บัญชีของฉัน → โทเค็นสำหรับเครื่องมือ → สร้างโทเค็น**
2. ตั้งชื่อ (เช่น &#34;โน้ตบุ๊กที่ทำงาน&#34;) เลือก **อายุโทเค็น** (30 วัน, 90 วัน, 1 ปี หรือไม่หมดอายุ) และขอบเขต **code**
3. คัดลอกโทเค็น (`ast_…`) เก็บไว้ — **แสดงเพียงครั้งเดียว**

สิทธิ์ของโทเค็นเท่ากับตำแหน่งของคุณ: `view_scripts` ดึงไฟล์/ดู log, `edit_scripts` ส่งขึ้น, `publish_scripts` เผยแพร่ โทเค็นใช้ได้เฉพาะ `/api/v1/code/**` และจะใช้ไม่ได้ทันทีเมื่อถูกยกเลิก หมดอายุ หรือเจ้าของเปลี่ยนรหัสผ่าน

## 2. เริ่มโปรเจกต์

```sh
anasaki-code login https://example.com      # วางโทเค็น (หรือ --token ast_...)
mkdir my-site && cd my-site
anasaki-code init https://example.com       # สร้าง anasaki.json + tsconfig.json + .anasakiignore แล้ว pull
code .
```

VS Code อ่าน `anasaki.d.ts` ผ่าน `tsconfig.json` ทันที — global ทุกตัว (`site`, `db`, `log`, `mail`, `http`, `jobs`, `plugins`…) และโมดูลของปลั๊กอิน JavaScript ที่เปิดอยู่ถูก autocomplete และตรวจ type

## 3. แก้ ส่งขึ้น และเผยแพร่

```sh
anasaki-code watch                          # push ทุกครั้งที่บันทึก (หน่วง 300 ms) และแสดงข้อผิดพลาดของ build
anasaki-code publish -m &#34;เพิ่มหน้าชำระเงิน&#34;    # build → แสดง migration ที่ค้าง → ถามก่อนถ้าอาจทำให้ข้อมูลหาย → เผยแพร่
```

ทุกอย่างที่ส่งขึ้นไปลง **ฉบับร่าง** บนเซิร์ฟเวอร์ (ร่างเดียวกับที่ editor บนเว็บใช้) เว็บจริงเปลี่ยนเมื่อ `publish` เท่านั้น

## คำสั่งทั้งหมด

| คำสั่ง | ทำอะไร |
| --- | --- |
| `login [--token ast_...]` | ตรวจโทเค็นแล้วเก็บใน `~/.anasaki/credentials.json` แยกตามเว็บ |
| `logout [site]` | ลบโทเค็นที่เก็บไว้ |
| `init [site] [--dir ]` | สร้าง `anasaki.json`, `tsconfig.json`, `.anasakiignore` แล้ว `pull` |
| `pull [--force]` | ดาวน์โหลดร่างและ `anasaki.d.ts` — ไฟล์ที่คุณแก้ในเครื่องไม่ถูกเขียนทับ (แจ้งเป็น conflict) เว้นแต่ใส่ `--force` |
| `push [--dry-run] [--delete]` | ส่งไฟล์ที่เปลี่ยนในคำขอเดียว (ทั้งหมดหรือไม่มีเลย) ไฟล์ที่ลบในเครื่องจะลบบนเซิร์ฟเวอร์เฉพาะเมื่อใส่ `--delete` |
| `status` | เทียบไฟล์ในเครื่อง ร่างบนเซิร์ฟเวอร์ และการซิงก์ครั้งล่าสุด |
| `watch [--debounce ms] [--poll ms]` | push ครั้งแรก แล้ว push ทุกครั้งที่บันทึก — **ไม่ลบไฟล์บนเซิร์ฟเวอร์** |
| `publish [-m ] [--yes]` | build, แสดง migration, ถามยืนยันถ้าอาจทำให้ข้อมูลหาย (`--yes` ข้าม — จำเป็นเมื่อรันแบบไม่มีคนตอบ) แล้วเผยแพร่ |
| `logs [--follow] [--unit ] [--level ] [--limit n]` | ดู log (`--unit` = `site` หรือ id ของปลั๊กอิน JavaScript) |
| `types` | อัปเดต `anasaki.d.ts` (หลังเพิ่ม migration หรือเปลี่ยนปลั๊กอิน) |

Exit code: `0` สำเร็จ · `1` ผิดพลาด (เครือข่าย การยืนยันตัวตน วิธีใช้) · `2` conflict, ไม่ผ่านการตรวจ หรือ build ผิดพลาด

## ไฟล์ในโปรเจกต์

- **`anasaki.json`** — `{ &#34;site&#34;: &#34;https://example.com&#34;, &#34;dir&#34;: &#34;.&#34; }` ไม่มีความลับ commit ได้
- **`.anasaki/state.json`** — hash ของการซิงก์ครั้งล่าสุด อย่า commit ถ้าหลายคนใช้โฟลเดอร์ร่วมกัน
- **`.anasakiignore`** — รูปแบบคล้าย `.gitignore` ซิงก์เฉพาะ `.ts .js .mjs .json .md` และข้ามไฟล์จุด `node_modules/` และ `anasaki.d.ts` / `tsconfig.json` ที่รากเสมอ

## ตัวแปรสภาพแวดล้อม

| ตัวแปร |  |
| --- | --- |
| `ANASAKI_TOKEN` | โทเค็นที่ใช้แทนที่เก็บไว้ — เหมาะกับ CI |
| `ANASAKI_LANG` / `LANG` | ข้อความเป็นภาษาไทยเมื่อค่าขึ้นต้นด้วย `th` (เช่น `ANASAKI_LANG=th`) |
| `ANASAKI_CONFIG_DIR` | ที่เก็บ `credentials.json` (ค่าเริ่มต้น `~/.anasaki`) |

## แสดงข้อผิดพลาดใน VS Code (Problems)

ข้อผิดพลาดของ build พิมพ์เป็น `path:line:column: error: message` และ `watch` พิมพ์ `[anasaki] sync start` / `[anasaki] sync done` ใส่ใน `.vscode/tasks.json`:

```json
{
  &#34;version&#34;: &#34;2.0.0&#34;,
  &#34;tasks&#34;: [
    {
      &#34;label&#34;: &#34;anasaki: watch&#34;,
      &#34;type&#34;: &#34;shell&#34;,
      &#34;command&#34;: &#34;anasaki-code watch&#34;,
      &#34;isBackground&#34;: true,
      &#34;problemMatcher&#34;: {
        &#34;owner&#34;: &#34;anasaki&#34;,
        &#34;fileLocation&#34;: [&#34;relative&#34;, &#34;${workspaceFolder}&#34;],
        &#34;pattern&#34;: {
          &#34;regexp&#34;: &#34;^(.+?):(\\d+):(\\d+): (error|warning): (.*)$&#34;,
          &#34;file&#34;: 1, &#34;line&#34;: 2, &#34;column&#34;: 3, &#34;severity&#34;: 4, &#34;message&#34;: 5
        },
        &#34;background&#34;: {
          &#34;activeBegin&#34;: &#34;^\\[anasaki\\] sync start&#34;,
          &#34;endsPattern&#34;: &#34;^\\[anasaki\\] sync done&#34;
        }
      }
    }
  ]
}
```

## เมื่อเกิด conflict

ถ้าไฟล์เดียวกันถูกแก้ทั้งในเครื่องและบนเว็บ (มีคนบันทึกใน editor บนเว็บ) `push` จะไม่ส่งอะไรเลยและจบด้วย exit 2:

1. `anasaki-code pull` — ดึงไฟล์อื่นทั้งหมดและแสดงรายการไฟล์ที่ชนกัน (ไฟล์ของคุณยังอยู่)
2. สำรองไฟล์ของคุณ แล้ว `anasaki-code pull --force` เพื่อรับไฟล์จากเซิร์ฟเวอร์ แล้วรวมการแก้ไขของคุณกลับเข้าไป
3. `anasaki-code push`

## แก้ปัญหา

| อาการ | สาเหตุ / วิธีแก้ |
| --- | --- |
| 401 | โทเค็นถูกยกเลิก หมดอายุ หรือเปลี่ยนรหัสผ่านแล้ว — สร้างโทเค็นใหม่แล้ว `anasaki-code login` |
| 403 `token scope` | endpoint อยู่นอก `/api/v1/code/**`; 403 แบบอื่น = ตำแหน่งของคุณไม่มีสิทธิ์นั้น |
| exit 2 ตอน push | มีไฟล์ถูกแก้บนเซิร์ฟเวอร์หลัง pull ครั้งล่าสุด — ทำตามหัวข้อ conflict ด้านบน |
| ไฟล์ถูกแจ้งว่า skipped | นามสกุลหรือชื่อไฟล์ไม่รองรับ (ใช้ได้เฉพาะ `A-Z a-z 0-9 . _ -` ในแต่ละส่วนของพาธ) |
