novelws 3.1.0 → 5.0.0

package/templates/scripts/bash/check-consistency.sh

@@ -1,463 +0,0 @@
-#!/usr/bin/env bash
-# 综合一致性检查脚本
-
-set -e
-
-# 加载通用函数
-SCRIPT_DIR=$(dirname "$0")
-source "$SCRIPT_DIR/common.sh"
-
-# 检查模式
-CHECKLIST_MODE=false
-if [ "$1" = "--checklist" ]; then
-    CHECKLIST_MODE=true
-fi
-
-# 获取当前故事目录
-STORY_DIR=$(get_current_story)
-
-if [ -z "$STORY_DIR" ]; then
-    echo "错误: 未找到故事项目" >&2
-    exit 1
-fi
-
-# 文件路径
-PROGRESS="$STORY_DIR/progress.json"
-PLOT_TRACKER="$STORY_DIR/spec/tracking/plot-tracker.json"
-TIMELINE="$STORY_DIR/spec/tracking/timeline.json"
-RELATIONSHIPS="$STORY_DIR/spec/tracking/relationships.json"
-CHARACTER_STATE="$STORY_DIR/spec/tracking/character-state.json"
-
-# ANSI颜色代码
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# 统计变量
-TOTAL_CHECKS=0
-PASSED_CHECKS=0
-WARNINGS=0
-ERRORS=0
-
-# 检查函数
-check() {
-    local name="$1"
-    local condition="$2"
-    local error_msg="$3"
-
-    ((TOTAL_CHECKS++))
-
-    if eval "$condition"; then
-        echo -e "${GREEN}✓${NC} $name"
-        ((PASSED_CHECKS++))
-    else
-        echo -e "${RED}✗${NC} $name: $error_msg"
-        ((ERRORS++))
-    fi
-}
-
-warn() {
-    local msg="$1"
-    echo -e "${YELLOW}⚠${NC} 警告: $msg"
-    ((WARNINGS++))
-}
-
-# 检查章节号一致性
-check_chapter_consistency() {
-    echo "📖 检查章节号一致性"
-    echo "───────────────────"
-
-    if [ -f "$PROGRESS" ] && [ -f "$PLOT_TRACKER" ]; then
-        PROGRESS_CHAPTER=$(jq -r '.statistics.currentChapter // 0' "$PROGRESS")
-        PLOT_CHAPTER=$(jq -r '.currentState.chapter // 0' "$PLOT_TRACKER")
-
-        check "章节号同步" \
-              "[ '$PROGRESS_CHAPTER' = '$PLOT_CHAPTER' ]" \
-              "progress.json(${PROGRESS_CHAPTER}) != plot-tracker.json(${PLOT_CHAPTER})"
-
-        if [ -f "$CHARACTER_STATE" ]; then
-            CHAR_CHAPTER=$(jq -r '.protagonist.currentStatus.chapter // 0' "$CHARACTER_STATE")
-            check "角色状态章节同步" \
-                  "[ '$PROGRESS_CHAPTER' = '$CHAR_CHAPTER' ]" \
-                  "与character-state.json(${CHAR_CHAPTER})不一致"
-        fi
-    else
-        warn "部分追踪文件缺失，无法完成章节检查"
-    fi
-
-    echo ""
-}
-
-# 检查时间线连续性
-check_timeline_consistency() {
-    echo "⏰ 检查时间线连续性"
-    echo "───────────────────"
-
-    if [ -f "$TIMELINE" ]; then
-        # 检查时间事件是否按章节递增
-        TIMELINE_ISSUES=$(jq '
-            .events |
-            sort_by(.chapter) |
-            . as $sorted |
-            reduce range(1; length) as $i (0;
-                if $sorted[$i].chapter <= $sorted[$i-1].chapter then . + 1 else . end
-            )' "$TIMELINE")
-
-        check "时间事件顺序" \
-              "[ '$TIMELINE_ISSUES' = '0' ]" \
-              "发现${TIMELINE_ISSUES}个乱序事件"
-
-        # 检查当前时间是否更新
-        CURRENT_TIME=$(jq -r '.storyTime.current // ""' "$TIMELINE")
-        check "当前时间设置" \
-              "[ -n '$CURRENT_TIME' ]" \
-              "当前故事时间未设置"
-    else
-        warn "时间线文件不存在"
-    fi
-
-    echo ""
-}
-
-# 检查角色状态合理性
-check_character_consistency() {
-    echo "👥 检查角色状态合理性"
-    echo "─────────────────────"
-
-    if [ -f "$CHARACTER_STATE" ] && [ -f "$RELATIONSHIPS" ]; then
-        # 检查主角是否存在于两个文件中
-        PROTAG_NAME=$(jq -r '.protagonist.name // ""' "$CHARACTER_STATE")
-
-        if [ -n "$PROTAG_NAME" ]; then
-            HAS_RELATIONS=$(jq --arg name "$PROTAG_NAME" \
-                'has($name)' "$RELATIONSHIPS" 2>/dev/null || echo "false")
-
-            check "主角关系记录" \
-                  "[ '$HAS_RELATIONS' = 'true' ]" \
-                  "主角'$PROTAG_NAME'在relationships.json中无记录"
-        fi
-
-        # 检查角色位置逻辑
-        LAST_LOCATION=$(jq -r '.protagonist.currentStatus.location // ""' "$CHARACTER_STATE")
-        check "主角位置记录" \
-              "[ -n '$LAST_LOCATION' ]" \
-              "主角当前位置未记录"
-    else
-        warn "角色追踪文件不完整"
-    fi
-
-    echo ""
-}
-
-# 检查伏笔回收计划
-check_foreshadowing_plan() {
-    echo "🎯 检查伏笔管理"
-    echo "──────────────"
-
-    if [ -f "$PLOT_TRACKER" ]; then
-        # 统计伏笔状态
-        TOTAL_FORESHADOW=$(jq '.foreshadowing | length' "$PLOT_TRACKER")
-        ACTIVE_FORESHADOW=$(jq '[.foreshadowing[] | select(.status == "active")] | length' "$PLOT_TRACKER")
-
-        if [ -f "$PROGRESS" ]; then
-            CURRENT_CHAPTER=$(jq -r '.statistics.currentChapter // 0' "$PROGRESS")
-
-            # 检查超期未回收的伏笔
-            OVERDUE=$(jq --arg current "$CURRENT_CHAPTER" '
-                [.foreshadowing[] |
-                 select(.status == "active" and .planted.chapter and
-                        (($current | tonumber) - .planted.chapter) > 50)] |
-                length' "$PLOT_TRACKER")
-
-            check "伏笔回收及时性" \
-                  "[ '$OVERDUE' = '0' ]" \
-                  "有${OVERDUE}个伏笔超过50章未回收"
-        fi
-
-        echo "  📊 伏笔统计: 总计${TOTAL_FORESHADOW}个，活跃${ACTIVE_FORESHADOW}个"
-
-        # 警告过多活跃伏笔
-        if [ "$ACTIVE_FORESHADOW" -gt 10 ]; then
-            warn "活跃伏笔过多(${ACTIVE_FORESHADOW}个)，可能造成读者困惑"
-        fi
-    else
-        warn "情节追踪文件不存在"
-    fi
-
-    echo ""
-}
-
-# 检查文件完整性
-check_file_integrity() {
-    echo "📁 检查文件完整性"
-    echo "────────────────"
-
-    check "progress.json" "[ -f '$PROGRESS' ]" "文件不存在"
-    check "plot-tracker.json" "[ -f '$PLOT_TRACKER' ]" "文件不存在"
-    check "timeline.json" "[ -f '$TIMELINE' ]" "文件不存在"
-    check "relationships.json" "[ -f '$RELATIONSHIPS' ]" "文件不存在"
-    check "character-state.json" "[ -f '$CHARACTER_STATE' ]" "文件不存在"
-
-    # 检查JSON格式是否有效
-    for file in "$PROGRESS" "$PLOT_TRACKER" "$TIMELINE" "$RELATIONSHIPS" "$CHARACTER_STATE"; do
-        if [ -f "$file" ]; then
-            filename=$(basename "$file")
-            if jq empty "$file" 2>/dev/null; then
-                check "$filename格式" "true" ""
-            else
-                check "$filename格式" "false" "JSON格式无效"
-            fi
-        fi
-    done
-
-    echo ""
-}
-
-# 生成报告
-generate_report() {
-    echo "═══════════════════════════════════════"
-    echo "📊 综合一致性检查报告"
-    echo "═══════════════════════════════════════"
-    echo ""
-
-    check_file_integrity
-    check_chapter_consistency
-    check_timeline_consistency
-    check_character_consistency
-    check_foreshadowing_plan
-
-    echo "═══════════════════════════════════════"
-    echo "📈 检查结果汇总"
-    echo "───────────────────"
-    echo "  总检查项: ${TOTAL_CHECKS}"
-    echo -e "  ${GREEN}通过: ${PASSED_CHECKS}${NC}"
-    echo -e "  ${YELLOW}警告: ${WARNINGS}${NC}"
-    echo -e "  ${RED}错误: ${ERRORS}${NC}"
-
-    if [ "$ERRORS" -eq 0 ] && [ "$WARNINGS" -eq 0 ]; then
-        echo ""
-        echo -e "${GREEN}✅ 完美！所有检查项全部通过${NC}"
-    elif [ "$ERRORS" -eq 0 ]; then
-        echo ""
-        echo -e "${YELLOW}⚠️  存在${WARNINGS}个警告，建议关注${NC}"
-    else
-        echo ""
-        echo -e "${RED}❌ 发现${ERRORS}个错误，需要修正${NC}"
-    fi
-
-    echo "═══════════════════════════════════════"
-    echo ""
-    echo "检查时间: $(date '+%Y-%m-%d %H:%M:%S')"
-
-    # 记录检查结果
-    if [ -f "$STORY_DIR/spec/tracking" ]; then
-        echo "{
-            \"timestamp\": \"$(date -Iseconds)\",
-            \"total\": $TOTAL_CHECKS,
-            \"passed\": $PASSED_CHECKS,
-            \"warnings\": $WARNINGS,
-            \"errors\": $ERRORS
-        }" > "$STORY_DIR/spec/tracking/.last-check.json"
-    fi
-}
-
-# 生成 checklist 格式输出
-output_checklist() {
-    # 静默执行检查逻辑
-    exec 3>&1 4>&2  # 保存原始输出
-    exec 1>/dev/null 2>&1  # 重定向到null
-
-    check_file_integrity
-    check_chapter_consistency
-    check_timeline_consistency
-    check_character_consistency
-    check_foreshadowing_plan
-
-    exec 1>&3 2>&4  # 恢复输出
-
-    # 获取章节号用于检查
-    local progress_chapter=""
-    local plot_chapter=""
-    local char_chapter=""
-    if [ -f "$PROGRESS" ] && [ -f "$PLOT_TRACKER" ]; then
-        progress_chapter=$(jq -r '.statistics.currentChapter // 0' "$PROGRESS" 2>/dev/null || echo "0")
-        plot_chapter=$(jq -r '.currentState.chapter // 0' "$PLOT_TRACKER" 2>/dev/null || echo "0")
-    fi
-    if [ -f "$CHARACTER_STATE" ]; then
-        char_chapter=$(jq -r '.protagonist.currentStatus.chapter // 0' "$CHARACTER_STATE" 2>/dev/null || echo "0")
-    fi
-
-    # 检查伏笔状态
-    local total_foreshadow=0
-    local active_foreshadow=0
-    local overdue_foreshadow=0
-    if [ -f "$PLOT_TRACKER" ]; then
-        total_foreshadow=$(jq '.foreshadowing | length' "$PLOT_TRACKER" 2>/dev/null || echo "0")
-        active_foreshadow=$(jq '[.foreshadowing[] | select(.status == "active")] | length' "$PLOT_TRACKER" 2>/dev/null || echo "0")
-
-        if [ -f "$PROGRESS" ]; then
-            local current_chapter=$(jq -r '.statistics.currentChapter // 0' "$PROGRESS" 2>/dev/null || echo "0")
-            overdue_foreshadow=$(jq --arg current "$current_chapter" '[.foreshadowing[] | select(.status == "active" and .planted.chapter and (($current | tonumber) - .planted.chapter) > 50)] | length' "$PLOT_TRACKER" 2>/dev/null || echo "0")
-        fi
-    fi
-
-    # 输出 checklist 格式
-    cat <<EOF
-# 数据同步一致性检查 Checklist
-
-**检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**检查对象**: spec/tracking/ 目录所有JSON文件
-**检查范围**: 文件完整性、章节同步、时间线连续性、角色状态、伏笔管理
-
----
-
-## 文件完整性
-
-- [$([ -f "$PROGRESS" ] && echo "x" || echo " ")] CHK001 progress.json 存在且格式有效
-- [$([ -f "$PLOT_TRACKER" ] && echo "x" || echo " ")] CHK002 plot-tracker.json 存在且格式有效
-- [$([ -f "$TIMELINE" ] && echo "x" || echo " ")] CHK003 timeline.json 存在且格式有效
-- [$([ -f "$RELATIONSHIPS" ] && echo "x" || echo " ")] CHK004 relationships.json 存在且格式有效
-- [$([ -f "$CHARACTER_STATE" ] && echo "x" || echo " ")] CHK005 character-state.json 存在且格式有效
-
-## 章节号同步
-
-EOF
-
-    if [ "$progress_chapter" = "$plot_chapter" ]; then
-        echo "- [x] CHK006 progress.json 与 plot-tracker.json 章节号一致（第 $progress_chapter 章）"
-    else
-        echo "- [!] CHK006 progress.json(${progress_chapter}) 与 plot-tracker.json(${plot_chapter}) 章节号不一致"
-    fi
-
-    if [ -n "$char_chapter" ]; then
-        if [ "$progress_chapter" = "$char_chapter" ]; then
-            echo "- [x] CHK007 progress.json 与 character-state.json 章节号一致"
-        else
-            echo "- [!] CHK007 progress.json(${progress_chapter}) 与 character-state.json(${char_chapter}) 章节号不一致"
-        fi
-    else
-        echo "- [ ] CHK007 character-state.json 章节号检查（文件不存在或缺少数据）"
-    fi
-
-    cat <<EOF
-
-## 时间线连续性
-
-- [$([ -f "$TIMELINE" ] && echo "x" || echo " ")] CHK008 时间线事件按章节有序排列
-- [$([ -f "$TIMELINE" ] && echo "x" || echo " ")] CHK009 当前故事时间已设置
-
-## 角色状态
-
-EOF
-
-    if [ -f "$CHARACTER_STATE" ] && [ -f "$RELATIONSHIPS" ]; then
-        local protag_name=$(jq -r '.protagonist.name // ""' "$CHARACTER_STATE" 2>/dev/null)
-        if [ -n "$protag_name" ]; then
-            echo "- [x] CHK010 主角信息完整（$protag_name）"
-            local has_relations=$(jq --arg name "$protag_name" 'has($name)' "$RELATIONSHIPS" 2>/dev/null || echo "false")
-            if [ "$has_relations" = "true" ]; then
-                echo "- [x] CHK011 主角在 relationships.json 中有关系记录"
-            else
-                echo "- [!] CHK011 主角'$protag_name'在 relationships.json 中无关系记录"
-            fi
-        else
-            echo "- [ ] CHK010 主角信息完整（缺少数据）"
-            echo "- [ ] CHK011 主角关系记录（缺少数据）"
-        fi
-
-        local last_location=$(jq -r '.protagonist.currentStatus.location // ""' "$CHARACTER_STATE" 2>/dev/null)
-        if [ -n "$last_location" ]; then
-            echo "- [x] CHK012 主角当前位置已记录（$last_location）"
-        else
-            echo "- [!] CHK012 主角当前位置未记录"
-        fi
-    else
-        echo "- [ ] CHK010 主角信息完整（文件不存在）"
-        echo "- [ ] CHK011 主角关系记录（文件不存在）"
-        echo "- [ ] CHK012 主角当前位置已记录（文件不存在）"
-    fi
-
-    cat <<EOF
-
-## 伏笔管理
-
-EOF
-
-    if [ "$total_foreshadow" -gt 0 ]; then
-        echo "- [x] CHK013 伏笔记录存在（总计 $total_foreshadow 个，活跃 $active_foreshadow 个）"
-
-        if [ "$overdue_foreshadow" -eq 0 ]; then
-            echo "- [x] CHK014 伏笔回收及时（无超期未回收）"
-        else
-            echo "- [!] CHK014 伏笔回收及时（有 $overdue_foreshadow 个超过50章未回收）"
-        fi
-
-        if [ "$active_foreshadow" -le 10 ]; then
-            echo "- [x] CHK015 活跃伏笔数量合理（$active_foreshadow ≤ 10）"
-        else
-            echo "- [!] CHK015 活跃伏笔数量过多（$active_foreshadow > 10，可能造成读者困惑）"
-        fi
-    else
-        echo "- [ ] CHK013 伏笔记录存在（未找到伏笔记录）"
-        echo "- [ ] CHK014 伏笔回收及时（无数据）"
-        echo "- [ ] CHK015 活跃伏笔数量合理（无数据）"
-    fi
-
-    cat <<EOF
-
----
-
-## 检查统计
-
-- **总检查项**: ${TOTAL_CHECKS}
-- **已通过**: ${PASSED_CHECKS}
-- **警告**: ${WARNINGS}
-- **错误**: ${ERRORS}
-
----
-
-## 后续行动
-
-EOF
-
-    if [ "$ERRORS" -gt 0 ]; then
-        echo "- [ ] 修复上述标记为 [!] 的不一致问题"
-    fi
-    if [ "$WARNINGS" -gt 0 ]; then
-        echo "- [ ] 关注警告项，考虑是否需要改进"
-    fi
-    if [ "$ERRORS" -eq 0 ] && [ "$WARNINGS" -eq 0 ]; then
-        echo "*所有检查通过，无需行动*"
-    fi
-
-    cat <<EOF
-
----
-
-**检查工具**: check-consistency.sh
-**版本**: 1.1 (支持 checklist 输出)
-EOF
-}
-
-# 主函数
-main() {
-    if [ "$CHECKLIST_MODE" = true ]; then
-        output_checklist
-    else
-        generate_report
-    fi
-
-    # 根据结果返回适当的退出码
-    if [ "$ERRORS" -gt 0 ]; then
-        exit 1
-    elif [ "$WARNINGS" -gt 0 ]; then
-        exit 0  # 警告不算失败
-    else
-        exit 0
-    fi
-}
-
-# 执行主函数
-main

package/templates/scripts/bash/check-facts.sh

@@ -1,214 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-# check-facts.sh - Story Facts 引用扫描脚本
-# 扫描章节中的 story-facts 注释，生成引用报告
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# 颜色输出
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-BOLD='\033[1m'
-NC='\033[0m' # No Color
-
-# 默认参数
-OUTPUT_JSON=false
-STORY_NAME=""
-
-# 解析参数
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --json)
-            OUTPUT_JSON=true
-            shift
-            ;;
-        --story)
-            STORY_NAME="$2"
-            shift 2
-            ;;
-        *)
-            echo "Usage: $0 [--json] [--story <story-name>]" >&2
-            exit 1
-            ;;
-    esac
-done
-
-# 检查 story-facts.json 是否存在
-FACTS_FILE="$PROJECT_ROOT/spec/tracking/story-facts.json"
-if [[ ! -f "$FACTS_FILE" ]]; then
-    if [[ "$OUTPUT_JSON" == true ]]; then
-        echo '{"error": "story-facts.json not found", "chapters": [], "unreferenced_facts": [], "unknown_ids": []}'
-    else
-        echo -e "${RED}❌ 未找到 story-facts.json${NC}" >&2
-        echo -e "   路径: $FACTS_FILE" >&2
-        echo -e "   请先使用 /facts 命令初始化" >&2
-    fi
-    exit 1
-fi
-
-# 读取已注册的 fact ID 列表
-# 使用 jq 提取（如果有），否则使用 grep + sed
-if command -v jq &> /dev/null; then
-    REGISTERED_FACTS=$(jq -r '.facts[].id' "$FACTS_FILE" 2>/dev/null || echo "")
-else
-    # 降级方案：使用 grep 提取 "id": "xxx"
-    REGISTERED_FACTS=$(grep -o '"id"[[:space:]]*:[[:space:]]*"[^"]*"' "$FACTS_FILE" | sed 's/"id"[[:space:]]*:[[:space:]]*"\([^"]*\)"/\1/' || echo "")
-fi
-
-# 转换为数组
-if [[ -n "$REGISTERED_FACTS" ]]; then
-    mapfile -t REGISTERED_FACTS_ARRAY <<< "$REGISTERED_FACTS"
-else
-    REGISTERED_FACTS_ARRAY=()
-fi
-
-# 确定扫描目录
-if [[ -n "$STORY_NAME" ]]; then
-    CONTENT_DIR="$PROJECT_ROOT/stories/$STORY_NAME/content"
-    if [[ ! -d "$CONTENT_DIR" ]]; then
-        if [[ "$OUTPUT_JSON" == true ]]; then
-            echo "{\"error\": \"story directory not found: $STORY_NAME\", \"chapters\": [], \"unreferenced_facts\": [], \"unknown_ids\": []}"
-        else
-            echo -e "${RED}❌ 未找到故事目录: $STORY_NAME${NC}" >&2
-        fi
-        exit 1
-    fi
-    SEARCH_PATTERN="$CONTENT_DIR/*.md"
-else
-    SEARCH_PATTERN="$PROJECT_ROOT/stories/*/content/*.md"
-fi
-
-# 初始化数据结构
-declare -A chapter_facts  # key: 文件路径, value: fact IDs (逗号分隔)
-declare -A fact_referenced  # key: fact ID, value: 1 if referenced
-declare -A unknown_ids_map  # key: unknown ID, value: 1
-
-# 扫描章节文件
-shopt -s nullglob  # 如果没有匹配文件，glob 返回空而非原始字符串
-for chapter_file in $SEARCH_PATTERN; do
-    # 提取 <!-- story-facts: ... --> 注释
-    # 正则：<!-- story-facts: (.+?) -->
-    facts_line=$(grep -oP '<!--\s*story-facts:\s*\K[^-]+(?=\s*-->)' "$chapter_file" || true)
-
-    if [[ -n "$facts_line" ]]; then
-        # 去除空格，分割为数组
-        IFS=',' read -ra fact_ids <<< "$facts_line"
-
-        # 处理每个 fact ID
-        cleaned_ids=()
-        for id in "${fact_ids[@]}"; do
-            # 去除前后空格
-            id=$(echo "$id" | xargs)
-            if [[ -n "$id" ]]; then
-                cleaned_ids+=("$id")
-
-                # 检查是否已注册
-                if printf '%s\n' "${REGISTERED_FACTS_ARRAY[@]}" | grep -q "^${id}$"; then
-                    fact_referenced["$id"]=1
-                else
-                    unknown_ids_map["$id"]=1
-                fi
-            fi
-        done
-
-        # 保存到 chapter_facts
-        if [[ ${#cleaned_ids[@]} -gt 0 ]]; then
-            chapter_facts["$chapter_file"]=$(IFS=,; echo "${cleaned_ids[*]}")
-        fi
-    fi
-done
-
-# 计算未被引用的事实
-unreferenced_facts=()
-for fact_id in "${REGISTERED_FACTS_ARRAY[@]}"; do
-    if [[ ! -v fact_referenced["$fact_id"] ]]; then
-        unreferenced_facts+=("$fact_id")
-    fi
-done
-
-# 收集 unknown IDs
-unknown_ids=("${!unknown_ids_map[@]}")
-
-# 输出结果
-if [[ "$OUTPUT_JSON" == true ]]; then
-    # JSON 输出
-    echo "{"
-    echo '  "chapters": ['
-
-    first=true
-    for file in "${!chapter_facts[@]}"; do
-        if [[ "$first" == false ]]; then
-            echo ","
-        fi
-        first=false
-
-        # 转换为相对路径
-        rel_path="${file#$PROJECT_ROOT/}"
-
-        # 转换 fact IDs 为 JSON 数组
-        IFS=',' read -ra ids <<< "${chapter_facts[$file]}"
-        ids_json=$(printf '"%s",' "${ids[@]}" | sed 's/,$//')
-
-        echo -n "    {\"file\": \"$rel_path\", \"facts\": [$ids_json]}"
-    done
-
-    if [[ "$first" == false ]]; then
-        echo ""
-    fi
-    echo "  ],"
-
-    # unreferenced_facts
-    echo -n '  "unreferenced_facts": ['
-    if [[ ${#unreferenced_facts[@]} -gt 0 ]]; then
-        printf '"%s",' "${unreferenced_facts[@]}" | sed 's/,$//'
-    fi
-    echo "],"
-
-    # unknown_ids
-    echo -n '  "unknown_ids": ['
-    if [[ ${#unknown_ids[@]} -gt 0 ]]; then
-        printf '"%s",' "${unknown_ids[@]}" | sed 's/,$//'
-    fi
-    echo "]"
-
-    echo "}"
-else
-    # 人类可读输出
-    echo -e "${BOLD}${BLUE}📊 Story Facts 引用报告${NC}"
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
-
-    echo -e "${GREEN}已注册事实:${NC} ${#REGISTERED_FACTS_ARRAY[@]} 个"
-    echo -e "${GREEN}引用章节:${NC} ${#chapter_facts[@]} 个"
-    echo ""
-
-    if [[ ${#chapter_facts[@]} -gt 0 ]]; then
-        echo -e "${BOLD}章节引用:${NC}"
-        for file in "${!chapter_facts[@]}"; do
-            rel_path="${file#$PROJECT_ROOT/}"
-            filename=$(basename "$rel_path")
-            facts="${chapter_facts[$file]}"
-            echo -e "  ${BLUE}$filename${NC} → ${facts//,/, }"
-        done
-        echo ""
-    fi
-
-    if [[ ${#unreferenced_facts[@]} -gt 0 ]]; then
-        echo -e "${YELLOW}未被引用的事实:${NC} ${unreferenced_facts[*]}"
-        echo ""
-    else
-        echo -e "${GREEN}✓ 所有事实都被至少一个章节引用${NC}"
-        echo ""
-    fi
-
-    if [[ ${#unknown_ids[@]} -gt 0 ]]; then
-        echo -e "${RED}未知 ID (章节中引用但未注册):${NC} ${unknown_ids[*]}"
-        echo -e "  ${YELLOW}提示: 可能是拼写错误或需要注册到 story-facts.json${NC}"
-    else
-        echo -e "${GREEN}✓ 未检测到未知 ID${NC}"
-    fi
-fi