Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 Ghi chú phát hành *Ngày phát hành: 7 tháng 8, 2025* ## 📑 Mục lục - [🎉 Tính năng mới chính](#-tính-năng-mới-chính) - [🤖 Hệ thống quản lý Agent](#-hệ-thống-quản-lý-agent) - [🤖 Phân công Agent hàng loạt bằng AI](#-phân-công-agent-hàng-loạt-bằng-ai) - [📊 Kiểm soát phiên bản Git cho lịch sử tác vụ](#-kiểm-soát-phiên-bản-git-cho-lịch-sử-tác-vụ) - [📊 Giao diện lịch sử dự án](#-giao-diện-lịch-sử-dự-án) - [🎨 Hệ thống quản lý Template](#-hệ-thống-quản-lý-template) - [🌍 Hỗ trợ quốc tế hóa (i18n)](#-hỗ-trợ-quốc-tế-hóa-i18n) - [🧭 Cải thiện điều hướng và UI](#-cải-thiện-điều-hướng-và-ui) - [🔄 Cải tiến đáng kể](#-cải-tiến-đáng-kể) - [Điều hướng chi tiết tác vụ](#điều-hướng-chi-tiết-tác-vụ) - [Nâng cao hiệu suất](#nâng-cao-hiệu-suất) - [Trải nghiệm nhà phát triển](#trải-nghiệm-nhà-phát-triển) - [Cải tiến UI/UX](#cải-tiến-uiux) - [🐛 Sửa lỗi](#-sửa-lỗi) - [Sửa lỗi quan trọng](#sửa-lỗi-quan-trọng) - [Sửa lỗi UI](#sửa-lỗi-ui) - [Xử lý dữ liệu](#xử-lý-dữ-liệu) - [🏗️ Cập nhật kỹ thuật](#️-cập-nhật-kỹ-thuật) - [Phụ thuộc mới](#phụ-thuộc-mới) - [Cải tiến API](#cải-tiến-api) - [Cải tiến kiến trúc](#cải-tiến-kiến-trúc) - [📝 Thay đổi không tương thích](#-thay-đổi-không-tương-thích) - [Cập nhật cấu hình](#cập-nhật-cấu-hình) - [Thay đổi API](#thay-đổi-api) - [🚀 Hướng dẫn di chuyển](#-hướng-dẫn-di-chuyển) - [🎯 Tóm tắt](#-tóm-tắt) ## 🎉 Tính năng mới chính ### 🤖 Hệ thống quản lý Agent **Quản lý sub-agent toàn diện cho xử lý tác vụ chuyên biệt** SHRIMP-TASK-MANAGER hiện hỗ trợ khả năng quản lý agent mạnh mẽ, cho phép bạn định nghĩa và sử dụng các agent AI chuyên biệt cho các loại tác vụ khác nhau. Agents là những nhân cách hoặc bộ kỹ năng AI chuyên biệt có thể được gán cho các tác vụ để thực hiện tối ưu. Tính năng này tích hợp liền mạch với hệ thống agent của Claude, cho phép bạn tận dụng các agent tùy chỉnh được lưu trong thư mục `.claude/agents` của bạn. Khả năng chính bao gồm: - **Giao diện danh sách Agent**: Duyệt tất cả các agent có sẵn từ thư mục `.claude/agents` với thông tin chi tiết - **Phân công Agent**: Gán các agent cụ thể cho tác vụ thông qua dropdown trong bảng tác vụ - **Popup xem Agent**: Nhấp vào biểu tượng mắt (👁️) trong bảng tác vụ để mở popup xem agent nơi bạn có thể cuộn qua các agent khác nhau và chọn agent phù hợp cho từng tác vụ - **Trình soạn thảo Agent**: Trình soạn thảo tích hợp với tùy chỉnh màu sắc cho metadata của agent - **Agent toàn cục và dự án**: Hỗ trợ định nghĩa agent cụ thể cho dự án và toàn cục - **Hướng dẫn AI một cú nhấp**: Nhấp emoji robot để sao chép hướng dẫn cụ thể của agent vào clipboard - **Hướng dẫn AI danh sách Agent**: Cột hướng dẫn AI mới trong danh sách agent với emoji robot (🤖) sao chép `use subagent [agent-name] located in [path]:` để sử dụng trực tiếp trong Claude - **Modal thông tin Agent**: Thông tin agent chi tiết với điều hướng giữa các agent - **Tích hợp Metadata**: Phân công agent được lưu trực tiếp vào tasks.json - **Mã hóa màu sắc**: Phân biệt trực quan các agent bằng màu sắc tùy chỉnh #### Quy trình phân công Agent: 1. **Xem Agents có sẵn**: Truy cập tab Agents để xem tất cả agent trong thư mục `.claude/agents` 2. **Gán cho Tác vụ**: Sử dụng dropdown trong bảng tác vụ để chọn agent cho từng tác vụ 3. **Sao chép hướng dẫn**: Nhấp emoji robot để sao chép: `use the built in subagent located in ./claude/agents/[agent-name] to complete this shrimp task: [task-id] please when u start working mark the shrimp task as in progress` 4. **Chỉnh sửa Agents**: Sửa đổi nội dung và metadata agent bao gồm màu sắc tùy chỉnh  *Giao diện danh sách Agent hiển thị tất cả agent có sẵn với cột hướng dẫn AI - nhấp emoji robot (🤖) để sao chép hướng dẫn sử dụng agent như `use subagent debugger.md located in ./claude/agents to perform:` trực tiếp vào clipboard*  *Gán agent cho tác vụ bằng bộ chọn dropdown trong bảng tác vụ*  *Nhấp biểu tượng mắt (👁️) để mở popup xem agent và duyệt qua các agent có sẵn để phân công tác vụ*  *Chỉnh sửa nội dung agent và tùy chỉnh bằng màu sắc để tổ chức trực quan*  *Nhấp emoji robot để sao chép hướng dẫn tác vụ cụ thể của agent*  *Duyệt qua các agent với thông tin chi tiết và điều hướng dễ dàng*  *Cấu hình đường dẫn thư mục Claude toàn cục để truy cập agent toàn hệ thống* ### 🤖 Phân công Agent hàng loạt bằng AI **Tự động gán các agent phù hợp nhất cho nhiều tác vụ bằng OpenAI GPT-4** Task Viewer hiện tích hợp với GPT-4 của OpenAI để thông minh gán agent cho tác vụ dựa trên mô tả và yêu cầu của chúng. Tính năng này giảm đáng kể thời gian cần thiết để cấu hình số lượng lớn tác vụ với agent phù hợp. Tính năng chính bao gồm: - **Lựa chọn hàng loạt**: Chọn nhiều tác vụ bằng checkbox trong bảng tác vụ - **Phân công một cú nhấp**: Nhấp "AI phân công Agents" để tự động gán agent cho tất cả tác vụ được chọn - **Ghép nối thông minh**: GPT-4 phân tích mô tả tác vụ và khả năng agent để thực hiện phân công tối ưu - **Tích hợp cài đặt toàn cục**: Cấu hình khóa API OpenAI trong tab Cài đặt toàn cục - **Hỗ trợ biến môi trường**: Cũng hỗ trợ biến môi trường `OPENAI_API_KEY` hoặc `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` - **Hướng dẫn lỗi**: Cung cấp hướng dẫn rõ ràng nếu khóa API chưa được cấu hình #### Hướng dẫn thiết lập: 1. **Cấu hình khóa API**: Đi đến Cài đặt → Cài đặt toàn cục và nhập khóa API OpenAI 2. **Chọn tác vụ**: Sử dụng checkbox để chọn tác vụ cần phân công agent 3. **Phân công AI**: Nhấp nút "🤖 AI phân công Agents" trong thanh hành động hàng loạt 4. **Xử lý tự động**: GPT-4 sẽ phân tích tác vụ và gán agent phù hợp nhất  *Cấu hình khóa API OpenAI trong Cài đặt toàn cục cho phân công agent được hỗ trợ AI*  *Chọn nhiều tác vụ và nhấp "🤖 AI phân công Agents (đã chọn 5 tác vụ)" để tự động gán agent phù hợp bằng GPT-4* ### 📊 Kiểm soát phiên bản Git cho lịch sử tác vụ **Commit Git tự động theo dõi mọi thay đổi trong tác vụ của bạn** SHRIMP-TASK-MANAGER hiện bao gồm tích hợp Git tích hợp sẵn tự động theo dõi tất cả thay đổi trong tệp tasks.json của bạn. Điều này cung cấp audit trail hoàn chỉnh của các sửa đổi tác vụ mà không cần can thiệp thủ công. Tính năng chính bao gồm: - **Kho Git tự động**: Khởi tạo kho Git trong thư mục dữ liệu khi sử dụng lần đầu - **Commit có timestamp**: Mỗi thao tác tác vụ (tạo, cập nhật, xóa) tạo commit với timestamp múi giờ địa phương - **Thông báo mô tả**: Commit bao gồm mô tả rõ ràng về những gì đã thay đổi (ví dụ: "Thêm tác vụ mới: Triển khai xác thực người dùng") - **Không chặn**: Thao tác Git được bao bọc trong khối try-catch - nếu Git thất bại, thao tác tác vụ vẫn tiếp tục bình thường - **Kho tách biệt**: Kho Git chỉ dành cho lịch sử tác vụ, hoàn toàn tách biệt với kho dự án của bạn - **Không xung đột merge**: Theo dõi tệp đơn với lịch sử tuyến tính có nghĩa là không thể xung đột #### Lợi ích: - **Lịch sử hoàn chỉnh**: Xem lại toàn bộ tiến hóa của tác vụ bằng công cụ Git tiêu chuẩn - **Theo dõi thay đổi**: Xem chính xác khi nào và như thế nào tác vụ được sửa đổi - **Tùy chọn phục hồi**: Khôi phục trạng thái tác vụ trước đó nếu cần - **Khả năng hiển thị nhóm**: Chia sẻ lịch sử tác vụ với thành viên nhóm Tích hợp Git hoàn toàn trong suốt và không yêu cầu cấu hình. Bạn có thể xem lịch sử bất cứ lúc nào bằng: ```bash cd <shrimp-data-directory> git log --oneline ``` #### Cách xem lịch sử tác vụ 1. **Điều hướng đến thư mục dữ liệu tác vụ** (như được cấu hình trong `.mcp.json`): ```bash cd <shrimp-data-directory> ``` 2. **Xem lịch sử commit**: ```bash git log --oneline ``` 3. **Xem thay đổi cụ thể**: ```bash git show <commit-hash> ``` 4. **So sánh phiên bản**: ```bash git diff HEAD~5 # So sánh với 5 commit trước ``` 5. **Khôi phục trạng thái trước** (nếu cần): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 Giao diện lịch sử dự án **Theo dõi và phân tích lịch sử thực hiện tác vụ dự án** SHRIMP-TASK-MANAGER tự động lưu các tác vụ đã hoàn thành vào tệp bộ nhớ trong dự án của bạn mỗi khi bạn bắt đầu phiên tác vụ mới. Trước đây, dữ liệu lịch sử có giá trị này bị ẩn trong các tệp bộ nhớ này và không thể truy cập qua UI. Giao diện lịch sử dự án mới công khai lịch sử tác vụ này, cho phép bạn khám phá cách dự án phát triển theo thời gian. Tính năng này cho phép bạn: - **Snapshot tác vụ lịch sử**: Duyệt qua các trạng thái quá khứ của dự án được lưu bởi SHRIMP-TASK-MANAGER - **Theo dõi tiến hóa tác vụ**: Xem tác vụ tiến triển từ tạo đến hoàn thành qua các phiên khác nhau như thế nào - **Hệ thống ghi chú**: Thêm ghi chú cá nhân vào các mục lịch sử để tham khảo tương lai và chia sẻ kiến thức nhóm - **Giao diện tác vụ chi tiết**: Khám phá sâu các trạng thái tác vụ lịch sử cụ thể để hiểu quyết định và triển khai quá khứ - **Điều hướng dựa thời gian**: Điều hướng qua dòng thời gian dự án để xem điều gì được hoàn thành khi nào - **So sánh snapshot**: So sánh trạng thái tác vụ qua các giai đoạn thời gian khác nhau để theo dõi sự phát triển và thay đổi của dự án   ### 🎨 Hệ thống quản lý Template **Tùy chỉnh template mạnh mẽ cho thực hiện tác vụ AI** Template là những hướng dẫn cốt lõi hướng dẫn SHRIMP-TASK-MANAGER phân tích và thực hiện các loại thao tác khác nhau. Chúng định nghĩa cách AI tiếp cận các loại thao tác khác nhau, từ lập kế hoạch và phân tích đến triển khai và xác minh. MCP-TASK-MANAGER cho phép template tùy chỉnh có thể ghi đè hành vi mặc định hoặc thêm hướng dẫn bổ sung vào template hiện có. Giao diện quản lý template mới này cung cấp cách trực quan để: - **Trình soạn thảo Template**: Trình soạn thảo markdown đầy đủ tính năng với tô sáng cú pháp để tạo hướng dẫn AI tùy chỉnh - **Xem trước Template**: Xem trước trực tiếp template trước khi kích hoạt để đảm bảo chúng đáp ứng yêu cầu - **Nhân bản Template**: Dễ dàng tạo biến thể của template hiện có cho các trường hợp sử dụng khác nhau - **Theo dõi trạng thái Template**: Chỉ báo trực quan hiển thị trạng thái Mặc định (gốc), Tùy chỉnh (thay thế hoàn toàn), và Tùy chỉnh+Thêm (thêm vào mặc định) - **Đặt lại về mặc định**: Khôi phục template gốc một cú nhấp khi cần - **Xuất Template**: Xuất template tùy chỉnh để sao lưu, chia sẻ với thành viên nhóm, hoặc kiểm soát phiên bản - **Hộp thoại kích hoạt**: Xác nhận rõ ràng khi kích hoạt template để ngăn thay đổi vô tình  ### 🌍 Hỗ trợ quốc tế hóa (i18n) **Hỗ trợ đa ngôn ngữ với chuyển đổi ngôn ngữ mượt mà** - **Hỗ trợ ba ngôn ngữ**: Tiếng Anh (en), Tiếng Trung (中文), và Tiếng Tây Ban Nha (Español) - **Lựa chọn ngôn ngữ bền vững**: Tùy chọn ngôn ngữ của bạn được lưu và ghi nhớ - **Dịch UI hoàn chỉnh**: Tất cả phần tử UI, nút, nhãn, và thông báo được dịch đầy đủ - **Chuyển đổi ngôn ngữ động**: Thay đổi ngôn ngữ ngay lập tức mà không cần tải lại trang - **Nhà cung cấp ngữ cảnh ngôn ngữ**: Quản lý ngôn ngữ tập trung để dịch thuật nhất quán ### 🧭 Cải thiện điều hướng và UI **Cải tiến giao diện hiện đại, trực quan** - **Hệ thống tab lồng nhau**: Điều hướng được tổ chức với tab chính và phụ - **Đồng bộ trạng thái URL**: URL trình duyệt cập nhật để phản ánh giao diện hiện tại - **Điều hướng chi tiết tác vụ**: Nút Trước/Sau cho phép xem lại tác vụ tuần tự mà không quay về danh sách - **Spinner tải**: Phản hồi trực quan trong quá trình tải dữ liệu - **Thông báo Toast**: Thông báo thành công/lỗi không xâm phạm - **Thiết kế responsive**: Cải thiện trải nghiệm di động và máy tính bảng - **Cải tiến Modal**: Bố cục và tương tác modal tốt hơn - **Điều hướng bàn phím**: Hỗ trợ phím mũi tên để điều hướng tác vụ nhanh hơn trong giao diện chi tiết ## 🔄 Cải tiến đáng kể ### Điều hướng chi tiết tác vụ **Quy trình xem lại tác vụ mượt mà** Giao diện chi tiết tác vụ hiện bao gồm nút điều hướng Trước/Sau biến đổi cách bạn xem lại và làm việc với tác vụ: - **Điều hướng tuần tự**: Di chuyển qua tác vụ theo thứ tự mà không quay về danh sách chính - **Bảo tồn ngữ cảnh**: Duy trì trong giao diện chi tiết khi chuyển đổi giữa các tác vụ - **Chỉ báo trực quan**: Nút hiển thị số tác vụ (ví dụ: "← Trước (Tác vụ 3)" và "Sau (Tác vụ 5) →") - **Ranh giới thông minh**: Nút điều hướng bị vô hiệu hóa ở tác vụ đầu tiên và cuối cùng - **Phím tắt bàn phím**: Sử dụng phím mũi tên để điều hướng nhanh hơn - **Tăng hiệu quả**: Xem lại toàn bộ danh sách tác vụ nhanh hơn 3-5 lần so với nhấp qua lại Tính năng này đặc biệt có giá trị khi: - Xem lại tác vụ mới tạo từ phân tích AI - Làm việc qua chuỗi tác vụ phụ thuộc - Kiểm tra chi tiết triển khai qua nhiều tác vụ liên quan - Thực hiện kiểm toán hoặc xem lại tác vụ ### Nâng cao hiệu suất - **Tối ưu hóa re-render**: React hooks được ghi nhớ đúng cách để hiệu suất tốt hơn - **Lazy Loading**: Component tải theo yêu cầu để tải trang ban đầu nhanh hơn - **Quản lý trạng thái hiệu quả**: Giảm cập nhật trạng thái không cần thiết - **Cập nhật hàng loạt**: Nhiều thay đổi trạng thái được nhóm lại để UI mượt hơn ### Trải nghiệm nhà phát triển - **Bộ test toàn diện**: Thêm test tích hợp và tính năng ngôn ngữ - **Checklist test**: Tài liệu test có cấu trúc - **Xử lý lỗi tốt hơn**: Thông báo lỗi thông tin hơn - **Debug logging**: Khả năng debug nâng cao cho phát triển ### Cải tiến UI/UX - **Bảng tác vụ cải tiến**: Kích thước cột và xuống dòng văn bản tốt hơn - **Modal nâng cao**: Phong cách và hành vi modal nhất quán - **Typography tốt hơn**: Cải thiện khả năng đọc với kích thước font cập nhật - **Cập nhật bảng màu**: Độ tương phản màu dễ tiếp cận hơn - **Nhất quán biểu tượng**: Sử dụng biểu tượng thống nhất trong toàn ứng dụng ## 🐛 Sửa lỗi ### Sửa lỗi quan trọng - **Lỗi useRef Hook**: Sửa import React hook thiếu gây crash ứng dụng - **Khóa dịch thuật**: Thêm khóa dịch thiếu cho tất cả ngôn ngữ được hỗ trợ - **Vòng lặp Symbolic Link**: Giải quyết vấn đề vòng lặp vô hạn thư mục Screenshots - **Xử lý đường dẫn Windows**: Sửa vấn đề file:// URI trên Windows 11 - **Liên kết repository**: Sửa tất cả tham chiếu repository ### Sửa lỗi UI - **Z-index Modal**: Sửa vấn đề phân lớp modal - **Lựa chọn Tab**: Sửa tính bền vững tab qua tải lại trang - **Bộ chọn ngôn ngữ**: Sửa vấn đề đồng bộ trạng thái - **Chức năng sao chép**: Cải thiện độ tin cậy thao tác clipboard - **Bố cục responsive**: Sửa vấn đề viewport di động ### Xử lý dữ liệu - **Tải profile**: Sửa điều kiện race khi chuyển profile - **Làm mới tác vụ**: Cải thiện độ tin cậy tự động làm mới - **Tải lịch sử**: Sửa vấn đề phân trang trong giao diện lịch sử - **Lưu template**: Giải quyết lỗi bền vững template ## 🏗️ Cập nhật kỹ thuật ### Phụ thuộc mới - `@headlessui/react`: Component UI hiện đại - `@tanstack/react-table`: Chức năng bảng nâng cao - `@uiw/react-md-editor`: Chỉnh sửa Markdown cho template - Định nghĩa kiểu bổ sung cho hỗ trợ TypeScript ### Cải tiến API - **GET /api/templates**: Liệt kê tất cả template có sẵn - **PUT /api/templates/:name**: Cập nhật nội dung template - **POST /api/templates/:name/duplicate**: Nhân bản template - **GET /api/history/:profileId**: Lấy lịch sử dự án - **Phản hồi lỗi nâng cao**: Thông báo lỗi API chi tiết hơn ### Cải tiến kiến trúc - **Modular hóa Component**: Tách biệt mối quan tâm tốt hơn - **Custom Hooks**: Logic có thể tái sử dụng được trích xuất thành hooks - **Context Providers**: Quản lý trạng thái tập trung - **Utility Functions**: Tiện ích chia sẻ cho thao tác thông thường ## 📝 Thay đổi không tương thích ### Cập nhật cấu hình - **Cài đặt ngôn ngữ**: Định dạng lưu trữ tùy chọn ngôn ngữ mới - **Lưu trữ Template**: Template hiện được lưu trong thư mục home người dùng - **Cấu trúc URL**: Mẫu URL cập nhật để điều hướng tốt hơn ### Thay đổi API - **Endpoint Profile**: Định dạng phản hồi cập nhật bao gồm thêm metadata - **Endpoint Task**: Nâng cao với tùy chọn lọc bổ sung - **Endpoint Template**: Cấu trúc endpoint mới cho quản lý template ## 🚀 Hướng dẫn di chuyển ### Từ v2.1 lên v3.0 1. **Lựa chọn ngôn ngữ**: Ngôn ngữ mặc định sẽ là tiếng Anh; chọn ngôn ngữ ưa thích từ bộ chọn mới 2. **Template**: Template tùy chỉnh hiện có sẽ được bảo tồn nhưng có thể cần kích hoạt lại 3. **Cache trình duyệt**: Xóa cache trình duyệt để hiệu suất tối ưu 4. **Dữ liệu Profile**: Tất cả profile hiện có sẽ tiếp tục hoạt động mà không thay đổi ## 🎯 Tóm tắt Phiên bản 3.0 đại diện cho bước tiến lớn của Task Viewer, biến đổi từ công cụ trực quan hóa tác vụ đơn giản thành nền tảng quản lý và tùy chỉnh tác vụ toàn diện. Với hỗ trợ quốc tế hóa đầy đủ, quản lý template mạnh mẽ, tự động hóa được hỗ trợ AI, và khả năng theo dõi lịch sử dựa Git, bản phát hành này cung cấp cho các nhóm quyền kiểm soát chưa từng có đối với quy trình phát triển được hỗ trợ AI của họ. Điểm nổi bật chính của bản phát hành này bao gồm: - **Phân công Agent được hỗ trợ AI**: Tận dụng GPT-4 để tự động gán agent phù hợp nhất cho tác vụ - **Kiểm soát phiên bản Git**: Theo dõi tự động tất cả thay đổi tác vụ với commit có timestamp - **Hỗ trợ đa ngôn ngữ**: Quốc tế hóa đầy đủ với tiếng Anh, Trung Quốc, và Tây Ban Nha - **Quản lý Template**: Tùy chỉnh sâu hành vi AI thông qua chỉnh sửa template - **Giao diện lịch sử**: Khả năng hiển thị hoàn chỉnh tiến hóa dự án thông qua cả commit Git và snapshot bộ nhớ Việc thêm hỗ trợ ba ngôn ngữ (Tiếng Anh, Trung Quốc, Tây Ban Nha) làm cho công cụ có thể truy cập được đối với đối tượng toàn cầu, trong khi hệ thống quản lý template cho phép tùy chỉnh sâu hành vi AI. Tích hợp Git cung cấp audit trail vĩnh viễn của tất cả sửa đổi tác vụ, và tính năng phân công hàng loạt được hỗ trợ AI tăng tốc độ cấu hình tác vụ một cách đáng kể. Bản phát hành này đặt nền móng cho các cải tiến tương lai và định vị Task Viewer như một công cụ thiết yếu trong bộ công cụ phát triển được hỗ trợ AI hiện đại.