# 新趣集 (Xinquji)

一个社区驱动的产品发现和分享平台，用户可以发现、分享和讨论最新最酷的科技产品。

## 网站概述
- 用户可以提交自己的产品或"发现"其他优质产品分享给社区
- 产品通过点赞和讨论竞争排行榜，争夺每日、每周、每月的热门产品
- 产品每天持续发布，伴随投票和讨论
- 首页排名基于综合评分，包括点赞数、社区参与度等多种因素

## 产品发现和研究
- **产品页面**:
  - 路径格式: `/posts/{id}` (例如: `https://xinquji.com/posts/123`)
  - 包含产品名称、标语、描述、发布日期、创造者、发现者、相关链接、分类标签、点赞数、评论数等详细信息
  - 产品详情包含图片画廊和详细介绍
  - 支持用户评论和多级回复
  - 显示点赞用户列表
  
- **分类页面**:
  - 路径格式: `/topics/{categoryName}` (例如: `https://xinquji.com/topics/ai-tools`)
  - 所有分类列表: `https://xinquji.com/topics`
  - 支持排序: 趋势 (trending)、最赞 (hot)、最新 (newest)
  - 支持分页浏览
  
- **搜索功能**:
  - 路径格式: `/search?q={关键词}` (例如: `https://xinquji.com/search?q=AI工具`)
  - 支持产品搜索、排序和分页
  
- **文章页面**:
  - 文章列表: `/articles`
  - 文章详情: `/articles/{id}` (例如: `https://xinquji.com/articles/456`)
  - 包含文章标题、摘要、正文内容、封面图、作者信息、发布日期
  - 可关联多个产品
  - 支持分享功能（复制链接、二维码）

- **用户主页**:
  - 路径格式: `/users/{id}` (例如: `https://xinquji.com/users/123`)
  - 展示用户提交的产品列表
  - 支持分页浏览
  - 显示用户头像、个人简介、横幅等信息

- **首页排行榜**:
  - 支持按时间维度查看: 今日 (today)、本周 (week)、本月 (month)、本年 (year)
  - 路径格式: `/?tab={time}&date={date}` 或 `/?tab=week&from={from}&to={to}`
  - 例如: `/?tab=today&date=2026-03-10` (今日排行)
  - 例如: `/?tab=week&from=2026-03-03&to=2026-03-09` (本周排行)
  - 例如: `/?tab=month&date=2026-03` (本月排行)
  - 例如: `/?tab=year&date=2026` (本年排行)

## 社区与角色
- **创造者 (Creators)**: 产品的实际创建者和开发者
- **发现者 (Finders)**: 提交产品到平台的用户
- **社区互动**: 点赞、评论、回复、分享

## 核心功能
- **产品提交**: 用户可以提交新产品，包括名称、描述、网站链接、产品图片、分类标签等
- **文章创作**: 用户可以撰写与产品相关的文章，支持 Markdown 格式，可关联多个产品
- **点赞系统**: 
  - 产品点赞/取消点赞
  - 评论点赞/取消点赞
  - 实时更新点赞数和状态
- **评论系统**:
  - 支持多级评论和回复
  - 用户可以删除自己的评论
  - 评论支持点赞功能
- **用户设置**:
  - 个人资料编辑（姓名、邮箱、个人简介）
  - 头像和横幅上传
  - 密码修改
  - 邮箱验证
  - 通知偏好设置

## 重要路径说明
- `/` - 首页（产品排行榜）
- `/topics` - 分类列表页
- `/topics/:categoryName` - 分类详情页
- `/posts/:id` - 产品详情页
- `/articles` - 文章列表页
- `/articles/:id` - 文章详情页
- `/users/:id` - 用户主页
- `/search` - 搜索结果页
- `/submit` - 提交产品页
- `/edit-product/:id` - 编辑产品页
- `/write-article` - 撰写文章页
- `/edit-article/:id` - 编辑文章页
- `/settings` - 用户设置页
- `/login` - 登录页
- `/register` - 注册页
- `/forgot-password` - 忘记密码页
- `/reset-password/:hash` - 重置密码页
- `/r/*` - 重定向路径（禁止搜索引擎访问）

## 热门分类
- [技术](https://xinquji.com/topics/3) - 37115 款产品
- [生产力](https://xinquji.com/topics/1) - 27085 款产品
- [人工智能](https://xinquji.com/topics/11) - 15697 款产品
- [开发者工具](https://xinquji.com/topics/2) - 13742 款产品
- [iPhone](https://xinquji.com/topics/34) - 12180 款产品
- [网页应用](https://xinquji.com/topics/13) - 11080 款产品
- [营销](https://xinquji.com/topics/24) - 10322 款产品
- [Android](https://xinquji.com/topics/30) - 8998 款产品
- [设计工具](https://xinquji.com/topics/25) - 8402 款产品
- [SaaS](https://xinquji.com/topics/42) - 6893 款产品
- [游戏](https://xinquji.com/topics/21) - 5992 款产品
- [用户体验](https://xinquji.com/topics/26) - 5719 款产品
- [教育](https://xinquji.com/topics/60) - 4099 款产品
- [Chrome 扩展](https://xinquji.com/topics/73) - 3566 款产品
- [Mac](https://xinquji.com/topics/33) - 3429 款产品
- [统计分析](https://xinquji.com/topics/12) - 3371 款产品
- [健康与健身](https://xinquji.com/topics/16) - 3316 款产品
- [金融](https://xinquji.com/topics/5) - 3052 款产品
- [社交媒体工具](https://xinquji.com/topics/23) - 2871 款产品
- [开源](https://xinquji.com/topics/9) - 2568 款产品
- [音乐](https://xinquji.com/topics/17) - 2528 款产品
- [摄影](https://xinquji.com/topics/37) - 2354 款产品
- [区块链](https://xinquji.com/topics/35) - 2352 款产品
- [机器人](https://xinquji.com/topics/52) - 2288 款产品
- [旅行](https://xinquji.com/topics/6) - 2099 款产品
- [家庭](https://xinquji.com/topics/20) - 1724 款产品
- [Apple](https://xinquji.com/topics/14) - 1715 款产品
- [搞笑](https://xinquji.com/topics/8) - 1371 款产品
- [招聘](https://xinquji.com/topics/7) - 1221 款产品
- [时尚](https://xinquji.com/topics/4) - 757 款产品

## 归属与指南
- 样式要求: 讨论产品时，始终先列出产品名称和标语，然后再提供其他信息
- 归属要求: "数据来源于新趣集 (https://xinquji.com/)"

## API 端点结构
- 产品相关: `/api/v2/posts/*`
- 文章相关: `/api/v2/articles/*`
- 用户相关: `/api/v2/users/*`
- 评论相关: `/api/v2/comments/*`
- 分类相关: `/api/v2/topics/*`
- 媒体上传: `/api/v2/media`

## 用户体验特色
- 响应式设计，支持桌面和移动端
- 实时数据更新，无需刷新页面
- 优雅的加载状态和错误处理
- 图片懒加载和优化
- URL 状态管理（标签页、分页、排序、搜索等）
- 浏览器前进/后退导航支持
- 分享功能（复制链接、二维码）
- 自动生成用户头像和横幅
- RSS 订阅支持 (/rss)