🎨 在线体验：hue-forge.vercel.app（推送到
main自动部署）
Hue Forge 是一个面向设计系统和品牌色板工作的颜色系统生成工具。它基于 HSB 曲线模型与 WCAG 对比度规则，帮助你生成、调整、检查并导出一整套可落地的色阶。
- 面向需要快速生成多色相、多层级色板的设计与前端工作流
- 把“颜色生成、可读性检查、代码导出”收敛在同一个本地前端工具里
- 当前为纯前端单页应用，不依赖后端服务
- 已通过 Vercel 部署：hue-forge.vercel.app
- 生成多色相色阶矩阵，并保持各列 step 结构对齐
- 调整
Base Scale、单列饱和度曲线和亮度曲线 - 同时查看黑字 / 白字对比度与 WCAG 等级
- 导出
CSS、Tailwind、Tailwind 4、Tokens，并支持一键复制SVG / Figma - 支持
AI Export，复制带上下文说明的结构化文本给 AI 使用
- 安装依赖：
npm install - 启动开发环境：
npm run dev - 打开浏览器访问：
http://localhost:1248
npm run dev
npm run build
npm run lint
npm run check:contrast欢迎任何形式的贡献 —— 报告 Bug、提交 Feature、改进文档或优化算法。请先阅读 CONTRIBUTING.md 了解开发环境与提交流程。
主站点（Vercel）：https://hue-forge.vercel.app/
- 仓库已连接 Vercel（
chenlicool/Hue-Forge），推送到main分支后自动构建部署，无需手动操作 - 部署配置：框架 Vite，构建命令
npm run build，输出目录dist
备用站点（GitHub Pages）：https://chenlicool.github.io/Hue-Forge/
- 仓库已配置 GitHub Actions 工作流（
.github/workflows/deploy.yml）；若从未启用，需在Settings -> Pages将Build and deployment的Source切换为GitHub Actions - 注意：GitHub 托管 Runner 近期存在不稳定，Actions 部署可能排队失败；若失败请以 Vercel 主站点为准（Runner 恢复时间待确认/未知）
- 本项目当前按
MIT License开源 - 仓库地址：chenlicool/Hue-Forge
- 许可证全文见仓库根目录 LICENSE
- 若你使用第三方 API 或自行扩展外部服务，对应服务条款与费用不包含在本项目开源许可证内
- 在顶部工具栏选择或新增 hue 集合
- 在左侧
Base轨道调整整体亮度基线 - 选中某个色条或 step，微调饱和度与亮度曲线
- 观察右侧对比度反馈，确认文字可读性
- 在工具栏直接复制
SVG / Figma，或打开导出面板复制代码格式用于代码库或 AI 工作流
Hue Forge 会基于当前画面中的 palette 直接生成导出结果，而不是维护另一套脱节的 token 状态。典型输出如下：
:root {
--blue-10: #f3f8ff;
--blue-20: #dbeafe;
--blue-30: #bfdbfe;
--blue-40: #93c5fd;
}export default {
theme: {
extend: {
colors: {
blue: {
10: "#f3f8ff",
20: "#dbeafe",
30: "#bfdbfe",
40: "#93c5fd"
}
}
}
}
}src/：前端源码scripts/：辅助脚本；当前包含颜色对比度检查脚本archive/：历史备份与遗留配置归档ARCHITECTURE.md：技术架构与核心流程说明CHANGELOG.md：版本变更记录
- Node.js 18+（更低版本兼容性待确认/未知）
- npm
- 已完成根目录工程整理并推送到 GitHub
- 主部署已切换为 Vercel（
hue-forge.vercel.app），GitHub Pages 保留为备用通道 - 已补齐
MIT许可证与页面内开源入口 - 已将内部协作与规划文档改为本地保留，不再作为公开仓库内容分发
- 当前构建可通过，但生产包体积存在告警，后续可继续做 chunk 拆分
archive/metadata.json是否仍需长期保留，待确认/未知