diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3ed7f5d..8b4e9f1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.7.88] - 2026-03-19
+
+### 🐛 修复
+
+- **TS 类型错误修复**：`installer-mcp.ts` 的 `serverConfig` 参数从 `Record<string, any>` 收紧为 `McpServerConfig`，修复 `tsc --noEmit` 报错 TS2345
+
+### 🔄 变更
+
+- **发版流程加固**：`pnpm typecheck` + `pnpm test` 列为必检项，位于 `pnpm build` 之前，防止类型错误漏网
+
+---
+
 ## [1.7.87] - 2026-03-19
 
 ### 🐛 修复
diff --git a/CLAUDE.md b/CLAUDE.md
index 8258c0f..3d6311b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,7 +2,7 @@
 
 > [根目录](../CLAUDE.md) > **skills-v2**
 
-**Last Updated**: 2026-03-19 (v1.7.87)
+**Last Updated**: 2026-03-19 (v1.7.88)
 
 ---
 
@@ -10,6 +10,10 @@
 
 > 完整变更历史请查看 [CHANGELOG.md](./CHANGELOG.md)
 
+### 2026-03-19 (v1.7.88)
+- 🐛 **TS 类型错误修复**：`installer-mcp.ts` 参数类型收紧为 `McpServerConfig`，修复 `tsc --noEmit` 报错
+- 🔄 **发版流程加固**：`pnpm typecheck` + `pnpm test` 列为发版必检项
+
 ### 2026-03-19 (v1.7.87)
 - 🐛 **Gemini 失败重试**：20 个命令模板新增 Gemini 调用失败重试规则（最多 2 次，间隔 5s），3 次全败才降级单模型
 - 🐛 **Codex 结果必须等待**：20 个命令模板新增 Codex 等待规则，禁止在 Codex 未返回时跳过下一阶段
@@ -404,9 +408,15 @@ graph TD
 ### 5. 构建 + 发布 + 推送
 
 ```bash
+# 类型检查（必须在 build 之前通过）
+pnpm typecheck
+
 # 构建
 pnpm build
 
+# 测试
+pnpm test
+
 # 发布 npm 包
 npm publish
 
@@ -421,7 +431,9 @@ git push origin main
 - [ ] CHANGELOG.md 已添加新版本条目
 - [ ] README.md 已更新（命令表 + 使用说明 + 底部版本号）
 - [ ] CLAUDE.md 已更新（Last Updated + 变更记录 + 受影响章节）
+- [ ] `pnpm typecheck` 通过（tsc --noEmit，不可跳过）
 - [ ] `pnpm build` 通过
+- [ ] `pnpm test` 通过
 - [ ] `npm publish` 成功
 - [ ] `git push origin main` 成功
 
diff --git a/package.json b/package.json
index 73f3a2c..ed58f70 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.87",
+  "version": "1.7.88",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
diff --git a/src/utils/installer-mcp.ts b/src/utils/installer-mcp.ts
index a9a6cad..c95108e 100644
--- a/src/utils/installer-mcp.ts
+++ b/src/utils/installer-mcp.ts
@@ -3,7 +3,7 @@ import { homedir } from 'node:os'
 import fs from 'fs-extra'
 import { join } from 'pathe'
 import { parse as parseToml, stringify as stringifyToml } from 'smol-toml'
-import { backupClaudeCodeConfig, buildMcpServerConfig, fixWindowsMcpConfig, mergeMcpServers, readClaudeCodeConfig, writeClaudeCodeConfig } from './mcp'
+import { type McpServerConfig, backupClaudeCodeConfig, buildMcpServerConfig, fixWindowsMcpConfig, mergeMcpServers, readClaudeCodeConfig, writeClaudeCodeConfig } from './mcp'
 import { isWindows } from './platform'
 
 // ═══════════════════════════════════════════════════════
@@ -20,7 +20,7 @@ type McpInstallResult = { success: boolean, message: string, configPath?: string
  */
 async function configureMcpInClaude(
   serverId: string,
-  serverConfig: Record<string, any>,
+  serverConfig: McpServerConfig,
   label: string,
 ): Promise<McpInstallResult> {
   try {