CSS

使用 HTML5、CSS3 和 JavaScript 构建一个交互式打字速度测试。创建包含文本显示和输入区域的简洁界面。实时实现 WPM 和准确率计算。添加难度等级，并配备合适的文本选择。包含错误高亮显示和更正跟踪。实现测试历史记录，并配有性能图表。添加自定义测试创建功能，支持文本导入。包含显示按键的虚拟键盘展示。支持多种语言和键盘布局。创建适用于所有设备的响应式设计。添加带排行榜的竞赛模式。

使用 HTML5、CSS3 和 JavaScript 开发一个记忆配对卡牌游戏。创建具有翻牌动画的精美卡牌设计。实现不同网格大小和卡牌数量的难度等级。添加计时器和步数计数器用于计分。包含翻牌和配对成功的音效。实现带分数持久化的排行榜。添加主题选择，提供不同的卡牌设计。包含多人模式以支持竞技对战。创建能自适应屏幕尺寸的响应式布局。添加键盘导航等无障碍功能。实现游戏过程中的渐进式难度提升。

使用 Three.js 和 JavaScript 创建一款刺激的 3D 赛车游戏。实现逼真的车辆物理，包括悬挂、轮胎摩擦和空气动力学。创建精细的赛车模型，支持自定义涂装和升级。设计多条赛道，地形和障碍物各不相同。添加难度等级和竞速行为各异的 AI 对手。实现本地竞速的分屏多人模式。包含全面的 HUD，显示速度、圈速、名次和小地图。为轮胎烟雾、引擎效果和天气创建粒子效果。添加带逼真光照的动态昼夜循环。实现计时赛、锦标赛和淘汰赛等竞赛模式。包含支持多机位的录像系统。

使用 HTML5、CSS3 和 JavaScript 创建一个习惯追踪应用。构建简洁的界面，提供每日、每周和每月视图。实现习惯创建，支持频率、提醒和目标设置。添加连续打卡追踪，配以可视化指示和里程碑庆祝。包含详细的统计数据和进度图表。支持习惯分类和标签以便整理。实现日历集成以安排日程。添加数据可视化，展示模式和趋势。创建适配所有设备的响应式设计。包含数据导出和备份功能。添加带有成就和奖励的游戏化元素。

使用 Three.js 和 JavaScript 开发一款第一人称射击游戏。创建精细的武器模型，配备逼真的动画和特效。实现精准的命中检测和伤害系统。设计多个游戏关卡，包含多样的环境和目标。添加具备寻路和战斗行为的 AI 敌人。为枪口闪光、命中和爆炸创建粒子效果。实现带团队目标的多人模式。包含武器拾取和背包系统。添加武器、脚步和环境的音效。创建详细的计分和统计追踪。实现用于击杀回放和比赛集锦的录像系统。

使用 Three.js 和 JavaScript 构建一款沉浸式 3D 太空探索游戏。创建一个广阔的宇宙，其中包含程序化生成的行星、恒星和星云。实现具有牛顿物理特性的逼真飞船操控。添加细节丰富的行星表面，包含地形生成和大气效果。创建用于贸易和任务的太空站与前哨基地。实现资源采集和货物管理系统。添加具有独特行为和互动方式的外星物种。创建星际之间的虫洞旅行效果。包含详细的飞船自定义和升级系统。实现挖矿和战斗机制，并带有武器特效。添加带有剧情元素和目标的 任务系统。

使用 HTML5 Canvas、CSS3 和 JavaScript 开发一个基于网页的图像编辑器。创建一个专业界面，包含工具面板和预览区域。实现基础调整功能，包括亮度、对比度、饱和度和锐度。添加滤镜，支持自定义参数和预览。包含裁剪和缩放，并支持宽高比控制。实现文字叠加，支持字体选择和样式设置。添加形状绘制工具，支持填充和描边选项。包含图层管理，并支持混合模式。支持以多种格式和质量导出图像。创建可自适应屏幕尺寸的响应式设计。添加撤销/重做功能，并保留历史状态。

使用 HTML5、CSS3 和 JavaScript 开发一个功能全面的交互式测验应用。创建一个有吸引力的 UI，并让题目之间的切换流畅自然。支持多种题型，包括单选题、判断题、配对题，以及可自动评分的简答题。为每道题实现可配置的计时器，并带有可视化的倒计时。添加详细的分数跟踪，根据难度和作答时间计算得分。显示动态进度条，指示完成百分比。包含回顾模式，可在测验结束后查看正确答案/错误答案及解析。使用 localStorage 实现持久化的排行榜。将题目按类别组织，并配以自定义图标和描述。支持多个难度等级，并影响计分规则和时间限制。生成详细的成绩摘要，包含表现分析和改进建议。添加结果社交分享功能，并支持自定义分享文案。

充当一名前端开发者。你的任务是为小米的自助管理系统创建前端。你的职责包括：

- 使用 HTML5、CSS3 和 JavaScript 设计用户友好的界面。
- 确保兼容各种设备和屏幕尺寸。
- 实现交互元素以增强用户参与度。
- 与后端服务集成，以动态获取并展示数据。
- 进行充分测试，以确保无缝的用户体验。

规则：
- 遵循小米的设计指南和品牌规范。
- 确保高性能和响应能力。
- 保持代码整洁且文档完善。

变量：
- Bootstrap - 要使用的 CSS 框架
- apiEndpoint - 后端 API 端点
- #FF6700 - 系统的主主题色

示例：
- 创建一个具有用户登录功能和数据可视化功能的仪表盘界面。

扮演一名前端开发者。你的任务是设计一个既现代又用户友好的侧边栏仪表盘界面。你的职责包括：

- 使用 HTML5 和 CSS3 创建响应式布局。
- 使用 JavaScript 实现交互元素，以支持动态内容更新。
- 确保侧边栏易于导航和访问，并为不同功能提供可折叠区域。
- 运用 UX/UI 设计的最佳实践来提升用户体验。

规则：
- 保持代码整洁有序。
- 确保跨浏览器兼容性。
- 针对移动端和桌面端视图进行优化。

扮演一名 Electron 前端开发者。你是使用 Electron 构建桌面应用的专家，专注于前端开发。

你的任务是：
- 设计并实现响应式且用户友好的用户界面。
- 利用 HTML、CSS 和 JavaScript 创建动态且可交互的组件。
- 集成 Electron API 以增强应用功能。

规则：
- 遵循前端架构的最佳实践。
- 确保在 Windows、macOS 和 Linux 上的跨平台兼容性。
- 优化性能并降低应用延迟。

使用 projectName、React 和 feature 等变量来自定义应用开发流程。

# App Store 截图画廊生成器

**为 iOS/macOS/Android 应用创建一个专业、可直接用于生产的截图画廊，看起来像是由顶尖 1% 的应用开发者设计的。**

## 背景

你正在为一个应用构建截图画廊页面。该项目在一个文件夹中存放了截图（通常是 `screenshots/`、`fastlane/screenshots/` 或类似目录）。画廊应为一个单独的 HTML 文件，可部署到 Netlify、Vercel 或任意静态托管平台。

## 要求

### 1. 设计系统基础

为以下内容创建 CSS 自定义属性（设计令牌）：

- **颜色**：主色调色板（50-900 色阶）、辅助/强调色调色板、中性灰（50-900）
- **表面**：三个表面层级（surface-1、surface-2、surface-3）
- **字体排印**：双字体栈（UI 元素使用等宽字体，正文使用无衬线字体）
- **间距**：一致的尺度（4px 基准）
- **边框**：圆角尺度（sm、md、lg、xl、2xl、3xl）
- **阴影**：五个高度层级（sm、md、lg、xl、2xl）
- **过渡**：三种速度（fast：150ms，normal：300ms，smooth：400ms 配合 cubic-bezier）

### 2. 布局架构

- **容器**：最大宽度 1600px，居中，带响应式内边距
- **网格**：使用 `grid-template-columns: repeat(auto-fill, minmax(340px, 1fr))` 的瀑布流式响应式网格
- **间距**：桌面端 2rem，平板 1.5rem，移动端 1rem
- **卡片宽高比**：保持一致的截图呈现

### 3. 头部区域

- **应用徽章**：带图标的小药丸形徽章，文字为“IOS APPLICATION”或平台名称
- **标题**：大号粗体应用名称，带渐变文字效果
- **副标题**：单行描述，提及关键技术和功能
- **背景**：细微网格图案叠加，营造深度
- **内边距**：缩减垂直内边距（顶部 3rem，底部 2rem），更紧凑

### 4. 截图卡片

每张卡片应包含：

- **容器**：白色/米白色背景，圆角（2xl），细微阴影
- **图片容器**：渐变背景，截图居中并带白色边框（8px）
- **悬停效果**：
  - 卡片上浮（translateY 位移 -8px），阴影增强
  - 截图缩放（1.04）并轻微旋转（0.5deg）
  - 顶部边框出现（渐变条）
  - 径向光晕叠加层淡入
- **元数据栏**：
  - 编号徽章（渐变背景，26px 方形）
  - 设备名称（大写、小字号、等宽字体）
- **标题**：粗体、等宽字体、1rem
- **描述**：单行说明文字、较小字号、细微颜色

### 5. 用户旅程排序

按用户使用应用的体验顺序排列截图：

1. **登录/引导** - 用户看到的第一个界面
2. **仪表盘/首页** - 登录后的主要着陆页
3. **主要功能视图** - 应用核心功能
4. **设置/配置** - 自定义界面
5. **权限/集成** - HealthKit、通知等
6. **高级功能** - 同步、分享、云功能
7. **分析/报告** - 数据可视化界面
8. **归档/历史** - 历史数据视图

### 6. 动画

- **入场**：错落的淡入配合 translateY 位移（卡片之间 0.1s 延迟）
- **悬停**：平滑的 cubic-bezier 缓动（0.16, 1, 0.3, 1）
- **滚动**：使用 IntersectionObserver 在卡片进入视口时触发动画
- **性能**：为 transform 和 opacity 使用 `will-change`

### 7. 页脚

- **背景**：深色（neutral-900）带细微渐变叠加
- **圆角**：仅顶部圆角（2xl）
- **内容**：带图标的最小元数据（设备、日期、状态）
- **间距**：紧凑（2rem 内边距）

### 8. 响应式断点

- **桌面**（>1280px）：4-5 列
- **平板**（768-1280px）：2-3 列
- **移动端**（<768px）：1 列，整体缩减内边距

### 9. 技术要求

- **单个 HTML 文件**：所有 CSS 内联在 `<style>` 标签中
- **仅外部依赖**：
  - Pico.css（极简 CSS 框架）
  - Font Awesome（图标）
  - Google Fonts（Inter + IBM Plex Mono）
  - Animate.css（可选，用于额外动画）
- **无构建步骤**：必须作为静态 HTML 直接运行
- **性能**：优化动画，无布局偏移
- **无障碍**：语义化 HTML，图片带 alt 文本

### 10. 打磨细节

- **细微渐变**：背景径向渐变营造深度（不过度）
- **边框处理**：1px 实线，带 alpha 透明度
- **阴影分层**：多个阴影值营造深度
- **字体排印**：标题使用紧凑字距（-0.03em）
- **颜色一致性**：处处使用设计令牌，不硬编码数值
- **图片呈现**：截图周围加白色边框，营造设备边框的错觉

## 输出格式

生成单个 `index.html` 文件，包含：

1. 完整的 HTML 结构
2. 带设计令牌的内联 CSS
3. 用于滚动动画的 JavaScript（IntersectionObserver）
4. 所有截图卡片及正确的元数据
5. 适配所有屏幕尺寸的响应式设计

## 截图卡片结构示例

```html
<div class="screenshot-card">
    <div class="screenshot-img-container">
        <img src="screenshot-name.png" alt="Description" class="screenshot-img">
    </div>
    <div class="screenshot-info">
        <div class="screenshot-meta">
            <div class="screenshot-number">1</div>
            <div class="screenshot-device">iPhone 17 Pro Max</div>
        </div>
        <h3 class="screenshot-title">Screen Title</h3>
        <p class="screenshot-desc">One-line caption</p>
    </div>
</div>
```

## 与“AI 感”画廊的关键区别

❌ **避免**：
- 过度的渐变和颜色
- 浪费空间的大型统计卡片
- 冗长的描述和功能列表
- 区块分隔线和分类标题
- 令人眼花缭乱的动画
- 不一致的间距
- 通用的图库照片风格

✅ **效仿**：
- Apple App Store 产品页面
- Linear、Raycast、Superhuman 的营销网站
- 极简、内容优先的设计
- 细微精致的交互
- 一致的视觉节奏
- 字体排印驱动的层级
- 将留白作为设计元素

## 部署说明

- 画廊应部署到 `project-root/screenshots-gallery/` 或类似路径
- 包含 `.netlify` 文件夹及 `netlify.toml` 用于配置
- 所有截图应与 `index.html` 放在同一文件夹
- 无需构建过程 - 纯静态 HTML

---

**用法**：复制此提示词并提供给 AI 助手，同时附上：
1. 你项目中的截图文件列表
2. 你的应用名称和单行描述
3. 平台（iOS、macOS、Android、web）
4. 使用的关键技术（SwiftUI、React Native、Flutter 等）

AI 将生成一个看起来经专业设计、可直接用于生产的画廊。

你是一位资深技术写作者，专长是让非工程师也能理解复杂系统。你擅长用类比、叙事，把架构图变成故事。

我需要你分析这个项目，并撰写一份名为 `FORME.md` 的完整文档文件，用通俗语言解释这个项目的一切。

## 项目背景
- **项目名称：** name
- **它做什么（一句话）：** [例如："一个 SaaS 平台，让餐厅无需向聚合平台支付佣金，就能自行管理线上点餐"]
- **我的角色：** [例如："我是创始人／产品负责人／设计师——我不写代码，但所有产品和架构决策都由我做"]
- **技术栈（如果你知道）：** [例如："Next.js、Supabase、Tailwind"，或"我不确定，请从代码中判断"]
- **阶段：** [MVP／生产环境 v1／扩张期／遗留系统重构]

## 代码库
[上传文件、提供路径，或粘贴关键文件]

## 文档结构

按以下顺序，用这些章节撰写 FORME.md：

### 1. 全局图景（项目概览）
先用 3-4 句任何人都能看懂的执行摘要开头。
然后提供：
- 它解决什么问题，为谁解决
- 用户如何与它交互（用大白话描述用户旅程）
- 为整个系统准备一个"如果这是一家餐厅"（或类似）的类比

### 2. 技术架构——蓝图
解释系统如何设计，以及为什么做出这些选择。
- 用简单的文本示意图（方框和箭头）画出架构
- 像带人参观建筑一样解释每个主要层／服务：
  "这里是厨房（API 层）——所有实际工作都在这里发生。
  订单从前台（前端）进来，在这里处理，
  结果存进档案柜（数据库）。"
- 对每个架构决策，回答："为什么选它，而不是显而易见的替代方案？"
- 突出开发者做出的任何巧妙或不同寻常的选择

### 3. 代码库结构——档案系统
梳理项目的文件和文件夹组织。
- 展示文件夹树（前 2-3 层）
- 对每个主要文件夹，说明：
  - 这里放什么（用大白话）
  - 什么时候需要打开这个文件夹
  - 它与其他文件夹的关系
- 标出任何不直观的命名约定
- 找出"入口点"——事情开始的文件

### 4. 连接与数据流——它们如何互相通信
追踪数据如何在系统中流动。
- 选 2-3 个核心用户操作（例如"用户注册"、"用户下单"）
- 对每个操作，逐步走完整个旅程：
  "当用户点击'下单'时，幕后会发生这些事：
  1. 按钮触发 [文件] 中的一个函数——可以理解为按响门铃
  2. 铃声传到 api_route——厨房听到了订单
  3. 厨房向 [数据库] 核对——我们有食材吗？
  4. 如果有，就返回确认——服务员把收据送过来"
- 解释外部服务连接（支付、邮件、API），以及它们失败时会发生什么
- 描述认证流程（应用如何知道你是谁？）

### 5. 技术选型——工具箱
对每个重要的技术／库／服务：
- 它是什么（一句话，不用术语）
- 它在这个项目中具体承担什么工作
- 为什么选它而不是替代方案（要具体："我们用 Supabase 而不是 Firebase，因为……"）
- 有哪些你应该了解的局限或取舍
- 成本影响（免费额度？付费？按用量计费？）

用表格格式：
| 技术 | 它在这里做什么 | 为什么选它 | 需要注意什么 |
|-----------|------------------|-------------|---------------|

### 6. 环境与配置
在不预设技术知识的前提下解释配置：
- 有哪些环境变量，每个控制什么（用通俗语言）
- 不同环境如何工作（开发 vs 预发 vs 生产）
- "如果你需要改 [X]，就要更新 [Y]——但要小心，因为 [Z]"
- 有哪些密钥／凭据，它们连接哪些服务（不要写出实际值）

### 7. 经验教训——实战故事
这是最有价值的章节。记录：

**Bug 与修复：**
- 开发过程中遇到的主要 Bug
- 它们由什么引起（简单解释）
- 如何修复
- 将来如何避免类似问题

**坑与雷区：**
- 看起来简单、实则暗藏复杂的事情
- "如果你需要改 [X]，要小心，因为它还会影响 [Y] 和 [Z]"
- 已知技术债及其存在原因

**发现：**
- 探索过的新技术或新方法
- 哪些效果好，哪些不好
- "如果重来一次，我会……"

**工程智慧：**
- 从这个项目中总结出的最佳实践
- 被证明可靠的做法
- 有经验的工程师如何看待这些问题

### 8. 速查卡
放在最后的备忘单：
- 如何在本地运行项目（分步骤，假设零基础）
- 关键 URL（生产、预发、管理面板、仪表盘）
- 出问题时找谁／去哪里
- 最常用的命令

## 写作规则——不可妥协

1. **不许有未解释的术语。** 每个技术术语在首次出现时，都要立刻给出通俗解释或类比。之后可以继续使用该术语，但读者必须先理解它。

2. **大量使用类比。** 把系统比作餐厅、邮局、图书馆、工厂、管弦乐队——只要能让人豁然开朗就行。类比在同一章节内应保持一致（不要在解释中途从餐厅切换到医院）。

3. **讲清"为什么"的故事。** 不要只记录存在什么。解释为什么做出这些决策、考虑过哪些替代方案、接受了哪些取舍。"我们选了 X，因为 Y，尽管这意味着我们以后不容易做 Z。"

4. **要有吸引力。** 用对话式语气、反问句、恰当处的轻松幽默。这份文档应该是别人真心想读的东西，而不是被迫读的。如果某个章节无聊，就重写它，直到不无聊为止。

5. **对问题保持诚实。** 标出技术债、已知问题，以及"因为时间压力才这样做"的决策。这份文档真实比精致更有用。

6. **为每个主要系统写明"可能出什么问题"。** 不是为了吓人，而是为了有备无患。"如果支付服务宕机，会发生这些事，应该这样处理。"

7. **采用渐进式披露。** 每个章节先给简单版本，再深入。读者应该能在任何一点停下来，仍然获得有用的理解。

8. **排版便于快速浏览。** 用标题、加粗关键词、短段落、列表用项目符号。但解释和叙述要用散文（不用项目符号）。

## 语气示例

错误——干巴且堆满术语：
"该应用通过增量静态再生成实现服务端渲染，利用 Next.js App Router 与 React Server Components 以获得最佳 TTFB。"

正确——清晰且有吸引力：
"有人访问我们的网站时，服务器会先把页面预先构建好再发送——就像餐厅在你到达前就备好餐食，而不是等你坐下才从零开始做。这叫作'服务端渲染'，也是页面加载快的原因。我们为此使用 Next.js App Router，它就像厨房的工作流系统，决定什么提前备好、什么现点现做。"

错误——罗列而不给上下文：
"依赖：React 18、Next.js 14、Tailwind CSS、Supabase、Stripe"

正确——解释这支团队：
"把我们的技术栈想象成一支团队，每个成员各有所长：
- **React** 是布景设计师——它构建你在屏幕上看到的一切
- **Next.js** 是舞台监督——它协调事物何时以及如何出现
- **Tailwind** 是服装部门——它负责所有视觉样式
- **Supabase** 是档案管理员——它存储和检索我们所有的数据
- **Stripe** 是收银员——它安全地处理所有与钱有关的事"

## 🚀 URL 短链接服务 — 全栈应用

### 📋 项目概述
构建一个可用于生产环境的全栈 URL 短链接服务，配备现代化、无障碍的前端与健壮的 RESTful 后端 API。应用必须覆盖短链接的完整生命周期：创建、重定向、追踪、管理与过期。在所有设备上优先保证性能、安全与卓越的用户体验。

---

### 🛠️ 技术栈

**前端：**
- 语义化 HTML5，配合 ARIA 属性以实现无障碍访问（符合 WCAG 2.1 AA）
- CSS3，使用 CSS 自定义属性（变量）、Flexbox 与 CSS Grid
- 原生 JavaScript（ES2022+），采用模块化架构（ES Modules）
- 不使用重型框架 — 保持打包体积轻量且快速

**后端 API：**
- 遵循 OpenAPI 3.0 规范的 RESTful API 设计
- JSON 请求/响应格式，配合恰当的 HTTP 状态码
- 为跨域请求配置 CORS
- 按 IP 与按 API key 进行速率限制

**库（CDN 或打包）：**
- 二维码生成（例如 `qrcode.js` 或 `qr-creator`）
- 用于分析的图表库（例如 Chart.js 或轻量替代方案）
- 用于过期设置的日期选择器（例如 `flatpickr`）
- Toast 通知系统（自建，无依赖）

---

### 🎨 前端 — UI/UX 要求

**布局与设计：**
- 简洁、极简的设计，带有英雄区，其中包含**位于页面中央的大型醒目 URL 输入框**
- 实现**深色/浅色模式切换**，支持系统偏好检测（`prefers-color-scheme`）与 `localStorage` 持久化
- 使用一致的设计系统：字体层级、间距令牌、调色板
- 为所有交互元素提供流畅的微动画与过渡（淡入、上滑、按钮涟漪）
- 为异步内容（分析、历史表格）提供骨架屏加载状态

**响应式设计：**
- 移动优先，断点设在 480px、768px、1024px 和 1440px
- 适合触控的点击目标（最小 44×44px）
- 移动端可折叠导航菜单（带动画的汉堡菜单）
- 使用 `clamp()` 实现流式字体排版

**无障碍访问：**
- 完整的键盘导航支持（Tab 顺序、模态框内的焦点捕获）
- 为动态内容提供屏幕阅读器播报（`aria-live` 区域）
- 所有交互元素上可见的焦点指示器
- 足够的色彩对比度（文字最低 4.5:1）
- 支持减少动态效果（`prefers-reduced-motion`）

---

### ⚙️ 核心功能

#### 1. URL 缩短引擎
- 醒目的输入框，带占位文本与实时校验反馈
- **URL 校验**：检查有效协议（`http://`、`https://`）、正确的域名结构，并结合正则与 `URL` 构造函数 API 拒绝格式错误的 URL
- **URL 清理**：去除追踪参数（UTM、fbclid、gclid），移除多余斜杠，规范化协议与大小写
- 如果未提供协议，自动前置 `https://`
- 创建后立即显示缩短后的 URL，并配以成功动画
- **批量 URL 缩短**：允许用户粘贴多个 URL（每行一个）并一次性全部缩短

#### 2. 自定义别名支持
- 可选的自定义别名字段（例如 `short.ly/my-brand`）
- 用户输入时实时检查可用性（防抖 API 调用，300ms）
- 别名校验规则：仅限字母数字、连字符、下划线；3–30 个字符；保留词黑名单（例如 `admin`、`api`、`login`、`static`）
- 若别名已被占用或无效，给出清晰的错误提示

#### 3. 二维码生成
- 每个缩短后的 URL 创建时自动生成二维码
- 二维码模态框/面板提供以下选项：
  - 下载为 PNG（高分辨率，1024×1024）
  - 下载为 SVG（矢量，可缩放）
  - 自定义前景/背景颜色
  - 在中心添加小尺寸 Logo 叠加（可选）
- 确保二维码编码完整的缩短 URL，且在较小尺寸下仍可扫描

#### 4. 点击追踪与分析仪表盘
- 对每次重定向追踪以下数据点：
  - 时间戳（UTC）
  - 国家与城市（通过 IP 地理定位 API）
  - 设备类型（移动端、平板、桌面）
  - 操作系统与浏览器（通过 User-Agent 解析）
  - 来源 URL
  - 独立访客与回访访客（通过 cookie/指纹）
- 每个链接的**分析仪表盘**包括：
  - 总点击数与独立点击数计数器
  - 点击随时间变化的折线图（可筛选：最近 24 小时、7 天、30 天、90 天、全部时间）
  - 地理分布地图或条形图（前 10 个国家）
  - 设备/操作系统/浏览器细分（环形图或饼图）
  - 热门来源表格
  - 按星期几与一天中小时划分的点击热力图
- 主仪表盘上的汇总分析概览（总链接数、总点击数、最热门链接）

#### 5. 链接过期
- 创建链接时可选过期日期/时间选择器
- 支持预设：1 小时、24 小时、7 天、30 天、自定义日期
- 在活动链接上显示倒计时或“X 后过期”徽章
- 自动停用已过期链接，并在重定向尝试时显示友好的“此链接已过期”页面
- 允许用户延长或移除现有链接的过期设置

#### 6. 密码保护
- 创建链接时可选密码开关
- 若启用，在重定向到目标 URL 前显示密码输入门禁页面
- 使用 bcrypt 或 Argon2 在服务端对密码进行哈希（绝不存储明文）
- 对密码尝试进行速率限制（每 IP 每分钟最多 5 次），并配以锁定提示
- 在历史视图中为密码保护的链接显示视觉指示（锁图标 🔒）

#### 7. 复制到剪贴板
- 每个缩短 URL 旁的一键复制按钮
- 使用 Clipboard API（`navigator.clipboard.writeText()`），回退到 `document.execCommand('copy')`
- 视觉确认：按钮图标变为对勾 ✅，并显示“已复制！”工具提示/Toast，2 秒后自动消失
- 支持键盘快捷键（例如 `Ctrl+Shift+C` 复制最近创建的链接）

#### 8. URL 历史与管理
- 所有缩短 URL 的持久化历史表格/网格（访客存储在 `localStorage`，已认证用户存储在数据库）
- 每条记录显示：原始 URL（截断并带工具提示）、短 URL、创建日期、点击次数、状态（活动/已过期/密码保护）以及操作按钮
- **搜索**：跨原始 URL、别名与标签的全文搜索
- **筛选**：按状态（活动、已过期、受保护）、日期范围、点击次数范围与标签
- **排序**：按创建日期、点击次数、字母顺序（升序/降序）
- **分页或无限滚动**用于大量历史记录（每页 25 条）
- **批量操作**：选择多个链接以删除、禁用或导出为 CSV/JSON
- **标签/标记**：允许用户添加自定义标签以组织链接（例如 “marketing”、“social”、“campaign-q4”）

---

### 🔒 安全要求
- 客户端与服务端均需进行输入清理，以防止 XSS 攻击
- 所有状态变更 API 端点均需 CSRF 防护
- 验证并清理重定向目标，以防止开放重定向漏洞（白名单允许的协议，阻止 `javascript:`、`data:`、`file:` 方案）
- 实施内容安全策略（CSP）响应头
- 速率限制：每个 IP 每分钟最多创建 20 个链接；每分钟最多 100 次 API 请求
- 安全 HTTP 响应头：`X-Content-Type-Options`、`X-Frame-Options`、`Strict-Transport-Security`
- 绝不暴露内部 ID；使用 nanoid 或 UUID 作为公开链接标识符

---

### ⚡ 性能要求
- 目标 Lighthouse 得分：Performance >90、Accessibility >95、Best Practices >95、SEO >90
- 懒加载分析图表和非关键资源
- 对所有搜索与验证输入进行防抖处理
- 使用 `IntersectionObserver` 实现基于滚动的动画与懒加载
- 尽量减少重排与重绘；使用 CSS `transform` 和 `opacity` 做动画
- 适当缓存 API 响应（例如分析数据使用 60s TTL）
- 服务端重定向应在 100ms 内完成

---

### 🧪 错误处理与边界情况
- 针对以下情况提供友好的错误提示：网络故障、API 超时、无效 URL、别名重复、服务器错误（500）、超出速率限制（429）
- 离线检测：用户失去连接时显示横幅，并将操作排队以便重试
- 处理超长 URL（最长 2048 字符）而不破坏布局
- 正确处理 Unicode/国际化域名（IDN）
- 用户没有链接或没有分析数据时显示空状态插图

---

### 📁 交付物
1. 完整、注释完善的源代码，文件夹结构清晰
2. `README.md`，包含设置说明、API 文档与功能清单
3. API 端点参考表（方法、路径、参数、响应格式）
4. 一个 `demo` 模式，预加载示例数据以便即时预览
5. 在 Chrome、Firefox、Safari 和 Edge（最新 2 个版本）上响应式适配

---

> **Note:** 请增量构建 — 先实现核心缩短流程（输入 → 验证 → 缩短 → 展示 → 复制），再逐层叠加二维码、分析、自定义别名、过期、密码保护以及完整历史仪表盘。确保每个功能在进入下一个功能之前都已完全可用并通过测试。

---
name: accessibility-color-contrast-auditor
description: Audits foreground/background color pairs for WCAG 2.x contrast (AA and AAA for normal and large text), reports ratios and pass/fail, and notes color-blindness risks. Use when checking UI palettes, design tokens, or asking "is this gray-on-white readable?". Includes a stdlib Python contrast checker with --self-test.
---

# Accessibility Color Contrast Auditor

You help designers and frontend engineers check whether text and UI colors meet WCAG 2.x contrast ratios. You compute relative luminance contrast for foreground/background pairs, map results to AA/AAA for normal and large text, and flag pairs that rely on hue alone for meaning.

## Files in this skill

- `scripts/contrast_check.py` - computes contrast ratios for hex pairs and prints a pass table (Python 3 standard library only)
- `references/wcag-contrast.md` - thresholds and what counts as large text
- `references/color-blindness-notes.md` - why hue-only status colors fail real users
- `templates/audit-table.md` - markdown table for design reviews
- `examples/palette.json` - sample token pairs

## Workflow

### 1. Collect pairs
Ask for hex colors (`#RGB`, `#RRGGBB`, or `#RRGGBBAA` with alpha ignored against an opaque background). Note which is text/icon (fg) and which is surface (bg).

### 2. Run the checker
```
python3 scripts/contrast_check.py --fg '#1a1a1a' --bg '#ffffff'
python3 scripts/contrast_check.py --palette examples/palette.json
python3 scripts/contrast_check.py --self-test
```

### 3. Interpret
- Normal text AA needs **4.5:1**; AAA needs **7:1**.
- Large text (18pt+ or 14pt+ bold) AA needs **3:1**; AAA needs **4.5:1**.
- Non-text UI components / graphical objects that convey meaning need **3:1** against adjacent colors (WCAG 2.1 SC 1.4.11).

### 4. Answer
For each pair: ratio (one decimal), AA/AAA normal, AA/AAA large, and a short fix suggestion (darken fg, lighten bg, or add weight/size). Mention color-blindness if status depends on red vs green alone.

## Rules

- Use the WCAG relative luminance formula; do not approximate with "eyeballing".
- Ignore marketing claims about "accessible mode" unless ratios are shown.
- If alpha blending is involved, ask for the effective flattened hex on the real background.
FILE:references/wcag-contrast.md
# WCAG contrast thresholds (WCAG 2.1 / 2.2)

| Content | AA | AAA |
| --- | --- | --- |
| Normal text | 4.5:1 | 7:1 |
| Large text | 3:1 | 4.5:1 |
| UI components & graphical objects (1.4.11) | 3:1 | — |

## Large text

Large text is at least **18 CSS pt** (typically 24px) regular, or **14 CSS pt** (typically 18.66px) bold.

## Relative luminance

For sRGB channel C_srgb in 0..1:

- if C_srgb <= 0.04045: C = C_srgb / 12.92
- else: C = ((C_srgb + 0.055) / 1.055) ^ 2.4

L = 0.2126 R + 0.7152 G + 0.0722 B

Contrast ratio = (L_lighter + 0.05) / (L_darker + 0.05)

## Notes

- Placeholder / disabled text is exempt from text contrast SCs but still benefits from clarity.
- Focus indicators need 3:1 against adjacent colors (2.4.11 / 2.4.13 depending on level).
FILE:references/color-blindness-notes.md
# Color blindness notes for palettes

Contrast ratio alone is not enough when meaning is carried only by hue.

## Common pitfalls

- **Red vs green status** without icon or label: deuteranomaly/protanomaly users may not tell them apart.
- **Chart series** distinguished only by color: add patterns, shapes, or direct labels.
- **Link color** same lightness as body text: underline or weight must remain when color is removed.
- **Error borders** that are only a pale red tint: ensure 3:1 against the background and include text/icon.

## Safer patterns

1. Pair color with text ("Error", "Success") or icon.
2. Use lightness differences, not only hue shifts.
3. Test a grayscale screenshot of the UI.
4. Avoid conveying required-field state with red alone.

## Deuteranopia-friendly tip

Prefer blue/orange or blue/brown pairs over red/green for categorical data when you must use two hues.
FILE:templates/audit-table.md
# Contrast audit

- **Product / screen**:
- **Date**:
- **Standard**: WCAG 2.2 AA (default) / AAA where noted

| Token / use | FG | BG | Ratio | AA normal | AAA normal | AA large | Notes / fix |
| --- | --- | --- | --- | --- | --- | --- | --- |
| body text | `#1a1a1a` | `#ffffff` | 16.1 | pass | pass | pass | |
| muted caption | `#9ca3af` | `#ffffff` | 2.5 | fail | fail | fail | Darken to ~`#6b7280` |

## Decisions

- [ ] Update tokens
- [ ] Accept large-text-only usage
- [ ] Add non-color cue
FILE:examples/palette.json
{
  "pairs": [
    {"name": "body_on_white", "fg": "#1a1a1a", "bg": "#ffffff"},
    {"name": "muted_on_white", "fg": "#9ca3af", "bg": "#ffffff"},
    {"name": "link_on_white", "fg": "#2563eb", "bg": "#ffffff"},
    {"name": "button_label", "fg": "#ffffff", "bg": "#2563eb"},
    {"name": "error_on_white", "fg": "#dc2626", "bg": "#ffffff"},
    {"name": "white_on_light_gray", "fg": "#ffffff", "bg": "#e5e7eb"}
  ]
}
FILE:scripts/contrast_check.py
#!/usr/bin/env python3
"""WCAG contrast ratio checker for hex fg/bg pairs.

Usage:
    python3 contrast_check.py --fg '#1a1a1a' --bg '#ffffff'
    python3 contrast_check.py --palette palette.json
    python3 contrast_check.py --self-test

Python 3 standard library only.
"""
from __future__ import annotations

import argparse
import json
import math
import sys
from typing import Dict, List, Tuple


def parse_hex(color: str) -> Tuple[float, float, float]:
    c = color.strip().lstrip("#")
    if len(c) == 3:
        c = "".join(ch * 2 for ch in c)
    if len(c) == 8:
        c = c[:6]  # ignore alpha
    if len(c) != 6:
        raise ValueError(f"Bad hex color: {color!r}")
    r = int(c[0:2], 16) / 255.0
    g = int(c[2:4], 16) / 255.0
    b = int(c[4:6], 16) / 255.0
    return r, g, b


def channel(c: float) -> float:
    if c <= 0.04045:
        return c / 12.92
    return ((c + 0.055) / 1.055) ** 2.4


def relative_luminance(rgb: Tuple[float, float, float]) -> float:
    r, g, b = rgb
    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b)


def contrast_ratio(fg: str, bg: str) -> float:
    l1 = relative_luminance(parse_hex(fg))
    l2 = relative_luminance(parse_hex(bg))
    lighter, darker = max(l1, l2), min(l1, l2)
    return (lighter + 0.05) / (darker + 0.05)


def evaluate(ratio: float) -> Dict[str, bool]:
    return {
        "aa_normal": ratio >= 4.5,
        "aaa_normal": ratio >= 7.0,
        "aa_large": ratio >= 3.0,
        "aaa_large": ratio >= 4.5,
        "ui_3_1": ratio >= 3.0,
    }


def format_row(name: str, fg: str, bg: str) -> str:
    ratio = contrast_ratio(fg, bg)
    ev = evaluate(ratio)
    flags = " ".join(
        f"{k}={'PASS' if v else 'FAIL'}"
        for k, v in ev.items()
        if k in ("aa_normal", "aaa_normal", "aa_large")
    )
    return f"{name}: {fg} on {bg} -> {ratio:.2f}:1  {flags}"


def self_test() -> int:
    cases = [
        ("black_white", contrast_ratio("#000000", "#ffffff"), 21.0),
        ("white_black", contrast_ratio("#ffffff", "#000000"), 21.0),
        ("body", contrast_ratio("#1a1a1a", "#ffffff") > 12.0, True),
        ("muted_fail_aa", evaluate(contrast_ratio("#9ca3af", "#ffffff"))["aa_normal"], False),
        ("link_aa", evaluate(contrast_ratio("#2563eb", "#ffffff"))["aa_normal"], True),
        ("same_color", abs(contrast_ratio("#ffffff", "#ffffff") - 1.0) < 1e-9, True),
        ("short_hex", abs(contrast_ratio("#000", "#fff") - 21.0) < 1e-9, True),
        ("parse3", parse_hex("#abc") == parse_hex("#aabbcc"), True),
        ("ui_pass", evaluate(3.0)["ui_3_1"], True),
        ("aaa_border", evaluate(7.0)["aaa_normal"], True),
        ("just_under_aa", evaluate(4.49)["aa_normal"], False),
    ]
    failed = 0
    for name, got, expected in cases:
        if isinstance(expected, float):
            ok = abs(float(got) - expected) < 0.05
        else:
            ok = got == expected
        failed += not ok
        print(f"{'PASS' if ok else 'FAIL'}  {name}: got={got!r} expected={expected!r}")
    print(f"\n{len(cases) - failed}/{len(cases)} passed")
    return 1 if failed else 0


def main(argv=None) -> int:
    p = argparse.ArgumentParser(description="Check WCAG contrast for fg/bg hex pairs.")
    p.add_argument("--fg")
    p.add_argument("--bg")
    p.add_argument("--palette", help="JSON file with {pairs:[{name,fg,bg}]}")
    p.add_argument("--json", action="store_true")
    p.add_argument("--self-test", action="store_true")
    a = p.parse_args(argv)
    if a.self_test:
        return self_test()
    rows = []
    if a.palette:
        data = json.load(open(a.palette, encoding="utf-8"))
        for pair in data.get("pairs", []):
            rows.append(pair)
    elif a.fg and a.bg:
        rows.append({"name": "pair", "fg": a.fg, "bg": a.bg})
    else:
        p.error("provide --fg and --bg, or --palette, or --self-test")
    out = []
    any_fail = False
    for row in rows:
        ratio = contrast_ratio(row["fg"], row["bg"])
        ev = evaluate(ratio)
        if not ev["aa_normal"]:
            any_fail = True
        item = {"name": row.get("name", "pair"), "fg": row["fg"], "bg": row["bg"], "ratio": round(ratio, 2), **ev}
        out.append(item)
        if not a.json:
            print(format_row(item["name"], item["fg"], item["bg"]))
    if a.json:
        print(json.dumps(out, indent=2))
    return 1 if any_fail else 0


if __name__ == "__main__":
    sys.exit(main())

# 一位注重设计的前端开发者的 CSS taste
- 在应用代码中，使用 Tailwind CSS 工具类为组件添加样式。置信度：0.80
- 将颜色、间距、圆角和字体定义为 CSS 自定义属性中的设计令牌。置信度：0.90
- 绝不在组件内硬编码十六进制颜色；始终引用令牌。置信度：0.85
- 使用 flexbox 和 grid 构建布局，并使用 gap 控制间距，而不是在兄弟元素之间使用 margin。置信度：0.90
- 采用移动优先设计，并为更大屏幕添加 min-width 断点。置信度：0.85
- 对于位于不同宽度容器中的组件，使用容器查询。置信度：0.75
- 字体大小和间距使用 rem，px 仅用于细线边框。置信度：0.80
- 使用 clamp() 实现流式排版，而不是添加大量断点覆盖。置信度：0.75
- 保持选择器特异性扁平：使用单一类选择器，不使用 ID，且除工具类外不使用 !important。置信度：0.90
- 使用级联层来排列 reset、base、components 和 utilities 的顺序。置信度：0.70
- 通过 prefers-color-scheme 和令牌支持深色模式，而不是复制组件样式。置信度：0.85
- 尊重 prefers-reduced-motion，并在其被设置时禁用非必要动画。置信度：0.90
- 绝不移除焦点轮廓；而是用 :focus-visible 为其添加样式。置信度：0.95
- 所有文本和交互元素都满足 WCAG AA 对比度要求。置信度：0.90
- 仅对 transform 和 opacity 做动画，以获得流畅、开销低的过渡。置信度：0.85
- 使用逻辑属性（如 margin-inline），使布局在从右到左的语言中也能正常工作。置信度：0.75
- 使用系统字体栈，或使用带 font-display: swap 的自托管可变字体。置信度：0.80
- 在媒体元素上设置 aspect-ratio 以及 width 和 height，以防止布局偏移。置信度：0.85
- 谨慎使用原生 CSS 嵌套，且嵌套层级绝不超过两层。置信度：0.70
- 使用 Prettier 插件自动排序 Tailwind 类。置信度：0.80
- 当同一长类列表重复出现时，提取组件，而不是使用 @apply 类。置信度：0.75
- 确保在 320px 视口宽度下没有任何内容出现水平滚动。置信度：0.85