feat: add open docs

.github/workflows/deploy.yaml

@@ -0,0 +1,98 @@
+on:
+  push:
+    branches: [main]
+  pull_request:
+    types: [opened, synchronize, reopened]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    name: Build Project
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Use Yarn 4
+        run: corepack enable
+
+      - name: Build
+        run: yarn install --immutable && yarn build
+
+      - name: Upload Build Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-files
+          path: build/
+          retention-days: 1
+
+  deploy-eo:
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      contents: read
+      deployments: write
+      pull-requests: write
+    name: Deploy to QCloud Pages
+    steps:
+      - name: Download Build Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: build/
+
+      - name: Deploy to QCloud Pages
+        id: deploy
+        run: |
+          npm install -g edgeone
+          if [ "${{ github.ref }}" = "refs/heads/main" ]; then
+            edgeone pages deploy ./build -n fcc-docs -t ${{ secrets.QCLOUD_PAGES_TOKEN }} 2>&1 | tee deploy.log
+          else
+            edgeone pages deploy ./build -n fcc-docs -e preview -t ${{ secrets.QCLOUD_PAGES_TOKEN }} 2>&1 | tee deploy.log
+          fi
+
+      - name: Extract Preview URL
+        id: extract-url
+        run: |
+          # 从部署日志中提取预览地址
+          if [ -f deploy.log ]; then
+            PREVIEW_URL=$(grep -o 'EDGEONE_DEPLOY_URL=https://[^[:space:]]*' deploy.log | head -1 | sed 's/EDGEONE_DEPLOY_URL=//')
+
+            if [ -n "$PREVIEW_URL" ]; then
+              echo "preview_url=$PREVIEW_URL" >> $GITHUB_OUTPUT
+              echo "Found preview URL: $PREVIEW_URL"
+            else
+              echo "No preview URL found in deployment log"
+              echo "preview_url=" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "Deploy log not found"
+            echo "preview_url=" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Comment on PR
+        if: github.event_name == 'pull_request' && steps.extract-url.outputs.preview_url != ''
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const previewUrl = '${{ steps.extract-url.outputs.preview_url }}';
+            const comment = `🚀 **预览部署完成！**
+
+            📱 **预览地址**: ${previewUrl}
+
+            > 此预览链接将在部署完成后可用，请稍等片刻再访问。
+
+            ---
+            *由 GitHub Actions 自动生成*`;
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment
+            });

docs/api/event/detail.md

@@ -0,0 +1,36 @@
+# 展会详情
+
+:::tip
+
+接口返回的图片地址已经经过优化压缩，且默认返回 jpg 格式，尽管如此部分图片的体积依然十分恐怖，请根据自身需求缓存后裁剪并优化体积（有的展会宣传图单张体积可超过 10MB+）。
+
+:::
+
+```
+https://api.furrycons.cn/open/event/{id}
+```
+
+预计响应：
+
+```json
+{
+  "id": "0b448a05-fefe-444c-a9dd-81b21ea785c3",
+  "name": "街頭生活",
+  "scale": "medium",
+  "status": "scheduled",
+  "slug": "2027-jan-xianggang-con",
+  "startDate": "2027-01-01T02:00:00.000Z",
+  "endDate": "2027-01-01T10:00:00.000Z",
+  "address": "",
+  "region": "香港特别行政区",
+  "thumbnail": "https://images.furrycons.cn/organizations/furban-jungle/2027-jan-xianggang-con/cover-k8xUi3tu5PcpJSfQ7mI9T.jpeg",
+  "detail": "💥 HONG KONG'S FIRST FURCON 💥\n\nHappy December everyone!\nThis has been in the works for a long time now, and it's still a while away, but now seems like a good time to finally announce a project me and dozens of other local furs have been working on.\n\nI am proud to announce \n\nFurban Jungle\n\nHong Kong's first furry convention in 2027.\n\nThe first year's theme will be Street Life.\n\nThis will be a 2 weekend day event held in the function rooms of a hotel. This hotel is not fully confirmed yet, we will confirm it at a later date.\n\nWe are very excited to work and delivery Hong Kong's first convention. We will work hard to deliver a new, fun, and unforgettable furry experience in Hong Kong. ❤️\n\n大家十二月好！\n我和一眾香港furry已經籌備了一段時間，雖然與正式舉辦還有一段距離，但現在似乎是正式公布的好時機\n\n我很榮幸在此公布：\n\nFurban Jungle\n\n於2027年，香港的第一個獸展\n\n我們的一年的主題是街頭生活\n\n這將會是一個於酒店多個多功能房間舉行，持續兩天的週末活動。酒店詳情現時尚未確定，我們將會於之後時間確實並公布\n\n我們很期待能夠帶給大家香港第一個獸展，我們會努力帶給大家一個全新、有趣、並難忘的香港毛毛體驗",
+  "organization": {
+    "name": "Furban Jungle",
+    "slug": "furban-jungle",
+    "logoUrl": "https://images.furrycons.cn/organizations/furban-jungle/logo-1IljEy9gQuIY8Z-R51sty.jpeg",
+    "url": "https://www.furrycons.cn/furban-jungle"
+  },
+  "url": "https://www.furrycons.cn/furban-jungle/2027-jan-xianggang-con"
+}
+```

docs/api/event/list.md

@@ -0,0 +1,52 @@
+# 展会列表
+
+:::tip
+
+接口返回的图片地址已经经过优化压缩，且默认返回 jpg 格式，尽管如此部分图片的体积依然十分恐怖，请根据自身需求缓存后裁剪并优化体积（有的展会宣传图单张体积可超过 10MB+）。
+
+:::
+
+```
+https://api.furrycons.cn/open/event/
+```
+
+可选的查询参数：
+
+- `eventStartAt`：展会开始日期，格式为 ISO 8601 格式，如 `2026-03-06T02:00:00.000Z`。
+- `eventEndAt`：展会结束日期，格式为 ISO 8601 格式，如 `2026-03-08T10:00:00.000Z`。
+- `search`：展会名称搜索。
+- `orgSearch`：组织名称搜索。
+- `current`：当前页码，默认为 1。
+- `pageSize`：每页条数，默认为20。
+
+预计响应：
+
+```json
+{
+  "total": 410,
+  "current": 1,
+  "pageSize": 1,
+  "data": [
+    {
+      "id": "0b448a05-fefe-444c-a9dd-81b21ea785c3",
+      "name": "街頭生活",
+      "scale": "medium",
+      "status": "scheduled",
+      "slug": "2027-jan-xianggang-con",
+      "startDate": "2027-01-01T02:00:00.000Z",
+      "endDate": "2027-01-01T10:00:00.000Z",
+      "address": "",
+      "region": "香港特别行政区",
+      "thumbnail": "https://images.furrycons.cn/organizations/furban-jungle/2027-jan-xianggang-con/cover-k8xUi3tu5PcpJSfQ7mI9T.jpeg",
+      "detail": "💥 HONG KONG'S FIRST FURCON 💥\n\nHappy December everyone!\nThis has been in the works for a long time now, and it's still a while away, but now seems like a good time to finally announce a project me and dozens of other local furs have been working on.\n\nI am proud to announce \n\nFurban Jungle\n\nHong Kong's first furry convention in 2027.\n\nThe first year's theme will be Street Life.\n\nThis will be a 2 weekend day event held in the function rooms of a hotel. This hotel is not fully confirmed yet, we will confirm it at a later date.\n\nWe are very excited to work and delivery Hong Kong's first convention. We will work hard to deliver a new, fun, and unforgettable furry experience in Hong Kong. ❤️\n\n大家十二月好！\n我和一眾香港furry已經籌備了一段時間，雖然與正式舉辦還有一段距離，但現在似乎是正式公布的好時機\n\n我很榮幸在此公布：\n\nFurban Jungle\n\n於2027年，香港的第一個獸展\n\n我們的一年的主題是街頭生活\n\n這將會是一個於酒店多個多功能房間舉行，持續兩天的週末活動。酒店詳情現時尚未確定，我們將會於之後時間確實並公布\n\n我們很期待能夠帶給大家香港第一個獸展，我們會努力帶給大家一個全新、有趣、並難忘的香港毛毛體驗",
+      "organization": {
+        "name": "Furban Jungle",
+        "slug": "furban-jungle",
+        "logoUrl": "https://images.furrycons.cn/organizations/furban-jungle/logo-1IljEy9gQuIY8Z-R51sty.jpeg",
+        "url": "https://www.furrycons.cn/furban-jungle"
+      },
+      "url": "https://www.furrycons.cn/furban-jungle/2027-jan-xianggang-con"
+    }
+  ]
+}
+```

docs/api/event/recent.md

@@ -1,39 +1,48 @@
 # 最近展会
 
-调用此接口可以获取最近 30 天内的展会信息，目前不支持任何参数：
+:::tip
 
-请注意：如果在最近 30 天内没有数据，会返回过期的最后一条数据。
+接口返回的图片地址已经经过优化压缩，且默认返回 jpg 格式，尽管如此部分图片的体积依然十分恐怖，请根据自身需求缓存后裁剪并优化体积（有的展会宣传图单张体积可超过 10MB+）。
+
+:::
+
+调用此接口可以获取最近 30 天内的展会信息。
+
+支持以下参数：
+
+- `keepOld`：当此值为 `true` 时，如果最近 30 天内没有数据，会返回过期的数据作为填充。
 
 ```
-https://api.furrycons.cn/event/recent
+https://api.furrycons.cn/open/event/recent
 ```
 
 预计响应：
 
 ```json
 {
   "total": 1,
+  "current": 1,
+  "pageSize": 10,
   "data": [
     {
-      "name": "冬兽聚2024",
+      "id": "0c55f1b6-0411-4f21-9244-95ca5268f10e",
+      "name": "乘风启航",
       "scale": "medium",
       "status": "scheduled",
-      "slug": "2024-dec-shanghai-con",
-      "startDate": "2024-12-20T02:00:00.677Z",
-      "endDate": "2024-12-22T10:00:00.816Z",
-      "address": "夏阳湖皇冠假日酒店",
-      "city": "上海",
-      "coverUrl": "https://images.furrycons.cn/organizations/furrychina/2024-dec-shanghai-con/cover-lMiuOMbUlUsqmiiOTpWpG.png",
-      "detail": "将它们化作璀璨星辰，让我在下雨之际看见我的玫瑰。\n关注并转发BILIBILI动态，抽一名小伙伴送出【冬兽聚2024】入场票1张~\n【11月9日19点正式开售！】\n购票&酒店预订：官网FurryChina.com\n\n【冬兽聚2024！】2024年12月20-22日\n第五年！上海·夏阳湖皇冠假日酒店！共计三天两夜！\n\n★★【新上线日夜通票！套票内含高能派对通行证！】★★\n房间套票现在内含高能派对通行证！无需额外购买！\n更多票务详情请访问官网Furrychina.com 或查看长图！\n\n★【新上线户外野营！】★\n想尝试不一样的兽聚体验？来试试户外野营吧！*\n\n【申请中心现已开放！】\n摊位申请、舞台申请、户外野营申请现已开放！\n\n【摊位展商速览！】\n天邪鬼工作室、狛神本铺、MOFUMOFU、犇犇牛火锅店、FLUFFYLAND！\n更多摊位正在路上！\n\n【那些熟悉的活动们！】\n毛毛大合照、名片交友会\n商品贩售、舞台表演\n高能派对、CFCC集市\n茶话会、祈愿亭\n【还有更多活动正在筹备中！敬请期待！】\n\n更多详情请查看长图！\n\n*该项逃票票活动需要参加者拥有野营装备及经验\n----------------------\n2024.12.20-22 上海·冬兽聚\n官网：FurryChina.com \n购票页面：FurryChina.com \n冬兽聚官方交流群③：652214537\nX： @furrychina\nFacebook：@furrychina\n展会联络邮箱：contact@furrychina.com\n商务咨询邮箱：business@furrychina.com",
+      "slug": "2026-mar-wuhan-con",
+      "startDate": "2026-03-06T02:00:00.000Z",
+      "endDate": "2026-03-08T10:00:00.000Z",
+      "address": "天河机场皇冠假日及假日酒店",
+      "region": "武汉",
+      "thumbnail": "https://images.furrycons.cn/organizations/wumeng/2026-mar-wuhan-con/cover-TkBWL2OJkeFPd5A0xWbt4.png",
+      "detail": "\n✈️准备好了吗？让我们一起乘风启航！✈️\n从「武萌汇」的温暖回忆，到「毛了个毛」的全新启程—— \n以毛相聚，以热爱为翼，共赴一场崭新的旅程！\n\n⏰活动时间：2026.3.6-3.8⏰\n📍活动地点：武汉天河机场皇冠假日及假日酒店📍\n\n🔶展会信息丨❤️嘉宾信息丨✏️签绘画师丨💳展商信息丨🎫票务情报 公布中～\n\n🏠酒店房间套票全新升级！基础通行证、赞助通行证可自由搭配各房型，灵活组合由你选择～\n🎫开票时间：2026年1月11日20:00🎫\n\n📖Staff、舞台、摊位、官方摄影师、签绘画师、毛毛大讲堂以及工作室合照申请表单填写现已开放。毛毛已经准备好啦，在这里等你！\n\n官方交流群：784051168\n\n联系邮箱：contact@fur-fur.cn\n\n🎊毛毛在这里祝大家周末快乐，三月我们不见不散！🎊",
       "organization": {
-        "name": "极兽聚",
-        "slug": "furrychina",
-        "coverUrl": "https://images.furrycons.cn/organizations/furrychina/logo.svg",
-        "globalUrl": "https://www.furryeventchina.com/furrychina",
-        "cnUrl": "https://www.furrycons.cn/furrychina"
+        "name": "毛了个毛FurFurFusion",
+        "slug": "wumeng",
+        "logoUrl": "https://images.furrycons.cn/organizations/wumeng/logo-pg0G5WXzFfCOhFRG3ZQtU.png",
+        "url": "https://www.furrycons.cn/wumeng"
       },
-      "globalUrl": "https://www.furryeventchina.com/furrychina/2024-dec-shanghai-con",
-      "cnUrl": "https://www.furrycons.cn/furrychina/2024-dec-shanghai-con"
+      "url": "https://www.furrycons.cn/wumeng/2026-mar-wuhan-con"
     }
   ]
 }

docs/api/event/recent_old.md

@@ -0,0 +1,64 @@
+# 最近展会-已废弃
+
+:::warning
+
+此接口属于遗留接口，不推荐在新业务中使用，可能随时发生中断且不会收到维护通知。
+
+此接口已不会再添加任何新字段。
+
+请使用[【新】最近展会](/docs/api/event/recent) 或 [展会列表](/docs/api/event/list) 接口替代。
+
+:::
+
+:::info
+
+无需携带鉴权信息。
+
+:::
+
+:::tip
+
+接口返回的图片地址已经经过优化压缩，且默认返回 jpg 格式，尽管如此部分图片的体积依然十分恐怖，请根据自身需求缓存后裁剪并优化体积（有的展会宣传图单张体积可超过 10MB+）。
+
+:::
+
+调用此接口可以获取最近 30 天内的展会信息。
+
+支持以下参数：
+
+- `keep_old`：当此值为 `true` 时，如果最近 30 天内没有数据，会返回过期的最后一条数据。
+
+```
+https://api.furrycons.cn/event/recent
+```
+
+预计响应：
+
+```json
+{
+  "total": 1,
+  "data": [
+    {
+      "name": "冬兽聚2024",
+      "scale": "medium",
+      "status": "scheduled",
+      "slug": "2024-dec-shanghai-con",
+      "startDate": "2024-12-20T02:00:00.677Z",
+      "endDate": "2024-12-22T10:00:00.816Z",
+      "address": "夏阳湖皇冠假日酒店",
+      "city": "上海",
+      "coverUrl": "https://images.furrycons.cn/organizations/furrychina/2024-dec-shanghai-con/cover-lMiuOMbUlUsqmiiOTpWpG.png",
+      "detail": "将它们化作璀璨星辰，让我在下雨之际看见我的玫瑰。\n关注并转发BILIBILI动态，抽一名小伙伴送出【冬兽聚2024】入场票1张~\n【11月9日19点正式开售！】\n购票&酒店预订：官网FurryChina.com\n\n【冬兽聚2024！】2024年12月20-22日\n第五年！上海·夏阳湖皇冠假日酒店！共计三天两夜！\n\n★★【新上线日夜通票！套票内含高能派对通行证！】★★\n房间套票现在内含高能派对通行证！无需额外购买！\n更多票务详情请访问官网Furrychina.com 或查看长图！\n\n★【新上线户外野营！】★\n想尝试不一样的兽聚体验？来试试户外野营吧！*\n\n【申请中心现已开放！】\n摊位申请、舞台申请、户外野营申请现已开放！\n\n【摊位展商速览！】\n天邪鬼工作室、狛神本铺、MOFUMOFU、犇犇牛火锅店、FLUFFYLAND！\n更多摊位正在路上！\n\n【那些熟悉的活动们！】\n毛毛大合照、名片交友会\n商品贩售、舞台表演\n高能派对、CFCC集市\n茶话会、祈愿亭\n【还有更多活动正在筹备中！敬请期待！】\n\n更多详情请查看长图！\n\n*该项逃票票活动需要参加者拥有野营装备及经验\n----------------------\n2024.12.20-22 上海·冬兽聚\n官网：FurryChina.com \n购票页面：FurryChina.com \n冬兽聚官方交流群③：652214537\nX： @furrychina\nFacebook：@furrychina\n展会联络邮箱：contact@furrychina.com\n商务咨询邮箱：business@furrychina.com",
+      "organization": {
+        "name": "极兽聚",
+        "slug": "furrychina",
+        "coverUrl": "https://images.furrycons.cn/organizations/furrychina/logo.svg",
+        "globalUrl": "https://www.furryeventchina.com/furrychina",
+        "cnUrl": "https://www.furrycons.cn/furrychina"
+      },
+      "globalUrl": "https://www.furryeventchina.com/furrychina/2024-dec-shanghai-con",
+      "cnUrl": "https://www.furrycons.cn/furrychina/2024-dec-shanghai-con"
+    }
+  ]
+}
+```

docs/intro.md

@@ -4,14 +4,32 @@ sidebar_position: 1
 
 # 快速开始
 
-我们当前只支持极少数接口，如有接口调用方面的问题，请进入群聊反馈。
+## 接口地址
 
-:::tip
+所有接口地址均为
 
-接口返回的图片地址是实际原图，请根据需求裁剪并优化体积（有的展会宣传图单张体积可超过 5MB+）。
+```
+https://api.furrycons.cn/open
+```
 
-:::
+## 鉴权
 
-## 展会
+在调用需要鉴权的接口时，需要在请求头中添加 `Authorization` 字段，值为 `<token>`。
 
-### [最近举行](/docs/api/event/recent)
+token 获取方式为注册 [兽展日历-工作台](https://dashboard.furrycons.cn) 后，在应用中心页面创建应用后查看 API Key。
+
+## 当前开放的接口
+
+我们目前开放了以下接口，如果您在开发中有更多的需求，欢迎进群戳我～
+
+### 展会相关
+
+#### [最近举行](/docs/api/event/recent)
+
+#### [展会列表](/docs/api/event/list)
+
+#### [展会详情](/docs/api/event/detail)
+
+## 友情提示
+
+我们的接口仍然处于积极开发中，可能会在不通知的情况下 新增/修改/删除 接口中的字段。

src/css/custom.css

@@ -6,13 +6,13 @@
 
 /* You can override the default Infima variables here. */
 :root {
-  --ifm-color-primary: #2e8555;
-  --ifm-color-primary-dark: #29784c;
-  --ifm-color-primary-darker: #277148;
-  --ifm-color-primary-darkest: #205d3b;
-  --ifm-color-primary-light: #33925d;
-  --ifm-color-primary-lighter: #359962;
-  --ifm-color-primary-lightest: #3cad6e;
+  --ifm-color-primary: #f87171;
+  --ifm-color-primary-dark: #f64f4f;
+  --ifm-color-primary-darker: #f53d3d;
+  --ifm-color-primary-darkest: #f10c0c;
+  --ifm-color-primary-light: #fa9393;
+  --ifm-color-primary-lighter: #fba5a5;
+  --ifm-color-primary-lightest: #fdd8d8;
   --ifm-code-font-size: 95%;
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
   --primary-color: #f87171;