Quản lý và theo dõi DSH Skills bằng echocat-skill-panel 3.0

Giới thiệu dự án

echocat-skill-panel 3.0 là plugin cordis dành cho DSH Desktop Beta. Plugin suy ra những skill thực sự được sử dụng trong từng lượt hội thoại từ luồng sự kiện phiên, thay vì phụ thuộc vào việc mô hình chủ động báo cáo.

Dù skill được mô hình tự động gọi, được người dùng gọi thủ công qua /name, hay hoàn toàn không được gọi trong lượt hiện tại, plugin đều đưa ra kết luận tương ứng.

Chức năng của ba giao diện

Ba入口 của plugin dùng chung một nguồn dữ liệu nhưng phù hợp với các tình huống thao tác khác nhau:

• Thanh ngang phía trên ô nhập: luôn hiển thị một dòng kết luận; nhấp vào để mở rộng báo cáo đầy đủ ngay tại chỗ. Đây là giao diện duy nhất hỗ trợ trích dẫn skill bằng một lần nhấp.
• Biểu tượng ở thanh bên trái: là入口 thường trực; nhấp vào để mở bảng điều khiển ở khu vực giữa.
• Bảng điều khiển ở cột giữa: dùng để xem báo cáo đầy đủ và danh mục skill.

Cài đặt plugin

Cách 1: Cài đặt từ mã nguồn GitHub

Cài đặt từ mã nguồn được khuyến nghị vì cung cấp đầy đủ gói. Chạy các lệnh sau trong PowerShell:

git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1"

Script cài đặt lần lượt sao lưu danh sách profile, thực hiện xử lý mirror, dọn tên gói cũ, tạo liên kết, chỉnh sửa manifest và chạy pnpm install.

Cách 2: Cài đặt qua npm hoặc DSH

Plugin đã được phát hành lên npm với tên gói echocat-skill-panel-3.0. Bạn có thể để DSH hoàn tất việc cài đặt:

dsh plugin --profile web add echocat-skill-panel-3.0

Bạn cũng có thể cài đặt trực tiếp vào thư mục profile:

npm install echocat-skill-panel-3.0

@deepseek-ai/dsh-llm và @deepseek-ai/schemastery được khai báo là peer dependencies tùy chọn. Chúng do runtime DSH cung cấp, nên npm sẽ không tải thêm bản sao để thay thế phiên bản của host.

Sau khi cài đặt xong, bắt buộc phải khởi động lại DSH Desktop Beta. Mã phía host được nạp vào bộ nhớ khi khởi động, vì vậy sau khi sửa host cũng phải khởi động lại. Nếu chỉ sửa mã client, chỉ cần làm mới trang để tải lại bundle client.

Khôi phục và an toàn khi cài đặt

Script cài đặt từ mã nguồn sẽ sao lưu danh sách profile trước khi thao tác. Khi cần khôi phục, có thể sử dụng tham số -Rollback do script cung cấp. Đối với cài đặt thủ công, khôi phục sau khi gỡ cài đặt và các ràng buộc bắt buộc có thể khiến ứng dụng không khởi động được, hãy tham khảo hướng dẫn cài đặt trong kho mã.

Cài đặt một skill

Sau khi mở giao diện cài đặt plugin, bạn có thể dán trực tiếp địa chỉ đầy đủ do tác giả cung cấp mà không cần điền riêng kho, nhánh và thư mục con.

Ví dụ, dán địa chỉ thư mục con trên GitHub sau:

https://github.com/owner/repo/tree/main/skills/my-skill

Host sẽ nhận diện loại địa chỉ, xác định cần clone hay tải xuống, đồng thời phân tích nhánh và thư mục con từ liên kết. Plugin hỗ trợ các dạng đầu vào sau:

• Địa chỉ trang chủ kho GitHub.
• Liên kết đến thư mục trong kho.
• Liên kết đến tệp SKILL.md.
• Liên kết trực tiếp đến tệp ZIP.
• Định dạng owner/repo.
• Địa chỉ SSH.
• Tải lên tệp .md hoặc .zip cục bộ.
• Dán trực tiếp toàn bộ nội dung SKILL.md.

Nếu vị trí đích đã có skill cùng tên, plugin sẽ không âm thầm ghi đè mà tạo bản sao lưu trước khi thay thế. Khi xóa skill, tệp cũng được chuyển vào thư mục sao lưu và không bị xóa vĩnh viễn.

Xem các skill được sử dụng trong từng lượt hội thoại

Chỉ cần sử dụng DSH để bắt đầu hội thoại như bình thường. Sau mỗi lượt, plugin sẽ tạo báo cáo dựa trên luồng sự kiện phiên và hiển thị một thông báo hệ thống gốc.

1. Hoàn thành một lượt hội thoại.
2. Xem kết luận tóm tắt trên thanh ngang phía trên ô nhập.
3. Nhấp vào thanh ngang để mở rộng báo cáo đầy đủ của lượt hiện tại.
4. Bạn cũng có thể mở bảng điều khiển ở cột giữa thông qua biểu tượng ở thanh bên trái để xem báo cáo và danh mục skill.

Phương thức phát hiện này không yêu cầu mô hình phải tuyên bố skill nào đã được gọi trong câu trả lời. Vì vậy, ngay cả khi mô hình quên giải thích, bảng điều khiển vẫn hiển thị kết quả dựa trên bản ghi sự kiện.

Trích dẫn và gọi skill bằng một lần nhấp

Thanh ngang phía trên ô nhập là giao diện duy nhất cung cấp chức năng trích dẫn bằng một lần nhấp. Sau khi mở rộng thanh ngang, nhấp vào Trích dẫn trên thẻ skill mục tiêu, plugin sẽ thêm cú pháp tương ứng vào bản nháp hiện tại:

/名字 

Sau đó nhấn Enter để gửi và gọi skill bằng cú pháp thủ công. Thông báo xuất hiện sau khi cài đặt skill thành công cũng có nút tương tự, vì vậy bạn có thể trích dẫn và sử dụng ngay sau khi cài đặt.

Thiết lập tên hiển thị tiếng Trung

Plugin hiển thị tên tiếng Trung thông qua trường display-name-zh trong meta.yaml của chính skill. Bạn có thể điền trường này khi cài đặt hoặc chỉnh sửa qua thẻ skill sau khi cài đặt.

• Sau khi điền tên tiếng Trung, bảng điều khiển sẽ ưu tiên hiển thị tên này.
• Để trống trường này để xóa tên hiển thị tiếng Trung.
• Cú pháp gọi /名字 vẫn sử dụng mã ASCII và không bị ảnh hưởng bởi tên hiển thị tiếng Trung.

Đối với skill chưa có tên tiếng Trung, plugin cũng có thể tự động dịch và lưu vào bộ nhớ đệm kết quả hiển thị.

Đề xuất sử dụng nâng cao

Hiểu về chế độ chỉ đọc

Nếu môi trường host không cho phép ghi, plugin sẽ tự động chuyển sang trạng thái chỉ đọc và nêu rõ lý do. Khi đó vẫn có thể xem báo cáo và danh mục, nhưng các thao tác cài đặt, chỉnh sửa hoặc xóa sẽ chịu giới hạn quyền của host.

Tận dụng bản sao lưu để tránh thao tác nhầm

Skill cùng tên sẽ được tự động sao lưu trước khi thay thế; thao tác xóa cũng không xóa tệp vĩnh viễn. Trước khi nâng cấp hoặc cài thử skill từ nguồn chưa xác định, bạn nên kiểm tra thư mục sao lưu và bản sao lưu danh sách profile để bảo đảm có thể khôi phục khi cần.

Phân biệt thay đổi ở client và host

Bundle client được tải lại khi mở trang, vì vậy các thay đổi chỉ ở client thường chỉ cần làm mới trang. Nội dung phía host được nạp vào bộ nhớ khi DSH khởi động; mọi thay đổi ở host hoặc việc hoàn tất cài đặt plugin đều cần khởi động lại DSH Desktop Beta.

Bật giao diện tối và các cấu hình khác

Plugin hỗ trợ giao diện tối, thông báo hệ thống sau mỗi lượt, bộ nhớ đệm dịch tự động và đầy đủ các tùy chọn cấu hình. Có thể xem các tùy chọn cụ thể và giới hạn cài đặt trong hướng dẫn cài đặt.

Phát triển và xây dựng

Nếu đã sửa src/client/, cần tạo lại sản phẩm build phía client:

node tools/build-client.mjs

lib/client.js là sản phẩm build bắt buộc phải commit vào kho mã, vì máy đích có thể không có toolchain. Các thay đổi trong src/client/ phải được commit cùng tệp đã xây dựng lại; nếu không, quá trình kiểm tra tính nhất quán giữa bundle và gói của verify-install.mjs sẽ thất bại.

Runtime của dự án không có dependency bổ sung; cả hai peer dependencies đều do host cung cấp. Có thể tham khảo các điểm thiết kế để biết về kiến trúc, quy tắc an toàn của công cụ cài đặt, các vấn đề dễ gặp khi triển khai và chi tiết kiểm thử.

Tóm tắt

echocat-skill-panel 3.0 tập trung việc theo dõi lệnh gọi skill, duyệt danh mục, cài đặt, trích dẫn, hiển thị tên tiếng Trung và gỡ cài đặt an toàn vào DSH Desktop Beta. Sau khi cài đặt plugin và khởi động lại ứng dụng, bạn có thể nhanh chóng xem báo cáo từng lượt qua thanh ngang phía trên ô nhập và dùng nút trích dẫn để thêm skill mục tiêu vào bản nháp. Dự án sử dụng giấy phép MIT.