novelws 4.0.0 → 5.0.0

package/templates/resources/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/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

package/templates/resources/scripts/bash/check-plot.sh

@@ -1,374 +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
-
-# 文件路径
-PLOT_TRACKER="$STORY_DIR/tracking/plot-tracker.json"
-OUTLINE="$STORY_DIR/creative-plan.md"
-PROGRESS="$STORY_DIR/progress.json"
-
-# 检查必要文件
-check_required_files() {
-    local missing=false
-
-    if [ ! -f "$PLOT_TRACKER" ]; then
-        echo "⚠️  未找到情节追踪文件，正在创建..." >&2
-        mkdir -p "$STORY_DIR/tracking"
-        # 复制模板
-        if [ -f "$SCRIPT_DIR/../../templates/tracking/plot-tracker.json" ]; then
-            cp "$SCRIPT_DIR/../../templates/tracking/plot-tracker.json" "$PLOT_TRACKER"
-        else
-            echo "错误: 无法找到模板文件" >&2
-            exit 1
-        fi
-    fi
-
-    if [ ! -f "$OUTLINE" ]; then
-        echo "错误: 未找到创作计划 (creative-plan.md)" >&2
-        echo "请先使用 /plan 命令创建创作计划" >&2
-        exit 1
-    fi
-}
-
-# 读取当前进度
-get_current_progress() {
-    if [ -f "$PROGRESS" ]; then
-        CURRENT_CHAPTER=$(jq -r '.statistics.currentChapter // 1' "$PROGRESS")
-        CURRENT_VOLUME=$(jq -r '.statistics.currentVolume // 1' "$PROGRESS")
-    else
-        CURRENT_CHAPTER=$(jq -r '.currentState.chapter // 1' "$PLOT_TRACKER")
-        CURRENT_VOLUME=$(jq -r '.currentState.volume // 1' "$PLOT_TRACKER")
-    fi
-}
-
-# 分析情节对齐
-analyze_plot_alignment() {
-    echo "📊 情节发展检查报告"
-    echo "━━━━━━━━━━━━━━━━━━━━"
-
-    # 当前进度
-    echo "📍 当前进度：第${CURRENT_CHAPTER}章（第${CURRENT_VOLUME}卷）"
-
-    # 读取情节追踪数据
-    if [ -f "$PLOT_TRACKER" ]; then
-        MAIN_PLOT=$(jq -r '.plotlines.main.currentNode // "未设定"' "$PLOT_TRACKER")
-        PLOT_STATUS=$(jq -r '.plotlines.main.status // "unknown"' "$PLOT_TRACKER")
-        echo "📖 主线进度：$MAIN_PLOT [$PLOT_STATUS]"
-
-        # 完成的节点
-        COMPLETED_COUNT=$(jq '.plotlines.main.completedNodes | length' "$PLOT_TRACKER")
-        echo ""
-        echo "✅ 已完成节点：${COMPLETED_COUNT}个"
-        jq -r '.plotlines.main.completedNodes[]? | "  • " + .' "$PLOT_TRACKER" 2>/dev/null || true
-
-        # 即将到来的节点
-        UPCOMING_COUNT=$(jq '.plotlines.main.upcomingNodes | length' "$PLOT_TRACKER")
-        if [ "$UPCOMING_COUNT" -gt 0 ]; then
-            echo ""
-            echo "→ 接下来的节点："
-            jq -r '.plotlines.main.upcomingNodes[0:3][]? | "  • " + .' "$PLOT_TRACKER" 2>/dev/null || true
-        fi
-    fi
-}
-
-# 检查伏笔状态
-check_foreshadowing() {
-    echo ""
-    echo "🎯 伏笔追踪"
-    echo "───────────"
-
-    if [ -f "$PLOT_TRACKER" ]; then
-        # 统计伏笔
-        TOTAL_FORESHADOW=$(jq '.foreshadowing | length' "$PLOT_TRACKER")
-        ACTIVE_FORESHADOW=$(jq '[.foreshadowing[] | select(.status == "active")] | length' "$PLOT_TRACKER")
-        RESOLVED_FORESHADOW=$(jq '[.foreshadowing[] | select(.status == "resolved")] | length' "$PLOT_TRACKER")
-
-        echo "统计：总计${TOTAL_FORESHADOW}个，活跃${ACTIVE_FORESHADOW}个，已回收${RESOLVED_FORESHADOW}个"
-
-        # 列出待处理的伏笔
-        if [ "$ACTIVE_FORESHADOW" -gt 0 ]; then
-            echo ""
-            echo "⚠️ 待处理伏笔："
-            jq -r '.foreshadowing[] | select(.status == "active") |
-                "  • " + .content + "（第" + (.planted.chapter | tostring) + "章埋设）"' \
-                "$PLOT_TRACKER" 2>/dev/null || true
-        fi
-
-        # 检查是否有过期的伏笔（超过30章未处理）
-        OVERDUE=$(jq --arg current "$CURRENT_CHAPTER" '
-            [.foreshadowing[] |
-             select(.status == "active" and .planted.chapter and
-                    (($current | tonumber) - .planted.chapter) > 30)] |
-            length' "$PLOT_TRACKER")
-
-        if [ "$OVERDUE" -gt 0 ]; then
-            echo ""
-            echo "⚠️ 警告：有${OVERDUE}个伏笔超过30章未处理"
-        fi
-    fi
-}
-
-# 检查冲突发展
-check_conflicts() {
-    echo ""
-    echo "⚔️ 冲突追踪"
-    echo "───────────"
-
-    if [ -f "$PLOT_TRACKER" ]; then
-        ACTIVE_CONFLICTS=$(jq '.conflicts.active | length' "$PLOT_TRACKER")
-
-        if [ "$ACTIVE_CONFLICTS" -gt 0 ]; then
-            echo "当前活跃冲突：${ACTIVE_CONFLICTS}个"
-            jq -r '.conflicts.active[] |
-                "  • " + .name + " [" + .intensity + "]"' \
-                "$PLOT_TRACKER" 2>/dev/null || true
-        else
-            echo "暂无活跃冲突"
-        fi
-    fi
-}
-
-# 生成建议
-generate_suggestions() {
-    echo ""
-    echo "💡 建议"
-    echo "───────"
-
-    # 基于当前章节给出建议
-    if [ "$CURRENT_CHAPTER" -lt 10 ]; then
-        echo "• 前10章是关键，确保有足够的钩子吸引读者"
-    elif [ "$CURRENT_CHAPTER" -lt 30 ]; then
-        echo "• 接近第一个小高潮，检查冲突是否足够激烈"
-    elif [ "$((CURRENT_CHAPTER % 60))" -gt 50 ]; then
-        echo "• 接近卷尾，准备高潮和悬念设置"
-    fi
-
-    # 基于伏笔状态给建议
-    if [ "$ACTIVE_FORESHADOW" -gt 5 ]; then
-        echo "• 活跃伏笔较多，考虑在接下来几章回收部分"
-    fi
-
-    # 基于冲突状态给建议
-    if [ "$ACTIVE_CONFLICTS" -eq 0 ] && [ "$CURRENT_CHAPTER" -gt 5 ]; then
-        echo "• 当前无活跃冲突，考虑引入新的矛盾点"
-    fi
-}
-
-# 生成 checklist 格式输出
-output_checklist() {
-    # 检查必要文件（静默）
-    check_required_files > /dev/null 2>&1 || true
-
-    # 获取当前进度
-    get_current_progress
-
-    # 收集数据
-    local main_plot="未设定"
-    local plot_status="unknown"
-    local completed_count=0
-    local upcoming_count=0
-    local total_foreshadow=0
-    local active_foreshadow=0
-    local resolved_foreshadow=0
-    local overdue_foreshadow=0
-    local active_conflicts=0
-
-    if [ -f "$PLOT_TRACKER" ]; then
-        main_plot=$(jq -r '.plotlines.main.currentNode // "未设定"' "$PLOT_TRACKER")
-        plot_status=$(jq -r '.plotlines.main.status // "unknown"' "$PLOT_TRACKER")
-        completed_count=$(jq '.plotlines.main.completedNodes | length' "$PLOT_TRACKER")
-        upcoming_count=$(jq '.plotlines.main.upcomingNodes | length' "$PLOT_TRACKER")
-
-        total_foreshadow=$(jq '.foreshadowing | length' "$PLOT_TRACKER")
-        active_foreshadow=$(jq '[.foreshadowing[] | select(.status == "active")] | length' "$PLOT_TRACKER")
-        resolved_foreshadow=$(jq '[.foreshadowing[] | select(.status == "resolved")] | length' "$PLOT_TRACKER")
-
-        overdue_foreshadow=$(jq --arg current "$CURRENT_CHAPTER" '
-            [.foreshadowing[] |
-             select(.status == "active" and .planted.chapter and
-                    (($current | tonumber) - .planted.chapter) > 30)] |
-            length' "$PLOT_TRACKER")
-
-        active_conflicts=$(jq '.conflicts.active | length' "$PLOT_TRACKER")
-    fi
-
-    # 输出 checklist 格式
-    cat <<EOF
-# 情节对齐检查 Checklist
-
-**检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**检查对象**: plot-tracker.json, creative-plan.md, progress.json
-**当前进度**: 第 ${CURRENT_CHAPTER} 章（第 ${CURRENT_VOLUME} 卷）
-
----
-
-## 文件完整性
-
-- [$([ -f "$PLOT_TRACKER" ] && echo "x" || echo " ")] CHK001 plot-tracker.json 存在
-- [$([ -f "$OUTLINE" ] && echo "x" || echo " ")] CHK002 creative-plan.md 存在
-- [$([ -f "$PROGRESS" ] && echo "x" || echo " ")] CHK003 progress.json 存在
-
-## 情节进度
-
-- [$([ "$plot_status" != "unknown" ] && echo "x" || echo " ")] CHK004 主线情节状态已更新（当前：$plot_status）
-- [x] CHK005 主线情节节点进度：$main_plot
-- [$([ $completed_count -gt 0 ] && echo "x" || echo " ")] CHK006 已完成情节节点（$completed_count 个）
-- [$([ $upcoming_count -gt 0 ] && echo "x" || echo " ")] CHK007 后续情节节点已规划（$upcoming_count 个）
-
-## 伏笔管理
-
-EOF
-
-    if [ $total_foreshadow -gt 0 ]; then
-        echo "- [x] CHK008 伏笔记录存在（总计 $total_foreshadow 个）"
-        echo "- [x] CHK009 伏笔状态跟踪（活跃 $active_foreshadow 个，已回收 $resolved_foreshadow 个）"
-
-        if [ $overdue_foreshadow -eq 0 ]; then
-            echo "- [x] CHK010 伏笔回收及时（无超过30章未处理）"
-        else
-            echo "- [!] CHK010 伏笔回收及时（⚠️ ${overdue_foreshadow}个超过30章未处理）"
-        fi
-
-        if [ $active_foreshadow -le 5 ]; then
-            echo "- [x] CHK011 活跃伏笔数量合理（$active_foreshadow ≤ 5）"
-        elif [ $active_foreshadow -le 10 ]; then
-            echo "- [!] CHK011 活跃伏笔数量偏多（$active_foreshadow 个，建议回收部分）"
-        else
-            echo "- [!] CHK011 活跃伏笔数量过多（⚠️ $active_foreshadow > 10，可能造成混乱）"
-        fi
-    else
-        echo "- [ ] CHK008 伏笔记录存在（未找到伏笔记录）"
-        echo "- [ ] CHK009 伏笔状态跟踪（无数据）"
-        echo "- [ ] CHK010 伏笔回收及时（无数据）"
-        echo "- [ ] CHK011 活跃伏笔数量合理（无数据）"
-    fi
-
-    cat <<EOF
-
-## 冲突发展
-
-EOF
-
-    if [ $active_conflicts -gt 0 ]; then
-        echo "- [x] CHK012 存在活跃冲突（$active_conflicts 个）"
-    elif [ $CURRENT_CHAPTER -gt 5 ]; then
-        echo "- [!] CHK012 存在活跃冲突（⚠️ 当前无活跃冲突，建议引入矛盾点）"
-    else
-        echo "- [x] CHK012 存在活跃冲突（前期章节，可暂无冲突）"
-    fi
-
-    cat <<EOF
-
-## 节奏建议
-
-EOF
-
-    # 基于当前章节给出检查项
-    if [ $CURRENT_CHAPTER -lt 10 ]; then
-        echo "- [ ] CHK013 前10章钩子设置（确保有足够吸引力）"
-    elif [ $CURRENT_CHAPTER -lt 30 ]; then
-        echo "- [ ] CHK014 第一个小高潮准备（检查冲突强度）"
-    elif [ $((CURRENT_CHAPTER % 60)) -gt 50 ]; then
-        echo "- [ ] CHK015 卷尾高潮设置（准备悬念和高潮）"
-    else
-        echo "- [x] CHK016 节奏正常（无特殊节点提醒）"
-    fi
-
-    cat <<EOF
-
----
-
-## 后续行动
-
-EOF
-
-    # 动态生成后续行动
-    local has_actions=false
-
-    if [ $overdue_foreshadow -gt 0 ]; then
-        echo "- [ ] 回收超期伏笔（${overdue_foreshadow}个）"
-        has_actions=true
-    fi
-
-    if [ $active_foreshadow -gt 10 ]; then
-        echo "- [ ] 减少活跃伏笔数量（当前 $active_foreshadow 个）"
-        has_actions=true
-    fi
-
-    if [ $active_conflicts -eq 0 ] && [ $CURRENT_CHAPTER -gt 5 ]; then
-        echo "- [ ] 引入新的冲突点"
-        has_actions=true
-    fi
-
-    if [ $upcoming_count -eq 0 ]; then
-        echo "- [ ] 规划后续情节节点"
-        has_actions=true
-    fi
-
-    if [ "$has_actions" = false ]; then
-        echo "*当前情节发展良好，无需特别行动*"
-    fi
-
-    cat <<EOF
-
----
-
-**检查工具**: check-plot.sh
-**版本**: 1.1 (支持 checklist 输出)
-EOF
-}
-
-# 主函数
-main() {
-    if [ "$CHECKLIST_MODE" = true ]; then
-        output_checklist
-    else
-        echo "🔍 开始检查情节一致性..."
-        echo ""
-
-        # 检查必要文件
-        check_required_files
-
-        # 获取当前进度
-        get_current_progress
-
-        # 执行各项检查
-        analyze_plot_alignment
-        check_foreshadowing
-        check_conflicts
-        generate_suggestions
-
-        echo ""
-        echo "━━━━━━━━━━━━━━━━━━━━"
-        echo "✅ 检查完成"
-    fi
-
-    # 更新检查时间
-    if [ -f "$PLOT_TRACKER" ]; then
-        TEMP_FILE=$(mktemp)
-        jq --arg date "$(date -Iseconds)" '.lastUpdated = $date' "$PLOT_TRACKER" > "$TEMP_FILE"
-        mv "$TEMP_FILE" "$PLOT_TRACKER"
-    fi
-}
-
-# 执行主函数
-main