Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

perf(harness-ops): plugin cache holds 1,053 version folders (1.5 GB) from release cadence; report churn, reduce versions

Đang mở
  • Có gì không ổn?
#6,636 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
22/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
performance, tooling

Hướng nghiên cứu

Start with plugins/harness-ops/lib/plugin_cache_versions.py (ORPHAN_SWEEP_DAYS = 14) and the report section of plugins/harness-ops/skills/audit-install-state/SKILL.md near line 144. The only code-level item is adding a report-only line for weekly orphan creation rate and the top 10 plugins by retained versions. The release-cadence ceiling needs a maintainer decision before anyone can finish it. Done means the report shows those numbers and deletes nothing.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

needs-human needs-triage

Related: #6244 (Windows performance audit tracker).

Problem

The plugin cache on the windows lane holds 1,053 version folders across 130 plugins (1.5 GB; cache/melodic-software alone is 984 MB, 940 folders). 95 plugins are enabled. The folders are not leaked: 905 carry an .orphaned_at marker and none is past the product's 14-day sweep. The volume comes from release cadence (the melodic-software plugins publish many versions per fortnight), and each version is a full copy.

This matters beyond disk: ~/.claude holds 195,094 files and a full walk took 21.5 s on this host (see melodic-software/provisioning issue on Defender exclusions); the cache is a large share of the file count that every scan, backup, and audit walks.

Measured

Method (direct, on melo-desk-001, 2026-10-08):

  • for m in ~/.claude/plugins/cache/*; do ls -d $m/*/*; done | wc -l returns 1,053 (version folders); for m in ~/.claude/plugins/cache/*; do ls -d $m/*; done | wc -l returns 130 (plugins).
  • find ~/.claude/plugins/cache -maxdepth 4 -name .orphaned_at | wc -l returns 905.
  • Marker age (days since .orphaned_at, first 400 markers): 0 to 11 days, none at 14 or more.
  • jq '[.enabledPlugins|to_entries[]|select(.value==true)]|length' ~/.claude/settings.json returns 95.
  • du -sh ~/.claude/plugins/cache returns 1.5G.

What the harness offers

  • Product: "When you update or uninstall a plugin, Claude Code writes an .orphaned_at marker into the previous version directory. It removes that directory in a background cleanup 14 days later" (https://code.claude.com/docs/en/plugins/loading, "Cleanup of previous versions"). I found no setting or flag to shorten that window.
  • harness-ops:audit-install-state already models this: plugins/harness-ops/lib/plugin_cache_versions.py (ORPHAN_SWEEP_DAYS = 14) classifies each folder, and plugins/harness-ops/skills/audit-install-state/SKILL.md:144 marks in-window folders product-managed-healthy with "Do not hand-prune". It offers report-only retention classification; deletion belongs to /disk-hygiene:clean and only for folders past the window.

So the audit does not offer a shorter retention; it correctly refuses to hand-prune in-window orphans (a running session may still load them).

Proposed fix

Reduce what creates the folders, since retention cannot be shortened:

  1. Release batching: publish a plugin version only when behavior changes, and batch the fragment-only chores (the release flow in chore(release): release N plugins). Count versions published per plugin over the last 14 days (ls -d ~/.claude/plugins/cache/melodic-software/<plugin>/* | wc -l; guardrails alone has 15) and set a per-plugin ceiling.
  2. Fewer large plugins in the default enabled set, or a lean-profile marketplace, so 95 enabled plugins is not the baseline.
  3. In audit-install-state, add a line that reports the weekly orphan creation rate and the top 10 plugins by retained version count, so the churn is visible. (Report only; no deletion.)

Basis: the 14-day product sweep above; measured marker ages. Judgment on the ceiling in item 1: no source gives a number, so the ceiling needs a decision with the evidence from the count above.

Expected saving

Folders retained scale with versions per plugin per 14 days. Halving the cadence would roughly halve the 905 orphaned folders and about 700 MB of the cache. Not a performance fix by itself; it lowers file count for every scan of ~/.claude.

Verify after the fix

  • Re-run the counts above after one full 14-day window; orphan marker count and du -sh drop proportionally.
  • /harness-ops:audit-install-state shows no folder past the sweep window.
Ngôn ngữ chính
Shell
Star
22
Fork
2
Merge trung bình
7 giờ 8 phút
Pull request đã merge (30 ngày)
874

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của melodic-software/claude-code-plugins

Tất cả issue của melodic-software/claude-code-plugins

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.