novelws 1.2.0

package/templates/scripts/powershell/analyze-story.ps1

@@ -0,0 +1,171 @@
+# 故事分析验证脚本
+# 用于 /analyze 命令
+
+param(
+    [string]$StoryName,
+    [string]$AnalysisType = "full"  # full, compliance, quality, progress
+)
+
+# 导入通用函数
+. "$PSScriptRoot\common.ps1"
+
+# 获取项目根目录
+$ProjectRoot = Get-ProjectRoot
+Set-Location $ProjectRoot
+
+# 确定故事路径
+if ([string]::IsNullOrEmpty($StoryName)) {
+    $StoryName = Get-ActiveStory
+}
+
+$StoryDir = "stories\$StoryName"
+
+# 检查必要文件
+function Test-StoryFiles {
+    $missingFiles = @()
+
+    # 检查基准文档
+    if (-not (Test-Path ".specify\memory\constitution.md")) {
+        $missingFiles += "宪法文件"
+    }
+    if (-not (Test-Path "$StoryDir\specification.md")) {
+        $missingFiles += "规格文件"
+    }
+    if (-not (Test-Path "$StoryDir\creative-plan.md")) {
+        $missingFiles += "计划文件"
+    }
+
+    if ($missingFiles.Count -gt 0) {
+        Write-Host "⚠️ 缺少以下基准文档：" -ForegroundColor Yellow
+        foreach ($file in $missingFiles) {
+            Write-Host "  - $file"
+        }
+        return $false
+    }
+
+    return $true
+}
+
+# 统计内容
+function Get-ContentAnalysis {
+    $contentDir = "$StoryDir\content"
+    $totalWords = 0
+    $chapterCount = 0
+
+    if (Test-Path $contentDir) {
+        $mdFiles = Get-ChildItem "$contentDir\*.md" -ErrorAction SilentlyContinue
+
+        foreach ($file in $mdFiles) {
+            $chapterCount++
+            # 简单的字数统计（中文按字符算）
+            $content = Get-Content $file.FullName -Raw
+            $words = ($content -replace '\s', '').Length
+            $totalWords += $words
+        }
+    }
+
+    Write-Host "内容统计："
+    Write-Host "  总字数：$totalWords"
+    Write-Host "  章节数：$chapterCount"
+
+    if ($chapterCount -gt 0) {
+        $avgLength = [math]::Round($totalWords / $chapterCount)
+        Write-Host "  平均章节长度：$avgLength"
+    }
+}
+
+# 检查任务完成度
+function Test-TaskCompletion {
+    $tasksFile = "$StoryDir\tasks.md"
+
+    if (-not (Test-Path $tasksFile)) {
+        Write-Host "任务文件不存在"
+        return
+    }
+
+    $content = Get-Content $tasksFile -Raw
+    $totalTasks = ([regex]::Matches($content, '^- \[', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+    $completedTasks = ([regex]::Matches($content, '^- \[x\]', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+    $inProgress = ([regex]::Matches($content, '^- \[~\]', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+    $pending = $totalTasks - $completedTasks - $inProgress
+
+    Write-Host "任务进度："
+    Write-Host "  总任务：$totalTasks"
+    Write-Host "  已完成：$completedTasks"
+    Write-Host "  进行中：$inProgress"
+    Write-Host "  未开始：$pending"
+
+    if ($totalTasks -gt 0) {
+        $completionRate = [math]::Round(($completedTasks * 100) / $totalTasks)
+        Write-Host "  完成率：$completionRate%"
+    }
+}
+
+# 检查规格符合度
+function Test-SpecificationCompliance {
+    $specFile = "$StoryDir\specification.md"
+
+    Write-Host "规格符合度检查："
+
+    if (Test-Path $specFile) {
+        $content = Get-Content $specFile -Raw
+
+        # 检查P0需求（简化版）
+        if ($content -match "### 必须包含（P0）") {
+            Write-Host "  P0需求：检测到，需人工验证"
+        }
+
+        # 检查是否还有[需要澄清]标记
+        $unclearCount = ([regex]::Matches($content, '\[需要澄清\]')).Count
+        if ($unclearCount -gt 0) {
+            Write-Host "  ⚠️ 仍有 $unclearCount 处需要澄清" -ForegroundColor Yellow
+        }
+        else {
+            Write-Host "  ✅ 所有决策已澄清" -ForegroundColor Green
+        }
+    }
+}
+
+# 主分析流程
+Write-Host "故事分析报告"
+Write-Host "============"
+Write-Host "故事：$StoryName"
+Write-Host "分析时间：$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
+Write-Host ""
+
+# 检查基准文档
+if (-not (Test-StoryFiles)) {
+    Write-Host ""
+    Write-Host "❌ 无法进行完整分析，请先完成基准文档" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "✅ 基准文档完整" -ForegroundColor Green
+Write-Host ""
+
+# 根据分析类型执行
+switch ($AnalysisType) {
+    "full" {
+        Get-ContentAnalysis
+        Write-Host ""
+        Test-TaskCompletion
+        Write-Host ""
+        Test-SpecificationCompliance
+    }
+    "quality" {
+        Get-ContentAnalysis
+    }
+    "progress" {
+        Test-TaskCompletion
+    }
+    "compliance" {
+        Test-SpecificationCompliance
+    }
+    default {
+        Write-Host "未知的分析类型：$AnalysisType" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Write-Host ""
+Write-Host "分析完成。详细报告已保存到：$StoryDir\analysis-report.md"

package/templates/scripts/powershell/check-analyze-stage.ps1

@@ -0,0 +1,110 @@
+#!/usr/bin/env pwsh
+# 检测 analyze 命令应该执行的阶段
+# 返回 JSON 格式的阶段信息
+
+param(
+    [switch]$Json
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+# 加载公共函数
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+. (Join-Path $scriptDir "common.ps1")
+
+# 获取项目根目录和故事目录
+try {
+    $projectRoot = Get-ProjectRoot
+    $storyDir = Get-CurrentStoryDir
+} catch {
+    Write-Error "错误: $_"
+    exit 1
+}
+
+if (-not $storyDir) {
+    Write-Error "错误: 未找到故事目录"
+    exit 1
+}
+
+# 默认返回值
+$analyzeType = "content"
+$chapterCount = 0
+$hasSpec = $false
+$hasPlan = $false
+$hasTasks = $false
+$reason = ""
+
+# 检查规格文件
+$specPath = Join-Path $storyDir "specification.md"
+if (Test-Path $specPath) {
+    $hasSpec = $true
+}
+
+# 检查计划文件
+$planPath = Join-Path $storyDir "creative-plan.md"
+if (Test-Path $planPath) {
+    $hasPlan = $true
+}
+
+# 检查任务文件
+$tasksPath = Join-Path $storyDir "tasks.md"
+if (Test-Path $tasksPath) {
+    $hasTasks = $true
+}
+
+# 统计章节数量
+$contentDir = Join-Path $storyDir "content"
+if (-not (Test-Path $contentDir)) {
+    $contentDir = Join-Path $storyDir "chapters"
+}
+
+if (Test-Path $contentDir) {
+    # 统计 .md 文件数量（排除索引文件）
+    $chapters = Get-ChildItem -Path $contentDir -Filter "*.md" -File |
+                Where-Object { $_.Name -notin @("README.md", "index.md") }
+    $chapterCount = $chapters.Count
+}
+
+# 决策逻辑
+if ($chapterCount -eq 0) {
+    # 无章节内容 → 框架分析
+    $analyzeType = "framework"
+    $reason = "无章节内容，建议进行框架一致性分析"
+} elseif ($chapterCount -lt 3) {
+    # 章节数量不足 → 框架分析（但提示可以开始写作）
+    $analyzeType = "framework"
+    $reason = "章节数量较少（$chapterCount 章），建议继续写作或进行框架验证"
+} else {
+    # 章节充足 → 内容分析
+    $analyzeType = "content"
+    $reason = "已完成 $chapterCount 章，可进行内容质量分析"
+}
+
+# 输出 JSON 或人类可读格式
+if ($Json) {
+    # JSON 格式输出
+    $output = @{
+        analyze_type = $analyzeType
+        chapter_count = $chapterCount
+        has_spec = $hasSpec
+        has_plan = $hasPlan
+        has_tasks = $hasTasks
+        story_dir = $storyDir
+        reason = $reason
+    }
+
+    $output | ConvertTo-Json -Compress
+} else {
+    # 人类可读输出
+    Write-Host "分析阶段检测结果"
+    Write-Host "=================="
+    Write-Host "故事目录: $storyDir"
+    Write-Host "章节数量: $chapterCount"
+    Write-Host "规格文件: $(if ($hasSpec) { '✅' } else { '❌' })"
+    Write-Host "计划文件: $(if ($hasPlan) { '✅' } else { '❌' })"
+    Write-Host "任务文件: $(if ($hasTasks) { '✅' } else { '❌' })"
+    Write-Host ""
+    Write-Host "推荐模式: $analyzeType"
+    Write-Host "原因: $reason"
+}

package/templates/scripts/powershell/check-consistency.ps1

@@ -0,0 +1,138 @@
+#!/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/*）" }
+
+$progress = Join-Path $storyDir "progress.json"
+$plot = Join-Path $storyDir "spec/tracking/plot-tracker.json"
+if (-not (Test-Path $plot)) { $plot = Join-Path $root "spec/tracking/plot-tracker.json" }
+$timeline = Join-Path $storyDir "spec/tracking/timeline.json"
+if (-not (Test-Path $timeline)) { $timeline = Join-Path $root "spec/tracking/timeline.json" }
+$rels = Join-Path $storyDir "spec/tracking/relationships.json"
+if (-not (Test-Path $rels)) { $rels = Join-Path $root "spec/tracking/relationships.json" }
+$charState = Join-Path $storyDir "spec/tracking/character-state.json"
+if (-not (Test-Path $charState)) { $charState = Join-Path $root "spec/tracking/character-state.json" }
+
+$TOTAL=0; $PASS=0; $WARN=0; $ERR=0
+function Check([string]$name, [bool]$ok, [string]$msg) {
+  $script:TOTAL++
+  if ($ok) { Write-Host "✓ $name" -ForegroundColor Green; $script:PASS++ }
+  else { Write-Host "✗ $name: $msg" -ForegroundColor Red; $script:ERR++ }
+}
+function Warn([string]$msg) { Write-Host "⚠ $msg" -ForegroundColor Yellow; $script:WARN++ }
+
+function Check-FileIntegrity {
+  Write-Host "📁 检查文件完整性"
+  Write-Host "────────────────"
+  Check "progress.json" (Test-Path $progress) "文件不存在"
+  Check "plot-tracker.json" (Test-Path $plot) "文件不存在"
+  Check "timeline.json" (Test-Path $timeline) "文件不存在"
+  Check "relationships.json" (Test-Path $rels) "文件不存在"
+  Check "character-state.json" (Test-Path $charState) "文件不存在"
+  Write-Host ""
+}
+
+function Check-ChapterConsistency {
+  Write-Host "📖 检查章节号一致性"
+  Write-Host "───────────────────"
+  if ((Test-Path $progress) -and (Test-Path $plot)) {
+    $p = Get-Content -LiteralPath $progress -Raw -Encoding UTF8 | ConvertFrom-Json
+    $j = Get-Content -LiteralPath $plot -Raw -Encoding UTF8 | ConvertFrom-Json
+    $pCh = [int]($p.statistics.currentChapter ?? 0)
+    $plCh = [int]($j.currentState.chapter ?? 0)
+    Check "章节号同步" ($pCh -eq $plCh) "progress($pCh) != plot-tracker($plCh)"
+    if (Test-Path $charState) {
+      $cs = Get-Content -LiteralPath $charState -Raw -Encoding UTF8 | ConvertFrom-Json
+      # 示例结构中 protagonist 字段不稳定，回退 characters->主角
+      $csCh = [int]($cs.protagonist.currentStatus.chapter)
+      if (-not $csCh) { $csCh = [int]($cs.characters.'主角'.lastSeen.chapter) }
+      if ($csCh) { Check "角色状态章节同步" ($pCh -eq $csCh) "与character-state($csCh)不一致" }
+    }
+  } else { Warn "部分追踪文件缺失，无法完成章节检查" }
+  Write-Host ""
+}
+
+function Check-TimelineConsistency {
+  Write-Host "⏰ 检查时间线连续性"
+  Write-Host "───────────────────"
+  if (Test-Path $timeline) {
+    $j = Get-Content -LiteralPath $timeline -Raw -Encoding UTF8 | ConvertFrom-Json
+    $events = @($j.events | Sort-Object chapter)
+    $issues=0; $prev=-1
+    foreach ($e in $events) { if ($prev -ge 0 -and $e.chapter -le $prev) { $issues++ }; $prev=$e.chapter }
+    Check "时间事件顺序" ($issues -eq 0) "发现${issues}个乱序事件"
+    $curTime = $j.storyTime.current
+    Check "当前时间设置" ([bool]$curTime) "当前故事时间未设置"
+  } else { Warn "时间线文件不存在" }
+  Write-Host ""
+}
+
+function Check-CharacterConsistency {
+  Write-Host "👥 检查角色状态合理性"
+  Write-Host "─────────────────────"
+  if ((Test-Path $charState) -and (Test-Path $rels)) {
+    $cs = Get-Content -LiteralPath $charState -Raw -Encoding UTF8 | ConvertFrom-Json
+    $rel = Get-Content -LiteralPath $rels -Raw -Encoding UTF8 | ConvertFrom-Json
+    $name = $cs.protagonist.name
+    if (-not $name) { $name = $cs.characters.'主角'.name }
+    if ($name) {
+      $has = $false
+      if ($rel.characters) { $has = $rel.characters.PSObject.Properties.Name -contains $name }
+      Check "主角关系记录" $has "主角'$name'在relationships中无记录"
+    }
+    $loc = $cs.protagonist.currentStatus.location
+    if (-not $loc) { $loc = $cs.characters.'主角'.location }
+    Check "主角位置记录" ([bool]$loc) "主角当前位置未记录"
+  } else { Warn "角色追踪文件不完整" }
+  Write-Host ""
+}
+
+function Check-ForeshadowingPlan {
+  Write-Host "🎯 检查伏笔管理"
+  Write-Host "──────────────"
+  if (Test-Path $plot) {
+    $j = Get-Content -LiteralPath $plot -Raw -Encoding UTF8 | ConvertFrom-Json
+    $fs = @($j.foreshadowing)
+    $total = $fs.Count
+    $active = @($fs | Where-Object { $_.status -eq 'active' }).Count
+    Write-Host "  📊 伏笔统计: 总计${total}个，活跃${active}个"
+    if ($active -gt 10) { Warn "活跃伏笔过多(${active}个)，可能造成读者困惑" }
+  } else { Warn "情节追踪文件不存在" }
+  Write-Host ""
+}
+
+Write-Host "═══════════════════════════════════════"
+Write-Host "📊 综合一致性检查报告"
+Write-Host "═══════════════════════════════════════"
+Write-Host ""
+
+Check-FileIntegrity
+Check-ChapterConsistency
+Check-TimelineConsistency
+Check-CharacterConsistency
+Check-ForeshadowingPlan
+
+Write-Host "═══════════════════════════════════════"
+Write-Host "📈 检查结果汇总"
+Write-Host "───────────────────"
+Write-Host "  总检查项: $TOTAL"
+Write-Host "  通过: $PASS"
+Write-Host "  警告: $WARN"
+Write-Host "  错误: $ERR"
+
+if ($ERR -eq 0 -and $WARN -eq 0) { Write-Host "`n✅ 完美！所有检查项全部通过" -ForegroundColor Green }
+elseif ($ERR -eq 0) { Write-Host "`n⚠️  存在$WARN 个警告，建议关注" -ForegroundColor Yellow }
+else { Write-Host "`n❌ 发现$ERR 个错误，需要修正" -ForegroundColor Red }
+
+Write-Host "═══════════════════════════════════════"
+Write-Host "检查时间: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
+
+if ($ERR -gt 0) { exit 1 } else { exit 0 }
+

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

@@ -0,0 +1,139 @@
+#!/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 "spec/tracking/plot-tracker.json"
+if (-not (Test-Path $plotPath)) { $plotPath = Join-Path $root "spec/tracking/plot-tracker.json" }
+$outlinePath = Join-Path $storyDir "outline.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 "未找到章节大纲 outline.md，请先使用 /outline" }
+}
+
+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/scripts/powershell/check-timeline.ps1

@@ -0,0 +1,112 @@
+#!/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 "spec/tracking/timeline.json"
+if (-not (Test-Path $timelinePath)) { $timelinePath = Join-Path $root "spec/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 }
+}
+