BigPizzaV3/CodexPlusPlus · error

theme.json 与 manifest 身份或背景图不一致

Error message

theme.json 与 manifest 身份或背景图不一致

What it means

Thrown by validate_theme during cross-file consistency checks: theme.json's schemaVersion is not 1, its id does not equal manifest.theme_id, name is missing/not a string, or image does not equal the package's actual image filename. The offending input is the mismatch between theme.json identity fields and the manifest/image_name arguments; the three files of a package must describe the same theme.

Source

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

        "promoSub",
        "promoUrl",
        "appearance",
        "art",
        "colors",
    ];
    if REQUIRED.iter().any(|key| !object.contains_key(*key))
        || object
            .keys()
            .any(|key| !REQUIRED.contains(&key.as_str()) && !OPTIONAL.contains(&key.as_str()))
    {
        bail!("theme.json 包含缺失或不支持的字段");
    }
    if object.get("schemaVersion").and_then(Value::as_u64) != Some(1)
        || object.get("id").and_then(Value::as_str) != Some(manifest.theme_id.as_str())
        || object.get("name").and_then(Value::as_str).is_none()
        || object.get("image").and_then(Value::as_str) != Some(image_name)
    {
        bail!("theme.json 与 manifest 身份或背景图不一致");
    }
    if object
        .get("name")
        .and_then(Value::as_str)
        .is_some_and(|name| !safe_manifest_text(name, 1, 80, false))
    {
        bail!("theme.json.name 无效");
    }
    for key in [
        "brandSubtitle",
        "tagline",
        "projectPrefix",
        "projectLabel",
        "statusText",
        "quote",
        "promoTitle",
        "promoSub",
    ] {

View on GitHub (pinned to f2074595a2)

Solutions

1. 把 theme.json 的 id 改为与 manifest.themeId 一致
2. 把 image 字段改为实际包含的背景图文件名
3. 确认 schemaVersion 为 1 且 name 非空

When it happens

Trigger: Thrown at crates/codex-plus-core/src/dream_skin_package.rs:1015 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/9620df49a2a212d2. Report an issue: GitHub.