Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

18.1 KB
Raw Blame
use colored::Colorize;
use unicode_width::UnicodeWidthStr;

use crate::{
    config::{Config, display_config_home},
    config_wizard::ConfigKind,
    error::Error,
    i18n::{Language, copy},
    theme,
};

const LABEL_WIDTH: usize = 14;
const ACTION_WIDTH: usize = 26;
const NAME_WIDTH: usize = 17;
const KIND_WIDTH: usize = 18;

#[derive(Debug, Clone)]
pub(crate) struct SwitchConfigRow {
    pub name: String,
    pub kind: ConfigKind,
    pub is_active: bool,
}

pub(crate) fn render_validate_success(config: &Config, active_name: Option<&str>) -> String {
    render_validate_success_with_language(config, active_name, Language::current())
}

pub(crate) fn render_validate_success_with_language(
    config: &Config,
    active_name: Option<&str>,
    language: Language,
) -> String {
    let mut lines = Vec::new();
    let kind = kind_label(ConfigKind::from_config(config), language);
    let active = active_name.unwrap_or_else(|| unknown(language));

    lines.push(title(copy(
        language,
        "OPENVIKING CONFIG CHECK",
        "OPENVIKING 配置检查",
    )));
    lines.push(String::new());
    lines.push(section(copy(language, "Config", "配置")));
    lines.push(detail_line(
        copy(language, "Active", "当前配置"),
        active_value(active, kind),
    ));
    lines.push(detail_line(
        copy(language, "Server", "服务器"),
        path_value(&config.url),
    ));
    lines.push(detail_line(
        copy(language, "Config home", "配置目录"),
        path_value(&display_config_home()),
    ));
    lines.push(String::new());
    lines.push(section(copy(language, "Checks", "检查项")));
    lines.push(detail_line(
        copy(language, "Config file", "配置文件"),
        ok_value(copy(language, "valid", "有效")),
    ));
    lines.push(detail_line(
        copy(language, "Server", "服务器"),
        ok_value(copy(language, "reachable", "可连接")),
    ));
    lines.push(detail_line(
        copy(language, "Auth", "认证"),
        ok_value(copy(language, "accepted", "已通过")),
    ));
    lines.push(detail_line(
        copy(language, "Health", "健康状态"),
        ok_value(copy(language, "healthy", "健康")),
    ));
    lines.push(String::new());
    lines.push(section(copy(language, "Next", "下一步")));
    lines.push(action_line(
        "ov status",
        copy(language, "Full system diagnostics", "查看完整系统诊断"),
    ));
    lines.push(action_line(
        "ov config switch",
        copy(language, "Use another config", "切换到其他配置"),
    ));
    lines.push(action_line(
        "ov config",
        copy(
            language,
            "Add, edit, or delete configs",
            "添加、编辑或删除配置",
        ),
    ));

    format!("{}\n", lines.join("\n"))
}

pub(crate) fn render_validate_failure(
    config: &Config,
    active_name: Option<&str>,
    error: &Error,
) -> String {
    render_validate_failure_with_language(config, active_name, error, Language::current())
}

pub(crate) fn render_validate_failure_with_language(
    config: &Config,
    active_name: Option<&str>,
    error: &Error,
    language: Language,
) -> String {
    let mut lines = Vec::new();
    let kind = kind_label(ConfigKind::from_config(config), language);
    let active = active_name.unwrap_or_else(|| unknown(language));
    let classification = ValidationFailureKind::from_error(error);

    lines.push(title(copy(
        language,
        "OPENVIKING CONFIG CHECK",
        "OPENVIKING 配置检查",
    )));
    lines.push(String::new());
    lines.push(section(copy(language, "Config", "配置")));
    lines.push(detail_line(
        copy(language, "Active", "当前配置"),
        active_value(active, kind),
    ));
    lines.push(detail_line(
        copy(language, "Server", "服务器"),
        path_value(&config.url),
    ));
    lines.push(detail_line(
        copy(language, "Config home", "配置目录"),
        path_value(&display_config_home()),
    ));
    lines.push(String::new());
    lines.push(section(copy(language, "Checks", "检查项")));
    lines.push(detail_line(
        copy(language, "Config file", "配置文件"),
        ok_value(copy(language, "valid", "有效")),
    ));
    lines.push(detail_line(
        copy(language, "Server", "服务器"),
        classification.server_check(language),
    ));
    lines.push(detail_line(
        copy(language, "Auth", "认证"),
        classification.auth_check(language),
    ));
    lines.push(detail_line(
        copy(language, "Health", "健康状态"),
        classification.health_check(language),
    ));
    lines.push(String::new());
    lines.push(section(copy(language, "Issue", "问题")));
    lines.push(format!(
        "  {}",
        theme::error(classification.message(language))
    ));
    lines.push(String::new());
    lines.push(section(copy(language, "Try", "可以尝试")));
    lines.push(action_line(
        "ov health",
        copy(language, "Quick server probe", "快速检查服务器"),
    ));
    lines.push(action_line(
        "ov config",
        copy(language, "Edit this config", "编辑当前配置"),
    ));
    lines.push(action_line(
        "ov config switch",
        copy(language, "Use another config", "切换到其他配置"),
    ));

    format!("{}\n", lines.join("\n"))
}

pub(crate) fn render_switch_header(
    active_name: Option<&str>,
    active_kind: Option<ConfigKind>,
    invalid_config_names: &[String],
) -> String {
    let language = Language::current();
    let mut lines = Vec::new();
    lines.push(title(copy(
        language,
        "OPENVIKING CONFIG SWITCH",
        "OPENVIKING 配置切换",
    )));
    lines.push(String::new());
    match (active_name, active_kind) {
        (Some(name), Some(kind)) => lines.push(format!(
            "{} {}",
            theme::muted(copy(language, "Active:", "当前配置:")),
            active_value(name, kind_label(kind, language))
        )),
        _ => lines.push(format!(
            "{} {}",
            theme::muted(copy(language, "Active:", "当前配置:")),
            unknown_value(copy(language, "none", "无"))
        )),
    }
    if let Some(warning) = invalid_saved_configs_notice(language, invalid_config_names) {
        lines.push(String::new());
        lines.push(warning);
    }
    format!("{}\n", lines.join("\n"))
}

pub(crate) fn switch_labels(rows: &[SwitchConfigRow]) -> Vec<String> {
    let language = Language::current();
    rows.iter()
        .map(|row| {
            let name = theme::command(pad_to_display_width(&row.name, NAME_WIDTH)).bold();
            let kind = theme::strong(pad_to_display_width(
                kind_label(row.kind, language),
                KIND_WIDTH,
            ));
            if row.is_active {
                format!(
                    "{name}{kind}{}",
                    theme::error(copy(language, "[Active]", "[当前]")).bold()
                )
            } else {
                format!("{name}{kind}")
            }
        })
        .collect()
}

pub(crate) fn render_no_saved_configs(invalid_config_names: &[String]) -> String {
    let language = Language::current();
    let mut lines = Vec::new();
    lines.push(title(copy(
        language,
        "OPENVIKING CONFIG SWITCH",
        "OPENVIKING 配置切换",
    )));
    lines.push(String::new());
    lines.push(section(copy(
        language,
        "No saved configs",
        "没有已保存配置",
    )));
    lines.push(format!(
        "  {}",
        theme::muted(copy(
            language,
            "Run ov config to add and save a config first.",
            "请先运行 ov config 添加并保存配置。",
        ))
    ));
    if let Some(warning) = invalid_saved_configs_notice(language, invalid_config_names) {
        lines.push(String::new());
        lines.push(warning);
    }
    format!("{}\n", lines.join("\n"))
}

pub(crate) fn render_switch_success(name: &str) -> String {
    let language = Language::current();
    format!(
        "{} {}\n{}\n",
        theme::success("✓").bold(),
        theme::success(copy_switch_success(language, name)).bold(),
        format!(
            "  {}",
            theme::muted(copy(
                language,
                "Run ov status to inspect it.",
                "运行 ov status 查看状态。"
            ))
        )
    )
}

pub(crate) fn render_switch_validation_failure(name: &str, error: &Error) -> String {
    let language = Language::current();
    let classification = ValidationFailureKind::from_error(error);
    format!(
        "{}\n\n{}\n  {}\n  {}\n\n{}",
        title(copy(
            language,
            "OPENVIKING CONFIG SWITCH",
            "OPENVIKING 配置切换"
        )),
        section(copy(language, "Issue", "问题")),
        theme::error(copy_target_validation_failed(language, name)),
        theme::muted(classification.message(language)),
        action_line(
            "ov config",
            copy(language, "Edit this config", "编辑这个配置")
        )
    )
}

fn unknown(language: Language) -> &'static str {
    copy(language, "unknown", "未知")
}

fn kind_label(kind: ConfigKind, language: Language) -> &'static str {
    match language {
        Language::En => kind.compact_label(),
        Language::ZhCn => match kind {
            ConfigKind::OpenVikingService => "OpenViking 服务",
            ConfigKind::Custom => "自定义",
        },
    }
}

fn copy_switch_success(language: Language, name: &str) -> String {
    match language {
        Language::En => format!("Switched active config to '{name}'."),
        Language::ZhCn => format!("已切换当前配置为 '{name}'。"),
    }
}

fn copy_target_validation_failed(language: Language, name: &str) -> String {
    match language {
        Language::En => format!("Target config '{name}' failed validation."),
        Language::ZhCn => format!("目标配置 '{name}' 验证失败。"),
    }
}

fn invalid_saved_configs_notice(
    language: Language,
    invalid_config_names: &[String],
) -> Option<String> {
    if invalid_config_names.is_empty() {
        return None;
    }

    let names = invalid_config_names.join(", ");
    Some(match language {
        Language::En => format!(
            "  {}",
            theme::warning(format!(
                "Note: Saved configs with damaged JSON structure were skipped: {names}."
            ))
            .bold()
        ),
        Language::ZhCn => format!(
            "  {}",
            theme::warning(format!(
                "提示:以下已保存配置因 JSON 结构损坏已跳过:{names}。"
            ))
            .bold()
        ),
    })
}

fn title(value: &str) -> String {
    theme::brand_title(value).bold().to_string()
}

fn section(value: &str) -> String {
    theme::heading(value).bold().to_string()
}

fn detail_line(label: &str, value: String) -> String {
    let label = theme::muted(pad_to_display_width(label, LABEL_WIDTH));
    format!("  {label}{value}")
}

fn action_line(command: &str, description: &str) -> String {
    let command = theme::command(pad_to_display_width(command, ACTION_WIDTH)).bold();
    format!("  {command}{}", theme::muted(description))
}

fn pad_to_display_width(value: &str, width: usize) -> String {
    format!(
        "{}{}",
        value,
        " ".repeat(width.saturating_sub(UnicodeWidthStr::width(value)))
    )
}

fn active_value(name: &str, kind: &str) -> String {
    format!(
        "{} {}",
        theme::config_name(name).bold(),
        theme::strong(format!("({kind})"))
    )
}

fn path_value(value: &str) -> String {
    theme::value(value).to_string()
}

fn ok_value(value: &str) -> String {
    theme::success(value).bold().to_string()
}

fn warn_value(value: &str) -> String {
    theme::warning(value).bold().to_string()
}

fn fail_value(value: &str) -> String {
    theme::error(value).bold().to_string()
}

fn unknown_value(value: &str) -> String {
    theme::muted(value).to_string()
}

#[derive(Debug, Clone, Copy)]
enum ValidationFailureKind {
    Network,
    Timeout,
    Auth,
    Unhealthy,
    Other,
}

impl ValidationFailureKind {
    fn from_error(error: &Error) -> Self {
        match error {
            Error::Network(message) if message.contains("unhealthy") => Self::Unhealthy,
            Error::Network(_) => Self::Network,
            Error::Timeout(_) => Self::Timeout,
            error @ Error::Api { .. } if error.code() == "UNAUTHENTICATED" => Self::Auth,
            _ => Self::Other,
        }
    }

    fn server_check(self, language: Language) -> String {
        match self {
            Self::Network => fail_value(copy(language, "unreachable", "无法连接")),
            Self::Timeout => fail_value(copy(language, "timed out", "超时")),
            Self::Auth | Self::Unhealthy => ok_value(copy(language, "reachable", "可连接")),
            Self::Other => warn_value(unknown(language)),
        }
    }

    fn auth_check(self, language: Language) -> String {
        match self {
            Self::Auth => fail_value(copy(language, "rejected", "被拒绝")),
            Self::Network | Self::Timeout => warn_value(copy(language, "not checked", "未检查")),
            Self::Unhealthy => ok_value(copy(language, "accepted", "已通过")),
            Self::Other => warn_value(unknown(language)),
        }
    }

    fn health_check(self, language: Language) -> String {
        match self {
            Self::Unhealthy => fail_value(copy(language, "unhealthy", "不健康")),
            Self::Network | Self::Timeout | Self::Auth => {
                warn_value(copy(language, "not checked", "未检查"))
            }
            Self::Other => warn_value(unknown(language)),
        }
    }

    fn message(self, language: Language) -> &'static str {
        match language {
            Language::En => match self {
                Self::Network => "Could not reach the configured OpenViking server.",
                Self::Timeout => {
                    "OpenViking did not respond before the configured timeout expired."
                }
                Self::Auth => "OpenViking rejected the API key for this config.",
                Self::Unhealthy => "OpenViking is reachable but reported an unhealthy state.",
                Self::Other => "The active config could not be validated.",
            },
            Language::ZhCn => match self {
                Self::Network => "无法连接已配置的 OpenViking 服务器。",
                Self::Timeout => "OpenViking 未在配置的超时时间内响应。",
                Self::Auth => "OpenViking 拒绝了这个配置的 API Key。",
                Self::Unhealthy => "服务器可连接,但健康状态异常。",
                Self::Other => "当前配置验证失败。",
            },
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::{config::Config, config_wizard::ConfigKind, error::Error};

    #[test]
    fn validate_success_rendering_is_styled_and_actionable() {
        let config = sample_config();

        colored::control::set_override(true);
        let rendered = super::render_validate_success(&config, Some("VPS"));
        colored::control::unset_override();

        assert!(rendered.contains("\u{1b}["));

        let plain = strip_ansi(&rendered);
        assert!(plain.contains("OPENVIKING CONFIG CHECK"));
        assert!(plain.contains("Active        VPS (Custom)"));
        assert!(plain.contains("Server        http://127.0.0.1:1933"));
        assert!(plain.contains("Config file   valid"));
        assert!(plain.contains("Server        reachable"));
        assert!(plain.contains("Auth          accepted"));
        assert!(plain.contains("Health        healthy"));
        assert!(plain.contains("ov status                 Full system diagnostics"));
        assert!(plain.contains("ov config switch          Use another config"));
    }

    #[test]
    fn validate_failure_rendering_hides_raw_error_and_suggests_recovery() {
        let config = sample_config();
        let error = Error::Network("connection refused at 127.0.0.1:1933".to_string());

        let rendered = super::render_validate_failure(&config, Some("VPS"), &error);
        let plain = strip_ansi(&rendered);

        assert!(plain.contains("OPENVIKING CONFIG CHECK"));
        assert!(plain.contains("Server        unreachable"));
        assert!(plain.contains("Auth          not checked"));
        assert!(plain.contains("Could not reach the configured OpenViking server."));
        assert!(plain.contains("ov health                 Quick server probe"));
        assert!(!plain.contains("connection refused"));
    }

    #[test]
    fn switch_labels_mark_active_once_without_url() {
        let labels = super::switch_labels(&[
            super::SwitchConfigRow {
                name: "local".to_string(),
                kind: ConfigKind::Custom,
                is_active: true,
            },
            super::SwitchConfigRow {
                name: "ov-service-799f84".to_string(),
                kind: ConfigKind::OpenVikingService,
                is_active: false,
            },
        ]);

        let plain = strip_ansi(&labels.join("\n"));
        assert!(plain.lines().any(|line| line.contains("local")
            && line.contains("Custom")
            && line.contains("[Active]")));
        assert!(plain.lines().any(|line| line.contains("ov-service-799f84")
            && line.contains("OpenViking Service")
            && !line.contains("VolcEngine Cloud")
            && !line.contains("[Active]")));
        assert_eq!(plain.matches("[Active]").count(), 1);
        assert!(!plain.contains("http://"));
        assert!(!plain.contains("https://"));
    }

    fn sample_config() -> Config {
        Config {
            url: "http://127.0.0.1:1933".to_string(),
            ..Config::default()
        }
    }

    fn strip_ansi(input: &str) -> String {
        let mut output = String::with_capacity(input.len());
        let mut chars = input.chars().peekable();

        while let Some(ch) = chars.next() {
            if ch == '\u{1b}' && chars.peek() == Some(&'[') {
                chars.next();
                for next in chars.by_ref() {
                    if next.is_ascii_alphabetic() {
                        break;
                    }
                }
                continue;
            }
            output.push(ch);
        }

        output
    }
}