from typing import Any from cli.tui.adapters.base import BaseBrowserAdapter from cli.tui.adapters.models import ( TUI_ADAPTER_MODEL_RENDERER, BrowserPageSnapshot, BrowserRecordSnapshot, DetailSectionSnapshot, ) from cli.tui.copy import TUI_COPY from cli.tui.diagnostics import TUI_DIAGNOSTIC_SERVICE from cli.utils import NESTED_CLI_SUPPORT, SHELL_TEXT_FORMATTER class CacheRowExtractor: """ 缓存浏览行提取器。 该对象负责从缓存统计结果中提取缓存名称列表，供共享分区和记录构建 逻辑复用。 """ @staticmethod def extract_cache_name_rows(payload: dict[str, Any] | None) -> list[dict[str, Any]]: """ 从缓存统计结果中提取缓存名称列表。 :param payload: `cache stats` JSON 负载 :return: 缓存名称行列表 """ if not isinstance(payload, dict): return [] cache_names = payload.get('cacheNames') if not isinstance(cache_names, list): return [] rows: list[dict[str, Any]] = [] for item in cache_names: if isinstance(item, dict): rows.append(item) continue if isinstance(item, str): rows.append({'cacheName': item, 'remark': ''}) return rows class CacheSectionBuilder: """ 缓存浏览页分区构建器。 该构建器负责构建缓存浏览页共享分区，以及单个缓存名前缀下的键摘要、 键列表和键详情分区。 :param page_adapter: 缓存浏览页适配器 :param row_extractor: 缓存浏览行提取器 """ def __init__( self, page_adapter: BaseBrowserAdapter, row_extractor: CacheRowExtractor | None = None, ) -> None: """ 初始化缓存浏览页分区构建器。 :param page_adapter: 缓存浏览页适配器 :param row_extractor: 缓存浏览行提取器 :return: None """ self.page_adapter = page_adapter self.row_extractor = row_extractor or CacheRowExtractor() def build_overview_section(self, payload: dict[str, Any] | None) -> DetailSectionSnapshot: """ 构建缓存总览共享分区。 :param payload: `cache stats` JSON 负载 :return: 分区快照 """ info = payload.get('info') if isinstance(payload, dict) and isinstance(payload.get('info'), dict) else {} cache_rows = self.row_extractor.extract_cache_name_rows(payload) return DetailSectionSnapshot( title='Redis 摘要', status='ok' if isinstance(payload, dict) and payload.get('ok', False) else 'fail', lines=[ '## 容量状态', f'当前键数: {payload.get("dbSize", "-") if isinstance(payload, dict) else "-"}', f'已登记缓存名: {len(cache_rows)} 个', '', '## 运行指标', f'Redis 版本: {info.get("redis_version", "-")}', f'客户端连接数: {info.get("connected_clients", "-")}', f'内存占用: {info.get("used_memory_human", info.get("used_memory", "-"))}', ], ) def build_overview_judgement_section( self, payload: dict[str, Any] | None, filtered_rows: list[dict[str, Any]], ) -> DetailSectionSnapshot: """ 构建缓存页总览判断共享分区。 :param payload: `cache stats` JSON 负载 :param filtered_rows: 当前筛选后的缓存名列表 :return: 分区快照 """ info = payload.get('info') if isinstance(payload, dict) and isinstance(payload.get('info'), dict) else {} cache_rows = self.row_extractor.extract_cache_name_rows(payload) db_size = payload.get('dbSize', '-') if isinstance(payload, dict) else '-' client_count = info.get('connected_clients', '-') command_stats = payload.get('commandStats') if isinstance(payload, dict) else None command_count = len(command_stats) if isinstance(command_stats, list) else 0 status = 'ok' conclusion = '缓存基线正常，可继续查看键列表、键值样本与 TTL' if not isinstance(payload, dict) or not payload.get('ok', False): status = 'fail' conclusion = '缓存状态读取失败，优先确认 Redis 连通性与运行环境' elif not cache_rows: status = 'info' conclusion = '当前没有登记的缓存名前缀，可先核对缓存配置与实际键空间' elif not filtered_rows: status = 'info' conclusion = '当前搜索条件没有命中缓存名前缀，可调整关键字后继续排查' return DetailSectionSnapshot( title='总览判断', status=status, lines=[ '## 当前结论', conclusion, '', '## 核心指标', f'已登记缓存名: {len(cache_rows)} 个', f'当前匹配: {len(filtered_rows)} 个', f'Redis 键数: {db_size}', f'客户端连接数: {client_count}', f'命令统计样本: {command_count} 组', '', '## 建议入口', '优先关注：Redis 摘要 / 命令统计 / 键值样本 / TTL', ], ) def build_top_commands_section(self, payload: dict[str, Any] | None) -> DetailSectionSnapshot: """ 构建缓存命令统计共享分区。 :param payload: `cache stats` JSON 负载 :return: 分区快照 """ command_stats = payload.get('commandStats') if isinstance(payload, dict) else None lines = TUI_ADAPTER_MODEL_RENDERER.build_empty_lines( empty_label='命令统计', empty_value='暂无数据', detail='当前 Redis 运行快照中未返回命令统计样本', ) section_status = 'info' if isinstance(command_stats, list) and command_stats: section_status = 'ok' lines = [ f'{item.get("name", "-")} · {item.get("value", 0)} 次' for item in command_stats[:8] if isinstance(item, dict) ] return DetailSectionSnapshot( title='命令统计', status=section_status if isinstance(payload, dict) and payload.get('ok', False) else 'fail', lines=lines, ) @staticmethod def build_cache_clear_entry_section() -> DetailSectionSnapshot: """ 构建缓存清理向导入口分区。 :return: 分区快照 """ return DetailSectionSnapshot( title='缓存清理入口', status='info', lines=TUI_COPY.build_command_hint_lines( scenario='当缓存命中异常、键数量失控，或需要按缓存名和前缀清理时，应先通过向导确认影响范围。', command=TUI_COPY.build_cli_command_hint('wizard', 'cache-clear', '--output=text'), guide='向导会继续询问环境、缓存名、键前缀和 dry-run 选项，确认后再执行实际清理。', ), ) def build_keys_summary_section(self, payload: dict[str, Any] | None) -> DetailSectionSnapshot: """ 构建缓存键摘要分区。 :param payload: `cache keys` JSON 负载 :return: 分区快照 """ if not isinstance(payload, dict) or not payload.get('ok', False): return DetailSectionSnapshot( title='键摘要', status='fail', lines=TUI_ADAPTER_MODEL_RENDERER.build_failure_lines( payload, empty_label='键摘要', empty_value='不可用' ), ) keys = payload.get('keys') if isinstance(payload.get('keys'), list) else [] rendered_keys = [str(item).strip() for item in keys if str(item).strip()] lines = [ '## 统计', f'缓存名: {payload.get("cacheName", "-")}', f'键数量: {payload.get("count", len(rendered_keys))}', ] if rendered_keys: lines.extend( ['', '## 键样本', *[f'> {SHELL_TEXT_FORMATTER.truncate_text(item, 64)}' for item in rendered_keys[:5]]] ) else: lines.extend(['', '## 键样本', '> 当前缓存名前缀下没有键']) return DetailSectionSnapshot( title='键摘要', status='ok', lines=lines, ) def build_keys_section(self, payload: dict[str, Any] | None) -> DetailSectionSnapshot: """ 构建缓存键列表分区。 :param payload: `cache keys` JSON 负载 :return: 分区快照 """ if not isinstance(payload, dict) or not payload.get('ok', False): return DetailSectionSnapshot( title='键列表', status='fail', lines=TUI_ADAPTER_MODEL_RENDERER.build_failure_lines( payload, empty_label='键列表', empty_value='不可用' ), ) keys = payload.get('keys') if isinstance(payload.get('keys'), list) else [] lines = [ SHELL_TEXT_FORMATTER.truncate_text(item, 88) for item in keys[:12] if str(item).strip() ] or TUI_ADAPTER_MODEL_RENDERER.build_empty_lines( empty_label='缓存键', empty_value='0 个', detail='当前缓存名前缀下没有可展示的缓存键', ) return DetailSectionSnapshot( title='键列表', status='ok', lines=lines, ) def render_ttl_text(self, payload: dict[str, Any] | None) -> str: """ 渲染缓存 TTL 文本。 :param payload: `cache ttl` JSON 负载 :return: TTL 文本 """ if not isinstance(payload, dict) or not payload.get('ok', False): return SHELL_TEXT_FORMATTER.truncate_text(self.page_adapter.extract_payload_message(payload), 56) ttl_seconds = payload.get('ttlSeconds', '-') if payload.get('persistent', False): return '永久' if payload.get('expires', False): return f'{ttl_seconds} 秒' return str(ttl_seconds) def build_key_detail_sections( self, cache_name: str, key_items: list[str], env: str, ) -> list[DetailSectionSnapshot]: """ 构建按缓存键展开的详情分区。 :param cache_name: 缓存名称 :param key_items: 缓存键列表 :param env: 当前运行环境 :return: 分区快照列表 """ if not key_items: return [] sections: list[DetailSectionSnapshot] = [] for cache_key in key_items[:5]: value_payload = NESTED_CLI_SUPPORT.run( 'cache', 'get', cache_name, cache_key, f'--env={env}', '--output=json', parse_json=True, ).payload ttl_payload = NESTED_CLI_SUPPORT.run( 'cache', 'ttl', cache_name, cache_key, f'--env={env}', '--output=json', parse_json=True, ).payload value_ok = isinstance(value_payload, dict) and value_payload.get('ok', False) ttl_ok = isinstance(ttl_payload, dict) and ttl_payload.get('ok', False) if value_ok and ttl_ok: section_status = 'ok' elif value_ok or ttl_ok: section_status = 'warn' else: section_status = 'fail' cache_value = ( '' if not value_ok or value_payload.get('cacheValue') is None else str(value_payload.get('cacheValue')) ) preview_lines = cache_value.splitlines()[:6] ttl_text = self.render_ttl_text(ttl_payload) lines = [ '## 键信息', f'缓存名: {cache_name}', f'缓存键: {SHELL_TEXT_FORMATTER.truncate_text(cache_key, 72)}', f'TTL: {ttl_text}', '', '## 值预览', ] if value_ok: lines.extend( [f'> {SHELL_TEXT_FORMATTER.truncate_text(line, 72)}' for line in preview_lines] if preview_lines else ['> -'] ) else: lines.append( f'> {SHELL_TEXT_FORMATTER.truncate_text(self.page_adapter.extract_payload_message(value_payload), 72)}' ) if not ttl_ok: lines.extend( [ '', '## TTL 结果', f'> {SHELL_TEXT_FORMATTER.truncate_text(self.page_adapter.extract_payload_message(ttl_payload), 72)}', ] ) sections.append( DetailSectionSnapshot( title=f'键详情 · {SHELL_TEXT_FORMATTER.truncate_text(cache_key, 28)}', status=section_status, lines=lines, ) ) return sections def load_cache_detail_sections( self, cache_row: dict[str, Any], env: str, ) -> list[DetailSectionSnapshot]: """ 按需加载单个缓存名称的详情分区。 :param cache_row: 缓存名称行数据 :param env: 当前运行环境 :return: 详情分区列表 """ cache_name = str(cache_row.get('cacheName', '-') or '-') keys_payload = NESTED_CLI_SUPPORT.run( 'cache', 'keys', cache_name, f'--env={env}', '--output=json', parse_json=True, ).payload key_items: list[str] = [] if isinstance(keys_payload, dict) and keys_payload.get('ok', False): raw_keys = keys_payload.get('keys') if isinstance(keys_payload.get('keys'), list) else [] key_items = [str(item).strip() for item in raw_keys if str(item).strip()] return [ self.build_keys_summary_section(keys_payload), self.build_keys_section(keys_payload), *self.build_key_detail_sections(cache_name, key_items, env), ] def build_shared_sections( self, payload: dict[str, Any] | None, filtered_rows: list[dict[str, Any]], ) -> list[DetailSectionSnapshot]: """ 构建缓存浏览页共享分区。 :param payload: `cache stats` 结果负载 :param filtered_rows: 当前筛选后的缓存名列表 :return: 共享分区列表 """ return [ self.build_overview_judgement_section(payload, filtered_rows), self.build_overview_section(payload), self.build_top_commands_section(payload), self.build_cache_clear_entry_section(), ] class CacheRecordBuilder: """ 缓存浏览记录构建器。 该对象负责构建缓存页单条浏览记录与失败兜底记录。 :param page_adapter: 缓存浏览页适配器 :param section_builder: 缓存浏览页分区构建器 """ def __init__( self, page_adapter: BaseBrowserAdapter, section_builder: CacheSectionBuilder, ) -> None: """ 初始化缓存浏览记录构建器。 :param page_adapter: 缓存浏览页适配器 :param section_builder: 缓存浏览页分区构建器 :return: None """ self.page_adapter = page_adapter self.section_builder = section_builder def build_record(self, cache_row: dict[str, Any], env: str) -> BrowserRecordSnapshot: """ 构建单条缓存浏览记录。 :param cache_row: 缓存名称行数据 :param env: 当前运行环境 :return: 浏览记录快照 """ cache_name = str(cache_row.get('cacheName', '-') or '-') remark = str(cache_row.get('remark', '') or '').strip() return BrowserRecordSnapshot( key=f'cache:{cache_name}', title=SHELL_TEXT_FORMATTER.truncate_text(cache_name, 40), status='ok', summary=SHELL_TEXT_FORMATTER.truncate_text(remark or '查看当前缓存名前缀下的键、值样本和过期时间', 64), metadata_lines=[ '## 缓存身份', f'缓存名称: {cache_name}', f'用途说明: {SHELL_TEXT_FORMATTER.truncate_text(remark or "-", 64)}', ], detail_sections=[], detail_loader=lambda cache_row=cache_row, env=env: self.section_builder.load_cache_detail_sections( cache_row, env ), ) def build_failure_record(self, payload: dict[str, Any] | None) -> BrowserRecordSnapshot: """ 构建缓存页失败兜底记录。 :param payload: 失败结果负载 :return: 浏览记录快照 """ return self.page_adapter.build_failure_record( key='cache:unavailable', subject='缓存', section_subject='缓存状态', payload=payload, ) class CacheBrowserAdapter(BaseBrowserAdapter): """ 缓存浏览页适配器。 该适配器负责采集 Redis 统计和缓存名前缀列表，并委托协作对象构建 共享分区、单条记录与键详情分区。 """ def __init__( self, row_extractor: CacheRowExtractor | None = None, section_builder: CacheSectionBuilder | None = None, record_builder: CacheRecordBuilder | None = None, ) -> None: """ 初始化缓存浏览页适配器。 :param row_extractor: 缓存浏览行提取器 :param section_builder: 缓存浏览页分区构建器 :param record_builder: 缓存浏览记录构建器 :return: None """ super().__init__( page_title='缓存', search_view_key='cache', filter_options=(), ) self.row_extractor = row_extractor or CacheRowExtractor() self.section_builder = section_builder or CacheSectionBuilder(self, self.row_extractor) self.record_builder = record_builder or CacheRecordBuilder(self, self.section_builder) @staticmethod def apply_cache_query(rows: list[dict[str, Any]], query: str) -> list[dict[str, Any]]: """ 按缓存名或备注查询词过滤缓存行数据。 :param rows: 原始缓存行列表 :param query: 当前搜索词 :return: 过滤后的缓存行列表 """ normalized_query = str(query).strip().lower() if not normalized_query: return rows return [ row for row in rows if normalized_query in str(row.get('cacheName', '') or '').strip().lower() or normalized_query in str(row.get('remark', '') or '').strip().lower() ] def collect_snapshot(self, env: str, query: str = '') -> BrowserPageSnapshot: """ 采集缓存浏览页只读快照。 :param env: 当前运行环境 :param query: 当前搜索词 :return: 浏览页快照 """ search_context = self.resolve_search_context(query) payload = NESTED_CLI_SUPPORT.run( 'cache', 'stats', f'--env={env}', '--output=json', parse_json=True, ).payload cache_rows = self.row_extractor.extract_cache_name_rows(payload) filtered_rows = self.apply_cache_query(cache_rows, query) shared_sections = self.section_builder.build_shared_sections(payload, filtered_rows) if not isinstance(payload, dict) or not payload.get('ok', False): return BrowserPageSnapshot( title='缓存', subtitle=TUI_COPY.build_unavailable_subtitle( '缓存状态', SHELL_TEXT_FORMATTER.truncate_text(self.extract_payload_message(payload), 72), ), records=[self.record_builder.build_failure_record(payload)], shared_sections=shared_sections, search=search_context, ) records = [self.record_builder.build_record(cache_row, env) for cache_row in filtered_rows[:12]] if not records: records = [ self.build_empty_record( key='cache:none', subject='缓存名', empty_label='缓存名前缀', has_source_rows=bool(cache_rows), filtered_summary='当前搜索条件下没有匹配缓存名前缀', empty_summary='当前运行环境没有登记可浏览的缓存名前缀', filtered_empty_value='暂无匹配', empty_empty_value='暂无登记', filtered_detail='当前搜索条件下没有匹配缓存名前缀', empty_detail='当前运行环境没有登记可浏览的缓存名前缀', ) ] return BrowserPageSnapshot( title='缓存', subtitle=TUI_DIAGNOSTIC_SERVICE.build_cache_diagnostic_subtitle(payload, len(filtered_rows)), records=records, shared_sections=shared_sections, search=search_context, ) CACHE_BROWSER_ADAPTER = CacheBrowserAdapter()