# vp-timesheet

**Repository Path**: IceCream1012/vp-timesheet

## Basic Information

- **Project Name**: vp-timesheet
- **Description**: csii vp报工管理 skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VP Timesheet - VP报工系统自动化管理

自动化管理VP报工系统，支持自动登录、添加报工、查看/删除报工等功能。

## 功能特性

- 自动登录VP报工系统
- 配置化默认参数，简化每日报工
- 支持单日/批量报工
- 查看和删除报工记录
- 参数灵活覆盖

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
playwright install chromium
```

### 2. 初始化配置

```bash
python3 vp_init.py --init
```

按提示设置：
- 用户名（VP系统邮箱）
- 密码
- 默认报工参数（工时类型、是否出差、出差城市、工作日志等）

### 3. 添加报工

```bash
# 添加今日报工
python3 vp_add.py $(date +%d)

# 添加指定日期报工
python3 vp_add.py 5
```

## 常用命令

### 添加报工

```bash
# 使用默认配置
python3 vp_add.py [日期]

# 指定工作内容
python3 vp_add.py 5 --content "完成API开发"

# 标记为出差
python3 vp_add.py 5 --is-travel --city "北京市"

# 只保存不提交
python3 vp_add.py 5 --action save
```

### 查看报工

```bash
# 查看当月所有报工
python3 vp_manage.py --check-only

# 查看指定日期报工
python3 vp_manage.py --month 3 --day 5 --check-only
```

### 删除报工

```bash
# 删除单日报工
python3 vp_manage.py --month 3 --day 5

# 删除多日报工
python3 vp_manage.py --month 3 --days 5 8 10
```

### 配置管理

```bash
# 查看当前配置
python3 vp_init.py --show

# 重新配置
python3 vp_init.py --init
```

## 配置文件

配置保存在 `~/.vp-workspace/.vp_config.json`：

```json
{
  "login": {
    "username": "your_email@example.com",
    "password": "your_password"
  },
  "timesheet": {
    "project_type": "交付项目",
    "is_travel": false,
    "city": "沈阳市",
    "work_content": "1.日常开发工作(100%)",
    "delay_time": 0
  }
}
```

## 注意事项

1. 首次使用必须运行初始化配置
2. 配置文件包含敏感信息，请妥善保管
3. 提交后、审批通过前可删除，审批通过后无法删除
4. 脚本在无头模式下运行

## 文件说明

| 文件 | 说明 |
|------|------|
| `vp_init.py` | 初始化配置脚本 |
| `vp_add.py` | 添加报工脚本 |
| `vp_manage.py` | 查看/删除报工脚本 |
| `vp_common.py` | 公共模块 |
| `requirements.txt` | Python依赖 |
| `help.md` | 详细帮助文档 |
| `SKILL.md` | Claude Code技能说明 |