SDK -> 事件 -> 处理器索引
本页整理 packages/utils/transport/sdk/domains/* 与主进程处理器的映射，并补充内部/私有 transport 的非 SDK 通道。
SDK -> 事件 -> 处理器索引
本页整理 packages/utils/transport/sdk/domains/* 与主进程处理器的映射，并补充内部/私有 transport 的非 SDK 通道。
B1. App SDK（packages/utils/transport/sdk/domains/app.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
close() | app:window:close | CommonChannel.registerTransportHandlers -> closeApp |
hide() | app:window:hide | CommonChannel.registerTransportHandlers -> touchApp.window.window.hide |
minimize() | app:window:minimize | CommonChannel.registerTransportHandlers -> touchApp.window.minimize |
focus() | app:window:focus | CommonChannel.registerTransportHandlers -> touchApp.window.window.focus |
openDevTools() | app:debug:open-devtools | CommonChannel.registerTransportHandlers -> touchApp.window.openDevTools |
getCwd() | app:system:get-cwd | CommonChannel.registerTransportHandlers -> process.cwd() |
getOS() | app:system:get-os | CommonChannel.registerTransportHandlers -> getOSInformation |
getPackage() | app:system:get-package | CommonChannel.registerTransportHandlers -> packageJson |
getPath(name) | app:system:get-path | CommonChannel.registerTransportHandlers -> electronApp.getPath |
openExternal(url) | app:system:open-external | CommonChannel.registerTransportHandlers -> shell.openExternal |
showInFolder(path) | app:system:show-in-folder | CommonChannel.registerTransportHandlers -> shell.showItemInFolder |
openApp(options) | app:system:open-app | CommonChannel.registerTransportHandlers -> shell.openPath/openApp |
executeCommand(options) | app:system:execute-command | CommonChannel.registerTransportHandlers -> exec |
readFile(path) | app:system:read-file | CommonChannel.registerTransportHandlers -> readFile |
B2. Platform SDK（packages/utils/transport/sdk/domains/platform.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
listCapabilities() | platform:capabilities:list | CommonChannel.registerTransportHandlers -> platformCapabilityRegistry.list |
B3. Download SDK（packages/utils/transport/sdk/domains/download.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
addTask() | download:task:add | DownloadCenter.registerTransportHandlers -> addTask |
pauseTask() | download:task:pause | DownloadCenter.registerTransportHandlers -> pauseTask |
resumeTask() | download:task:resume | DownloadCenter.registerTransportHandlers -> resumeTask |
cancelTask() | download:task:cancel | DownloadCenter.registerTransportHandlers -> cancelTask |
retryTask() | download:task:retry | DownloadCenter.registerTransportHandlers -> retryTask |
removeTask() | download:task:remove | DownloadCenter.registerTransportHandlers -> removeTask |
updatePriority() | download:task:update-priority | DownloadCenter.registerTransportHandlers -> updateTaskPriority |
pauseAll() | download:task:pause-all | DownloadCenter.registerTransportHandlers -> pauseAllTasks |
resumeAll() | download:task:resume-all | DownloadCenter.registerTransportHandlers -> resumeAllTasks |
cancelAll() | download:task:cancel-all | DownloadCenter.registerTransportHandlers -> cancelAllTasks |
getAllTasks() | download:list:get | DownloadCenter.registerTransportHandlers -> getAllTasks |
getTasksByStatus() | download:list:get-by-status | DownloadCenter.registerTransportHandlers -> getTasksByStatus |
getTaskStatus() | download:task:get-status | DownloadCenter.registerTransportHandlers -> getTaskStatus |
getConfig() | download:config:get | DownloadCenter.registerTransportHandlers -> getConfig |
updateConfig() | download:config:update | DownloadCenter.registerTransportHandlers -> updateConfig |
getNotificationConfig() | download:config:get-notification | DownloadCenter.registerTransportHandlers -> getNotificationConfig |
updateNotificationConfig() | download:config:update-notification | DownloadCenter.registerTransportHandlers -> updateNotificationConfig |
getHistory() | download:history:get | DownloadCenter.registerTransportHandlers -> getTaskHistory |
clearHistory() | download:history:clear | DownloadCenter.registerTransportHandlers -> clearHistory |
clearHistoryItem() | download:history:clear-item | DownloadCenter.registerTransportHandlers -> clearHistoryItem |
openFile() | download:file:open | DownloadCenter.registerTransportHandlers -> openFile |
showInFolder() | download:file:show-in-folder | DownloadCenter.registerTransportHandlers -> showInFolder |
deleteFile() | download:file:delete | DownloadCenter.registerTransportHandlers -> deleteFile |
cleanupTemp() | download:maintenance:cleanup-temp | DownloadCenter.registerTransportHandlers -> cleanupTempFiles |
getTempStats() | download:temp:get-stats | DownloadCenter.registerTransportHandlers -> getTempStats |
getLogs() | download:logs:get | DownloadCenter.registerTransportHandlers -> getLogs |
getErrorStats() | download:logs:get-error-stats | DownloadCenter.registerTransportHandlers -> getErrorStats |
clearLogs() | download:logs:clear | DownloadCenter.registerTransportHandlers -> clearLogs |
getStats() | download:stats:get | DownloadCenter.registerTransportHandlers -> getStats |
checkMigrationNeeded() | download:migration:check-needed | DownloadCenter.registerTransportHandlers -> checkMigrationNeeded |
startMigration() | download:migration:start | DownloadCenter.registerTransportHandlers -> startMigration |
retryMigration() | download:migration:retry | DownloadCenter.registerTransportHandlers -> retryMigration |
getMigrationStatus() | download:migration:status | DownloadCenter.registerTransportHandlers -> getMigrationStatus |
onTaskAdded() | download:push:task-added | DownloadCenter.broadcastTaskAdded |
onTaskProgress() | download:push:task-progress | DownloadCenter.broadcastTaskProgress |
onTaskCompleted() | download:push:task-completed | DownloadCenter.broadcastTaskCompleted |
onTaskFailed() | download:push:task-failed | DownloadCenter.broadcastTaskFailed |
onTaskUpdated() | download:push:task-updated | DownloadCenter.broadcastTaskUpdated |
onTaskRetrying() | download:push:task-retrying | DownloadCenter.startDownloadTask (retryStrategy callback) |
onNotificationClicked() | download:push:notification-clicked | DownloadCenter.handleNotificationClick |
B4. Notification SDK（packages/utils/transport/sdk/domains/notification.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
notify() | notification:api:notify | NotificationModule.registerTransportHandlers -> handleNotify |
update() | notification:api:update | NotificationModule.registerTransportHandlers -> handleUpdate |
dismiss() | notification:api:dismiss | NotificationModule.registerTransportHandlers -> handleDismiss |
reportAction() | notification:api:action | NotificationModule.registerTransportHandlers -> handleAction |
listInbox() | notification:inbox:list | NotificationModule.registerTransportHandlers -> inbox.list |
markRead() | notification:inbox:mark-read | NotificationModule.registerTransportHandlers -> handleInboxMarkRead |
archive() | notification:inbox:archive | NotificationModule.registerTransportHandlers -> handleInboxArchive |
delete() | notification:inbox:delete | NotificationModule.registerTransportHandlers -> inbox.delete |
clear() | notification:inbox:clear | NotificationModule.registerTransportHandlers -> inbox.clear |
onNotify() | notification:push:notify | NotificationModule.handleNotify -> transport.broadcast |
onUpdate() | notification:push:update | NotificationModule.handleUpdate -> transport.broadcast |
onDismiss() | notification:push:dismiss | NotificationModule.handleDismiss -> transport.broadcast |
onAction() | notification:push:action | NotificationModule.handleAction -> transport.broadcast |
onInboxUpdated() | notification:push:inbox-updated | NotificationModule.handleInbox* -> transport.broadcast |
B5. Store SDK（packages/utils/transport/sdk/domains/store.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
checkUpdates() | store:check-updates | PluginModule.start -> triggerUpdateCheck |
search() | store:search | PluginModule.start -> searchMarket |
getPlugin() | store:get-plugin | PluginModule.start -> getMarketPlugin |
httpRequest() | store:http-request | PluginModule.start -> performMarketHttpRequest |
featured() | store:featured | PluginModule.start -> featured |
npmList() | store:npm-list | PluginModule.start -> npmList |
onUpdatesAvailable() | store:updates-available | startUpdateScheduler.onUpdatesFound -> transport.broadcast |
B6. Plugin SDK（packages/utils/transport/sdk/domains/plugin.ts）
| SDK 方法 | 事件名 | 主处理器（函数级） |
|---|---|---|
list() | plugin:api:list | PluginModule.start -> manager.plugins list |
get() | plugin:api:get | PluginModule.start -> manager.plugins.get |
getStatus() | plugin:api:get-status | PluginModule.start -> plugin.status |
enable() | plugin:api:enable | PluginModule.start -> manager.enablePlugin |
disable() | plugin:api:disable | PluginModule.start -> manager.disablePlugin |
reload() | plugin:api:reload | PluginModule.start -> manager.reloadPlugin |
install() | plugin:api:install | PluginModule.start -> pluginInstaller.install |
uninstall() | plugin:api:uninstall | PluginModule.start -> manager.uninstallPlugin |
triggerFeature() | plugin:api:trigger-feature | PluginModule.start -> manager.triggerFeature |
registerWidget() | plugin:api:register-widget | PluginModule.start -> widgetManager.registerWidget |
featureInputChanged() | plugin:api:feature-input-changed | PluginModule.start -> manager.featureInputChanged |
openFolder() | plugin:api:open-folder | PluginModule.start -> shell.openPath |
getOfficialList() | plugin:api:get-official-list | PluginModule.start -> getOfficialList |
getManifest() | plugin:api:get-manifest | PluginModule.start -> readManifest |
saveManifest() | plugin:api:save-manifest | PluginModule.start -> saveManifest |
saveWidgetFile() | plugin:api:save-widget-file | PluginModule.start -> saveWidgetFile |
getPaths() | plugin:api:get-paths | PluginModule.start -> resolvePluginPaths |
openPath() | plugin:api:open-path | PluginModule.start -> shell.openPath |
revealPath() | plugin:api:reveal-path | PluginModule.start -> shell.showItemInFolder |
getPerformance() | plugin:api:get-performance | PluginModule.start -> plugin.getPerformanceMetrics |
getRuntimeStats() | plugin:api:get-runtime-stats | PluginModule.start -> plugin.getRuntimeStats |
reconnectDevServer() | plugin:reconnect-dev-server | PluginModule.start -> healthMonitor.reconnectDevServer |
getDevServerStatus() | plugin:dev-server-status | PluginModule.start -> healthMonitor.getStatus |
onStateChanged() | plugin:state-changed | createPluginManager -> transport.broadcast |
onStatusUpdated() | plugin-status-updated | TouchPlugin.status setter -> transport.broadcast |
onInstallProgress() | plugin:install-progress | PluginInstallQueue.emitProgress |
onInstallConfirm() | plugin:install-confirm | PluginInstallQueue.requestConfirmation |
sendInstallConfirmResponse() | plugin:install-confirm-response | PluginModule.start -> installQueue.handleConfirmResponse |
installFromSource() | plugin:install-source | PluginModule.start -> installQueue.enqueue |
C. 内部/私有 Transport（非 SDK）
说明：这些事件通常由渲染进程或插件进程直接调用，不经过 SDK 封装。
C1. CoreBox 内部 raw 事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
core-box:trigger | CoreBoxWindowManager.show/hide -> channel.broadcastTo（apps/core-app/src/main/modules/box-tool/core-box/window.ts） | useVisibility -> transport.on（apps/core-app/src/renderer/src/modules/box/adapter/hooks/useVisibility.ts） |
core-box:ui-resume | CoreBoxWindowManager.attachUIView -> sendToPlugin（apps/core-app/src/main/modules/box-tool/core-box/window.ts） | 插件进程 UI View（非仓库代码） |
core-box:hide-input | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> setInputVisibility(false)（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:show-input | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> setInputVisibility(true)（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:allow-input | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> windowManager.enableInputMonitoring（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:set-height | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> windowManager.setHeight（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:get-bounds | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> window.getBounds（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:set-position-offset | 调用方：插件/渲染器（raw event） | IpcManager.registerTransportHandlers -> windowManager.setPositionOffset（apps/core-app/src/main/modules/box-tool/core-box/ipc.ts） |
core-box:get-recommendations | 调用方：渲染器/后台 | SearchEngineCore.init -> recommendationEngine.recommend（apps/core-app/src/main/modules/box-tool/search-engine/search-core.ts） |
core-box:aggregate-time-stats | 调用方：渲染器/后台 | SearchEngineCore.init -> timeStatsAggregator.aggregateTimeStats（apps/core-app/src/main/modules/box-tool/search-engine/search-core.ts） |
core-box:is-pinned | 调用方：渲染器 | SearchEngineCore.init -> dbUtils.isPinned（apps/core-app/src/main/modules/box-tool/search-engine/search-core.ts） |
core-box:clipboard-change | ClipboardModule.checkClipboard -> sendToPlugin（apps/core-app/src/main/modules/clipboard.ts） | 插件进程 UI View（非仓库代码） |
core-box:clipboard-meta-updated | OcrService.broadcastMetaUpdate -> sendToPlugin（apps/core-app/src/main/modules/ocr/ocr-service.ts） | 插件进程 UI View（非仓库代码） |
C2. Plugin 进程 raw 事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
window:new | 插件进程（Prelude） | PluginModule.start -> transport.on(defineRawEvent('window:new'))（apps/core-app/src/main/modules/plugin/plugin-module.ts） |
window:visible | 插件进程（Prelude） | PluginModule.start -> transport.on(defineRawEvent('window:visible'))（apps/core-app/src/main/modules/plugin/plugin-module.ts） |
C3. CommonChannel 兼容/遗留事件（App/System）
C3.1 App/System
| 事件名 | 发送端 | 处理端 |
|---|---|---|
close | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> closeApp（apps/core-app/src/main/channel/common.ts） |
hide | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> touchApp.window.window.hide（apps/core-app/src/main/channel/common.ts） |
minimize | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> touchApp.window.minimize（apps/core-app/src/main/channel/common.ts） |
dev-tools | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> touchApp.window.openDevTools（apps/core-app/src/main/channel/common.ts） |
get-package | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> packageJson（apps/core-app/src/main/channel/common.ts） |
open-external | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> shell.openExternal（apps/core-app/src/main/channel/common.ts） |
get-os | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> getOSInformation（apps/core-app/src/main/channel/common.ts） |
common:cwd | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> process.cwd()（apps/core-app/src/main/channel/common.ts） |
common:get-path | 调用方：渲染器/插件（raw event） | CommonChannel.registerTransportHandlers -> touchApp.app.getPath（apps/core-app/src/main/channel/common.ts） |
folder:open | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> shell.showItemInFolder（apps/core-app/src/main/channel/common.ts） |
app:open-prompts-folder | 渲染器（apps/core-app/src/renderer/src/components/intelligence/IntelligencePrompts.vue） | CommonChannel.registerTransportHandlers -> shell.showItemInFolder/shell.openPath（apps/core-app/src/main/channel/common.ts） |
module:folder | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> shell.openPath（apps/core-app/src/main/channel/common.ts） |
execute:cmd | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> shell.openPath（apps/core-app/src/main/channel/common.ts） |
app:open | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> shell.openPath（apps/core-app/src/main/channel/common.ts） |
url:open | 渲染器（apps/core-app/src/renderer/src/modules/hooks/application-hooks.ts） | CommonChannel.registerTransportHandlers -> onOpenUrl（apps/core-app/src/main/channel/common.ts） |
files:index-progress | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> fileProvider.getIndexingProgress（apps/core-app/src/main/channel/common.ts） |
app:system:get-active-app | 调用方：插件 SDK typed transport（packages/utils/plugin/sdk/system.ts） | CommonChannel.registerTransportHandlers -> activeAppService.getActiveApp（apps/core-app/src/main/channel/common.ts） |
system:get-storage-usage | 渲染器（apps/core-app/src/renderer/src/views/storage/Storagable.vue） | CommonChannel.registerTransportHandlers -> getStorageUsageReport（apps/core-app/src/main/channel/common.ts） |
build:get-verification-status | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> resolveBuildVerificationStatus（apps/core-app/src/main/channel/common.ts） |
C3.2 Temp File / Storage Cleanup
| 事件名 | 发送端 | 处理端 |
|---|---|---|
temp-file:create | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> tempFileService.createFile（apps/core-app/src/main/channel/common.ts） |
temp-file:delete | 渲染器（legacy touch-sdk：packages/utils/renderer/touch-sdk/index.ts） | CommonChannel.registerTransportHandlers -> tempFileService.deleteFile（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:clipboard | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupClipboard（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:file-index | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupFileIndex（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:logs | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupLogs（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:temp | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupTemp（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:analytics | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupAnalytics（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:usage | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupUsage（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:ocr | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupOcr（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:downloads | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupDownloads（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:intelligence | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupIntelligence（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:config | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupConfig（apps/core-app/src/main/channel/common.ts） |
storage:cleanup:updates | 调用方：渲染器（raw event） | CommonChannel.registerTransportHandlers -> cleanupUpdates（apps/core-app/src/main/channel/common.ts） |
C4. Storage 兼容/遗留事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
storage:get | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> getConfig（apps/core-app/src/main/modules/storage/index.ts） |
storage:get-versioned | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> getConfigWithVersion（apps/core-app/src/main/modules/storage/index.ts） |
storage:save | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> saveConfig（apps/core-app/src/main/modules/storage/index.ts） |
storage:reload | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> reloadConfig + broadcastUpdate（apps/core-app/src/main/modules/storage/index.ts） |
storage:saveall | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> StoragePollingService.forceSave（apps/core-app/src/main/modules/storage/index.ts） |
storage:save-sync | 调用方：渲染器（legacy raw event） | StorageModule.registerTransportHandlers -> saveConfig + sync write（apps/core-app/src/main/modules/storage/index.ts） |
storage:update | StorageModule.broadcastUpdate -> transport.broadcastToWindow（apps/core-app/src/main/modules/storage/index.ts） | 渲染器（storage 订阅者） |
C5. Clipboard 兼容/遗留事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
clipboard:get-history | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> history query（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:set-favorite | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> setFavorite（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:delete-item | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> delete item（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:clear-history | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> clear history（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:apply-to-active-app | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> applyToActiveApp（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:write-text | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> writePayload(text)（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:write | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> writePayload（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:read | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> clipboard.read*（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:read-image | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> clipboard.readImage（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:read-files | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> clipboardHelper.readClipboardFiles（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:clear | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> clipboard.clear()（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:copy-and-paste | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> applyToActiveApp（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:query | 调用方：渲染器（legacy raw event） | ClipboardModule.registerTransportHandlers -> queryHistoryByMeta（apps/core-app/src/main/modules/clipboard.ts） |
clipboard:new-item | ClipboardModule.checkClipboard -> transport.sendTo（apps/core-app/src/main/modules/clipboard.ts） | 渲染器（clipboard 订阅者） |
C6. BoxItem SDK 内部通道（CoreBox Item）
| 事件名 | 发送端 | 处理端 |
|---|---|---|
box-item:create | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> create（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:update | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> update（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:upsert | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> upsert（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:delete | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> delete（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:batch-upsert | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> batchUpsert（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:batch-delete | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> batchDelete（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:clear | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> clear（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:sync | 渲染器（BoxItem SDK） | BoxItemManager.registerTransportHandlers -> handleSyncRequest（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） |
box-item:sync-response | BoxItemManager.handleSyncRequest -> emitToRenderer（apps/core-app/src/main/modules/box-tool/item-sdk/box-item-manager.ts） | 渲染器（BoxItem SDK） |
C7. Shortcut（shortcon）内部事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
shortcon:update | 渲染器（apps/core-app/src/renderer/src/modules/channel/main/shortcon.ts） | ShortcutModule.setupIpcListeners -> updateShortcut（apps/core-app/src/main/modules/global-shortcon.ts） |
shortcon:disable-all | 渲染器（apps/core-app/src/renderer/src/modules/channel/main/shortcon.ts） | ShortcutModule.setupIpcListeners -> disableAll（apps/core-app/src/main/modules/global-shortcon.ts） |
shortcon:enable-all | 渲染器（apps/core-app/src/renderer/src/modules/channel/main/shortcon.ts） | ShortcutModule.setupIpcListeners -> enableAll（apps/core-app/src/main/modules/global-shortcon.ts） |
shortcon:get-all | 渲染器（apps/core-app/src/renderer/src/modules/channel/main/shortcon.ts） | ShortcutModule.setupIpcListeners -> buildShortcutSnapshot（apps/core-app/src/main/modules/global-shortcon.ts） |
shortcon:reg | 插件进程（Prelude） | ShortcutModule.setupIpcListeners -> registerRendererShortcut（apps/core-app/src/main/modules/global-shortcon.ts） |
shortcon:trigger | ShortcutModule.handleTrigger -> transport.sendToPlugin/sendToWindow（apps/core-app/src/main/modules/global-shortcon.ts） | 渲染器/插件（快捷键订阅方） |
C8. Intelligence / Agents SDK 事件
C8.1 Intelligence
| 事件名 | 发送端 | 处理端 |
|---|---|---|
intelligence:api:invoke | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.invoke（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:chat-langchain | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.invoke('text.chat')（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:test-provider | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.testProvider（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-capability-test-meta | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> capabilityTesterRegistry.get（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:test-capability | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> tester.generateTestPayload + ai.invoke（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:fetch-models | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> fetchProviderModels（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-audit-logs | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.queryAuditLogs（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-today-stats | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.getTodayStats（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-month-stats | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.getMonthStats（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-usage-stats | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> ai.getUsageStats（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-quota | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.getQuota（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:set-quota | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.setQuota（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:delete-quota | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.deleteQuota（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-all-quotas | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.getAllQuotas（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:check-quota | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.checkQuota（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:get-current-usage | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> intelligenceQuotaManager.getCurrentUsage（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
intelligence:api:reload-config | 调用方：渲染器/插件（Intelligence SDK typed event） | IntelligenceModule.onInit -> reloadConfig（apps/core-app/src/main/modules/ai/intelligence-module.ts） |
C8.2 Agents
| 事件名 | 发送端 | 处理端 |
|---|---|---|
agents:update-priority | 渲染器（raw event） | registerAgentChannels -> agentManager.updateTaskPriority（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） |
agents:task-started | agentManager.on('task:started') -> transport.broadcast（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） | 渲染器（Agent 状态订阅者） |
agents:task-progress | agentManager.on('task:progress') -> transport.broadcast（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） | 渲染器（Agent 状态订阅者） |
agents:task-completed | agentManager.on('task:completed') -> transport.broadcast（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） | 渲染器（Agent 状态订阅者） |
agents:task-failed | agentManager.on('task:failed') -> transport.broadcast（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） | 渲染器（Agent 状态订阅者） |
agents:task-cancelled | agentManager.on('task:cancelled') -> transport.broadcast（apps/core-app/src/main/modules/ai/agents/agent-channels.ts） | 渲染器（Agent 状态订阅者） |
C9. Analytics 事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
AppEvents.analytics.getSummary | 渲染器（apps/core-app/src/renderer/src/views/base/settings/SettingAbout.vue） | AnalyticsModule.registerTransportHandlers -> startupAnalytics.getPerformanceSummary（apps/core-app/src/main/modules/analytics/analytics-module.ts） |
AppEvents.analytics.export | 渲染器（apps/core-app/src/renderer/src/views/base/settings/SettingAbout.vue） | AnalyticsModule.registerTransportHandlers -> startupAnalytics.exportMetrics（apps/core-app/src/main/modules/analytics/analytics-module.ts） |
C10. AddonOpener / Drop raw 事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
auth:external-callback | AddonOpenerModule.schemaHandlers -> transport.sendTo（apps/core-app/src/main/modules/addon-opener.ts） | 渲染器（授权回调接收方） |
@open-plugin | AddonOpenerModule.open-file -> transport.sendTo（apps/core-app/src/main/modules/addon-opener.ts） | 渲染器（apps/core-app/src/renderer/src/modules/hooks/dropper-resolver.ts） |
@install-plugin | 渲染器（apps/core-app/src/renderer/src/components/plugin/action/mention/PluginApplyInstall.vue） | AddonOpenerModule.on(installPluginEvent) -> PluginResolver（apps/core-app/src/main/modules/addon-opener.ts） |
drop:plugin | 渲染器（apps/core-app/src/renderer/src/modules/hooks/dropper-resolver.ts） | AddonOpenerModule.on(dropPluginEvent) -> PluginResolver（apps/core-app/src/main/modules/addon-opener.ts） |
drop | 渲染器（raw event） | DropManager.init -> transport.sendToPlugin（apps/core-app/src/main/modules/drop-manager.ts） |
C11. 文件 Provider raw 事件
| 事件名 | 发送端 | 处理端 |
|---|---|---|
everything:status | 渲染器（Everything 设置页） | EverythingProvider.registerChannels -> status（apps/core-app/src/main/modules/box-tool/addon/files/everything-provider.ts） |
everything:toggle | 渲染器（Everything 设置页） | EverythingProvider.registerChannels -> toggle（apps/core-app/src/main/modules/box-tool/addon/files/everything-provider.ts） |
everything:test | 渲染器（Everything 设置页） | EverythingProvider.registerChannels -> test（apps/core-app/src/main/modules/box-tool/addon/files/everything-provider.ts） |
openers:resolve | 渲染器（apps/core-app/src/renderer/src/modules/openers/index.ts） | FileProvider.registerOpenersChannel -> getOpenerForExtension（apps/core-app/src/main/modules/box-tool/addon/files/file-provider.ts） |
file-index:failed | FileProvider.notifyIndexingFailure -> transport.broadcast（apps/core-app/src/main/modules/box-tool/addon/files/file-provider.ts） | 渲染器（索引状态订阅者） |
C12. 系统服务 raw 事件（Permission/Terminal/Logs/Dashboard）
C12.1 Permission
| 事件名 | 发送端 | 处理端 |
|---|---|---|
system:permission:check | 渲染器（apps/core-app/src/renderer/src/views/base/begin/internal/SetupPermissions.vue） | PermissionChecker.setupChannels -> checker.checkAccessibility/checkNotifications/...（apps/core-app/src/main/modules/system/permission-checker.ts） |
system:permission:request | 渲染器（apps/core-app/src/renderer/src/views/base/begin/internal/SetupPermissions.vue） | PermissionChecker.setupChannels -> requestPermission（apps/core-app/src/main/modules/system/permission-checker.ts） |
system:permission:open-settings | 调用方：渲染器（raw event） | PermissionChecker.setupChannels -> openSystemSettings（apps/core-app/src/main/modules/system/permission-checker.ts） |
C12.2 Terminal
| 事件名 | 发送端 | 处理端 |
|---|---|---|
terminal:session:create | createTerminalSdk.create（packages/utils/transport/sdk/domains/terminal.ts） | TerminalModule.create（apps/core-app/src/main/modules/terminal/index.ts）→ 共用 PtySessionCore.create |
terminal:session:write | TerminalSessionHandle.write | TerminalModule.write → PTY 输入 |
terminal:session:resize | TerminalSessionHandle.resize | TerminalModule.resize → PTY 行列 |
terminal:session:close | TerminalSessionHandle.close / SDK 取消 | TerminalModule.close → 共用会话清理 |
terminal:session:data | 共用 PTY 核心 → owner 定向通知 | 创建前注册的 SDK 输出订阅 |
terminal:session:exit | 共用 PTY 核心 → owner 定向通知 | SDK 退出订阅和订阅清理 |
所有控制操作都在启动或访问 PTY 前验证 system.shell 和可信 transport 身份。owner 绑定真实 sender 对象与当前插件 activation，不接受请求正文指定的归属。不存在的 ID 与其他 owner 的 ID 使用相同拒绝语义。创建接收可执行文件与独立参数，不隐式交给 shell 解释。
共用核心位于 apps/core-app/src/main/modules/terminal/pty-session-core.ts，同时管理 AI CLI 的 PTY。local-ai-cli:terminal:* 业务入口保留 Provider、访问等级、cwd、恢复与 lease 门禁。输出完整且有序。关闭后拒绝新输入，只发送一次终止请求，并等待原生 onExit，随后才释放监听和原生会话 lease。信号退出保留 signal；原生零退出码伴随终止信号时，exitCode 转为 null，不表示命令执行成功。
SDK 自动生成内部 creationToken。主进程在异步权限或 Provider 检查前记录 token 的可信 owner。取消或创建回执失败、丢失时，SDK 用同一 typed close/kill 事件按 token 收尾：未启动的记录被取消，已启动的 PTY 等待真实退出。迟到回执不能重建已取消会话。token 不授予归属权限，不存在与其他 owner 的 token 使用相同拒绝语义。AI 业务 SDK 支持 terminal.create(request, { signal })，原有事件名和 Provider 请求字段保持。
TxTerminal 只负责显示输出和发送输入、尺寸事件。网页展示或只读日志不创建进程。EnvDetector 使用 domain SDK，在完成、失败或超时后清理资源。
C12.3 Plugin Logs
| 事件名 | 发送端 | 处理端 |
|---|---|---|
plugin-log:subscribe | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> subscribe（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:unsubscribe | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> unsubscribe（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:get-sessions | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> getSessions（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:open-session-file | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> openSessionFile（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:open-log-directory | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> openLogDirectory（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:get-buffer | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> getBuffer（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log:get-session-log | 渲染器（apps/core-app/src/renderer/src/components/plugin/tabs/PluginLogs.vue） | PluginLogModule -> getSessionLog（apps/core-app/src/main/service/plugin-log.service.ts） |
plugin-log-stream | PluginLogModule -> transport.sendTo（apps/core-app/src/main/service/plugin-log.service.ts） | 渲染器（日志流订阅者） |
C12.4 Dashboard / OCR
| 事件名 | 发送端 | 处理端 |
|---|---|---|
tuff:dashboard | 调用方：渲染器（raw event） | TuffDashboardModule.onInit -> buildSnapshot（apps/core-app/src/main/modules/system/tuff-dashboard.ts） |
ocr:dashboard | 调用方：渲染器（raw event） | OcrService.registerChannels -> getDashboardSnapshot（apps/core-app/src/main/modules/ocr/ocr-service.ts） |