สำหรับนักพัฒนา

Site Code

anasaki-code CLI

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

อ่าน 8 นาทีอัปเดตล่าสุด

ดูเป็น Markdown

ในหน้านี้

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

ติดตั้ง#

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

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

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

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

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

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

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

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. แก้ ส่งขึ้น และเผยแพร่#

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

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

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

คำสั่งทำอะไร
login <site> [--token ast_...]ตรวจโทเค็นแล้วเก็บใน ~/.anasaki/credentials.json แยกตามเว็บ
logout [site]ลบโทเค็นที่เก็บไว้
init [site] [--dir <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 <msg>] [--yes]build, แสดง migration, ถามยืนยันถ้าอาจทำให้ข้อมูลหาย (--yes ข้าม — จำเป็นเมื่อรันแบบไม่มีคนตอบ) แล้วเผยแพร่
logs [--follow] [--unit <id>] [--level <l>] [--limit n]ดู log (--unit = site หรือ id ของปลั๊กอิน JavaScript)
typesอัปเดต anasaki.d.ts (หลังเพิ่ม migration หรือเปลี่ยนปลั๊กอิน)

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

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

  • anasaki.json — { "site": "https://example.com", "dir": "." } ไม่มีความลับ 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:

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

เมื่อเกิด conflict#

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

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

แก้ปัญหา#

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