KLTN – Bảng công việc (extension VS Code)

Bảng công việc và thư viện tài liệu của nhóm, dùng ngay trong VS Code hoặc Antigravity.

Cài đặt

Trong VS Code hoặc Antigravity, mở mục Extensions (Ctrl+Shift+X), tìm KLTN (hoặc mã antonny3.kltn-tasks-vscode) rồi bấm Install. VS Code tải từ Visual Studio Marketplace, Antigravity tải từ Open VSX; hai nơi cùng một bản.
Nếu trước đây đã cài bản thử từ file .vsix (tên nhà phát hành kltn), gỡ bản đó đi để không chạy hai bản cùng lúc.
Tạo khóa trên trang web: ⚙ Cài đặt → Khóa cho agent và VS Code, chọn loại VS Code, bấm Tạo khóa, rồi chép khóa.
Trong VS Code: Ctrl+Shift+P → KLTN: Đăng nhập → dán khóa.

Khóa được cất trong kho bí mật của VS Code, không nằm trong file nào của repo. Mỗi máy dùng một khóa riêng; mất máy thì thu hồi khóa trên web.

Dùng khóa loại VS Code, không dùng khóa agent. Khi sửa bằng khóa VS Code, thay đổi được ghi là của bạn. Khi sửa bằng khóa agent, thay đổi bị ghi là của agent, và bạn không bỏ được bài trong thư viện.

Dùng

Việc	Cách làm
Mở bảng	Bấm biểu tượng ☑ ở thanh trạng thái (góc dưới bên trái), hoặc chạy lệnh KLTN: Mở bảng công việc. Bảng giống hệt trang web và đồng bộ trực tiếp với mọi người.
Xem theo tuần, đổi deadline	Bấm Dòng thời gian ở đầu bảng: mỗi việc là một thanh từ ngày tạo tới deadline, gom theo người làm. Kéo đầu phải của thanh (hoặc chọn rồi bấm ← →) để dời deadline.
Sáng / tối	Bảng tự theo theme đang dùng của VS Code. Nút ◐ trên đầu bảng chuyển giữa tự động, sáng và tối.
Mở tham chiếu	Bấm tham chiếu trên bảng: file mở bên cạnh, đúng dòng. Lệnh KLTN: Mở tham chiếu của việc… cho chọn nhanh từ các việc chưa xong.
Gắn dòng vào việc	Chuột phải ở dòng cần gắn → Gắn vào việc… → chọn việc, hoặc Tạo việc mới với dòng này. Extension lưu `repo:đường-dẫn:dòng` cùng nội dung dòng (gọi là "đoạn neo").
Xem việc sắp hạn	Thanh trạng thái hiện `☑ 2` (2 việc của bạn còn ≤ 3 ngày hoặc đã quá hạn) và `📖 1` (1 bài bạn tải chưa phân loại). Có việc quá hạn thì ô này đổi màu. Rê chuột vào để xem danh sách.
Xóa bản PDF của bài đã bị bỏ	Khi một bài trong thư viện bị bỏ mà trên máy còn bản PDF (trong các thư mục đang mở, hoặc file đã nạp bằng `task lib add`), extension hỏi có chuyển bản đó vào Thùng rác không. Extension chỉ hỏi, không tự xóa; mỗi file chỉ hỏi một lần.

Dòng bị lệch

Khi file được sửa, số dòng của tham chiếu có thể lệch. Extension tìm lại dòng theo đoạn neo:

Chỉ một chỗ khớp: mở đúng chỗ và tự cập nhật số dòng trên bảng. Số dòng mới chỉ được lưu khi file trên máy giống bản đã push. Nếu file chưa push, extension vẫn mở đúng chỗ trên máy bạn nhưng không đổi bảng, để máy người khác không bị lệch theo.
File đổi tên: extension tìm theo lịch sử đổi tên của git.
Nhiều chỗ khớp: extension hỏi chỗ nào đúng. Chỗ bạn chọn được lưu nếu file đã push.
Không còn chỗ nào khớp: extension mở dòng cũ và báo. Nhờ agent chạy task ref check rồi task ref fix, hoặc sửa tham chiếu trên bảng.

Tham chiếu có nhãn chờ xem là do agent sửa. Khi mở tham chiếu đó, extension hỏi "Đúng chỗ chưa?"; bấm Đúng chỗ để bỏ nhãn.

Extension cũng tự kiểm tra lại các tham chiếu mỗi khi lưu file và mỗi vài phút, nên sau khi push thì dòng mới được lưu mà không cần làm gì.

Repo trên máy

Extension tự nhận repo theo remote GitHub. Nó xem các thư mục đang mở và các repo nằm cạnh chúng (cùng thư mục cha), rồi so với danh sách repo quản lý đã khai trên web. Nếu không nhận được, mở tham chiếu sẽ có nút Chọn thư mục repo…. Cũng có thể khai bằng tay trong cài đặt kltnTasks.repoPaths, ví dụ:

"kltnTasks.repoPaths": { "baocao": "D:/nhom/bao-cao" }

Cập nhật

VS Code và Antigravity tự cập nhật extension từ chợ như mọi extension khác. Ai không vào được chợ thì tải file .vsix trên trang web (⚙ Cài đặt → Extension VS Code) và cài bằng Install from VSIX….

Đăng bản mới (quản lý)

Tăng "version" trong packages/extension/package.json (ví dụ 0.3.0 → 0.3.1).
Ở packages/extension, chạy npm run release -- --ghi-chu "Có gì mới". Lệnh này build, đóng gói, đăng lên Open VSX, đưa file lên kho R2 của nhóm (cho link trên web) và tạo release trên GitHub.
Visual Studio Marketplace làm tay (Marketplace đòi tài khoản Azure để đăng bằng lệnh): mở trang quản lý publisher antonny3, bấm ··· cạnh extension → Update, kéo file .vsix mà lệnh vừa in đường dẫn.

Cần trên máy: wrangler login bằng tài khoản Cloudflare của nhóm, gh đã đăng nhập, và mã Open VSX trong biến môi trường OVSX_PAT. Biểu tượng vẽ bằng node scripts/make-icon.mjs.

Cài đặt khác

kltnTasks.server: địa chỉ cổng API (mặc định là cổng của nhóm, không cần đổi).
kltnTasks.scanPdfs: tắt nếu không muốn extension tìm bản PDF của bài đã bị bỏ.

Thành viên, repo và khóa chỉ quản lý được trên web, nên trong VS Code không có nút ⚙.

KLTN – Bảng công việc

AnTonnyPro