---
status: resolved
trigger: "kb-workflow技能添加bilibili视频时，归档的文件名不对，analysis.md文件中的title, duration, author等元数据也不对。"
created: 2026-03-16T00:00:00Z
updated: 2026-03-16T00:10:00Z
resolved: 2026-03-16
---

## Current Focus

hypothesis: 修复已实施并自验证通过
test: 用户需要在实际环境中验证
expecting: 用户确认修复有效
next_action: 等待用户确认

## Symptoms

expected: |
  1. analysis.md 的 frontmatter 应该包含正确的 title, duration, author（从 _metadata.json 获取）
  2. .m4a 音频文件名应该遵循 `平台_BV号` 的规范（如 bilibili_BV16cNMzpExh.m4a）

actual: |
  1. analysis.md 的 frontmatter 显示：
     - title: "未命名" (应该是视频标题)
     - duration: 0 (应该是 07:16 或秒数)
     - author: "未知" (应该是 "阿周的Eureka")
  2. .m4a 文件名是 "2-3月宏观经济运行状态复盘与推演  2026年政府工作报告解读  阿周的Eureka.m4a"
     （应该是 bilibili_BV16cNMzpExh.m4a）

errors: 无显式错误，kb-workflow 命令执行成功，但输出不正确

reproduction: 对 Bilibili 视频 BV16cNMzpExh 运行 kb-workflow process

started: 首次测试时发现

additional_context: |
  _metadata.json 文件中的元数据是正确的：
  - title: "2-3月宏观经济运行状态复盘与推演 + 2026年政府工作报告解读 | 【阿周的Eureka】"
  - author: "阿周的Eureka"
  - duration: "07:16"
  - bvid: "BV16cNMzpExh"

  但 analysis.md 的 frontmatter 没有使用这些数据。

  归档目录位于：kb-workflow/bilibili_BV16cNMzpExh/

## Eliminated

## Evidence

- timestamp: 2026-03-16
  checked: kb-workflow/bilibili_BV16cNMzpExh/bilibili_BV16cNMzpExh_metadata.json
  found: metadata 文件结构正确，title/author/duration 都在 metadata.metadata 下
  implication: 元数据源文件是正确的

- timestamp: 2026-03-16
  checked: kb-workflow/bilibili_BV16cNMzpExh/analysis.md
  found: frontmatter 显示 title="未命名", author="未知", duration=0
  implication: generate_frontmatter() 使用了默认值

- timestamp: 2026-03-16
  checked: kb_pipeline/processors/analyze.py:111-116
  found: _write_analysis_report(metadata=metadata, ...) 传递原始 metadata
  implication: 原始 metadata 是嵌套结构 {metadata: {...}, stats: {...}}

- timestamp: 2026-03-16
  checked: kb-deep-analyzer/deep_analyzer.py:436-470
  found: generate_frontmatter() 使用 metadata.get('title', '未命名')
  implication: 期望扁平结构，但收到嵌套结构，所以取不到值

- timestamp: 2026-03-16
  checked: kb-deep-analyzer/deep_analyzer.py:382-414
  found: _normalize_metadata() 可以正确扁平化嵌套结构
  implication: DeepAnalyzer.analyze() 内部调用了 _normalize_metadata，但 _write_analysis_report() 没有调用

- timestamp: 2026-03-16
  checked: kb_pipeline/platforms/bilibili.py:463-483
  found: _sanitize_filename() 使用视频标题作为文件名
  implication: 文件名不是规范的 bilibili_BV号 格式

- timestamp: 2026-03-16
  checked: 单元测试验证
  found: _normalize_metadata() 和 _sanitize_filename() 修复后测试通过
  implication: 修复逻辑正确

## Resolution

root_cause: |
  问题1 - analysis.md 元数据错误:
  AnalyzeProcessor._write_analysis_report() 直接将原始嵌套 metadata 传递给 generate_frontmatter()，
  而 generate_frontmatter() 期望扁平化的 metadata 结构。
  原始结构: {metadata: {title, author, ...}, stats: {...}}
  期望结构: {title, author, ...}

  问题2 - 音频文件名不规范:
  BilibiliAdapter._sanitize_filename() 使用视频标题作为文件名，
  而不是规范的 "bilibili_BV号" 格式。

fix: |
  问题1: 在 AnalyzeProcessor 中添加 _normalize_metadata() 方法，
  在 _write_analysis_report() 中调用它将嵌套 metadata 扁平化

  问题2: 修改 _sanitize_filename() 返回标准化的 "bilibili_{bvid}" 格式

verification: |
  自验证测试通过：
  - _normalize_metadata() 正确处理嵌套结构，返回扁平化的 metadata
  - generate_frontmatter() 使用扁平化后的 metadata，生成正确的 frontmatter
  - _sanitize_filename() 返回标准化的 "bilibili_BV号" 格式

files_changed:
  - kb_pipeline/processors/analyze.py
  - kb_pipeline/platforms/bilibili.py