OfficeCLI cho AI agent: Tự động hóa Word, Excel, PowerPoint
iOfficeAI/OfficeCLIOfficeCLI cho AI agent là một CLI một binary cho phép agent — hoặc chính bạn, trực tiếp — đọc, sửa và tạo tài liệu Word, Excel và PowerPoint mà không cần cài Microsoft Office. Bạn điều khiển nó bằng các lệnh như `officecli create deck.pptx` và `officecli add`, trỏ tới bất kỳ phần tử nào theo path (`/slide[1]/shape[1]`), rồi lấy lại JSON có cấu trúc. Một bộ render tích hợp biến tài liệu thành HTML hoặc PNG để agent thấy được thứ nó vừa tạo.
Hãy chọn OfficeCLI nếu bạn muốn một AI agent dựng hoặc sửa file Office và thực sự kiểm tra được kết quả — bộ render tích hợp biến một .pptx hay .docx thành HTML hoặc PNG để agent nhìn lại phần việc của mình và sửa một tiêu đề bị tràn. Bỏ qua nếu bạn chỉ cần rút text ra khỏi tài liệu, khi đó một bộ chuyển đổi nhẹ hơn như MarkItDown làm tốt việc đó, hoặc nếu bạn cần độ trung thực từng pixel so với Office trên desktop, vì engine render được viết mới từ đầu chứ không phải của Microsoft.
Vấn đề nó giải quyết
Bắt một AI agent tạo ra một .docx hay .pptx thật lâu nay khá vụng. Cách thường thấy là 50 dòng python-pptx hoặc openpyxl cho mỗi tài liệu, mà kể cả vậy agent vẫn làm việc trong mù mờ — nó chỉnh được OOXML nhưng không biết tiêu đề có tràn hay hai shape có đè lên nhau không. OfficeCLI ra đời để gom việc đó vào các lệnh đơn lẻ và cho agent một cách xem trang đã render, khép lại vòng render-nhìn-sửa vốn thiếu khi tạo tài liệu.
Đây là gì?
OfficeCLI cho AI agent là một công cụ dòng lệnh mã nguồn mở (giấy phép Apache-2.0), viết bằng C#, trao cho một AI agent toàn quyền đọc, sửa và tạo file Word (.docx), Excel (.xlsx) và PowerPoint (.pptx). Nó xuất xưởng dưới dạng một binary tự chứa duy nhất với .NET runtime nhúng sẵn, nên không có gì phải cài và không cần bản Microsoft Office nào. Một engine render HTML tích hợp có thể biến tài liệu thành HTML hoặc PNG theo từng trang, đó chính là thứ cho một agent đa phương thức nhìn kết quả đã render và sửa lỗi bố cục thay vì đoán từ XML thô.
Vì sao đang được chú ý
Công cụ cho agent đang là làn sóng hiện tại, và tài liệu Office vẫn là định dạng gần như mọi nhân viên tri thức sống cùng mỗi ngày. OfficeCLI bám vào đó với một lệnh cài đặt nhắm thẳng tới agent (`curl -fsSL https://officecli.ai/SKILL.md`), thả một file skill vào Claude Code, Cursor, Windsurf và Copilot. README cũng quảng bá nó là "bộ Office đầu tiên và tốt nhất trên thế giới thiết kế cho AI agent" — đó là lời quảng cáo, không phải sự thật đã kiểm chứng — nhưng khoảng 15k sao GitHub cho thấy ý tưởng đang được đón nhận.
Tính năng chính
- ✓Một binary tự chứa duy nhất với .NET runtime nhúng sẵn — không cần Microsoft Office và không cần cài runtime riêng
- ✓Engine render HTML tích hợp xuất ra HTML độc lập hoặc PNG từng trang, kèm chế độ `watch` với bản xem trước tự làm mới tại localhost:26315
- ✓Sửa theo path: trỏ tới bất kỳ phần tử nào như `/slide[1]/shape[1]` và đọc lại dưới dạng JSON có cấu trúc
- ✓Engine công thức Excel với hơn 350 hàm tính ngay khi ghi, spill mảng động, và pivot table OOXML gốc
- ✓Word hỗ trợ bảng, style, công thức LaTeX, sơ đồ mermaid, theo dõi thay đổi và RTL/i18n
- ✓`merge` điền placeholder `{{key}}` từ JSON, còn `dump`/`batch` tuần tự hóa tài liệu thành JSON có thể phát lại
- ✓Cài một dòng cho agent qua SKILL.md, nối công cụ vào Claude Code, Cursor, Windsurf và Copilot
Trường hợp dùng tốt nhất
- •Cho một AI agent tạo trọn một bộ slide PowerPoint từ prompt rồi tự kiểm bố cục qua bản render PNG
- •Tự động tạo báo cáo từ database hay API vào các file .docx và .xlsx theo mẫu
- •Xử lý tài liệu hàng loạt trong CI/CD hoặc Docker — không cần màn hình, không cần cài Office
- •Rút dữ liệu có cấu trúc từ một tài liệu sẵn có ra JSON để xử lý tiếp
- •Điền một mẫu đã thiết kế N lần bằng `merge` để có kết quả nhất quán, tất định
Cách cài đặt / dùng thử
OfficeCLI xuất xưởng dưới dạng một binary tự chứa duy nhất. Cài bằng lệnh một dòng `curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash` trên macOS/Linux, hoặc `irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex` trên Windows PowerShell. Trình quản lý gói cũng chạy được: `brew install officecli`, `scoop install officecli`, hoặc `npm install -g @officecli/officecli`. Binary dựng sẵn cho macOS, Linux và Windows trên cả x64 lẫn ARM64 có trên GitHub Releases. Kiểm tra bằng `officecli --version`.
Cách sử dụng
Tạo và sửa từ dòng lệnh. `officecli create deck.pptx` tạo file trống; `officecli add deck.pptx / --type slide --prop title="Q4 Report"` thêm nội dung; `officecli view deck.pptx html` (hoặc `screenshot`) render nó; `officecli get deck.pptx '/slide[1]/shape[1]' --json` đọc lại một phần tử. `officecli watch deck.pptx` mở bản xem trước sống, làm mới sau mỗi lần sửa. Với AI agent, chạy `curl -fsSL https://officecli.ai/SKILL.md` trong chat của agent sẽ cài skill để agent tự học các lệnh.
Điểm mạnh
- ✓Không cần cài Microsoft Office hay .NET — một binary chạy headless trong CI, Docker, hay server không màn hình
- ✓Bước render ra PNG cho agent đa phương thức một vòng phản hồi thật thay vì đoán từ XML
- ✓Thay các script Python nhiều thư viện (python-pptx + openpyxl + python-docx) bằng những lệnh đơn lẻ
- ✓Phủ định dạng rộng: công thức, pivot table, biểu đồ, công thức LaTeX, sơ đồ mermaid, theo dõi thay đổi, RTL
- ✓Cũng chạy như một CLI thuần, nên bạn không bị khóa vào việc phải dùng qua agent
Hạn chế & rủi ro
- △Giá trị cao nhất khi ghép với một AI agent; tự thân nó là một CLI selector theo path khá dài dòng, có đường học (`/slide[1]/shape[1]`, chuỗi cờ `--prop`)
- △Engine render viết mới từ đầu, không phải của Microsoft, nên độ trung thực chỉ tốt ngang engine đó — đừng cho rằng kết quả giống hệt từng pixel so với Office trên desktop
- △Đóng góp vào mã nguồn nghĩa là C#/.NET, một cộng đồng nhỏ hơn hệ sinh thái công cụ tài liệu Python mà nó cạnh tranh
- △Cách README gọi "đầu tiên và tốt nhất" / "đầu tiên thế giới" là quảng cáo, chưa được kiểm chứng độc lập — hãy đánh giá công cụ qua kết quả thực tế
- △Mọi thứ chạy qua một binary và cách nó tự hiện thực OOXML; các tính năng Office lạ hoặc hiếm có thể không round-trip hoàn hảo
Lựa chọn thay thế
Ai nên thử — và ai nên bỏ qua
Lập trình viên xây workflow cho agent cần tạo hoặc sửa file Office thật — slide, báo cáo, bảng tính — và muốn agent tự kiểm kết quả bằng mắt. Nó hợp với pipeline tài liệu CI headless và với ai đã mệt vì ghép python-pptx với openpyxl. Nếu bạn chỉ cần rút text ra khỏi tài liệu, một bộ chuyển đổi nhẹ hơn như MarkItDown là đủ; nếu bạn cần độ trung thực từng pixel được bảo chứng với Office desktop, hãy thử engine render trên chính file của bạn trước.
Câu hỏi thường gặp
OfficeCLI là một công cụ dòng lệnh mã nguồn mở cho phép AI agent (hoặc bạn) đọc, sửa và tạo file Word, Excel và PowerPoint mà không cần cài Microsoft Office. Nó xuất xưởng dưới dạng một binary tự chứa duy nhất và có engine render xuất ra HTML hoặc PNG để agent thấy kết quả chỉnh sửa của mình.
Không. Binary tự chứa với .NET runtime nhúng sẵn và tự hiện thực việc đọc/ghi cùng render OOXML, nên nó chạy trên server, trong Docker và trong CI mà không cần cài Office và không phải thiết lập gì thêm.
Chạy `curl -fsSL https://officecli.ai/SKILL.md` trong chat của agent sẽ cài một file skill dạy agent các lệnh. README nói trình cài đặt của nó còn nối skill vào Claude Code, Cursor, Windsurf và Copilot.
README gọi nó là "bộ Office đầu tiên và tốt nhất trên thế giới thiết kế cho AI agent," nhưng đó là lời quảng cáo, không phải sự thật đã kiểm chứng. Các thư viện như python-pptx và bộ chuyển đổi như MarkItDown đã lo một phần việc này nhiều năm; điểm khác biệt của OfficeCLI là gộp đọc/sửa/tạo cộng render sau một CLI duy nhất.
Nó viết bằng C# và cấp phép Apache-2.0, với binary dựng sẵn cho macOS, Linux và Windows trên cả x64 lẫn ARM64.