核心用法
react-native-logs-cli（rn-logs）是一款专为 React Native 开发者设计的轻量级命令行调试工具，通过 Chrome DevTools Protocol (CDP) 直接连接 Metro 打包服务，实时捕获应用日志流。区别于传统调试方案，它完全绕过 MCP（Model Context Protocol）等中间层协议，以原生 CDP 通信实现最低延迟的日志传输。
显著优点
- 极简架构：零依赖 MCP 或其他代理层，直接与 Metro 建立 CDP 会话，降低系统复杂度
- 代理友好：默认纯文本输出格式，专为非交互式自动化场景设计，便于 CI/CD 管道和 AI Agent 解析
- 精准定位：支持按应用 ID 或名称过滤多设备/多应用环境，避免日志混杂
- 灵活采集：支持实时流式输出（
logs）与快照截取（--limit）两种模式，兼顾监控与故障排查 - 环境兼容：自动适配默认 Metro 配置（localhost:8081），同时允许自定义主机与端口
潜在缺点与局限性
- 前置依赖严格：必须保持 Metro 运行且应用处于活跃状态，任一条件缺失即失效
- 多应用管理成本：当多应用同时连接时，强制要求
--app参数，增加脚本编写复杂度 - 功能单一性：专注日志读取，不包含性能分析、网络拦截等高级调试能力
- 平台局限：仅适用于 React Native 生态，不支持 Flutter、原生 iOS/Android 等其他框架
适合人群
- React Native 开发者进行日常调试与日志追踪
- DevOps 工程师构建自动化测试与监控流水线
- AI Agent/LLM 系统需要结构化日志输入的场景
- 追求轻量工具、反感重型 IDE 调试配置的开发者
常规风险
- 网络暴露风险：CDP 协议若绑定至非本地地址，可能暴露调试接口（建议始终使用 localhost 或安全隧道）
- 日志敏感信息： Metro 日志可能包含用户数据、API 密钥等，自动化处理时需配置脱敏规则
- 并发稳定性：高频率日志输出场景下未明确说明背压处理机制，极端负载或存在丢日志风险
- 版本锁定：依赖特定 Metro 版本的 CDP 实现，升级 Metro 时需验证兼容性
安全评估说明
本报告为系统占位生成，未执行实际安全扫描。建议后续补充静态代码审计、依赖漏洞扫描及运行时行为分析。