Progress Ring 计划进度环
长计划做到哪一步，输入框上方一眼看清。
> 给订单列表加上分页
⏺ 我先看看列表组件。
◔ 60% 第 3/5 步：编写测试
Claude 正在工作 · 计划：发布 2.0
✓ 构建通过 ● 测试 ○ 文档 ○ 发布
Now: 编写测试 · ✓ 构建通过 · 3/5
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add alvaro-hi/progress-ring
/plugin install progress-ring@progress-ring
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add alvaro-hi/progress-ring
claude plugin install progress-ring@progress-ring然后在会话里执行 /reload-plugins，或开一个新会话。
请帮我安装 Claude Code Mod「Progress Ring 计划进度环」（https://github.com/alvaro-hi/progress-ring）。安装前先阅读仓库 README 的 Security 和 Requirements 部分，告诉我它会读写哪些内容、运行什么命令、是否联网，以及对 Claude Code 版本、系统和终端的要求。确认没有问题后，运行 claude plugin marketplace add alvaro-hi/progress-ring 和 claude plugin install progress-ring@progress-ring 完成安装，最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code，它会先读原作者说明再安装。
git clone https://github.com/alvaro-hi/progress-ring
cd progress-ring
claude --plugin-dir .克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明，收录时核对；可用 claude plugin validate 自行检查。
读取
有读取 ~/.claude/progress 的进度卡、会话 id 与目录、钩子事件数据，含用于统计 token 的会话记录。
写入文件
有通过本地 CLI 写入 ~/.claude/progress 的 JSON 卡片和错误日志；清除时移到 _done/。
运行命令
有运行插件目录里的 python3 bin/progress_hook.py 与 bin/progress；跳转会话时用 open 或 xdg-open。
联网
无介绍
Progress Ring 是 Álvaro del Pozo 做的 Claude Code function hooks Mod。Claude 开始三步以上的计划时会建一张进度卡，每完成一步就关闭一步。输入框上方的横条显示百分比环、当前步骤、计划名，以及 Claude 是在工作、等你还是已停滞；/progress 面板列出本会话和其他会话的所有计划、等待复核的子代理，并能跳转到所属会话；对话里还有“Now: X · ✓ 已完成 · N/M”的里程碑行。
- 进度卡存在
~/.claude/progress，由本地 Python CLI 写入；百分比只计已关闭的步骤。 - 它会向系统提示加一段使用规则，并在每次提示里加一行当前卡片状态。
- 作者说明：需 python3 3.9+，支持 macOS 或 Linux，仅注明在 Claude Code 2.1.287 上测试；界面只有西语和英语，随系统语言。
未实测，介绍据 README 与清单；预览为示意。
适合谁
- 让 Claude 做多步长计划、想随时看进度的人
- 同时开多个会话、要集中看各计划状态的人
运行要求
- Claude Code ≥ 2.1.287
- 平台 · macOS / Linux
- 需要 PATH 上有 python3 3.9 或更新版本。
- 作者只写“在 2.1.287 上测试”，未写最低版本。