Skip to content

证据政策

本页结论:本站只认两级证据——E1 官方文档、E2 本仓库可复现实验输出(demos/**/*.out.txt);每条结论必须标注证据来源;Windows 侧快照由 collect-windows-outputs workflow(workflow_dispatch 手动触发)采集,首采已入库;「待首次采集」是首采入库前的历史标注,表示当时尚无快照佐证。

证据分级

级别证据类型来源用途
E1官方文档上游手册、发行说明、官方参考(如 bash man page、PowerShell Learn 文档、fish 官方文档、cmd 的 Microsoft 文档)描述「设计与承诺的行为」:语法定义、默认值、官方口径
E2本仓库可复现实验输出demos/**/*.out.txt(与脚本并排、真实采集入库,见快速上手描述「实际跑出来的行为」:真实输出、退出码、报错文本

优先级:当 E1 与 E2 冲突时,以 E2 的实际输出为准陈述行为,用 E1 解释差异原因(版本、平台、配置)。本站不采信 E1/E2 之外的「据说」「我记得」。

标注规则

  • 每条结论必须标注证据来源:E1 注明来源(文档名或链接),E2 注明快照路径(如 demos/bash/07_errors.sh.out.txt)。
  • 无证据支撑的说法要么不写,要么显式标注为「推断」,不得与已验证结论混排。
  • 结论引用输出时,引用的文本必须与快照逐字一致,不得改写、美化或省略关键报错。

Windows 快照与「待首次采集」

  • Windows 侧(cmd / PowerShell 5 / PowerShell 7)没有可锁镜像(见版本政策),其 *.out.txt 快照由 GitHub Actions 的 collect-windows-outputs workflow 在 windows-latest runner 上采集,经 workflow_dispatch 手动触发,采集后自动提交入库。
  • 首采已完成:该 workflow 已完成首采,27 份 Windows 侧快照(cmd / PowerShell 5 / PowerShell 7 各 9 份,含各自 00_env)已入库。Windows runner 无镜像可锁,版本漂移以 00_env 快照留痕,此后经 workflow_dispatch 重采刷新。
  • 「待首次采集」是历史标注:首采入库前,无快照佐证的结论一律标注「待首次采集」,不得写成「已验证 / 实测 / 真实输出为……」,不得进入矩阵页的对照单元格作为既成事实。快照入库后,此类结论应逐步对照入库快照核实并移除标注;标注尚存之处,上述约束仍然适用。

复现与失效

  • 任何人可用 npm run collect-outputs 本地重跑 Linux 侧采集,并与入库快照对照,验证 E2 证据可复现。
  • Windows 侧重采由 collect-windows-outputs workflow 经 workflow_dispatch 手动触发,新快照自动提交入库后,按版本政策的升级流程审查差异。
  • 运行体升级后,旧快照可能失效——按版本政策的升级流程重跑采集、审查差异、同步结论。

Released under the MIT License.