Tôi có cần cài Archscribe toàn cục không?
Không. npx -y archscribe ... lấy gói từ npm và chạy lệnh. Lần đầu cần truy cập registry. Xem Cài đặt.
Không dùng trình AI có chạy được không?
Có. Dùng npx -y archscribe doctor /path/to/project rồi npx -y archscribe run /path/to/project. setup chỉ dành cho kết nối MCP với trình AI.
setup và scaffold khác nhau thế nào?
setup đăng ký MCP cho trình AI ở phạm vi người dùng. scaffold tạo .mcp.json và skill Claude Code trong một dự án cụ thể, bỏ qua file đã tồn tại trừ khi bạn chủ động dùng --overwrite.
Vì sao không thấy tool trong trình AI?
Kiểm tra CLI của trình AI có trong PATH, đọc thông báo từ setup rồi khởi động lại trình. Với Claude Code, thử claude mcp list. Nếu dùng Antigravity, kiểm tra ~/.gemini/config/mcp_config.json.
Thiếu Java hoặc dự án bị báo sai cấu trúc?
Cài JDK 17+ và thêm java vào PATH. Trỏ lệnh tới thư mục gốc có src/main/java cùng pom.xml, build.gradle hoặc build.gradle.kts. Chạy lại doctor.
Tại sao không có file DOCX?
Tạo DOCX phụ thuộc quyền sử dụng. Kiểm tra thông báo từ lệnh chạy và trạng thái license. Nếu được yêu cầu kích hoạt, dùng npx -y archscribe login với key hợp lệ. Không chia sẻ key công khai.
Có dùng được với Maven nhiều module không?
Có thể phân tích nhưng phạm vi không bảo đảm đầy đủ. Một số endpoint, đặc biệt đường dẫn kế thừa, có thể bị thiếu. Hãy soát mã nguồn và sơ đồ trước khi dùng.
Vì sao npx archscribe chạy bản cũ trên máy tôi?
Máy phát triển có thể đã npm link một checkout cũ hoặc cài bản global. Kiểm tra liên kết đó trước. Chỉ chạy npm unlink -g archscribe nếu bạn muốn gỡ nó, sau đó thử npx -y archscribe version.
Tài liệu sinh ra có dùng ngay để nộp được không?
Không nên dùng mà không rà soát. Báo cáo có thể còn chương dạng khung, còn ca sử dụng và sơ đồ cần đối chiếu với mã nguồn và yêu cầu thực tế. Xem Quy trình và đầu ra.