/wps-conditional-format

name: wps-conditional-format
description: |
  表格自动变色。想让低于60分的自动变红？想加个进度条效果？想要红绿灯图标？
  帮你设置条件格式，数据条、色阶、图标集、重复值高亮，还提供JSA宏代码。
  用于帮助用户设置表格条件格式。当用户提到条件格式、自动变色、数据条、红绿灯时触发。
  Conditional formatting expert - data bars, color scales, icon sets, and rules.
license: MIT
user-invocable: true
argument-hint: '[格式需求描述]'
allowed-tools: 'Read, Grep, Glob, Bash, Write, Edit'
metadata:
  author: BWKYD
  title: 条件格式设置
  description_zh: 设置表格条件格式，比如不及格标红、数据条、图标集等
  tags:
    - 条件格式
    - 高亮
    - 数据条
    - Excel
    - WPS
  version: 1.0.1
  license: MIT

条件格式专家

让数据自动变色、加图标、显示数据条。一看就懂。

> "领导要的那种红绿灯效果，就是条件格式。"

When to Use

• 数据自动变色（如负数变红）
• 进度条/数据条效果
• 红绿灯/图标集
• 重复值高亮
• 用户说"怎么让数据自动变色""加个红绿灯"

When NOT to Use

• 图表可视化 → 使用 `wps-chart`
• 公式问题 → 使用 `wps-formula`

常用条件格式场景

场景1：数值范围变色

需求：成绩≥90绿色，60-89正常，<60红色

openpyxl方式：

from openpyxl import load_workbook
from openpyxl.formatting.rule import CellIsRule
from openpyxl.styles import PatternFill

wb = load_workbook('scores.xlsx')
ws = wb.active

red = PatternFill(start_color='FF6B6B', end_color='FF6B6B', fill_type='solid')
green = PatternFill(start_color='51CF66', end_color='51CF66', fill_type='solid')
yellow = PatternFill(start_color='FFD43B', end_color='FFD43B', fill_type='solid')

ws.conditional_formatting.add('C2:C100',
    CellIsRule(operator='greaterThanOrEqual', formula=['90'], fill=green))
ws.conditional_formatting.add('C2:C100',
    CellIsRule(operator='lessThan', formula=['60'], fill=red))

wb.save('scores_formatted.xlsx')

JSA宏方式：

function HighlightScores() {
    var ws = Application.ActiveSheet;
    var range = ws.Range("C2:C100");
    range.FormatConditions.Delete(); // 清除旧规则

    // >=90 绿色
    var fc1 = range.FormatConditions.Add(1, 5, "90"); // xlCellValue, xlGreaterEqual
    fc1.Interior.Color = 0x66CF51; // BGR绿色

    // <60 红色
    var fc2 = range.FormatConditions.Add(1, 6, "60"); // xlCellValue, xlLess
    fc2.Interior.Color = 0x6B6BFF; // BGR红色

    Application.alert("条件格式已设置！");
}

场景2：数据条（进度条效果）

from openpyxl.formatting.rule import DataBarRule

ws.conditional_formatting.add('D2:D50',
    DataBarRule(start_type='min', end_type='max',
               color='3498DB', showValue=True))

// JSA: 添加数据条
function AddDataBar() {
    var range = Application.ActiveSheet.Range("D2:D50");
    range.FormatConditions.Delete();
    range.FormatConditions.AddDatabar();
    var db = range.FormatConditions.Item(1);
    db.BarColor.Color = 0xDB9834; // BGR蓝色
}

场景3：重复值高亮

from openpyxl.formatting.rule import FormulaRule

ws.conditional_formatting.add('A2:A100',
    FormulaRule(formula=['COUNTIF($A$2:$A$100,A2)>1'],
               fill=PatternFill('solid', fgColor='FFD43B')))

// JSA: 高亮重复值
function HighlightDuplicates() {
    var range = Application.ActiveSheet.Range("A2:A100");
    range.FormatConditions.Delete();
    var fc = range.FormatConditions.AddUniqueValues();
    fc.DupeUnique = 1; // xlDuplicate
    fc.Interior.Color = 0x3BD4FF; // BGR黄色
}

场景4：图标集（红绿灯）

// JSA: 红绿灯图标集
function AddTrafficLights() {
    var range = Application.ActiveSheet.Range("E2:E50");
    range.FormatConditions.Delete();
    var fc = range.FormatConditions.AddIconSetCondition();
    fc.IconSet = Application.ActiveWorkbook.IconSets(1); // 红绿灯
    // 自定义阈值
    fc.IconCriteria(2).Value = 60;
    fc.IconCriteria(3).Value = 90;
}

场景5：隔行变色（斑马纹）

from openpyxl.formatting.rule import FormulaRule

stripe = PatternFill('solid', fgColor='F0F4F8')
ws.conditional_formatting.add('A2:G100',
    FormulaRule(formula=['MOD(ROW(),2)=0'], fill=stripe))

条件格式速查表

| 需求 | 类型 | 关键参数 | |------|------|----------| | 大于/小于变色 | CellIsRule | operator + formula | | 包含特定文字 | FormulaRule | SEARCH函数 | | 重复值高亮 | UniqueValues | DupeUnique=1 | | 前N名/后N名 | Top10Rule | rank + percent | | 数据条 | DataBarRule | color | | 色阶(渐变色) | ColorScaleRule | start/mid/end_color | | 图标集 | IconSetCondition | IconSet类型 | | 日期到期提醒 | FormulaRule | TODAY()比较 | | 隔行变色 | FormulaRule | MOD(ROW(),2) |

工作流程

Step 1: 理解需求

确认要格式化的范围和条件

Step 2: 选择方案

• openpyxl → 生成新文件
• JSA宏 → 在WPS中直接运行

Step 3: 生成代码并说明

Step 4: 交付

1. 提供代码（二选一或两种都给） 2. 说明如何修改阈值和颜色 3. 注意事项（规则优先级、性能影响）

示例

# 数值变色
/wps-conditional-format 让销售额低于目标的变红色，超过的变绿色

# 数据条
/wps-conditional-format 给完成率列加个进度条效果

# 重复值
/wps-conditional-format 帮我找出A列有哪些重复的数据