@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md

@@ -0,0 +1,217 @@
+# ArkTS 编译错误修复示例
+
+> 本文档按 P0/P1/P2 优先级分类，提供各类编译错误的修复代码示例。
+> 供 SKILL.md 第三层"自动诊断与修复"参考。
+
+---
+
+## P0：必须修复（阻止编译）
+
+### P0-1：类型错误
+
+**错误**：`Type 'number' is not assignable to type 'string'.`
+
+```typescript
+// ❌ 错误
+let value: string = 123;
+
+// ✅ 修复
+let value: string = "123";
+```
+
+### P0-2：导入错误（不存在的导出名）
+
+**错误**：`Module '"./xxx"' has no exported member 'NonExistentClass'.`
+
+```typescript
+// ❌ 错误
+import { NonExistentClass } from './xxx';
+
+// ✅ 修复 — 查看实际导出名
+import { CorrectClassName } from './xxx';
+```
+
+### P0-3：括号不匹配
+
+**错误**：`')' expected.` 或 `Unexpected token.`
+
+```typescript
+// ❌ 错误 — 缺少右括号
+function test() {
+  return doSomething(;
+}
+
+// ✅ 修复
+function test() {
+  return doSomething();
+}
+```
+
+### P0-4：interface 不能 new
+
+**错误**：`arkts-no-interface-inst  (6133)`
+
+```typescript
+// ❌ 错误 — interface 不能实例化
+interface Config { name: string; }
+const config = new Config();  // Error
+
+// ✅ 修复 — 用对象字面量
+const config: Config = { name: "test" };
+
+// ✅ 或用 class + implements
+class ConfigImpl implements Config { name: string = "test"; }
+const config = new ConfigImpl();
+```
+
+### P0-5：static 方法通过实例调用
+
+**错误**：`Property 'staticMethod' is a static member of type 'ClassName'.`
+
+```typescript
+class MathUtil {
+  static add(a: number, b: number) { return a + b; }
+}
+
+// ❌ 错误 — 通过实例调用 static
+const math = new MathUtil();
+math.add(1, 2);
+
+// ✅ 修复 — 用类名调用
+MathUtil.add(1, 2);
+```
+
+### P0-6：catch(e) { throw e } 违反 arkts-limited-throw
+
+**错误**：`arkts-limited-throw`
+
+```typescript
+// ❌ 错误 — 不能在 catch 中直接 throw
+try {
+  doSomething();
+} catch (e) {
+  throw e;  // Error: arkts-limited-throw
+}
+
+// ✅ 修复 — 用布尔标记模式
+let success = false;
+try {
+  doSomething();
+  success = true;
+} catch (e) {
+  // 记录错误，不直接 throw
+}
+if (!success) {
+  // 通过返回值或标志位处理
+}
+```
+
+---
+
+## P0：源库 ArkTS 规范问题（不修复）
+
+> ⚠️ 以下错误来自源库代码，**不修复**，报告中标注"源库 ArkTS 规范问题"。
+
+### P0-S1：arkts-no-any
+
+**错误**：`arkts-no-any  (6133)`
+
+```typescript
+// 源库代码（不修改）
+function process(data: any) { ... }  // ArkTS 不允许 any
+```
+
+**处理**：标注"源库 ArkTS 规范问题，不修复"，继续构建。
+
+### P0-S2：arkts-no-dynamic-property
+
+**错误**：`arkts-no-dynamic-property`
+
+```typescript
+// 源库代码（不修改）
+const obj: Record<string, Object> = {};
+obj.dynamicProp = 123;  // ArkTS 不允许动态属性
+```
+
+**处理**：标注"源库 ArkTS 规范问题，不修复"，继续构建。
+
+---
+
+## P1：建议修复（废弃 API 迁移）
+
+> ⚠️ 仅迁移**测试代码**中的废弃 API，源库代码不迁移。
+
+### P1-1：@ohos.fileio → @ohos.file.fs
+
+**错误**：`'@ohos.fileio' is deprecated. Use '@ohos.file.fs' instead.  (6387)`
+
+```typescript
+// ❌ 废弃
+import fileio from '@ohos.fileio';
+const fd = fileio.openSync(path, 0, 0o666);
+const data = fileio.readSync(fd.buffer);
+
+// ✅ 迁移 — 参数需调整（fs.open 返回 FILE，非 fd）
+import fs from '@ohos.file.fs';
+const file = fs.openSync(path, fs.OpenMode.READ_WRITE);
+const data = new ArrayBuffer(1024);
+fs.readSync(file.fd, data);
+fs.closeSync(file);
+```
+
+### P1-2：AbilityContext → UIAbilityContext
+
+**错误**：`'AbilityContext' is deprecated. Use 'UIAbilityContext' instead.  (6387)`
+
+```typescript
+// ❌ 废弃
+import { AbilityContext } from '@ohos.abilityBase';
+
+// ✅ 迁移
+import { UIAbilityContext } from '@ohos.app.ability.UIAbility';
+```
+
+---
+
+## P2：可选优化（不阻塞编译）
+
+### P2-1：未使用变量（删除或加 `_` 前缀）
+
+**错误**：`'unusedVar' is declared but never used.  (6133)`
+
+```typescript
+// ❌ 未使用
+const unusedVar = 123;
+
+// ✅ 修复 — 删除，或加下划线前缀
+const _unusedVar = 123;  // 前缀 _ 表示有意未使用
+```
+
+### P2-2：异步函数缺异常处理
+
+**错误**：`Add try-catch to the async function.  (addAsyncCatch)`
+
+```typescript
+// ❌ 缺异常处理
+async function fetchData() {
+  const res = await fetch(url);
+  return res.json();
+}
+
+// ✅ 修复 — 添加 try-catch + 布尔标记
+async function fetchData(): Promise<boolean> {
+  try {
+    const res = await fetch(url);
+    const data = await res.json();
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+```
+
+### P2-3：权限警告
+
+**错误**：`Permission warning.  (28007)`
+
+**处理**：权限警告不阻塞编译，报告中标注即可。

package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1

@@ -0,0 +1,93 @@
+<#
+.SYNOPSIS
+    Run devecocli build with timeout and daemon cleanup.
+.DESCRIPTION
+    Use .NET Process class to avoid PS 5.1 Start-Process limitations.
+    Redirect via cmd.exe built-in redirection (> file 2>&1), daemon inherits
+    FILE handles from cmd.exe (not pipe handles), WaitForExit only waits cmd.exe.
+    On timeout or build failure, force-kills the process tree and sweeps
+    residual hvigor node/java daemons so pipes are released.
+#>
+param([string]$Cmd, [switch]$JavaHome)
+
+$DevEco = "D:\software\ide\DevEco Studio"  # fallback
+try {
+    $hdcPath = (cmd /c "where.exe hdc 2>nul" 2>&1) -split "`r`n" | Select-Object -First 1
+    if ($hdcPath) {
+        $hdcPath = $hdcPath.Trim()
+        $idx = $hdcPath.IndexOf('\sdk')
+        if ($idx -gt 0) { $DevEco = $hdcPath.Substring(0, $idx) }
+    }
+} catch {}
+
+# Auto-set JAVA_HOME for test HAP builds
+if ($JavaHome) {
+    $Cmd = "set JAVA_HOME=$DevEco\jbr && set PATH=%JAVA_HOME%\bin;%PATH% && $Cmd"
+}
+
+$TimeoutMs = 300000
+$ErrorActionPreference = "Continue"
+
+Write-Host "[build.ps1] DevEco:  $DevEco"
+Write-Host "[build.ps1] Cmd:     $Cmd"
+Write-Host "[build.ps1] Timeout: $($TimeoutMs/1000)s"
+
+# Write command to temp .cmd file
+$guid = [System.Guid]::NewGuid().ToString("N")
+$cmdFile = "$env:TEMP\devecocli_cmd_$guid.cmd"
+$logFile = "$env:TEMP\devecocli_log_$guid.log"
+Set-Content -Path $cmdFile -Value "@echo off`r`n$Cmd > `"$logFile`" 2>&1"
+
+# Use .NET Process class (avoids PS 5.1 Start-Process -NoNewWindow + Redirect conflict)
+$psi = New-Object System.Diagnostics.ProcessStartInfo
+$psi.FileName = "cmd.exe"
+$psi.Arguments = "/c `"$cmdFile`""
+$psi.UseShellExecute = $false
+$psi.CreateNoWindow = $true
+# Don't set RedirectStandardOutput/RedirectStandardError - cmd.exe handles redirection internally
+$proc = [System.Diagnostics.Process]::Start($psi)
+
+# Wait for cmd.exe only (daemon stays alive with FILE handles, not pipe handles)
+$finished = $proc.WaitForExit($TimeoutMs)
+
+if (-not $finished) {
+    Write-Host "[build.ps1] TIMEOUT after $($TimeoutMs/1000)s"
+    $proc.Kill()
+    taskkill /PID $proc.Id /T /F 2>$null | Out-Null
+    $exitCode = 1
+} else {
+    $exitCode = $proc.ExitCode
+}
+
+# Output build results from file
+if (Test-Path $logFile) {
+    Get-Content $logFile
+}
+Write-Host ""
+
+# Daemon cleanup (prevents session blocking via inherited handles)
+Write-Host "[build.ps1] Stopping daemon..."
+& "$DevEco\tools\node\node.exe" "$DevEco\tools\hvigor\bin\hvigorw.js" --stop-daemon *>$null
+
+# Residual daemon force-kill fallback on failure (success path keeps graceful stop only)
+if ($exitCode -ne 0) {
+    Write-Host "[build.ps1] Build failed - sweeping residual hvigor daemons..."
+    $residual = Get-CimInstance Win32_Process -ErrorAction SilentlyContinue |
+        Where-Object {
+            ($_.Name -eq 'node.exe' -or $_.Name -eq 'java.exe') -and
+            $_.CommandLine -and
+            $_.CommandLine -match 'hvigor' -and
+            $_.CommandLine -match [regex]::Escape($DevEco) -and
+            $_.CommandLine -notmatch '--stop-daemon'
+        }
+    foreach ($p in $residual) {
+        Write-Host "[build.ps1] Force-kill residual daemon PID $($p.ProcessId)"
+        taskkill /PID $p.ProcessId /T /F 2>$null | Out-Null
+    }
+}
+
+# Cleanup temp files
+Remove-Item $logFile, $cmdFile -Force -ErrorAction SilentlyContinue
+
+Write-Host "[build.ps1] DONE exit=$exitCode"
+[Environment]::Exit($exitCode)