suken-cite-guide
Giúp một LLM agent (như Claude Code) giải thích có bằng chứng và cầm tay chỉ việc cho người dùng. Mỗi khẳng định kèm ảnh chụp nguồn khoanh đỏ đoạn trích và một dòng dịch; mỗi việc cần làm trên trình duyệt thì agent vẽ vòng đỏ ngay trên màn hình để người dùng tự bấm. Gói có 5 chế độ, người dùng gõ từ khoá trong chat để bật đúng chế độ cần:
| Từ khoá | Chế độ | Người đọc nhận |
|---|---|---|
suken-Story |
cốt truyện giải thích | một link tuyến truyện vẽ trên khung UI (trục thời gian, chuỗi nhân quả, so sánh, so số liệu, mâu thuẫn, chỗ hổng…), đi từng bước bằng ◀ ▶, ô nào cũng có 📷 mở ảnh nguồn |
suken-Cite |
trích dẫn đơn lẻ | câu trả lời ngắn, mỗi ý kèm một link ảnh nguồn khoanh đỏ |
suken-CodeStory |
cốt truyện code | một flow qua nhiều module kể thành tuyến truyện, mỗi bước một thẻ giải thích code |
suken-Code |
thẻ code | một thẻ gom vị trí trong flow, class, hàm, thư viện, biến và giá trị thật lúc chạy, bằng màu, icon, sơ đồ |
suken-Guide / suken-non_Guide |
cầm tay chỉ việc | vòng đỏ, mũi tên, 📋 dán, ⏎, 🔗 vẽ trên chính tab của mình; tự bấm từng bước, bấm sai thì bị chặn. Hết kịch bản, bấm ⏺ rồi tự khám phá: các bước và ảnh màn hình được ghi lại, gửi kèm tin nhắn kế tiếp |
Nguồn có thể là trang web (kể cả email, chat phải đăng nhập), PDF, Word, Excel, PowerPoint, CSV, ảnh, file code và file chữ (mở trong VS Code chạy trên trình duyệt).
Dùng thế nào
Cài gói, rồi cài hook một lần trong thư mục mở Claude Code:
pip install suken-cite-guide
suken-cite-guide setup # cài hook, 2 reviewer, code-server; kiểm chrome-devtools
Từ đó, gõ từ khoá kèm yêu cầu trong chat, ví dụ suken-Story vì sao run B chậm hơn run A?. Hook đưa
nguyên hướng dẫn của chế độ đó cho agent ngay trong lượt chat, agent không phải tự nhớ đọc. Riêng
suken-Guide giữ tới khi gõ suken-non_Guide: trong lúc bật, hook chặn agent tự bấm, gõ, mở, đóng tab
trên trình duyệt, chỉ người dùng tắt được.
Không dùng hook (agent khác Claude Code): bảo agent chạy suken-cite-guide usage để chọn chế độ và đọc
hướng dẫn. Mỗi hướng dẫn cùng một khung: luật vàng, checklist, review; agent chỉ giao kết quả khi reviewer
chấm ĐẠT.
Các lệnh
| Lệnh | Làm gì |
|---|---|
suken-cite-guide setup [--remove] |
cài hook cho 5 từ khoá (.claude/settings.local.json, giữ nguyên hook khác), 2 subagent reviewer (.claude/agents/), code-server (~220 MB vào cache); kiểm MCP chrome-devtools và cổng Chrome DevTools rồi báo thiếu gì. --remove gỡ hook và reviewer |
suken-cite-guide usage [story|cite|codestory|code|guide|renderer] |
in hướng dẫn của một chế độ (không kèm: in danh sách chế độ) |
suken-cite-guide init --dir ./cites |
tạo thư mục dự án trích dẫn |
suken-cite-guide serve --dir ./cites |
bật server xem ảnh, xem file (mặc định cổng 8123); render/pdf.html?file=…&page= và render/open.html?file=… mở thẳng PDF, Word, Excel, PowerPoint, CSV |
suken-cite-guide text --file … | --doc … |
in chữ của nguồn (pdf, docx, xlsx, pptx) để đọc nhanh trước khi chụp |
suken-cite-guide add … |
thêm trích dẫn: ảnh chụp --image + --box, hoặc thẻ code --explain <json> — thiếu mục nào thì từ chối và nói rõ |
suken-cite-guide skeleton --file … --lines … |
thẻ code: in khung JSON điền sẵn class, hàm, biến của các dòng code (Python) |
suken-cite-guide story --template timeline|argument |
in khung truyện; điền xong thì story --id … --json … kiểm và lưu |
suken-cite-guide editor --folder … |
mở VS Code chạy trên trình duyệt (code-server); lần đầu tự tải ~220 MB vào cache |
suken-cite-guide guide template |
in khung kịch bản cầm tay chỉ việc |
suken-cite-guide guide run <kịch bản|-> |
kiểm kịch bản rồi vẽ vòng đỏ trên tab người dùng; mỗi lần cần agent (xong, lạc, bấm sai, tunnel…) in một dòng JSON kèm ảnh tab và tóm tắt trang |
suken-cite-guide guide reattach [địa chỉ] |
gắn bộ điều khiển đang chạy vào kết nối Chrome mới (sau khi người dùng mở lại tunnel) |
suken-cite-guide register, snapshot, urls |
ghi nguồn gốc file; lưu bản sao trang web (cách cũ); in link |
suken-cite-guide check |
kiểm mọi trích dẫn và mọi truyện |
Ví dụ một trích dẫn:
suken-cite-guide init --dir ./cites
suken-cite-guide serve --dir ./cites &
# agent mở nguồn trên Chrome, chụp màn hình vào ./cites/shots/price.png, rồi chỉ vùng cần khoanh:
suken-cite-guide add --dir ./cites --id price --image ./cites/shots/price.png --box 120,340,860,372 \
--quote "Pears 2.40/kg" --section "prices.pdf · trang 3" --vi "Lê giá 2,40 mỗi kg."
# link cho người đọc : http://127.0.0.1:8123/c.html?id=price
Yêu cầu
- Python 3.9+ (không cần thư viện Python nào khác; phần chạy trên trình duyệt đã đóng gói sẵn).
- Chrome, và Claude Code có MCP server chrome-devtools; cầm tay chỉ việc dùng chung cổng DevTools đó
(mặc định
http://127.0.0.1:9222). - Hook và từ khoá: Claude Code.
- Nguồn phải đăng nhập (email, chat…): đăng nhập sẵn trên chính Chrome mà chrome-devtools điều khiển.
- Linux hoặc macOS.
Giấy phép
MIT. Các thư viện trình duyệt đi kèm và giấy phép của chúng nằm trong THIRD_PARTY_NOTICES.md.
Metadata
Release files for suken-cite-guide 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| suken_cite_guide-0.1.1.tar.gz | 3.4 MB | Without provenance | Details for suken_cite_guide-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| suken_cite_guide-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for suken_cite_guide-0.1.1-py3-none-any.whl |
Total release size: 6.8 MB
Release files / suken_cite_guide-0.1.1.tar.gz
| Download URL | suken_cite_guide-0.1.1.tar.gz |
|---|---|
| Size | 3.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fa77901cc1523bdccac634efa0c33cc5cfd876b093e5fd17f317673e1a195071
|
|
BLAKE2b-256 checksum How to use checksums |
508b81540c08bf7019104810b6a02574ceb93f1f28807a9f8e268787b00024ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / suken_cite_guide-0.1.1-py3-none-any.whl
| Download URL | suken_cite_guide-0.1.1-py3-none-any.whl |
|---|---|
| Size | 3.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bfd0799904fe8f3b8ad722315e50f7ee71ed5ea68c66f1c84f670faca6c27f91
|
|
BLAKE2b-256 checksum How to use checksums |
862f377c8cdd210039678fa83956773f79380068a7de3baa05508684ddec1489
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for suken-cite-guide 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.