1
2
3
4

① 数据层   data/bookmarks.csv    ← 唯一手改文件（分组,名称,网址,描述,状态）
② 构建层   scripts/build/        ← CSV → 压缩 JSON（去重/校验/私有过滤）
③ 展示层   index.html + assets/  ← 分类卡片 + 多引擎搜索 + 亮暗主题
④ 部署层   GitHub Actions        ← 推送 main 即双站部署

1
2
3

                     ┌─→ sync-public.js  ──→ public-site/ ──→ 公开站（无管理代码）
bookmarks.csv → 构建 ┤
                     └─→ build-admin-dist.js → admin-dist/ ──→ 管理站（全量+管理面板）

1
2
3
4
5
6
7
8

push main
  ├─ ① 校验 + 构建 data.js
  ├─ ② 生成公开副本 public-site/
  ├─ ③ 确保公开站 Pages 项目存在（不存在则创建）
  ├─ ④ 部署 public-site/ → 公开站
  ├─ ⑤ 构建管理副本 admin-dist/        ┐ 未设 NAV_ADMIN_PASS
  ├─ ⑥ 确保管理站 Pages 项目存在        │ 则 ⑤⑥⑦ 自动跳过
  └─ ⑦ 部署 admin-dist/ → 管理站       ┘ （公开站照常部署）

1
2
3
4
5

cd <项目路径>

npm run validate    # 完整性自检
npm test            # 单元测试
npm run serve       # 本地预览 http://localhost:3366

1
2

git remote add origin git@github.com:<你的用户名>/<仓库名>.git
git push -u origin main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

name: Deploy to Cloudflare Pages

on:
  push:
    branches: [main]
  workflow_dispatch:      # 支持手动触发

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      # secrets 不能用于步骤 if 条件，先转成普通 env（'true'/'false'）
      ADMIN_ENABLED: ${{ secrets.NAV_ADMIN_PASS != '' }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20

      # ① 校验 + 构建
      - name: Validate & build
        env:
          NAV_ADMIN_PASS: ${{ secrets.NAV_ADMIN_PASS }}
        run: |
          node scripts/maintain/validate-project.js
          node scripts/build/build-sites.js

      # ② 公开副本（剥离管理面板 / 过滤私有数据 / 生成 sitemap）
      - name: Build public site
        env:
          NAV_SITE_URL: ${{ secrets.NAV_SITE_URL }}
        run: node scripts/build/sync-public.js

      # ③ 确保公开站项目存在（非交互模式 wrangler 不会自动创建）
      - name: Ensure public Pages project exists
        run: npx --yes wrangler pages project create <公开项目名> --production-branch=main || echo "已存在，跳过"
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

      # ④ 部署公开站
      - name: Publish public site
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy public-site --project-name=<公开项目名> --branch=main --commit-dirty=true

      # ⑤ 构建管理副本（未设 NAV_ADMIN_PASS 时自动跳过）
      - name: Build admin site
        if: env.ADMIN_ENABLED == 'true'
        env:
          NAV_ADMIN_PASS: ${{ secrets.NAV_ADMIN_PASS }}
        run: npm run build:admin

      # ⑥ 确保管理站项目存在
      - name: Ensure admin Pages project exists
        if: env.ADMIN_ENABLED == 'true'
        run: npx --yes wrangler pages project create <管理项目名> --production-branch=main || echo "已存在，跳过"
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

      # ⑦ 部署管理站
      - name: Publish admin site
        if: env.ADMIN_ENABLED == 'true'
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy admin-dist --project-name=<管理项目名> --branch=main --commit-dirty=true

1
2
3

git add .github/workflows/deploy.yml
git commit -m "ci: 添加双站自动部署工作流"
git push origin main

1

[![Deploy](https://github.com/<你的用户名>/<仓库名>/actions/workflows/deploy.yml/badge.svg?branch=main)](https://github.com/<你的用户名>/<仓库名>/actions/workflows/deploy.yml)

1
2
3
4
5
6
7
8

# ① 改数据：直接编辑 data/bookmarks.csv（自动备份 20 份历史版本，可回滚）
#    或用 CLI（参数用空格分隔）：
npm run nav -- add 分组 名称 https://example.com 描述

# ② 提交推送
git add -A && git commit -m "更新书签" && git push

# ③ 完成——双站 1-2 分钟内自动重新部署