Skip to content

Commit 68d0470

Browse files
cfrs2005claude
andcommitted
feat: 版本 1.2.5 发布 - 重要修复与文档纠正
重要修复: - setup.sh 默认安装所有 MCP 服务器,简化安装流程 - 修正 gemini-mcp-tool 包名和服务名配置 - 恢复 MCP 服务器配置到 settings.local.json 文档修正: - 移除 README.md 中虚假的命令列表 - 替换为实际存在的斜杠命令 - 明确命令使用方式和功能说明 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 45b947b commit 68d0470

3 files changed

Lines changed: 75 additions & 98 deletions

File tree

CHANGELOG.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,25 @@
55
格式基于[保持更新日志](https://keepachangelog.com/zh-CN/1.0.0/)
66
本项目遵循[语义化版本](https://semver.org/lang/zh-CN/)
77

8+
## [1.2.5] - 2025-09-13
9+
10+
### 🔧 重要修复
11+
- **setup.sh 默认配置优化** - 移除用户询问,默认安装所有 MCP 服务器
12+
- **MCP 服务器配置修正** - 使用正确的 `gemini-mcp-tool` 包名和服务名
13+
- **恢复 MCP 服务器配置生成** - setup.sh 现在正确生成 `settings.local.json` 中的 MCP 配置
14+
15+
### 📝 文档纠正
16+
- **README.md 命令列表修正** - 移除虚假的命令,替换为实际存在的斜杠命令
17+
- **命令描述准确化** - 明确说明是在 Claude Code 中使用的斜杠命令,不是终端命令
18+
19+
### 🛠️ 安装体验改进
20+
- **简化安装流程** - 不再询问用户选择,直接安装所有功能
21+
- **MCP 配置一致性** - 确保配置文件与实际包名保持一致
22+
23+
### ⚡ 技术优化
24+
- **配置生成逻辑优化** - 简化脚本逻辑,提高安装成功率
25+
- **服务器命名规范** - 统一使用正确的 MCP 扩展名称
26+
827
## [1.2.4] - 2025-09-12
928

1029
### 🔧 问题修复

README.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -153,27 +153,37 @@ cp your-sound.mp3 .claude/hooks/sounds/input.mp3
153153
- 智能选择相关上下文信息
154154
- 保持会话间状态一致性
155155

156-
### 4. 🎯 快捷指令
156+
### 4. 🎯 Claude Code 斜杠命令
157157

158-
安装后新增的 Claude Code 指令
158+
安装后可使用的内置 Claude Code 命令
159159

160160
```bash
161-
# 项目初始化
162-
claude init-chinese # 创建中文项目结构
161+
# 📊 上下文分析
162+
/full-context # 全面上下文收集和分析
163163

164-
# 文档管理
165-
claude docs-update # 更新项目文档
166-
claude context-check # 检查上下文完整性
164+
# 🔍 代码质量
165+
/code-review # 多专家角度代码审查
167166

168-
# MCP 管理
169-
claude mcp-status # 查看 MCP 服务状态
170-
claude mcp-config # 配置 MCP 服务器
167+
# 🧠 AI 咨询
168+
/gemini-consult # 与 Gemini 深入对话咨询
171169

172-
# Hook 管理
173-
claude hooks-test # 测试 Hook 脚本
174-
claude sound-test # 测试通知音效
170+
# 📝 文档管理
171+
/create-docs # 创建 AI 优化文档结构
172+
/update-docs # 保持文档与代码同步
173+
174+
# ♻️ 代码维护
175+
/refactor # 智能重构代码
176+
177+
# 🤝 会话管理
178+
/handoff # 保留上下文和任务状态
179+
180+
# 📡 MCP 工具
181+
/mcp-status # 检查 MCP 服务器状态
175182
```
176183

184+
**使用方式:** 直接在 Claude Code 中输入斜杠命令
185+
**自动功能:** 所有命令自动获得项目上下文注入
186+
177187
## 💬 使用反馈
178188

179189
### 🐛 问题反馈

setup.sh

Lines changed: 33 additions & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -15,19 +15,10 @@ NC='\033[0m'
1515

1616
# 配置变量
1717
TARGET_DIR="${INSTALLER_ORIGINAL_PWD:-$(pwd)}"
18-
INSTALL_CONTEXT7="n"
19-
INSTALL_GEMINI="n"
18+
# 默认安装所有 MCP 服务器
19+
INSTALL_CONTEXT7="y"
20+
INSTALL_GEMINI="y"
2021
INSTALL_NOTIFICATIONS="y"
21-
IS_INTERACTIVE=true
22-
23-
# 检查是否为交互式终端
24-
if [ ! -t 0 ]; then
25-
IS_INTERACTIVE=false
26-
# 非交互式模式下的默认配置
27-
INSTALL_CONTEXT7="y"
28-
INSTALL_GEMINI="y"
29-
INSTALL_NOTIFICATIONS="y"
30-
fi
3122

3223
print_color() {
3324
local color=$1
@@ -74,41 +65,10 @@ print_header() {
7465
echo
7566
}
7667

77-
# 询问可选组件
68+
# 直接开始安装,不再询问用户
7869
prompt_optional_components() {
79-
if [ "$IS_INTERACTIVE" = false ]; then
80-
print_color "$CYAN" "🤖 非交互模式:启用所有 MCP 功能"
81-
return 0
82-
fi
83-
84-
echo
85-
print_color "$YELLOW" "可选组件配置:"
86-
echo
87-
88-
# Context7 MCP
89-
print_color "$CYAN" "Context7 MCP 服务器(强烈推荐)"
90-
echo " 为外部库提供最新文档支持(React、FastAPI 等)"
91-
echo " 仓库:https://github.com/upstash/context7"
92-
if ! safe_read_yn INSTALL_CONTEXT7 " 安装 Context7 集成?(y/n): " "y"; then
93-
exit 1
94-
fi
95-
echo
96-
97-
# Gemini MCP
98-
print_color "$CYAN" "Gemini 助手 MCP 服务器(强烈推荐)"
99-
echo " 启用架构咨询和高级代码审查功能"
100-
echo " 仓库:https://github.com/jamubc/gemini-mcp-tool"
101-
if ! safe_read_yn INSTALL_GEMINI " 安装 Gemini 集成?(y/n): " "y"; then
102-
exit 1
103-
fi
104-
echo
105-
106-
# 通知系统
107-
print_color "$CYAN" "通知系统(便利功能)"
108-
echo " 任务完成或需要输入时播放音频提醒"
109-
if ! safe_read_yn INSTALL_NOTIFICATIONS " 设置通知 Hook?(y/n): " "y"; then
110-
exit 1
111-
fi
70+
print_color "$CYAN" "🚀 默认安装所有 MCP 功能和通知系统"
71+
return 0
11272
}
11373

11474
# 生成 settings.local.json 配置
@@ -260,9 +220,9 @@ EOF
260220
if [ "$INSTALL_GEMINI" = "y" ]; then
261221
[ "$first_server" = false ] && echo "," >> "$config_file"
262222
cat >> "$config_file" << 'EOF'
263-
"gemini": {
223+
"gemini-mcp-tool": {
264224
"command": "npx",
265-
"args": ["-y", "gemini-mcp", "--api-key", "YOUR_GEMINI_API_KEY"]
225+
"args": ["-y", "gemini-mcp-tool"]
266226
}
267227
EOF
268228
fi
@@ -278,37 +238,29 @@ EOF
278238

279239
# 显示 MCP 服务器信息
280240
display_mcp_info() {
281-
if [ "$INSTALL_CONTEXT7" = "y" ] || [ "$INSTALL_GEMINI" = "y" ]; then
282-
echo
283-
print_color "$BLUE" "=== MCP 服务器设置信息 ==="
284-
echo
285-
print_color "$GREEN" "✅ MCP 服务器已配置到 settings.local.json 中!"
286-
echo
287-
echo "配置的服务器:"
288-
289-
if [ "$INSTALL_CONTEXT7" = "y" ]; then
290-
print_color "$YELLOW" "📚 Context7 MCP 服务器:"
291-
echo " • 提供最新外部库文档"
292-
echo " • 支持 React、FastAPI、Next.js 等"
293-
echo " • 使用方法:mcp__context7__get_library_docs"
294-
echo
295-
fi
296-
297-
if [ "$INSTALL_GEMINI" = "y" ]; then
298-
print_color "$YELLOW" "🧠 Gemini MCP 服务器:"
299-
echo " • 深度架构咨询"
300-
echo " • 高级代码审查"
301-
echo " • 使用方法:mcp__gemini__consult_gemini"
302-
echo
303-
fi
304-
305-
print_color "$CYAN" "💡 重要配置提醒:"
306-
echo " • MCP 服务器已配置,但需要设置 API 密钥才能使用"
307-
echo " • 编辑 .claude/settings.local.json,将占位符替换为真实 API 密钥"
308-
echo " - YOUR_CONTEXT7_API_KEY → 你的 Context7 API 密钥"
309-
echo " - YOUR_GEMINI_API_KEY → 你的 Gemini API 密钥"
310-
echo " • API 密钥获取方式请参考各服务官方文档"
311-
fi
241+
echo
242+
print_color "$BLUE" "=== MCP 服务器设置信息 ==="
243+
echo
244+
print_color "$GREEN" "✅ MCP 服务器已配置到 settings.local.json 中!"
245+
echo
246+
echo "配置的服务器:"
247+
248+
print_color "$YELLOW" "📚 Context7 MCP 服务器:"
249+
echo " • 提供最新外部库文档"
250+
echo " • 支持 React、FastAPI、Next.js 等"
251+
echo " • 使用方法:mcp__context7__get_library_docs"
252+
echo
253+
254+
print_color "$YELLOW" "🧠 Gemini MCP 服务器:"
255+
echo " • 深度架构咨询"
256+
echo " • 高级代码审查"
257+
echo " • 使用方法:mcp__gemini__consult_gemini"
258+
echo
259+
260+
print_color "$CYAN" "💡 重要配置提醒:"
261+
echo " • Context7 需要 API 密钥,编辑 .claude/settings.local.json"
262+
echo " 替换 YOUR_CONTEXT7_API_KEY 为你的真实 API 密钥"
263+
echo " • Gemini MCP 不需要 API 密钥,直接使用"
312264
}
313265

314266
# 主安装流程
@@ -403,11 +355,7 @@ main() {
403355
echo " 2. 阅读 docs/README.md 学习文档系统"
404356
echo " 3. 参考 examples/ 目录中的使用示例"
405357

406-
if [ "$INSTALL_GEMINI" = "y" ]; then
407-
echo " 4. 编辑 MCP-ASSISTANT-RULES.md 设置 Gemini 编码标准"
408-
fi
409-
410-
echo " $([ "$INSTALL_GEMINI" = "y" ] && echo 5 || echo 4). 运行 'claude' 开始你的中文开发之旅!"
358+
echo " 4. 运行 'claude' 开始你的中文开发之旅!"
411359
echo
412360

413361
# MCP 服务器安装指导
@@ -418,7 +366,7 @@ main() {
418366
echo " claude mcp add context7 --scope project -- npx -y @upstash/context7-mcp --api-key YOUR_CONTEXT7_API_KEY"
419367
echo
420368
print_color "$YELLOW" "Gemini - 深度代码分析和咨询:"
421-
echo " claude mcp add gemini-cli --scope project -- npx -y gemini-mcp-tool"
369+
echo " claude mcp add gemini --scope project -- npx -y gemini-mcp-tool"
422370
echo
423371
print_color "$YELLOW" "💡 MCP 服务器让 Claude Code 功能更强大,强烈推荐安装!"
424372
}

0 commit comments

Comments
 (0)