newsnow/
├── src/                # 前端SPA源码
│   ├── components/     # 页面组件（新闻列卡片、头部、通用UI）
│   ├── hooks/          # 自定义状态/请求钩子（刷新、缓存、收藏）
│   ├── routes/         # 页面路由
│   └── ...
├── server/             # Nitro后端API、爬虫、数据库、MCP服务
│   ├── api/            # RESTful接口（登录、新闻、MCP、用户同步）
│   ├── sources/        # 各平台数据源抓取适配器（核心扩展点）
│   ├── database/       # 数据库初始化、CRUD封装
│   └── mcp/            # MCP协议服务实现
├── shared/             # 前后端共享代码
│   ├── types.ts        # 全局类型（NewsItem、Source定义）
│   └── sources.json    # 所有资讯源元配置
├── public/             # 静态资源、PWA图标
├── .github/workflows   # CI自动部署流水线
├── Dockerfile / docker-compose.yml # 容器部署配置
├── nitro.config.ts     # Nitro服务配置
├── vite.config.ts      # 前端构建配置
├── example.env.server  # 环境变量模板（登录、数据库密钥）
└── CONTRIBUTING.md     # 新增数据源、贡献规范文档

// server/sources/xxx.ts 标准模板
export default defineSource({
  id: "weibo",
  name: "微博热搜",
  interval: 2, // 最小抓取间隔2分钟
  async fetch(): Promise<NewsItem[]> {
    // 1. 请求API/爬取页面
    // 2. 清洗数据统一转为NewsItem标准结构
    // 3. 返回标准化新闻列表
  }
})

{
 "mcpServers": {
 "newsnow": {
 "command": "npx",
 "args": ["-y", "newsnow-mcp-server"],
 "env": { "BASE_URL": "https://你的部署域名" }
 }
 }
}

docker compose up

corepack enable
pnpm i
pnpm dev

.dockerignore
.gitignore
CONTRIBUTING.md
Dockerfile
LICENSE
README.ja-JP.md
README.md
README.zh-CN.md
docker-compose.local.yml
docker-compose.yml
eslint.config.mjs
example.env.server
example.wrangler.toml
index.html
nitro.config.ts
package.json
pnpm-lock.yaml
pwa.config.ts
test/
  common.test.ts
tsconfig.app.json
tsconfig.base.json
tsconfig.json
tsconfig.node.json
uno.config.ts
vite.config.ts
vitest.config.ts
.vscode/
...
patches/
...
shared/
...
.github/
...
server/
...
src/
...
screenshots/
...
scripts/
...
public/
...
tools/
...

# Github Client ID
G_CLIENT_ID=
# Github Client Secret
G_CLIENT_SECRET=
# JWT Secret, usually the same as Client Secret
JWT_SECRET=
# Initialize database, must be set to true on first run, can be turned off afterward
INIT_TABLE=true
# Whether to enable cache
ENABLE_CACHE=true

docker compose up

// server/sources/github.ts
import * as cheerio from "cheerio"
import type { NewsItem } from "@shared/types"

const trending = defineSource(async () => {
  const baseURL = "https://github.com"
  const html: any = await myFetch("https://github.com/trending?spoken_language_code=")
  const $ = cheerio.load(html)
  const $main = $("main .Box div[data-hpc] > article")
  const news: NewsItem[] = []
  $main.each((_, el) => {
    const a = $(el).find(">h2 a")
    const title = a.text().replace(/\n+/g, "").trim()
    const url = a.attr("href")
    const star = $(el).find("[href$=stargazers]").text().replace(/\s+/g, "").trim()
    const desc = $(el).find(">p").text().replace(/\n+/g, "").trim()
    if (url && title) {
      news.push({
        url: `${baseURL}${url}`,
        title,
        id: url,
        extra: {
          info: `✰ ${star}`,
          hover: desc,
        },
      })
    }
  })
  return news
})

export default defineSource({
  "github": trending,
  "github-trending-today": trending,
})

// server/api/oauth/github.ts
import process from "node:process"
import { SignJWT } from "jose"
import { UserTable } from "#/database/user"

export default defineEventHandler(async (event) => {
  const db = useDatabase()
  const userTable = db ? new UserTable(db) : undefined
  if (!userTable) throw new Error("db is not defined")
  if (process.env.INIT_TABLE !== "false") await userTable.init()

  const response: {
    access_token: string
    token_type: string
    scope: string
  } = await myFetch(
    `https://github.com/login/oauth/access_token`,
    {
      method: "POST",
      body: {
        client_id: process.env.G_CLIENT_ID,
        client_secret: process.env.G_CLIENT_SECRET,
        code: getQuery(event).code,
      },
      headers: {
        accept: "application/json",
      },
    },
  )

  const userInfo: {
    id: number
    name: string
    avatar_url: string
    email: string
    notification_email: string
  } = await myFetch(`https://api.github.com/user`, {
    headers: {
      "Accept": "application/vnd.github+json",
      "Authorization": `token ${response.access_token}`,
      // 必须有 user-agent，在 cloudflare worker 会报错
      "User-Agent": "NewsNow App",
    },
  })

  const userID = String(userInfo.id)
  await userTable.addUser(userID, userInfo.notification_email || userInfo.email, "github")

  const jwtToken = await new SignJWT({
    id: userID,
    type: "github",
  })
    .setExpirationTime("60d")
    .setProtectedHeader({ alg: "HS256" })
    .sign(new TextEncoder().encode(process.env.JWT_SECRET!))

  // nitro 有 bug，在 cloudflare 里没法 set cookie
  // seconds
  // const maxAge = 60 * 24 * 60 * 60
  // setCookie(event, "user_jwt", jwtToken, { maxAge })
  // setCookie(event, "user_avatar", userInfo.avatar_url, { maxAge })
  // setCookie(event, "user_name", userInfo.name, { maxAge })

  const params = new URLSearchParams({
    login: "github",
    jwt: jwtToken,
    user: JSON.stringify({
      avatar: userInfo.avatar_url,
      name: userInfo.name,
    }),
  })
  return sendRedirect(event, `/?${params.toString()}`)
})