Java实现tmux兼容24位RGB转xterm-256颜色相关问题咨询

tmux采用的xterm-256映射逻辑完全遵循xterm官方的颜色分层规则，分为三个部分：

• 0-15：16种基础ANSI 4位颜色
• 16-231：6×6×6的RGB颜色立方体，每个RGB通道分为6级，对应实际亮度值为[0, 95, 135, 175, 215, 255]
• 232-255：24阶连续灰度，亮度从8到238按步长10递增
  映射时分别计算输入RGB与立方体最接近颜色、灰度阶最接近颜色的颜色距离（为了性能直接用平方差对比，不需要开方），取距离更小的对应色号作为结果。

对齐上述逻辑的Java实现如下，返回值为byte类型：

public class Xterm256Converter {
    private static final int[] CUBE_STEPS = {0, 95, 135, 175, 215, 255};
    private static final int[] GRAY_STEPS = new int[24];

    static {
        for (int i = 0; i < 24; i++) {
            GRAY_STEPS[i] = 8 + i * 10;
        }
    }

    /**
     * 24位RGB转tmux/xterm标准256色
     * @param r 红色通道 取值0-255
     * @param g 绿色通道 取值0-255
     * @param b 蓝色通道 取值0-255
     * @return xterm-256色值，byte类型；需要无符号值时可通过`res & 0xFF`转成0-255范围的int
     */
    public static byte rgbToXterm256(int r, int g, int b) {
        // 匹配6x6x6立方体最接近色
        int rCubeIdx = findNearestIndex(CUBE_STEPS, r);
        int gCubeIdx = findNearestIndex(CUBE_STEPS, g);
        int bCubeIdx = findNearestIndex(CUBE_STEPS, b);
        int cubeCode = 16 + rCubeIdx * 36 + gCubeIdx * 6 + bCubeIdx;
        int cubeDist = calcColorDistance(r, g, b,
                CUBE_STEPS[rCubeIdx], CUBE_STEPS[gCubeIdx], CUBE_STEPS[bCubeIdx]);

        // 匹配灰度阶最接近色
        int grayAvg = (r + g + b) / 3;
        int grayIdx = findNearestIndex(GRAY_STEPS, grayAvg);
        int grayCode = 232 + grayIdx;
        int grayDist = calcColorDistance(r, g, b,
                GRAY_STEPS[grayIdx], GRAY_STEPS[grayIdx], GRAY_STEPS[grayIdx]);

        return (byte) (cubeDist <= grayDist ? cubeCode : grayCode);
    }

    private static int findNearestIndex(int[] arr, int target) {
        int bestIdx = 0;
        int minDiff = Integer.MAX_VALUE;
        for (int i = 0; i < arr.length; i++) {
            int diff = Math.abs(target - arr[i]);
            if (diff < minDiff) {
                minDiff = diff;
                bestIdx = i;
            }
        }
        return bestIdx;
    }

    private static int calcColorDistance(int r1, int g1, int b1, int r2, int g2, int b2) {
        int dr = r1 - r2;
        int dg = g1 - g2;
        int db = b1 - b2;
        return dr*dr + dg*dg + db*db;
    }
}

• 通用性：该实现完全对齐xterm-256官方规范和tmux的映射逻辑，所有声明支持xterm-256color的终端（包括主流的Windows Terminal、iTerm2、GNOME Terminal、Konsole、tmux、screen等）都能正确渲染，仅0-15号基础色可能受用户自定义主题影响，16-255号色的跨终端一致性非常高，没有兼容性问题。
• 落地必要性：终端彩色输出的多级兜底是行业通用方案，优先级建议为：优先检测终端是否支持24位真彩色，支持则直接输出RGB值；不支持则使用上述256色转换逻辑；仅当终端明确仅支持16色（如传统Linux tty、老旧串口终端）时，再降级到4位ANSI颜色。
• 4位色兜底的适用场景：不建议跳过256色直接用4位色兜底，256色的色彩还原度、内容辨识度远高于16色，直接降级到4位色会让支持256色的终端显示效果大幅下降，仅在终端能力明确不支持256色时再使用4位色即可。

内容的提问来源于stack exchange，提问作者jredfox_