# 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. 注意事项

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

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

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