style(core): optimize imports and remove deprecated types

- Update imports in handlers and tools to reference context.js directly
- Remove deprecated HandlerContext alias from index.ts
- Remove ResolvedContext re-export from index.ts to prevent circular dependencies
- Update create-feature.sh template to use correct import path

Author: MikotoZero

CONTRIBUTING.md

@@ -118,6 +118,8 @@ src/
 **模块说明**：
 - **app**: 基础应用管理（开发者/应用选择、OAuth 授权、环境检查）
 - **leaderboard**: 排行榜功能（依赖 app 模块）
+- **h5Game**: H5 游戏管理
+- **vibrate**: 振动 API 文档
 - 未来: cloudSave, share 等（都可以复用 app 模块）
 
 ---
@@ -216,7 +218,7 @@ export const myTools: ToolRegistration[] = [
       description: '...',
       inputSchema: { ... }
     },
-    handler: async (args: { param: string }, context) => {
+    handler: async (args: { param: string }, context: ResolvedContext) => {
       // 实现逻辑
     }
   }
@@ -357,9 +359,11 @@ TapTap API
 |------|-------|---------|------|
 | app | 4 | ~430 行 | 应用管理基础功能 |
 | leaderboard | 7 | ~1350 行 | 排行榜（已分离 app 操作）|
-| core | 9 | ~900 行 | 共享核心代码 |
-| server.ts | 1 | ~300 行 | 主服务器 |
-| **总计** | **21** | **~2980 行** | |
+| h5Game | 5 | ~600 行 | H5 游戏管理 |
+| vibrate | 6 | ~300 行 | 振动 API 文档 |
+| core | 10 | ~1100 行 | 共享核心代码 |
+| server.ts | 1 | ~450 行 | 主服务器 |
+| **总计** | **33** | **~4230 行** | |
 
 **架构优化成果**：
 - ✅ 模块化后清理重复代码

README.md

@@ -2,7 +2,7 @@
 
 > 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5 游戏**服务器 - 提供排行榜文档和管理 API，支持 **OAuth 2.0 零配置认证**。
 
-🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **19 Tools + 7 Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
+🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **19 Tools + 11 Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
 
 ## ✨ 核心特性
 
@@ -128,7 +128,7 @@ curl http://localhost:5003/health
 #### 振动 API 文档 (1)
 - `get_vibrate_integration_guide` - 振动 API 完整文档和接入指引
 
-### 7 个 Resources
+### 11 个 Resources
 
 完整的排行榜 API 文档：
 - `docs://leaderboard/overview` - 完整概览
@@ -139,6 +139,12 @@ curl http://localhost:5003/health
 - `docs://leaderboard/api/load-player-score` - 玩家排名
 - `docs://leaderboard/api/load-centered-scores` - 周围玩家
 
+完整的振动 API 文档：
+- `docs://vibrate/overview` - 完整概览
+- `docs://vibrate/api/vibrate-short` - 短振动 API
+- `docs://vibrate/api/vibrate-long` - 长振动 API
+- `docs://vibrate/patterns` - 使用模式和最佳实践
+
 ## 🎯 使用示例
 
 ### 接入排行榜

docs/ARCHITECTURE.md

@@ -40,6 +40,20 @@ src/
 │   │   ├── handlers.ts   # 业务逻辑
 │   │   └── api.ts        # API 调用
 │   │
+│   ├── h5Game/           # H5 游戏模块
+│   │   ├── index.ts      # 模块定义
+│   │   ├── tools.ts      # 工具定义
+│   │   ├── handlers.ts   # 业务逻辑
+│   │   ├── api.ts        # API 调用
+│   │   └── messages.ts   # 消息常量
+│   │
+│   ├── vibrate/          # 振动 API 文档模块
+│   │   ├── index.ts      # 模块定义
+│   │   ├── tools.ts      # 工具定义
+│   │   ├── resources.ts  # 资源定义
+│   │   ├── docs.ts       # 文档内容
+│   │   └── docTools.ts   # 文档工具
+│   │
 │   └── 未来功能/         # cloudSave/, share/ 等
 │
 ├── core/                  # 跨模块共享代码
@@ -72,6 +86,16 @@ bin/
   - 排行榜 API 文档 Resources
   - 用户分数查询
 
+- **h5Game 模块** - H5 游戏管理
+  - H5 游戏信息收集
+  - 游戏包上传和发布
+  - 游戏创建和状态查询
+
+- **vibrate 模块** - 振动 API 文档
+  - 振动功能接入指引
+  - 完整的 API 文档 Resources
+  - 最佳实践和使用模式
+
 - **未来模块** - cloudSave（云存档）、share（分享）等
 
 #### 核心共享层（`src/core/`）
@@ -328,35 +352,42 @@ export interface ResourceRegistration {
 
 ### 实现方案
 
-服务器层是唯一处理私有参数的地方：
+服务器层是唯一处理私有参数的地方，使用 `ResolvedContext` 进行统一封装：
 
 ```typescript
 // Server 层（src/server.ts）
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-  const toolName = request.params.name;
-  const args = request.params.arguments || {};
+  const { name, arguments: args } = request.params;
 
-  // 1. 提取私有参数（从 arguments 或 HTTP Header）
-  const enrichedArgs = injectPrivateParams(args, extra);
+  // 1. 从 HTTP Headers 提取私有参数（仅 HTTP/SSE 模式）
+  let enrichedArgs = args || {};
+  if (extra?.requestInfo?.headers) {
+    enrichedArgs = extractPrivateParamsFromHeaders(enrichedArgs, extra.requestInfo.headers);
+  }
 
-  // 2. 合并到 context
-  const effectiveContext = getEffectiveContext(enrichedArgs, baseContext);
+  // 2. 构建 ResolvedContext（合并 args + baseContext）
+  // baseContext 来自 Session 闭包（userId, projectId）
+  const ctx = new ResolvedContext(enrichedArgs, baseContext);
 
   // 3. 移除私有参数，业务层不可见
   const businessArgs = stripPrivateParams(enrichedArgs);
 
-  // 4. 调用业务层
-  const result = await toolReg.handler(businessArgs, effectiveContext);
+  // 4. 调用业务层（传入 context）
+  const result = await toolReg.handler(businessArgs, ctx);
 
   return result;
 });
 ```
 
-业务层代码完全不感知私有参数：
+业务层代码完全不感知私有参数，通过 Context 访问：
 
 ```typescript
 // 业务层（features/leaderboard/handlers.ts）
-handler: async (args: { page: number }, context) => {
+handler: async (args: { page: number }, context: ResolvedContext) => {
+  // 通过 context 获取认证和应用信息
+  const token = context.resolveToken();
+  const app = context.resolveApp();
+  
   // 简洁的业务逻辑
   return api.listLeaderboards(args, context);
 }
@@ -586,10 +617,11 @@ const overview = generateOverview(documentation);
 |------|-------|---------|------|
 | **app** | 4 | ~430 行 | 应用管理基础功能 |
 | **leaderboard** | 7 | ~1350 行 | 排行榜（已分离 app 操作）|
-| **h5game** | 4 | ~600 行 | H5 游戏管理 |
+| **h5Game** | 5 | ~600 行 | H5 游戏管理 |
+| **vibrate** | 6 | ~300 行 | 振动 API 文档 |
 | **core** | 10 | ~1100 行 | 共享核心代码 |
 | **server.ts** | 1 | ~450 行 | 主服务器（支持 SSE/HTTP）|
-| **总计** | **26** | **~3930 行** | |
+| **总计** | **33** | **~4230 行** | |
 
 ### 架构优化成果
 

docs/PROXY.md

@@ -226,23 +226,6 @@ echo -n '{"kid":"abc123","mac_key":"secret","token_type":"mac","mac_algorithm":"
 }
 ```
 
-#### Server 层统一处理
-
-```typescript
-// Server 层（唯一处理私有参数的地方）
-server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-  const { arguments: args } = request.params;
-
-  // 1. 提取私有参数（从 arguments 或 HTTP Header）
-  const effectiveContext = getEffectiveContext(enrichedArgs, baseContext);
-
-  // 2. 移除私有参数
-  const businessArgs = stripPrivateParams(enrichedArgs);
-
-  // 3. 调用业务层（完全干净）
-  await toolReg.handler(businessArgs, effectiveContext);
-});
-```
 
 ### 3.7 工作流程
 

scripts/create-feature.sh

@@ -180,7 +180,7 @@ cat > "$FEATURE_DIR/index.ts" << EOF
  */
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { HandlerContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/index.js';
 
 import { ${CAMEL_CASE}ToolDefinitions, ${CAMEL_CASE}ToolHandlers } from './tools.js';
 EOF
@@ -248,7 +248,7 @@ cat > "$FEATURE_DIR/tools.ts" << EOF
  */
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { HandlerContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/context.js';
 
 import * as handlers from './handlers.js';
 import { ${CAMEL_CASE}Tools } from './docTools.js';
@@ -315,21 +315,21 @@ export const ${CAMEL_CASE}ToolDefinitions: Tool[] = [
  */
 export const ${CAMEL_CASE}ToolHandlers = [
   // get_${FEATURE_KEY}_integration_guide
-  async (args: any, context: HandlerContext) => {
+  async (args: any, context: ResolvedContext) => {
     return ${CAMEL_CASE}Tools.getIntegrationWorkflow();
   },
 
   // TODO: 添加更多 handlers
   // 示例 - save_${FEATURE_KEY}_data handler:
   /*
-  async (args: { key: string; value: string }, context: HandlerContext) => {
+  async (args: { key: string; value: string }, context: ResolvedContext) => {
     return handlers.saveData(args, context);
   },
   */
 
   // 示例 - load_${FEATURE_KEY}_data handler:
   /*
-  async (args: { key: string }, context: HandlerContext) => {
+  async (args: { key: string }, context: ResolvedContext) => {
     return handlers.loadData(args, context);
   }
   */
@@ -698,15 +698,15 @@ cat > "$FEATURE_DIR/handlers.ts" << EOF
  * $FEATURE_NAME Handlers
  */
 
-import type { HandlerContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/index.js';
 import * as api from './api.js';
 
 // TODO: 实现业务逻辑处理器
 // 示例:
 /*
 export async function saveData(
   args: { key: string; value: string },
-  context: HandlerContext
+  context: ResolvedContext
 ): Promise<string> {
   const { key, value } = args;
 
@@ -720,7 +720,7 @@ Value: \${value}\`;
 
 export async function loadData(
   args: { key: string },
-  context: HandlerContext
+  context: ResolvedContext
 ): Promise<string> {
   const { key } = args;
 
@@ -745,7 +745,7 @@ cat > "$FEATURE_DIR/api.ts" << EOF
 
 import { HttpClient } from '../../core/network/httpClient.js';
 import { ensureAppInfo } from '../app/api.js';  // 导入应用信息函数
-import type { HandlerContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/context.js';
 
 // TODO: 定义接口
 // 示例:
@@ -777,11 +777,12 @@ export interface LoadDataResponse {
 /*
 export async function saveDataToCloud(
   args: { key: string; value: string },
-  context: HandlerContext
+  context: ResolvedContext
 ): Promise<SaveDataResponse> {
   const client = new HttpClient();
 
   // 获取应用信息（developer_id, app_id 等）
+  // 注意：ensureAppInfo 现在接受 projectPath 字符串，从 context.projectPath 获取
   const appInfo = await ensureAppInfo(context.projectPath);
 
   const response = await client.post<SaveDataResponse>(
@@ -801,7 +802,7 @@ export async function saveDataToCloud(
 
 export async function loadDataFromCloud(
   args: { key: string },
-  context: HandlerContext
+  context: ResolvedContext
 ): Promise<string> {
   const client = new HttpClient();
 

src/core/types/index.ts

@@ -31,10 +31,7 @@ export type {
   SessionContext,
   TokenSource
 } from './context.js';
-export { ResolvedContext, getTokenSourceLabel } from './context.js';
-
-// 向后兼容别名（将逐步废弃）
-export type { RequestContext as HandlerContext } from './context.js';
+export { getTokenSourceLabel } from './context.js';
 
 // 前向声明
 import type { ResolvedContext as RC } from './context.js';

src/features/app/handlers.ts

@@ -3,7 +3,7 @@
  * Handles developer and app selection operations
  */
 
-import type { ResolvedContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/context.js';
 import { getAllDevelopersAndApps, selectApp as selectAppApi } from './api.js';
 import { clearAppCache } from '../../core/utils/cache.js';
 import { clearToken, saveToken } from '../../core/auth/tokenStorage.js';

src/features/app/tools.ts

@@ -3,7 +3,7 @@
  * Unified definitions and handlers for app operations
  */
 
-import type { ToolRegistration, HandlerContext } from '../../core/types/index.js';
+import type { ToolRegistration } from '../../core/types/index.js';
 import * as appHandlers from './handlers.js';
 import * as appApi from './api.js';
 

src/features/h5Game/handlers.ts

@@ -23,7 +23,7 @@ import { readAppCache, saveAppCache, type AppCacheInfo } from '../../core/utils/
 import { logger } from '../../core/utils/logger.js';
 import { resolveWorkPath } from '../../core/utils/pathResolver.js';
 import { EnvConfig } from '../../core/utils/env.js';
-import type { ResolvedContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/context.js';
 
 /**
  * 临时文件根目录（独立于 workspace）

src/features/leaderboard/handlers.ts

@@ -3,7 +3,7 @@
  * Handles leaderboard operations including creation, listing, and workflow guidance
  */
 
-import type { ResolvedContext } from '../../core/types/index.js';
+import type { ResolvedContext } from '../../core/types/context.js';
 import {
   createLeaderboard as createLeaderboardApi,
   listLeaderboards as listLeaderboardsApi,