docs: 完成 trans 文本短路径复盘

2026-07-13 05:52:33 +02:00
parent 96baf6854a
commit f495151335
6 changed files with 76 additions and 5 deletions
@@ -111,22 +111,22 @@

 解决 [UniDesk #1880](https://github.com/pikasTech/unidesk/issues/1880)：收敛 `platform-db postgres plan|status|apply` 默认输出为有界、同构且脱敏的计划/状态/终态摘要；`apply --wait` 保留实时进度，但最终只展示 mutation/job/result/cutover blockers、role/database/app connection 与 Secret presence/fingerprint，并以显式 `--full|--raw` 提供完整下钻；不得提高 stdout 阈值、读取临时 dump 二次裁剪、改变 PostgreSQL 运行语义或打印完整 `DATABASE_URL`，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R7_Task_Report.md)。

-## R8 [in_progress]
+## R8 [completed]

 依据用户 post-task 解决 [UniDesk #1889](https://github.com/pikasTech/unidesk/issues/1889) 与 [UniDesk #1890](https://github.com/pikasTech/unidesk/issues/1890)：让 Windows ps/cmd 继承 route cwd，远端文本默认走 cat/apply-patch quoted heredoc，文本传输在写入前引导，默认有界输出不再自动产生临时 dump；目标是减少同类任务的试探、转存和二次读取调用，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R8_Task_Report.md)。

-### R8.1 [in_progress]
+### R8.1 [completed]

 由原生子代理解决 [UniDesk #1889](https://github.com/pikasTech/unidesk/issues/1889)：统一 Windows ps/cmd/quoted-heredoc stdin 的 route cwd，补原入口测试并提交独立 PR，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R8.1_Task_Report.md)。

-### R8.2 [in_progress]
+### R8.2 [completed]

 由原生子代理解决 [UniDesk #1890](https://github.com/pikasTech/unidesk/issues/1890)：前置收敛文本 download/upload、apply-patch TTY 与默认 dump 合同，更新 scoped help、skill/reference、测试并提交独立 PR，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R8.2_Task_Report.md)。

-### R8.3
+### R8.3 [completed]

 主代理依次审查合并两个 PR，在 D518 仅使用 cat、apply-patch quoted heredoc 和有界查询完成原入口验收，关闭 issue 并记录调用数收敛证据，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R8.3_Task_Report.md)。

-### R8.4 [in_progress]
+### R8.4 [completed]

 补齐合并后验收发现的 [UniDesk #1890](https://github.com/pikasTech/unidesk/issues/1890) 残余：gh issue 默认 Next、readCommands、help、skill 与 reference 必须把 trans gh:/owner/repo/issue/<number> cat 作为人工正文读取首选，结构化 JSON/full/raw 仅作为显式机器披露，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R8.4_Task_Report.md)。
@@ -0,0 +1,13 @@
+# R8.1 任务报告
+
+## 结果
+
+- [Issue #1889](https://github.com/pikasTech/unidesk/issues/1889) 由原生子代理完成，[PR #1891](https://github.com/pikasTech/unidesk/pull/1891) 已合并，master merge commit 为 `18937da9`。
+- Windows `ps` / `cmd` 现在要求显式 `win/<drive>/<path>` route cwd，并同时设置 PowerShell provider cwd 与 `[Environment]::CurrentDirectory`；这保证 .NET API 和子进程也使用同一相对路径基准。
+- 非法或缺失 Windows route cwd 返回 typed 错误，不再静默从 `C:\Windows` 执行。
+
+## 验证
+
+- 定向测试 34/34 通过。
+- D518 原入口中 `(Get-Location).Path` 与 `[Environment]::CurrentDirectory` 均为 `D:\work\研究资料归档-李昂`。
+- 相对路径 `[IO.File]::ReadAllBytes('README.md')` 成功读取 8511 字节，SHA-256 为 `da93d75d98a35e872c0dac164080c75bb513f64a336159d023038e4ef9d395a7`。
@@ -0,0 +1,15 @@
+# R8.2 任务报告
+
+## 结果
+
+- [Issue #1890](https://github.com/pikasTech/unidesk/issues/1890) 第一阶段由原生子代理完成，[PR #1893](https://github.com/pikasTech/unidesk/pull/1893) 已合并，master merge commit 为 `1f05e26f`。
+- 已知文本路径的 `download` / `upload` 在远端操作或本地目标写入前返回 `text-transfer-discouraged`；二进制和显式 `--allow-text-transfer` 生成物仍保留字节数与 SHA-256 校验。
+- `apply-patch` 无 stdin 的交互 TTY 立即返回 `apply-patch-stdin-required` 和 quoted heredoc 示例。
+- 默认超限输出不再生成 dump；只有显式 full/raw 或 `UNIDESK_TRAN_STREAM_DUMP=1` 才允许受保护完整披露。
+- trans help、skill 与长期参考已统一推荐 `cat|head|tail|rg` 和 `apply-patch <<'PATCH'`，旧 `< patch.diff>` 与文本 download 默认示例已清零。
+
+## 验证
+
+- 补审后定向测试 50/50、basic check 11/11、`git diff --check` 和受控 preflight 通过。
+- master 上 `trans --help apply-patch|download|upload` 的第一用法分别为 quoted heredoc、`cat`、quoted heredoc。
+- 使用 `trans gh:/... apply-patch` quoted heredoc 更新 Issue 正文，9 ms 一次成功，无临时 patch、download/upload 或 dump。
@@ -0,0 +1,14 @@
+# R8.3 任务报告
+
+## 主代理验收
+
+- 主代理逐个审查并受控合并 PR #1891、#1893、#1894；#1889 与 #1890 均已关闭。
+- D518 MET 计算程序实跑 `ok=true`、`gold_pass=true`，得到 `Kp0=0.1315041505228434`、`Kd0=0.08617637469156456 s`；E 系列候选为 `R5=39 kOhm`、`C5=220 nF`，局部 `Kd=0.0858 s`，误差 `-0.4367%`，设计带幅值/相位误差均通过。
+- D518 归档 repo 已有 2 个聚焦提交；MET MDTODO、R1/R1.1-R1.7 八份报告、程序、配置、30 行 CSV 和结果均已跟踪。其余 6982 个历史文件共 1.057 GiB，含大量压缩包、备份和不可 diff 二进制，因此未做未经治理的巨型提交。
+
+## 调用数收敛
+
+- Windows 相对路径：从失败探测加绝对路径重试的约 2 次，收敛为 1 次 route-cwd heredoc。
+- 远端文本修改：从临时 patch 创建、转交、清理及失败重试的 3 次以上，收敛为 1 次 quoted heredoc apply-patch。
+- Issue/PR 人工全文：从 `--json body`、dump 读取、dump 清理的约 3 次，收敛为 1 次 `trans gh:/... cat`；定点信息直接 1 次 `rg`。
+- D518 同类归档审计：从约 8 次散点读取整理为 2 次聚合 PowerShell 检查，只有异常时追加 1 次复核。
@@ -0,0 +1,14 @@
+# R8.4 任务报告
+
+## 结果
+
+- 合并后验收发现默认 `gh issue view` Next 仍优先 `--json body`，因此重开 #1890 并由原生子代理继续修复。
+- [PR #1894](https://github.com/pikasTech/unidesk/pull/1894) 已合并，master merge commit 为 `96baf685`。
+- issue/PR 的默认 view、生命周期、创建/更新、参数错误、scoped help、skill 与 reference 均把 `trans gh:/... cat|rg` 作为人工正文入口。
+- `--json body`、`--full`、`--raw` 保留为显式机器结构化入口；普通默认或普通 `--json body` 超预算不创建 dump。
+
+## 验证
+
+- 定向测试 19/19、basic check 11/11、`git diff --check` 通过。
+- 独立原生子代理只读审计通过，无阻塞残余。
+- master 原入口 `gh issue view 1890` 与 `gh pr view 1894` 的 Next 前两项均为对应 `trans gh:` cat 和 rg，输出无 dump。
@@ -0,0 +1,15 @@
+# R8 任务报告
+
+## 完成结论
+
+本轮 post-task 已把用户指出的临时 dump、文本 download/upload、临时 patch 和 Windows route cwd 摩擦落实到工具源码、typed hint、help、skill、长期参考和回归测试中。
+
+- #1889 / PR #1891：统一 Windows provider cwd 与进程 cwd，稳定消费 stdin heredoc。
+- #1890 / PR #1893：文本传输前置拦截、apply-patch TTY 快速失败、默认不落 dump、quoted heredoc 首选。
+- #1890 / PR #1894：人工 issue/PR 正文统一为 `trans gh: cat|rg`，机器 JSON/full/raw 单独显式披露。
+- 三个 PR 均经主代理审查、受控 preflight、合并和 master 原入口复验；两个 Issue 已关闭。
+- D518 MET 计算链与资料归档已复验，未将 1.057 GiB 未治理历史文件草率整体提交。
+
+## 长期效果
+
+同类任务的常规最短路径固定为一次 `cat`、一次 `rg` 或一次 `apply-patch` heredoc；默认输出不再要求调用方读取和清理 dump。子代理 post-task 未发现新的阻塞工具问题。