# TUI 写配置：外科式改写，校验通过才原子替换

三个配置文件都含**无法往返**的内容：

- `SoftwareCatalog.psd1` 里有 `$(if ($env:SCOOP_GLOBAL) { ... } else { ... })\persist` 这类动态
  表达式、`$(scoop prefix translucenttb)\settings.json`，以及**跨行字符串拼接**的 `Exclude`。
  `Import-PowerShellDataFile` **实测读不了这个文件**（报 "cannot generate a PowerShell object
  for a ScriptBlock evaluating dynamic expressions"）。
- `BackupList.txt` 与 `BackupConfig.psd1` 里的注释**本身就是文档**（记录每个开关的取舍）。

所以任何"解析成对象 → 改 → 重新序列化"的方案都会把它们毁掉。做法：

1. **只改写被编辑的那一行/那一块**，其余逐字节保持；
2. 写临时文件 → 用模块自己的读取器解析 + 语义校验（清单逐行 `ConvertFrom-BackupListLine`、
   配置的类型与取值、名录的展开与 `Test-Path`）；
3. **只有全过才调用已有的 `Write-BaknretAtomicText` 替换**；不过就**拒绝保存**并把原文错误打出来。

这条让 TUI 编辑器从"方便"升级为"**比手改更安全**"——手改没有校验，而它有。

## 可编辑面按"能不能安全往返"来定

| 文件 | 模型 | 可编辑 |
| --- | --- | --- |
| `BackupList.txt` | 行编辑器（复用已有 token 解析器） | 方向 / 目标 / 覆盖 / 排除 / 追加 / 加密 / 键值 / 说明 |
| `BackupConfig.psd1` | 扁平表单 | 目录、阈值、开关及其合法取值 |
| `SoftwareCatalog.psd1` | 树 + 只读字段 | **只有 `Encrypt` 与 `Description`**；`Path`/`Exclude`/`Include` 显示为只读并提示用文本编辑器 |

## 两条配套约定

- 每次保存前把原文件按时间戳复制到 `logs/config-backups/`（已 gitignore，不污染仓库）。
- 每个编辑器带一条**往返断言**：解析 → 改一个字段 → 写回 → 重新解析，**除目标字段外逐字段相等，
  且注释行数不变**。没有这条断言，TUI 编辑器就是"看起来能保存"的典型。