# service-api

**Repository Path**: hsyi/service-api

## Basic Information

- **Project Name**: service-api
- **Description**: api集合
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-13
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 通用打包命令

```bash
pyinstaller --python=.\venv\Scripts\python.exe --onefile main.py --hidden-import=aiohttp
```

### 各应用打包命令

| 应用              | 打包命令                                                                                          |
|-----------------|-----------------------------------------------------------------------------------------------|
| Senior V2       | `pyinstaller --paths=.\ --onefile .\apps\senior\v2\main.py --name "senior_v2"`                |
| Senior V3       | `pyinstaller --paths=.\ --onefile .\apps\senior\v3\main.py --name "senior_v3"`                |
| Senior Calendar | `pyinstaller --paths=.\ --onefile .\apps\senior_calendar\main.py --name "senior_calendar"`    |
| Yuedong V2      | `pyinstaller --paths=.\ --onefile .\apps\yuedong\v2\main.py --name "yuedong_v2"`              |
| Yuedong V3      | `pyinstaller --paths=.\ --onefile .\apps\yuedong\v3\main.py --name "yuedong_v3"`              |
| 测试应用            | `pyinstaller --paths=.\ --onefile .\apps\verify_test.py --name "senior"`                      |
| 茅台监控            | `pyinstaller --paths=.\ --onefile .\apps\maotai\lihua_app_monitoring\main.py --name "maotai"` |
| 京东茅台礼品库存监控      | `pyinstaller --paths=.\ --onefile .\apps\jd_moutai_point\main.py --name "京东茅台礼品库存监控v.1.0.7"`  |
# Service API 项目

这是一个包含多个应用服务的Python项目，提供了各种功能模块和工具。

## 目录结构

```
├── .venv/                 # Python虚拟环境
├── apps/                  # 应用程序目录
│   ├── consumer/          # 消费者应用
│   ├── ddns/              # DDNS服务
│   ├── lihua_bearer_monitor/ # 监控服务
│   ├── senior/            # 高级服务 (v1-v3版本)
│   ├── senior_calendar/   # 日历服务
│   ├── yuedong/           # 运动服务 (v1-v3版本)
│   └── maotai/            # 茅台应用监控
├── common/                # 通用组件
├── configs/               # 配置管理
├── constants/             # 常量定义
├── helpers/               # 辅助函数
├── utils/                 # 工具类
└── test/                  # 测试代码
```

## 环境配置与依赖安装

### 虚拟环境设置

项目使用Python虚拟环境隔离依赖，虚拟环境目录为 `.venv/`。

### 依赖安装

1. 激活虚拟环境：
   ```bash
   .venv\Scripts\Activate.ps1  # Windows PowerShell
   # 或
   .venv\Scripts\activate.bat  # Windows CMD
   ```

2. 安装依赖：
   ```bash
   python -m pip install -r requirements.txt
   ```

### 解决pip更新问题

如果遇到pip安装或更新报错，可以尝试以下步骤：

```bash
# 确保pip已安装并更新到最新版本
py -m ensurepip --upgrade

# 升级pip
python -m pip install --upgrade pip
```

### 虚拟环境包安装注意事项

本项目在虚拟环境中创建了 `.venv\pip.ini` 配置文件，用于解决包安装路径问题：

#### 作用
- **覆盖全局pip配置**：避免包被安装到全局目录 `E:\packages\pip`
- **确保包安装到虚拟环境**：所有依赖包都会安装到 `.venv\Lib\site-packages` 目录
- **持久化配置**：配置会一直生效，无论使用 `pip install` 还是 `python -m pip install` 命令

#### 配置内容
```ini
[global]
target =

[install]
prefix =
```

#### 使用建议
1. 确保激活虚拟环境后再安装依赖
2. 推荐使用 `python -m pip install` 命令安装包，以确保安装到正确的位置
3. 保留此配置文件，避免未来遇到类似的包安装路径问题

#### 验证方法
```bash
# 查看当前pip配置
pip config list

# 验证包安装位置（以requests为例）
python -c "import requests; print(requests.__file__)"
```

## Git相关命令

### 查看提交文件大小

```bash
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | awk '$1=="blob" {print $3/1024/1024 " MB", $2, $4}' | sort -nr | head -n 10
```

### 清理Commit历史

当遇到Git commit卡住或需要清理历史提交时，可以使用以下命令：

```bash
git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch build' --prune-empty --tag-name-filter cat -- --all

git reflog expire --expire=now --all
git gc --prune=now --aggressive
git push origin --force --all
```

> **注意**：此命令会重写Git历史，谨慎使用！

## 开发与测试

### 运行应用

各应用的主入口文件位于 `apps/` 目录下对应的应用文件夹中，例如：

```bash
# 运行Senior V3应用
python apps\senior\v3\main.py
```

### 测试代码

测试代码位于 `test/` 目录下，可以运行相关测试脚本进行功能验证。

## 许可证

本项目使用MIT许可证，详见LICENSE文件。