felo-ai 0.2.0

package/docs/EXAMPLES.md

@@ -0,0 +1,681 @@
+# Usage Examples
+
+Real-world examples showing how to use Felo Search for different scenarios.
+
+**Quick Navigation:**
+- [Daily Life Scenarios](#daily-life-scenarios)
+- [Developer Scenarios](#developer-scenarios)
+- [Multi-language Queries](#multi-language-queries)
+- [Complex Queries](#complex-queries)
+- [Tips for Better Results](#tips-for-better-results)
+
+---
+
+## Daily Life Scenarios
+
+### Weather
+
+**Query:** "What's the weather in Tokyo today?"
+```
+Current temperature, conditions, forecast
+Example: "Currently 15°C in Tokyo with partly cloudy skies..."
+```
+
+**Query:** "杭州明天天气怎么样？"
+```
+明天杭州天气预报，温度范围，降水概率
+示例："杭州明天多云转晴，气温 8-16°C..."
+```
+
+**Query:** "Will it rain in Seattle this weekend?"
+```
+Weekend forecast with precipitation probability
+```
+
+**Query:** "北京下周天气预报"
+```
+北京未来一周天气趋势，温度变化
+```
+
+### Restaurants & Food
+
+**Query:** "Best ramen in Osaka"
+```
+Top-rated ramen shops with addresses, ratings, reviews
+Example: "1. Ichiran Dotonbori - Famous tonkotsu ramen..."
+```
+
+**Query:** "上海哪里有好吃的小笼包？"
+```
+推荐餐厅列表，地址，特色菜品
+示例："1. 南翔馒头店 - 豫园老字号，皮薄汁多..."
+```
+
+**Query:** "Vegetarian restaurants near Times Square"
+```
+Nearby vegetarian options with ratings and menus
+```
+
+**Query:** "成都火锅推荐"
+```
+成都特色火锅店，人气排名，特色菜品
+```
+
+**Query:** "Best coffee shops in Portland"
+```
+Top-rated coffee shops with specialties and atmosphere
+```
+
+**Query:** "东京米其林餐厅推荐"
+```
+东京米其林星级餐厅，预订方式，价格区间
+```
+
+### Shopping & Prices
+
+**Query:** "iPhone 15 Pro price comparison"
+```
+Prices from different retailers with links
+Example: "Apple Store: $999, Amazon: $979..."
+```
+
+**Query:** "MacBook Air M3 多少钱？"
+```
+各渠道价格对比，优惠信息
+示例："官网: ¥9,499, 京东: ¥9,299..."
+```
+
+**Query:** "Best deals on noise-canceling headphones"
+```
+Current deals and discounts on popular models
+```
+
+**Query:** "Switch OLED 哪里买最便宜？"
+```
+各平台价格对比，促销活动信息
+```
+
+**Query:** "AirPods Pro 2 vs Sony WF-1000XM5"
+```
+Detailed comparison: features, sound quality, price
+```
+
+**Query:** "小米14 Pro 值得买吗？"
+```
+评测总结，优缺点分析，购买建议
+```
+
+### Travel & Local Info
+
+**Query:** "Things to do in Kyoto this weekend"
+```
+Events, attractions, seasonal activities
+Example: "Cherry blossom viewing at Maruyama Park..."
+```
+
+**Query:** "台北有什么好玩的地方？"
+```
+景点推荐，开放时间，交通方式
+示例："台北 101 - 观景台看夜景..."
+```
+
+**Query:** "Best time to visit Iceland"
+```
+Seasonal recommendations, weather, tourist seasons
+```
+
+**Query:** "巴黎旅游攻略"
+```
+必去景点，美食推荐，交通指南
+```
+
+**Query:** "Cheap flights from NYC to London"
+```
+Flight deals, best booking times, airline comparisons
+```
+
+**Query:** "日本签证怎么办理？"
+```
+签证类型，申请流程，所需材料
+```
+
+---
+
+## Developer Scenarios
+
+### Latest Documentation
+
+**Query:** "React 19 new features"
+```
+Latest React 19 features with official docs links
+Example: "React Compiler (auto-optimization)..."
+```
+
+**Query:** "Next.js 15 有什么新功能？"
+```
+Next.js 15 新特性总结，文档链接
+示例："Turbopack 稳定版（构建速度提升 5x）..."
+```
+
+**Query:** "Python 3.13 release notes"
+```
+New features, improvements, breaking changes
+```
+
+**Query:** "Vue 3.4 更新内容"
+```
+新特性，性能改进，迁移指南
+```
+
+**Query:** "TypeScript 5.4 what's new"
+```
+New type system features, compiler improvements
+```
+
+**Query:** "Rust 1.76 有哪些改进？"
+```
+语言特性更新，标准库改进
+```
+
+### Library Comparison
+
+**Query:** "Vite vs Webpack 2024 comparison"
+```
+Performance, features, use cases comparison
+Example: "Build Speed: Vite 10x faster (dev)..."
+```
+
+**Query:** "Vue 3 和 React 哪个更适合新项目？"
+```
+对比分析，适用场景，社区生态
+示例："学习曲线: Vue 更平缓..."
+```
+
+**Query:** "Tailwind CSS vs Bootstrap 2026"
+```
+Feature comparison, performance, ecosystem
+```
+
+**Query:** "PostgreSQL vs MySQL 性能对比"
+```
+性能测试，适用场景，特性对比
+```
+
+**Query:** "Jest vs Vitest for testing"
+```
+Speed, features, migration difficulty
+```
+
+**Query:** "Redux vs Zustand 状态管理对比"
+```
+复杂度，性能，学习成本对比
+```
+
+### Tech Trends & News
+
+**Query:** "Latest AI developments January 2026"
+```
+Recent AI breakthroughs, company announcements
+Example: "OpenAI GPT-5 preview released..."
+```
+
+**Query:** "最近有什么重要的技术新闻？"
+```
+近期科技动态，行业趋势
+示例："苹果发布 Vision Pro 2 代..."
+```
+
+**Query:** "Web development trends 2026"
+```
+Popular frameworks, tools, best practices
+```
+
+**Query:** "人工智能最新突破"
+```
+AI 领域重大进展，研究成果
+```
+
+**Query:** "Cybersecurity threats 2026"
+```
+Current threats, vulnerabilities, protection methods
+```
+
+**Query:** "区块链技术最新应用"
+```
+区块链新应用场景，技术发展
+```
+
+### API & Tools
+
+**Query:** "How to use OpenAI GPT-4 API"
+```
+Setup guide, code examples, best practices
+Example: "Install SDK: pip install openai..."
+```
+
+**Query:** "Anthropic Claude API 怎么用？"
+```
+API 使用指南，示例代码，定价信息
+示例："安装 SDK: pip install anthropic..."
+```
+
+**Query:** "GitHub Actions tutorial"
+```
+Workflow setup, common use cases, examples
+```
+
+**Query:** "Docker 入门教程"
+```
+基础概念，常用命令，实战示例
+```
+
+**Query:** "AWS Lambda best practices"
+```
+Performance optimization, cost reduction, security
+```
+
+**Query:** "Kubernetes 部署指南"
+```
+集群搭建，应用部署，运维管理
+```
+
+### Framework Updates
+
+**Query:** "Django 5.0 release notes"
+```
+New features, breaking changes, migration guide
+Example: "Async support improvements..."
+```
+
+**Query:** "Spring Boot 3.2 更新了什么？"
+```
+新特性，改进点，升级建议
+示例："原生镜像支持增强..."
+```
+
+**Query:** "Angular 17 what's new"
+```
+New features, performance improvements
+```
+
+**Query:** "Laravel 11 新功能介绍"
+```
+框架更新，新特性，最佳实践
+```
+
+**Query:** "Express.js vs Fastify performance"
+```
+Benchmark results, use cases, migration
+```
+
+**Query:** "Rails 7.1 有哪些改进？"
+```
+新特性，性能优化，安全更新
+```
+
+---
+
+## Multi-language Queries
+
+### Chinese (Simplified)
+
+**Query:** "人工智能最新进展"
+```
+AI 领域最新研究成果，应用案例
+示例："大模型参数突破 10 万亿..."
+```
+
+**Query:** "深圳有什么好玩的地方"
+```
+深圳景点推荐，特色活动
+示例："世界之窗 - 微缩景观..."
+```
+
+**Query:** "如何学习编程？"
+```
+编程学习路径，资源推荐，学习方法
+```
+
+**Query:** "中国新能源汽车市场分析"
+```
+市场规模，主要厂商，政策影响
+```
+
+**Query:** "最好的在线教育平台"
+```
+平台对比，课程质量，价格分析
+```
+
+### Chinese (Traditional - Taiwan)
+
+**Query:** "台北最近有什麼新鮮事？"
+```
+台北近期新聞，活動資訊
+示例："捷運環狀線北環段動工..."
+```
+
+**Query:** "高雄美食推薦"
+```
+高雄特色餐廳，必吃美食
+示例："六合夜市 - 木瓜牛奶..."
+```
+
+**Query:** "台灣旅遊景點推薦"
+```
+熱門景點，特色體驗，交通資訊
+```
+
+**Query:** "如何申請台灣護照？"
+```
+申請流程，所需文件，辦理時間
+```
+
+**Query:** "台中房價走勢"
+```
+房市分析，價格趨勢，投資建議
+```
+
+### Japanese
+
+**Query:** "東京で今人気のレストランは？"
+```
+東京の人気レストラン、評価、予約情報
+例："Narisawa - モダン日本料理..."
+```
+
+**Query:** "最新のAI技術について教えて"
+```
+最新AI技術の解説、応用例
+例："GPT-5の登場で自然言語処理が進化..."
+```
+
+**Query:** "日本の観光スポット"
+```
+人気観光地、季節のおすすめ、アクセス
+```
+
+**Query:** "プログラミング学習方法"
+```
+学習ロードマップ、おすすめ教材
+```
+
+**Query:** "東京オリンピック後の変化"
+```
+インフラ整備、経済影響、都市開発
+```
+
+### Korean
+
+**Query:** "서울 맛집 추천"
+```
+서울 인기 맛집, 메뉴, 위치 정보
+예시："광장시장 - 전통 한식..."
+```
+
+**Query:** "최신 프로그래밍 트렌드"
+```
+최신 개발 트렌드, 인기 기술 스택
+예시："AI 코딩 어시스턴트 보편화..."
+```
+
+**Query:** "한국 여행 가이드"
+```
+추천 여행지, 맛집, 교통 정보
+```
+
+**Query:** "부동산 시장 전망"
+```
+시장 분석, 가격 동향, 투자 조언
+```
+
+**Query:** "K-pop 최신 소식"
+```
+신곡 발매, 콘서트 일정, 차트 순위
+```
+
+### Mixed Language
+
+**Query:** "React 在中国的使用情况"
+```
+React 在中国的普及度，案例分析
+示例："市场份额: 约 45%（仅次于 Vue）..."
+```
+
+**Query:** "日本のAI企業について"
+```
+日本の主要AI企業、技術動向
+例："Preferred Networks - 深層学習..."
+```
+
+**Query:** "Python vs Java 哪个更适合初学者？"
+```
+语言对比，学习难度，就业前景
+```
+
+**Query:** "東京で中国語が通じる病院"
+```
+中国語対応の医療機関、診療科目
+```
+
+**Query:** "한국에서 일본 여행 가는 방법"
+```
+항공편, 비자, 여행 팁
+```
+
+---
+
+## Complex Queries
+
+### Research & Analysis
+
+**Query:** "Impact of AI on software development 2024-2026"
+```
+Comprehensive analysis with statistics, trends, expert opinions
+Example: "Productivity: 40% faster coding with AI assistants..."
+```
+
+**Query:** "量子计算对密码学的影响"
+```
+深度分析，技术挑战，未来展望
+示例："威胁: RSA、ECC 等传统加密算法将被破解..."
+```
+
+**Query:** "Climate change effects on global economy"
+```
+Economic impact analysis, sector-specific effects, projections
+```
+
+**Query:** "区块链在供应链管理中的应用"
+```
+应用场景，技术方案，案例分析
+```
+
+**Query:** "Future of remote work post-pandemic"
+```
+Trends, company policies, productivity studies
+```
+
+**Query:** "5G 技术对物联网的影响"
+```
+技术优势，应用场景，发展趋势
+```
+
+### Comparisons
+
+**Query:** "Cloud providers comparison: AWS vs Azure vs GCP"
+```
+Detailed comparison table, pricing, use cases
+Example: "Market Share: AWS 32%, Azure 23%..."
+```
+
+**Query:** "编程语言性能对比：Python vs Go vs Rust"
+```
+性能测试数据，适用场景，学习曲线
+示例："执行速度: Rust > Go > Python..."
+```
+
+**Query:** "Electric vehicles: Tesla vs BYD vs Rivian"
+```
+Specs, range, charging, price comparison
+```
+
+**Query:** "在线会议软件对比：Zoom vs Teams vs Google Meet"
+```
+功能对比，价格分析，适用场景
+```
+
+**Query:** "Database comparison: MongoDB vs PostgreSQL"
+```
+Performance, scalability, use cases
+```
+
+**Query:** "智能手机芯片对比：骁龙 vs 天玑 vs 麒麟"
+```
+性能测试，功耗对比，AI 能力
+```
+
+### Deep Dives
+
+**Query:** "How does GPT-4 architecture work?"
+```
+Technical explanation, architecture details, training process
+Example: "Transformer-based architecture with..."
+```
+
+**Query:** "区块链技术原理详解"
+```
+技术架构，共识机制，应用场景
+示例："分布式账本技术，通过密码学..."
+```
+
+**Query:** "Quantum computing explained"
+```
+Principles, qubits, quantum gates, applications
+```
+
+**Query:** "深度学习神经网络原理"
+```
+网络结构，训练过程，优化算法
+```
+
+**Query:** "How does CRISPR gene editing work?"
+```
+Mechanism, applications, ethical considerations
+```
+
+**Query:** "容器化技术深度解析"
+```
+Docker 原理，Kubernetes 架构，最佳实践
+```
+
+### Market Research
+
+**Query:** "Electric vehicle market trends 2026"
+```
+Market size, growth projections, key players
+Example: "Global EV sales expected to reach 20M units..."
+```
+
+**Query:** "中国新能源汽车市场分析"
+```
+市场规模，主要厂商，政策影响
+示例："2026 年市场规模预计突破 1000 万辆..."
+```
+
+**Query:** "AI chip market forecast"
+```
+Market size, major players, technology trends
+```
+
+**Query:** "智能家居市场前景"
+```
+市场规模，消费趋势，竞争格局
+```
+
+**Query:** "Cryptocurrency market analysis 2026"
+```
+Market cap, adoption rates, regulatory landscape
+```
+
+**Query:** "在线教育行业发展趋势"
+```
+市场规模，用户增长，商业模式
+```
+
+### Product Reviews
+
+**Query:** "M3 MacBook Pro vs M3 MacBook Air detailed comparison"
+```
+Specs, performance, price, recommendations
+Example: "Performance: Pro 20% faster in sustained workloads..."
+```
+
+**Query:** "小米14 Pro 和 iPhone 15 Pro 对比评测"
+```
+详细对比，优缺点，购买建议
+示例："性能: 骁龙 8 Gen 3 vs A17 Pro..."
+```
+
+**Query:** "Best budget smartphones 2026"
+```
+Top picks, specs, value analysis
+```
+
+**Query:** "游戏笔记本电脑推荐"
+```
+性能对比，散热测试，性价比分析
+```
+
+**Query:** "Wireless earbuds comparison 2026"
+```
+Sound quality, ANC, battery life, comfort
+```
+
+**Query:** "智能手表选购指南"
+```
+功能对比，续航测试，适用人群
+```
+
+---
+
+## Tips for Better Results
+
+### Be Specific
+
+❌ **Vague:** "Good food Tokyo"
+✅ **Specific:** "Best Italian restaurants in downtown Tokyo"
+
+❌ **Vague:** "React hooks"
+✅ **Specific:** "React hooks tutorial for beginners"
+
+### Include Context
+
+❌ **No context:** "Latest news"
+✅ **With context:** "Latest AI developments January 2026"
+
+❌ **No context:** "Price comparison"
+✅ **With context:** "iPhone 15 Pro price comparison in US"
+
+### Use Natural Language
+
+✅ **Natural:** "What's the weather like in Paris this weekend?"
+✅ **Natural:** "How do I deploy a Next.js app to Vercel?"
+✅ **Natural:** "上海有什么好吃的日本料理？"
+
+### Multi-language Works
+
+✅ **Mixed:** "React 在中国的使用情况"
+✅ **Mixed:** "東京で中国語が通じる病院"
+✅ **Mixed:** "Python vs Java 哪个更适合初学者？"
+
+Felo understands context across languages!
+
+### Great for Current Info
+
+✅ **Time-sensitive:** "latest", "recent", "2026", "today", "now"
+✅ **Trending:** "popular", "trending", "hot", "viral"
+✅ **Comparative:** "best", "top", "vs", "compare"
+
+---
+
+**Need more help?** Check the [FAQ](./FAQ.md) or [report an issue](https://github.com/Felo-Inc/felo-skills/issues).