Files
deepseek-harness/docs/event-producer-consumer.zh.md
T

30 KiB

事件生产方与消费方矩阵

English | 中文

本矩阵展示哪些包会派发各个 harness 自有事件,以及哪些包会监听这些事件。事件之间存在多对多关系,因此密集的关系数据以表格而非一张大型关系图呈现。接收方和事件名称类型还涵盖有意绕过 ctx.emit 的内含派发位置,例如 subagent 生命周期封装。

应用级监听者不在本包矩阵范围内。Desktop Host 通过 installOperationDiagnostics 订阅 plugin-manager/operation,并向壳转发有界记录。

Event Mode Declared in Dispatchers Listeners
agent-loop/config-start-failed emit packages/core/agent-loop/src/index.ts:198 agent-loop (events.dispatch) -
agent-preset/selected emit packages/preset/agent-preset-registry/src/types.ts:66 agent-preset-registry (emit) cua, remotes
agent/assistant-stream emit packages/core/agent/src/runtime-types.ts:399 agent-loop (emit) headless, session-controller
agent/created serial packages/core/agent/src/runtime-types.ts:290 agent (serial) agent-team, browser-use-runtime, claude-code-mods, creation-recommendations, cua, file-reference-local, goal, goal-round-driver, hooks-claude-code, hooks-codex, liveshare, loader-smoke, permission-presets, session-controller, tool-subagent
agent/disposed emit packages/core/agent/src/runtime-types.ts:299 agent (events.dispatch) action-cards, agent-loop, claude-code-mods, creation-recommendations, file-reference-local, goal-round-driver, server, session-controller, subagent, tool-subagent-control
agent/error emit packages/core/agent/src/runtime-types.ts:429 agent-loop (emit) acp, deepseek-account, goal-round-driver, headless, server, session-controller, session-telemetry, subagent
agent/inbox/claimed emit packages/core/agent/src/runtime-types.ts:328 agent-loop (emit) acp, goal-round-driver, subagent, tool-jobs, user-questions
agent/inbox/discarded emit packages/core/agent/src/runtime-types.ts:336 agent-loop (emit) goal-round-driver, subagent, user-questions
agent/inbox/inserted emit packages/core/agent/src/runtime-types.ts:317 agent-loop (emit) client-ui-forge, goal-round-driver, subagent, tool-jobs, tool-subagent-control
agent/pre-step waterfall packages/core/agent/src/runtime-types.ts:350 agent-loop (waterfall) action-cards, agent, agent-instructions, claude-code-mods, client-ui-forge, compaction-basic, goal-round-driver, hooks-claude-code, hooks-codex, liveshare, plan-mode, repeat-tool-reminder, session-checkpoint-policy, session-controller, session-reference, subagent, time-context, tmux-context, tool-skill
agent/request-error waterfall packages/core/agent/src/runtime-types.ts:389 agent-loop (waterfall) compaction-basic, compaction-image-offload, llm-retry
agent/status emit packages/core/agent/src/runtime-types.ts:309 agent-loop (emit) acp, compaction-basic, goal-round-driver, server, session-controller
agent/turn-stopping serial packages/core/agent/src/runtime-types.ts:417 agent-loop (serial) hooks-claude-code, hooks-codex, workspace-changes
api-session/activity emit packages/api/session-controller/src/types.ts:705 session-controller (emit) remotes
api-session/added emit packages/api/session-controller/src/types.ts:685 session-controller (emit) remotes
api-session/error emit packages/api/session-controller/src/types.ts:712 session-controller (emit) remotes
api-session/removed emit packages/api/session-controller/src/types.ts:691 session-controller (emit) remotes
api-session/status emit packages/api/session-controller/src/types.ts:698 session-controller (emit) remotes
app-boot/config-reload emit packages/boot/app-boot/src/index.ts:55 app-boot (emit) settings
approval/request waterfall packages/interaction/user-approval/src/types.ts:87 user-approval (waterfall) acp, remotes, server
authorization/settled emit packages/credentials/authorization/src/index.ts:57 authorization (events.dispatch) -
commands/change emit packages/interaction/commands/src/types.ts:89 commands (events.dispatch) remotes
compaction/summary-error waterfall packages/compaction/compaction/src/index.ts:106 compaction-basic (waterfall) compaction-image-offload
connection/request waterfall packages/client/connection/src/index.ts:71 connection (waterfall) -
cordis/dynamic-package emit packages/extensions/cordis-host-runner/src/types.ts:383 cordis-host-runner (emit) remotes
cordis/dynamic-retract emit packages/extensions/cordis-host-runner/src/types.ts:389 cordis-host-runner (emit) remotes
cordis/inspect-query emit packages/extensions/cordis-host-runner/src/types.ts:395 cordis-host-runner (emit) remotes
cordis/inspect-query-resolved emit packages/extensions/cordis-host-runner/src/types.ts:401 cordis-host-runner (emit) remotes
cordis/request-run emit packages/extensions/cordis-host-runner/src/types.ts:371 cordis-host-runner (emit) remotes
cordis/request-run-resolved emit packages/extensions/cordis-host-runner/src/types.ts:377 cordis-host-runner (emit) remotes
credentials/record-updated emit packages/credentials/credentials/src/types.ts:99 credentials (events.dispatch) authorization, deepseek-account-platform, remotes
credentials/reference-updated emit packages/credentials/credentials/src/types.ts:87 credentials (events.dispatch) mcp-client, remotes
deepseek-account/model-sign-in-required emit packages/credentials/deepseek-account/src/types.ts:97 deepseek-account (emit) remotes
deepseek-account/session-expired emit packages/credentials/deepseek-account/src/types.ts:93 deepseek-account-platform (emit) account-controller, remotes
deepseek-account/signed-out emit packages/credentials/deepseek-account/src/index.ts:12 deepseek-account-platform (emit) deepseek-account
domain/changed emit packages/storage/storage-domain/src/events.ts:46 storage-domain (emit) workspace-controller
feedback/committed parallel packages/feedback/message-feedback/src/index.ts:58 message-feedback (parallel) session-telemetry-otel
forge/providers-changed parallel packages/experimental/forge/src/index.ts:27 forge (parallel) forge-session
fs/delete-intent waterfall packages/fs/fs/src/index.ts:82 tool-fs (waterfall) fs-observation-policy, workspace-changes
fs/edit-intent waterfall packages/fs/fs/src/index.ts:74 liveshare (waterfall), tool-fs (waterfall), tool-str-replace-editor (waterfall) fs-observation-policy, workspace-changes
fs/observed emit packages/fs/fs/src/index.ts:92 liveshare (emit), tool-fs (emit), tool-str-replace-editor (emit) fs-observation-policy, skill-filesystem, workspace-files
fs/write-intent waterfall packages/fs/fs/src/index.ts:66 liveshare (waterfall), tool-fs (waterfall), tool-str-replace-editor (waterfall) fs-observation-policy, workspace-changes
goal/activation-changed emit packages/goal/goal/src/types.ts:147 goal (emit) remotes, server
goal/changed emit packages/goal/goal/src/domain.ts:114 goal (emit) goal-round-driver
hmr/change emit packages/boot/hmr/src/index.ts:35 hmr (emit) -
hmr/reload emit packages/boot/hmr/src/index.ts:40 hmr (emit) -
llm-pi-ai/request-headers waterfall packages/llm/llm-pi-ai/src/index.ts:114 llm-pi-ai (waterfall) -
llm/adapters-updated emit packages/llm/llm/src/types.ts:24 llm (events.dispatch) acp, remotes
llm/models-updated emit packages/llm/llm/src/types.ts:30 llm-deepseek (emit) remotes
llm/stream waterfall packages/llm/llm/src/index.ts:75 llm (waterfall) llm-replay, session-checkpoint-policy, session-title
mcp-manager/status parallel packages/mcp/mcp-manager/src/types.ts:46 mcp-manager (parallel) -
permission-presets/catalog-changed emit packages/interaction/permission-presets/src/types.ts:48 permission-presets (events.dispatch) remotes
plugin-manager/changed emit packages/boot/plugin-manager/src/types.ts:432 plugin-manager (emit) remotes
plugin-manager/install-log emit packages/boot/plugin-manager/src/types.ts:438 plugin-manager (emit) remotes
plugin-manager/install-state emit packages/boot/plugin-manager/src/types.ts:445 plugin-manager (emit) remotes
plugin-manager/operation parallel packages/boot/plugin-manager/src/types.ts:424 plugin-manager (parallel) -
plugin-manager/update-state emit packages/boot/plugin-manager/src/types.ts:452 plugin-manager (emit) remotes
plugin-market/changed emit packages/boot/plugin-market/src/types.ts:168 plugin-market (emit) remotes
schedule/changed emit packages/schedule/schedule/src/types.ts:634 schedule (emit) remotes
schedule/resolve-agent waterfall packages/schedule/schedule/src/index.ts:71 schedule (waterfall) server
session-telemetry/record waterfall packages/session/session-telemetry/src/index.ts:44 session-telemetry (waterfall) -
session/created emit packages/core/session/src/index.ts:56 session (events.dispatch) server, session-controller, session-projection, session-projection-cache, session-telemetry
session/disposed emit packages/core/session/src/index.ts:65 session (events.dispatch) agent-loop, file-upload, forge-session, session-controller, session-persistence-jsonl, session-projection-cache, session-telemetry, session-title, ui-trajectory, workspace-changes
session/event emit packages/core/session/src/index.ts:76 session (events.dispatch) acp, agent-instructions, agent-loop, agent-preset-registry, claude-code-mods, client-ui-forge, compaction-basic, file-reference-local, file-upload, forge-session, goal, goal-round-driver, headless, loader-smoke, product-analytics, ptc-runtime-node, server, session-controller, session-persistence-jsonl, session-projection, session-projection-cache, session-telemetry, session-telemetry-otel, session-title, subagent, token-meter, tool-executor-ptc, tool-jobs, ui-trajectory, user-questions, workspace-changes
session/flush parallel packages/core/session/src/index.ts:84 session (events.dispatch) session-persistence-jsonl, session-telemetry
settings/document-updated emit packages/settings/settings/src/types.ts:75 settings (emit) remotes
skills/change emit packages/skill/skill/src/index.ts:296 skill (events.dispatch) -
subagent/end emit packages/subagent/subagent/src/index.ts:166 subagent (events.dispatch) hooks-claude-code, server
subagent/provider-added emit packages/subagent/subagent/src/index.ts:142 subagent (emit) tool-subagent
subagent/provider-removed emit packages/subagent/subagent/src/index.ts:148 subagent (events.dispatch) tool-subagent
subagent/start emit packages/subagent/subagent/src/index.ts:158 subagent (events.dispatch) hooks-claude-code
system-prompt/assemble waterfall packages/core/system-prompt/src/index.ts:31 system-prompt (waterfall) browser-use-runtime, working-directory
system-prompt/change emit packages/core/system-prompt/src/index.ts:37 system-prompt (emit) -
tools/change emit packages/core/tools/src/events.ts:56 agent-preset-registry (emit), tools (emit) browser-use-runtime
tools/execute waterfall packages/core/tools/src/events.ts:29 tools (waterfall) browser-use-runtime, browser-use-stagehand-native, claude-code-mods, computer-use-cua-driver-native, session-checkpoint-policy, timeout-policy
tools/post-execute waterfall packages/core/tools/src/events.ts:41 tools (waterfall) claude-code-mods, hooks-claude-code, hooks-codex, repeat-tool-reminder, spill-policy, tool-fs-search
tools/pre-execute waterfall packages/core/tools/src/events.ts:18 tools (waterfall) auto-review, hooks-claude-code, hooks-codex, liveshare, tool-jobs, workspace-changes
tools/ptc-dispatch-log waterfall packages/core/tool-executor-ptc/src/runtime-types.ts:46 tool-executor-ptc (waterfall) spill-policy
tools/result emit packages/core/tools/src/events.ts:49 tools (events.dispatch) action-cards, agent-instructions, claude-code-mods, forge-session, liveshare, subagent, tool-present, ui-trajectory
user-questions/request waterfall packages/interaction/user-questions/src/types.ts:174 user-questions (waterfall) remotes, server
web/providers-changed emit packages/web/web/src/types.ts:21 web (events.dispatch) remotes
webserver/index-inject emit packages/host/webserver/src/index.ts:44 webserver (emit) connection, inspector, modules, remote-access, shortcuts, ui-sidebar-documentpreview, ui-theme
workflow/agent-end emit packages/workflow/workflow/src/index.ts:79 workflow (events.dispatch) tool-workflow
workflow/agent-start emit packages/workflow/workflow/src/index.ts:68 workflow (events.dispatch) tool-workflow
workflow/end emit packages/workflow/workflow/src/index.ts:89 workflow (events.dispatch) -
workflow/log emit packages/workflow/workflow/src/index.ts:58 workflow (events.dispatch) tool-workflow
workflow/phase emit packages/workflow/workflow/src/index.ts:51 workflow (events.dispatch) tool-workflow
workflow/start emit packages/workflow/workflow/src/index.ts:43 workflow (events.dispatch) -
workspace/session-activity waterfall packages/workspace/workspace/src/index.ts:129 workspace (waterfall) agent, jobs, schedule, subagent
workspace/session-stop parallel packages/workspace/workspace/src/index.ts:147 workspace (parallel) agent, jobs, schedule, subagent

Non-harness or undeclared event strings seen in package source

Event string Dispatchers Listeners
agent/request agent-loop (waterfall) compaction-basic
connection/reset gateway (emit) terminal-controller, ui-settings
internal/config - llm-pi-ai, mcp-manager
internal/dispatch - terminal-bash
internal/plugin - computer-use-cua-driver-native, inspector, loader, lsp-stdio, mcp-client, mcp-manager, modules
internal/service - client-ui-forge, gateway
internal/status - agent, claude-code-mods, inspector, translator, web
loader/volatile-update - llm-deepseek, llm-deepseek-api-key, llm-pi-ai, mcp-manager, plugin-market, product-analytics, speech-to-text
locale/change locale (emit) locale
slots/changed ui-renderer (emit) -
theme/change ui-theme (emit) ui-layout, ui-theme

Maintenance mode: generated: Cordis event declarations and producer/listener edges are resolved from the repository TypeScript Program.