01 / NGỮ CẢNH MÃ NGUỒN
Nén mã nguồn cho ChatGPT
CLI giảm token của mã nguồn trong khi cố giữ khai báo import, lớp, chữ ký hàm, kiểu dữ liệu và ký hiệu cần thiết để ChatGPT vẫn phân tích được cấu trúc.
Nén mã nguồn · Codex AGENTS.md · STRICT_TOKEN_EFFICIENT_V1 · ECC
Ít token hơn.
Giữ đúng ngữ cảnh cần thiết.
code-compressor giúp tạo ngữ cảnh mã nguồn gọn hơn cho ChatGPT,
quản lý chính sách thực thi trong ~/.codex/AGENTS.md,
và hướng dẫn Codex thực thi kế hoạch theo STRICT_TOKEN_EFFICIENT_V1 cùng các hướng dẫn ECC phù hợp.
Nén mã nguồn cho ChatGPT
Giữ khai báo import, lớp, chữ ký hàm, kiểu dữ liệu và ký hiệu quan trọng để giảm ngữ cảnh mà vẫn bảo toàn cấu trúc cần thiết cho phân tích.
Quản lý Codex AGENTS.md
Trình cài đặt hợp nhất chính sách vào khối được quản lý và giữ nguyên nội dung người dùng nằm ngoài khối đó.
STRICT + hướng dẫn ECC
Giới hạn việc khám phá lại, đọc lại và mở rộng phạm vi; hướng dẫn Codex dùng chỉ dẫn tác nhân ECC khi nhiệm vụ phù hợp.
Ví dụ nén mã nguồn
Giữ cấu trúc, rút gọn phần triển khai
Các ví dụ dưới đây minh họa đầu vào và biểu diễn đã nén để đưa vào ngữ cảnh. Đây là bản minh họa giao diện dựa trên các mẫu mã nguồn, không gọi CLI thật trong trình duyệt.
Mẫu:
Gốc: token
ĐÃ NÉN
Còn lại: token
Tiết kiệm:
compressionRatio:
cú pháp phải hợp lệ
compressionRatio < 1.0
savingsPercentage ≥ 5%
trả về mã nguồn gốc nếu không đạt
Phạm vi dự án
Ba trách nhiệm — không hơn, không kém
README hiện tại xác định rõ `code-compressor` tập trung vào nén mã nguồn, chính sách Codex và hướng dẫn phía thực thi. Việc tạo kế hoạch triển khai hoặc quản lý vòng đời của các kỹ năng thuộc dự án khác.
02 / CHÍNH SÁCH CODEX
Quản lý `AGENTS.md`
AGENTS_RELEASE.md được trình cài đặt hợp nhất vào ~/.codex/AGENTS.md bằng khối được quản lý, đồng thời giữ nguyên các chỉ dẫn khác của người dùng.
03 / HỢP ĐỒNG THỰC THI
STRICT + hướng dẫn ECC
Chính sách định nghĩa cách Codex tiết kiệm token khi thực thi kế hoạch và khi nào phải đọc các chỉ dẫn tác nhân ECC chuyên biệt.
Không thuộc phạm vi: `code-compressor` không tạo kế hoạch thực thi/kế hoạch sửa lỗi cho Codex và không quản lý phần triển khai, cài đặt hay vòng đời của các kỹ năng ECC. Phần đó thuộc
codex-skill/token-efficient-planner và dự án quản lý kỹ năng riêng.
Quy trình tổng thể
Từ mã nguồn đến thay đổi do Codex thực thi
BƯỚC 1
Mã nguồn
Mã nguồn cần phân tích.
BƯỚC 2
Code Compressor
Tạo ngữ cảnh gọn hơn cho ChatGPT.
BƯỚC 3
ChatGPT + người dùng
Tạo, đánh giá và phê duyệt kế hoạch triển khai.
BƯỚC 4
token-efficient-planner
Chuyển kế hoạch đã duyệt thành kế hoạch thực thi cho Codex.
BƯỚC 5
Codex
Đọc `AGENTS.md`, áp dụng STRICT và ECC, rồi thay đổi mã nguồn.
Mã nguồn ↓ code-compressor ↓ Ngữ cảnh đã nén ↓ ChatGPT → Kế hoạch chi tiết → Người dùng phê duyệt ↓ codex-skill/token-efficient-planner ↓ Execution policy: STRICT_TOKEN_EFFICIENT_V1 ↓ Codex → ~/.codex/AGENTS.md + chỉ dẫn ECC → thay đổi mã nguồn
CLI Code Compressor
Hai luồng xử lý ngôn ngữ
Headroom CodeAwareCompressor
Nhóm Python / hệ thống / hướng đối tượng (OOP)
Python .py
Go .go
Rust .rs
Java .java
C / C++
C# .cs
Tree-sitter JavaScript/TypeScript
Không yêu cầu Node.js, Babel hoặc SWC
JavaScript .js .jsx .mjs .cjs
TypeScript .ts .mts .cts .tsx
Luồng này có chính sách riêng cho chú thích/JSDoc và luôn phân tích lại kết quả đầu ra. Nếu cú pháp không hợp lệ hoặc mức tiết kiệm dưới 5%, CLI trả lại mã nguồn ban đầu.
Hợp đồng thực thi của Codex
STRICT_TOKEN_EFFICIENT_V1
Các quy tắc nghiêm ngặt chỉ được kích hoạt khi kế hoạch triển khai bắt đầu bằng dòng chính xác sau:
Execution policy: STRICT_TOKEN_EFFICIENT_V1
Khi được kích hoạt, Codex phải tôn trọng kế hoạch, ảnh chụp trạng thái nguồn, lô công việc, danh mục tệp và ngân sách cứng; tránh khám phá lại/đọc lại không cần thiết và không tự chạy kiểm thử.
Khóa kế hoạch / trạng thái nguồn
Một lô công việc đang mở
Danh mục tệp giới hạn
Sổ theo dõi ngân sách cứng
Kiểm thử do người dùng chạy
5 kết quả chuẩn
COMPLETE
PARTIAL
CAPABILITY_GAP
BUDGET_STOP
POLICY_CONFLICT
Everything Claude Code
ECC hướng dẫn Codex dùng đúng chỉ dẫn chuyên biệt
`code-compressor` chỉ kết xuất đường dẫn và quy tắc sử dụng ECC vào chính sách; nó không cài đặt, sao chép kho, cập nhật hay thay thế ECC.
1. Kiểm tra lỗi im lặng
silent-failure-hunter
Xử lý lỗi, thử lại, phương án dự phòng, ghi nhật ký, tác vụ nền và đường phục hồi.
2. Hiệu năng
performance-optimizer
Thời gian chạy, biên dịch, kết xuất, bộ nhớ hoặc đường xử lý nóng.
3. Đơn giản hóa
code-simplifier
Giảm độ phức tạp không cần thiết trong phần mã nguồn đã thay đổi.
4. Tái cấu trúc
refactor-cleaner
Dọn mã chết, phần trùng lặp hoặc cấu trúc dư thừa sau thay đổi.
Thư mục gốc ECC mặc định
~/Project/everything-claude-code
Nếu ECC ở vị trí khác, trình cài đặt hỗ trợ --path-ecc /absolute/path/to/everything-claude-code. Chính sách chỉ tham chiếu đường dẫn; phần triển khai kỹ năng vẫn do dự án khác quản lý.
Demo xác minh với Codex
Kiểm tra chính sách đã được đọc đúng
Sau khi cài chính sách và mở phiên Codex mới, có thể hỏi trực tiếp để xác nhận Codex hiểu đúng STRICT và ECC.
Câu 1
STRICT_TOKEN_EFFICIENT_V1 là gì?
Kết quả mong đợi: Codex nhận diện đây là chế độ thực thi kế hoạch với quy tắc nghiêm ngặt để tiết kiệm token và tránh mở rộng phạm vi.
Codex phải nêu được dấu kích hoạt, ràng buộc kế hoạch/trạng thái nguồn/lô công việc, ngân sách cứng, kiểm thử do người dùng sở hữu và các kết quả chuẩn.
Câu 2
ECC bắt làm gì?
Kết quả mong đợi: Codex biết khi nhiệm vụ phù hợp phải đọc và áp dụng chỉ dẫn tác nhân tương ứng.
Thứ tự mặc định khi nhiều chỉ dẫn cùng áp dụng: Kiểm tra lỗi im lặng → Hiệu năng → Đơn giản hóa → Tái cấu trúc; không tự cài đặt hoặc thay thế ECC.
Cài đặt & sử dụng
CLI và chính sách Codex là hai phần độc lập
Thử CLI Code Compressor
Bộ phụ thuộc tối thiểu
python3 -m venv .venv-cli .venv-cli/bin/python -m pip install --upgrade pip .venv-cli/bin/python -m pip install \ "tree-sitter==0.25.2" \ "tree-sitter-language-pack" \ "headroom-ai[code]" .venv-cli/bin/python src/code_compressor_cli.py \ ./src/code_compressor_cli.py \ --plain
Phát hành chính sách Codex
Không đóng gói CLI Code Compressor
# Tạo bản phát hành ./scripts/release.sh --version 0.1.0 # Sau khi giải nén bản phát hành ./install.sh # ECC nằm ở vị trí khác ./install.sh --path-ecc /path/to/everything-claude-code # Chỉ gỡ khối chính sách được quản lý ./uninstall.sh
Khối được quản lý
Trình cài đặt giữ nguyên nội dung nằm ngoài khối trong `~/.codex/AGENTS.md`.
Cảnh báo ECC
Nếu dùng thư mục gốc ECC mặc định nhưng thư mục không tồn tại, trình cài đặt sẽ cảnh báo nhưng không làm quá trình cài đặt thất bại.
Gỡ cài đặt an toàn
Chỉ gỡ khối chính sách được quản lý; không xóa ECC hoặc ghi đè thay đổi mới của người dùng.