@mison/ling 1.0.0

package/.agents/scripts/verify_all.py

@@ -0,0 +1,327 @@
+#!/usr/bin/env python3
+"""
+Full Verification Suite - Antigravity Kit
+==========================================
+
+Runs COMPLETE validation including all checks + performance + E2E.
+Use this before deployment or major releases.
+
+Usage:
+    python scripts/verify_all.py . --url <URL>
+
+Includes ALL checks:
+    [OK]  Security Scan (OWASP, secrets, dependencies)
+    [OK]  Lint & Type Coverage
+    [OK]  Schema Validation
+    [OK]  Test Suite (unit + integration)
+    [OK]  UX Audit (psychology, accessibility)
+    [OK]  SEO Check
+    [OK]  Lighthouse (Core Web Vitals)
+    [OK]  Playwright E2E
+    [OK]  Bundle Analysis (if applicable)
+    [OK]  Mobile Audit (if applicable)
+"""
+
+import sys
+import subprocess
+import argparse
+from pathlib import Path
+from typing import List, Dict, Optional
+from datetime import datetime
+
+# ANSI colors
+class Colors:
+    HEADER = '\033[95m'
+    BLUE = '\033[94m'
+    CYAN = '\033[96m'
+    GREEN = '\033[92m'
+    YELLOW = '\033[93m'
+    RED = '\033[91m'
+    ENDC = '\033[0m'
+    BOLD = '\033[1m'
+
+def print_header(text: str):
+    print(f"\n{Colors.BOLD}{Colors.CYAN}{'='*70}{Colors.ENDC}")
+    print(f"{Colors.BOLD}{Colors.CYAN}{text.center(70)}{Colors.ENDC}")
+    print(f"{Colors.BOLD}{Colors.CYAN}{'='*70}{Colors.ENDC}\n")
+
+def print_step(text: str):
+    print(f"{Colors.BOLD}{Colors.BLUE}[RUN]  {text}{Colors.ENDC}")
+
+def print_success(text: str):
+    print(f"{Colors.GREEN}[OK]  {text}{Colors.ENDC}")
+
+def print_warning(text: str):
+    print(f"{Colors.YELLOW}[WARN]   {text}{Colors.ENDC}")
+
+def print_error(text: str):
+    print(f"{Colors.RED}[FAIL]  {text}{Colors.ENDC}")
+
+# Complete verification suite
+VERIFICATION_SUITE = [
+    # P0: Security (CRITICAL)
+    {
+        "category": "Security",
+        "checks": [
+            ("Security Scan", ".agent/skills/vulnerability-scanner/scripts/security_scan.py", True),
+            ("Dependency Analysis", ".agent/skills/vulnerability-scanner/scripts/dependency_analyzer.py", False),
+        ]
+    },
+    
+    # P1: Code Quality (CRITICAL)
+    {
+        "category": "Code Quality",
+        "checks": [
+            ("Lint Check", ".agent/skills/lint-and-validate/scripts/lint_runner.py", True),
+            ("Type Coverage", ".agent/skills/lint-and-validate/scripts/type_coverage.py", False),
+        ]
+    },
+    
+    # P2: Data Layer
+    {
+        "category": "Data Layer",
+        "checks": [
+            ("Schema Validation", ".agent/skills/database-design/scripts/schema_validator.py", False),
+        ]
+    },
+    
+    # P3: Testing
+    {
+        "category": "Testing",
+        "checks": [
+            ("Test Suite", ".agent/skills/testing-patterns/scripts/test_runner.py", False),
+        ]
+    },
+    
+    # P4: UX & Accessibility
+    {
+        "category": "UX & Accessibility",
+        "checks": [
+            ("UX Audit", ".agent/skills/frontend-design/scripts/ux_audit.py", False),
+            ("Accessibility Check", ".agent/skills/frontend-design/scripts/accessibility_checker.py", False),
+        ]
+    },
+    
+    # P5: SEO & Content
+    {
+        "category": "SEO & Content",
+        "checks": [
+            ("SEO Check", ".agent/skills/seo-fundamentals/scripts/seo_checker.py", False),
+            ("GEO Check", ".agent/skills/geo-fundamentals/scripts/geo_checker.py", False),
+        ]
+    },
+    
+    # P6: Performance (requires URL)
+    {
+        "category": "Performance",
+        "requires_url": True,
+        "checks": [
+            ("Lighthouse Audit", ".agent/skills/performance-profiling/scripts/lighthouse_audit.py", True),
+            ("Bundle Analysis", ".agent/skills/performance-profiling/scripts/bundle_analyzer.py", False),
+        ]
+    },
+    
+    # P7: E2E Testing (requires URL)
+    {
+        "category": "E2E Testing",
+        "requires_url": True,
+        "checks": [
+            ("Playwright E2E", ".agent/skills/webapp-testing/scripts/playwright_runner.py", False),
+        ]
+    },
+    
+    # P8: Mobile (if applicable)
+    {
+        "category": "Mobile",
+        "checks": [
+            ("Mobile Audit", ".agent/skills/mobile-design/scripts/mobile_audit.py", False),
+        ]
+    },
+    
+    # P9: Internationalization
+    {
+        "category": "Internationalization",
+        "checks": [
+            ("i18n Check", ".agent/skills/i18n-localization/scripts/i18n_checker.py", False),
+        ]
+    },
+]
+
+def run_script(name: str, script_path: Path, project_path: str, url: Optional[str] = None) -> dict:
+    """Run validation script"""
+    if not script_path.exists():
+        print_warning(f"{name}: Script not found, skipping")
+        return {"name": name, "passed": True, "skipped": True, "duration": 0}
+    
+    print_step(f"Running: {name}")
+    start_time = datetime.now()
+    
+    # Build command
+    cmd = ["python", str(script_path), project_path]
+    if url and ("lighthouse" in script_path.name.lower() or "playwright" in script_path.name.lower()):
+        cmd.append(url)
+    
+    # Run
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=600  # 10 minute timeout for slow checks
+        )
+        
+        duration = (datetime.now() - start_time).total_seconds()
+        passed = result.returncode == 0
+        
+        if passed:
+            print_success(f"{name}: PASSED ({duration:.1f}s)")
+        else:
+            print_error(f"{name}: FAILED ({duration:.1f}s)")
+            if result.stderr:
+                print(f"  {result.stderr[:300]}")
+        
+        return {
+            "name": name,
+            "passed": passed,
+            "output": result.stdout,
+            "error": result.stderr,
+            "skipped": False,
+            "duration": duration
+        }
+    
+    except subprocess.TimeoutExpired:
+        duration = (datetime.now() - start_time).total_seconds()
+        print_error(f"{name}: TIMEOUT (>{duration:.0f}s)")
+        return {"name": name, "passed": False, "skipped": False, "duration": duration, "error": "Timeout"}
+    
+    except Exception as e:
+        duration = (datetime.now() - start_time).total_seconds()
+        print_error(f"{name}: ERROR - {str(e)}")
+        return {"name": name, "passed": False, "skipped": False, "duration": duration, "error": str(e)}
+
+def print_final_report(results: List[dict], start_time: datetime):
+    """Print comprehensive final report"""
+    total_duration = (datetime.now() - start_time).total_seconds()
+    
+    print_header(" FULL VERIFICATION REPORT")
+    
+    # Statistics
+    total = len(results)
+    passed = sum(1 for r in results if r["passed"] and not r.get("skipped"))
+    failed = sum(1 for r in results if not r["passed"] and not r.get("skipped"))
+    skipped = sum(1 for r in results if r.get("skipped"))
+    
+    print(f"Total Duration: {total_duration:.1f}s")
+    print(f"Total Checks: {total}")
+    print(f"{Colors.GREEN}[OK]  Passed: {passed}{Colors.ENDC}")
+    print(f"{Colors.RED}[FAIL]  Failed: {failed}{Colors.ENDC}")
+    print(f"{Colors.YELLOW}[SKIP]   Skipped: {skipped}{Colors.ENDC}")
+    print()
+    
+    # Category breakdown
+    print(f"{Colors.BOLD}Results by Category:{Colors.ENDC}")
+    current_category = None
+    for r in results:
+        # Print category header if changed
+        if r.get("category") and r["category"] != current_category:
+            current_category = r["category"]
+            print(f"\n{Colors.BOLD}{Colors.CYAN}{current_category}:{Colors.ENDC}")
+        
+        # Print result
+        if r.get("skipped"):
+            status = f"{Colors.YELLOW}[SKIP]  {Colors.ENDC}"
+        elif r["passed"]:
+            status = f"{Colors.GREEN}[OK] {Colors.ENDC}"
+        else:
+            status = f"{Colors.RED}[FAIL] {Colors.ENDC}"
+        
+        duration_str = f"({r.get('duration', 0):.1f}s)" if not r.get("skipped") else ""
+        print(f"  {status} {r['name']} {duration_str}")
+    
+    print()
+    
+    # Failed checks detail
+    if failed > 0:
+        print(f"{Colors.BOLD}{Colors.RED}[FAIL]  FAILED CHECKS:{Colors.ENDC}")
+        for r in results:
+            if not r["passed"] and not r.get("skipped"):
+                print(f"\n{Colors.RED}X {r['name']}{Colors.ENDC}")
+                if r.get("error"):
+                    error_preview = r["error"][:200]
+                    print(f"  Error: {error_preview}")
+        print()
+    
+    # Final verdict
+    if failed > 0:
+        print_error(f"VERIFICATION FAILED - {failed} check(s) need attention")
+        print(f"\n{Colors.YELLOW}TIP:  Tip: Fix critical (security, lint) issues first{Colors.ENDC}")
+        return False
+    else:
+        print_success(" ALL CHECKS PASSED - Ready for deployment! ")
+        return True
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Run complete Antigravity Kit verification suite",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python scripts/verify_all.py . --url http://localhost:3000
+  python scripts/verify_all.py . --url https://staging.example.com --no-e2e
+        """
+    )
+    parser.add_argument("project", help="Project path to validate")
+    parser.add_argument("--url", required=True, help="URL for performance & E2E checks")
+    parser.add_argument("--no-e2e", action="store_true", help="Skip E2E tests")
+    parser.add_argument("--stop-on-fail", action="store_true", help="Stop on first failure")
+    
+    args = parser.parse_args()
+    
+    project_path = Path(args.project).resolve()
+    
+    if not project_path.exists():
+        print_error(f"Project path does not exist: {project_path}")
+        sys.exit(1)
+    
+    print_header(" ANTIGRAVITY KIT - FULL VERIFICATION SUITE")
+    print(f"Project: {project_path}")
+    print(f"URL: {args.url}")
+    print(f"Started: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    
+    start_time = datetime.now()
+    results = []
+    
+    # Run all verification categories
+    for suite in VERIFICATION_SUITE:
+        category = suite["category"]
+        requires_url = suite.get("requires_url", False)
+        
+        # Skip if requires URL and not provided
+        if requires_url and not args.url:
+            continue
+        
+        # Skip E2E if flag set
+        if args.no_e2e and category == "E2E Testing":
+            continue
+        
+        print_header(f" {category.upper()}")
+        
+        for name, script_path, required in suite["checks"]:
+            script = project_path / script_path
+            result = run_script(name, script, str(project_path), args.url)
+            result["category"] = category
+            results.append(result)
+            
+            # Stop on critical failure if flag set
+            if args.stop_on_fail and required and not result["passed"] and not result.get("skipped"):
+                print_error(f"CRITICAL: {name} failed. Stopping verification.")
+                print_final_report(results, start_time)
+                sys.exit(1)
+    
+    # Print final report
+    all_passed = print_final_report(results, start_time)
+    
+    sys.exit(0 if all_passed else 1)
+
+if __name__ == "__main__":
+    main()

package/.agents/skills/api-patterns/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: api-patterns
+description: API design principles and decision-making（API 设计原则与决策逻辑）。REST vs GraphQL vs tRPC selection（选择）、response formats（响应格式）、versioning（版本控制）、pagination（分页）。
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# API Patterns（API 模式）
+
+> API design principles and decision-making for 2025（2025 年 API 设计原则与决策逻辑）。
+> **Learn to THINK, not copy fixed patterns（学习如何思考，而非机械复制固定模式）。**
+
+##  选择性阅读规则（Selective Reading Rule）
+
+**仅阅读与当前请求相关的文件（Read ONLY files relevant to the request）！** 查阅内容地图并定位所需章节（Check the content map, find what you need）。
+
+---
+
+##  内容地图（Content Map）
+
+| File（文件） | Description（描述） | When to Read（阅读时机） |
+| ---- | ---- | -------- |
+| `api-style.md` | REST vs GraphQL vs tRPC decision tree（决策树） | Choosing API type（选择 API 类型时） |
+| `rest.md` | Resource naming, HTTP methods, status codes（资源命名/HTTP 方法/状态码） | Designing REST API（设计 REST API 时） |
+| `response.md` | Envelope pattern, error format, pagination（信封模式/错误格式/分页） | Response structure（确定响应结构时） |
+| `graphql.md` | Schema design, when to use, security（模式设计/使用场景/安全性） | Considering GraphQL（考虑 GraphQL 时） |
+| `trpc.md` | TypeScript monorepo, type safety（TS 单仓/类型安全） | TS fullstack projects（TS 全栈项目） |
+| `versioning.md` | URI/Header/Query versioning（URI/请求头/查询参数版本控制） | API evolution planning（规划 API 演进） |
+| `auth.md` | JWT, OAuth, Passkey, API Keys（认证方案） | Auth pattern selection（选择认证模式） |
+| `rate-limiting.md` | Token bucket, sliding window（令牌桶/滑动窗口） | API protection（API 保护机制） |
+| `documentation.md` | OpenAPI/Swagger best practices（文档规范） | Documentation（编写 API 文档） |
+| `security-testing.md` | OWASP API Top 10, auth/authz testing（认证/授权测试） | Security audits（安全审计） |
+
+---
+
+##  相关技能（Related Skills）
+
+| Need（需求） | Skill（技能） |
+| ---- | ------------ |
+| API implementation（API 落地实现） | `@[skills/nodejs-best-practices]` |
+| Data structure（数据库结构设计） | `@[skills/database-design]` |
+| Security details（安全加固细节） | `@[skills/vulnerability-scanner]` |
+
+---
+
+## [OK]  决策检查清单（Decision Checklist）
+
+设计 API 之前（Before designing an API）：
+
+- [ ] **Asked user about API consumers?（是否询问 API 消费者？）**
+- [ ] **Chosen API style for THIS context?（是否为当前上下文选择 API 风格？）** (REST/GraphQL/tRPC)
+- [ ] **Defined consistent response format?（是否定义统一响应格式？）**
+- [ ] **Planned versioning strategy?（是否规划版本控制策略？）**
+- [ ] **Considered authentication needs?（是否考虑认证需求？）**
+- [ ] **Planned rate limiting?（是否规划频率限制？）**
+- [ ] **Documentation approach defined?（是否定义文档方案？）**
+
+---
+
+## [FAIL]  反模式（Anti-Patterns）
+
+**不要（DON'T）：**
+
+- 任何场景都默认 REST（Default to REST for everything）。
+- REST 端点使用动词，如 `/getUsers`（Use verbs in REST endpoints）。
+- 响应格式不一致（Return inconsistent response formats）。
+- 向客户端暴露内部错误（Expose internal errors to clients）。
+- 忽略频率限制（Skip rate limiting）。
+
+**推荐做法（DO）：**
+
+- 根据上下文选择 API 风格（Choose API style based on context）。
+- 先询问客户端需求（Ask about client requirements）。
+- 编写详尽文档（Document thoroughly）。
+- 使用合适的 HTTP 状态码（Use appropriate status codes）。
+
+---
+
+## 运行脚本（Script）
+
+| Script（脚本） | Purpose（用途） | Command（命令） |
+| ---- | ---- | ---- |
+| `scripts/api_validator.py` | API endpoint validation（API 端点校验） | `python scripts/api_validator.py <project_path>`（项目路径） |
+
+---

package/.agents/skills/api-patterns/api-style.md

@@ -0,0 +1,42 @@
+# API 风格选择（2025）
+
+> REST vs GraphQL vs tRPC —— 在什么情况下选择哪种？
+
+## 决策树
+
+```
+谁是 API 消费者？
+|
++-- 公共 API / 多平台支持
+|   +-- REST + OpenAPI（接口规范，最广泛的兼容性）
+|
++-- 数据需求复杂 / 多个前端
+|   +-- GraphQL（灵活的查询）
+|
++-- TypeScript（TS）前端 + 后端（monorepo，单仓）
+|   +-- tRPC（端到端类型安全）
+|
++-- 实时性 / 事件驱动
+|   +-- WebSocket + AsyncAPI（异步 API 规范）
+|
++-- 内部微服务
+    +-- gRPC（追求性能）或 REST（追求简单）
+```
+
+## 对比
+
+| 因素 | REST | GraphQL | tRPC |
+| :--- | :--- | :------ | :--- |
+| **最佳适用** | 公共 API | 复杂应用 | TS monorepos（TypeScript 单仓） |
+| **学习曲线** | 低 | 中 | 低（如果是 TS 用户） |
+| **过度/不足获取** | 常见（over/under fetching） | 已解决 | 已解决 |
+| **类型安全** | 手动（OpenAPI） | 基于 Schema（模式） | 自动 |
+| **缓存** | HTTP 原生支持 | 复杂 | 基于客户端 |
+
+## 选择问题
+
+1. 谁是 API 消费者？
+2. 前端是 TypeScript（TS）吗？
+3. 数据关系有多复杂？
+4. 缓存是否至关重要？
+5. 是公共 API 还是内部 API？

package/.agents/skills/api-patterns/auth.md

@@ -0,0 +1,24 @@
+# 认证模式
+
+> 根据用例选择认证模式。
+
+## 选择指南
+
+| 模式 | 最佳适用场景 |
+| :--- | :----------- |
+| **JWT（JSON Web Token）** | 无状态、微服务架构 |
+| **Session（会话）** | 传统 Web 应用、简单场景 |
+| **OAuth 2.0（授权协议）** | 第三方集成 |
+| **API Keys（API 密钥）** | 服务器间通信、公共 API |
+| **Passkey（通行密钥）** | 现代无密码认证（2025+） |
+
+## JWT（JSON Web Token）原则
+
+```
+重要事项:
++-- 始终验证签名
++-- 检查过期时间
++-- 仅包含最小必要的声明（Claims）
++-- 使用短过期时间 + 刷新令牌（Refresh tokens）
++-- 绝不在 JWT 中存储敏感数据
+```

package/.agents/skills/api-patterns/documentation.md

@@ -0,0 +1,26 @@
+# API 文档编写原则
+
+> 好的文档 = 快乐的开发者 = API 被广泛采用。
+
+## OpenAPI/Swagger 精要
+
+```
+应包含:
++-- 所有端点（Endpoints）及其示例
++-- 请求/响应 Schema（模式）
++-- 认证要求
++-- 错误响应格式
++-- 速率限制信息
+```
+
+## 优质文档包含
+
+```
+核心要素:
++-- 快速开始 / 入门指南
++-- 认证指南
++-- 完整的 API 参考手册
++-- 错误处理指南
++-- 代码示例（多种语言）
++-- 更新日志（Changelog）
+```

package/.agents/skills/api-patterns/graphql.md

@@ -0,0 +1,41 @@
+# GraphQL（图查询语言）原则
+
+> 为复杂、互联的数据提供灵活的查询。
+
+## 何时使用
+
+```
+[OK]  适用场景:
++-- 数据关系复杂且互相连接
++-- 有多个前端平台
++-- 客户端需要灵活的查询
++-- 数据需求在不断演进
++-- 减少“过度获取（over-fetching）”非常重要
+
+[FAIL]  不适用场景:
++-- 简单的 CRUD（增删改查）操作
++-- 包含大量的文件上传
++-- HTTP（超文本传输协议）级缓存非常重要
++-- 团队对 GraphQL（图查询语言）不熟悉
+```
+
+## Schema（模式）设计原则
+
+```
+设计原则:
++-- 以图（Graph）的方式思考，而不是端点（Endpoints）
++-- 设计要有可演进性（通常无版本号）
++-- 使用 Connections（连接）模式进行分页
++-- 类型定义要具体（不要使用通用的 "data"）
++-- 深思熟虑地处理空值（Nullability）
+```
+
+## 安全考量
+
+```
+防范措施:
++-- 查询深度攻击（Query depth attacks） -> 设置最大深度
++-- 查询复杂度（Query complexity） -> 计算查询成本
++-- 批量滥用（Batching abuse） -> 限制批量大小
++-- 内省（Introspection） -> 生产环境禁用
+```

package/.agents/skills/api-patterns/rate-limiting.md

@@ -0,0 +1,31 @@
+# 限流原则
+
+> 保护你的 API（接口）免受滥用和过载。
+
+## 为什么要限流
+
+```
+防范措施:
++-- 暴力破解攻击
++-- 资源耗尽
++-- 成本超支（如果是按量计费）
++-- 不公平的使用
+```
+
+## 策略选择
+
+| 类型 | 机制 | 适用场景 |
+| :--- | :--- | :------- |
+| **令牌桶（Token bucket）** | 允许突发流量，随时间填充 | 大多数 API |
+| **滑动窗口（Sliding window）** | 平滑分布 | 严格限制 |
+| **固定窗口（Fixed window）** | 每个窗口的简单计数器 | 基本需求 |
+
+## 响应头
+
+```
+要在响应头中包含:
++-- X-RateLimit-Limit（最大请求数）
++-- X-RateLimit-Remaining（剩余请求数）
++-- X-RateLimit-Reset（重置时间）
++-- 超出限制时返回 429
+```

package/.agents/skills/api-patterns/response.md

@@ -0,0 +1,37 @@
+# 响应格式原则
+
+> 一致性是关键——选择一种格式并坚持使用。
+
+## 常见模式
+
+```
+请选择一种:
++-- 信封模式（Envelope pattern）: { success, data, error }
++-- 直接返回数据（Direct data）: 仅返回资源内容
++-- HAL/JSON:API（超媒体模式）
+```
+
+## 错误响应
+
+```
+应包含:
++-- 错误代码（Error code）: 用于程序化处理
++-- 用户消息（User message）: 用于界面显示
++-- 详细信息（Details）: 用于调试、字段级错误
++-- 请求 ID（Request ID）: 用于支持查询
++-- 绝不包含内部实现细节（安全隐患）
+```
+
+## 分页类型
+
+| 类型 | 最佳适用场景 | 权衡 |
+| :--- | :----------- | :---------------- |
+| **Offset（偏移量）** | 简单，支持跳转页码 | 大数据集性能差 |
+| **Cursor（游标）** | 大数据集，无限滚动 | 无法跳转特定页 |
+| **Keyset（键集）** | 性能至关重要 | 需要可排序的键 |
+
+### 选择问题
+
+1. 数据集有多大？
+2. 用户需要跳转到特定页面吗？
+3. 数据是否频繁变化？

package/.agents/skills/api-patterns/rest.md

@@ -0,0 +1,40 @@
+# REST（表述性状态转移）原则
+
+> 基于资源的 API（接口）设计——使用名词而非动词。
+
+## 资源命名规则
+
+```
+设计原则:
++-- 使用名词，而非动词（资源，而非动作）
++-- 使用复数形式（/users 而不是 /user）
++-- 使用小写，连字符分隔（/user-profiles）
++-- 使用嵌套表示关系（/users/123/posts）
++-- 保持浅层嵌套（建议最多 3 层）
+```
+
+## HTTP（超文本传输协议）方法选择
+
+| 方法 | 目的 | 是否幂等（Idempotent）？ | 是否包含请求体（Body）？ |
+| :--- | :--- | :--------- | :----------------------- |
+| **GET** | 读取资源 | 是 | 否 |
+| **POST** | 创建新资源 | 否 | 是 |
+| **PUT** | 替换整个资源 | 是 | 是 |
+| **PATCH** | 部分更新资源 | 否 | 是 |
+| **DELETE** | 删除资源 | 是 | 否 |
+
+## 状态码选择
+
+| 场景 | 代码 | 原因 |
+| :--- | :--- | :--- |
+| 成功（读取） | 200 | 标准成功响应 |
+| 已创建 | 201 | 新资源已创建 |
+| 无内容 | 204 | 操作成功，无需返回内容 |
+| 错误请求 | 400 | 请求格式错误 |
+| 未授权 | 401 | 缺少认证信息或无效 |
+| 禁止访问 | 403 | 认证有效，但无权限 |
+| 未找到 | 404 | 资源不存在 |
+| 冲突 | 409 | 状态冲突（如重复资源） |
+| 验证错误 | 422 | 语法正确，但数据无效 |
+| 速率限制 | 429 | 请求过多 |
+| 服务器错误 | 500 | 服务器内部错误 |