novel-maker 2.2.0

package/skill/scripts/reviewer/subplot_tracker.py

@@ -0,0 +1,207 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+支线追踪器
+追踪小说中的支线剧情发展状态，检测未回收的伏笔和断裂的支线。
+供复盘师在卷末复盘时使用，或规划师在规划新支线时参考。
+
+用法:
+    python scripts/reviewer/subplot_tracker.py 章节目录 --json
+    python scripts/reviewer/subplot_tracker.py 章节目录 --verbose
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+from collections import defaultdict
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'common'))
+from nm_utils import (
+    list_chapters, read_chapter, extract_characters, extract_locations,
+    detect_hook, count_chinese
+)
+
+# ─── 支线类型定义 ───────────────────────────────
+SUBPLOT_PATTERNS = {
+    '感情线': {
+        'keywords': ['喜欢', '爱', '情', '心动', '暗恋', '表白', '分手', '复合', '婚姻'],
+        'indicators': ['两人独处', '眼神交流', '心跳加速', '脸红', '牵手']
+    },
+    '复仇线': {
+        'keywords': ['仇', '恨', '报复', '凶手', '仇人', '血债', '讨回'],
+        'indicators': ['调查真相', '寻找证据', '准备复仇', ' confrontation']
+    },
+    '成长线': {
+        'keywords': ['修炼', '突破', '进阶', '领悟', '提升', '实力'],
+        'indicators': ['闭关', '顿悟', '突破瓶颈', '新技能']
+    },
+    '阴谋线': {
+        'keywords': ['阴谋', '计划', '暗中', '秘密', '隐藏', '真相'],
+        'indicators': ['密谋', '布局', '暗中观察', '设局']
+    },
+    '冒险线': {
+        'keywords': ['探险', '寻宝', '秘境', '遗迹', '未知', '危险'],
+        'indicators': ['出发', '探索', '发现', '遭遇危险']
+    }
+}
+
+
+def detect_subplot_mentions(text):
+    """Detect subplot mentions in text."""
+    mentions = defaultdict(list)
+
+    for subplot_type, config in SUBPLOT_PATTERNS.items():
+        for keyword in config['keywords']:
+            if keyword in text:
+                mentions[subplot_type].append(keyword)
+        for indicator in config['indicators']:
+            if indicator in text:
+                mentions[subplot_type].append(f"[{indicator}]")
+
+    return dict(mentions)
+
+
+def track_subplot_across_chapters(chapters_dir, recent_n=None):
+    """Track subplot development across chapters."""
+    chapter_files = list_chapters(chapters_dir, recent_n)
+    if not chapter_files:
+        return {'error': '未找到章节文件'}
+
+    subplot_timeline = defaultdict(list)
+    subplot_status = {}
+
+    for idx, cf in enumerate(chapter_files):
+        raw, title, clean, wc = read_chapter(cf)
+        ch_num = idx + 1
+
+        # Detect subplot mentions
+        mentions = detect_subplot_mentions(clean)
+
+        for subplot_type, keywords in mentions.items():
+            subplot_timeline[subplot_type].append({
+                'chapter_num': ch_num,
+                'chapter_title': title,
+                'keywords': list(set(keywords))[:5],  # Limit to 5 keywords
+                'word_count': wc
+            })
+
+    # Analyze subplot status
+    for subplot_type, timeline in subplot_timeline.items():
+        total_chapters = len(timeline)
+        first_chapter = timeline[0]['chapter_num'] if timeline else 0
+        last_chapter = timeline[-1]['chapter_num'] if timeline else 0
+
+        # Determine status
+        if total_chapters == 0:
+            status = '未出现'
+        elif total_chapters == 1:
+            status = '刚引入'
+        elif last_chapter - first_chapter < 3:
+            status = '发展中'
+        elif total_chapters > len(chapter_files) * 0.3:
+            status = '主要支线'
+        else:
+            status = '间歇性出现'
+
+        subplot_status[subplot_type] = {
+            'status': status,
+            'total_chapters': total_chapters,
+            'first_appearance': first_chapter,
+            'last_appearance': last_chapter,
+            'chapters_involved': [t['chapter_num'] for t in timeline],
+            'timeline': timeline[-5:]  # Last 5 appearances
+        }
+
+    return {
+        'total_chapters_analyzed': len(chapter_files),
+        'subplots_detected': len(subplot_timeline),
+        'subplot_status': subplot_status,
+        'subplot_timeline': dict(subplot_timeline)
+    }
+
+
+def check_subplot_consistency(result):
+    """Check for subplot consistency issues."""
+    issues = []
+
+    for subplot_type, status in result.get('subplot_status', {}).items():
+        # Check for abandoned subplots
+        if status['status'] == '刚引入' and result['total_chapters_analyzed'] > 10:
+            issues.append({
+                'type': '可能遗弃',
+                'subplot': subplot_type,
+                'message': f"{subplot_type}在第{status['first_appearance']}章引入后未再出现",
+                'severity': 'warning'
+            })
+
+        # Check for inconsistent pacing
+        if status['total_chapters'] > 0:
+            chapters = status['chapters_involved']
+            gaps = [chapters[i+1] - chapters[i] for i in range(len(chapters)-1)]
+            if gaps and max(gaps) > 5:
+                issues.append({
+                    'type': '节奏不均',
+                    'subplot': subplot_type,
+                    'message': f"{subplot_type}章节间隔过大（最大{max(gaps)}章）",
+                    'severity': 'info'
+                })
+
+    return issues
+
+
+def main():
+    parser = argparse.ArgumentParser(description='支线追踪器')
+    parser.add_argument('chapters_dir', help='章节目录路径')
+    parser.add_argument('--recent', type=int, help='仅分析最近N章')
+    parser.add_argument('--json', action='store_true', help='JSON输出')
+    parser.add_argument('--verbose', '-v', action='store_true', help='显示详细信息')
+    args = parser.parse_args()
+
+    if not os.path.isdir(args.chapters_dir):
+        print(f"错误: 目录不存在: {args.chapters_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    result = track_subplot_across_chapters(args.chapters_dir, args.recent)
+
+    # Add consistency check
+    if not args.json:
+        issues = check_subplot_consistency(result)
+        result['consistency_issues'] = issues
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    else:
+        if 'error' in result:
+            print(result['error'])
+            return
+
+        print(f"\n=== 支线追踪报告 ===\n")
+        print(f"分析章节数: {result['total_chapters_analyzed']}")
+        print(f"检测支线数: {result['subplots_detected']}")
+
+        print(f"\n支线状态:")
+        for subplot_type, status in result['subplot_status'].items():
+            icon = '●' if status['status'] == '主要支线' else '○'
+            print(f"  {icon} {subplot_type}: {status['status']}")
+            print(f"     出场章数: {status['total_chapters']}, 首次: 第{status['first_appearance']}章, 最近: 第{status['last_appearance']}章")
+
+        if result.get('consistency_issues'):
+            print(f"\n一致性问题:")
+            for issue in result['consistency_issues']:
+                icon = '' if issue['severity'] == 'warning' else 'ℹ'
+                print(f"  {icon} {issue['subplot']}: {issue['message']}")
+
+        if args.verbose and result.get('subplot_timeline'):
+            print(f"\n详细时间线:")
+            for subplot_type, timeline in result['subplot_timeline'].items():
+                print(f"\n  {subplot_type}:")
+                for entry in timeline[-5:]:  # Last 5 entries
+                    print(f"    第{entry['chapter_num']}章: {entry['chapter_title']}")
+                    if entry['keywords']:
+                        print(f"      关键词: {', '.join(entry['keywords'])}")
+
+
+if __name__ == '__main__':
+    main()

package/skill/scripts/reviewer/summary_generator.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+阶段总结辅助脚本
+从各章结构化数据中提取摘要，拼接剧情时间线。
+供 `/novel-maker summary` 指令使用，AI 读取此输出代替读全文。
+"""
+
+import os
+import sys
+import json
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'common'))
+from nm_utils import (
+    list_chapters, read_chapter, extract_characters, extract_locations,
+    detect_hook, count_chinese, clean_markdown
+)
+
+
+def build_chapter_timeline(chapter_path):
+    """Extract a structured timeline entry from a single chapter."""
+    raw, title, clean, wc = read_chapter(chapter_path)
+    chars = extract_characters(clean)
+    locs = extract_locations(clean)
+    hook = detect_hook(raw)
+
+    # Extract first and last paragraph summaries
+    paragraphs = [p.strip() for p in clean.split('\n') if p.strip()]
+    first_para = paragraphs[0][:100] if paragraphs else ''
+    last_para = paragraphs[-1][-150:] if paragraphs else ''
+
+    return {
+        'title': title,
+        'words': wc,
+        'characters': chars[:6],
+        'locations': locs[:3],
+        'hook_type': hook['type'],
+        'first_para_summary': first_para,
+        'last_para_summary': last_para,
+    }
+
+
+def generate_summary(chapters_dir, start_n=1, end_n=None):
+    """Generate a structured summary for chapters start_n through end_n."""
+    all_chapters = list_chapters(chapters_dir)
+    if not all_chapters:
+        return {'error': 'No chapters found'}
+
+    if end_n is None:
+        end_n = len(all_chapters)
+    start_idx = max(0, start_n - 1)
+    end_idx = min(len(all_chapters), end_n)
+    target_chapters = all_chapters[start_idx:end_idx]
+
+    timeline = []
+    all_chars = set()
+    all_locs = set()
+
+    for cf in target_chapters:
+        entry = build_chapter_timeline(cf)
+        timeline.append(entry)
+        all_chars.update(entry['characters'])
+        all_locs.update(entry['locations'])
+
+    total_words = sum(t['words'] for t in timeline)
+
+    return {
+        'chapter_range': f"第{start_n}-{start_n + len(timeline) - 1}章",
+        'total_chapters': len(timeline),
+        'total_words': total_words,
+        'avg_words': round(total_words / max(len(timeline), 1), 0),
+        'timeline': timeline,
+        'characters_involved': sorted(all_chars),
+        'locations_visited': sorted(all_locs),
+    }
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="Summary generator")
+    parser.add_argument("chapters_dir", help="Chapters directory")
+    parser.add_argument("--range", type=str, help="Chapter range, e.g. '1-10' or '11-20'", default=None)
+    parser.add_argument("--last", type=int, help="Last N chapters", default=None)
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    args = parser.parse_args()
+
+    if not os.path.isdir(args.chapters_dir):
+        print(f"Error: {args.chapters_dir} is not a directory", file=sys.stderr)
+        sys.exit(1)
+
+    start_n = 1
+    end_n = None
+
+    if args.range:
+        parts = args.range.split('-')
+        if len(parts) == 2:
+            start_n = int(parts[0])
+            end_n = int(parts[1])
+    elif args.last:
+        all_chapters = list_chapters(args.chapters_dir)
+        start_n = max(1, len(all_chapters) - args.last + 1)
+
+    result = generate_summary(args.chapters_dir, start_n, end_n)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    else:
+        if 'error' in result:
+            print(result['error'])
+            return
+
+        print(f"\n{'=' * 60}")
+        print(f"📋 阶段总结 ({result['chapter_range']})")
+        print(f"{'=' * 60}")
+        print(f"章节数: {result['total_chapters']}")
+        print(f"总字数: {result['total_words']:,}")
+        print(f"平均字数: {result['avg_words']}/章")
+        print(f"涉及角色: {', '.join(result['characters_involved'][:8])}")
+        print(f"涉及场景: {', '.join(result['locations_visited'][:5])}")
+        print(f"\n剧情时间线:")
+        for t in result['timeline']:
+            print(f"\n  {t['title']} ({t['words']}字)")
+            print(f"    角色: {', '.join(t['characters'][:4])}")
+            print(f"    开头: {t['first_para_summary'][:60]}...")
+            print(f"    结尾: ...{t['last_para_summary'][-60:]}")
+            print(f"    钩子: {t['hook_type']}")
+
+
+if __name__ == "__main__":
+    main()

package/skill/scripts/reviewer/truth_diff.py

@@ -0,0 +1,227 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+真相文件变更检测 — 自动检测章节变更并生成更新 diff
+
+对比定稿章节与真相文件，检测需要更新的内容（新角色、新地点、
+伏笔变化、情感变化等），输出结构化 diff 供复盘师审核。
+
+用法:
+    python scripts/reviewer/truth_diff.py ch15.md --truth-dir .novel-maker/truth-files/
+    python scripts/reviewer/truth_diff.py ch15.md --prev ch14.md --truth-dir .novel-maker/truth-files/ --json
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'common'))
+from nm_utils import (
+    read_chapter, extract_characters, extract_locations,
+    detect_hook, clean_markdown, read_truth_section
+)
+
+
+def _load_known_names(truth_dir, filename='characters.md'):
+    """从真相文件中提取已知角色名"""
+    fpath = os.path.join(truth_dir, filename)
+    sections = read_truth_section(fpath)
+    if not sections:
+        return set()
+    names = set()
+    for title, content in sections.items():
+        for m in re.finditer(r'\*\*([^*]{1,10})\*\*', content):
+            name = m.group(1).strip()
+            if len(name) >= 2 and not any(c in name for c in '（）()'):
+                names.add(name)
+        for m in re.finditer(r'[:：]\s*([^\s,，。]{2,6})', content):
+            name = m.group(1).strip()
+            if len(name) >= 2:
+                names.add(name)
+    return names
+
+
+def _load_known_hooks(truth_dir, filename='pending-hooks.md'):
+    """从伏笔表中提取已知伏笔"""
+    fpath = os.path.join(truth_dir, filename)
+    sections = read_truth_section(fpath)
+    if not sections:
+        return {'pending': [], 'recovered': []}
+    hooks = {'pending': [], 'recovered': []}
+    for title, content in sections.items():
+        if '已回收' in title or '已解决' in title:
+            for m in re.finditer(r'H\[(\d+)\]', content):
+                hooks['recovered'].append(m.group(1))
+        elif 'header' not in title:
+            for m in re.finditer(r'H\[(\d+)\]', content):
+                hooks['pending'].append(m.group(1))
+    return hooks
+
+
+def _load_known_locations(truth_dir, filename='world-setting.md'):
+    """从世界观设定中提取已知地点"""
+    fpath = os.path.join(truth_dir, filename)
+    sections = read_truth_section(fpath)
+    if not sections:
+        return set()
+    locs = set()
+    for title, content in sections.items():
+        if '地' in title or '区域' in title or '地点' in title:
+            for m in re.finditer(r'\*\*([^*]{2,8})\*\*', content):
+                locs.add(m.group(1))
+    return locs
+
+
+def _detect_hook_keywords(text):
+    """检测伏笔相关关键词"""
+    hook_keywords = {
+        'reveal': ['原来', '竟然', '居然', '真相', '秘密', '身份'],
+        'setup': ['记住', '将来', '总有一天', '等着', '约定'],
+        'foreshadow': ['似乎', '隐约', '感觉', '仿佛', '好像'],
+    }
+    found = {}
+    for htype, keywords in hook_keywords.items():
+        matches = [kw for kw in keywords if kw in text]
+        if matches:
+            found[htype] = matches
+    return found
+
+
+def _detect_emotion_keywords(text):
+    """检测情感关键词"""
+    emotion_map = {
+        '愤怒': ['怒', '火', '恨', '咬牙', '攥拳', '瞪'],
+        '悲伤': ['泪', '哭', '泣', '哽咽', '心痛', '悲伤'],
+        '喜悦': ['笑', '喜', '乐', '高兴', '兴奋', '激动'],
+        '恐惧': ['怕', '恐', '惊', '颤', '抖', '畏惧'],
+        '惊讶': ['惊', '没想到', '居然', '竟然', '不敢相信'],
+        '平静': ['平静', '淡然', '从容', '沉稳', '泰然'],
+    }
+    found = {}
+    for emotion, keywords in emotion_map.items():
+        count = sum(1 for kw in keywords if kw in text)
+        if count >= 2:
+            found[emotion] = count
+    return found
+
+
+def detect_changes(chapter_path, truth_dir, prev_chapter_path=None):
+    """检测章节变更"""
+    if not os.path.exists(chapter_path):
+        return {'error': f'章节文件不存在: {chapter_path}'}
+    if not os.path.isdir(truth_dir):
+        return {'error': f'真相文件目录不存在: {truth_dir}'}
+
+    raw, title, clean, wc = read_chapter(chapter_path)
+    changes = {
+        'chapter': os.path.basename(chapter_path),
+        'title': title,
+        'word_count': wc,
+        'detected': {}
+    }
+
+    # 1. 新角色检测
+    known_chars = _load_known_names(truth_dir)
+    chapter_chars = set(extract_characters(clean))
+    new_chars = chapter_chars - known_chars
+    if new_chars:
+        changes['detected']['new_characters'] = sorted(new_chars)
+
+    # 2. 新地点检测
+    known_locs = _load_known_locations(truth_dir)
+    chapter_locs = set(extract_locations(clean))
+    new_locs = chapter_locs - known_locs
+    if new_locs:
+        changes['detected']['new_locations'] = sorted(new_locs)
+
+    # 3. 伏笔检测
+    hook_keywords = _detect_hook_keywords(clean)
+    if hook_keywords:
+        changes['detected']['hook_keywords'] = hook_keywords
+
+    # 4. 章末钩子
+    hook = detect_hook(raw)
+    if hook['type'] not in ('未检测', '未知'):
+        changes['detected']['chapter_hook'] = {
+            'type': hook['type'],
+            'tail_preview': hook.get('tail_preview', '')
+        }
+
+    # 5. 情感变化
+    emotions = _detect_emotion_keywords(clean)
+    if emotions:
+        changes['detected']['emotions'] = emotions
+
+    # 6. 与前章对比
+    if prev_chapter_path and os.path.exists(prev_chapter_path):
+        prev_raw, prev_title, prev_clean, prev_wc = read_chapter(prev_chapter_path)
+        prev_chars = set(extract_characters(prev_clean))
+        prev_locs = set(extract_locations(prev_clean))
+        continuing_chars = chapter_chars & prev_chars
+        new_in_chapter = chapter_chars - prev_chars
+        changes['detected']['continuing_characters'] = sorted(continuing_chars)
+        if new_in_chapter:
+            changes['detected']['new_vs_prev'] = sorted(new_in_chapter)
+
+    # 7. 伏笔表状态
+    known_hooks = _load_known_hooks(truth_dir)
+    changes['detected']['hook_status'] = {
+        'pending_count': len(known_hooks['pending']),
+        'recovered_count': len(known_hooks['recovered'])
+    }
+
+    # 汇总
+    change_count = len([v for v in changes['detected'].values() if v])
+    changes['summary'] = {
+        'total_changes': change_count,
+        'has_new_characters': 'new_characters' in changes['detected'],
+        'has_new_locations': 'new_locations' in changes['detected'],
+        'has_hook_keywords': 'hook_keywords' in changes['detected'],
+        'has_emotions': 'emotions' in changes['detected'],
+    }
+
+    return changes
+
+
+def main():
+    parser = argparse.ArgumentParser(description='真相文件变更检测')
+    parser.add_argument('chapter', help='定稿章节文件路径')
+    parser.add_argument('--truth-dir', '-t', required=True, help='真相文件目录')
+    parser.add_argument('--prev', '-p', help='前一章文件路径')
+    parser.add_argument('--json', action='store_true', help='JSON输出')
+    args = parser.parse_args()
+
+    changes = detect_changes(args.chapter, args.truth_dir, args.prev)
+
+    if args.json:
+        print(json.dumps(changes, ensure_ascii=False, indent=2))
+    else:
+        if 'error' in changes:
+            print(f"错误: {changes['error']}")
+            return
+        print(f"=== 变更检测: {changes['chapter']} ({changes['title']}) ===\n")
+
+        detected = changes['detected']
+        if 'new_characters' in detected:
+            print(f"新角色: {', '.join(detected['new_characters'])}")
+        if 'new_locations' in detected:
+            print(f"新地点: {', '.join(detected['new_locations'])}")
+        if 'hook_keywords' in detected:
+            for htype, keywords in detected['hook_keywords'].items():
+                print(f"伏笔({htype}): {', '.join(keywords)}")
+        if 'chapter_hook' in detected:
+            print(f"章末钩子: {detected['chapter_hook']['type']}")
+        if 'emotions' in detected:
+            for emotion, count in detected['emotions'].items():
+                print(f"情感({emotion}): {count}次")
+        if 'continuing_characters' in detected:
+            print(f"延续角色: {', '.join(detected['continuing_characters'])}")
+
+        if changes['summary']['total_changes'] == 0:
+            print("未检测到需要更新的内容")
+
+
+if __name__ == '__main__':
+    main()

package/skill/scripts/reviewer/truth_manager.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+真相文件管理器
+解析 truth-files 目录，快速查看角色、伏笔、世界观、力量体系等实体信息。
+供 `/novel-maker memory entity` 指令使用。
+"""
+
+import os
+import sys
+import json
+import re
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'common'))
+from nm_utils import read_truth_section, count_chinese
+
+
+TRUTH_FILES = {
+    'characters': '角色档案',
+    'world-setting': '世界观',
+    'power-system': '力量体系',
+    'current-state': '当前状态',
+    'pending-hooks': '伏笔表',
+    'constitution': '创作宪法',
+}
+
+
+def scan_truth_files(truth_dir):
+    """Scan all truth files and return structured data."""
+    if not os.path.isdir(truth_dir):
+        return {'error': f'目录不存在: {truth_dir}'}
+
+    result = {}
+    for key, label in TRUTH_FILES.items():
+        filepath = os.path.join(truth_dir, f'{key}.md')
+        if os.path.exists(filepath):
+            with open(filepath, 'r', encoding='utf-8') as f:
+                text = f.read()
+            wc = count_chinese(text)
+            sections = read_truth_section(filepath)
+            result[key] = {
+                'label': label,
+                'words': wc,
+                'sections': list(sections.keys()) if sections else [],
+                'sections_content': sections,
+            }
+
+    # Extract character names from characters.md
+    if 'characters' in result:
+        content = result['characters'].get('sections_content', {})
+        char_names = []
+        for section_text in content.values():
+            for m in re.finditer(r'[*\-]?\s*\*\*?([\u4e00-\u9fff]{2,4})\*\*?', section_text):
+                name = m.group(1)
+                if name not in ('角色', '人物', '主角', '配角', '反派', '姓名'):
+                    char_names.append(name)
+        result['characters']['extracted_names'] = list(set(char_names))[:20]
+
+    # Extract hook info from pending-hooks.md
+    if 'pending-hooks' in result:
+        content = result['pending-hooks'].get('sections_content', {})
+        hooks = []
+        for section_text in content.values():
+            for m in re.finditer(r'\[([^\]]+)\]', section_text):
+                hooks.append(m.group(1))
+        result['pending-hooks']['extracted_hooks'] = hooks[:10]
+
+    return result
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="Truth files manager")
+    parser.add_argument("truth_dir", nargs='?', default=None, help="Truth files directory")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    parser.add_argument("--entity", type=str, help="Show specific entity (characters/world/power/hooks/state)")
+    args = parser.parse_args()
+
+    truth_dir = args.truth_dir
+    if truth_dir is None:
+        # Try common locations
+        for candidate in ['.novel-maker/truth-files', 'novels/truth-files', 'truth-files']:
+            if os.path.isdir(candidate):
+                truth_dir = candidate
+                break
+        if truth_dir is None:
+            print("错误: 未找到 truth-files 目录，请指定路径", file=sys.stderr)
+            sys.exit(1)
+
+    result = scan_truth_files(truth_dir)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        return
+
+    if 'error' in result:
+        print(result['error'])
+        return
+
+    print(f"\n{'=' * 60}")
+    print(f"📁 真相文件管理 ({truth_dir})")
+    print(f"{'=' * 60}\n")
+
+    for key, info in result.items():
+        if args.entity and key != args.entity:
+            continue
+        print(f"📄 {info['label']} ({key}.md, {info['words']}字)")
+        if info['sections']:
+            print(f"   章节: {', '.join(info['sections'])}")
+        if key == 'characters' and info.get('extracted_names'):
+            print(f"   角色: {', '.join(info['extracted_names'][:10])}")
+        if key == 'pending-hooks' and info.get('extracted_hooks'):
+            print(f"   伏笔 ({len(info['extracted_hooks'])}条):")
+            for h in info['extracted_hooks'][:5]:
+                print(f"     • {h}")
+        print()
+
+
+if __name__ == "__main__":
+    main()