dir2md v1.0.4 — CLI chuyển đổi codebase mã nguồn mở thành Markdown thân thiện với LLM, bản cập nhật lớn

🔥 dir2md v1.0.4 — CLI chuyển đổi codebase mã nguồn mở thành Markdown thân thiện với LLM, bản cập nhật lớn

dir2md là một công cụ CLI mã nguồn mở quét kho lưu trữ cục bộ hoặc từ xa để tạo ra bản thiết kế Markdown được tối ưu cho đầu vào của LLM từ cấu trúc thư mục + nội dung tệp.

Có thể được sử dụng hữu ích trong review code, tài liệu hóa bằng AI, prompt engineering, v.v.

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

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

---

Các cải tiến chính (v1.0.3 → v1.0.4)

⚙️ Cải thiện cấu hình CLI và xử lý tùy chọn (General Availability)

• Thiết lập mặc định của CLI đã được ổn định ở mức GA chính thức.

• Cách hoạt động của các tùy chọn chính (-preset, -mask, -exclude, v.v.) đã được sắp xếp rõ ràng,

  đảm bảo đầu ra nhất quán mà không có khác biệt hành vi giữa các phiên bản.

• Loại bỏ các cảnh báo không cần thiết và thông báo trùng lặp.

🧠 Tự động hóa môi trường chạy cục bộ và kiểm thử

• Đã thêm repository-level import helper.

  → Khi chạy pytest hoặc chạy cục bộ, thư mục src/ được tự động nhận diện,

  không còn cần pip install -e . (editable install).

• Đơn giản hóa thiết lập môi trường kiểm thử, nâng cao hiệu quả phát triển cục bộ.

🔍 Khôi phục glob matching (gitwildmatch semantics)

• Đã sửa lỗi khiến mẫu */ khớp cả với các tệp ở thư mục gốc.

  → Khôi phục chính xác hành vi gitwildmatch của Git,

  giúp tìm kiếm glob đệ quy hoạt động trực quan hơn.

• Ngăn việc thiếu sót tệp ngoài ý muốn hoặc quét quá mức khi quét các repository lớn.

🛡️ Tăng cường bảo mật masking và cấu hình

• Mở rộng phạm vi masking mặc định:

  • GitHub PAT (ghp_, gho_, ghs_, v.v.)
  • Tự động che giấu thông tin nhạy cảm như API Key, JWT, Database URL, OAuth Secret.

• Đã thêm tính năng tự động nạp tệp .env:

  Khi chạy CLI, sẽ tìm và áp dụng tệp .env gần nhất.

• Hỗ trợ mẫu masking do người dùng tự định nghĩa:

  • Tùy chọn CLI: -mask-pattern, -mask-pattern-file
  • Cấu hình dự án: [tool.dir2md.masking] trong pyproject.toml

⚡️ Tối ưu hiệu năng và preset (Pro Mode)

• Khi chạy Pro preset, đã áp dụng hướng dẫn ưu tiên hiệu năng:
  • Loại trừ các tệp không cần thiết (Targeted excludes)
  • Tự động tính toán ngân sách token (Tight budgets)
  • Thêm tùy chọn bỏ qua tạo Manifest để tăng tốc xử lý các dự án lớn.
• Cải thiện caching nội bộ và hiệu quả IO → tốc độ chạy trung bình tăng khoảng 15~25%.

🧾 Khả năng tương thích và độ ổn định

• Sửa lỗi xử lý URI file:///C:/path trên môi trường Windows.
• Đảm bảo đầu ra an toàn với ASCII ngay cả trong môi trường locale không phải UTF-8 như CP949.
• Tự động bỏ qua một số bài kiểm thử trong môi trường không hỗ trợ symlink.
• Toàn bộ các bài kiểm thử còn lại đều vượt qua.

---

🧭 Tóm tắt một dòng

dir2md v1.0.4 = tăng cường bảo mật + cải thiện hiệu năng + đơn giản hóa cấu hình

Nếu bạn muốn xây dựng pipeline tóm tắt code thân thiện với LLM, hãy cập nhật ngay!