novelws 4.0.0 → 5.0.0

package/templates/resources/scripts/powershell/check-facts.ps1

@@ -1,195 +0,0 @@
-# check-facts.ps1 - Story Facts 引用扫描脚本
-# 扫描章节中的 story-facts 注释，生成引用报告
-
-param(
-    [switch]$Json,
-    [string]$Story = ""
-)
-
-$ErrorActionPreference = "Stop"
-
-# 获取项目根目录
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = (Get-Item (Join-Path $ScriptDir ".." "..")).FullName
-
-# 检查 story-facts.json 是否存在
-$FactsFile = Join-Path $ProjectRoot "spec" "tracking" "story-facts.json"
-if (-not (Test-Path $FactsFile)) {
-    if ($Json) {
-        $errorObj = @{
-            error = "story-facts.json not found"
-            chapters = @()
-            unreferenced_facts = @()
-            unknown_ids = @()
-        }
-        Write-Output ($errorObj | ConvertTo-Json -Compress)
-    } else {
-        Write-Host "❌ 未找到 story-facts.json" -ForegroundColor Red
-        Write-Host "   路径: $FactsFile"
-        Write-Host "   请先使用 /facts 命令初始化"
-    }
-    exit 1
-}
-
-# 读取已注册的 fact ID 列表
-try {
-    $factsData = Get-Content $FactsFile -Raw | ConvertFrom-Json
-    $registeredFacts = $factsData.facts | ForEach-Object { $_.id }
-    if ($null -eq $registeredFacts) {
-        $registeredFacts = @()
-    } elseif ($registeredFacts -isnot [array]) {
-        $registeredFacts = @($registeredFacts)
-    }
-} catch {
-    if ($Json) {
-        $errorObj = @{
-            error = "Failed to parse story-facts.json: $_"
-            chapters = @()
-            unreferenced_facts = @()
-            unknown_ids = @()
-        }
-        Write-Output ($errorObj | ConvertTo-Json -Compress)
-    } else {
-        Write-Host "❌ 无法解析 story-facts.json: $_" -ForegroundColor Red
-    }
-    exit 1
-}
-
-# 确定扫描目录
-if ($Story) {
-    $ContentDir = Join-Path $ProjectRoot "stories" $Story "content"
-    if (-not (Test-Path $ContentDir)) {
-        if ($Json) {
-            $errorObj = @{
-                error = "story directory not found: $Story"
-                chapters = @()
-                unreferenced_facts = @()
-                unknown_ids = @()
-            }
-            Write-Output ($errorObj | ConvertTo-Json -Compress)
-        } else {
-            Write-Host "❌ 未找到故事目录: $Story" -ForegroundColor Red
-        }
-        exit 1
-    }
-    $chapterFiles = Get-ChildItem -Path $ContentDir -Filter "*.md" -File
-} else {
-    $storiesDir = Join-Path $ProjectRoot "stories"
-    if (Test-Path $storiesDir) {
-        $chapterFiles = Get-ChildItem -Path $storiesDir -Recurse -Filter "*.md" -File |
-            Where-Object { $_.FullName -match '\\content\\[^\\]+\.md$' }
-    } else {
-        $chapterFiles = @()
-    }
-}
-
-# 初始化数据结构
-$chapterFacts = @{}  # key: 文件路径, value: fact IDs 数组
-$factReferenced = @{}  # key: fact ID, value: $true if referenced
-$unknownIdsMap = @{}  # key: unknown ID, value: $true
-
-# 扫描章节文件
-foreach ($file in $chapterFiles) {
-    $content = Get-Content $file.FullName -Raw
-
-    # 提取 <!-- story-facts: ... --> 注释
-    # 正则：<!-- story-facts: (.+?) -->
-    $match = [regex]::Match($content, '<!--\s*story-facts:\s*([^-]+?)\s*-->')
-
-    if ($match.Success) {
-        $factsLine = $match.Groups[1].Value.Trim()
-
-        # 分割为数组并去除空格
-        $factIds = $factsLine -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
-
-        if ($factIds.Count -gt 0) {
-            $cleanedIds = @()
-
-            foreach ($id in $factIds) {
-                $cleanedIds += $id
-
-                # 检查是否已注册
-                if ($registeredFacts -contains $id) {
-                    $factReferenced[$id] = $true
-                } else {
-                    $unknownIdsMap[$id] = $true
-                }
-            }
-
-            $chapterFacts[$file.FullName] = $cleanedIds
-        }
-    }
-}
-
-# 计算未被引用的事实
-$unreferencedFacts = @()
-foreach ($factId in $registeredFacts) {
-    if (-not $factReferenced.ContainsKey($factId)) {
-        $unreferencedFacts += $factId
-    }
-}
-
-# 收集 unknown IDs
-$unknownIds = @($unknownIdsMap.Keys)
-
-# 输出结果
-if ($Json) {
-    # JSON 输出
-    $chapters = @()
-    foreach ($file in $chapterFacts.Keys) {
-        $relPath = $file.Replace($ProjectRoot + "\", "").Replace("\", "/")
-        $chapters += @{
-            file = $relPath
-            facts = $chapterFacts[$file]
-        }
-    }
-
-    $result = @{
-        chapters = $chapters
-        unreferenced_facts = $unreferencedFacts
-        unknown_ids = $unknownIds
-    }
-
-    Write-Output ($result | ConvertTo-Json -Depth 10 -Compress)
-} else {
-    # 人类可读输出
-    Write-Host ""
-    Write-Host "📊 Story Facts 引用报告" -ForegroundColor Cyan
-    Write-Host ("━" * 40)
-    Write-Host ""
-
-    Write-Host "已注册事实: " -NoNewline
-    Write-Host "$($registeredFacts.Count) 个" -ForegroundColor Green
-    Write-Host "引用章节: " -NoNewline
-    Write-Host "$($chapterFacts.Count) 个" -ForegroundColor Green
-    Write-Host ""
-
-    if ($chapterFacts.Count -gt 0) {
-        Write-Host "章节引用:" -ForegroundColor White
-        foreach ($file in $chapterFacts.Keys) {
-            $filename = Split-Path -Leaf $file
-            $facts = $chapterFacts[$file] -join ", "
-            Write-Host "  " -NoNewline
-            Write-Host $filename -ForegroundColor Blue -NoNewline
-            Write-Host " → $facts"
-        }
-        Write-Host ""
-    }
-
-    if ($unreferencedFacts.Count -gt 0) {
-        Write-Host "未被引用的事实: " -ForegroundColor Yellow -NoNewline
-        Write-Host ($unreferencedFacts -join ", ")
-        Write-Host ""
-    } else {
-        Write-Host "✓ 所有事实都被至少一个章节引用" -ForegroundColor Green
-        Write-Host ""
-    }
-
-    if ($unknownIds.Count -gt 0) {
-        Write-Host "未知 ID (章节中引用但未注册): " -ForegroundColor Red -NoNewline
-        Write-Host ($unknownIds -join ", ")
-        Write-Host "  提示: 可能是拼写错误或需要注册到 story-facts.json" -ForegroundColor Yellow
-    } else {
-        Write-Host "✓ 未检测到未知 ID" -ForegroundColor Green
-    }
-}

package/templates/resources/scripts/powershell/check-plot.ps1

@@ -1,139 +0,0 @@
-#!/usr/bin/env pwsh
-# 检查情节发展的一致性和连贯性（PowerShell）
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = 'Stop'
-
-. "$PSScriptRoot/common.ps1"
-
-$root = Get-ProjectRoot
-$storyDir = Get-CurrentStoryDir
-if (-not $storyDir) { throw "未找到故事项目（stories/*）" }
-
-$plotPath = Join-Path $storyDir "tracking/plot-tracker.json"
-if (-not (Test-Path $plotPath)) { $plotPath = Join-Path $root "tracking/plot-tracker.json" }
-$outlinePath = Join-Path $storyDir "creative-plan.md"
-$progressPath = Join-Path $storyDir "progress.json"
-
-function Ensure-PlotTracker {
-  if (-not (Test-Path $plotPath)) {
-    Write-Host "⚠️  未找到情节追踪文件，正在创建..."
-    $tpl = Join-Path $root "templates/tracking/plot-tracker.json"
-    if (-not (Test-Path $tpl)) { throw "无法找到模板文件" }
-    New-Item -ItemType Directory -Path (Split-Path $plotPath -Parent) -Force | Out-Null
-    Copy-Item $tpl $plotPath -Force
-  }
-  if (-not (Test-Path $outlinePath)) { throw "未找到创作计划 creative-plan.md，请先使用 /plan" }
-}
-
-function Get-CurrentProgress {
-  if (Test-Path $progressPath) {
-    $p = Get-Content -LiteralPath $progressPath -Raw -Encoding UTF8 | ConvertFrom-Json
-    return @{ chapter = ($p.statistics.currentChapter ?? 1); volume = ($p.statistics.currentVolume ?? 1) }
-  }
-  if (Test-Path $plotPath) {
-    $j = Get-Content -LiteralPath $plotPath -Raw -Encoding UTF8 | ConvertFrom-Json
-    return @{ chapter = ($j.currentState.chapter ?? 1); volume = ($j.currentState.volume ?? 1) }
-  }
-  return @{ chapter = 1; volume = 1 }
-}
-
-function Analyze-PlotAlignment {
-  Write-Host "📊 情节发展检查报告"
-  Write-Host "━━━━━━━━━━━━━━━━━━━━"
-  $cur = Get-CurrentProgress
-  Write-Host "📍 当前进度：第$($cur.chapter)章（第$($cur.volume)卷）"
-
-  if (Test-Path $plotPath) {
-    $j = Get-Content -LiteralPath $plotPath -Raw -Encoding UTF8 | ConvertFrom-Json
-    $main = $j.plotlines.main
-    $mainPlot = $main.currentNode
-    $status = $main.status
-    Write-Host "📖 主线进度：$mainPlot [$status]"
-
-    $completed = @($main.completedNodes)
-    Write-Host ""
-    Write-Host "✅ 已完成节点：$($completed.Count)个"
-    $completed | ForEach-Object { Write-Host "  • $_" }
-
-    $upcoming = @($main.upcomingNodes)
-    if ($upcoming.Count -gt 0) {
-      Write-Host ""
-      Write-Host "→ 接下来的节点："
-      $upcoming | Select-Object -First 3 | ForEach-Object { Write-Host "  • $_" }
-    }
-    return @{ cur = $cur; json = $j }
-  }
-}
-
-function Check-Foreshadowing($state) {
-  Write-Host ""
-  Write-Host "🎯 伏笔追踪"
-  Write-Host "───────────"
-  $j = $state.json
-  $curCh = [int]$state.cur.chapter
-  $fs = @($j.foreshadowing)
-  $total = $fs.Count
-  $active = @($fs | Where-Object { $_.status -eq 'active' }).Count
-  $resolved = @($fs | Where-Object { $_.status -eq 'resolved' }).Count
-  Write-Host "统计：总计${total}个，活跃${active}个，已回收${resolved}个"
-
-  if ($active -gt 0) {
-    Write-Host ""
-    Write-Host "⚠️ 待处理伏笔："
-    $fs | Where-Object { $_.status -eq 'active' } | ForEach-Object {
-      $ch = $_.planted.chapter
-      Write-Host "  • $($_.content)（第$ch章埋设）"
-    }
-  }
-
-  $overdue = @($fs | Where-Object { $_.status -eq 'active' -and $_.planted.chapter -and ($curCh - [int]$_.planted.chapter) -gt 30 }).Count
-  if ($overdue -gt 0) { Write-Host ""; Write-Host "⚠️ 警告：有${overdue}个伏笔超过30章未处理" }
-}
-
-function Check-Conflicts($state) {
-  Write-Host ""
-  Write-Host "⚔️ 冲突追踪"
-  Write-Host "───────────"
-  $active = @($state.json.conflicts.active)
-  $count = $active.Count
-  if ($count -gt 0) {
-    Write-Host "当前活跃冲突：${count}个"
-    $active | ForEach-Object { Write-Host ("  • " + $_.name + " [" + $_.intensity + "]") }
-  } else { Write-Host "暂无活跃冲突" }
-}
-
-function Generate-Suggestions($state) {
-  Write-Host ""
-  Write-Host "💡 建议"
-  Write-Host "───────"
-  $ch = [int]$state.cur.chapter
-  if ($ch -lt 10) { Write-Host "• 前10章是关键，确保有足够的钩子吸引读者" }
-  elseif ($ch -lt 30) { Write-Host "• 接近第一个小高潮，检查冲突是否足够激烈" }
-  elseif (($ch % 60) -gt 50) { Write-Host "• 接近卷尾，准备高潮和悬念设置" }
-
-  $activeFo = @($state.json.foreshadowing | Where-Object { $_.status -eq 'active' }).Count
-  if ($activeFo -gt 5) { Write-Host "• 活跃伏笔较多，考虑在接下来几章回收部分" }
-  $activeConf = @($state.json.conflicts.active).Count
-  if ($activeConf -eq 0 -and $ch -gt 5) { Write-Host "• 当前无活跃冲突，考虑引入新的矛盾点" }
-}
-
-Write-Host "🔍 开始检查情节一致性..."
-Write-Host ""
-Ensure-PlotTracker
-$st = Analyze-PlotAlignment
-Check-Foreshadowing $st
-Check-Conflicts $st
-Generate-Suggestions $st
-
-Write-Host ""
-Write-Host "━━━━━━━━━━━━━━━━━━━━"
-Write-Host "✅ 检查完成"
-
-# 更新时间戳
-if (Test-Path $plotPath) {
-  $json = Get-Content -LiteralPath $plotPath -Raw -Encoding UTF8 | ConvertFrom-Json
-  $json.lastUpdated = (Get-Date).ToString('yyyy-MM-ddTHH:mm:ss')
-  $json | ConvertTo-Json -Depth 12 | Set-Content -LiteralPath $plotPath -Encoding UTF8
-}
-

package/templates/resources/scripts/powershell/check-timeline.ps1

@@ -1,112 +0,0 @@
-#!/usr/bin/env pwsh
-# 时间线管理与检查（PowerShell）
-
-param(
-  [ValidateSet('show','add','check','sync')]
-  [string]$Command = 'show',
-  [string]$Param1,
-  [string]$Param2
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = 'Stop'
-
-. "$PSScriptRoot/common.ps1"
-
-$root = Get-ProjectRoot
-$storyDir = Get-CurrentStoryDir
-if (-not $storyDir) { throw "未找到故事项目（stories/*）" }
-
-$timelinePath = Join-Path $storyDir "tracking/timeline.json"
-if (-not (Test-Path $timelinePath)) { $timelinePath = Join-Path $root "tracking/timeline.json" }
-
-function Init-Timeline {
-  if (-not (Test-Path $timelinePath)) {
-    Write-Host "⚠️  未找到时间线文件，正在创建..."
-    $tpl = Join-Path $root "templates/tracking/timeline.json"
-    if (-not (Test-Path $tpl)) { throw "无法找到模板文件" }
-    New-Item -ItemType Directory -Path (Split-Path $timelinePath -Parent) -Force | Out-Null
-    Copy-Item $tpl $timelinePath -Force
-    Write-Host "✅ 时间线文件已创建"
-  }
-}
-
-function Show-Timeline {
-  Write-Host "📅 故事时间线"
-  Write-Host "━━━━━━━━━━━━━━━━━━━━"
-  if (-not (Test-Path $timelinePath)) { Write-Host "未找到时间线文件"; return }
-  $j = Get-Content -LiteralPath $timelinePath -Raw -Encoding UTF8 | ConvertFrom-Json
-  $cur = $j.storyTime.current
-  if (-not $cur) { $cur = '未设定' }
-  Write-Host "⏰ 当前时间：$cur"
-  Write-Host ""
-  $events = @($j.events)
-  if ($events.Count -gt 0) {
-    Write-Host "📖 重要事件："
-    Write-Host "───────────────"
-    $events | Sort-Object chapter -Descending | Select-Object -First 5 | ForEach-Object {
-      Write-Host ("第{0}章 | {1} | {2}" -f $_.chapter, $_.date, $_.event)
-    }
-  }
-  $p = $j.parallelEvents.timepoints
-  if ($p) {
-    Write-Host ""
-    Write-Host "🔄 并行事件："
-    $p.PSObject.Properties | ForEach-Object { Write-Host ("{0}: {1}" -f $_.Name, (@($_.Value) -join ', ')) }
-  }
-}
-
-function Add-Event([int]$chapter, [string]$date, [string]$event) {
-  if (-not $chapter -or -not $date -or -not $event) { throw "用法: check-timeline.ps1 add <章节号> <时间> <事件描述>" }
-  Init-Timeline
-  $j = Get-Content -LiteralPath $timelinePath -Raw -Encoding UTF8 | ConvertFrom-Json
-  if (-not $j.events) { $j | Add-Member -NotePropertyName events -NotePropertyValue @() }
-  $j.events += [pscustomobject]@{ chapter=$chapter; date=$date; event=$event; duration=''; participants=@() }
-  $j.events = @($j.events | Sort-Object chapter)
-  $j.lastUpdated = (Get-Date).ToString('yyyy-MM-ddTHH:mm:ss')
-  $j | ConvertTo-Json -Depth 12 | Set-Content -LiteralPath $timelinePath -Encoding UTF8
-  Write-Host "✅ 事件已添加：第${chapter}章 - $date - $event"
-}
-
-function Check-Continuity {
-  Write-Host "🔍 检查时间线连续性"
-  Write-Host "━━━━━━━━━━━━━━━━━━━━"
-  if (-not (Test-Path $timelinePath)) { throw "时间线文件不存在" }
-  $j = Get-Content -LiteralPath $timelinePath -Raw -Encoding UTF8 | ConvertFrom-Json
-  $chapters = @($j.events | Sort-Object chapter | ForEach-Object { $_.chapter })
-  $issues = 0
-  $prev = -1
-  foreach ($c in $chapters) {
-    if ($prev -ge 0 -and $c -le $prev) {
-      Write-Host "⚠️  章节顺序异常：第$c 章出现在第$prev 章之后"
-      $issues++
-    }
-    $prev = $c
-  }
-  if ($issues -eq 0) { Write-Host "`n✅ 时间线检查通过，未发现逻辑问题" }
-  else { Write-Host "`n⚠️  发现${issues}个潜在问题，请检查" }
-  $j.lastChecked = (Get-Date).ToString('yyyy-MM-ddTHH:mm:ss')
-  if (-not $j.anomalies) { $j | Add-Member anomalies (@{}) }
-  $j.anomalies.lastCheckIssues = $issues
-  $j | ConvertTo-Json -Depth 12 | Set-Content -LiteralPath $timelinePath -Encoding UTF8
-}
-
-function Sync-Parallel([string]$timepoint, [string]$eventsCsv) {
-  if (-not $timepoint -or -not $eventsCsv) { throw "用法: check-timeline.ps1 sync <时间点> <事件列表,逗号分隔>" }
-  Init-Timeline
-  $j = Get-Content -LiteralPath $timelinePath -Raw -Encoding UTF8 | ConvertFrom-Json
-  if (-not $j.parallelEvents) { $j | Add-Member -NotePropertyName parallelEvents -NotePropertyValue @{ timepoints=@{} } }
-  $events = $eventsCsv.Split(',').Trim()
-  $j.parallelEvents.timepoints[$timepoint] = $events
-  $j.lastUpdated = (Get-Date).ToString('yyyy-MM-ddTHH:mm:ss')
-  $j | ConvertTo-Json -Depth 12 | Set-Content -LiteralPath $timelinePath -Encoding UTF8
-  Write-Host "✅ 并行事件已同步：$timepoint"
-}
-
-switch ($Command) {
-  'show'  { Init-Timeline; Show-Timeline }
-  'add'   { Add-Event -chapter ([int]$Param1) -date $Param2 -event ($args | Select-Object -Skip 2 | Out-String).Trim() }
-  'check' { Check-Continuity }
-  'sync'  { Sync-Parallel -timepoint $Param1 -eventsCsv $Param2 }
-}
-