BigPizzaV3/CodexPlusPlus · error

主题包需要更新版本的 Dream Skin 协议:{}

Error message

主题包需要更新版本的 Dream Skin 协议:{}

What it means

Thrown by validate_manifest when the package's declared min_client_version compares greater than 1.5.12 — the newest Dream Skin protocol this build implements. It is a forward-compatibility guard: the package demands capabilities this client cannot guarantee, so install is refused; the offending input is manifest.min_client_version.

Source

Thrown at crates/codex-plus-core/src/dream_skin_package.rs:921

        _ => IMAGE_LIMIT,
    }
}

fn validate_manifest(manifest: &DreamSkinPackageManifest, platform: &str) -> anyhow::Result<()> {
    if manifest.package_version != 1 || manifest.skin_api_version != 1 {
        bail!("不支持的 Dream Skin 主题协议版本");
    }
    if manifest.theme_id.chars().count() < 3
        || manifest.theme_id.chars().count() > 64
        || !valid_theme_id(&manifest.theme_id)
    {
        bail!("manifest.themeId 无效");
    }
    if !valid_semver(&manifest.version) || !valid_semver(&manifest.min_client_version) {
        bail!("manifest 版本号无效");
    }
    if compare_semver(&manifest.min_client_version, "1.5.12").is_gt() {
        bail!(
            "主题包需要更新版本的 Dream Skin 协议:{}",
            manifest.min_client_version
        );
    }
    if manifest.platforms.is_empty()
        || manifest.platforms.len() > 2
        || has_duplicates(&manifest.platforms)
        || manifest
            .platforms
            .iter()
            .any(|item| !matches!(item.as_str(), "macos" | "windows"))
    {
        bail!("manifest.platforms 无效");
    }
    if !manifest.platforms.iter().any(|item| item == platform) {
        bail!("主题包不支持当前平台:{platform}");
    }
    if manifest.capabilities.is_empty()

View on GitHub (pinned to f2074595a2)

Solutions

  1. 升级 Codex++ 到主题要求的最低客户端版本
  2. 把 min_client_version 降到 1.5.12 或以下(仅当主题确实不依赖新特性)
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/codex-plus-core/src/dream_skin_package.rs:921 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of BigPizzaV3/CodexPlusPlus@f2074595a2 (2026-08-23). Data as JSON: /api/errors/3561e73f3c0e7b12. Report an issue: GitHub.