# AndroidLogcatView

**Repository Path**: agrui/android-logcat-view

## Basic Information

- **Project Name**: AndroidLogcatView
- **Description**: AndroidLogcatView是一个在您的电脑上实时显示 Android logcat 日志的工具。
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-31
- **Last Updated**: 2025-11-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AndroidLogcatViewer 用户手册

## 简介

LogcatViewer 是一个在您的电脑上实时显示 Android logcat 日志的工具。

## 功能特性

- 实时 logcat 日志显示
- 通过进程ID（pid）、标签（tag）和包名进行过滤
- 将日志保存到文件
- 过滤历史记录
- 可配置的 ADB 路径
- **AI 助手** - 智能日志分析和故障排除支持
- **多模型支持** - 兼容 OpenAI、Ollama 和其他 AI 提供商
- **Markdown 渲染** - AI 响应的富文本显示

## 效果展示
![功能演示](./images/introduce.gif)

## 如何使用

### 基本使用
1. **通过 USB 将您的 Android 设备** 连接到您的电脑。
2. **在您的 Android 设备上启用 USB 调试**。
3. **运行 LogcatViewer.exe**。
4. **在主窗口中查看日志**。
5. **使用过滤器输入框过滤日志**。
6. **使用 "文件" -> "另存为" 菜单将日志保存到文件**。
7. **如果 ADB 不在您的系统 PATH 中，请使用 "文件" -> "配置 ADB 路径" 菜单配置 ADB 路径**。
8. **使用 "帮助" -> "用户手册" 菜单访问用户手册**。
9. **使用 "帮助" -> "关于" 菜单访问关于对话框**。

### AI 助手使用
1. **打开 AI 助手** 通过点击界面中的 AI 助手面板或按钮。
2. **配置 AI 模型** 设置您首选的 AI 提供商（请参阅下面的 AI 模型配置部分）。
3. **提出问题** 关于日志分析、错误排除或 Android 开发问题。
4. **获取智能响应** 包含 Markdown 格式的解释和解决方案。
5. **复制或保存** AI 响应以供将来参考。

## AI 模型配置

AI 助手支持多种 AI 提供商。通过编辑应用程序目录中的 `Settings.json` 文件来配置您首选的模型。

### 配置格式

```json
{
  "modelConfigs": [
    {
      "apiProvider": "OpenAI",
      "apiKey": "your-openai-api-key",
      "url": "https://api.openai.com/v1/chat/completions",
      "modelName": "gpt-4"
    },
    {
      "apiProvider": "Ollama",
      "apiKey": "ollama",
      "url": "http://localhost:11434/v1/chat/completions",
      "modelName": "llama2"
    }
  ],
  "lastSelectedProvider": "OpenAI",
  "lastSelectedModel": "gpt-4"
}
```

### 支持的提供商

- **OpenAI**: 需要有效的 API 密钥，支持 GPT-4、GPT-3.5-turbo 等模型
- **Ollama**: 本地 AI 模型，需要本地运行 Ollama 服务器
- **自定义 API**: 任何兼容 OpenAI 的 API 端点

### 配置参数

- `apiProvider`: AI 提供商名称（例如 "OpenAI"、"Ollama"）
- `apiKey`: 用于身份验证的 API 密钥（本地 Ollama 使用 "ollama"）
- `url`: API 端点 URL
- `modelName`: 要使用的具体模型名称
- `lastSelectedProvider`: 启动时使用的默认提供商
- `lastSelectedModel`: 启动时使用的默认模型

## 故障排除

### ADB 问题
- **"ADB not found" 错误**:
    - 确保您的电脑上已安装 ADB，并且应用程序中已正确配置 ADB 路径。
    - 使用 "文件" -> "配置 ADB 路径" 设置 ADB 路径。
- **没有显示日志**:
    - 确保您的 Android 设备上已启用 USB 调试。
    - 确保您的 Android 设备已正确连接到您的电脑。
    - 通过在命令行中运行 `adb devices` 检查 ADB 是否正常工作。

### AI 助手问题
- **AI 助手无响应**:
    - 检查您的 `Settings.json` 配置文件中的 API 设置是否正确。
    - 验证您的 API 密钥是否有效且有足够的配额。
    - 对于 Ollama：确保 Ollama 服务器正在运行且可访问。
- **"模型未找到" 错误**:
    - 验证 `Settings.json` 中的模型名称是否与可用模型匹配。
    - 对于 Ollama：使用 `ollama list` 查看可用的本地模型。
- **连接超时**:
    - 检查您的互联网连接（对于基于云的 API）。
    - 验证 API URL 是否正确且可访问。
    - 对于本地模型：确保本地服务器在指定端口上运行。

## 联系方式

如果您有任何问题或疑问，请联系 runnerrjg@21cn.com