# vscode插件-工作日报生成器

**Repository Path**: a12989/vscode-ext-work-report

## Basic Information

- **Project Name**: vscode插件-工作日报生成器
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-10
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git Log Reader VSCode Extension

一个用于读取和显示 Git 日志信息的 VSCode 扩展插件，现在支持侧边栏视图！

## ✨ 功能特性

- 🚀 **侧边栏集成**：直接在 VSCode 左侧活动栏中显示插件图标
- 🔥 **牛逼一点模式**：显示带有图形和颜色的详细 Git 日志
- 📝 **朴素一点模式**：显示简洁的单行 Git 日志
- 🎨 **主题适配**：完美适配 VSCode 各种主题
- 🔄 **实时刷新**：支持手动刷新功能
- ⚡ **即时激活**：插件启动时自动激活并显示

## 🛠️ 安装方法

### 方法一：开发环境测试
1. 克隆或下载此项目
2. 在项目根目录运行 `npm install`
3. 按 `F5` 启动扩展开发主机
4. 在新窗口中查看左侧活动栏的 Git 分支图标

### 方法二：VSIX 包安装
1. 下载 `git-log-reader-0.0.1.vsix` 文件
2. 在 VSCode 中按 `Ctrl+Shift+P`
3. 输入 "Extensions: Install from VSIX"
4. 选择下载的 `.vsix` 文件

## 🎯 使用方法

### 侧边栏使用（推荐）
1. 在 VSCode 左侧活动栏中找到 Git 分支图标（🌿）
2. 点击图标打开 Git Log Reader 侧边栏
3. 点击按钮查看不同风格的 Git 日志：
   - **🔥 牛逼一点**：显示详细的 Git 日志（带图形和装饰）
   - **📝 朴素一点**：显示简洁的 Git 日志

### 命令面板使用
1. 按 `Ctrl+Shift+P` 打开命令面板
2. 输入 "Show Git Log" 并选择命令
3. 在弹出的窗口中使用相同的按钮功能

## 📁 项目结构

```
git-log-reader/
├── .vscode/                 # VSCode 配置文件
│   ├── launch.json         # 调试配置
│   ├── settings.json       # 编辑器设置
│   └── tasks.json          # 任务配置
├── src/
│   └── extension.ts        # 主要扩展代码
├── out/                    # 编译输出目录
├── package.json            # 扩展清单文件
├── tsconfig.json          # TypeScript 配置
├── README.md              # 项目说明
└── git-log-reader-0.0.1.vsix  # 打包文件
```

## 🔧 开发说明

### 环境要求
- Node.js 16.x 或更高版本
- VSCode 1.74.0 或更高版本
- TypeScript 4.9.4 或更高版本

### 开发命令
```bash
# 安装依赖
npm install

# 编译 TypeScript
npm run compile

# 监听文件变化并自动编译
npm run watch

# 打包扩展
vsce package
```

### 调试步骤
1. 在 VSCode 中打开项目
2. 按 `F5` 启动扩展开发主机
3. 在新窗口中测试插件功能
4. 在原窗口中设置断点进行调试

## 🚀 分享方法

### Git 仓库分享
```bash
# 推送到远程仓库
git remote add origin <你的仓库地址>
git push -u origin master
```

### VSIX 包分享
直接将 `git-log-reader-0.0.1.vsix` 文件发送给其他人安装使用。

## ⚠️ 重要说明

- 确保工作区包含有效的 Git 仓库
- 需要安装 Git 命令行工具
- 插件会自动检测当前工作区
- 如果遇到 "没有可提供视图数据的已注册数据提供程序" 错误，请重新启动扩展开发主机

## 🐛 故障排除

### 插件图标不显示
- 确保按 `F5` 启动了扩展开发主机
- 检查是否在新打开的 VSCode 窗口中查看
- 重新编译项目：`npm run compile`

### Git 日志无法显示
- 确保当前工作区是 Git 仓库
- 检查 Git 是否正确安装
- 确保有提交历史记录

## 📝 更新日志

### v0.0.1
- ✅ 实现基本的 Git 日志读取功能
- ✅ 添加两种显示模式（牛逼一点/朴素一点）
- ✅ 集成侧边栏视图
- ✅ 支持主题适配
- ✅ 添加刷新功能

---

**享受使用 Git Log Reader！** 🎉