Skip to main content

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.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for suken-cite-guide 0.1.5
File Size Uploaded Provenance Actions
suken_cite_guide-0.1.5.tar.gz 3.4 MB Without provenance Details for suken_cite_guide-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for suken-cite-guide 0.1.5
File Interpreter ABI Platform Actions
suken_cite_guide-0.1.5-py3-none-any.whl Python 3 none any Details for suken_cite_guide-0.1.5-py3-none-any.whl

Total release size: 6.8 MB

Release files / suken_cite_guide-0.1.5.tar.gz

Download URL suken_cite_guide-0.1.5.tar.gz
Size 3.4 MB
Tags Source
SHA-256 checksum
How to use checksums
79d08cae547ed360497d7738679350b5eaf335c0b18fa4f3c617266dbbc12f78
BLAKE2b-256 checksum
How to use checksums
990bf2f4a7eaa374d10c96a7d4230092102d7f5f23d6a4a8fe08f92f581a86cb
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.5-py3-none-any.whl

Download URL suken_cite_guide-0.1.5-py3-none-any.whl
Size 3.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
b631e8a6b74a4a09a50328be4d95a8b98783a21ac03595a9dca915958e8a2990
BLAKE2b-256 checksum
How to use checksums
651af43a73779de35e44436cb94af605f92a50d6d653e0c13d59bdee0e7758a6
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.5

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page