1. 插件定位

插件名称：按颜色分类

应用目录：colorcat

当前版本：1.0

适配 CMS：4.7.1

类型：内容模块增强插件（自动识别图片颜色 + 搜索按颜色筛选）

2. 核心功能

• 自动识别颜色：内容发布/更新后，自动从指定图片附件中提取主色并写入颜色标签字段。

• 颜色字段组件：提供 Colorcat:：Maincolor 字段类型，以圆形色块展示识别结果，并支持手动勾选修正。

• 一键取色：在发布表单支持从“来源图片字段”实时 AJAX 取色。

• 搜索筛选：支持前台模块搜索按 ec_color 参数筛选内容。

• URL 参数保留：搜索翻页时自动保留颜色筛选参数，避免筛选丢失。

• 菜单自修复：首次初始化时若后台菜单缺失，可自动补齐应用入口并刷新缓存。

3. 功能亮点

• 颜色识别与内容模型深度联动，发布即打标签。

• 支持 Image/File/Files 等附件来源字段。

• 按字段白名单写入，避免非法值注入。

• 前后端都可调用识别接口，兼容后台发布和会员发布场景。

• 与现有模块搜索体系无缝集成，无需改动核心搜索逻辑。

4. 安装与启用

1) 将插件文件部署到站点应用目录。

2) 后台安装并启用 colorcat。

3) 在目标内容模块中新增字段类型 Colorcat::Maincolor（用于存储识别标签）。

4) 在插件配置页按模块设置是否启用和取色来源字段。

5) 清理缓存后测试发布。

5. 前台效果

• 列表/详情可展示颜色点。

• 搜索页可按颜色筛选，URL 参数 ec_color 全程保留。

• 可通过 API 实时取色并回填表单。

6. 注意事项

• 必须正确配置来源字段，否则自动识别不会执行。

• 来源字段需为图片可解析类型，否则会返回“请上传图片文件”。

• 若后台菜单未立即出现，可执行一次缓存更新/初始化菜单。