💡
快速开始
新手入门指南：如何浏览、复制和使用CSS效果代码，快速上手CSS Magic平台。
🎨
代码使用
了解如何免费使用我们的CSS代码，包括授权信息、最佳实践和常见用法。
🔐
账户与登录
注册、登录问题解答，特别是GitHub登录的常见问题和解决方案。
🔄
功能使用
收藏功能、搜索功能、效果预览等核心功能的使用方法和限制。
📝
贡献代码
如何提交自己的CSS效果，贡献指南、审核流程和贡献者权益。
🛠️
技术支持
遇到技术问题？了解我们的技术栈、已知问题和故障排除方法。
常见问题解答
Q1: 使用网站上的CSS代码需要付费或署名吗？
▼
完全免费，且无需强制署名！
CSS Magic 的核心使命就是让前端开发更轻松、更愉快。网站上的所有CSS代码片段，您都可以：
- 免费使用于个人项目、商业项目、开源项目
- 直接复制代码到您的项目中
- 任意修改代码以适应您的需求
- 无需付费，没有任何隐藏费用
- 无需强制署名，但如果您愿意在项目文档或博客中提到"灵感来源于CSS Magic"，我们会非常感激！
我们的唯一要求是：请不要将我们的代码重新打包后作为付费产品出售。
Q2: 如何收藏我喜欢的效果？收藏功能什么时候上线？
▼
收藏功能是我们路线图中的核心功能之一，目前正在积极开发中。
📅 预计上线时间：
我们计划在未来1-2个月内发布完整的收藏功能。
🎯 收藏功能将包括：
- 一键收藏/取消收藏效果
- 收藏夹分类管理
- 收藏效果批量导出
- 个性化推荐基于收藏历史
⏳ 目前您可以：
- 使用浏览器书签：暂时使用浏览器的书签功能保存您喜欢的效果页面
- 注册账户：现在注册账户，收藏功能上线时会自动为您迁移数据
- 关注动态：关注我们，功能上线时会第一时间通知
Q3: GitHub登录失败怎么办？为什么总是登录不上？
▼
GitHub登录问题通常是由于网络环境导致的，以下是详细的解决方案：
🔍 常见原因：
- 网络限制：GitHub在国内部分地区访问不稳定
- OAuth配置：回调URL配置问题（我们已优化，但个别网络可能仍有问题）
- 浏览器问题：缓存或Cookie问题
- 账户权限：未授权必要的权限
🛠️ 解决方案：
- 刷新重试：简单的刷新页面可能解决临时网络问题
- 清除缓存：清除浏览器缓存和Cookie后重试
- 更换网络：尝试切换到不同的WiFi或使用移动数据
- 使用代理：如果条件允许，使用稳定的网络工具
- 更换浏览器：尝试使用Chrome、Firefox等现代浏览器
- 稍后重试：等待一段时间（可能是服务端临时问题）
📧 如果上述方法都无效：
请通过联系我们页面发送您的GitHub用户名和问题描述，我们将为您手动检查账户状态。
🎯 未来计划：我们正在开发邮箱登录、微信登录等多种登录方式，以解决GitHub登录的依赖问题。
Q4: 我可以提交自己的CSS效果吗？投稿有什么要求？
▼
非常欢迎投稿！ CSS Magic 是一个社区驱动的项目，您的贡献将使整个社区受益。
📝 投稿要求：
- 原创性：必须是您原创或拥有使用授权的代码
- 实用性：代码应有一定的实用价值或学习价值
- 质量：代码规范、注释清晰、浏览器兼容性好
- 完整性：包含HTML结构、CSS样式和必要的JavaScript
📋 投稿流程：
- 阅读完整的贡献指南
- 准备好您的代码和效果说明
- 通过联系我们页面提交
- 我们的团队会在1-3个工作日内审核
- 审核通过后，效果将被添加到网站
🎖️ 贡献者权益：
- 在效果页面显示您的名字和GitHub链接
- 获得"CSS Magic贡献者"专属徽章
- 优先体验新功能
- 参与社区决策的机会
对于优秀的贡献者，我们还会在首页和社交媒体上特别推荐！
Q5: 网站的技术栈是什么？我可以参与开发吗？
▼
🛠️ 当前技术栈：
- 前端：原生HTML5、CSS3、ES6+ JavaScript
- UI框架：自定义CSS框架，无第三方UI库依赖
- 状态管理：原生JavaScript状态管理模式
- 后端服务：Supabase（认证、数据库、存储）
- 部署平台：Cloudflare Pages（全球CDN加速）
- 开发工具：VS Code、Git、GitHub Actions
🌱 技术演进路线：
我们保持技术栈的简洁性和可维护性，未来可能引入：
- TypeScript用于更好的类型安全
- 轻量级框架增强组件复用
- PWA支持离线访问
- 更多第三方服务集成
👨💻 参与开发：
我们欢迎开发者参与共建！参与方式：
- 查看贡献指南中的开发者部分
- 在GitHub上fork项目仓库
- 提交Pull Request修复bug或添加功能
- 参与代码审查和讨论
即使是新手开发者，我们也欢迎参与文档编写、测试等贡献！
Q6: 遇到Bug或有功能建议如何反馈？
▼
感谢您帮助我们改进！优质的反馈对我们至关重要。
📤 反馈渠道：
- 邮件反馈：通过联系我们页面发送
- GitHub Issues：项目开源后将开放issue功能
- 用户调查：定期发布的用户满意度调查
📝 优质反馈包含：
- 问题描述：清晰描述遇到的问题或建议的功能
- 复现步骤：一步一步说明如何复现问题
- 环境信息：浏览器版本、操作系统、设备类型
- 期望结果：您期望的正常行为是什么
- 截图/录屏：提供可视化的证据（如有）
⏱️ 响应时间：
- 紧急问题：24小时内初步响应
- 一般问题：1-3个工作日内响应
- 功能建议：我们会评估并纳入产品路线图
对于提出有价值反馈的用户，我们会给予积分奖励或特别感谢！
Q7: 网站的盈利模式是什么？如何保证长期运营？
▼
这是一个非常重要的问题！我们致力于长期、可持续地运营CSS Magic。
🎯 核心原则：
- 代码永远免费：所有CSS代码将始终保持免费使用
- 无强制广告：不会用弹窗广告或强制广告干扰用户体验
- 用户隐私第一：严格遵守隐私政策，保护用户数据
💰 可持续运营模式：
- 赞助与捐赠：接受用户和企业的自愿赞助
- 高级功能：未来可能提供团队协作、高级搜索等增值服务
- 企业服务：为企业提供定制化CSS解决方案
- 优质内容：与优质创作者合作，提供独家内容
- 社区支持：通过社区众筹支持核心开发
🛡️ 长期承诺：
- 开源承诺：核心代码将逐步开源，确保项目透明
- 数据可迁移：用户数据将提供导出功能
- 传承计划：建立项目传承机制，防止项目中断
- 社区治理：逐步过渡到社区主导的治理模式
我们相信，通过提供真正的价值，自然能够获得社区的支持，实现可持续发展。