Tài liệu tham chiếu CLI

Tất cả các lệnh xử lý nguồn đều chấp nhận --header-language c|cpp cho các tệp .h. Mặc định là c; chọn cpp cho các tệp tiêu đề C++ có tên .h. Các phần mở rộng khác không bị ảnh hưởng. Xem hỗ trợ ngôn ngữ để biết chính sách lựa chọn và khả năng trích xuất đã được kiểm tra.

codeknit

Khởi chạy giao diện dòng lệnh tương tác (TUI), hướng dẫn bạn qua các lệnh và tùy chọn có sẵn.

codeknit

codeknit parse

Trích xuất thông tin cấu trúc từ mã nguồn vào các tệp .skt hoặc JSON.

codeknit parse <input-path> [output-dir]

Cờ	Kiểu	Mặc định	Mô tả
--output-mode	string	directory-flat	Chế độ đầu ra: inline, directory-flat, hoặc directory-tree
--format	string	skt	Định dạng đầu ra: skt hoặc json
--max-lines	int	500	Số dòng tối đa cho mỗi tệp đầu ra (áp dụng cho các chế độ directory-flat và directory-tree)
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--minify	bool	false	Kích hoạt nén đầu ra dựa trên từ điển
--edges	bool	false	Bao gồm phần [edges] trong đầu ra (tắt mặc định để tiết kiệm token)
--clean	bool	false	Xóa các tệp .skt cũ trong thư mục đầu ra trước khi ghi
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	Hiển thị thông tin tiến trình trong quá trình xử lý

Thư mục đầu ra mặc định là ./skeleton khi không được chỉ định. Trong chế độ inline, đầu ra được ghi vào stdout và không sử dụng thư mục. Với --format json, đầu ra thư mục được ghi dưới dạng codeknit.json.

codeknit graph show

Tạo biểu đồ HTML tương tác để trực quan hóa cấu trúc codebase.

codeknit graph show <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	string	./skeleton/codeknit-graph.html	Đường dẫn tệp HTML đầu ra
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	Hiển thị thông tin tiến trình trong quá trình xử lý

Tệp HTML được tạo ra là tự chứa và tự động mở trong trình duyệt mặc định của bạn.

codeknit graph analyze

Chạy các thuật toán phân tích đồ thị và xuất báo cáo .skt có thể đọc được bởi LLM.

codeknit graph analyze <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	string	./skeleton/graph_analysis.skt	Đường dẫn tệp .skt đầu ra
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	Hiển thị thông tin tiến trình trong quá trình xử lý
--fan-threshold	int	10	Ngưỡng fan-in hoặc fan-out tối thiểu để gắn cờ cho một ký hiệu trung tâm
--god-threshold	int	15	Số lượng cạnh chứa tối thiểu để gắn cờ cho một god class/function
--max-inheritance-depth	int	5	Gắn cờ cho các chuỗi kế thừa sâu hơn giá trị này
--top-n	int	30	Giới hạn các phần đầu ra được xếp hạng; 0 nghĩa là không giới hạn
--betweenness-threshold	float64	0.001	Giá trị trung tâm betweenness tối thiểu để báo cáo
--propagation-cutoff	float64	0.05	Xác suất tối thiểu để tiếp tục mô phỏng lan truyền thay đổi

codeknit graph hotspots

Xếp hạng các tệp bằng lịch sử Git và tầm quan trọng cấu trúc, đồng thời báo cáo sự kết hợp thời gian giữa các tệp thường xuyên thay đổi cùng nhau.

codeknit graph hotspots <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	string	./skeleton/hotspots.skt	Đường dẫn tệp đầu ra
--format	string	skt	Định dạng đầu ra: skt hoặc json
--since	string	12mo	Cửa sổ lịch sử, ví dụ: 180d, 12mo, hoặc 2y
--max-commits	int	2000	Số lượng commit tối đa để kiểm tra
--max-files-per-commit	int	50	Loại trừ các commit thay đổi nhiều tệp hơn
--min-cochanges	int	3	Số lượng commit chia sẻ tối thiểu cho sự kết hợp thời gian
--top-n	int	30	Số lượng kết quả tối đa cho mỗi phần báo cáo
--include-merges	bool	false	Bao gồm các commit merge
--collect-test	bool	false	Bao gồm các tệp kiểm thử
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	Hiển thị thông tin tiến trình

codeknit fingerprint

Phát hiện mã trùng lặp và gần trùng lặp bằng cách sử dụng fuzzy hashing.

codeknit fingerprint <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	string	./skeleton/fingerprints.skt	Đường dẫn tệp .skt đầu ra
--min-similarity	int	65	Phần trăm độ tương đồng tối thiểu để báo cáo (0–100)
--max-similarity	int	95	Phần trăm độ tương đồng tối đa để báo cáo (0–100)
--show-all	bool	false	Bao gồm phần [fingerprints] với dữ liệu token thô
--rerank	bool	false	Tìm các lân cận ngữ nghĩa và xếp hạng lại các ứng viên bằng cách sử dụng embeddings Ollama (yêu cầu ollama serve và ollama pull qwen3-embedding:0.6b)
--model	string	qwen3-embedding:0.6b	Mô hình embedding Ollama để sử dụng với --rerank
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	Hiển thị thông tin tiến trình trong quá trình xử lý

codeknit completion

Tạo các tập lệnh hoàn thành shell cho các shell được hỗ trợ.

codeknit completion <shell>

Các shell được hỗ trợ: bash, zsh, fish, powershell.

Cờ toàn cục

Cờ	Mô tả
--version	Hiển thị thông tin phiên bản
--help, -h	Hiển thị trợ giúp cho lệnh hiện tại