105 lines
4.0 KiB
Markdown
105 lines
4.0 KiB
Markdown
|
# 最小验证（Validation）
|
|||
|
|
|
|||
|
|
在本仓库验证：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
pnpm i
|
|||
|
|
pnpm run serve
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
迁移到新仓库后，至少验证：
|
|||
|
|
|
|||
|
|
- 首页可渲染（Layout 正常）
|
|||
|
|
- 路由跳转正常
|
|||
|
|
- Pinia 与 i18n 可注入
|
|||
|
|
- Mock 请求可命中（开发环境）
|
|||
|
|
|
|||
|
|
建议附加：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
pnpm run lint
|
|||
|
|
pnpm run test:unit
|
|||
|
|
pnpm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 文档/清单对账（防止漏登记模块）
|
|||
|
|
|
|||
|
|
对账 `library/components/*` 是否都已登记到 `AI-Coding/openspec-lite/manifest.yaml`：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
$repo = (Get-Location).Path;
|
|||
|
|
$componentDirs = Get-ChildItem -LiteralPath "$repo\library\components" -Directory | Select-Object -ExpandProperty Name | Sort-Object;
|
|||
|
|
$manifest = Get-Content -LiteralPath "$repo\AI-Coding\openspec-lite\manifest.yaml" -Raw;
|
|||
|
|
$manifestComponents = [regex]::Matches($manifest,'library/components/(?<name>Vab[^/]+)/') | ForEach-Object { $_.Groups['name'].Value } | Sort-Object -Unique;
|
|||
|
|
Compare-Object -ReferenceObject $componentDirs -DifferenceObject $manifestComponents
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
对账 `library/layouts/*` 子目录是否都被 `AI-Coding/openspec-lite/modules/layouts.yaml` 覆盖：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
$repo = (Get-Location).Path;
|
|||
|
|
$layoutDirs = Get-ChildItem -LiteralPath "$repo\library\layouts" -Directory | Select-Object -ExpandProperty Name | Sort-Object;
|
|||
|
|
$layoutsSpec = Get-Content -LiteralPath "$repo\AI-Coding\openspec-lite\modules\layouts.yaml" -Raw;
|
|||
|
|
$specDirs = [regex]::Matches($layoutsSpec,'library/layouts/(?<name>VabLayout[^/]+)/') | ForEach-Object { $_.Groups['name'].Value } | Sort-Object -Unique;
|
|||
|
|
Compare-Object -ReferenceObject $layoutDirs -DifferenceObject $specDirs
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
对账 `components.d.ts` 里自动导入的 `Vab*` 组件是否都被任一 module spec 覆盖（按源文件路径精确匹配）：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
$repo = (Get-Location).Path;
|
|||
|
|
$dtsPath = "$repo\library\build\vuePlugins\components.d.ts";
|
|||
|
|
$specDir = "$repo\AI-Coding\openspec-lite\modules";
|
|||
|
|
|
|||
|
|
$dts = Get-Content -LiteralPath $dtsPath -Raw;
|
|||
|
|
$specText = (Get-ChildItem -LiteralPath $specDir -Filter '*.yaml' | ForEach-Object { Get-Content -LiteralPath $_.FullName -Raw }) -join "`n---`n";
|
|||
|
|
|
|||
|
|
$imports = [regex]::Matches(
|
|||
|
|
$dts,
|
|||
|
|
"Vab[A-Za-z0-9_]+:\\s*typeof\\s+import\\('(?<p>[^']+)'\\)\\['default'\\]",
|
|||
|
|
[System.Text.RegularExpressions.RegexOptions]::Multiline
|
|||
|
|
) | ForEach-Object { $_.Groups['p'].Value } | Where-Object { $_ -like '*components*' } | ForEach-Object {
|
|||
|
|
$p = $_;
|
|||
|
|
$p = $p -replace "^\\./\\.\\./\\.\\./","";
|
|||
|
|
$p = $p -replace "^\\./\\.\\./","";
|
|||
|
|
$p = $p -replace "^\\./","";
|
|||
|
|
if ($p -like 'components/*') { $p = "library/" + $p }
|
|||
|
|
$p
|
|||
|
|
} | Sort-Object -Unique;
|
|||
|
|
|
|||
|
|
$missing = foreach ($p in $imports) { if ($specText -notmatch [regex]::Escape($p)) { $p } };
|
|||
|
|
if ($missing) { $missing } else { '(none)' }
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
对账 `src/router/index.ts` 引用的 `@/views/*.vue` 是否都存在，并列出未被路由引用的 views：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
$repo = (Get-Location).Path;
|
|||
|
|
$routerPath = "$repo\src\router\index.ts";
|
|||
|
|
$viewsRoot = "$repo\src\views";
|
|||
|
|
|
|||
|
|
$router = Get-Content -LiteralPath $routerPath -Raw;
|
|||
|
|
# 只提取“非注释行”中的 views 引用，避免把 // 注释的 demo 路由当成缺失文件
|
|||
|
|
$routeViewRefs = [regex]::Matches(
|
|||
|
|
$router,
|
|||
|
|
"(?m)^(?!\\s*//).*@/views/(?<p>[^'\\\"\\)]+\\.vue)",
|
|||
|
|
[System.Text.RegularExpressions.RegexOptions]::Multiline
|
|||
|
|
) | ForEach-Object { $_.Groups['p'].Value } | Sort-Object -Unique;
|
|||
|
|
|
|||
|
|
$missingFiles = foreach ($p in $routeViewRefs) {
|
|||
|
|
$abs = Join-Path $viewsRoot ($p -replace '/', '\\');
|
|||
|
|
if (-not (Test-Path -LiteralPath $abs)) { "src/views/$p" }
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
$allViews = Get-ChildItem -LiteralPath $viewsRoot -Recurse -File -Filter '*.vue' | ForEach-Object {
|
|||
|
|
$_.FullName.Substring($viewsRoot.Length + 1).Replace('\\','/')
|
|||
|
|
} | Sort-Object -Unique;
|
|||
|
|
|
|||
|
|
$unreferenced = Compare-Object -ReferenceObject $allViews -DifferenceObject $routeViewRefs -PassThru | Where-Object { $_ -in $allViews } | Sort-Object;
|
|||
|
|
|
|||
|
|
'--- router references missing files ---';
|
|||
|
|
if ($missingFiles) { $missingFiles } else { '(none)' };
|
|||
|
|
'--- views not referenced by router ---';
|
|||
|
|
if ($unreferenced) { $unreferenced | ForEach-Object { "src/views/$_" } } else { '(none)' };
|
|||
|
|
```
|