fix(extension): 收紧插件命令运行时契约

frontend/src/contracts/index.ts

@@ -292,10 +292,30 @@ export interface PluginCommandContext {
   selection?: string | null
 }
 
-export interface PluginCommandEffect {
-  type: 'none' | 'notification' | 'navigate' | 'refresh' | 'job'
-  payload: Record<string, unknown>
-}
+export type PluginCommandEffect =
+  | { type: 'none'; payload: Record<string, never> }
+  | {
+      type: 'notification'
+      payload: { level: 'info' | 'success' | 'warning' | 'error'; message: string }
+    }
+  | {
+      type: 'navigate'
+      payload: {
+        route:
+          | 'vault-entry'
+          | 'workspace'
+          | 'search'
+          | 'chat'
+          | 'agent'
+          | 'tasks'
+          | 'skills'
+          | 'plugins'
+          | 'themes'
+          | 'settings'
+      }
+    }
+  | { type: 'refresh'; payload: { scope: 'workspace' | 'commands' | 'settings' | 'plugins' } }
+  | { type: 'job'; payload: { job_id: string } }
 
 export interface PluginCommandResult {
   command_id: string

frontend/src/services/pluginService.spec.ts

@@ -26,7 +26,7 @@ describe('pluginService contribution adapter', () => {
       .mockResolvedValueOnce(jsonResponse({
         command_id: 'text-tools.uppercase-selection',
         status: 'completed',
-        effect: { type: 'notification', payload: { message: 'HELLO' } },
+        effect: { type: 'notification', payload: { level: 'success', message: 'HELLO' } },
       }))
 
     const commands = await pluginService.listPluginCommands('command_palette')
@@ -37,6 +37,7 @@ describe('pluginService contribution adapter', () => {
     )
 
     expect(commands[0].command_id).toBe('text-tools.uppercase-selection')
+    if (result.effect.type !== 'notification') throw new Error('expected notification effect')
     expect(result.effect.payload.message).toBe('HELLO')
     expect(fetchMock.mock.calls[0][0]).toBe(
       '/api/plugin-contributions/commands?location=command_palette',