# 技术需求

**我是卡若。**

我不懂什么高深算法，我只知道：**用户体验差，流量就跑了。**

所以，技术指标必须服务于业务目标。

## 1. 核心技术指标 (KPI)

-   **首屏加载时间 (FCP)**: **< 1.5秒**。
    -   *原因*: 现在的用户没耐心，慢一秒流失 20%。
    -   *手段*: Next.js SSR, 图片懒加载, 骨架屏。
-   **SEO (搜索引擎优化)**: **必须收录**。
    -   *原因*: 被动流量最香。
    -   *手段*: 语义化 HTML, 动态 Meta 标签, Sitemap 自动生成。
-   **移动端适配**: **100% 完美**。
    -   *原因*: 99% 的流量来自手机（微信、抖音）。
    -   *手段*: Tailwind CSS 移动端优先 (Mobile First) 写法。

## 2. 开发环境规范

-   **OS**: macOS (我的主力机)。
-   **Node 版本**: >= 18.0.0 (LTS)。
-   **包管理**: `pnpm` (省磁盘，安装快)。
-   **Git流**:
    -   `main`: 生产环境（只接受 PR）。
    -   `dev`: 开发环境。
    -   `feature/*`: 功能分支。

## 3. 部署流水线 (CI/CD)

我要的是**全自动化**。我写完文章，按个 `Ctrl+S`，剩下的事情机器帮我干。

1.  **触发**: 本地 `autosync.sh` 检测到 Markdown 变化 -> Push 到 GitHub。
2.  **构建**: GitHub Webhook 通知 Vercel/宝塔。
3.  **部署**: Vercel 自动 Build -> 发布上线。
4.  **通知**: 给我微信发个消息“新文章已上线”。

## 4. 安全需求

-   **防爬虫**: 虽然我们是公开内容，但别被竞品一秒钟全扒走了。加个简单的 Rate Limit。
-   **接口鉴权**: 管理员接口（如生成文档）必须校验 Token。

---
**卡若说：**
技术不用最牛的，要用最稳的。把地基打牢，楼才能盖高。
