# 🚀 工作性价比计算器

一个帮助你评估工作真实价值的工具，综合考虑薪资、工时、通勤、工作环境等多个因素，让你更全面地了解一份工作的实际回报。

## ✨ 功能特点

- **工作性价比计算**：综合考虑薪资、工时、通勤、工作环境等多个因素
- **工作比较**：对比两份工作的综合性价比，帮助你做出更明智的职业选择
- **多种评估维度**：包含薪资、时间投入、工作环境、领导关系、职业稳定性等
- **地域差异调整**：支持不同国家/地区的购买力平价(PPP)和城市生活成本调整
- **双版本支持**：提供命令行版本和MCP服务器版本

## 📦 安装指南

### 基本依赖

- Python 3.7 或更高版本

### 安装步骤

1. 克隆或下载本项目到本地

2. 安装所需依赖（仅MCP版本需要）：
```bash
pip install mcp fastmcp
```

## 🚀 使用指南

### 命令行版本（推荐）

命令行版本无需额外依赖，操作简单直观：

```bash
# 计算单个工作的性价比
python worth_calculator_cli.py calculate

# 比较两份工作的性价比
python worth_calculator_cli.py compare

# 查看支持的国家/地区列表
python worth_calculator_cli.py countries

# 查看工具版本
python worth_calculator_cli.py version
```

### MCP服务器版本

如果需要通过MCP框架使用：

```bash
# 启动MCP服务器
python worth_calculator_mcp.py

# 使用MCP客户端连接（需要MCP客户端）
# 注意：MCP服务器的API可能无法通过HTTP请求直接访问
```

## 📊 计算逻辑

工作性价比评分基于以下维度：

1. **基础分**：基于薪资和时间投入的平衡
2. **WFH加成**：远程工作减少通勤压力的额外加分
3. **工作环境评分**：工作场所的舒适度和便利性
4. **领导关系评分**：与上级领导的关系和谐度
5. **职业稳定度评分**：工作的稳定性和保障性

## 🔧 配置说明

### 支持的国家/地区（含PPP转换因子）
- 中国 (4.19)
- 美国 (1.0)
- 日本 (105.0)
- 韩国 (1100.0)
- 德国 (0.9)
- 英国 (0.78)
- 法国 (0.85)
- 加拿大 (1.3)
- 澳大利亚 (1.4)
- 新加坡 (1.35)
- 香港 (0.78)
- 台湾 (28.0)
- 澳门 (0.78)

### 城市生活成本系数
- 一线城市 (1.0)
- 新一线 (0.8)
- 二线城市 (0.65)
- 三线城市 (0.55)
- 四线城市 (0.45)
- 县城 (0.38)
- 乡镇 (0.3)

## 📝 示例输出

计算单个工作性价比的示例输出：

```
===== 计算结果 =====
年薪: 200000 元
实际工作天数: 232 天
小时工资: 114.94 元/小时
真实日薪: 862.07 元/天
标准化日薪: 164.6 元/天
综合评分: 98.48/100
结论: 工作很值得，继续保持！

详细评分:
  基础分: 45.98
  WFH加成: 2.0
  工作环境: 18.0
  领导关系: 15.0
  职业稳定度: 17.5
```

## 🛠️ 开发说明

如果你想修改或扩展这个工具，可以：

1. 在 `worth_calculator_cli.py` 或 `worth_calculator_mcp.py` 中调整评分权重或增加新的评估维度
2. 更新PPP转换因子或城市生活成本系数以反映最新情况
3. 添加新的命令行功能或API接口

## 📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

## 👥 贡献者

- Alvin

## 💡 反馈与建议

如果你有任何问题或建议，欢迎提交 Issue 或 Pull Request。