novelws 4.0.0 → 5.0.0

package/templates/resources/scripts/bash/check-analyze-stage.sh

@@ -1,108 +0,0 @@
-#!/usr/bin/env bash
-# 检测 analyze 命令应该执行的阶段
-# 返回 JSON 格式的阶段信息
-
-set -euo pipefail
-
-# 解析参数
-JSON_OUTPUT=false
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --json|-j)
-            JSON_OUTPUT=true
-            shift
-            ;;
-        *)
-            echo "未知参数: $1" >&2
-            exit 1
-            ;;
-    esac
-done
-
-# 加载公共函数
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "${SCRIPT_DIR}/common.sh"
-
-# 获取项目根目录和故事目录
-if ! PROJECT_ROOT=$(get_project_root); then
-    echo "错误: 无法获取项目根目录" >&2
-    exit 1
-fi
-
-if ! STORY_DIR=$(get_current_story_dir); then
-    echo "错误: 未找到故事目录" >&2
-    exit 1
-fi
-
-# 默认返回值
-ANALYZE_TYPE="content"
-CHAPTER_COUNT=0
-HAS_SPEC=false
-HAS_PLAN=false
-HAS_TASKS=false
-REASON=""
-
-# 检查规格文件
-SPEC_PATH="${STORY_DIR}/specification.md"
-if [[ -f "$SPEC_PATH" ]]; then
-    HAS_SPEC=true
-fi
-
-# 检查计划文件
-PLAN_PATH="${STORY_DIR}/creative-plan.md"
-if [[ -f "$PLAN_PATH" ]]; then
-    HAS_PLAN=true
-fi
-
-# 检查任务文件
-TASKS_PATH="${STORY_DIR}/tasks.md"
-if [[ -f "$TASKS_PATH" ]]; then
-    HAS_TASKS=true
-fi
-
-# 统计章节数量
-CONTENT_DIR="${STORY_DIR}/content"
-if [[ ! -d "$CONTENT_DIR" ]]; then
-    CONTENT_DIR="${STORY_DIR}/chapters"
-fi
-
-if [[ -d "$CONTENT_DIR" ]]; then
-    # 统计 .md 文件数量（排除索引文件）
-    CHAPTER_COUNT=$(find "$CONTENT_DIR" -maxdepth 1 -type f -name "*.md" \
-        ! -name "README.md" ! -name "index.md" 2>/dev/null | wc -l)
-fi
-
-# 决策逻辑
-if [[ $CHAPTER_COUNT -eq 0 ]]; then
-    # 无章节内容 → 框架分析
-    ANALYZE_TYPE="framework"
-    REASON="无章节内容，建议进行框架一致性分析"
-elif [[ $CHAPTER_COUNT -lt 3 ]]; then
-    # 章节数量不足 → 框架分析（但提示可以开始写作）
-    ANALYZE_TYPE="framework"
-    REASON="章节数量较少（${CHAPTER_COUNT} 章），建议继续写作或进行框架验证"
-else
-    # 章节充足 → 内容分析
-    ANALYZE_TYPE="content"
-    REASON="已完成 ${CHAPTER_COUNT} 章，可进行内容质量分析"
-fi
-
-# 输出 JSON 或人类可读格式
-if [[ "$JSON_OUTPUT" == true ]]; then
-    # JSON 格式输出
-    cat <<EOF
-{"analyze_type":"${ANALYZE_TYPE}","chapter_count":${CHAPTER_COUNT},"has_spec":${HAS_SPEC},"has_plan":${HAS_PLAN},"has_tasks":${HAS_TASKS},"story_dir":"${STORY_DIR}","reason":"${REASON}"}
-EOF
-else
-    # 人类可读输出
-    echo "分析阶段检测结果"
-    echo "=================="
-    echo "故事目录: ${STORY_DIR}"
-    echo "章节数量: ${CHAPTER_COUNT}"
-    echo "规格文件: $(if [[ "$HAS_SPEC" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo "计划文件: $(if [[ "$HAS_PLAN" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo "任务文件: $(if [[ "$HAS_TASKS" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo ""
-    echo "推荐模式: ${ANALYZE_TYPE}"
-    echo "原因: ${REASON}"
-fi

package/templates/resources/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/tracking/plot-tracker.json"
-TIMELINE="$STORY_DIR/tracking/timeline.json"
-RELATIONSHIPS="$STORY_DIR/tracking/relationships.json"
-CHARACTER_STATE="$STORY_DIR/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/tracking" ]; then
-        echo "{
-            \"timestamp\": \"$(date -Iseconds)\",
-            \"total\": $TOTAL_CHECKS,
-            \"passed\": $PASSED_CHECKS,
-            \"warnings\": $WARNINGS,
-            \"errors\": $ERRORS
-        }" > "$STORY_DIR/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')
-**检查对象**: 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