Site Code
anasaki-code CLI
ดึง Site Code มาแก้ใน VS Code พร้อม type ครบ แล้ว push, watch และ publish จาก terminal — ตั้งแต่สร้างโทเค็นจนถึงแก้ conflict
ในหน้านี้
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. สร้างโทเค็น#
- ในหลังบ้าน: บัญชีของฉัน → โทเค็นสำหรับเครื่องมือ → สร้างโทเค็น
- ตั้งชื่อ (เช่น "โน้ตบุ๊กที่ทำงาน") เลือก อายุโทเค็น (30 วัน, 90 วัน, 1 ปี หรือไม่หมดอายุ) และขอบเขต code
- คัดลอกโทเค็น (
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:
anasaki-code pull— ดึงไฟล์อื่นทั้งหมดและแสดงรายการไฟล์ที่ชนกัน (ไฟล์ของคุณยังอยู่)- สำรองไฟล์ของคุณ แล้ว
anasaki-code pull --forceเพื่อรับไฟล์จากเซิร์ฟเวอร์ แล้วรวมการแก้ไขของคุณกลับเข้าไป 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 . _ - ในแต่ละส่วนของพาธ) |
