@uwa4d/openapi-mcp 0.2.0-beta.0 → 0.2.0-beta.10

package/dist/indicator-dashboard-keys.json

@@ -0,0 +1,338 @@
+{
+    "generatedAt": "2026-08-07T02:47:15.585Z",
+    "keys": [
+        "Active_Dynamic_Bodies_Count_max",
+        "Active_Kinematic_Bodies_Count_max",
+        "AnimationClip_cnt_max",
+        "AnimationClip_mem_max_mb",
+        "AnimationUpdate_cpu_avg_ms",
+        "Animation_grpcpu_avg_ms",
+        "AnimatorInitialize_cpu_avg_ms",
+        "AnimatorInitialize_jank_rate",
+        "Animator_cnt_max",
+        "Animator_mem_max_mb",
+        "AnimatorsUpdate_cpu_avg_ms",
+        "AnimatorsWriteJob_cpu_avg_ms",
+        "Application.backgroundLoadingPriority",
+        "AssetBundle_Disk_mem_max_mb",
+        "AssetBundle_Memory_mem_max_mb",
+        "AssetBundle_cnt_max",
+        "AssetBundle_mem_max_mb",
+        "Asset_Count_max",
+        "Asset_total_cnt_max",
+        "Asset_total_mem_max_mb",
+        "AudioClip_cnt_max",
+        "AudioClip_mem_max_mb",
+        "Batch_cpu_cnt_max",
+        "Batches_Count_max",
+        "CameraImageEffects_cpu_avg_ms",
+        "CameraRender_cpu_avg_ms",
+        "CanvasBuildBatch_cpu_avg_ms",
+        "CanvasRenderSubBatch_cnt_max",
+        "CanvasRendererSyncTransform_cnt_max",
+        "CanvasSendWillRenderCanvases_cpu_avg_ms",
+        "CollectGarbageIncremental_cpu_avg_ms",
+        "Culling_cpu_avg_ms",
+        "Draw_Calls_Count_max",
+        "Dynamic_Bodies_2D_Count_max",
+        "FAsyncLoadingThread_cpu_avg_ms",
+        "FDrawSceneCommand_cpu_avg_ms",
+        "FTickFunctionTask_cpu_avg_ms",
+        "FTimerManager_cpu_avg_ms",
+        "Font_cnt_max",
+        "Font_mem_max_mb",
+        "GCCollect_jank_rate",
+        "GameThread_cpu_avg_ms",
+        "Game_Object_Count_max",
+        "GarbageCollectAssetsProfile_jank_rate",
+        "Instantiate_jank_rate",
+        "Kinematic_Bodies_2D_Count_max",
+        "LoadingReadObjectThreaded_jank_rate",
+        "LoadingReadObject_jank_rate",
+        "LoadingUpdatePreloading_cpu_avg_ms",
+        "Loading_grpcpu_avg_ms",
+        "Material_cnt_max",
+        "Material_mem_max_mb",
+        "MeshSkinningUpdate_cpu_avg_ms",
+        "Mesh_cnt_max",
+        "Mesh_mem_max_mb",
+        "Native_HeapTotal_mem_max_mb",
+        "Object_Count_max",
+        "OnDemandRendering_RenderFrameInterval_Count",
+        "Overlap_Queries_2D_Count_max",
+        "Overlaps_Count_max",
+        "ParticleSystemDraw_cnt_max",
+        "ParticleSystemUpdate_cpu_avg_ms",
+        "ParticleSystem_cnt_max",
+        "ParticleSystem_grpcpu_avg_ms",
+        "ParticleSystem_mem_max_mb",
+        "PhysicsFetchResults_cpu_avg_ms",
+        "PhysicsProcessReports_cpu_avg_ms",
+        "PhysicsProcessReports_jank_rate",
+        "PhysicsProcessing_cpu_avg_ms",
+        "PhysicsSimulate_cpu_avg_ms",
+        "Physics_grpcpu_avg_ms",
+        "RHIThread_cpu_avg_ms",
+        "RenderOpaqueGeometry_cpu_avg_ms",
+        "RenderPipelineManagerDoRenderLoop_Internal_cpu_avg_ms",
+        "RenderTexture_cnt_max",
+        "RenderTexture_mem_max_mb",
+        "RenderThread_cpu_avg_ms",
+        "RenderTransparentGeometry_cpu_avg_ms",
+        "RenderingEmitWorldScreenspaceCameraGeometry_cpu_avg_ms",
+        "Rendering_grpcpu_avg_ms",
+        "ResourcesUnloadUnusedAssets_cpu_avg_ms",
+        "STAT_AI_Overall_cpu_avg_ms",
+        "STAT_AddViewDependentWholeSceneShadowsForView_cpu_avg_ms",
+        "STAT_AnimGameThreadTime_cpu_avg_ms",
+        "STAT_AnimTickTime_cpu_avg_ms",
+        "STAT_AnimTriggerAnimNotifies_cpu_avg_ms",
+        "STAT_AnisotropyPassDrawTime_cpu_avg_ms",
+        "STAT_AssetRegistryLLM_max",
+        "STAT_AsyncLoadingLLM_max",
+        "STAT_BasePassDrawTime_cpu_avg_ms",
+        "STAT_BeginOcclusionTestsTime_cpu_avg_ms",
+        "STAT_BlendInPhysics_cpu_avg_ms",
+        "STAT_BlueprintTime_cpu_avg_ms",
+        "STAT_BuildCSMVisibilityState_cpu_avg_ms",
+        "STAT_CLMM_Occlusion_cpu_avg_ms",
+        "STAT_CLMM_Opaque_cpu_avg_ms",
+        "STAT_CLMM_Post_cpu_avg_ms",
+        "STAT_CLMM_Shadows_cpu_avg_ms",
+        "STAT_CLMM_Translucency_cpu_avg_ms",
+        "STAT_CSMStaticMeshReceivers_cnt_max",
+        "STAT_CSMSubjects_cnt_max",
+        "STAT_CacheUniformExpressions_cpu_avg_ms",
+        "STAT_CharFindFloor_cpu_avg_ms",
+        "STAT_CharHandleImpact_cpu_avg_ms",
+        "STAT_CharMoveUpdateDelegate_cpu_avg_ms",
+        "STAT_CharPhysFalling_cpu_avg_ms",
+        "STAT_CharPhysNavWalking_cpu_avg_ms",
+        "STAT_CharPhysWalking_cpu_avg_ms",
+        "STAT_CharacterMovementNonSimulated_cpu_avg_ms",
+        "STAT_CharacterMovementSimulated_cpu_avg_ms",
+        "STAT_CharacterMovementSmoothClientPosition_Interp_cpu_avg_ms",
+        "STAT_CharacterMovementSmoothClientPosition_Visual_cpu_avg_ms",
+        "STAT_CharacterMovementSmoothClientPosition_cpu_avg_ms",
+        "STAT_CharacterMovementTick_cpu_avg_ms",
+        "STAT_CharacterMovement_cpu_avg_ms",
+        "STAT_CollectGarbageInternalCall_ncall_max",
+        "STAT_CollectGarbageInternal_cpu_avg_ms",
+        "STAT_CollectGarbageInternal_cpu_max_ms",
+        "STAT_Collision_SceneQueryTotal_cpu_avg_ms",
+        "STAT_ComputeViewRelevance_cpu_avg_ms",
+        "STAT_CreateLumenRayTracingPipeline_cpu_avg_ms",
+        "STAT_CreateRayTracingPipeline_cpu_avg_ms",
+        "STAT_CreateWholeSceneProjectedShadow_cpu_avg_ms",
+        "STAT_DecalsDrawTime_cpu_avg_ms",
+        "STAT_DecompressPrecomputedOcclusion_cpu_avg_ms",
+        "STAT_DepthDrawTime_cpu_avg_ms",
+        "STAT_DestroyActor_cpu_avg_ms",
+        "STAT_DynamicEmitterCount_cnt_max",
+        "STAT_DynamicPSysCompCount_cnt_max",
+        "STAT_DynamicPSysCompCount_ncall_max",
+        "STAT_DynamicPrimitiveDrawTime_cpu_avg_ms",
+        "STAT_DynamicShadowSetupTime_cpu_avg_ms",
+        "STAT_EngineInitLLM_max",
+        "STAT_EngineMiscLLM_max",
+        "STAT_EnginePreInitLLM_max",
+        "STAT_ExplicitWaitRHIThread_cpu_avg_ms",
+        "STAT_FAsyncPackage_TickAsyncLoadingGameThread_cpu_avg_ms",
+        "STAT_FAsyncPackage_TickAsyncLoadingGameThread_cpu_max_ms",
+        "STAT_FEngineLoop_Tick_SlateInput_cpu_avg_ms",
+        "STAT_FNameLLM_max",
+        "STAT_FileSystemLLM_max",
+        "STAT_FinalizeAnimationUpdate_cpu_avg_ms",
+        "STAT_FinishRenderViewTargetTime_cpu_avg_ms",
+        "STAT_FrameSyncTime_cpu_avg_ms",
+        "STAT_GCLLM_max",
+        "STAT_GatherShadowPrimitivesTime_cpu_avg_ms",
+        "STAT_GetDynamicMeshElements_cpu_avg_ms",
+        "STAT_InitDynamicShadowsTime_cpu_avg_ms",
+        "STAT_InitProjectedShadowVisibility_cpu_avg_ms",
+        "STAT_InitViewsTime_cpu_avg_ms",
+        "STAT_InterpolateVolumetricLightmapOnCPU_cpu_avg_ms",
+        "STAT_LightingDrawTime_cpu_avg_ms",
+        "STAT_LocalizationLLM_max",
+        "STAT_MaterialsLLM_max",
+        "STAT_MeshDrawCalls_cnt_max",
+        "STAT_MeshObjectUpdate_cpu_avg_ms",
+        "STAT_Montage_Advance_cpu_avg_ms",
+        "STAT_NavWorldTickTime_cpu_avg_ms",
+        "STAT_NetReceiveRPC_cpu_avg_ms",
+        "STAT_NetWorldTickTime_cpu_avg_ms",
+        "STAT_NiagaraLLM_max",
+        "STAT_NiagaraNumSprites_cnt_max",
+        "STAT_NiagaraOverview_GT_cpu_avg_ms",
+        "STAT_NiagaraOverview_RT_cpu_avg_ms",
+        "STAT_NiagaraRenderSprites_ncall_max",
+        "STAT_OcclusionCull_cpu_avg_ms",
+        "STAT_OcclusionQueries_cnt_max",
+        "STAT_OpenGLShaderCompileTime_cpu_avg_ms",
+        "STAT_OpenGLShaderLinkTime_cpu_avg_ms",
+        "STAT_OpenGLShaderLinkTime_cpu_max_ms",
+        "STAT_ParticleDrawCalls_cnt_max",
+        "STAT_ParticlesLLM_max",
+        "STAT_ParticlesOverview_GT_cpu_avg_ms",
+        "STAT_ParticlesOverview_RT_cpu_avg_ms",
+        "STAT_PlatformTotalLLM_max",
+        "STAT_PlatformTrackedTotalLLM_max",
+        "STAT_PostAnimEvaluation_cpu_avg_ms",
+        "STAT_PresentTime_cpu_avg_ms",
+        "STAT_ProcessMouseButtonDown_cpu_avg_ms",
+        "STAT_ProcessMouseButtonUp_cpu_avg_ms",
+        "STAT_ProcessMouseMove_cpu_avg_ms",
+        "STAT_ProcessedPrimitives_cnt_max",
+        "STAT_ProgramSizeLLM_max",
+        "STAT_ProjectedShadowDrawTime_cpu_avg_ms",
+        "STAT_RHIDrawPrimitiveCalls_cnt_max",
+        "STAT_RHIMiscLLM_max",
+        "STAT_RHIThreadExecute_cpu_avg_ms",
+        "STAT_RHITriangles_cnt_max",
+        "STAT_RayTracingActiveInstances_cnt_max",
+        "STAT_RayTracingTotalInstances_cnt_max",
+        "STAT_RayTracing_FinishGatherInstances_cpu_avg_ms",
+        "STAT_ReflectiveShadowMapDrawTime_cpu_avg_ms",
+        "STAT_RefreshBoneTransforms_cpu_avg_ms",
+        "STAT_RenderQueryResultTime_cpu_avg_ms",
+        "STAT_RenderVelocities_cpu_avg_ms",
+        "STAT_ResourcesSumLLM_max",
+        "STAT_SceneDecals_cnt_max",
+        "STAT_SceneLights_cnt_max",
+        "STAT_SetupInteractionShadows_cpu_avg_ms",
+        "STAT_SetupMeshPass_cpu_avg_ms",
+        "STAT_ShadersLLM_max",
+        "STAT_Shaders_RTShaderLoadTime_cpu_avg_ms",
+        "STAT_Shaders_RTShaderLoadTime_cpu_max_ms",
+        "STAT_SkeletalMeshLLM_max",
+        "STAT_SlateApplicationInput_cpu_avg_ms",
+        "STAT_SlateDrawWindowTime_cpu_avg_ms",
+        "STAT_SlateElements_cnt_max",
+        "STAT_SlateMessageTick_cpu_avg_ms",
+        "STAT_SlateNumBatches_cnt_max",
+        "STAT_SlateNumPaintedWidgets_cnt_max",
+        "STAT_SlatePostProcessingRTTime_cpu_avg_ms",
+        "STAT_SlatePreFullBufferRTTime_cpu_avg_ms",
+        "STAT_SlatePreTickEvent_cpu_avg_ms",
+        "STAT_SlateRTDrawBatches_cpu_avg_ms",
+        "STAT_SlateRenderingRTTime_cpu_avg_ms",
+        "STAT_SlateTickTime_cpu_avg_ms",
+        "STAT_SlateTotalWidgets_cnt_max",
+        "STAT_SlateUpdateBufferRTTime_cpu_avg_ms",
+        "STAT_SlateVertexCount_cnt_max",
+        "STAT_SortStaticDrawLists_cpu_avg_ms",
+        "STAT_SpawnActorTime_cpu_avg_ms",
+        "STAT_SpawnActorTime_cpu_max_ms",
+        "STAT_StaticDrawListDrawTime_cpu_avg_ms",
+        "STAT_StaticMeshLLM_max",
+        "STAT_StaticRelevance_cpu_avg_ms",
+        "STAT_StatsLLM_max",
+        "STAT_TextureMetaDataLLM_max",
+        "STAT_ThreadStackLLM_max",
+        "STAT_TickableGameObjectsTime_cpu_avg_ms",
+        "STAT_TotalGPUFrameTime_cpu_avg_ms",
+        "STAT_TotalLLM_max",
+        "STAT_TotalPhysicsTime_cpu_avg_ms",
+        "STAT_TotalSceneRenderingTime_cpu_avg_ms",
+        "STAT_TranslucencyDrawTime_cpu_avg_ms",
+        "STAT_UILLM_max",
+        "STAT_UnitFrame_cpu_avg_ms",
+        "STAT_UnitGPU_cpu_avg_ms",
+        "STAT_UnitGame_cpu_avg_ms",
+        "STAT_UnitRHIT_cpu_avg_ms",
+        "STAT_UnitRender_cpu_avg_ms",
+        "STAT_UntaggedTotalLLM_max",
+        "STAT_UpdateAlwaysVisible_cpu_avg_ms",
+        "STAT_UpdateAnimation_cpu_avg_ms",
+        "STAT_UpdateIndirectLightingCache_cpu_avg_ms",
+        "STAT_UpdateOverlaps_cpu_avg_ms",
+        "STAT_UpdatePreshadowCache_cpu_avg_ms",
+        "STAT_UpdatePrimitiveFading_cpu_avg_ms",
+        "STAT_UpdateRBBones_cpu_avg_ms",
+        "STAT_UpdateStaticMeshesTime_cpu_avg_ms",
+        "STAT_ViewRelevance_cpu_avg_ms",
+        "STAT_ViewVisibilityTime_cpu_avg_ms",
+        "STAT_VisibleDynamicPrimitives_cnt_max",
+        "STAT_VisibleRayTracingPrimitives_cnt_max",
+        "STAT_VisibleStaticMeshElements_cnt_max",
+        "STAT_VulkanQueuePresent_cpu_avg_ms",
+        "STAT_WaterPassDrawTime_cpu_avg_ms",
+        "STAT_eglSwapBuffers_cpu_avg_ms",
+        "Scene_Object_Count_max",
+        "Screen_Resolution_Height_Count",
+        "Screen_Resolution_Width_Count",
+        "Scripting_grpcpu_avg_ms",
+        "ShaderCreateGPUProgram_jank_rate",
+        "ShaderParse_jank_rate",
+        "Shader_cnt_max",
+        "Shader_mem_max_mb",
+        "SkelMeshObjectUpdateDataCommand_cpu_avg_ms",
+        "SlateDrawWindowsCommand_cpu_avg_ms",
+        "StageEngineLateUpdate_cpu_avg_ms",
+        "Stat_ChannelReceivedRawBunchCall_ncall_max",
+        "Stat_ChannelReceivedRawBunch_ncall_max",
+        "Static_Colliders_Count_max",
+        "Static_Shapes_2D_Count_max",
+        "TextAsset_cnt_max",
+        "TextAsset_mem_max_mb",
+        "Texture_cnt_max",
+        "Texture_mem_max_mb",
+        "Triangles_Count_max",
+        "UIPanelLateUpdate_cpu_avg_ms",
+        "UIRectUpdate_cpu_avg_ms",
+        "Wasm_HeapTotal_mem_max_mb",
+        "Wwise_Reserved_mem_max_mb",
+        "android_memory_pss@max",
+        "batterylevel@mean_delta_p10000",
+        "batterypower_max",
+        "batterypower_mean",
+        "big_jank_rate",
+        "cpu_freq_x@mean",
+        "drawcall_cnt_max",
+        "fps_avg",
+        "frametime@gt_40_pct",
+        "gpu_counter_bandwidth_total_avg",
+        "gpu_counter_bandwidth_total_in_seconds_avg",
+        "gpu_counter_bus_utilization",
+        "gpu_counter_clocks",
+        "gpu_counter_cycles_per_pixel",
+        "gpu_counter_fragment",
+        "gpu_counter_fragment_shaded_avg",
+        "gpu_counter_gpu_temperature_max",
+        "gpu_counter_nobaselevel_texture_avg",
+        "gpu_counter_overdraw_avg",
+        "gpu_counter_primitive_avg",
+        "gpu_counter_read_stall_avg",
+        "gpu_counter_shader_cycles_avg",
+        "gpu_counter_shader_instructions_avg",
+        "gpu_counter_texture_cache_miss_l1_avg",
+        "gpu_target_freq_usage_120_fps_pct",
+        "gpu_target_freq_usage_30_fps_pct",
+        "gpu_target_freq_usage_45_fps_pct",
+        "gpu_target_freq_usage_60_fps_pct",
+        "gpu_time_avg_ms",
+        "ios_memory_footprint@max",
+        "jank_rate",
+        "jank_time_rate",
+        "lua_function_cnt_max",
+        "lua_mem_max_mb",
+        "lua_table_cnt_max",
+        "lua_userdata_cnt_max",
+        "monoObjectRef_cnt_max",
+        "network_in@max",
+        "network_out@max",
+        "power_max",
+        "reservedMono_mem_max_mb",
+        "reservedTotal_mem_max_mb",
+        "soc_ddr_freq",
+        "soc_gpu_freq",
+        "soc_gpu_loading",
+        "soc_gpu_utilization",
+        "temperature_max",
+        "temperature_mean",
+        "triangle_cnt_max",
+        "ui_cpu_avg_ms",
+        "usedSystem_mem_max_mb",
+        "windows_memory_workingset@max"
+    ]
+}

package/dist/presets.js

@@ -22,9 +22,18 @@ export const PRESET_DEFAULT = [
     'list_optimization_tasks',
     'gotonline_overview_indicator_statistic_dashboard',
     'gotonline_overview_indicator_curve_dashboard',
+    'gotonline_overview_indicator_dashboard_keys',
     'gotonline_overview_memory_manage_data_report',
     'gotonline_overview_method_group_statistic',
+    'gotonline_overview_stack_id_map',
     'gotonline_overview_stack_stutter_full_presign',
+    'gotonline_overview_stack_stutter_full_tree_presign',
+    'gotonline_overview_stack_stutter_scene_tree_presign',
+    'gotonline_overview_stack_tree_frame_presign',
+    // 复合工具（手写，见 src/composite/）
+    'top_resources',
+    'top_functions',
+    'report_diagnosis',
 ];
 /**
  * 每个接口对应的一组过滤键，用户在 --tool 里写任意一个即可命中。

package/dist/server-instructions.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP server instructions：客户裸问时的全局纪律（勿依赖用户粘贴规则）。
+ * 与 docs/EMPTY_STATE_CONTRACT.md 对齐。
+ */
+export declare const SERVER_INSTRUCTIONS: string;

package/dist/server-instructions.js

@@ -0,0 +1,17 @@
+/**
+ * MCP server instructions：客户裸问时的全局纪律（勿依赖用户粘贴规则）。
+ * 与 docs/EMPTY_STATE_CONTRACT.md 对齐。
+ */
+export const SERVER_INSTRUCTIONS = [
+    '你是 UWA GOT Online OpenAPI MCP 助手。用人话查报告时遵守以下纪律：',
+    '',
+    '1. 多份候选报告：先列出备注/设备/时间，再选或先问用户；禁止静默默认却假装只有一份。',
+    '2. 没有某类报告（如 GPU/Mono）：看 list 返回的 module_available；为 false 时明确说没有并停手。禁止用 Overview 的 RenderTexture / WaitForVsync 冒充 GPU 分析。',
+    '3. 说「GPU Bound / GPU 是主要瓶颈」之前：必须先查 gotonline_gpu_bound（或看 report_diagnosis.gpuBound）。空数组 [] 只能说「未检出 Bound」，不能说主要瓶颈是 GPU。',
+    '4. 卡顿根因：优先 gotonline_overview_stack_stutter_full_tree_presign / stutter_scene_tree；禁止把 WaitForVsync 直接当根因。尖峰再查单帧树。',
+    '5. 非法面板名要纠正（fps_mean→fps_avg；android_pss_max→android_memory_pss@max）；数值带单位。PSS 优先读 pss_peak_kb/mb/frame。',
+    '6. 接口失败时说明原因：运行日志 80108 — Unity 无 LG file_meta 表示未解析、无可用日志；UE 无 meta 只能说「暂不支持获取当前报告的运行日志」（方案切换过），勿断定报告本身无日志。其它失败勿把瞬时错误说成「一定没有数据」。',
+    '7. 接口限流 31004（API_RATE_LIMIT）：UWA 服务端保护，预期行为，不是 Bug。稍等重试或减少并行/批量（如 top_resources 缩小 assetTypes）。若返回含 _partialErrors 且 _rateLimitHint，部分类型限流时已有 Top 仍可用，需说明可能不完整，勿当成报告无资源。',
+    '',
+    '体检优先调用 report_diagnosis；细节再按 _apisUsed 深挖。对比多份报告时说明场景/时长/目标帧是否可比（见 comparability_note）。',
+].join('\n');

package/dist/server.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { COMPOSITE_TOOLS, selectCompositeTools } from './composite/index.js';
 import { type Engine } from './spec.js';
 import { type NameCase } from './tools.js';
 export interface ServerOptions {
@@ -16,10 +17,14 @@ export interface ServerOptions {
     timeoutMs: number;
     specPath?: string;
 }
-export declare const PACKAGE_VERSION = "0.1.0";
+/** 与 package.json 同步，避免 MCP 握手版本和 npm 包不一致。 */
+export declare const PACKAGE_VERSION: string;
 export declare function createServer(opts: ServerOptions): {
     server: McpServer;
     toolCount: number;
     total: number;
+    atomicCount: number;
+    compositeCount: number;
 };
 export declare function startStdio(opts: ServerOptions): Promise<void>;
+export { selectCompositeTools, COMPOSITE_TOOLS };

package/dist/server.js

@@ -1,10 +1,27 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { UwaClient } from './client.js';
+import { registerCompositeTools, COMPOSITE_TOOLS, selectCompositeTools } from './composite/index.js';
 import { selectOperations } from './presets.js';
 import { loadSpec } from './spec.js';
 import { makeHandler, toolConfig, toolName } from './tools.js';
-export const PACKAGE_VERSION = '0.1.0';
+import { SERVER_INSTRUCTIONS } from './server-instructions.js';
+import { scheduleUpdateNotice } from './version-check.js';
+function readPackageVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** 与 package.json 同步，避免 MCP 握手版本和 npm 包不一致。 */
+export const PACKAGE_VERSION = readPackageVersion();
 export function createServer(opts) {
     const spec = loadSpec(opts.specPath);
     const operations = selectOperations(spec.operations, { tools: opts.tools, engine: opts.engine });
@@ -13,15 +30,26 @@ export function createServer(opts) {
         credentials: { appId: opts.appId, appSecret: opts.appSecret },
         timeoutMs: opts.timeoutMs,
     });
-    const server = new McpServer({ name: 'uwa-openapi-mcp', version: PACKAGE_VERSION });
+    const server = new McpServer({ name: 'uwa-openapi-mcp', version: PACKAGE_VERSION }, { instructions: SERVER_INSTRUCTIONS });
     for (const op of operations) {
         server.registerTool(toolName(op.id, opts.nameCase, opts.namePrefix), toolConfig(op), makeHandler(op, client, opts.maxRows, opts.maxChars));
     }
-    return { server, toolCount: operations.length, total: spec.operations.length };
+    const compositeCount = registerCompositeTools(server, client, {
+        tools: opts.tools,
+        engine: opts.engine,
+        nameCase: opts.nameCase,
+        namePrefix: opts.namePrefix,
+        maxChars: opts.maxChars,
+    });
+    const toolCount = operations.length + compositeCount;
+    const total = spec.operations.length + COMPOSITE_TOOLS.length;
+    return { server, toolCount, total, atomicCount: operations.length, compositeCount };
 }
 export async function startStdio(opts) {
-    const { server, toolCount, total } = createServer(opts);
+    const { server, toolCount, total, atomicCount, compositeCount } = createServer(opts);
     // stdout 是 MCP 协议通道，任何日志都必须走 stderr
-    console.error(`[uwa-openapi-mcp] 已加载 ${toolCount}/${total} 个工具，接口地址 ${opts.baseUrl}`);
+    console.error(`[uwa-openapi-mcp] v${PACKAGE_VERSION} 已加载 ${toolCount}/${total} 个工具（原子 ${atomicCount} + 复合 ${compositeCount}），接口地址 ${opts.baseUrl}`);
+    scheduleUpdateNotice(PACKAGE_VERSION);
     await server.connect(new StdioServerTransport());
 }
+export { selectCompositeTools, COMPOSITE_TOOLS };

package/dist/tools.d.ts

@@ -28,6 +28,23 @@ export interface ToolResult {
  * 帧号范围和步长，并在点数对不上时给出警告，从结构上消除歧义。
  */
 export declare function annotateCurveAxes(data: unknown): unknown;
+/**
+ * 自定义面板 statistic/curve 返回空 `{}` 时，优先提示面板名传错（静默失败高发）。
+ */
+export declare function annotateDashboardEmptyResult(op: Operation, data: unknown, args: Record<string, unknown>): unknown;
+/** 各 GOT Online 子模块是否有报告；供模型「无 GPU 停手」。 */
+export declare function buildModuleAvailable(group: Record<string, unknown>): Record<string, boolean>;
+export declare function annotateModuleAvailable(data: unknown): unknown;
+/**
+ * 报告列表接口一次返回、按项目组分组。但上游会把同一份报告挂到每个项目组下
+ * （沙箱实测多组两两交集 100%），直接按组统计会成倍放大。
+ *
+ * 这里就地合并：按 link 里的 project= 判定真实归属，每份报告只保留在正确的组里。
+ * 不额外打接口。上游修好后检测不到重复，本函数原样返回。
+ */
+export declare function annotateProjectGroups(data: unknown): unknown;
+/** 空 Bound / 空日志列表等：补可教模型的语义，避免误判。 */
+export declare function annotateEmptyStateSemantics(op: Operation, data: unknown): unknown;
 export declare function makeHandler(op: Operation, client: UwaClient, defaultMaxRows: number, maxChars: number): (args: Record<string, unknown>) => Promise<ToolResult>;
 export declare function toolConfig(op: Operation): {
     title: string;