ColorFlow Web v0.2.0

ColorFlow Web v0.2.0 — 一键流水线 + API Key 认证 + AI Agent(MCP)接入。

🚀 一键流水线(描图 → 配色 → 报价)

• 描图成功后新增「提取主色 & Pantone 匹配」:后端 /api/trace/colors 一次性返回主色板 + 每个主色的 Pantone 匹配(含 ΔE)
• 前端渲染色板 + 一键「按 N 色填入报价」,自动切到报价 Tab 完成全链路
• SDK 新增 extract_svg_colors() 提供主色提取(见 ColorFlow v0.2.0)

🔒 API Key 认证

• 设置 COLORFLOW_API_KEY 后,/api/* 必须携带 x-api-key 头(恒定时间字节比较,非 ASCII 安全)
• 页面与静态资源保持公开;前端提供 API Key 输入框(localStorage 持久化,自动附带请求头)
• 未设置 key 时本地开发完全开放

🤖 AI Agent 接入(MCP Server)

• 新增 mcp_server.py,基于 FastMCP,4 个工具:
  • trace_image (位图 → SVG)
  • match_pantone (HEX → 最近 5 个 Pantone + ΔE)
  • quote_print (全链路印刷报价)
  • trace_and_match (一键流水线)
• Claude Code / Cursor 可直接接入:.mcp.json 配置即可

工程

• 抽出上传/参数处理 helper,简化路由
• 测试 27 → 34(流水线端点、认证守卫、MCP 冒烟测试)
• README 同步更新(流水线、认证、MCP 接入、API 文档)

ColorFlow Web v0.1.0

ColorFlow Web 首个正式版本 — AI 矢量描图 + Pantone 色彩管理 Web 工具，一个页面搞定从位图到印刷落地。

四大功能

• 矢量描图：上传位图（PNG/JPG/WebP/BMP），VTracer 转 SVG，预览 + 下载
• Pantone 查色：输入色号，一键获取 HEX / CMYK / RGB
• 色彩匹配：输入 HEX，自动匹配最近 5 个 Pantone 色 + ΔE 色彩偏差分级
• 印刷报价：尺寸/颜色/纸张/数量 → 全链路油墨 + 版材 + 调机 + 印刷成本

Bug 修复

• 印刷报价显示 N/A：后端直接透传 mcp-print 的 ink_cost/total_cost，而前端读取 *_usd 字段，报价全链路无法显示。已在后端映射为 ink_cost_usd / total_cost_usd / cost_per_unit_usd / breakdown 等字段
• 非法参数导致 500：表单/查询参数非数字时 int()/float() 抛异常 → 500；改为安全解析器回退默认值，非法 JSON/HEX 返回 400
• /api/trace 无类型校验：不支持的图片类型现在返回 415；SDK 参数校验错误映射为 400
• 移除重复 import os

安全加固

• 前端修复 XSS：后端错误字符串插入 innerHTML 前统一转义（escapeHtml）
• 修正页面 footer 与 README 中的仓库链接（AbinCheungCom → Abinius）

工程化

• 新增 requirements.txt（colorflow-sdk 未发布 PyPI，改为 git+ 引用）、.gitignore
• 移除误提交的 __pycache__
• 新增 21 个集成测试：trace 认证/415/400/成功链路、Pantone 匹配/查询/分页、报价字段映射回归测试

技术栈

• 前端：原生 HTML + CSS + JS（零框架）
• 后端：Flask + Python 3.10+
• 引擎：VTracer（Rust）+ mcp-print（2415 Pantone 色）+ ColorFlow SDK