GitHub 儲存庫 · 發布者 Haworthiasa

limit-line

Name: limit-line
Author: Haworthiasa

Claude Code 的外掛：在提示列上方顯示限制列（5 小時/每週、上下文、快取命中），提供 /usage-plus 面板和用於 pytest 及長記錄的 Bash 輸出蒸餾器。

Haworthiasa@Haworthiasa

Haworthiasa/limiter/tree/main/limit-line

已翻譯

關於這個 mod

limit-line 是 Claude Code 的外掛（≥ 2.1.287），包含提示列上方的限制區段（5 小時、每週、上下文、快取命中、上下文差值、蒸餾器截斷層級）、每輪詳細列、帶有 Session/Week/Month 三個分頁的 /usage-plus 面板，以及 Bash 輸出蒸餾器：長輸出（≥ 8000 個字元）會在 Claude 讀取前縮短到 ≤ 4000 個字元，完整版本儲存到 <project>/.claude/distill/。它為 pytest 提供獨立的篩選器（依簽名彙整錯誤），符合清單的失敗命令（pytest、python train、docker logs、pip install、make/ninja/cargo/npm build）會在執行前被包裝。命令：/limits、/limits detail、/usage-plus、/distill on|off|stats|last。資料儲存在 ~/.local/share/limit-line/。Claude Code 的 PATH 中需要 node ≥ 23.6。成本是依據 hooks/pricing.ts 計算的 API-equiv，不是訂閱方案實際需要支付的金額。

安裝

請先查看作者 README，確認 marketplace 與外掛名稱；指令可能隨儲存庫結構而變動。

claude plugin marketplace add Haworthiasa/limiter
claude plugin install limit-line

原文 / README

limit-line

Mod cho Claude Code (≥ 2.1.287): dòng hạn mức phía trên ô prompt, bảng /usage-plus, và bộ chưng cất output Bash.

Tính năng

Band (phía trên prompt):

5h █░░░░░ 13% 2h19m | wk ██░░░░ 34% T2 10:00 | ctx ░░░░░░ 7% ▲+18k | cache 90% | dist -142k   [+]
turn 4 req · in 61k (cache 55k · write 4k · new 2k) · out 2.3k · ~$0.42 · opus · ctx ▃▄▆█

5h / wk: hạn mức 5 giờ và tuần, thời điểm reset, ! khi dự báo sẽ cạn trước khi reset. Có toast ở 80% và 95%.
ctx: mức đầy context; ▲+N / ▼-N: context đổi bao nhiêu trong turn vừa xong (đỏ nếu quá 10% cửa sổ).
cache N%: tỉ lệ cache hit của turn vừa xong (xanh ≥ 80, vàng 50–79, đỏ < 50).
dist -N: số ký tự distiller đã cắt trong phiên.
[+] / /limits detail: dòng chi tiết turn (số request, token theo loại, chi phí API-equiv, model, biểu đồ ctx). Lựa chọn được nhớ giữa các phiên.
Màn hình hẹp: bỏ dist, rồi ▲, rồi cache, rồi thu gọn thanh.

/usage-plus: pane ba tab, phím 1 Session, 2 Week, 3 Month, x đóng (cần focus pane: click hoặc ctrl+x tab). Token theo loại mỗi ngày, cache hit, tiền tiết kiệm nhờ cache, các lần cache bust kèm nguyên nhân (sau /compact, hết TTL, đổi model, không rõ), phân bổ theo model và project, lịch sử hạn mức và dự báo tuần, thống kê distiller. Mỗi lần mở sẽ chạy indexer (đọc tăng dần ~/.claude/projects).

Distiller (hook trên Bash): output dài (≥ 8000 ký tự) được rút gọn còn ≤ 4000 trước khi Claude đọc; bản đầy đủ luôn lưu ở <project>/.claude/distill/ (tự thêm vào .gitignore của repo git). Có bộ lọc riêng cho pytest (gom lỗi theo chữ ký, traceback đầu của mỗi nhóm), các log khác dùng bộ lọc chung (đầu, cuối và mọi dòng lỗi).

Lệnh thành công: output được thay sau khi chạy.
Lệnh thất bại: core không cho rút gọn sau khi chạy, nên các lệnh khớp danh sách (pytest, python *train*, docker logs, pip install, make/ninja/cargo/npm build) được bọc trước khi chạy: output đầy đủ ghi ra file, in bản rút gọn, giữ đúng mã thoát. Vì vậy quy tắc permission sẽ thấy lệnh đã bọc.

Lệnh

| Lệnh | Việc | |---|---| | /limits | Ẩn / hiện band | | /limits detail | Bật / tắt dòng chi tiết turn | | /usage-plus | Mở bảng usage (nếu trùng tên: /usage-x) | | /distill on / off | Bật / tắt distiller (nhớ giữa các phiên) | | /distill stats | Số lần, ký tự đã cắt theo loại, tỉ lệ đọc lại | | /distill last | Đường dẫn log đầy đủ của lần gần nhất |

Muốn xem output gốc của một lệnh: thêm NO_DISTILL=1 vào lệnh. Lệnh đọc file trong .claude/distill/ không bị chưng cất.

Dữ liệu

~/.local/share/limit-line/:

ledger/<ngày>.json        mỗi request trực tiếp (token, model, project; không có nội dung)
measure/<tháng>.json      các lần đọc hạn mức (thưa)
compact/<tháng>.json      các lần compact
distill/<tháng>.json      các lần chưng cất (kích thước, đường dẫn log)
index/state.json          vị trí đã đọc của từng file JSONL
index/days/<ngày>.json    tổng hợp theo ngày (giờ Asia/Bangkok)

Xóa dữ liệu: rm -rf ~/.local/share/limit-line (indexer sẽ đọc lại từ đầu lần sau), và rm -rf <project>/.claude/distill. Đọc lại lịch sử từ đầu: node scripts/indexer.mjs --rebuild.

Giới hạn đã biết

Chi phí là API-equiv theo bảng giá trong hooks/pricing.ts (cập nhật 2026-09-25, cần xác nhận); với gói subscription đây không phải số tiền phải trả.
Usage trực tiếp không tách cache write 5m/1h: band và ledger tính như 1h; indexer dùng số tách trong JSONL.
Lời gọi advisor nằm trong usage.iterations của JSONL: indexer có tính, band và ledger trực tiếp thì không.
Dấu compact và subagent trong JSONL chưa được xác minh trên dữ liệu thật (chưa có phiên nào như vậy).
Ước tính "ngoài máy này" chỉ hiện khi có ít nhất 2 cửa sổ 5h đầy đủ trong ledger.
Distiller mới có bộ lọc pytest và chung; cuda, docker, train để sau.
Cần node ≥ 23.6 trong PATH của Claude Code (indexer và wrapper của distiller chạy file .ts trực tiếp).

Phát triển

claude plugin validate --strict .     # manifest + module
claude plugin test .                  # test của engine
node --test tests/indexer.node.mjs    # test của indexer
npx -p typescript@5 tsc -p .          # kiểu (sau khi Claude Code đã sinh .claude-plugin/types)
node scripts/build-fixtures.mjs       # sau khi thêm log vào tests/fixtures/<loại>/

作品資訊

作者: Haworthiasa
用途: 儀表板與 HUD
收錄於: 2026年10月5日
來源更新: 2026年10月2日
星數: 0
權限足跡: L2
次瀏覽: 0

bash-distillerclaude-codecontext-monitorcost-trackinghookspluginpytestusage-dashboard

回報這個作品這是你的作品？認領

贊助

在此刊登，每週 $10 起

權限足跡 L2

權限足跡

資料來自自動掃描，安裝前請自行查看原始碼。等級描述能力，不代表安全認證。

環境變數
讀取檔案
寫入檔案
執行指令
攔截工具呼叫

查看命中位置（23）

環境變數 · 第54 行limit-line/hooks/register.tsxconst home = await $.env.get('HOME')

讀取檔案 · 第63 行limit-line/hooks/register.tsxlist = JSON.parse(await $.fs.read(path)) as T[]

寫入檔案 · 第67 行limit-line/hooks/register.tsxawait $.fs.write(path, JSON.stringify([...list, ...items]))

讀取檔案 · 第72 行limit-line/hooks/register.tsxreturn JSON.parse(await $.fs.read(path)) as T

環境變數 · 第80 行limit-line/hooks/register.tsxconst home = await $.env.get('HOME')

執行指令 · 第87 行limit-line/hooks/register.tsx

const run = await $.process.run(['node', `${$.plugin.root}/scripts/indexer.mjs`, '--data', data], { timeoutMs: 120_000 })

執行指令 · 第63 行limit-line/hooks/band.tsreturn /opus|sonnet|haiku|fable|mythos/.exec(model)?.[0] ?? model

環境變數 · 第22 行limit-line/hooks/distiller.tsconst h = await $.env.get('HOME')

讀取檔案 · 第33 行limit-line/hooks/distiller.tsreturn JSON.parse(await $.fs.read(path)) as T

寫入檔案 · 第43 行limit-line/hooks/distiller.tsawait $.fs.write(path, JSON.stringify([...list, ...items]))

讀取檔案 · 第58 行limit-line/hooks/distiller.tstext = await $.fs.read(path)

寫入檔案 · 第63 行limit-line/hooks/distiller.tsawait $.fs.write(path, `${text}${text === '' || text.endsWith('\n') ? '' : '\n'}${IGNORE_LINE}\n`)

寫入檔案 · 第85 行limit-line/hooks/distiller.tsawait $.fs.write(file, JSON.stringify(list.map(x => (x.logPath === ev.logPath ? { ...x, reread: true } : x))))

讀取檔案 · 第92 行limit-line/hooks/distiller.ts? await $.fs.read(out.persistedOutputPath)

寫入檔案 · 第102 行limit-line/hooks/distiller.tsawait $.fs.write(logPath, raw)

寫入檔案 · 第105 行limit-line/hooks/distiller.tsawait $.fs.write(`${base}.part${i + 1}.log`, raw.slice(i * PART_CHARS, (i + 1) * PART_CHARS))

攔截工具呼叫 · 第118 行limit-line/hooks/distiller.tson('tool.call', { tool: 'Read' }, async ($, e, next) => {

攔截工具呼叫 · 第127 行limit-line/hooks/distiller.tson('tool.call', { tool: 'Bash' }, async ($, e, next) => {

寫入檔案 · 第148 行limit-line/hooks/distiller.tsawait $.fs.write(log, '')

執行指令 · 第155 行limit-line/hooks/distiller.tsconst m = ran.deny === undefined && ran.text !== undefined ? ANNOTATION.exec(ran.text) : null

執行指令 · 第42 行limit-line/hooks/distill/pytest.tsconst s = SECTION.exec(line)

執行指令 · 第49 行limit-line/hooks/distill/pytest.tsconst b = BLOCK.exec(line)

執行指令 · 第60 行limit-line/hooks/distill/pytest.ts.map(l => ENTRY.exec(l))

limit-line

關於這個 mod

安裝

limit-line

Tính năng

Lệnh

Dữ liệu

Giới hạn đã biết

Phát triển

更多類似作品

ruflo-docs

token-optimizer

databricks-cli