详解 SwiftWork 的 Tool Card 系统:ToolRenderable 协议如何定义工具渲染契约、ToolRendererRegistry 如何做注册查找、5 个内置渲染器的差异,以及 ToolResultContentView 的 diff 检测。
详解 SwiftWork 的事件时间线实现:TimelineView 如何分派 18 种事件到不同视图、ScrollModeManager 如何处理自动滚屏和手动浏览的切换、虚拟化如何在 1000+ 事件下保持流畅。
详解 SwiftWork 的 SDK 集成层设计:AgentBridge 如何消费 AsyncStream、EventMapper 如何做类型映射、ToolContent 如何配对工具事件,以及事件持久化和内存管理策略。
SwiftWork 是一个 macOS 原生 AI Agent 工作台,基于 Open Agent SDK 构建,提供 Agent 执行的实时可观测性。这篇文章介绍项目动机、事件驱动架构和核心数据流。
分析 Open Agent SDK 的多 LLM 提供商支持(LLMClient 协议、AnthropicClient、OpenAIClient 适配层)、运行时模型切换与计费、Thinking/Effort 配置、Skills 系统与工具限制,以及预算控制、中断、动态权限等运行时控制机制。
分析 Open Agent SDK 的会话持久化、权限控制、沙盒机制和 Hook 系统——SessionStore 的五个核心操作、六种 PermissionMode、SandboxChecker 的路径与命令过滤、20+ 生命周期事件的 HookRegistry,以及四者组合构建安全 Agent 的完整方案。
分析 Open Agent SDK 的多 Agent 协作机制:子 Agent 生成(SubAgentSpawner 协议、DefaultSubAgentSpawner、AgentTool)、Task 任务系统(生命周期与状态机)、Team 团队管理、MailboxStore 消息传递,以及实际的编排模式。
分析 Open Agent SDK 的 MCP 集成:五种传输配置、MCPClientManager 连接流程、运行时动态管理、MCP 资源系统、InProcessMCPServer 零开销模式,让 Agent 通过标准协议接入任意外部工具。
分析 Open Agent SDK 的工具系统:ToolProtocol 协议设计、Core/Advanced/Specialist 三层架构、defineTool 工厂函数的 Codable 自动解码、工具池组装与过滤机制。
分析 Open Agent SDK 的 Agent Loop 状态机:阻塞式 prompt() 和流式 stream() 两条路径、工具并发/串行分治、自动压缩、微压缩、预算控制、协作取消,看一个 Swift Agent 怎样在进程内跑完整个循环。