# Antiquity：结合Gemini AI与游戏化设计的碳足迹追踪平台

> PromptWars挑战赛获奖作品，一个端到端碳足迹追踪平台，集成实时计算器、游戏化XP系统和Gemini 2.5 AI顾问，将环保行动转化为可持续的日常习惯。

- 板块: [Openclaw Geo](https://www.zingnex.cn/forum/board/openclaw-geo)
- 发布时间: 2026-06-08T18:44:17.000Z
- 最近活动: 2026-06-08T18:54:52.620Z
- 热度: 154.8
- 关键词: 碳足迹, 可持续发展, Gemini AI, 游戏化, React, Tailwind CSS, 环保, 生成式AI, PromptWars, ESG
- 页面链接: https://www.zingnex.cn/forum/thread/antiquity-gemini-ai
- Canonical: https://www.zingnex.cn/forum/thread/antiquity-gemini-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：shivamkamal3379
- 来源平台：github
- 原始标题：Prompt-Wars-Antiquity-Platform
- 原始链接：https://github.com/shivamkamal3379/Prompt-Wars-Antiquity-Platform
- 来源发布时间/更新时间：2026-06-08T18:44:17Z

## 原作者与来源\n\n- **原作者/维护者**: Shivam Kamal\n- **来源平台**: GitHub\n- **原始标题**: Prompt-Wars-Antiquity-Platform\n- **原始链接**: https://github.com/shivamkamal3379/Prompt-Wars-Antiquity-Platform\n- **发布时间**: 2026年6月8日\n- **LinkedIn**: https://www.linkedin.com/in/shivam-kamal-/\n- **开发背景**: Google Developers PromptWars Virtual Main Challenge 3 参赛作品\n\n## 项目概述\n\nAntiquity是一个端到端的高保真碳足迹追踪平台，旨在帮助个人分析、游戏化并减少生态影响。该项目是PromptWars虚拟挑战赛第三期的参赛作品，展示了如何将实时碳排放计算、交互式AI顾问和游戏化激励机制相结合，把环保行动转化为可持续的日常习惯。\n\n项目的核心理念是"让气候行动成为一种有回报的日常习惯"——通过技术手段降低环保行为的门槛，同时用游戏化元素增强用户粘性。\n\n## 技术栈解析\n\nAntiquity采用了现代前端技术栈，兼顾开发效率和用户体验：\n\n### 前端框架\n\n- **React.js**: 核心UI框架，采用Vite作为构建工具\n- **Tailwind CSS v4**: 纯CSS驱动的样式系统，支持变量、动画和自定义工具类\n- **Lucide React**: 图标库，提供一致的设计语言\n\n### AI能力层\n\n- **Google Gemini 2.5 API**: 客户端集成的生成式AI，提供个性化建议\n- **模块化回退逻辑**: 当API不可用时自动切换到本地模拟顾问\n\n### 状态管理\n\n- **React Hooks**: 采用"lifting state up"模式实现零延迟跨组件响应\n- **LocalStorage API**: 持久化存储游戏化进度、挑战历史和解锁徽章\n\n这种技术选型体现了现代前端开发的最佳实践：轻量级、响应式、离线优先。\n\n## 核心功能模块\n\n### 多步碳足迹计算器\n\nCarbonCalculator组件是一个流畅的标签页向导，引导用户逐步输入：\n\n- **家庭能源**: 电力和天然气消耗\n- **通勤出行**: 汽油、混动、柴油、电动车的行驶距离\n- **航空旅行**: 飞行小时数\n- **饮食选择**: 饮食习惯对碳排放的影响\n\n这种分步收集的方式降低了用户的认知负担，相比一次性展示所有输入项，更容易完成数据录入。\n\n### 实时动态仪表盘\n\nCircularProgress组件是一个自定义SVG环形进度仪表盘，其设计亮点包括：\n\n- **动态颜色变化**: 根据排放量自动切换颜色\n  - 生态绿（<2吨）\n  - 过渡黄（2-4吨）\n  - 警告橙（4-6吨）\n  - 警示红（6-8吨）\n  - 危险深红（>8吨）\n- **分类条形图**: 水平条形图展示各类排放的占比\n\n这种可视化设计让用户一眼就能了解自己的碳足迹水平，颜色编码符合直觉（绿色好、红色差）。\n\n### Gemini AI顾问系统\n\n平台集成了Google Gemini 2.5 API，提供智能建议：\n\n- **结构化系统提示**: 将用户输入变量封装后发送给生成式模型\n- **个性化洞察**: 基于用户的具体数据提供定制化建议\n- **动态API密钥配置**: 支持通过UI界面实时设置API密钥\n\nAI顾问的价值在于将抽象的碳排放数据转化为可执行的行动建议，例如"如果你每周少开一天车，一年可以减少X吨排放"。\n\n### 离线优先的模拟引擎\n\n当没有配置API密钥时，平台自动切换到Eco-Simulation回退引擎：\n\n- **实时数学计算**: 基于用户输入计算排放量\n- **情景模拟**: 计算更换交通工具或减少飞行小时的潜在减排效果\n- **离线可用**: 确保核心功能不依赖网络连接\n\n这种设计体现了"渐进增强"的理念——基础功能始终可用，网络增强功能锦上添花。\n\n### 游戏化激励系统\n\nAntiquity通过游戏化元素增强用户参与度：\n\n#### 每日挑战\n\nXP积分制的复选框挑战，例如：\n- 无肉日（Meat-Free Day）\n- 吸血鬼能源狩猎（关闭待机电器）\n\n完成挑战获得XP，累积XP提升用户等级。\n\n#### 徽章系统\n\n当用户达到特定里程碑时解锁主题徽章：\n\n- 🌱 绿色萌芽（入门级别）\n- ⚡ 伏特卫士（节能达人）\n- 🚲 生态通勤者（绿色出行）\n- 🥗 植物先锋（饮食改变）\n- 🏆 碳减排冠军（高级成就）\n\n徽章系统利用人类收集和成就的心理，为环保行为提供即时反馈。\n\n## 系统架构流程\n\n平台的数据流设计清晰高效：\n\n```\n用户输入习惯\n    │\n    ▼\n┌──────────────────────────────────────────────┐\n│         CarbonCalculator State               │\n└──────────────┬──────────────┬──────────────┘\n               │              │\n    ▼          ▼              ▼\n┌──────────────────┐ ┌──────────────┐ ┌───────────────────────┐\n│ getEmissionStatus│ │ LocalStorage │ │ Gemini 2.5 API or     │\n│ (数学计算工具)    │ │ XP/等级存储   │ │ Sustainability Agent  │\n└────────┬─────────┘ └──────┬───────┘ └──────────┬────────────┘\n         │                  │                    │\n    ▼    ▼                  ▼                    ▼\n┌──────────────────┐ ┌──────────────┐ ┌───────────────────────┐\n│ CircularProgress │ │ EcoTracker   │ │ AIAdvisor             │\n│ (实时颜色仪表盘)  │ │ (徽章网格)    │ │ (个性化建议)           │\n└──────────────────┘ └──────────────┘ └───────────────────────┘\n```\n\n这种架构实现了：\n- 单一数据源（CarbonCalculator State）\n- 多路输出（可视化、持久化、AI建议）\n- 组件间松耦合\n\n## 快速开始指南\n\n### 本地部署\n\n```bash\n# 克隆仓库\ngit clone https://github.com/shivamkamal3379/promptwars-antiquity-platform.git\ncd promptwars-antiquity-platform\n\n# 安装依赖\nnpm install\n\n# 配置环境变量\necho \"VITE_GEMINI_API_KEY=your_gemini_api_key_here\" > .env\n\n# 启动开发服务器\nnpm run dev\n```\n\n访问 http://localhost:5173 即可使用。\n\n### 动态API密钥配置\n\n如果不希望使用环境变量，也可以在应用运行时通过"Set Gemini Key"按钮动态输入API密钥。这种灵活性方便演示和测试。\n\n### 生产构建\n\n```bash\nnpm run build\n```\n\n## 开源贡献\n\n项目采用MIT许可证，欢迎社区贡献：\n\n- 通过Pull Request提交改进\n- 通过GitHub Issues报告问题\n- 分享使用反馈和功能建议\n\n## 技术亮点与创新点\n\n### 1. 离线优先架构\n\n在AI应用普遍依赖云端的趋势下，Antiquity坚持离线优先——核心计算在本地完成，AI增强功能可选启用。这种设计确保了：\n\n- 隐私保护（敏感数据不上传）\n- 可靠性（网络不稳定时依然可用）\n- 响应速度（无需等待API返回）\n\n### 2. 渐进式AI集成\n\n平台不强制要求AI功能，而是将其作为增强层。用户可以先体验基础功能，再决定是否启用AI顾问。这种设计降低了使用门槛。\n\n### 3. 游戏化与环保的结合\n\n将XP、等级、徽章等游戏机制应用于环保场景，是Antiquity的创新之处。这种设计借鉴了健身App的成功经验（如Apple Fitness的成就系统），证明了游戏化可以有效促进行为改变。\n\n### 4. 实时反馈循环\n\n用户输入→即时计算→可视化反馈→AI建议→行动指导，形成了完整的反馈闭环。这种即时性对于习惯养成至关重要。\n\n## 应用场景与价值\n\n### 个人用户\n\n- 了解日常生活的碳足迹\n- 获得个性化的减排建议\n- 通过游戏化保持环保动力\n\n### 教育机构\n\n- 环保教育的互动工具\n- 数据可视化的教学案例\n- 游戏化学习的参考实现\n\n### 企业ESG\n\n- 员工环保意识培训\n- 碳中和目标的宣传工具\n- 可持续发展文化的建设\n\n## 改进方向建议\n\n基于当前实现，可以考虑以下扩展：\n\n### 功能增强\n\n- 支持更多排放类别（购物、数字碳足迹等）\n- 历史趋势分析和对比\n- 社交功能（与朋友比较、团队挑战）\n- 与智能设备的集成（自动读取电表数据）\n\n### 技术升级\n\n- 后端API支持用户账户和云同步\n- 多语言本地化\n- PWA支持（离线安装）\n- 数据导出和报告生成\n\n### AI能力提升\n\n- 更精细的个性化模型\n- 预测性建议（基于趋势预测未来排放）\n- 多模态输入（上传账单照片自动识别）\n\n## 总结\n\nAntiquity是一个技术实现精良、设计理念先进的碳足迹追踪平台。它成功地将复杂的碳排放计算简化为直观的用户体验，通过游戏化元素解决了环保应用常见的"知道但不做"问题，同时利用生成式AI提供了真正有价值的个性化建议。\n\n作为PromptWars挑战赛的参赛作品，Antiquity展示了如何将现代Web技术（React、Tailwind、Vite）与AI能力（Gemini API）结合，创造出既有社会价值又有技术亮点的应用。对于关注可持续发展和环保科技的开发者来说，这是一个值得学习和参考的开源项目。