BakNRet

59 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
Shuery	2cbcaaee48	chore(license): 补 Apache License 2.0 许可证正文逐字采用 ASF 的 LICENSE-2.0.txt，只把 APPENDIX 里的版权占位行填成 "Copyright 2026 Shuery" —— 正文一个字节都没改。为此先下载规范文本再打补丁，而不是凭记忆抄一遍：许可证抄错一个词就不再是那个许可证了。校验方式是逐行对比本仓 LICENSE 与规范文本，结果只差版权那一行（规范文本 11358 字节、 SHA256 cfc7749b…；本仓 11337 字节，差额 21 字节正好等于两行文本的长度差）。选 Apache-2.0 而非 MIT，主要差别在第 3 节的明示专利授权：贡献者授予专利许可，而不只是版权许可。同时： * README 的许可证章节从「尚未声明」改成实际条款摘要 + 徽章（License: Apache-2.0） * BakNRet.psd1 的 PrivateData.PSData 登记 LicenseUri 与 Copyright，Import-Module 之后可直接读到许可信息 * 不加 NOTICE：第 4(d) 节只在作品本身带 NOTICE 时才要求向下传递，而本仓库不分发第三方代码（Pester / PSScriptAnalyzer 只放在 .tools/ 供本地测试，既进 gitignore 也不进分发产物） * .scratch/ci-cd 的两份报告补了带日期的「后续更新」注记，关掉许可证合规的 L-1 与依赖安全扫描的 R-1，避免后来的人读到「主许可证未声明」这个已经过期的结论验收：test.ps1 9/9 全绿（5.1 与 7）；静态分析 80 条、0 Error（与改动前持平）； README 相对链接 0 失效、新增外部链接 2/2 返回 200；双宿主解析 psd1 零错、89 个导出不变。	2026-10-02 01:34:45 +08:00
Shuery	45bbd66815	docs(report): 新增 PROJECT_REPORT.md 与 CI/CD 流水线记录 PROJECT_REPORT.md：论文式项目报告（摘要 / 目录 / 7 章 / 参考文献 / 致谢 / 附录 A）， 4 张 Mermaid 图同样经真实浏览器渲染验证。所有数字都与证据文件逐个核对过。 .scratch/ci-cd/：本次流水线的全部证据与可重跑脚本 * 阶段报告：依赖安全扫描 / 许可证合规 / 阶段 0 静态分析 / 阶段 3 测试与性能 * 证据：分析器原始输出（修复前 84 条、修复后 80 条）、Pester 详细输出、性能基线 JSON、黑盒用例结果（阶段 1 的 11 例与阶段 2 回归的 12 例） * 可重跑：blackbox-tests.ps1 / blackbox-regression.ps1 / perf-baseline.ps1 两条边界必须写在明处，不能含糊： * VM 内验证只取到修复前的快照（Pester 183 项全绿）。随后会话审批策略改为 never， gsudo 提权被自动拒绝（退出码 999），而 Hyper-V 与 PowerShell Direct 都需要管理员，于是修复后的三套件在 VM 内没有跑成。报告里明确标注了范围，没有把"宿主跑绿了" 说成"VM 也跑绿了"。 * 性能基线是首次建立，无历史可比，故无退化可判；指标只在同机同宿主下对比，跨机比数字没有意义。另外记一笔：静态分析的口径是"仓库自己的门禁"。剩余 80 条全是风格类（0 Error），且逐条有依据 —— 行长 160 是配置里写明的有意偏离，PSPlaceCloseBrace 等集中在测试夹具字符串内（改了会改变断言语义）。严格模式的"零容忍"在这里与仓库自身约定相抵，选择尊重仓库约定并在报告里登记，而不是制造一个横跨 12 个文件的纯排版大 diff。	2026-10-02 01:17:40 +08:00

Author

SHA1

Message

Date

Shuery

2cbcaaee48

chore(license): 补 Apache License 2.0

许可证正文**逐字采用** ASF 的 LICENSE-2.0.txt，只把 APPENDIX 里的版权占位行填成
"Copyright 2026 Shuery" —— 正文一个字节都没改。

为此先下载规范文本再打补丁，而不是凭记忆抄一遍：许可证抄错一个词就不再是那个许可证了。
校验方式是逐行对比本仓 LICENSE 与规范文本，结果只差版权那一行（规范文本 11358 字节、
SHA256 cfc7749b…；本仓 11337 字节，差额 21 字节正好等于两行文本的长度差）。

选 Apache-2.0 而非 MIT，主要差别在第 3 节的**明示专利授权**：贡献者授予专利许可，
而不只是版权许可。

同时：
  * README 的许可证章节从「尚未声明」改成实际条款摘要 + 徽章（License: Apache-2.0）
  * BakNRet.psd1 的 PrivateData.PSData 登记 LicenseUri 与 Copyright，Import-Module
    之后可直接读到许可信息
  * 不加 NOTICE：第 4(d) 节只在作品本身带 NOTICE 时才要求向下传递，而本仓库不分发第三方
    代码（Pester / PSScriptAnalyzer 只放在 .tools/ 供本地测试，既进 gitignore 也不进分发产物）
  * .scratch/ci-cd 的两份报告补了带日期的「后续更新」注记，关掉许可证合规的 L-1 与依赖
    安全扫描的 R-1，避免后来的人读到「主许可证未声明」这个已经过期的结论

验收：test.ps1 9/9 全绿（5.1 与 7）；静态分析 80 条、0 Error（与改动前持平）；
README 相对链接 0 失效、新增外部链接 2/2 返回 200；双宿主解析 psd1 零错、89 个导出不变。

2026-10-02 01:34:45 +08:00

Shuery

45bbd66815

docs(report): 新增 PROJECT_REPORT.md 与 CI/CD 流水线记录

PROJECT_REPORT.md：论文式项目报告（摘要 / 目录 / 7 章 / 参考文献 / 致谢 / 附录 A），
4 张 Mermaid 图同样经真实浏览器渲染验证。所有数字都与证据文件逐个核对过。

.scratch/ci-cd/：本次流水线的全部证据与可重跑脚本
  * 阶段报告：依赖安全扫描 / 许可证合规 / 阶段 0 静态分析 / 阶段 3 测试与性能
  * 证据：分析器原始输出（修复前 84 条、修复后 80 条）、Pester 详细输出、
    性能基线 JSON、黑盒用例结果（阶段 1 的 11 例与阶段 2 回归的 12 例）
  * 可重跑：blackbox-tests.ps1 / blackbox-regression.ps1 / perf-baseline.ps1

两条边界必须写在明处，不能含糊：

  * **VM 内验证只取到修复前的快照**（Pester 183 项全绿）。随后会话审批策略改为 never，
    gsudo 提权被自动拒绝（退出码 999），而 Hyper-V 与 PowerShell Direct 都需要管理员，
    于是修复后的三套件在 VM 内**没有跑成**。报告里明确标注了范围，没有把"宿主跑绿了"
    说成"VM 也跑绿了"。
  * **性能基线是首次建立**，无历史可比，故无退化可判；指标只在同机同宿主下对比，
    跨机比数字没有意义。

另外记一笔：静态分析的口径是"仓库自己的门禁"。剩余 80 条全是风格类（0 Error），且逐条
有依据 —— 行长 160 是配置里写明的有意偏离，PSPlaceCloseBrace 等集中在测试夹具字符串内
（改了会改变断言语义）。严格模式的"零容忍"在这里与仓库自身约定相抵，选择尊重仓库约定
并在报告里登记，而不是制造一个横跨 12 个文件的纯排版大 diff。

2026-10-02 01:17:40 +08:00