HSoft AI Coding Assistant

Chat với API tương thích OpenAI trong tab HSoft AI riêng ở Secondary Sidebar hoặc qua @hsoft trong CHAT native của VS Code. Extension cho phép người dùng tự nhập Base URL, API key và model ID, vì vậy có thể dùng OpenRouter, endpoint free, local gateway hoặc provider riêng.

Tính năng

• Tab HSoft AI riêng trong Secondary Sidebar, cạnh CHAT, CLAUDE CODE và CODEX.
• Native Chat participant @hsoft vẫn có thể dùng trong tab CHAT chung.
• Lịch sử nhiều phiên được lưu theo từng workspace và còn nguyên sau khi reload VS Code.
• Hiển thị Markdown đầy đủ cho tiêu đề, chữ đậm, danh sách, bảng và code block.
• Hiển thị trạng thái đang suy nghĩ và các bước agent đang đọc/quét file.
• Nút Dừng hủy request API đang chạy ngay trong sidebar.
• Sau mỗi 10 vòng agent, hỏi trước khi tiếp tục để kiểm soát thời gian và token.
• API key lưu bằng VS Code SecretStorage, không lưu trong settings hoặc workspace.
• Gọi API chuẩn /models và /chat/completions.
• Chọn mức suy luận auto, none, minimal, low, medium, high hoặc xhigh.
• Gửi ảnh PNG, JPG, WebP hoặc GIF cho model vision.
• Đính kèm file hiện tại hoặc chọn nhiều file làm ngữ cảnh.
• Agent tools để liệt kê và đọc file trong trusted workspace.
• Đọc file text tối đa 1 MB mặc định, đủ cho các lockfile thông dụng.
• Tự bỏ qua .DS_Store, file nén, ảnh, font, database và binary khi quét source.
• AI chỉ tạo đề xuất sửa file, không tự ghi.
• Xem diff và xác nhận trước khi áp dụng bằng WorkspaceEdit.
• Hỗ trợ workspace nhiều root.

Cấu hình

Mở tab HSoft AI bên phải và bấm nút cấu hình, hoặc nhập @hsoft /config trong CHAT:

API key là tùy chọn đối với endpoint không yêu cầu xác thực. Extension không gửi cấu hình provider qua web app HSoft; request đi trực tiếp từ VS Code Extension Host đến Base URL người dùng nhập.

Khi chọn mức khác auto, extension gửi field OpenAI-compatible reasoning_effort. Model/provider không hỗ trợ reasoning có thể từ chối field này; khi đó hãy chọn auto.

Extension luôn gửi max_tokens, mặc định 2048, giống web HSoft. Một số gateway cần trường này để giữ quota output trước khi chạy request.

Dùng agent sửa code

1. Mở một workspace và chọn Trust.
2. Mở tab HSoft AI bên phải và nhập Tìm nguyên nhân lỗi đăng nhập và đề xuất cách sửa.
3. Agent dùng tool chỉ đọc để liệt kê và kiểm tra các file cần thiết.
4. Mỗi file cần sửa xuất hiện dưới dạng thẻ Đề xuất sửa file.
5. Bấm Xem diff, sau đó bấm Apply nếu thay đổi đúng.

Trong khung nhập, nhấn Enter để gửi và Shift+Enter để xuống dòng.

HSoft AI có thể khám phá và đọc toàn bộ folder đã Trust mà không cần đính kèm từng file. Không có tool nào được phép tự ghi file; mỗi thay đổi luôn cần thao tác xác nhận.

Lịch sử chat

• Bấm ＋ trên đầu tab để tạo cuộc trò chuyện mới.
• Bấm ☰ để mở danh sách, chuyển phiên hoặc xóa lịch sử.
• Tiêu đề được tạo từ câu hỏi đầu tiên của phiên.
• Extension giữ tối đa 30 phiên gần nhất và 30 lượt hỏi đáp cho mỗi phiên.

Lịch sử của tab HSoft được lưu cục bộ bằng VS Code workspaceState, không gửi lên web app hoặc D1. Nội dung lịch sử không được mã hóa như API key, vì vậy không nên nhập secret trực tiếp vào khung chat.

Gửi ảnh

Dùng nút kẹp giấy trong native Chat để đính kèm file hoặc tối đa 4 ảnh, mỗi ảnh tối đa 5 MB. Model được chọn phải hỗ trợ input dạng image_url.

Phát triển local

Yêu cầu Node.js 20 trở lên:

cd hsoft
npm install
npm test
npm run check

Mở thư mục này bằng VS Code và nhấn F5 để chạy Extension Development Host.

Đóng gói VSIX:

npm run package

Cài thử file vừa tạo:

code --install-extension hsoft-by-hungdentutuonglai-0.4.8.vsix

Publish lên VS Code Marketplace

Publisher trong package.json là hsoft. ID này phải trùng với publisher Vu Manh Hung (hsoft) trong Visual Studio Marketplace.

1. Tạo publisher tại Visual Studio Marketplace Publisher Management.
2. Tạo Azure DevOps Personal Access Token có quyền Marketplace: Manage.
3. Đăng nhập vsce:

npx vsce login hsoft

4. Publish:

npm run publish

Các bản tiếp theo cần tăng version trong package.json, hoặc dùng:

npx vsce publish patch

Marketplace sẽ quét package trước khi extension xuất hiện công khai. Không commit hoặc đóng gói API key/PAT.

Tại thời điểm tháng 6/2026, PAT vẫn dùng được cho publish thủ công. Microsoft thông báo global PAT sẽ bị ngừng vào 1/12/2026; pipeline tự động mới nên dùng Microsoft Entra ID/workload identity theo tài liệu chính thức.

Bảo mật

• API key được lưu trong SecretStorage của VS Code.
• Agent chỉ được đọc/sửa file khi workspace đã trust.
• Đường dẫn tool bị giới hạn bên trong workspace.
• File thay đổi tối đa 1 MB và luôn cần Preview/Apply.
• File lớn, binary, thư mục dependency và metadata Git bị loại khỏi quá trình đọc.

Source

github.com/vuumanhhung/hsoft-chat