Update plugin 颜色助手 v1.1.0

[snwjas]

插件信息

• 名称: 颜色助手
• 插件ID: color-helper
• 版本: 1.1.0
• CLI版本: 1.3.2
• 描述: 颜色、UI 色卡、传统色、渐变色、图片色卡、收藏颜色、AI 配色
• 作者: mylesy
• 类型: 更新

本次变更

修复

• 修复 tsconfig.json 的 include 路径，让 tsc 真正检查代码
• 修复渐变导出图片与预览不一致（渐变线长度算错）
• 统一明暗判定判据（原先混用三套阈值），修复传统色部分色块文字对比度不足
• 修复颜色输入识别：正则误判普通单词为颜色，主输入框里大写色值不匹配
• 修复 AI 调用硬编码了宿主解析不出的模型 ID，导致总是报「未找到 AI 模型配置」
• 修复图片色卡无法通过 img / files 命令带入图片
• 修复收藏颜色删除后残留索引、单个文档损坏导致整批丢失
• 修复剪贴板回退逻辑从未生效（接不住 Promise reject）
• 修复两处整页白屏：懒加载页面加载失败、图标库在 vite 8 下不兼容
• 修复提示条收藏：半透明色（8 位 hex）不再被误判为非法色值、失败时给出反馈、在收藏页上收藏后列表立即刷新；「查看」按钮与收藏星标不再跨页面显示旧状态
• 颜色页各格式复制按钮的 Tooltip 与实际复制的完整色值一致

变更

• 移除 AI 配色的颜色正则：与「颜色」完全重复，粘色值时只会多出冗余候选，只留「AI 配色」文本命令
• 侧边栏顺序与 plugin.json 的 features 对齐，AI 配色移到末位
• 颜色页各格式复制按钮改为走统一提示条，原样回显复制文本、剪贴板为该格式完整色值（原先一律变回 hex）；在颜色页上不显示「查看」
• 渐变页复制增加反馈，浏览器下降级为下载 PNG
• 渐变色 / 图片色卡 / AI 配色改为懒加载
• 图片色卡四个版式重做，色值内嵌色块、字号按槽位自适应
• 构建链与依赖升级：vite 8 + vitest 4、Node 22、chroma-js 3、MUI 7、React 19，锁定 pnpm 版本，pnpm audit 归零
• 全库注释清理：删除上游残留、复述与叙事式、过期注释，为非直观处补「为什么」说明

新增

• 提示条上增加「收藏」（已收藏显示星标，点击跳到收藏页）
• 引入 vitest 测试基建（pnpm test / pnpm run test:run）
• 抽出 utils/gradient.ts、utils/collect.ts（统一收藏颜色的文档形状与写入，供提示条与收藏页共用）
• window.platform 类型声明逐条对齐官方 ztools.api.d.ts

移除

• 移除死代码与无用文件：package-lock.json、react-router-dom、utils/storage.ts、context/AppContext.tsx、plugin.json 的 pluginName 字段、quantize 死条件 maxColors > 256、App.tsx 无入口的 AI 配色 regex 分支与透传复制回调

截图 / 演示

自检清单

• plugin.json 的 name / title / version / description / author 字段均已检查
• 已移除调试日志、未使用文件、敏感信息（.env、token、密钥等）
• 本次 PR 的 diff 仅涉及 plugins/color-helper/ 目录
• 已在本地 ZTools 客户端实际加载并测试过此插件，主要功能正常
• 同意以仓库声明的开源协议发布此插件

---

此 PR 由 ztools-plugin-cli 自动管理：每次 ztools publish 基于最新主仓库重建发布分支；打开的 PR 链接保持不变。