# vs-GrepConsole **Repository Path**: hitools/vs-grep-console ## Basic Information - **Project Name**: vs-GrepConsole - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-12-31 - **Last Updated**: 2026-01-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HiToolsGrepConsole [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) 一个用于捕获和显示 Flutter 和 Dart 控制台输出的 VS Code 扩展,支持日志着色、筛选等高级功能。 ## ✨ 功能特性 - 🎯 **自动捕获** - 自动捕获 Flutter 和 Dart 调试会话的控制台输出 - 📝 **专用面板** - 在底部面板区域(与调试控制台同级)显示日志 - 🎨 **日志着色** - 支持自定义颜色规则,高亮显示关键信息 - 🔍 **日志筛选** - 支持创建筛选器,快速过滤感兴趣的日志 - 📥 **完整捕获** - 包含依赖解析、下载等标准输出 - ⚡ **实时同步** - 日志实时同步到 Webview 面板 - 🧹 **一键清空** - 支持清除控制台历史记录 ## 📦 安装 1. 在 VS Code 扩展市场搜索 `HiToolsGrepConsole` 2. 点击安装 或者从源码构建: ```bash git clone cd vs-GrepConsole npm install npm run compile ``` ## 🚀 使用方法 ### 启动扩展 1. 安装扩展后,它会在 VS Code 启动时自动激活 2. 当你开始调试 Flutter 或 Dart 应用时,扩展会自动捕获控制台输出 ### 可用命令 在命令面板 (`Cmd/Ctrl + Shift + P`) 中可以使用以下命令: | 命令 | 说明 | |------|------| | `Show Flutter & Dart Console` | 显示 Flutter 和 Dart 控制台输出面板 | | `Clear Flutter & Dart Console` | 清除控制台历史记录 | ### HiToolsConsole 面板 - 在 VS Code 底部面板区域找到 **HiToolsConsole** 标签页 - 面板内提供工具栏按钮: - 🗑️ **Clear** - 清空日志 - 🎨 **管理颜色** - 打开颜色规则管理器 ### 日志着色 1. 在日志面板中选中要高亮的文本 2. 右键点击选择「设置颜色」 3. 在颜色选择器中选择前景色和背景色 4. 确认后,所有匹配的文本都会应用该颜色 ### 日志筛选 1. 选中要筛选的关键词 2. 右键点击选择「添加筛选」 3. 在工具栏中点击筛选标签切换显示 4. 支持多个筛选条件组合(OR 逻辑) ## 🏗️ 项目结构 ``` src/ ├── extension.ts # 入口文件 ├── types.ts # 类型定义 ├── logManager.ts # 日志管理器 ├── ruleManager.ts # 规则管理器(颜色/筛选规则) ├── debugListener.ts # 调试监听器 ├── commands.ts # 命令注册 └── webview/ ├── index.ts # 导出入口 ├── templates.ts # HTML 模板 └── consoleViewProvider.ts # 视图提供者 ``` ## 🛠️ 开发说明 ### 构建项目 ```bash npm run compile ``` ### 监视模式 ```bash npm run watch ``` ### 调试扩展 1. 在 VS Code 中打开项目 2. 按 `F5` 启动扩展开发主机 3. 在新窗口中测试扩展功能 ### 代码检查 ```bash npm run lint ``` ## 🔧 技术实现 - 使用 VS Code Debug API 监听调试会话事件 - 通过 `registerDebugAdapterTrackerFactory` 捕获完整 DAP 输出 - 使用 `onDidReceiveDebugSessionCustomEvent` 捕获自定义事件 - 使用 Webview API 实现自定义控制台面板 - 使用 `globalState` 持久化用户规则配置 ## 📋 版本历史 ### 0.0.1 - 🎉 初始版本 - ✅ 支持 Flutter 和 Dart 控制台输出捕获 - ✅ 提供基本的显示和清除功能 - ✅ 支持日志着色和筛选 - ✅ 模块化代码结构 ## 🤝 贡献 欢迎提交 Issue 和 Pull Request! ## 📄 许可证 本项目采用 [Apache License 2.0](./LICENSE) 开源协议。 ``` Copyright 2025 HiToolsGrepConsole Contributors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 ```