@ohos-cpf/3rdloop 0.0.2 → 0.0.4

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

@@ -1,217 +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)`
-
-**处理**：权限警告不阻塞编译，报告中标注即可。
+# 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

@@ -1,93 +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)
+<#
+.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)