docs: TUI 与入口重组的设计记录（4 条 ADR + 验收锚点）
grilling 三轮把设计树走完了，这里把它落成文件，避免决策只活在对话里。 ADR-0010 零依赖自研 TUI：三个候选库全部实测排除 —— ConsoleGuiTools 的 PSGallery 元数据声明最低 7.2（5.1 装不上）；Spectre.Console 0.49.1 能在 5.1 加载但要塞 4 个第三方 DLL 且不支持鼠标；Terminal.Gui 1.15.0 能反射接线到真的渲染出窗口，但 Application.Shutdown() 在两端都抛 NRE。同时记下两条实测坑：无控制台时 $Host.UI.SupportsVirtualTerminal 会撒谎返回 True（第一道闸门必须是 [Console]::IsOutputRedirected），以及 5.1 的 RawUI.LengthInBufferCells 对中文返回 2、对边框字符返回 6（都不能用来排版）。 ADR-0011 进度回调这个例外：它是注入点不是状态，无头路径为 $null 时行为与今天完全一致。 ADR-0012 入口改名与垫片：这次留垫片而 Common.psm1 直接删，是因为前者是外部接口（断了是静默没用）后者是内部实现（断了当场报错）。并纠正了自己的一个伪前提 —— 本机实测没有注册任何 BakNRet 计划任务。 ADR-0013 TUI 写配置：外科式改写 + 校验通过才原子替换。硬事实是 SoftwareCatalog.psd1 根本不能被 Import-PowerShellDataFile 读入（动态表达式），任何"解析成对象再序列化"的方案都会毁掉表达式与注释。 .scratch/tui/spec.md 是这次改造的验收锚点：9 条已定决策 + 三轮的判据 + 风险表。 验收：Parse 两版仍绿。
This commit is contained in:
Shuery committed
1 parent
187549e2af
commit
60f2ae3e0f
25 files changed
+1708
No files matched your search
@@ -0,0 +1,57 @@
|
||||
param([Parameter(Mandatory=$true)][string]$OutFile, [Parameter(Mandatory=$true)][string]$Work, [int]$HoldSeconds = 6)
|
||||
$lines = New-Object System.Collections.Generic.List[string]
|
||||
function L($s) { $lines.Add($s); [System.IO.File]::WriteAllLines($OutFile, $lines, (New-Object System.Text.UTF8Encoding($false))) }
|
||||
function Asm([string]$n) { return [AppDomain]::CurrentDomain.GetAssemblies() | Where-Object { $_.GetName().Name -eq $n } | Select-Object -First 1 }
|
||||
L ("PSVersion: " + $PSVersionTable.PSVersion)
|
||||
try {
|
||||
Add-Type -Path (Join-Path $Work 'nstack111\lib\netstandard2.0\NStack.dll') -ErrorAction Stop
|
||||
Add-Type -Path (Join-Path $Work 'tg115\lib\net472\Terminal.Gui.dll') -ErrorAction Stop
|
||||
$tgAsm = Asm 'Terminal.Gui'
|
||||
$usT = (Asm 'NStack').GetType('NStack.ustring')
|
||||
L (" NStack.ustring type: " + [bool]$usT)
|
||||
$winT = $tgAsm.GetType('Terminal.Gui.Window')
|
||||
L " Window constructors:"
|
||||
foreach ($c in $winT.GetConstructors()) { L (" (" + (($c.GetParameters() | ForEach-Object { $_.ParameterType.Name + ' ' + $_.Name }) -join ', ') + ")") }
|
||||
L " Note: title parameters are NStack.ustring, not System.String -> PowerShell cannot bind a string literal."
|
||||
# convert
|
||||
$implicit = $usT.GetMethod('op_Implicit', [Type[]]@([string]))
|
||||
L (" ustring implicit conversion from string: " + [bool]$implicit)
|
||||
$us = $implicit.Invoke($null, @('BakNRet - Terminal.Gui'))
|
||||
L (" converted title object: " + $us.GetType().FullName)
|
||||
$appT = $tgAsm.GetType('Terminal.Gui.Application')
|
||||
$drvT = $tgAsm.GetType('Terminal.Gui.NetDriver')
|
||||
$mlT = $tgAsm.GetType('Terminal.Gui.IMainLoopDriver')
|
||||
$loopT = $tgAsm.GetType('Terminal.Gui.NetMainLoop')
|
||||
$drv = [Activator]::CreateInstance($drvT)
|
||||
$ctor = $loopT.GetConstructors([System.Reflection.BindingFlags]'Public,NonPublic,Instance') | Select-Object -First 1
|
||||
$loop = $ctor.Invoke(@($drv))
|
||||
$appT.GetMethod('Init', [Type[]]@($drvT, $mlT)).Invoke($null, @($drv, $loop)) | Out-Null
|
||||
L " Application.Init -> OK"
|
||||
$lblT = $tgAsm.GetType('Terminal.Gui.Label'); $btnT = $tgAsm.GetType('Terminal.Gui.Button')
|
||||
$w = [Activator]::CreateInstance($winT, [object[]]@($us))
|
||||
L (" Window created with ustring title: " + ($w.GetType().FullName))
|
||||
# Labels also take ustring; use implicit conversion
|
||||
$l1 = [Activator]::CreateInstance($lblT, [object[]]@($implicit.Invoke($null, @('Terminal.Gui 1.15.0 / Label via ustring conversion'))))
|
||||
$l2 = [Activator]::CreateInstance($lblT, [object[]]@($implicit.Invoke($null, @('CJK cell test: 2 CJK chars -> 4 columns'))))
|
||||
$b1 = [Activator]::CreateInstance($btnT, [object[]]@($implicit.Invoke($null, @('OK'))))
|
||||
$w.Add($l1); $w.Add($l2); $w.Add($b1)
|
||||
$w.X = 1; $w.Y = 1; $w.Width = 78; $w.Height = 9
|
||||
$l1.Y = 1; $l2.Y = 3
|
||||
$b1.Y = 5; $b1.X = 2
|
||||
$appT.GetProperty('Top').SetValue($null, $w)
|
||||
$appT.GetProperty('Current').SetValue($null, $w)
|
||||
$w.SetFocus(); $w.Redraw($w.Bounds)
|
||||
$appT.GetMethod('Refresh', [Type[]]@()).Invoke($null, @()) | Out-Null
|
||||
L " *** FULLY WORKING Terminal.Gui TUI painted: Window(78x9) + 2 Labels + Button ***"
|
||||
L "RESULT: TerminalGui=FULL-WIN via reflection + ustring conversion"
|
||||
Write-Host ""
|
||||
Write-Host (" ===== Terminal.Gui 1.15.0 live on PowerShell $($PSVersionTable.PSVersion) =====") -ForegroundColor Cyan
|
||||
Start-Sleep -Seconds $HoldSeconds
|
||||
$appT.GetMethod('Shutdown', [Type[]]@()).Invoke($null, @()) | Out-Null
|
||||
L " Shutdown clean"
|
||||
} catch {
|
||||
L (" FAILED: " + $_.Exception.GetType().Name + ': ' + $_.Exception.Message)
|
||||
$ie = $_.Exception.InnerException; while ($ie) { L (" inner: " + $ie.GetType().Name + ': ' + ($ie.Message -split "`n")[0]); $ie = $ie.InnerException }
|
||||
L "RESULT: TerminalGui=FAILED"
|
||||
}
|
||||
if (-not [Console]::IsOutputRedirected) { Start-Sleep -Seconds 2 }
|
||||
Reference in new issue
Block a user