dir2md v1.0.4 — CLI สำหรับแปลงโค้ดเบสโอเพนซอร์สเป็น Markdown ที่เป็นมิตรกับ LLM อัปเดตครั้งใหญ่

🔥 dir2md v1.0.4 — CLI สำหรับแปลงโค้ดเบสโอเพนซอร์สเป็น Markdown ที่เป็นมิตรกับ LLM อัปเดตครั้งใหญ่

dir2md เป็นเครื่องมือ CLI โอเพนซอร์สที่สแกนรีโพซิทอรีแบบโลคัลหรือรีโมต แล้วสร้างโครงสร้างไดเรกทอรี + เนื้อหาไฟล์ให้อยู่ในรูปแบบ Markdown blueprint ที่ปรับให้เหมาะกับอินพุตของ LLM

สามารถนำไปใช้ได้อย่างมีประโยชน์ในงานอย่าง code review, AI documentation, prompt engineering และอื่น ๆ

🔗 GitHub: https://github.com/Flamehaven/dir2md

🔗 Release v1.0.4: https://github.com/Flamehaven/dir2md/releases/tag/v1.0.4

---

การปรับปรุงหลัก (v1.0.3 → v1.0.4)

⚙️ ปรับปรุงการตั้งค่า CLI และการจัดการออปชัน (General Availability)

• การตั้งค่าเริ่มต้นของ CLI มีความเสถียรในระดับ GA อย่างเป็นทางการแล้ว

• การทำงานของออปชันหลัก (-preset, -mask, -exclude เป็นต้น) ถูกจัดระเบียบให้ชัดเจนขึ้น

  ทำให้รับประกันเอาต์พุตที่สม่ำเสมอโดยไม่มีความแตกต่างของพฤติกรรมระหว่างเวอร์ชัน

• ลบข้อความเตือนที่ไม่จำเป็นและคำแนะนำที่ซ้ำซ้อนออก

🧠 ทำงานอัตโนมัติสำหรับการรันแบบโลคัลและสภาพแวดล้อมทดสอบ

• เพิ่ม Repository-level import helper

  → ระหว่างการรัน pytest หรือการรันแบบโลคัล จะรู้จักไดเรกทอรี src/ โดยอัตโนมัติ

  ไม่จำเป็นต้องใช้ pip install -e . (editable install) อีกต่อไป

• ลดความซับซ้อนของการตั้งค่าสภาพแวดล้อมทดสอบ และเพิ่มประสิทธิภาพในการพัฒนาแบบโลคัล

🔍 กู้คืนการจับคู่ Glob (gitwildmatch semantics)

• แก้ปัญหาที่แพตเทิร์น */ ไปแมตช์ถึงไฟล์ในรูทด้วย

  → กู้คืนพฤติกรรม gitwildmatch ของ Git ได้อย่างถูกต้อง

  ทำให้การค้นหา glob แบบ recursive ทำงานได้ตรงตามความคาดหมายมากขึ้น

• ป้องกันการตกหล่นของไฟล์โดยไม่คาดคิด หรือการสแกนมากเกินไปเมื่อสแกนรีโพซิทอรีขนาดใหญ่

🛡️ เสริมความปลอดภัยในการ masking และการตั้งค่า

• ขยายขอบเขตการ masking เริ่มต้น:

  • GitHub PAT (ghp_, gho_, ghs_ เป็นต้น)
  • API Key, JWT, Database URL, OAuth Secret และข้อมูลอ่อนไหวอื่น ๆ จะถูกซ่อนอัตโนมัติ

• เพิ่มความสามารถในการโหลดไฟล์ .env อัตโนมัติ

  ระหว่างรัน CLI จะค้นหาและนำไฟล์ .env ที่อยู่ใกล้เคียงมาใช้โดยอัตโนมัติ

• รองรับแพตเทิร์น masking แบบกำหนดเอง:

  • CLI option: -mask-pattern, -mask-pattern-file
  • การตั้งค่าโปรเจกต์: [tool.dir2md.masking] ใน pyproject.toml

⚡️ ปรับจูนประสิทธิภาพและพรีเซ็ต (Pro Mode)

• เมื่่อใช้ Pro preset จะมีแนวทางที่เน้นประสิทธิภาพถูกนำมาใช้:
  • ตัดไฟล์ที่ไม่จำเป็นออก (Targeted excludes)
  • คำนวณงบประมาณโทเค็น (Tight budgets) อัตโนมัติ
  • เพิ่มออปชันข้ามการสร้าง manifest เพื่อเร่งความเร็วในการประมวลผลโปรเจกต์ขนาดใหญ่
• ปรับปรุง internal caching และประสิทธิภาพของ IO → ความเร็วเฉลี่ยเพิ่มขึ้นราว 15~25%

🧾 ความเข้ากันได้และความเสถียร

• แก้บั๊กการจัดการ URI แบบ file:///C:/path บน Windows
• รับประกันเอาต์พุตแบบ ASCII-safe แม้อยู่ใน locale ที่ไม่ใช่ UTF-8 เช่น CP949
• ข้ามบางการทดสอบโดยอัตโนมัติในสภาพแวดล้อมที่ไม่รองรับ symlink
• การทดสอบที่เหลือทั้งหมดผ่านเรียบร้อย

---

🧭 สรุปสั้น ๆ ในบรรทัดเดียว

dir2md v1.0.4 = ความปลอดภัยดีขึ้น + เร็วขึ้น + ตั้งค่าง่ายขึ้น

ถ้าอยากสร้าง pipeline สำหรับสรุปโค้ดที่เป็นมิตรกับ LLM อัปเดตได้เลยตอนนี้!