xinquji.com

# 新趣集 (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 格式，可关联多个产品
- **点赞系统**: 
  - 产品点赞/取消点赞
  - 评论点赞/取消点赞
  - 实时更新点赞数和状态
- **评论系统**:
  - 支持多级评论和回复
  - 用户可以删除自己的评论
  - 评论支持点赞功能
- **用户设置**:
  - 个人资料编辑（姓名、邮箱、个人简介）
  - 头像和横幅上传
  - 密码修改
  - 邮箱验证
  - 通知偏好设置

## MCP 服务（AI Agent 接入）
- 新趣集提供 MCP 服务端，任何支持 MCP 的客户端都能直接搜索产品、查看详情、检查提交条件并准备发布草稿
- 端点: `https://xinquji.com/api/mcp`（Streamable HTTP，无需安装、无需本地进程、无需 API Key）
- 文档: `https://xinquji.com/api-mcp`
- 客户端配置示例: `{ "mcpServers": { "xinquji": { "url": "https://xinquji.com/api/mcp" } } }`
- 读取类工具匿名可用；创建草稿需要一次浏览器授权，或改用长期访问令牌（请求头 `Authorization: Bearer <token>`，可在设置页生成和撤销）
- Agent 只能准备草稿，永远不能替你发布、选择方案、设置发布日期或付款

## 重要路径说明
- `/` - 首页（产品排行榜）
- `/topics` - 分类列表页
- `/topics/:categoryName` - 分类详情页
- `/posts/:id` - 产品详情页
- `/articles` - 文章列表页
- `/articles/:id` - 文章详情页
- `/users/:id` - 用户主页
- `/search` - 搜索结果页
- `/launch` - 发布产品页（选择浏览器表单或 AI Agent）
- `/api-mcp` - MCP 服务文档页
- `/submit` - 提交产品页
- `/edit-product/:id` - 编辑产品页
- `/write-article` - 撰写文章页
- `/edit-article/:id` - 编辑文章页
- `/settings` - 用户设置页
- `/login` - 登录页
- `/register` - 注册页
- `/forgot-password` - 忘记密码页
- `/reset-password/:hash` - 重置密码页

## 热门分类
- [技术](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)

---

# Xinquji (English)

A community-driven product discovery and sharing platform where users can discover, share, and discuss the latest and coolest tech products.

## Site Overview
- Users can submit their own products or "discover" quality products to share with the community
- Products compete on leaderboards through upvotes and discussions, vying for daily, weekly, and monthly top spots
- Products are launched daily, accompanied by voting and discussion
- Homepage ranking is based on a composite score including upvotes, community engagement, and other factors

## Product Discovery & Research
- **Product Pages**:
  - Path format: `/posts/{id}` (e.g., `https://xinquji.com/posts/123`)
  - Contains product name, tagline, description, launch date, creator, finder, related links, topic tags, upvote count, comment count, and more
  - Product details include image gallery and detailed introduction
  - Supports user comments and nested replies
  - Displays list of users who upvoted

- **Category Pages**:
  - Path format: `/topics/{categoryName}` (e.g., `https://xinquji.com/topics/ai-tools`)
  - All categories list: `https://xinquji.com/topics`
  - Supports sorting: trending, hot, newest
  - Supports pagination

- **Search**:
  - Path format: `/search?q={keyword}` (e.g., `https://xinquji.com/search?q=AI tools`)
  - Supports product search, sorting, and pagination

- **Article Pages**:
  - Article list: `/articles`
  - Article detail: `/articles/{id}` (e.g., `https://xinquji.com/articles/456`)
  - Contains article title, summary, body content, cover image, author info, publish date
  - Can link to multiple products
  - Supports sharing (copy link, QR code)

- **User Profile**:
  - Path format: `/users/{id}` (e.g., `https://xinquji.com/users/123`)
  - Displays user's submitted products
  - Supports pagination
  - Shows avatar, bio, banner, and other info

- **Homepage Leaderboard**:
  - Supports time-based views: today, week, month, year
  - Path format: `/?tab={time}&date={date}` or `/?tab=week&from={from}&to={to}`
  - e.g., `/?tab=today&date=2026-03-10` (today's leaderboard)
  - e.g., `/?tab=week&from=2026-03-03&to=2026-03-09` (this week's leaderboard)
  - e.g., `/?tab=month&date=2026-03` (this month's leaderboard)
  - e.g., `/?tab=year&date=2026` (this year's leaderboard)

## Community & Roles
- **Creators**: The actual builders and developers of products
- **Finders**: Users who submit products to the platform
- **Community Interaction**: Upvotes, comments, replies, sharing

## Core Features
- **Product Submission**: Users can submit new products, including name, description, website link, product images, topic tags, etc.
- **Article Writing**: Users can write product-related articles in Markdown, with the ability to link multiple products
- **Upvote System**:
  - Upvote/unupvote products
  - Upvote/unupvote comments
  - Real-time upvote count and status updates
- **Comment System**:
  - Supports nested comments and replies
  - Users can delete their own comments
  - Comments support upvoting
- **User Settings**:
  - Profile editing (name, email, bio)
  - Avatar and banner upload
  - Password changes
  - Email verification
  - Notification preferences

## MCP Server (agent access)
- Xinquji exposes an MCP server, so any MCP-capable client can search products, read listings, audit a submission and prepare launch drafts
- Endpoint: `https://xinquji.com/api/mcp` (Streamable HTTP — no install, no local process, no API key)
- Docs: `https://xinquji.com/api-mcp`
- Client config: `{ "mcpServers": { "xinquji": { "url": "https://xinquji.com/api/mcp" } } }`
- Read tools are anonymous; creating a draft needs a one-time browser approval, or a durable access token instead (`Authorization: Bearer <token>`, generated and revocable in settings)
- An agent can only open drafts — it can never publish, pick a plan, set a launch date, or pay

## Important Paths
- `/` - Homepage (product leaderboard)
- `/topics` - Categories list
- `/topics/:categoryName` - Category detail
- `/posts/:id` - Product detail
- `/articles` - Article list
- `/articles/:id` - Article detail
- `/users/:id` - User profile
- `/search` - Search results
- `/launch` - Launch a product (choose browser form or AI agent)
- `/api-mcp` - MCP server docs
- `/submit` - Submit product
- `/edit-product/:id` - Edit product
- `/write-article` - Write article
- `/edit-article/:id` - Edit article
- `/settings` - User settings
- `/login` - Login
- `/register` - Register
- `/forgot-password` - Forgot password
- `/reset-password/:hash` - Reset password

## Popular Categories
- [Tech](https://xinquji.com/topics/3) - 37115 products
- [Productivity](https://xinquji.com/topics/1) - 27085 products
- [AI](https://xinquji.com/topics/11) - 15697 products
- [Developer Tools](https://xinquji.com/topics/2) - 13742 products
- [iPhone](https://xinquji.com/topics/34) - 12180 products
- [Web Apps](https://xinquji.com/topics/13) - 11080 products
- [Marketing](https://xinquji.com/topics/24) - 10322 products
- [Android](https://xinquji.com/topics/30) - 8998 products
- [Design Tools](https://xinquji.com/topics/25) - 8402 products
- [SaaS](https://xinquji.com/topics/42) - 6893 products
- [Games](https://xinquji.com/topics/21) - 5992 products
- [UX](https://xinquji.com/topics/26) - 5719 products
- [Education](https://xinquji.com/topics/60) - 4099 products
- [Chrome Extensions](https://xinquji.com/topics/73) - 3566 products
- [Mac](https://xinquji.com/topics/33) - 3429 products
- [Analytics](https://xinquji.com/topics/12) - 3371 products
- [Health & Fitness](https://xinquji.com/topics/16) - 3316 products
- [Finance](https://xinquji.com/topics/5) - 3052 products
- [Social Media Tools](https://xinquji.com/topics/23) - 2871 products
- [Open Source](https://xinquji.com/topics/9) - 2568 products
- [Music](https://xinquji.com/topics/17) - 2528 products
- [Photography](https://xinquji.com/topics/37) - 2354 products
- [Blockchain](https://xinquji.com/topics/35) - 2352 products
- [Robotics](https://xinquji.com/topics/52) - 2288 products
- [Travel](https://xinquji.com/topics/6) - 2099 products
- [Home](https://xinquji.com/topics/20) - 1724 products
- [Apple](https://xinquji.com/topics/14) - 1715 products
- [Fun](https://xinquji.com/topics/8) - 1371 products
- [Jobs](https://xinquji.com/topics/7) - 1221 products
- [Fashion](https://xinquji.com/topics/4) - 757 products

## Attribution & Guidelines
- Style guide: When discussing products, always list the product name and tagline first, then provide other information
- Attribution: "Data sourced from Xinquji (https://xinquji.com/)"

## API Endpoints
- Products: `/api/v2/posts/*`
- Articles: `/api/v2/articles/*`
- Users: `/api/v2/users/*`
- Comments: `/api/v2/comments/*`
- Topics: `/api/v2/topics/*`
- Media upload: `/api/v2/media`

## UX Features
- Responsive design, supports desktop and mobile
- Real-time data updates without page refresh
- Elegant loading states and error handling
- Image lazy loading and optimization
- URL state management (tabs, pagination, sorting, search, etc.)
- Browser back/forward navigation support
- Sharing features (copy link, QR code)
- Auto-generated user avatars and banners
- RSS feed support (/rss)