Repository navigation
INSTALL.mdmới ở gốc repo: hướng dẫn cài dành cho AI agent. Một prompt copy-dán dùng chung
cho Codex, Claude Code, Claude Desktop và Google Antigravity; agent tự kiểm tra máy, hỏi trước
khi cài phần mềm hoặc cần quyền admin, cài, chạy doctor, kiểm bằng bài mẫu CSV và báo lại.- Hỗ trợ Python 3.11–3.14 (
pythonnet3.1.0); bộ cài báo rõ khi Python nằm ngoài khoảng này. doctor.ps1 -Preflightkiểm tiên quyết (PowerShell, ExecutionPolicy, Git, Python, ADOMD.NET,
Node, Azure CLI) ngay sau khi clone, trước khi cài.- Claude Desktop (tab chat) được đăng ký bằng
-Hosts claude-desktop, chỉ có 16 công cụ MCP. - Bộ cài, doctor và engine dò ADOMD.NET theo cùng một danh sách, tôn trọng
ADOMD_LIB_DIR. - Tài liệu và website cài đặt viết chung cho mọi host: bảng "Chuẩn bị máy" với gói
winget,
script chạy bằng-ExecutionPolicy Bypasstheo tiến trình, không đổi chính sách máy. - Test mới giữ prompt đồng bộ giữa
INSTALL.md, README, START-HERE và website, và giữ version
thống nhất giữa các manifest. - Sửa lỗi: cài lại trên checkout đã có
.venvtừng treo chờ bàn phím; nay chạy thẳng. - Sửa lỗi:
powershell -File install.ps1 -Hosts a,btừng không đăng ký host nào mà vẫn báo hoàn
tất; nay bộ cài tách dấu phẩy và từ chối tên host lạ trước khi ghi.doctor.ps1và
uninstall.ps1gọi qua-Filevẫn nhận mỗi lần một host. doctor.ps1báoWARNở dòngdriverkhi có module ADOMD cho Python nhưng không thấy DLL
ADOMD.NET.ADOMD_LIB_DIRtrongconfig.envviết không bọc nháy kép.- Nâng cấp từ 0.7.0:
requirements.txtđổi (pythonnet3.1.0) nênupdate.ps1 -Applysẽ
từ chối áp tự động. Đóng các host, chạygit pull, rồi chạy lạiinstall.ps1với-Hostsnhư
lúc cài; pip tự nâng thư viện trong.venv. Muốn thêm Claude Desktop thì thêmclaude-desktop
vào-Hosts.
Cài đặt: dán prompt ở trang Cài đặt vào Codex, Claude Code, Claude Desktop hoặc Google Antigravity — agent đọc INSTALL.md và cài giúp. Tự cài: START-HERE.md.
Giới hạn đã biết
- Chưa nghiệm thu cài trên một máy Windows hoàn toàn sạch và chưa chạy phiên host thật cho cả bốn host (sẽ nghiệm thu trên máy mới).
- Python 3.13/3.14 mới kiểm qua CI; ADOMD.NET với Power BI Desktop thật mới kiểm trên 3.12.
- Nhánh kết nối Power BI Desktop của
doctor.ps1 -ProbeDesktopvà đường Power BI Service chưa nghiệm thu với báo cáo thật.