PromptVault Documentation

Hướng dẫn chi tiết giúp bạn làm chủ thư viện Prompt AI cá nhân với ToolPuff PromptVault.

Thêm vào Chrome Chính sách Bảo mật

Tài liệu này mô tả toàn bộ cách dùng extension: Popup, Options, Quick Insert, Backup/Restore.

1. Tổng quan nhanh

ToolPuff PromptVault là extension quản lý prompt AI với 6 nhóm chức năng chính:

Lưu prompt nhanh từ text bôi đen (right click).
Quản lý thư viện prompt (search, sort, edit, duplicate, delete).
Prompt template với biến {{variable}}.
Tái sử dụng prompt nhanh bằng Popup extension hoặc /puff + Space trong ô chat AI.
Tổ chức prompt theo Folders + Collections.
Import/Export JSON để backup và restore.

2. Các khu vực giao diện

Extension có 3 điểm sử dụng chính:

Context menu: Chuột phải trên trang web.
Popup extension: Bấm icon extension trên thanh công cụ.
Options page: Trang quản lý đầy đủ các prompt và bộ sưu tập.

3. Hướng dẫn từng tính năng

3.1 Lưu prompt nhanh bằng chuột phải

Mục tiêu: lưu nhanh một đoạn text thành prompt.

Cách dùng:

Bôi đen đoạn text trên trang web.
Right click.
Bấm menu: Save to PromptVault.

Kết quả: Extension tạo 1 bản nháp (draft), mở Options page với form đã điền sẵn Title, Text, Model hint và Context.

3.2 Popup extension (sử dụng nhanh)

Mở popup bằng cách bấm icon extension trên thanh công cụ Chrome.

Khu header

New Prompt button: Mở Options page để tạo prompt mới thủ công.

Khu bo loc va sap xep

Search prompt or tag: Tìm theo title, description, text, tags, collection.
All collections: Lọc prompt theo collection.
Sort: Recently used, Most used, Newest.

Từng card prompt trong popup

Copy: Copy đối với prompt thường. Hỗ trợ thông báo Copied to clipboard.
Fill & Copy: Xuất hiện cho prompt template có variables, mở dialog điền biến.
Edit: Mở Options page để sửa prompt này.

Dialog variables trong popup

Cancel: Đóng dialog, không copy.
Generate & Copy: Render prompt từ các biến đã nhập và copy vào clipboard.

3.3 Quick insert bằng /puff trong chat AI

Mục tiêu: chèn prompt trực tiếp vào ô nhập chat, không cần paste tay.

Focus vào ô nhập chat.
Gõ /puff.
Chọn prompt từ Palette PromptVault hiện ra.

3.4 Options page - Quản lý đầy đủ

A) Block Collections

Add Collection: Tạo collection mới (gồm Name, Folder).
Delete: Xóa collection (prompt thuộc về sẽ chuyển về Inbox).
Inbox: Collection mặc định, không thể xóa.

B) Block Import / Export

Export JSON: Tải file backup JSON.
Import JSON: Khôi phục dữ liệu từ file JSON (có validate định dạng).

C) Form Create/Edit Prompt

Các trường: Title, Description, Collection, Category, Tags, Model, Context, Prompt template/text.
Template Variables: Tự động phát hiện {{variable}}. Hỗ trợ type text hoặc dropdown.

D) Block Library

Edit: Nạp prompt vào form để sửa.
Duplicate: Tạo bản sao prompt.
Delete: Xóa prompt (có confirm).

4. Luồng sử dụng đề xuất (Best practice)

Luồng A: Lưu & sử dụng

Right click save -> Thêm tags -> Save -> Popup search -> Copy.

Luồng B: Template

Tạo prompt với biến -> Popup -> Fill & Copy -> Generate.

Luồng C: Quick Insert

Chat AI -> Gõ /puff -> Chọn prompt.

Luồng D: Backup

Export JSON hàng tuần/tháng để đảm bảo an toàn dữ liệu.

5. Danh sách button và tác dụng

Popup: New Prompt, Copy, Fill & Copy, Edit, Cancel, Generate & Copy.
Options: Add Collection, Delete (collection), Export JSON, Import JSON, Save Prompt, Edit, Duplicate, Delete (library).
Context menu: Save to PromptVault.

6. Troubleshooting chi tiết

Copy không paste được: Kiểm tra quyền clipboard của trình duyệt hoặc thử dùng /puff.
/puff không mở palette: Refresh tab chat, kiểm tra focus ô nhập hoặc reload extension.
Variables không phát hiện: Đảm bảo đúng cú pháp {{variable_name}}.
Import JSON lỗi: Đảm bảo file JSON hợp lệ và đúng schema của PromptVault.

7. Lưu ý về quyền riêng tư

Dữ liệu prompt được lưu locally trong chrome.storage.local. bạn tự quản lý backup qua JSON.

8. Danh sách host hỗ trợ quick insert

chatgpt.com/*
chat.openai.com/*
claude.ai/*
gemini.google.com/*
copilot.microsoft.com/*