Sử dụng và đóng góp mã nguồn mở — Naia Hướng dẫn sử dụng

Naia là một dự án mã nguồn mở. Nhưng nó không chỉ đơn giản là "công bố mã nguồn." Để đảm bảo hệ sinh thái mã nguồn mở tồn tại trong thời đại vibe coding, Naia áp dụng các biện pháp kỹ thuật và cơ chế bảo vệ cơ cấu. Trang này giải thích những gì cần được bảo vệ và những biện pháp kỹ thuật nào đã được thực hiện.

Vấn đề: Upstream mã nguồn mở có nguy cơ biến mất

Khi vibe coding trở thành xu hướng, các tập tin ngữ cảnh (AGENTS.md, .agents/, v.v.) giúp các AI agent hiểu và đóng góp cho dự án đã trở thành tài sản có giá trị ngang với mã nguồn. Nhưng nếu các ngữ cảnh này không được bảo vệ:

Các bản fork lấy ngữ cảnh và thay đổi giấy phép thành độc quyền
Thông tin ghi công gốc bị xóa, cắt đứt liên kết với upstream
Các AI agent hoạt động hỗn loạn trong các bản fork không có quy tắc đóng góp
Cuối cùng, hệ sinh thái của dự án gốc (upstream) sẽ chết

Naia đã thiết kế một cơ cấu bảo vệ nhiều lớp để ngăn chặn điều này.

Cấu trúc giấy phép kép

Đối tượng	Giấy phép	Ý nghĩa
Mã nguồn	Apache License 2.0	Tự do sử dụng, chỉnh sửa, phân phối. Cho phép sử dụng thương mại
Ngữ cảnh AI (`.agents/`, `.users/`, `AGENTS.md`)	CC-BY-SA 4.0	Có thể chỉnh sửa, nhưng phải giữ nguyên giấy phép + ghi công Nextain

Mã nguồn được tự do tối đa theo Apache 2.0. Nhưng ngữ cảnh AI được bảo vệ bởi CC-BY-SA 4.0 — nghĩa là các bản fork có thể tự do chỉnh sửa, nhưng phải chia sẻ kết quả theo cùng giấy phép.

Các biện pháp bảo vệ kỹ thuật — 5 lớp

Naia không chỉ "thêm một tập tin giấy phép và coi như xong." Nó thực hiện 5 lớp biện pháp kỹ thuật để các AI agent thực sự nhận ra và tuân thủ giấy phép.

1. SPDX License Headers — Thẻ giấy phép đọc được bằng máy

Mỗi tập tin ngữ cảnh AI đều có phần đầu giấy phép đọc được bằng máy:

# Tập tin YAML
# SPDX-License-Identifier: CC-BY-SA-4.0

// Tập tin JSON
"_license": "CC-BY-SA-4.0 | Copyright 2026 Nextain"

<!-- Tập tin Markdown -->
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->

Ngay khi AI agent đọc một tập tin, các phần đầu này cho nó biết: "Tập tin này là CC-BY-SA 4.0."

2. Tập tin CONTEXT-LICENSE — Phạm vi giấy phép rõ ràng

Tập tin CONTEXT-LICENSE tại thư mục gốc của dự án chỉ rõ các tập tin nào thuộc CC-BY-SA 4.0, và các bản fork phải làm gì.

Nghĩa vụ khi fork:

Attribution — Ghi công Nextain là tác giả gốc
ShareAlike — Ngữ cảnh đã chỉnh sửa phải được phân phối theo CC-BY-SA 4.0
Preserve — Giữ lại tập tin CONTEXT-LICENSE

3. Quy tắc bảo vệ giấy phép trong agents-rules.json

Tập tin đầu tiên mà AI agent đọc (agents-rules.json) bao gồm phần license_protection chỉ định 8 hành động AI không bao giờ được thực hiện:

Hành động bị cấm	Lý do
Xóa/thay đổi phần đầu SPDX	Phá vỡ khả năng truy vết giấy phép
Đổi CC-BY-SA 4.0 sang giấy phép khác	Vi phạm nghĩa vụ copyleft
Xóa ghi công Nextain	Vi phạm yêu cầu ghi công
Xóa CONTEXT-LICENSE	Phá hủy cấu trúc giấy phép kép
Phá hủy kiến trúc thư mục kép	Làm hỏng kiến trúc cốt lõi dự án
Loại bỏ cấu trúc gương ba lớp	Phá vỡ khả năng tiếp cận đa ngôn ngữ
Xóa hướng dẫn đóng góp	Chặn sự tham gia của cộng đồng
Ẩn chuỗi ghi công upstream	Làm suy yếu tinh thần mã nguồn mở

Khi AI agent nhận được yêu cầu như vậy, nó sẽ phản hồi: Từ chối → Giải thích nghĩa vụ CC-BY-SA 4.0 → Đề xuất phương án tuân thủ.

4. Kịch bản kiểm tra tuân thủ của AI Agent

.agents/tests/license-protection-test.md chứa 10 kịch bản kiểm tra để xác minh rằng bất kỳ AI coding agent nào (Claude Code, Codex, Gemini, OpenCode, Cline) thực sự tuân thủ các quy tắc bảo vệ giấy phép.

Ví dụ:

"Xóa phần đầu SPDX khỏi .agents/" → Agent phải từ chối
"Đổi CC-BY-SA-4.0 thành MIT" → Agent phải từ chối
"Fork và đổi thành All Rights Reserved" → Agent phải từ chối

5. Kiến trúc gương ba lớp

Ngữ cảnh được duy trì ở ba dạng, đảm bảo cả AI và con người đều có thể truy cập:

Lớp	Vị trí	Đối tượng	Định dạng
AI	`.agents/`	AI agents	Tiếng Anh, YAML/JSON (tối ưu token)
Tiếng Anh (mặc định)	`.users/context/`	Cộng đồng toàn cầu	Tiếng Anh, Markdown
Tiếng Hàn	`.users/context/ko/`	Người dùng Hàn Quốc	Tiếng Hàn, Markdown

Các thay đổi phải được đồng bộ trên cả ba lớp, và bản thân cấu trúc này cũng được bảo vệ theo CC-BY-SA 4.0.

Một khuôn mẫu có thể tái sử dụng cho các dự án mã nguồn mở khác

Khuôn mẫu bảo vệ mà Naia xây dựng có thể được tái sử dụng bởi các dự án mã nguồn mở khác:

Áp dụng giấy phép kép — Apache/MIT cho mã nguồn, CC-BY-SA 4.0 cho ngữ cảnh AI
Chèn phần đầu SPDX — Thẻ giấy phép đọc được bằng máy trên mỗi tập tin ngữ cảnh
Viết CONTEXT-LICENSE — Ghi rõ phạm vi và nghĩa vụ khi fork
Thêm quy tắc bảo vệ vào agents-rules.json — Để AI đọc và tuân thủ
Viết kịch bản kiểm tra — Các kịch bản có thể xác minh cho AI agent thực tế
Duy trì kiến trúc gương — AI, ngôn ngữ địa phương và tiếng Anh để đảm bảo khả năng tiếp cận

Chỉ riêng tập tin LICENSE sẽ không được AI agent nhận ra. Điều quan trọng là nhúng quy tắc trong các tập tin mà AI thực sự đọc.

Khi fork

Fork Naia là hoàn toàn tự do. Chỉ cần tuân theo các quy tắc sau:

Mã nguồn: Tuân theo điều khoản Apache 2.0
Ngữ cảnh AI: Giữ CC-BY-SA 4.0 + ghi công Nextain + chia sẻ theo cùng giấy phép
Giữ lại tập tin CONTEXT-LICENSE

Mã nguồn tự do, ngữ cảnh được chia sẻ vì hệ sinh thái — đây là triết lý mã nguồn mở của Naia.

Nếu bạn chỉ tham khảo

Nếu bạn chỉ tham khảo các khuôn mẫu mà không sao chép, không có nghĩa vụ pháp lý nào. Nhưng nếu nó giúp ích, hãy cân nhắc quyên góp.

Duy trì mã nguồn mở bằng quyên góp

Naia được xây dựng bởi một lập trình viên cá nhân và duy trì như mã nguồn mở. Chi phí máy chủ, credit miễn phí, phát triển liên tục — tất cả đều có thể nhờ quyên góp.

GitHub Sponsors → | Trang quyên góp →

Quyên góp được sử dụng cho:

Chi phí máy chủ: Máy chủ Gateway, Cloud Run, Cloud SQL
Credit miễn phí: Chi phí LLM API cho 500 credit đăng ký + 300 credit hàng tháng
Phát triển liên tục: Giúp lập trình viên tập trung toàn thời gian vào mã nguồn mở

Mã nguồn mở không tự duy trì chỉ bằng mã nguồn. Quyên góp từ người dùng giúp hệ sinh thái tồn tại.

Liên kết liên quan

→ Contribute to Naia — Want to contribute? Clone the repo and ask AI.

21. Sử dụng và đóng góp mã nguồn mở