b-class-worth-calculator 1.0.0

智能工作性价比分析工具，综合评估薪资、工时、通勤等多维度因素，支持生成可视化报告

🎯 这个B班值不值得上 - 工作性价比计算器

让数据指导你的职业选择！ 🚀

一个智能的工作性价比分析工具，帮你科学评估工作机会，告别盲目选择！

✨ 核心功能

🧮 智能计算引擎

• 💰 多维度评估: 综合考虑薪资、工时、通勤、假期等关键因素
• 🌍 全球化支持: 支持190+国家的购买力平价(PPP)转换
• 👩‍🎓 个性化分析: 根据学历、经验、城市等级智能调整评分
• 📊 科学评分: 基于数据模型的100分制评分系统

🎨 可视化报告

• 🖼️ 精美图片: 自动生成高质量的可视化分析报告
• 🌈 智能主题: 根据评分自动调整颜色和表情符号
• 📱 响应式设计: 适配各种设备和分辨率
• 💾 多格式支持: PNG格式，支持高分辨率显示

🔧 MCP工具集成

• ⚡ 即插即用: 完美集成MCP(Model Context Protocol)生态
• 🤖 AI友好: 可直接被AI助手调用和使用
• 📋 标准化接口: 提供完整的工具函数和参数模板

🚀 快速开始

安装

# 从PyPI安装
pip install b-class-worth-calculator

# 安装Playwright浏览器（用于图片生成）
playwright install chromium

基础使用

from b_class_worth_calculator import calculate_job_worth

# 分析一个工作机会
result = calculate_job_worth(
    annual_salary=300000,  # 年薪30万
    country="中国",
    work_days_per_week=5,
    daily_work_hours=9.0,  # 每天9小时
    commute_hours=1.5,     # 通勤1.5小时
    wfh_days_per_week=2,   # 每周2天居家办公
    annual_leave_days=10,  # 10天年假
    education="本科",
    experience="3-5年",
    city_level="一线城市",
    work_environment="良好"
)

print(result)

MCP工具使用

作为MCP工具运行：

# 启动MCP服务器
b-class-worth-calculator

在MCP客户端配置中添加：

{
  "mcpServers": {
    "b-class-worth-calculator": {
      "command": "b-class-worth-calculator"
    }
  }
}

📊 功能展示

🎯 综合评分示例

工作类型	年薪	工时	通勤	评分	等级
大厂996	50万	12h	2h	45.2	一般
外企朝九晚五	35万	8h	1h	78.6	良好
远程工作	30万	8h	0h	85.3	优秀

🖼️ 可视化报告

生成的报告图片包含：

• 📈 综合评分和等级
• 💰 核心财务指标
• ⏰ 工作时间分析
• 🏠 工作生活平衡
• 💡 个性化改进建议

🛠️ 高级功能

工作对比分析

# 比较两个工作机会
job1_data = '{"annual_salary": 300000, "daily_work_hours": 9, ...}'
job2_data = '{"annual_salary": 250000, "daily_work_hours": 8, ...}'

comparison = compare_jobs(job1_data, job2_data)
print(comparison)

生成可视化报告

# 生成精美的报告图片
image_path = generate_work_report_image(
    report_data=result,
    output_path="my_job_analysis.png"
)
print(f"报告已生成: {image_path}")

获取计算模板

# 获取参数模板
template = get_calculation_template()
print(template)

🌍 支持的国家和地区

支持190+个国家和地区的PPP转换，包括：

• 🇨🇳 中国
• 🇺🇸 美国
• 🇯🇵 日本
• 🇩🇪 德国
• 🇬🇧 英国
• 🇫🇷 法国
• 🇨🇦 加拿大
• 🇦🇺 澳大利亚
• 🇰🇷 韩国
• 🇸🇬 新加坡
• 更多...

📋 评估维度

💰 薪资分析

• 年薪总包
• PPP调整后薪资
• 标准化日薪
• 实际时薪

⏰ 时间成本

• 工作时长
• 通勤时间
• 假期安排
• 工作生活平衡

🎯 个人因素

• 学历水平
• 工作经验
• 城市等级
• 工作环境

📊 综合评分

• 基础分（0-40分）
• 时薪分（0-30分）
• 平衡分（0-20分）
• 加成分（0-10分）

🔧 技术架构

核心技术

• Python 3.8+: 现代Python开发
• MCP协议: 标准化的工具接口
• Playwright: 高质量图片生成
• Jinja2: 灵活的模板引擎
• 科学计算: 基于数据的评分模型

设计原则

• 🎯 数据驱动: 基于科学的评估模型
• 🔧 模块化: 清晰的代码结构
• 🚀 高性能: 优化的计算算法
• 🛡️ 可靠性: 完善的错误处理

📈 使用场景

👔 求职者

• 评估offer的真实价值
• 对比多个工作机会
• 制定薪资谈判策略

🏢 HR和招聘

• 设计有竞争力的薪酬包
• 分析市场薪资水平
• 优化工作条件

🤖 AI助手

• 集成到聊天机器人
• 提供职业咨询服务
• 自动化分析报告

🎨 示例输出

🎯 工作性价比分析报告
==================================================

📋 基本信息:
  • 年薪总包: 300,000 元
  • 工作国家: 中国
  • 城市等级: 一线城市
  • 学历: 本科
  • 工作经验: 3-5年
  • 工作环境: 良好

📊 核心指标:
  • 标准化日薪: 1,200.00 元
  • 实际时薪: 115.38 元
  • 工作生活平衡: 75.0/100
  • 个人因素加成: 1.08x

🎯 综合评估:
  • 最终得分: 72.5/100
  • 评估等级: 良好

💡 改进建议:
  • 🏠 争取居家办公机会以提高工作灵活性
  • 🏖️ 争取更多年假以改善工作生活平衡

🤝 贡献指南

我们欢迎所有形式的贡献！

如何贡献

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发环境

# 克隆项目
git clone https://github.com/trae-ai/b-class-worth-calculator.git
cd b-class-worth-calculator

# 安装依赖
pip install -r requirements.txt
playwright install chromium

# 运行测试
python -m pytest

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 感谢所有贡献者的努力
• 灵感来源于真实的求职经历
• 特别感谢开源社区的支持

📞 联系我们

• 📧 邮箱: [e-mail]
• 🐛 问题反馈: GitHub Issues
• 📖 文档: 项目文档

---

🎉 让数据指导你的职业选择，告别盲目的工作决策！

"这个B班值不值得上" - 用科学的方法回答人生重要问题 🚀