参赛项目文档

参赛项目名称

此城可期 · CITY WORTH IT（city-worth-it）

择一城，安一业 —— 综合评估 offer 性价比、城市适配度与生活幸福感的 AI Web 应用，让每一次城市选择，都值得奔赴。

团队 / 作者

歪部叩定队（团队参赛）
团队成员：fanbinkong2001、chuhongliang2001

我做了什么

围绕「用 AI 帮求职者做出更理性的城市 / offer 决策」完成了一整套产品化交付：

1. AI 深度评估报告（核心）：接入阿里云百炼（DashScope，OpenAI 兼容模式，qwen-max / qwen-plus），用户填写个人画像（学历 / 年龄 / 职业）+ 工作信息（城市 / 岗位 / 薪资）后，AI 生成结构化评估报告：综合评分、关键优势、风险隐患、具体建议，SSE 流式输出（打字机体验）。Prompt 强制 AI「用数据算账」——必须计算时薪、房价收入比，结合城市产业与职业匹配度深度分析，杜绝空话套话。

2. 城市数据实时联网搜索：输入城市 → AI 联网搜索 2025 年末口径数据（人均收入 / 房价 / 租金 / 通勤 / 气候），带来源标注，24 小时缓存秒回，避免重复计费。

3. 人才政策知识库匹配：内置 675 条人才政策（人才政策.xlsx，覆盖全国主要城市），AI 评估时按城市自动注入知识库，并在「关键优势」中按用户学历 / 年龄加粗列出适用政策及实际补贴利益——这是区别于通用 AI 测评的差异化亮点。

4. 工程架构（FastAPI BFF + 原生前端）：

   • 后端：FastAPI + uvicorn，/api/city-data（联网搜索）、/api/evaluate（SSE 评估）、/report/pdf（PDF 兜底）等路由；Pydantic Settings 环境变量注入；CORS 白名单按 FRONTEND_URLS 配置
   • 前端：原生 HTML/CSS/JS（无框架、无构建），双视图（首页 hero + 评估表单），ResortLux 设计系统（金 / 象牙 / 藏蓝），KaTeX 公式渲染，北上广深港城市影像轮播
   • AI 排队机制：同一 API Key 并发限制自动排队，避免触发 DashScope 限流

5. 云端部署（公网可用）：

   • 后端 → 腾讯云 SCF Web 函数（city-worth-bff，Python3.10，函数 URL + SSE 透传），百炼 API Key 只存函数环境变量，不进代码包
   • 前端 → 腾讯云 COS 静态网站托管 + CDN 加速 + 自定义域名 + HTTPS（TrustAsia 证书）
   • 已上线双域名：cichengkeqi.asia（主）与 iscityworth.asia

6. 代码资产管理：GitHub 公开仓库（含 README、LICENSE MIT、.env.example 模板、一键 启动.bat），密钥全部走环境变量不入库。

使用的工具

• OpenWork / 百炼 CLI：未使用 CLI，通过百炼 OpenAI 兼容接口（compatible-mode） 直接调用

• 百炼能力 / 模型：qwen-max（深度评估）、qwen-plus 联网搜索（城市实时数据）

• 其他：腾讯云 COS / SCF / CDN / DNSPod、FastAPI + SSE、Supabase（可选兜底）、原生前端（无构建）

效果展示

在线 Demo（已上线，公网可访问）：

👉 https://cichengkeqi.asia

完整流程演示：首页 → 填写个人画像 + 工作信息 → 选择城市 → AI 联网搜索城市数据 → 生成 SSE 流式深度评估报告（综合评分 + 关键优势 + 风险隐患 + 具体建议）。

差异化能力：输入任意城市，报告会自动注入该城市人才政策（按学历 / 年龄命中具体补贴），并强制给出时薪 / 房价收入比等量化账目——例如评估「应届硕士去深圳做产品经理」时，报告会同时呈现：深圳房价收入比压力、该学历可申请的人才补贴金额、职业匹配度与 3 年成长路径。

项目链接（可选）

• GitHub 仓库：https://github.com/fanbinkong2001/city-worth-it （公开）
• 在线 Demo：https://cichengkeqi.asia

踩坑记录（可选）