refactor: generate only zh-CN and en-US project status reports, each for its own stories; clean up obsolete reports

Author: Hongwei-MB

.nuke/build.schema.json

@@ -27,8 +27,10 @@
         "Build",
         "BuildAll",
         "Clean",
+        "CleanPluginsArtifacts",
         "Default",
         "Pack",
+        "Plugin",
         "Restore",
         "Run",
         "Test"
@@ -113,6 +115,14 @@
             "Release"
           ]
         },
+        "name": {
+          "type": "string",
+          "description": "Name of the plugin to pack (required when op=single)"
+        },
+        "op": {
+          "type": "string",
+          "description": "Operation to perform: 'all' (default) or 'single'"
+        },
         "Solution": {
           "type": "string",
           "description": "Path to a solution file that is automatically loaded"

README-Project-Status.md

@@ -0,0 +1,53 @@
+# Modulus 项目状态
+
+本文档提供了 Modulus 项目的当前状态和进度概览。
+
+## Story 命名规则
+
+我们采用统一的 Story 命名规则：
+
+- **文件格式**：`S-XXXX-标题.md` (例如：`S-0001-初始项目设置.md`)
+- **标题格式**：`# S-XXXX-标题` (例如：`# S-0001-初始项目设置`)
+- **必要元数据**：每个 Story 文档需包含优先级和状态标记
+
+```markdown
+<!-- 优先级：P0 | P1 | P2 -->
+<!-- 状态：待开始 | 进行中 | 已完成 -->
+```
+
+## 如何生成最新进度报告
+
+我们提供了自动化脚本来生成项目进度报告：
+
+```powershell
+# 默认生成报告（存放在 docs/reports 目录）
+.\Update-ProjectDocs.ps1
+
+# 指定报告输出目录
+.\Update-ProjectDocs.ps1 -ReportPath ".\custom\path"
+
+# 同时清理空文件
+.\Update-ProjectDocs.ps1 -CleanEmptyFiles
+```
+
+这将生成以下报告文件：
+- `docs/reports/story-progress-report.md` - 默认进度报告
+- `docs/reports/story-progress-report.zh-CN.md` - 中文进度报告
+- `docs/reports/story-progress-report.en-US.md` - 英文进度报告
+
+## 项目管理文档
+
+详细的项目管理指南可在以下位置找到：
+- [项目管理指南](./docs/project-management.md)
+- [Story 模板](./docs/story-template.md)
+
+## 如何更新任务状态
+
+1. 在相应的 Story 文档中，将已完成任务的复选框从 `[ ]` 更新为 `[x]`
+2. 更新 Story 文档顶部的状态注释（<!-- 状态：待开始 | 进行中 | 已完成 -->）
+3. 运行进度报告脚本查看最新状态
+
+## GitHub 项目看板
+
+您也可以在我们的 GitHub 仓库查看可视化的项目进度：
+[https://github.com/Agibuild/modulus/projects](https://github.com/Agibuild/modulus/projects)

README.md

@@ -33,4 +33,34 @@ Modulus - Modular Application Template for Cross-Platform Tooling
 
 ```bash
 dotnet new --install Modulus.Templates
-dotnet new modulus-plugin -n MyPlugin
+dotnet new modulus-plugin -n MyPlugin
+```
+
+---
+
+## 📚 文档
+
+完整的项目文档可以在 [docs](./docs/README.md) 目录中找到。文档包括：
+
+- **用户指南**：安装说明、使用说明和故障排除
+- **开发者指南**：插件开发、系统架构和 API 参考
+- **用户故事**：产品开发路线图和功能演进
+
+文档提供多种语言版本：
+- [English Documentation](./docs/en-US/README.md)
+- [中文文档](./docs/zh-CN/README.md)
+
+---
+
+## 📊 项目状态
+
+查看当前项目进度与状态请参阅 [README-Project-Status.md](./README-Project-Status.md)。
+
+我们使用标准化的用户故事文档，所有 Story 文件遵循以下命名规则：
+- 文件格式：`S-XXXX-标题.md`
+- 文档标题：`# S-XXXX-标题`
+- 必要元数据：包含优先级和状态标记
+
+通过运行 `.\Generate-StoryProgress.ps1` 可生成最新的项目进度报告。
+
+---

Update-ProjectDocs.ps1

@@ -0,0 +1,121 @@
+# 项目进度状态生成脚本
+# 该脚本扫描 docs 目录下的 story 文档，生成项目进度报告
+
+param (
+    [string]$ChineseReportPath = ".\docs\reports\story-progress-report.zh-CN.md",
+    [string]$EnglishReportPath = ".\docs\reports\story-progress-report.en-US.md"
+)
+
+function Get-StoryFiles {
+    param([string]$Lang)
+    if ($Lang -eq "zh-CN") {
+        $dir = ".\docs\zh-CN\stories"
+    } else {
+        $dir = ".\docs\en-US\stories"
+    }
+    $storyFiles = @()
+    if (Test-Path $dir) {
+        $storyFiles += Get-ChildItem -Path $dir -Filter "*.md"
+    }
+    return $storyFiles
+}
+
+function Get-StoryStatus {
+    param([string]$Content)
+    $total = ([regex]::Matches($Content, '- \[[ xX]\]')).Count
+    $done = ([regex]::Matches($Content, '- \[[xX]\]')).Count
+    return @{ Total = $total; Done = $done }
+}
+
+function Get-StoryId {
+    param([string]$FileName)
+    $match = [regex]::Match($FileName, 'S-(\d+)-')
+    if ($match.Success) { return [int]$match.Groups[1].Value }
+    return 9999
+}
+
+function Get-ProjectReport {
+    param(
+        [string]$Lang # zh-CN or en-US
+    )
+    $storyFiles = Get-StoryFiles -Lang $Lang | Sort-Object { Get-StoryId $_.Name }
+    $totalTasks = 0
+    $completedTasks = 0
+    $storyRows = @()
+
+    foreach ($file in $storyFiles) {
+        $content = Get-Content -Path $file.FullName -Raw
+        $status = Get-StoryStatus -Content $content
+        $totalTasks += $status.Total
+        $completedTasks += $status.Done
+        $display = if ($status.Total -eq 0) { "N/A" } else { "$($status.Done)/$($status.Total)" }
+        $storyRows += "| $($file.BaseName) | $display |"
+    }
+
+    $completionRate = if ($totalTasks -gt 0) { [math]::Round($completedTasks * 100.0 / $totalTasks) } else { 0 }
+
+    if ($Lang -eq "zh-CN") {
+        $report = @"
+# Modulus 项目进度报告
+
+生成时间: $(Get-Date -Format "yyyy-MM-dd HH:mm:ss")
+## 总体进度
+
+- 总任务数: $totalTasks
+- 已完成任务: $completedTasks
+- 完成率: $completionRate%
+
+## 各 Story 进度
+
+| Story | 完成/总计 |
+|-------|-----------|
+$($storyRows -join "`n")
+"@
+    } else {
+        $report = @"
+# Modulus Project Progress Report
+
+Generated at: $(Get-Date -Format "yyyy-MM-dd HH:mm:ss")
+## Overall Progress
+
+- Total tasks: $totalTasks
+- Completed tasks: $completedTasks
+- Completion rate: $completionRate%
+
+## Story Progress
+
+| Story | Completed/Total |
+|-------|-----------------|
+$($storyRows -join "`n")
+"@
+    }
+    return $report
+}
+
+# 清理无用的报告文件（只保留本次生成的两个）
+$reportDir = Split-Path $ChineseReportPath -Parent
+$allReports = Get-ChildItem -Path $reportDir -Filter "story-progress-report*.md" -ErrorAction SilentlyContinue
+foreach ($f in $allReports) {
+    if ($f.FullName -ne (Resolve-Path $ChineseReportPath) -and $f.FullName -ne (Resolve-Path $EnglishReportPath)) {
+        Remove-Item $f.FullName -Force
+    }
+}
+
+# 主执行流程
+Write-Host "开始生成中英文项目进度报告..." -ForegroundColor Cyan
+
+# 生成中文报告
+$zhReport = Get-ProjectReport -Lang "zh-CN"
+$zhDir = Split-Path $ChineseReportPath -Parent
+if (-not (Test-Path $zhDir)) { New-Item -Path $zhDir -ItemType Directory -Force | Out-Null }
+$zhReport | Out-File -FilePath $ChineseReportPath -Encoding UTF8
+Write-Host "中文报告已生成: $ChineseReportPath" -ForegroundColor Green
+
+# 生成英文报告
+$enReport = Get-ProjectReport -Lang "en-US"
+$enDir = Split-Path $EnglishReportPath -Parent
+if (-not (Test-Path $enDir)) { New-Item -Path $enDir -ItemType Directory -Force | Out-Null }
+$enReport | Out-File -FilePath $EnglishReportPath -Encoding UTF8
+Write-Host "English report generated: $EnglishReportPath" -ForegroundColor Green
+
+Write-Host "\n✅ 项目进度报告已更新！" -ForegroundColor Green