claude-code-achievements 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.es.md +177 -227
  3. package/README.ja.md +177 -227
  4. package/README.ko.md +177 -227
  5. package/README.md +177 -227
  6. package/README.zh.md +177 -227
  7. package/bin/install.js +79 -61
  8. package/hooks/track-achievement.sh +2 -1
  9. package/package.json +1 -1
package/README.zh.md CHANGED
@@ -1,18 +1,24 @@
1
1
  <div align="center">
2
2
 
3
- <img src="assets/icon.png" alt="Claude Code Achievements" width="120" height="120">
3
+ <img src="assets/icon.png" alt="Claude Code Achievements" width="128" height="128">
4
4
 
5
5
  # Claude Code Achievements
6
6
 
7
- **Steam 风格的 Claude Code 成就系统**
7
+ ### 提升你的 AI 编程技能
8
8
 
9
- [![npm version](https://img.shields.io/npm/v/claude-code-achievements.svg?style=flat-square&color=CB3837)](https://www.npmjs.com/package/claude-code-achievements)
10
- [![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
11
- [![node](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen.svg?style=flat-square)](package.json)
9
+ [![npm version](https://img.shields.io/npm/v/claude-code-achievements.svg?style=for-the-badge&color=FFD700)](https://www.npmjs.com/package/claude-code-achievements)
10
+ [![downloads](https://img.shields.io/npm/dt/claude-code-achievements.svg?style=for-the-badge&color=4CAF50)](https://www.npmjs.com/package/claude-code-achievements)
11
+ [![license](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)
12
12
 
13
- 游戏化你的编程之旅，在掌握 Claude Code 功能的同时解锁成就！
13
+ ```
14
+ ╔══════════════════════════════════════════════════════════════╗
15
+ ║ 🎮 解锁成就 • 追踪进度 • 享受编程乐趣 🎮 ║
16
+ ╚══════════════════════════════════════════════════════════════╝
17
+ ```
14
18
 
15
- [安装](#安装) · [使用方法](#使用方法) · [成就列表](#成就列表) · [工作原理](#架构)
19
+ **将你的 Claude Code 体验变成 RPG 冒险！**
20
+
21
+ [快速开始](#-快速开始) · [成就](#-成就) · [命令](#-命令)
16
22
 
17
23
  **[English](README.md)** · **[Español](README.es.md)** · **[한국어](README.ko.md)** · **[日本語](README.ja.md)**
18
24
 
@@ -20,296 +26,240 @@
20
26
 
21
27
  ---
22
28
 
23
- ## 功能特性
29
+ ## ✨ 为什么要做这个？
24
30
 
25
- - **26 个成就**，分为 4 个类别
26
- - **实时通知**，通过系统提醒或终端显示
27
- - **多语言支持**（EN / 中文 / ES / 한국어 / 日本語）
28
- - **跨平台**（macOS / Linux / Windows）
29
- - **全局安装** - 在所有项目中自动生效
31
+ 学习 Claude Code 是一段旅程。这个插件将这段旅程变成**游戏**。
30
32
 
31
- ## 安装
33
+ - 🏆 **26 个成就** - 4 个技能树
34
+ - 🔔 **实时通知** - 每次升级时
35
+ - 📊 **追踪精通度** - 从新手到专家
36
+ - 🌍 **5 种语言** 支持
37
+
38
+ ---
39
+
40
+ ## 🚀 快速开始
32
41
 
33
42
  ```bash
34
43
  npx claude-code-achievements
35
44
  ```
36
45
 
37
- 交互式安装程序将会：
38
- 1. 自动检测操作系统和通知功能
39
- 2. 询问语言偏好
40
- 3. 配置通知样式（系统/终端/两者）
41
- 4. 全局安装到 `~/.claude/plugins/local/`
46
+ 就这样！开始编程，成就会自动解锁！
47
+
48
+ ---
42
49
 
43
- > **注意：** 此插件**全局安装**，自动在所有项目中生效。
50
+ ## 🏆 成就
44
51
 
45
- ### 手动安装
52
+ <table>
53
+ <tr>
54
+ <td width="25%" align="center">
46
55
 
47
- ```bash
48
- git clone https://github.com/subinium/claude-code-achievements.git
49
- cd claude-code-achievements
50
- node bin/install.js
51
- ```
56
+ ### 🌱 入门
57
+ **4 个成就**
52
58
 
53
- ## 使用方法
59
+ *第一步*
54
60
 
55
- | 命令 | 说明 |
56
- |------|------|
57
- | `/achievements` | 查看已解锁的成就（默认） |
58
- | `/achievements locked` | 查看未解锁的成就及提示 |
59
- | `/achievements all` | 按类别查看所有成就 |
60
- | `/achievements-settings` | 更改语言或通知设置 |
61
+ </td>
62
+ <td width="25%" align="center">
61
63
 
62
- ### 类别筛选
64
+ ### ⚡ 工作流
65
+ **8 个成就**
63
66
 
64
- ```bash
65
- /achievements basics # 入门
66
- /achievements workflow # 工作流程
67
- /achievements tools # 高级工具
68
- /achievements mastery # 精通
69
- ```
67
+ *更聪明地工作*
68
+
69
+ </td>
70
+ <td width="25%" align="center">
70
71
 
71
- ## 成就列表
72
-
73
- <details>
74
- <summary><b>入门</b>（4 个成就）</summary>
75
-
76
- | 成就 | 解锁方式 |
77
- |------|----------|
78
- | ✏️ **初次接触** | 编辑任意文件 |
79
- | 📝 **创造者** | 创建新文件 |
80
- | 🔍 **代码侦探** | 使用 Glob 或 Grep 搜索代码库 |
81
- | 📋 **项目策展人** | 创建 `CLAUDE.md` 设置项目上下文 |
82
-
83
- </details>
84
-
85
- <details>
86
- <summary><b>工作流程</b>（8 个成就）</summary>
87
-
88
- | 成就 | 解锁方式 |
89
- |------|----------|
90
- | 📋 **任务规划者** | 使用 TodoWrite 进行任务追踪 |
91
- | 🎯 **战略思考者** | 使用 Plan 模式（按两次 `Shift+Tab`） |
92
- | 🗣️ **沟通者** | Claude 使用 `AskUserQuestion` 澄清需求 |
93
- | 🌍 **全局策展人** | 设置 `~/.claude/CLAUDE.md` |
94
- | 📦 **版本控制者** | 使用 Claude 提交代码 |
95
- | 🚀 **发布！** | 推送到远程仓库 |
96
- | 🧪 **质量守护者** | 使用 Claude 运行测试 |
97
- | 🚦 **CI/CD 先驱** | 创建 GitHub Actions 工作流 |
98
-
99
- </details>
100
-
101
- <details>
102
- <summary><b>高级工具</b>（9 个成就）</summary>
103
-
104
- | 成就 | 解锁方式 |
105
- |------|----------|
106
- | 🎨 **视觉检查员** | 分析图片或截图 |
107
- | 📡 **文档猎人** | 获取并分析网页 |
108
- | 🤖 **委派大师** | 使用 `Task` 工具创建子代理 |
109
- | 🔌 **MCP 先驱** | 使用任意 MCP 工具 |
110
- | 🌐 **网络探索者** | 使用 `WebSearch` 工具 |
111
- | ⚙️ **定制者** | 修改 Claude Code 设置 |
112
- | 📜 **技能创造者** | 在 `.claude/skills/` 创建自定义技能 |
113
- | ⌨️ **命令工匠** | 创建自定义斜杠命令 |
114
- | 🧩 **插件探索者** | 从市场安装插件 |
115
-
116
- </details>
117
-
118
- <details>
119
- <summary><b>精通</b>（5 个成就）</summary>
120
-
121
- | 成就 | 解锁方式 |
122
- |------|----------|
123
- | 🪝 **自动化架构师** | 设置 Claude Code 钩子 |
124
- | 🔗 **MCP 连接器** | 配置 `.mcp.json` 进行集成 |
125
- | 🤖 **代理架构师** | 在 `.claude/agents/` 创建自定义代理 |
126
- | 🛡️ **安全卫士** | 配置安全权限 |
127
- | 🔄 **循环大师** | 启动自主编码循环 |
128
-
129
- </details>
72
+ ### 🔧 强力工具
73
+ **9 个成就**
74
+
75
+ *解锁能力*
76
+
77
+ </td>
78
+ <td width="25%" align="center">
79
+
80
+ ### 👑 精通
81
+ **5 个成就**
82
+
83
+ *成为传奇*
84
+
85
+ </td>
86
+ </tr>
87
+ </table>
130
88
 
131
89
  ---
132
90
 
133
- ## 架构
91
+ ### 🌱 入门
134
92
 
135
- 此插件使用 **Claude Code 的钩子系统** 实时追踪你的操作。
93
+ > *每个大师都曾是初学者*
136
94
 
137
- ```
138
- ┌─────────────────────────────────────────────────────────────┐
139
- │ CLAUDE CODE 会话 │
140
- ├─────────────────────────────────────────────────────────────┤
141
- │ │
142
- │ 你: "编辑配置文件" │
143
- │ │ │
144
- │ ▼ │
145
- │ ┌─────────────────────────────────────┐ │
146
- │ │ Claude 使用 Edit 工具 │ │
147
- │ └─────────────────────────────────────┘ │
148
- │ │ │
149
- │ ▼ │
150
- │ ┌─────────────────────────────────────┐ │
151
- │ │ PostToolUse 钩子触发 │◄── hooks.json │
152
- │ │ → track-achievement.sh │ │
153
- │ └─────────────────────────────────────┘ │
154
- │ │ │
155
- │ ┌──────────┴──────────┐ │
156
- │ ▼ ▼ │
157
- │ ┌───────────┐ ┌───────────┐ │
158
- │ │ 匹配成功 │ │ 无匹配 │ │
159
- │ │ │ │ │ │
160
- │ │ 解锁成就 │ │ 继续 │ │
161
- │ │ 发送通知 │ └───────────┘ │
162
- │ │ 保存状态 │ │
163
- │ └───────────┘ │
164
- │ │
165
- └─────────────────────────────────────────────────────────────┘
166
- ```
95
+ | | 成就 | 任务 |
96
+ |:--:|------|------|
97
+ | ✏️ | **初次接触** | 用 Claude 编辑文件 |
98
+ | 📝 | **创造者** | 创建新文件 |
99
+ | 🔍 | **代码侦探** | 用 Glob 或 Grep 搜索 |
100
+ | 📋 | **项目策展人** | 创建第一个 `CLAUDE.md` |
167
101
 
168
- ### 插件结构
102
+ ---
169
103
 
170
- ```
171
- ~/.claude/plugins/local/claude-code-achievements/
172
- ├── .claude-plugin/
173
- │ └── plugin.json # 插件元数据
174
- ├── hooks/
175
- │ ├── hooks.json # 钩子定义 (PostToolUse, Stop)
176
- │ ├── track-achievement.sh # 主追踪逻辑
177
- │ └── track-stop.sh # 会话结束处理器
178
- ├── commands/
179
- │ ├── achievements.md # /achievements 命令
180
- │ └── achievements-settings.md
181
- ├── scripts/
182
- │ ├── show-achievements.sh # 显示 UI
183
- │ └── show-notification.sh # 通知处理器
184
- └── data/
185
- ├── achievements.json # 成就定义
186
- └── i18n/
187
- ├── en.json # English
188
- ├── zh.json # 中文
189
- ├── es.json # Español
190
- ├── ko.json # 한국어
191
- └── ja.json # 日本語
192
- ```
104
+ ### ⚡ 工作流
193
105
 
194
- ### 钩子工作原理
106
+ > *效率是聪明的懒惰*
195
107
 
196
- 插件在 Claude Code 中注册两个钩子：
108
+ | | 成就 | 任务 |
109
+ |:--:|------|------|
110
+ | 📋 | **任务规划师** | 使用 TodoWrite 管理任务 |
111
+ | 🎯 | **战略思考者** | 进入计划模式 (`Shift+Tab` × 2) |
112
+ | 🗣️ | **沟通大师** | 让 Claude 提出澄清问题 |
113
+ | 🌍 | **全局策展人** | 设置 `~/.claude/CLAUDE.md` |
114
+ | 📦 | **版本控制者** | 与 Claude 一起提交 |
115
+ | 🚀 | **发布！** | 推送到远程 |
116
+ | 🧪 | **质量守护者** | 运行测试 |
117
+ | 🚦 | **CI/CD 先驱** | 创建 GitHub Actions |
197
118
 
198
- | 钩子 | 触发时机 | 目的 |
199
- |------|----------|------|
200
- | `PostToolUse` | 工具执行后 | 检查成就解锁条件 |
201
- | `Stop` | 会话结束时 | 保存会话统计 |
119
+ ---
120
+
121
+ ### 🔧 强力工具
202
122
 
203
- ### 命令工作原理
123
+ > *能力越大，生产力越高*
204
124
 
205
- 斜杠命令（`/achievements`）通过 `~/.claude/commands/` 中的**Markdown 文件**实现。
125
+ | | 成就 | 任务 |
126
+ |:--:|------|------|
127
+ | 🎨 | **视觉检查员** | 分析图像/截图 |
128
+ | 📡 | **文档猎人** | 获取并分析网页 |
129
+ | 🤖 | **委派大师** | 用 Task 生成子代理 |
130
+ | 🔌 | **MCP 先驱** | 使用 MCP 工具 |
131
+ | 🌐 | **网络探索者** | 搜索网络 |
132
+ | ⚙️ | **定制者** | 修改 Claude Code 设置 |
133
+ | 📜 | **技能创造者** | 创建自定义技能 |
134
+ | ⌨️ | **命令工匠** | 创建自定义斜杠命令 |
135
+ | 🧩 | **插件探索者** | 从市场安装插件 |
206
136
 
207
137
  ---
208
138
 
209
- ## 通知
139
+ ### 👑 精通
210
140
 
211
- 安装时会自动检测系统通知功能：
141
+ > *突破界限的少数精英*
212
142
 
213
- | 操作系统 | 方法 | 声音 |
214
- |----------|------|------|
215
- | macOS | `osascript` | Glass |
216
- | Linux | `notify-send` | 系统默认 |
217
- | Windows | PowerShell | 系统默认 |
218
- | 备用 | 终端 | 无 |
143
+ | | 成就 | 任务 |
144
+ |:--:|------|------|
145
+ | 🪝 | **自动化架构师** | 设置 Claude Code 钩子 |
146
+ | 🔗 | **MCP 连接器** | 配置 `.mcp.json` 集成 |
147
+ | 🤖 | **代理架构师** | 创建自定义代理 |
148
+ | 🛡️ | **安全卫士** | 配置安全权限 |
149
+ | 🔄 | **循环大师** | 启动自主编程循环 |
219
150
 
220
- ### 在 Linux 上安装 notify-send
151
+ ---
152
+
153
+ ## 🎮 命令
221
154
 
222
155
  ```bash
223
- # Ubuntu/Debian
224
- sudo apt install libnotify-bin
156
+ /achievements # 查看已解锁成就
157
+ /achievements locked # 查看未解锁成就 + 提示
158
+ /achievements all # 按类别查看所有成就
159
+ /achievements-settings # 配置语言和通知
160
+ ```
225
161
 
226
- # Fedora
227
- sudo dnf install libnotify
162
+ ### 类别过滤
228
163
 
229
- # Arch
230
- sudo pacman -S libnotify
164
+ ```bash
165
+ /achievements basics # 🌱 入门
166
+ /achievements workflow # ⚡ 工作流
167
+ /achievements tools # 🔧 强力工具
168
+ /achievements mastery # 👑 精通
231
169
  ```
232
170
 
233
171
  ---
234
172
 
235
- ## 配置
173
+ ## 🔔 通知
174
+
175
+ 解锁成就时立即通知！
236
176
 
237
- 设置保存在 `~/.claude/achievements/state.json`：
177
+ | 平台 | 样式 |
178
+ |------|------|
179
+ | 🍎 macOS | 原生通知 + 声音 |
180
+ | 🐧 Linux | 系统通知 |
181
+ | 🪟 Windows | Toast 通知 |
182
+ | 💻 备用 | 终端提示 |
183
+
184
+ ---
238
185
 
239
- ```json
240
- {
241
- "settings": {
242
- "language": "zh",
243
- "notifications": true,
244
- "notification_style": "system"
245
- },
246
- "achievements": {},
247
- "counters": {}
248
- }
186
+ ## 🛠️ 工作原理
187
+
188
+ ```
189
+ 你: "编辑配置文件"
190
+ │
191
+ ▼
192
+ ┌─────────────────────┐
193
+ │ Claude 使用 Edit │
194
+ └─────────────────────┘
195
+ │
196
+ ▼
197
+ ┌─────────────────────┐
198
+ │ 🎯 钩子触发 │──▶ 成就检查
199
+ └─────────────────────┘
200
+ │
201
+ ┌──────┴──────┐
202
+ ▼ ▼
203
+ ┌───────┐ ┌────────┐
204
+ │ 🏆 +1 │ │ 无 │
205
+ │ 解锁! │ │ 继续 │
206
+ └───────┘ └────────┘
249
207
  ```
250
208
 
251
- | 设置 | 值 | 说明 |
252
- |------|-----|------|
253
- | `language` | `"en"`, `"zh"`, `"es"`, `"ko"`, `"ja"` | 界面语言 |
254
- | `notifications` | `true`, `false` | 启用/禁用提醒 |
255
- | `notification_style` | `"system"`, `"terminal"`, `"both"` | 提醒方式 |
209
+ 插件连接到 Claude Code 的事件系统。每次工具使用都会被追踪。达到里程碑时，你会获得奖励！
256
210
 
257
211
  ---
258
212
 
259
- ## 故障排除
213
+ ## 🌍 支持语言
260
214
 
261
- <details>
262
- <summary><b>成就没有解锁？</b></summary>
215
+ - 🇺🇸 English
216
+ - 🇨🇳 中文
217
+ - 🇪🇸 Español
218
+ - 🇰🇷 한국어
219
+ - 🇯🇵 日本語
263
220
 
264
- ```bash
265
- # 检查插件是否已安装
266
- ls ~/.claude/plugins/local/claude-code-achievements/
221
+ 随时使用 `/achievements-settings` 更改
267
222
 
268
- # 检查状态文件是否存在
269
- cat ~/.claude/achievements/state.json
223
+ ---
270
224
 
271
- # 安装后重启 Claude Code 以加载钩子
272
- ```
225
+ ## 📂 你的进度
273
226
 
274
- </details>
227
+ 所有进度都保存在本地：
275
228
 
276
- <details>
277
- <summary><b>重置所有进度</b></summary>
229
+ ```
230
+ ~/.claude/achievements/state.json
231
+ ```
278
232
 
233
+ 重新开始你的旅程：
279
234
  ```bash
280
235
  rm ~/.claude/achievements/state.json
281
236
  ```
282
237
 
283
- </details>
238
+ ---
284
239
 
285
- <details>
286
- <summary><b>重新安装插件</b></summary>
240
+ ## 🤝 贡献
287
241
 
288
- ```bash
289
- npx claude-code-achievements@latest
290
- ```
242
+ 有新成就的想法？发现了 bug？欢迎贡献！
291
243
 
292
- </details>
244
+ - 🏆 建议新成就
245
+ - 🌍 添加翻译
246
+ - 🐛 报告问题
247
+ - ⭐ 给个 Star！
293
248
 
294
249
  ---
295
250
 
296
- ## 贡献
297
-
298
- 欢迎贡献！可以考虑：
251
+ <div align="center">
299
252
 
300
- - 新成就
301
- - 新语言翻译
302
- - UI 改进
303
- - Bug 修复
253
+ ### 准备好开始你的旅程了吗？
304
254
 
305
- ## 许可证
255
+ ```bash
256
+ npx claude-code-achievements
257
+ ```
306
258
 
307
- MIT © [subinium](https://github.com/subinium)
259
+ **升级。解锁成就。享受编程乐趣！**
308
260
 
309
261
  ---
310
262
 
311
- <div align="center">
312
-
313
- **祝编程愉快！**
263
+ MIT © [subinium](https://github.com/subinium)
314
264
 
315
265
  </div>