文档

• PulseCN 上游同步指南：docs/upstream-sync.zh-CN.md

Pulse 是一个面向 Apple 平台的强大日志系统。原生实现，基于 SwiftUI 构建。

你可以直接在 iOS App 中记录并查看日志与 URLSession 网络请求；还可以分享日志、在 Pulse Pro 中查看，或者使用远程日志实时观察。所有日志默认都存储在本地，不会离开你的设备。

关于 Pulse

Pulse 不只是一个工具，更是一套框架。它可以记录来自 URLSession 的事件，或者来自依赖 URLSession 的框架（例如 Alamofire 与 Get）的事件，并通过你直接集成到 App 中的 PulseUI 视图进行展示。

这样一来，凡是拿到测试构建的人都能使用 Pulse 控制台。你或 QA 团队可以直接在设备上查看日志，并轻松导出后附加到 Bug 报告中。

Pulse 不是 网络代理。如果你需要代理工具，可以看看 Proxyman。

快速开始

开始使用 Pulse 的最佳入口是官方的 Getting Started 指南。想了解更多用法，可以继续查看这些官方文档：

• Pulse Docs：介绍主框架的集成方式与日志启用方法
• PulseUI Docs：介绍如何把调试菜单与控制台集成到 App 中
• PulseLogHandler Docs：介绍如何把 Pulse 作为 SwiftLog 后端使用

Pulse Pro

Pulse Pro 是一款专业的 macOS 应用，可以让你实时查看日志。它强调灵活、可扩展和精确，同时遵循熟悉的 macOS 交互模式。面对大型日志文件时，它也能通过表格模式、文本模式、过滤器、全新网络检查器、JSON 过滤等能力提升排查效率。

最低要求

Pulse	Swift	Xcode	平台
Pulse 5.0	Swift 5.10	Xcode 15.4	iOS 15、tvOS 15、watchOS 8、macOS 12、visionOS 1
Pulse 4.0	Swift 5.7	Xcode 14.1	iOS 14、tvOS 15、watchOS 8、macOS 12

PulseCN 维护说明

PulseCN 相比原始 Pulse，主要增加了：

• PulseUI 基于 Swift Package Resources 的本地化资源
• en.lproj / zh-Hans.lproj 字符串资源
• 少量把 UI 文案改接到 L10n key 的代码变更

因此后续同步上游时，建议始终遵循：

1. 先同步上游源码
2. 再补齐新增文案的本地化 key
3. 最后重新构建验证中英文界面

详细步骤见：上游同步维护指南

许可证

Pulse 基于 MIT 许可证发布。详情见 LICENSE.md。