svharness 0.15.11 → 0.15.13

package/templates/codechat/Start-CodeChat.ps1

@@ -1,18 +1,17 @@
-# Standalone CodeChat launcher (no Node / svharness required).
-# UTF-8 BOM required for PS 5.1 when menu labels contain non-ASCII.
-# Compatible with both `irm | iex` and `-File` invocation (no param() block).
+# Standalone CodeChat launcher.
+# UTF-8 BOM is added by Install-CodeChatContextMenu for PS 5.1 -File mode.
+# Compatible with both irm|iex and -File invocation.
 # Suppress Set-ExecutionPolicy errors when Group Policy overrides (common on enterprise machines).
 try { Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force -ErrorAction Stop | Out-Null } catch {}
 # Ensure console output uses UTF-8 so Chinese labels print correctly
 try { chcp 65001 | Out-Null } catch {}
 [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
 $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
-$Action='Install'; $WorkDir=(Get-Location).Path; $NoSyncEnv=$NoSkipPermissions=$false; $ExtraArgs=@()
+$Action='Install'; $WorkDir=(Get-Location).Path; $NoSkipPermissions=$false; $ExtraArgs=@()
 for($__i=0;$__i -lt $args.Count;$__i++){
   switch -Regex ($args[$__i]){
     '^-Action$' { $Action=$args[++$__i] }
     '^-WorkDir$' { $WorkDir=$args[++$__i] }
-    '^-NoSyncEnv$' { $NoSyncEnv=$true }
     '^-NoSkipPermissions$' { $NoSkipPermissions=$true }
     default { $ExtraArgs += $args[$__i] }
   }
@@ -21,14 +20,12 @@ Remove-Variable __i
 
 # The URL this script was downloaded from (used when re-downloading in iex mode)
 $script:DownloadUrl = 'https://v-hub.desaysz.site/Start-CodeChat.ps1'
+$script:IconDownloadUrl = 'https://v-hub.desaysz.site/codechat-agent.ico'
 
 $ErrorActionPreference = 'Stop'
 
-$script:MenuLabel = if ([System.Globalization.CultureInfo]::CurrentUICulture.Name -like 'zh-*') {
-  '在此启动 CodeChat CLI'
-} else {
-  'Launch CodeChat CLI here'
-}
+# ASCII-only label avoids mojibake in Explorer context menu (registry encoding).
+$script:MenuLabel = 'Launch CodeChat CLI here'
 $script:MenuKeyBg = 'HKCU:\Software\Classes\Directory\Background\shell\CodeChatStandaloneAgent'
 $script:MenuKeyDir = 'HKCU:\Software\Classes\Directory\shell\CodeChatStandaloneAgent'
 $script:SvharnessMenuKeyBg = 'HKCU:\Software\Classes\Directory\Background\shell\SvharnessLaunchCodeChatAgent'
@@ -176,127 +173,138 @@ function Find-CodeChatRunner {
   }
 }
 
-function Parse-EnvFile {
-  param([string]$Path)
-  $result = @{}
-  if (-not (Test-Path -LiteralPath $Path)) { return $result }
-  Get-Content -LiteralPath $Path -Encoding UTF8 | ForEach-Object {
-    $line = $_.Trim()
-    if ($line -eq '' -or $line.StartsWith('#')) { return }
-    $eq = $line.IndexOf('=')
-    if ($eq -le 0) { return }
-    $key = $line.Substring(0, $eq).Trim()
-    if (-not $key) { return }
-    $val = $line.Substring($eq + 1).Trim()
-    # Strip surrounding quotes
-    $wasQuoted = $false
-    if ($val.Length -ge 2) {
-      $fc = $val[0]; $lc = $val[-1]
-      if (($fc -eq '"' -and $lc -eq '"') -or ($fc -eq "'" -and $lc -eq "'")) {
-        $val = $val.Substring(1, $val.Length - 2)
-        $wasQuoted = $true
-      }
-    }
-    # Strip inline comment (# outside quotes only)
-    if (-not $wasQuoted) {
-      $hashIdx = $val.IndexOf('#')
-      if ($hashIdx -ge 0) {
-        $val = $val.Substring(0, $hashIdx).TrimEnd()
-      }
-    }
-    $result[$key] = $val
+function Initialize-ConsoleUtf8 {
+  try { chcp 65001 | Out-Null } catch {}
+  [Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
+  [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+  $script:OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+}
+
+function Get-ExtraArgsFromJsonFragment {
+  param([string]$Fragment)
+  if ([string]::IsNullOrWhiteSpace($Fragment)) { return @() }
+  if ($Fragment -match '^\[\s*(.*)\s*\]$') {
+    $inner = $Matches[1]
+    if ([string]::IsNullOrWhiteSpace($inner)) { return @() }
+    return @([regex]::Matches($inner, '"((?:\\.|[^"\\])*)"') | ForEach-Object { $_.Groups[1].Value })
+  }
+  if ($Fragment -match '^"\s*([^"]*)\s*"$') {
+    return @($Matches[1].Trim() -split '\s+' | Where-Object { $_ })
   }
-  return $result
+  return @()
 }
 
-function Merge-EnvToSettingsJson {
+function Format-ExtraArgsJsonArray {
+  param([string[]]$ArgValues)
+  if (-not $ArgValues -or $ArgValues.Count -eq 0) { return '[]' }
+  $escaped = ($ArgValues | ForEach-Object {
+    '"{0}"' -f ([string]$_ -replace '\\', '\\' -replace '"', '\"')
+  }) -join ', '
+  return "[$escaped]"
+}
+
+function Update-SectionExtraArgsInConfigJson {
   param(
-    [string]$SettingsPath,
-    [hashtable]$EnvPairs
+    [string]$JsonText,
+    [string]$SectionName,
+    [string[]]$RemoveArgs = @('-c'),
+    [string[]]$EnsureArgs = @('--dangerously-skip-permissions'),
+    [switch]$SkipEnsure
   )
-  # Read or init settings
-  $settings = @{}
-  if (Test-Path -LiteralPath $SettingsPath) {
-    try {
-      $raw = Get-Content -LiteralPath $SettingsPath -Raw -Encoding UTF8
-      if ($raw) {
-        # Convert PSObject to hashtable (PS5.1 compat — no -AsHashtable)
-        $parsed = $raw | ConvertFrom-Json
-        $settings = @{}
-        $parsed.PSObject.Properties | ForEach-Object { $settings[$_.Name] = $_.Value }
-      }
-    } catch {
-      $settings = @{}
+  if ([string]::IsNullOrWhiteSpace($JsonText)) { return $JsonText }
+
+  $pattern = "(`"$SectionName`"\s*:\s*\{[\s\S]*?`"extra_args`"\s*:\s*)(\[[^\]]*\]|`"[^`"]*`"|\{\s*\})"
+  $match = [regex]::Match($JsonText, $pattern)
+  if (-not $match.Success) { return $JsonText }
+
+  $current = Get-ExtraArgsFromJsonFragment -Fragment $match.Groups[2].Value
+  $next = @($current | Where-Object { $_ -and ($_ -notin $RemoveArgs) })
+  if ($SkipEnsure) {
+    $next = @($next | Where-Object { $_ -notin $EnsureArgs })
+  } else {
+    foreach ($arg in $EnsureArgs) {
+      if ($arg -and ($arg -notin $next)) { $next += $arg }
     }
   }
-  $settings['env'] = $EnvPairs
-  $dir = Split-Path -Parent $SettingsPath
-  if (-not (Test-Path -LiteralPath $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }
-  $json = $settings | ConvertTo-Json -Depth 10
-  Write-Utf8NoBom -Path $SettingsPath -Value $json
+
+  $newFragment = Format-ExtraArgsJsonArray -ArgValues $next
+  $currentFragment = $match.Groups[2].Value
+  $isArrayFragment = $currentFragment -match '^\[\s*'
+  if ($isArrayFragment -and ($currentFragment -eq $newFragment)) { return $JsonText }
+
+  $headLen = $match.Groups[1].Index + $match.Groups[1].Length
+  $tailStart = $match.Groups[2].Index + $match.Groups[2].Length
+  return $JsonText.Substring(0, $headLen) + $newFragment + $JsonText.Substring($tailStart)
 }
 
-function Sync-ProjectEnv {
-  param(
-    [string]$ProjectRoot,
-    [switch]$SkipSync
-  )
-  $projectEnv = Join-Path $ProjectRoot '.claude\.env'
-  $userClaudeEnv = Join-Path $HOME '.claude\.env'
-  $userCodechatEnv = Join-Path $HOME '.codechat\.env'
-  $settingsPath = Join-Path $HOME '.claude\settings.json'
-
-  if (-not $SkipSync -and (Test-Path -LiteralPath $projectEnv)) {
-    # New: Merge project .env content into ~/.claude/settings.json["env"]
-    $envPairs = Parse-EnvFile -Path $projectEnv
-    if ($envPairs.Count -gt 0) {
-      Merge-EnvToSettingsJson -SettingsPath $settingsPath -EnvPairs $envPairs
-      Write-Host "[info] merged project env -> $settingsPath (${envPairs.Count} vars)"
-    }
-    # Backward compat: also sync .env file for --env-file argument
-    $resolvedProject = (Resolve-Path -LiteralPath $projectEnv).Path
-    $resolvedUser    = if (Test-Path -LiteralPath $userClaudeEnv) { (Resolve-Path -LiteralPath $userClaudeEnv).Path } else { $null }
-    if ($resolvedProject -ne $resolvedUser) {
-      $userDir = Split-Path -Parent $userClaudeEnv
-      if (-not (Test-Path -LiteralPath $userDir)) {
-        New-Item -ItemType Directory -Force -Path $userDir | Out-Null
+function Repair-CodeChatBootstrapConfigLib {
+  # bootstrap Config.ps1 unwraps single-element JSON arrays to strings on load, and
+  # ConvertTo-Json may write extra_args as strings — patch once in the local CLI install.
+  $configPs1 = Join-Path $env:USERPROFILE '.codechat\cli_app\win\lib\Config.ps1'
+  if (-not (Test-Path -LiteralPath $configPs1)) { return }
+
+  try {
+    $content = Get-Content -LiteralPath $configPs1 -Raw -Encoding UTF8
+    if (-not $content) { return }
+
+    $marker = 'Start-CodeChat: preserve single-element arrays'
+    if ($content -notmatch [regex]::Escape($marker)) {
+      $needle = "        return `$list"
+      $replacement = "        return ,@(`$list)  # $marker"
+      if ($content.Contains($needle)) {
+        $content = $content.Replace($needle, $replacement)
+        Write-Utf8NoBom -Path $configPs1 -Value $content
       }
-      Copy-Item -LiteralPath $projectEnv -Destination $userClaudeEnv -Force
     }
-    return $userClaudeEnv
+  } catch {
+    # Never block startup for bootstrap patch
   }
+}
 
-  if (Test-Path -LiteralPath $userClaudeEnv) {
-    return $userClaudeEnv
-  }
+function Ensure-BootstrapExtraArgs {
+  # Surgical edit only: strip legacy "-c" from extra_args; keep all other config fields/args.
+  param(
+    [switch]$SkipPermissions
+  )
 
-  # Fallback: ~/.codechat/.env (from old codechat.ps1)
-  if (Test-Path -LiteralPath $userCodechatEnv) {
-    return $userCodechatEnv
-  }
+  Repair-CodeChatBootstrapConfigLib
 
-  Write-Host "[warn] No .env file found. Create one at $projectEnv or $userClaudeEnv"
-  return ''
-}
+  $configPath = Join-Path $env:USERPROFILE '.codechat\bootstrap\config.json'
+  $ensureArgs = @('--dangerously-skip-permissions')
 
-function Initialize-ConsoleUtf8 {
-  try { chcp 65001 | Out-Null } catch {}
-  [Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
-  [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
-  $script:OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+  if (-not (Test-Path -LiteralPath $configPath)) { return }
+
+  try {
+    $raw = Get-Content -LiteralPath $configPath -Raw -Encoding UTF8
+    if (-not $raw) { return }
+
+    $updated = $raw
+    foreach ($sectionName in @('claudecode', 'codechat')) {
+      $updated = Update-SectionExtraArgsInConfigJson `
+        -JsonText $updated `
+        -SectionName $sectionName `
+        -RemoveArgs @('-c') `
+        -EnsureArgs $ensureArgs `
+        -SkipEnsure:$SkipPermissions
+    }
+
+    if ($updated -ne $raw) {
+      Write-Utf8NoBom -Path $configPath -Value $updated
+    }
+  } catch {
+    # Silently ignore — never block startup for config tweaks
+  }
 }
 
 function Invoke-CodeChatStart {
   param(
     [string]$TargetWorkDir,
-    [switch]$SkipEnvSync,
     [switch]$SkipPermissions
   )
 
   Initialize-ConsoleUtf8
 
   $resolvedWorkDir = (Resolve-Path -LiteralPath $TargetWorkDir).Path
-  $envFile = Sync-ProjectEnv -ProjectRoot $resolvedWorkDir -SkipSync:$SkipEnvSync
   $resolved = Find-CodeChatRunner
 
   $sourceLog = $resolved.Source
@@ -306,26 +314,25 @@ function Invoke-CodeChatStart {
 
   Write-Host "CodeChat CLI: $($resolved.Runner) ($sourceLog)"
   Write-Host "workdir: $resolvedWorkDir"
-  if ($envFile) {
-    Write-Host "env: $envFile"
-  }
 
-  $args = @(
-    "--cwd=`"$resolvedWorkDir`""
-  )
-  if ($envFile) {
-    $args += "--env-file=`"$envFile`""
-  }
-  if (-not $SkipPermissions) {
-    $args += '--dangerously-skip-permissions'
-  }
-  # Append extra args forwarded from alias (e.g., -c for config path)
+  # Sync bootstrap extra_args for both codechat + claudecode before launch
+  Ensure-BootstrapExtraArgs -SkipPermissions:$SkipPermissions
+
+  # run.bat → bootstrap.ps1 only accepts -cwd <path> (two args).
+  # --cwd="path" is silently dropped when invoked via cmd.exe %*.
+  $args = @('-cwd', $resolvedWorkDir)
+  # Append extra args forwarded from alias
   if ($ExtraArgs -and $ExtraArgs.Count -gt 0) {
     $args += $ExtraArgs
   }
 
   & $resolved.Runner @args
-  exit $LASTEXITCODE
+  $exitCode = $LASTEXITCODE
+
+  # bootstrap Update-CliPreference may rewrite extra_args; repair after CLI exits.
+  Ensure-BootstrapExtraArgs -SkipPermissions:$SkipPermissions
+
+  exit $exitCode
 }
 
 function Get-WtExecutable {
@@ -345,6 +352,9 @@ function Get-WtExecutable {
 
 function Copy-OptionalIcon {
   param([string]$SourceScriptPath)
+  if (Test-Path -LiteralPath $script:InstalledIcon) {
+    return $true
+  }
   $candidates = @(
     (Join-Path (Split-Path -Parent $SourceScriptPath) 'codechat-agent.ico'),
     (Join-Path (Split-Path -Parent $SourceScriptPath) '..\assets\codechat-agent.ico'),
@@ -353,13 +363,41 @@ function Copy-OptionalIcon {
   foreach ($icon in $candidates) {
     try {
       $resolved = Resolve-Path -LiteralPath $icon -ErrorAction Stop
-      Copy-Item -LiteralPath $resolved.Path -Destination $script:InstalledIcon -Force
+      Copy-Item -LiteralPath $resolved.Path -Destination $script:InstalledIcon -Force -ErrorAction Stop
       return $true
     } catch {}
   }
   return $false
 }
 
+function Download-MenuIcon {
+  if (Test-Path -LiteralPath $script:InstalledIcon) {
+    return $true
+  }
+  if (-not $script:IconDownloadUrl) {
+    return $false
+  }
+  try {
+    Invoke-WebRequest -Uri $script:IconDownloadUrl -OutFile $script:InstalledIcon -ErrorAction Stop
+    return (Test-Path -LiteralPath $script:InstalledIcon)
+  } catch {
+    try {
+      (New-Object System.Net.WebClient).DownloadFile($script:IconDownloadUrl, $script:InstalledIcon)
+      return (Test-Path -LiteralPath $script:InstalledIcon)
+    } catch {
+      return $false
+    }
+  }
+}
+
+function Ensure-MenuIcon {
+  param([string]$SourceScriptPath)
+  if (Copy-OptionalIcon -SourceScriptPath $SourceScriptPath) {
+    return $true
+  }
+  return (Download-MenuIcon)
+}
+
 function Register-ExplorerMenu {
   param(
     [string]$MenuKey,
@@ -369,7 +407,8 @@ function Register-ExplorerMenu {
   New-Item -Path $MenuKey -Force | Out-Null
   Set-ItemProperty -Path $MenuKey -Name '(default)' -Value $script:MenuLabel
   if ($IconPath -and (Test-Path -LiteralPath $IconPath)) {
-    Set-ItemProperty -Path $MenuKey -Name 'Icon' -Value "$IconPath,0"
+    $iconValue = "$((Resolve-Path -LiteralPath $IconPath).Path),0"
+    Set-ItemProperty -Path $MenuKey -Name 'Icon' -Value $iconValue
   }
   New-Item -Path "$MenuKey\command" -Force | Out-Null
   Set-ItemProperty -Path "$MenuKey\command" -Name '(default)' -Value $Command
@@ -415,7 +454,12 @@ function Install-CodeChatContextMenu {
     $null = New-Item -ItemType Directory -Force -Path $script:StandaloneDir
     Copy-Item -LiteralPath $sourceScript -Destination $script:InstalledScript -Force
   }
-  $hasIcon = Copy-OptionalIcon -SourceScriptPath $sourceScript
+  # Re-add UTF-8 BOM for PS 5.1 -File mode (required for Chinese chars in menu labels)
+  $utf8Bom = New-Object System.Text.UTF8Encoding($true)
+  $savedContent = Get-Content -LiteralPath $script:InstalledScript -Raw -Encoding UTF8
+  [System.IO.File]::WriteAllText($script:InstalledScript, $savedContent, $utf8Bom)
+
+  $hasIcon = Ensure-MenuIcon -SourceScriptPath $sourceScript
 
   $psArgs = "-NoExit -NoProfile -ExecutionPolicy Bypass -File `"$($script:InstalledScript)`" -Action Start -WorkDir"
   $wt = Get-WtExecutable
@@ -434,6 +478,11 @@ function Install-CodeChatContextMenu {
 
   Write-Host "[ok]   Context menu registered: $($script:MenuLabel)"
   Write-Host "[info] script: $($script:InstalledScript)"
+  if ($hasIcon) {
+    Write-Host "[info] icon:   $($script:InstalledIcon)"
+  } else {
+    Write-Host "[warn] icon not found; menu will have no icon"
+  }
   if ($wt) {
     Write-Host "[info] terminal: Windows Terminal"
   }
@@ -513,16 +562,6 @@ function Install-CodeChatAlias {
         Write-Utf8NoBom -Path $PROFILE -Value $joined
     }
 
-    # First-run bootstrap: copy ~/.codechat/.env → <cwd>/.claude/.env
-    $claudeDir = Join-Path (Get-Location).Path '.claude'
-    $claudeEnv = Join-Path $claudeDir '.env'
-    $homeEnv   = Join-Path $HOME '.codechat\.env'
-    if (-not (Test-Path $claudeEnv) -and (Test-Path $homeEnv)) {
-        if (-not (Test-Path $claudeDir)) { New-Item -ItemType Directory -Path $claudeDir -Force | Out-Null }
-        Copy-Item -Path $homeEnv -Destination $claudeEnv -Force
-        Write-Host "[info] copied $homeEnv -> $claudeEnv"
-    }
-
     # Resolve the installed script path (this script after InstallMenu copies it)
     $aliasTarget = if (Test-Path -LiteralPath $script:InstalledScript) { $script:InstalledScript } else { $PSCommandPath }
 
@@ -546,9 +585,6 @@ function codechat {
     # Load into current session
     try { . $PROFILE } catch {}
     Write-Host "[ok]   Alias 'codechat' installed to $PROFILE"
-    if (-not (Test-Path $claudeEnv) -and -not (Test-Path $homeEnv)) {
-        Write-Host "[warn] No .env found. Open this project in VS Code or Android Studio and run the CodeChat plugin first."
-    }
 }
 
 function Uninstall-CodeChatAlias {
@@ -565,7 +601,7 @@ function Uninstall-CodeChatAlias {
 
 switch ($Action) {
   'Start' {
-    Invoke-CodeChatStart -TargetWorkDir $WorkDir -SkipEnvSync:$NoSyncEnv -SkipPermissions:$NoSkipPermissions
+    Invoke-CodeChatStart -TargetWorkDir $WorkDir -SkipPermissions:$NoSkipPermissions
   }
   'InstallMenu' {
     Install-CodeChatContextMenu
@@ -585,5 +621,10 @@ switch ($Action) {
   'Install' {
     Install-CodeChatContextMenu
     Install-CodeChatAlias
+    Ensure-BootstrapExtraArgs -SkipPermissions:$NoSkipPermissions
+  }
+  'Uninstall' {
+    Uninstall-CodeChatContextMenu
+    Uninstall-CodeChatAlias
   }
 }

package/templates/codechat/bash.exe.stackdump

@@ -0,0 +1,29 @@
+Stack trace:
+Frame         Function      Args
+0007FFFFBF80  00021005FE8E (000210285F68, 00021026AB6E, 000000000000, 0007FFFFAE80) msys-2.0.dll+0x1FE8E
+0007FFFFBF80  0002100467F9 (000000000000, 000000000000, 000000000000, 0007FFFFC258) msys-2.0.dll+0x67F9
+0007FFFFBF80  000210046832 (000210286019, 0007FFFFBE38, 000000000000, 000000000000) msys-2.0.dll+0x6832
+0007FFFFBF80  000210068CF6 (000000000000, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x28CF6
+0007FFFFBF80  000210068E24 (0007FFFFBF90, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x28E24
+0007FFFFC260  00021006A225 (0007FFFFBF90, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x2A225
+End of stack trace
+Loaded modules:
+000100400000 bash.exe
+7FF8D7220000 ntdll.dll
+7FF8D5CA0000 KERNEL32.DLL
+7FF8D4870000 KERNELBASE.dll
+7FF8D5080000 USER32.dll
+7FF8D4F30000 win32u.dll
+000210040000 msys-2.0.dll
+7FF8D6BC0000 GDI32.dll
+7FF8D4E10000 gdi32full.dll
+7FF8D4D70000 msvcp_win.dll
+7FF8D4750000 ucrtbase.dll
+7FF8D5E70000 advapi32.dll
+7FF8D6070000 msvcrt.dll
+7FF8D6DB0000 sechost.dll
+7FF8D5050000 bcrypt.dll
+7FF8D6980000 RPCRT4.dll
+7FF8D3E60000 CRYPTBASE.DLL
+7FF8D4FD0000 bcryptPrimitives.dll
+7FF8D56F0000 IMM32.DLL

package/templates/codechat/docs/project-structure.md

@@ -0,0 +1,59 @@
+# 前端目录（Vue3 + TypeScript + Pinia）
+src/
+├── api/            # API 接口定义层（只写 URL 和 method，每个业务模块一个文件）
+├── mock/
+│   ├── index.js        # 路由映射表 (mockDataMap)，所有 Mock 路由在此注册
+│   ├── interceptor.js  # axios 拦截器（Mock 核心开关）
+│   └── modules/        # Mock 数据实现，与 api/ 一一对应
+├── stores/         # Pinia 状态层（可选，用于跨组件共享数据，内部仍调用 api/）
+├── views/          # 页面
+├── components/     # 公共组件（图表、顶栏、面板等）
+├── router/
+│   └── index.ts    # 路由配置（含权限守卫）
+└── utils/
+    └── request.ts  # axios 封装（含 Mock 拦截接入点）
+
+# 后端目录（SpringBoot DDD 分层，包名以 [基础包名] 为前缀）
+[基础包名]/
+├── application/
+│   ├── adapter/
+│   │   ├── api/                        # REST 入口（XxxAppService）
+│   │   ├── consumer/                   # MQ 消费者
+│   │   └── scheduler/                  # 定时任务（XxxTask）
+│   ├── service/
+│   │   ├── XxxAppService.java          # 应用服务
+│   │   └── process/
+│   │       └── XxxProcess.java         # 编排流程
+│   ├── repository/                     # 仓储接口（IXxxAppRepository）
+│   ├── dto/                            # 请求/响应体（XxxReqDTO / XxxRespDTO）
+│   ├── converter/                      # 转换器（XxxAppConverter）
+│   ├── external/                       # 外部服务接口（IXxxExternalService）
+│   └── error/                          # 错误码（AppErrorEnum）
+├── domain/
+│   └── [聚合根]/
+│       ├── entity/                     # 实体（无后缀）/ 值对象（XxxVO）
+│       ├── event/                      # 领域事件（完成时态，XxxEvent）
+│       ├── repository/                 # 仓储接口（IXxxRepository）
+│       ├── constants/                  # 常量（XxxConstants）
+│       ├── enums/                      # 枚举（XxxEnum）
+│       ├── error/                      # 错误码（XxxErrorEnum）
+│       └── properties/
+├── infrastructure/
+│   └── [聚合根]/
+│       └── repository/
+│           ├── dao/                    # DAO（XxxDao）
+│           ├── cache/                  # 缓存（XxxCache）
+│           ├── storage/                # 对象存储（XxxStorage）
+│           ├── dataObject/             # 持久化对象（XxxDO）
+│           └── converter/              # 转换器（XxxConverter）
+│               └── XxxRepository.java  # 仓储实现（XxxRepository）
+├── external/
+│   └── [外部中心名称]/
+│       ├── dto/                        # 外部 DTO（XxxReqDTO / XxxRespDTO）
+│       ├── converter/                  # 防腐转换（XxxConverter）
+│       ├── feign/                      # Feign 客户端（IXxxFeignClient）
+│       ├── error/                      # 错误码（ExternalErrorEnum）
+│       └── properties/
+│           └── XxxExternalService.java # 外部服务实现
+└── boot/                               # 启动层（包名固定：[基础包名].boot）
+    └── XxxApplication.java             # 启动类

package/templates/svharness.config.example.yaml

@@ -26,6 +26,7 @@ build:
   repomix: false
   enableBaselineExtract: false
   strictInputConfirm: false
+  # convertTimeoutSec: 900  # build 自动 convert 超时（秒），默认 900（15 分钟）
   generateWiki: false
   wikiLang: zh
   force: false
@@ -55,6 +56,7 @@ convert:
     - ./docs/*.pdf
   output: ./my-app-harness
   type: requirements
+  # timeoutSec: 900  # 单文件转换超时（秒），默认 900（15 分钟）
   yes: true
 
 # wiki：对任意代码工程目录生成 baseline wiki（独立于 harness 生命周期）

package/dist/lib/launch-script-path.js

@@ -1,24 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveLaunchScriptPath = resolveLaunchScriptPath;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-/**
- * Resolve absolute path to bin/launch-codechat-cli.js in the installed package.
- */
-function resolveLaunchScriptPath() {
-    // dist/lib/launch-script-path.js → ../../bin/launch-codechat-cli.js
-    const fromDist = path_1.default.resolve(__dirname, '..', '..', 'bin', 'launch-codechat-cli.js');
-    if (fs_extra_1.default.existsSync(fromDist)) {
-        return fromDist;
-    }
-    // fallback: package root from scripts/postinstall.js context
-    const fromCwd = path_1.default.resolve(__dirname, '..', '..', '..', 'bin', 'launch-codechat-cli.js');
-    if (fs_extra_1.default.existsSync(fromCwd)) {
-        return fromCwd;
-    }
-    throw new Error(`未找到 launch-codechat-cli.js（预期：${fromDist}）`);
-}

package/templates/codechat/.claude/.env

@@ -1,59 +0,0 @@
-# ============================================================
-# CodeChat接口
-# ============================================================
-ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InVpZHEzNjQwIiwiZXhwIjoxNzg0MTAzODE1fQ.d8BSD1V2_5Kv-gB8OeS5092Jg6XoL63XR2Tocw5S2bs
-ANTHROPIC_BASE_URL=https://aiplus.desaysv.com/chatbot/anthropic
-# ANTHROPIC_BASE_URL=http://127.0.0.1:6008/chatbot/anthropic  # 德赛本地调试
-ANTHROPIC_MODEL=deepseek  # glm / deepseek
-ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek  # glm / deepseek
-ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek  # glm / deepseek
-API_TIMEOUT_MS=3000000
-
-# ============================================================
-# OpenAI（通过 LiteLLM 代理）
-# 先启动: litellm --config litellm_config.yaml --port 4000
-# ============================================================
-# ANTHROPIC_AUTH_TOKEN=sk-anything
-# ANTHROPIC_BASE_URL=http://localhost:4000
-# ANTHROPIC_MODEL=gpt-4o
-# ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-4o
-# ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-4o
-# ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-4o
-# API_TIMEOUT_MS=3000000
-
-# ============================================================
-# DeepSeek（通过 LiteLLM 代理）
-# 先启动: litellm --config litellm_config.yaml --port 4000
-# ============================================================
-# ANTHROPIC_AUTH_TOKEN=sk-anything
-# ANTHROPIC_BASE_URL=http://localhost:4000
-# ANTHROPIC_MODEL=deepseek-chat
-# ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-chat
-# ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-chat
-# ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-chat
-# API_TIMEOUT_MS=3000000
-
-# ============================================================
-# OpenRouter（直连 Anthropic 兼容接口）
-# ============================================================
-# ANTHROPIC_AUTH_TOKEN=sk-or-v1-xxx
-# ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
-# ANTHROPIC_MODEL=openai/gpt-4o
-# ANTHROPIC_DEFAULT_SONNET_MODEL=openai/gpt-4o
-# ANTHROPIC_DEFAULT_HAIKU_MODEL=openai/gpt-4o-mini
-# ANTHROPIC_DEFAULT_OPUS_MODEL=openai/gpt-4o
-
-# ============================================================
-# 德赛调试专用
-# ============================================================
-CLAUDE_CODE_TRACE_ENABLED=0
-CLAUDE_CODE_TRACE_PIPELINE=0
-CLAUDE_CODE_TRACE_PIPELINE_FILE=
-CLAUDE_CODE_TRACE_WIRE_PARAMS=0
-
-# ============================================================
-# 通用设置（建议始终开启）
-# ============================================================
-DISABLE_TELEMETRY=1
-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
-ENABLE_TOOL_SEARCH=0