src__services.md

目录说明：src/services

目录定位

服务层目录，封装远程 API、MCP、分析埋点、设置同步、记忆处理和插件管理。

目录快照

• 相对路径：src/services
• 直接文件数：16
• 直接子目录数：20
• 递归文件数：130
• 主要文件类型：.ts x 15、.tsx x 1

依赖关系观察

• 该目录最常引用的仓库内目录：src/utils (49)、src/services/api (5)、src/services/analytics (5)、src/utils/model (4)、src/services/mcp (4)、src (3)、src/types (2)
• 最常引用该目录的仓库内目录：src/utils (11)、src/services/api (5)、src/hooks (5)、src/components (3)、src/services/compact (3)、src/screens (3)、src (2)

直接文件说明

文件	行数	导出/关键符号	说明
awaySummary.ts	74	generateAwaySummary	服务逻辑；导出符号以 generateAwaySummary 为主，顶部注释说明：Generates a short session recap for the "while you were away" card. Returns null on abort, empty transcript, or error.
claudeAiLimits.ts	515	getRateLimitDisplayName, OverageDisabledReason, ClaudeAILimits, currentLimits, getRawUtilization, statusListeners	服务逻辑；导出符号以 getRateLimitDisplayName, OverageDisabledReason, ClaudeAILimits, currentLimits 为主，结合所在目录可判断其服务于 src/services 这条功能线。
claudeAiLimitsHook.ts	23	useClaudeAiLimits	hook 或 hook 执行逻辑；导出符号以 useClaudeAiLimits 为主，结合所在目录可判断其服务于 src/services 这条功能线。
diagnosticTracking.ts	397	Diagnostic, DiagnosticFile, DiagnosticTrackingService, diagnosticTracker	服务逻辑；导出符号以 Diagnostic, DiagnosticFile, DiagnosticTrackingService, diagnosticTracker 为主，结合所在目录可判断其服务于 src/services 这条功能线。
internalLogging.ts	90	getContainerId, logPermissionContextForAnts	服务逻辑；导出符号以 getContainerId, logPermissionContextForAnts 为主，顶部注释说明：Get the current Kubernetes namespace: Returns null on laptops/local development, "default" for devboxes in default na...
mcpServerApproval.tsx	41	handleMcpjsonServerApprovals	界面组件或交互视图；导出符号以 handleMcpjsonServerApprovals 为主，顶部注释说明：Show MCP server approval dialogs for pending project servers. Uses the provided Ink root to render (reusing the exist...
mockRateLimits.ts	882	MockHeaderKey, MockScenario, setMockHeader, addExceededLimit, setMockEarlyWarning, clearMockEarlyWarning	服务逻辑；导出符号以 MockHeaderKey, MockScenario, setMockHeader, addExceededLimit 为主，顶部注释说明：Mock rate limits for testing [ANT-ONLY]
notifier.ts	156	NotificationOptions, sendNotification	服务逻辑；导出符号以 NotificationOptions, sendNotification 为主，结合所在目录可判断其服务于 src/services 这条功能线。
preventSleep.ts	165	startPreventSleep, stopPreventSleep, forceStopPreventSleep	服务逻辑；导出符号以 startPreventSleep, stopPreventSleep, forceStopPreventSleep 为主，顶部注释说明：Prevents macOS from sleeping while Claude is working. Uses the built-in caffeinate command to create a power assert...
rateLimitMessages.ts	344	RATE_LIMIT_ERROR_PREFIXES, isRateLimitErrorMessage, RateLimitMessage, getRateLimitMessage, getRateLimitErrorMessage, getRateLimitWarning	服务逻辑；导出符号以 RATE_LIMIT_ERROR_PREFIXES, isRateLimitErrorMessage, RateLimitMessage, getRateLimitMessage 为主，顶部注释说明：Centralized rate limit message generation Single source of truth for all rate limit-related messages
rateLimitMocking.ts	144	processRateLimitHeaders, shouldProcessRateLimits, checkMockRateLimitError, isMockRateLimitError, shouldProcessMockLimits	服务逻辑；导出符号以 processRateLimitHeaders, shouldProcessRateLimits, checkMockRateLimitError, isMockRateLimitError 为主，顶部注释说明：Facade for rate limit header processing This isolates mock logic from production code
tokenEstimation.ts	495	countTokensWithAPI, countMessagesTokensWithAPI, roughTokenCountEstimation, bytesPerTokenForFileType, roughTokenCountEstimationForFileType, countTokensViaHaikuFallback	服务逻辑；导出符号以 countTokensWithAPI, countMessagesTokensWithAPI, roughTokenCountEstimation, bytesPerTokenForFileType 为主，顶部注释说明：@aws-sdk/client-bedrock-runtime is imported dynamically in countTokensWithBedrock()
vcr.ts	406	withVCR, withTokenCountVCR	服务逻辑；导出符号以 withVCR, withTokenCountVCR 为主，顶部注释说明：Generic fixture management helper Handles caching, reading, writing fixtures for any data type
voice.ts	525	_resetArecordProbeForTesting, _resetAlsaCardsForTesting, checkVoiceDependencies, RecordingAvailability, requestMicrophonePermission, checkRecordingAvailability	服务逻辑；导出符号以 _resetArecordProbeForTesting, _resetAlsaCardsForTesting, checkVoiceDependencies, RecordingAvailability 为主，顶部注释说明：Voice service: audio recording for push-to-talk voice input.
voiceKeyterms.ts	106	splitIdentifier, getVoiceKeyterms	服务逻辑；导出符号以 splitIdentifier, getVoiceKeyterms 为主，顶部注释说明：Voice keyterms for improving STT accuracy in the voice_stream endpoint.
voiceStreamSTT.ts	544	FINALIZE_TIMEOUTS_MS, VoiceStreamCallbacks, FinalizeSource, VoiceStreamConnection, isVoiceStreamAvailable, connectVoiceStream	服务逻辑；导出符号以 FINALIZE_TIMEOUTS_MS, VoiceStreamCallbacks, FinalizeSource, VoiceStreamConnection 为主，顶部注释说明：Anthropic voice_stream speech-to-text client for push-to-talk.

直接子目录说明

子目录	直接文件数	直接子目录数	说明
src/services/AgentSummary	1	0	该目录是 src/services 下的子模块，围绕 AgentSummary 这一主题组织实现文件。
src/services/MagicDocs	2	0	该目录是 src/services 下的子模块，围绕 MagicDocs 这一主题组织实现文件。
src/services/PromptSuggestion	2	0	该目录是 src/services 下的子模块，围绕 PromptSuggestion 这一主题组织实现文件。
src/services/SessionMemory	3	0	该目录是 src/services 下的子模块，围绕 SessionMemory 这一主题组织实现文件。
src/services/analytics	9	0	该目录是 src/services 下的子模块，围绕 analytics 这一主题组织实现文件。
src/services/api	20	0	面向 Anthropic/Claude 远程接口的 API 服务目录，负责请求封装、日志、配额与业务调用。
src/services/autoDream	4	0	该目录是 src/services 下的子模块，围绕 autoDream 这一主题组织实现文件。
src/services/compact	11	0	该目录是 src/services 下的子模块，围绕 compact 这一主题组织实现文件。
src/services/extractMemories	2	0	该目录是 src/services 下的子模块，围绕 extractMemories 这一主题组织实现文件。
src/services/lsp	7	0	该目录是 src/services 下的子模块，围绕 lsp 这一主题组织实现文件。
src/services/mcp	23	0	MCP 服务协调目录，负责服务器配置、连接管理、官方 registry 和 Claude.ai 集成。
src/services/oauth	5	0	该目录是 src/services 下的子模块，围绕 oauth 这一主题组织实现文件。
src/services/plugins	3	0	该目录是 src/services 下的子模块，围绕 plugins 这一主题组织实现文件。
src/services/policyLimits	2	0	该目录是 src/services 下的子模块，围绕 policyLimits 这一主题组织实现文件。
src/services/remoteManagedSettings	5	0	该目录是 src/services 下的子模块，围绕 remoteManagedSettings 这一主题组织实现文件。
src/services/settingsSync	2	0	该目录是 src/services 下的子模块，围绕 settingsSync 这一主题组织实现文件。
src/services/teamMemorySync	5	0	该目录是 src/services 下的子模块，围绕 teamMemorySync 这一主题组织实现文件。
src/services/tips	3	0	该目录是 src/services 下的子模块，围绕 tips 这一主题组织实现文件。
src/services/toolUseSummary	1	0	该目录是 src/services 下的子模块，围绕 toolUseSummary 这一主题组织实现文件。
src/services/tools	4	0	该目录实现模型可调用的工具能力，是代理执行动作的直接承载层。