tt-a1i/archify

Archify

เปลี่ยนโค้ดเบสหรือคำอธิบายระบบให้เป็นแผนผังระบบแบบโต้ตอบที่สวยงาม — โดยตรงในแชท

Archify คือระบบเรนเดอร์และตรวจสอบ Node.js สำหรับ Cursor, Claude Code, Codex CLI และ OpenCode เอเจนต์จะสร้าง Typed JSON IR; Archify จะคอมไพล์เป็น HTML/SVG อย่างแม่นยำ

• เปิดและนำเสนอ — แผนภาพห้าประเภท, สี่พรีเซ็ต, ธีมมืด/สว่าง, แบรนด์มาร์กในตัว และการเคลื่อนไหวที่จำกัด
• ตรวจสอบการเปลี่ยนแปลงสถาปัตยกรรมก่อนการรวมโค้ด — เปรียบเทียบสแนปช็อตที่ผ่านการตรวจสอบสองรายการเป็น Before / Delta / After พร้อมข้อเท็จจริงที่เพิ่ม, ลบ, เปลี่ยนแปลง, ย้าย และเปลี่ยนเส้นทางอย่างแม่นยำ
• ทุกการโต้ตอบยังคงมีพื้นฐาน — ค้นหาโหนด, เลือกเปิดแหล่งที่มาที่ผ่านการตรวจสอบการแก้ไข, ติดตามการเข้าถึงที่เขียนขึ้นต้นน้ำ/ปลายน้ำและเส้นทางที่แน่นอน, เปรียบเทียบบทบาท และเล่นเรื่องราวที่แนะนำโดยไม่ต้องสร้างโทโพโลยี
• ไฟล์เดียว, พร้อมเชื่อถือและแบ่งปัน — Typed JSON IR และการตรวจสอบที่แม่นยำจะสร้าง HTML ที่รวมอยู่ในตัวเอง พร้อมด้วย PNG, SVG, WebM และการ์ดแชร์ขนาด 1200×630

เวอร์ชันการพัฒนาปัจจุบัน: v2.17.0-dev.1 ดู Changelog

หน้าโปรเจกต์ · คู่มือสถานการณ์ · Proof Lab

npx skills add tt-a1i/archify -g

ใช้ Cursor อยู่ใช่ไหม? เปิด agent-aware quick start สำหรับคำสั่ง global และ project ที่แน่นอน

ไม่จำเป็นต้องมี Repository: อธิบายระบบในแชทของเอเจนต์ใดก็ได้

❤️ ผู้สนับสนุน

ดู Archify ในการทำงาน

สิ่งเหล่านี้คืออาร์ติแฟกต์ Archify ที่สร้างขึ้น ไม่ใช่ภาพจำลองผลิตภัณฑ์ คลิกที่เฟรมเพื่อเปิดสถานะที่ใช้งานได้จริงและสามารถแชร์ได้

เรื่องราวแนะนำ	การตรวจสอบเส้นทาง	เลนส์เชิงความหมาย
เล่นบทที่กำหนดชื่อบทเดียว	ตรวจสอบเส้นทางที่เขียนขึ้นโดยตรงที่สั้นที่สุด	เปรียบเทียบการรับส่งข้อมูลจริงระหว่างบทบาทเชิงความหมาย

Proof Lab มีสถานการณ์ที่ตรวจสอบแล้วทั้ง 11 รายการ, แหล่งที่มา JSON, มุมมองที่กำหนดชื่อ และใบเสร็จการตรวจสอบ

Repository จริง, แมปจากแหล่งที่มา

Archify ได้ติดตาม mco-org/mco ที่ 9f1a1cf และสร้างแผนที่ที่ตรวจสอบแล้วนี้ เปิดเลย ↗ · ติดตามการเข้าถึง ↗ · แหล่งที่มาแบบ Typed

ตัวอย่าง

แผนภาพเดียวกัน, สองธีม, คลิกเดียวเพื่อสลับ:

มืด	สว่าง

เมนู Export จะคัดลอก PNG ไปยังคลิปบอร์ดและดาวน์โหลดรูปแบบคงที่หรือแบบเคลื่อนไหว:

ใช้ Copy Share Card เมื่อคุณต้องการภาพขนาด 1200×630 ที่เป็นมาตรฐานสำหรับ README, การเผยแพร่ หรือโพสต์โซเชียล

หลังจากติดตามเส้นทางแล้ว Export → Route Share Card จะดาวน์โหลดเส้นทางที่เขียนขึ้นนั้นเป็น PNG ขนาด 1200×630 โดยยังคงแผนภาพทั้งหมดไว้เพื่อเป็นบริบท

หลังจากติดตามการเข้าถึง Upstream หรือ Downstream ที่เขียนขึ้นแล้ว Export → Reach Share Card จะจับภาพการอ่านที่แน่นอนนั้นโดยไม่กล่าวอ้างถึงผลกระทบในขณะรันไทม์

เปิด examples/web-app.html ในเครื่องเพื่อลองใช้โปรแกรมดูแบบสมบูรณ์

เริ่มต้นอย่างรวดเร็ว

1. ติดตั้ง

npx skills add tt-a1i/archify -g

สำหรับการติดตั้ง Cursor แบบชัดเจนและไม่โต้ตอบ:

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

หากต้องการลองโดยไม่ต้องติดตั้ง:

npx skills use tt-a1i/archify@archify --agent codex

DSH community opt-in: dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

ตัวสลับเอเจนต์ ครอบคลุม cursor, codex, claude-code และ opencode สำหรับการติดตั้ง ZIP ด้วยตนเองของ Raven ให้แตกไฟล์ archify.zip ไปยัง ~/.raven/workspace/skills; ซึ่งจะสร้าง ~/.raven/workspace/skills/archify Raven ไม่ใช่เป้าหมายของตัวสลับ

Archify อาจ GET manifest ที่เสถียรแบบตายตัวเพียงเพื่อแสดงการแจ้งเตือนเสริม; จะไม่มีการดาวน์โหลดหรือติดตั้งการอัปเดต การตรวจสอบที่สำเร็จจะรอประมาณ 72 ชั่วโมง (±20%); การใช้งานที่ใช้งานอยู่จะลองใหม่เมื่อเกิดข้อผิดพลาดหลังจาก 6 ชั่วโมง จากนั้น 24 ชั่วโมง เซิร์ฟเวอร์จะเห็นข้อมูลเมตา HTTP ปกติ (IP และเวลา) แต่ไม่ได้รับเวอร์ชัน, เอเจนต์, ข้อมูลโปรเจกต์, พรอมต์, ID บัญชี/อุปกรณ์ หรือ ETag คุณเป็นผู้ตัดสินใจว่าจะอัปเดตเมื่อใดและอย่างไร ตั้งค่า ARCHIFY_UPDATE_CHECK_DISABLED=1 เพื่อปิดการเชื่อมต่อเครือข่ายและการเขียนสถานะการแจ้งเตือน

2. เริ่มต้นจากคำอธิบาย — ไม่ต้องมี Repository

Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

สำหรับหลักฐานจาก Source ให้เปิด repository และถาม:

Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

3. ปรับแต่งในแชท

ดำเนินการต่อด้วยคำขอที่เน้นเฉพาะเจาะจง เช่น add Redis, move auth to the left หรือ highlight the rollback path Archify จะเก็บ source ที่พิมพ์ไว้สำหรับการปรับปรุงแบบเจาะจง

เลือกไดอะแกรมที่เหมาะสม

โปรไฟล์ deployment-ownership ที่เป็นทางเลือกของ Architecture จะล้มเหลวเมื่อเจ้าของที่ระบุ, ตำแหน่งภูมิภาค, ขอบเขตฐานข้อมูลส่วนตัว หรือการข้ามที่ระบุชื่อหายไป; มันไม่เคยเป็นโดยนัยและไม่ได้ตรวจสอบโครงสร้างพื้นฐานที่ใช้งานจริง ดู checked deployment proof

สำหรับการออกแบบหรือการตรวจสอบ PR, Architecture Delta จะเปรียบเทียบสแนปช็อต Before / Delta / After ที่ผ่านการตรวจสอบแล้วพร้อมใบเสร็จจากเครื่อง เลือกการเปลี่ยนแปลงที่ระบุหรือเล่น Review แบบจำกัด, ดูได้อย่างเดียว; มันไม่สรุปผลกระทบ, ความเสี่ยง หรือความปลอดภัยในการรวมโค้ด

node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json

ไม่แน่ใจว่าอันไหนเหมาะสม? ใช้ interactive scenario guide หรือสอบถาม CLI ที่ไม่มี dependency:

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Workflow ทำให้เส้นทางปกติชัดเจนในแต่ละเลน:

Sequence อธิบายการโต้ตอบหนึ่งครั้งในช่วงเวลาหนึ่ง:

Data Flow ทำให้การเคลื่อนไหวและขอบเขตความละเอียดอ่อนชัดเจน:

Lifecycle แยกความคืบหน้า, การรอ, การลองใหม่ และผลลัพธ์สุดท้าย:

ตัวอย่าง Architecture: web-app · Archify pipeline · grid placement · desktop agent

ทำไมต้อง Archify

• การตัดสินใจจัดวางแทนการจัดวางอัตโนมัติแบบทั่วไป — Agent จะเลือกโครงสร้างลำดับชั้น, ระยะห่าง, เส้นทาง และการเน้น; จุดสิ้นสุดอัตโนมัติที่ใช้ร่วมกันจะกระจายอย่างเป็นระเบียบแทนที่จะซ้อนลูกศรบนจุดกึ่งกลางเดียว
• Typed JSON IR — ทุกโหมดที่รองรับ Renderer มี Schema และ Source ที่สามารถสร้างซ้ำได้
• การตรวจสอบแบบ Atomic ก่อนการส่งมอบ — การตรวจสอบ Schema, การจัดวาง, HTML/SVG, เส้นทาง และการเคลียร์ Label-to-route ทั้งหมดต้องผ่านก่อนที่ Artifact ที่แสดงจะมาแทนที่ Output ที่ดีที่สุดที่ทราบล่าสุด
• ความล้มเหลวมาพร้อมกับใบเสร็จการซ่อมแซม — validate --json และ deliver --json จะส่งคืนรหัสกฎที่เสถียร, Subject ที่แน่นอน, หลักฐานที่วัดได้ และการควบคุมการซ่อมแซมที่รองรับเท่านั้น แทนที่จะเป็น Node stack หรือการคาดเดาการลองใหม่ที่ไม่มีโครงสร้าง
• Last-good live preview — ลูปเดสก์ท็อปที่เป็นทางเลือกจะเฝ้าดูไฟล์ JSON หนึ่งไฟล์, รีเฟรชเฉพาะหลังจากที่ Candidate ล่าสุดผ่านทุกเกต และแสดงไดอะแกรมที่ตรวจสอบแล้วก่อนหน้าเมื่อการบันทึกไม่สมบูรณ์หรือไม่ถูกต้อง
• การโต้ตอบที่แท้จริง — การโฟกัส, การเข้าถึง Upstream/Downstream, เส้นทางที่แน่นอน, การเปรียบเทียบบทบาท และเรื่องราวจะใช้ Node และความสัมพันธ์ที่ระบุไว้ซ้ำ แทนที่จะสร้าง Topology หรืออ้างสิทธิ์ผลกระทบใน Runtime
• หลักฐานจาก Source, เฉพาะเมื่อร้องขอ — Node Architecture ที่มีหลักฐานจะทำเครื่องหมายตัวเองว่า SRC n และเปิดไฟล์และช่วงบรรทัดที่ตรวจสอบโดย Git ซึ่งปักหมุดไว้ที่ Commit สาธารณะหนึ่งรายการ; Artifact ทั่วไปจะยังคงไม่มี Source
• พกพาได้โดยค่าเริ่มต้น — ผลลัพธ์คือไฟล์ HTML หนึ่งไฟล์; การส่งออกยังคงเป็นไดอะแกรมเต็มรูปแบบและไม่มีสถานะ Viewer ชั่วคราว

Archify ไม่ใช่โปรแกรมแก้ไขภาพวาดทั่วไปหรือธีม Mermaid มันเปลี่ยนความตั้งใจทางเทคนิคให้เป็น Artifact สำหรับการสื่อสาร

วิธีการทำงาน

คำสั่ง Repository ที่มีประโยชน์:

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

preview เป็นโหมดเดสก์ท็อปแบบ Loopback เท่านั้นที่ชัดเจน: มันจะเฝ้าดูไฟล์ JSON หนึ่งไฟล์บนพอร์ต 127.0.0.1 แบบสุ่ม, เก็บ Output ที่ตรวจสอบแล้วล่าสุดไว้แม้จะเกิดความล้มเหลว, หยุดด้วย Ctrl-C และไม่เพิ่ม Runtime ของ HTML ที่สร้างขึ้น ใช้ --no-open สำหรับการทดสอบหรือการเปิด URL ด้วยตนเอง

deliver --open เป็นการส่งมอบแบบครั้งเดียวหลังจาก Commit ที่เลือกใช้ได้ ความล้มเหลวของ Opener จะรักษาความสำเร็จไว้; JSON ยังคงอยู่บน stdout และเส้นทางสำรองแบบ Absolute จะไปที่ stderr

เมื่อเกิดความล้มเหลว, validate --json และ deliver --json จะส่งออกออบเจกต์ JSON หนึ่งรายการ ใช้เฉพาะ supportedFixes ของ Subject ใน diagnostics[] ภายในสองรอบการแก้ไขของ Skill; การตรวจสอบด้วยสายตายังคงแยกต่างหาก

การตั้งค่า:

{
  "meta": {
    "locale": "en",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

meta.locale=en|zh-CN จะแปลชื่อหน้า, Legend, สถานะ/ข้อผิดพลาด, a11y, HTML/SVG lang — ไม่ใช่เนื้อหาที่ระบุไว้ มิฉะนั้นให้ละเว้น; รักษาสำเนาภาษาที่ร้องขอ; เปิดเผยภาษาอังกฤษสำรอง Static จะละเว้น animation; classic เป็นค่าเริ่มต้น

สำรวจและแบ่งปัน Output

ลิงก์ที่เสถียรสามารถกู้คืน #focus=<id>, #focus=<id>&reach=upstream|downstream, #relation=<id>, #route=<source>~<target>, #lens=<kind>~<kind> และ #view=<view-id> การเคลื่อนไหวที่ขับเคลื่อนโดยผู้อ่านมีจำกัด, เคารพ prefers-reduced-motion และไม่เคยเข้าสู่การส่งออก Canonical

สัญญาการสร้างและ Viewer ที่สมบูรณ์อยู่ใน archify/SKILL.md

ตัวเลือกการติดตั้ง

การอ้างอิงและขอบเขต

• การอ้างอิง Schema · ทักษะ · ตัวอย่าง · ตำรา Agent
• บันทึกการเปลี่ยนแปลง
• แผนงาน
• ห้องปฏิบัติการพิสูจน์ที่สร้างขึ้น

การแยกวิเคราะห์ Mermaid อัตโนมัติ, การจัดวางอัตโนมัติแบบทั่วไป, การแชร์แบบโฮสต์ และการแก้ไขแบบ WYSIWYG อยู่นอกขอบเขตปัจจุบันโดยเจตนา

ใบอนุญาต

MIT — ใช้งาน แก้ไข และเผยแพร่ได้ฟรี

การมีส่วนร่วม

ยินดีรับ Issues, pull requests และไดอะแกรมจากโลกจริง เริ่มต้นด้วย คู่มือการมีส่วนร่วม, ใช้แบบฟอร์มรายงานข้อผิดพลาดที่สามารถทำซ้ำได้สำหรับความล้มเหลว หรือส่งไดอะแกรมที่ผ่านการตรวจสอบแล้วผ่าน แบบฟอร์มแสดงผลงานของชุมชน  · LINUX DO

ประวัติ Star