@namewta/speculo 1.0.3 → 1.0.5

package/template/workflows/ops/H-computer-hygiene/examples/linux/2026-09-14.md

@@ -0,0 +1,216 @@
+# 2026-09-14 电脑环境与清理检测报告
+
+**测试示例：SYNTHETIC_FIXTURE_NOT_YOUR_COMPUTER。数据来自隔离 fixture，不代表任何用户的真实电脑。**
+
+运行 ID：`4c413d09b58a`；开始：2026-09-14T08:44:02.779627+00:00；完成：2026-09-14T08:44:02.783712+00:00。
+
+## 1. 结论与空间口径
+
+系统：**Linux / SIMULATED_ARCHITECTURE**。本次发现 6 条待复核事项；可选隔离候选 3 项，自动永久删除动作 **0** 项。检测没有启动包管理器、连接网络、卸载软件或修改环境配置。
+
+Home 所在卷剩余：120.00 GiB / 512.00 GiB。测量范围内按文件标识去重的逻辑大小：174.09 KiB；这**不是可释放空间**。扫描不完整时是已观察下界；硬链接、克隆、压缩、稀疏文件及文件系统特性会影响实际释放量。
+
+**隔离只是同卷重命名，不释放磁盘空间。** 缓存重新生成可能需要网络，mtime 不等于最后使用时间；所有删除、迁移、卸载和系统改动仍需逐项授权。
+
+执行环境线索：\{"fixture\_only": true\}。若在容器、SSH 主机或 WSL 中运行，报告针对该执行环境，不自动代表桌面宿主机。
+
+## 2. 覆盖范围与缺口
+
+| 范围 | 状态 | 说明 |
+| --- | --- | --- |
+| environment | partial | Process PATH and curated path variables inspected; no shell evaluation, tool execution or effective-version proof. |
+| configuration | partial | Known profile anchors and allowlisted Maven/npm path fields; no credentials, includes, project overrides, or effective execution. |
+| storage | partial | Known defaults and declared locations; per-tree/global budgets; no full-disk crawl; custom tool defaults may be missed. |
+| projects | partial | Authorized roots only; depth <= 3; repository content/state/remote ownership not verified. |
+| applications/startup | SIMULATED-NOT-NATIVE | Synthetic application metadata only; no real registry, Applications, launchd or service reads. |
+| loose-files/duplicates | partial | Downloads direct-child installers/archives/large-file metadata only. No content hashes, full-disk duplicate proof, Documents/Desktop traversal or personal-data deletion. |
+
+已访问元数据条目：38；全局预算耗尽：False。不是全盘完整性证明。
+
+No complete disk or effective-tool-version claim.
+
+Stat calls on an unrecognized remote filesystem may block; budgets are cooperative, not OS I/O deadlines.
+
+No universal detection of bind mounts, macOS firmlinks, APFS clones or same-device remote mappings.
+
+Metadata mtime is not last-use evidence; content-identical duplicates not proven.
+
+Current user's report does not cover other users, WSL guest systems or all external volumes.
+
+Disk capacity, architecture and application identity are illustrative fixture values, not real measurements.
+
+## 3. 优先处理清单
+
+| ID | 风险 | 发现 | 证据 | 建议 |
+| --- | --- | --- | --- | --- |
+| F0001 | R1 | PATH 字面重复项 | \{"index": 3, "value": "~/bin-primary", "expanded": "~/bin-primary", "status": "exists", "linklike": false, "duplicate\_of": 1\} | 保留必要优先级，备份后只修改产生重复的配置来源。 |
+| F0002 | R1 | PATH 目录当前不存在 | \{"index": 4, "value": "~/missing-bin", "expanded": "~/missing-bin", "status": "missing", "linklike": false\} | 排除未挂载磁盘、会话级 shims 与延迟创建路径后再移除。 |
+| F0003 | R2 | java 有多个 PATH 命中 | \["~/bin-primary/java", "~/bin-old/java"\] | 在可信终端核实实际版本和主用管理器；多个路径不等于冗余安装。 |
+| F0004 | R2 | JAVA\_HOME 出现在多个 profile 位置 | \[\{"path": "~/.profile", "line": 1\}, \{"path": "~/.zshrc", "line": 1\}\] | 只是静态出现记录，未证明重复赋值或加载顺序；人工核实生效 shell 后整合。 |
+| F0005 | R2 | 项目位于易被清理的位置 | ~/Downloads/source-clone | 先保全仓库状态与唯一数据，再规划项目根；位置不规范不等于允许删除。 |
+| F0006 | R2 | 同一项目有多个 Node 包管理锁文件 | \{"path": "~/Projects/example-web", "locks": \["package-lock.json", "pnpm-lock.yaml"\]\} | 确认实际管理器、迁移期和 CI 约束；不自动删除任一锁文件。 |
+
+风险：R0 观察；R1 缓存候选；R2 可能影响离线构建或应用；R3 系统/应用数据级；P 保护项。等级低不代表允许自动删除。
+
+## 4. PATH 与工具解析
+
+| 序号 | 当前项 | 状态 | 重复于 |
+| --- | --- | --- | --- |
+| 1 | ~/bin-primary | exists | — |
+| 2 | ~/bin-old | exists | — |
+| 3 | ~/bin-primary | exists | 1 |
+| 4 | ~/missing-bin | missing | — |
+
+| 工具 | PATH 候选首项 | 全部命中 | 实际版本 |
+| --- | --- | --- | --- |
+| java | ~/bin-primary/java | \["~/bin-primary/java", "~/bin-old/java"\] | 未执行，未知 |
+| javac | — | \[\] | 未执行，未知 |
+| mvn | — | \[\] | 未执行，未知 |
+| mvnw | — | \[\] | 未执行，未知 |
+| gradle | — | \[\] | 未执行，未知 |
+| node | — | \[\] | 未执行，未知 |
+| npm | — | \[\] | 未执行，未知 |
+| npx | — | \[\] | 未执行，未知 |
+| corepack | — | \[\] | 未执行，未知 |
+| pnpm | — | \[\] | 未执行，未知 |
+| go | — | \[\] | 未执行，未知 |
+| rustc | — | \[\] | 未执行，未知 |
+| cargo | — | \[\] | 未执行，未知 |
+| rustup | — | \[\] | 未执行，未知 |
+| python | — | \[\] | 未执行，未知 |
+| python3 | — | \[\] | 未执行，未知 |
+| uv | — | \[\] | 未执行，未知 |
+| uvx | — | \[\] | 未执行，未知 |
+| pip | — | \[\] | 未执行，未知 |
+| pipx | — | \[\] | 未执行，未知 |
+| mise | — | \[\] | 未执行，未知 |
+| asdf | — | \[\] | 未执行，未知 |
+| fnm | — | \[\] | 未执行，未知 |
+| volta | — | \[\] | 未执行，未知 |
+| nvm | — | \[\] | 未执行，未知 |
+| pyenv | — | \[\] | 未执行，未知 |
+| jenv | — | \[\] | 未执行，未知 |
+| scoop | — | \[\] | 未执行，未知 |
+| brew | — | \[\] | 未执行，未知 |
+| winget | — | \[\] | 未执行，未知 |
+
+PATH 查找不解析 shell alias/function、版本管理器 shim 内部逻辑或 IDE 环境；nvm 等函数型工具可能不会出现。
+
+## 5. 配置来源
+
+| 路径 | 状态 | 允许记录的字段 |
+| --- | --- | --- |
+| ~/.profile | inspected | \{"declarations": \[\{"variable": "JAVA\_HOME", "line": 1, "value": "not recorded; no evaluation"\}\]\} |
+| ~/.zshrc | inspected | \{"declarations": \[\{"variable": "JAVA\_HOME", "line": 1, "value": "not recorded; no evaluation"\}\]\} |
+| ~/.m2/settings.xml | inspected | \{"localRepository": "~/.m2/repository", "sensitive\_sections\_recorded": false\} |
+| ~/.cargo/config.toml | metadata-only | \{"note": "Potential configuration/credentials; content not exported. Effective values require trusted native queries."\} |
+
+当前进程的路径变量：
+
+| 变量 | 值 |
+| --- | --- |
+| JAVA\_HOME | ~/old-jdk |
+| GOCACHE | ~/.cache/go-build |
+| CARGO\_HOME | ~/.cargo |
+
+持久化环境（Windows 可读范围）：
+
+没有记录；请结合覆盖范围判断是不存在还是未检查。
+
+## 6. 工具链、依赖与缓存完整清单
+
+| 类型 | 路径 | 状态 | 逻辑大小 | 风险 | 证据来源 / 说明 |
+| --- | --- | --- | --- | --- | --- |
+| maven-local-repository | ~/.m2/repository | measured | 18.00 KiB | P | settings.xml declaration, not effective configuration proof; known default hypothesis; not proof of active use — May contain unpublished artifacts installed locally; never blanket-delete. |
+| gradle-home | ~/.gradle | absent | 未知 | P | known default hypothesis; not proof of active use — Contains configuration, caches, wrapper distributions and possibly credentials. |
+| cargo-home | ~/.cargo | measured | 59.00 B | P | known default hypothesis; not proof of active use; process environment: CARGO\_HOME — Contains config, credentials, installed binaries, registry and Git stores. |
+| rustup-home | ~/.rustup | absent | 未知 | R2 | known default hypothesis; not proof of active use — Installed toolchains; remove by exact toolchain through rustup after checking pins. |
+| go-workspace | ~/go | absent | 未知 | P | known default hypothesis; not proof of active use — Can contain source code and installed tools, not a disposable cache. |
+| uv-cache | ~/.cache/uv | absent | 未知 | R2 | known default hypothesis; not proof of active use — Use native uv cache commands after version verification; no automated moves. |
+| pnpm-store | ~/.local/share/pnpm/store | absent | 未知 | R2 | known default hypothesis; not proof of active use — Version-dependent default hypothesis; use pnpm store path to establish actual location. |
+| npm-home | ~/.npm | measured | 52.00 KiB | R2 | known default hypothesis; not proof of active use — May contain logs and other state; only \_cacache can qualify for quarantine. |
+| nvm | ~/.nvm | absent | 未知 | R2 | known default hypothesis; not proof of active use — Version manager; includes per-version global packages. |
+| volta | ~/.volta | absent | 未知 | R2 | known default hypothesis; not proof of active use — Version manager data; do not move without documented migration. |
+| fnm | ~/.local/share/fnm | absent | 未知 | R2 | known default hypothesis; not proof of active use — Default hypothesis, verify with configuration. |
+| mise | ~/.local/share/mise | absent | 未知 | R2 | known default hypothesis; not proof of active use — Support and path semantics must be checked against installed version. |
+| asdf | ~/.asdf | absent | 未知 | R2 | known default hypothesis; not proof of active use — May contain plugins, shims and installed runtimes. |
+| sdkman | ~/.sdkman | absent | 未知 | R2 | known default hypothesis; not proof of active use — Not assumed to support native Windows; WSL is a separate environment. |
+| pyenv | ~/.pyenv | absent | 未知 | R2 | known default hypothesis; not proof of active use — Interpreters and virtualenvs may have absolute prefix references. |
+| jdk-user | ~/.jdks | absent | 未知 | R2 | known default hypothesis; not proof of active use — Often IDE-managed; verify IDE ownership and project JDK pins. |
+| bun | ~/.bun | absent | 未知 | R2 | known default hypothesis; not proof of active use — Runtime and package state; not a pure cache. |
+| docker-user-state | ~/.docker | absent | 未知 | P | known default hypothesis; not proof of active use — Configuration may include authentication and contexts; no content export or automated deletion. |
+| npm-content-cache | ~/.npm/\_cacache | measured | 52.00 KiB | R1 | conservative default cache location — Recreation may need network; metadata age does not prove disuse. |
+| pip-cache | ~/.cache/pip | measured | 52.00 KiB | R1 | conservative default cache location — Recreation may need network; metadata age does not prove disuse. |
+| go-build-cache | ~/.cache/go-build | measured | 52.00 KiB | R1 | conservative default cache location; process environment: GOCACHE — Recreation may need network; metadata age does not prove disuse. |
+| jdk-install | ~/old-jdk | absent | 未知 | R2 | process environment: JAVA\_HOME —  |
+| project-artifact-node\_modules | ~/Projects/example-web/node\_modules | measured | 38.00 B | R2 | authorized project inventory — Name is only a hint; may contain source, local-only data, editable installs or tracked outputs. Manual review only. |
+
+不完整测量与跳过：
+
+没有记录；请结合覆盖范围判断是不存在还是未检查。
+
+## 7. 项目、仓库与构建产物
+
+| 项目 | 标记 | Git 类型 / 状态 | 构建产物候选 | 版本 pin / Node 声明 |
+| --- | --- | --- | --- | --- |
+| ~/Downloads/source-clone | \[\] | gitfile/worktree-or-submodule / unknown; Git commands not executed | \[\] | \{"packageManager": null, "pin\_files": \[\]\} |
+| ~/Projects/example-web | \[".nvmrc", "package-lock.json", "package.json", "pnpm-lock.yaml"\] | directory / unknown; Git commands not executed | \["~/Projects/example-web/node\_modules"\] | \{"packageManager": "pnpm@9.0.0", "pin\_files": \[".nvmrc"\]\} |
+
+目录名相同不证明仓库冗余；未验证 Git 的未提交/未推送内容、worktree、submodule、LFS 和分支。`build`、`dist`、`target` 或 `.venv` 可能含独有数据，不提供自动删除动作。
+
+## 8. 软件、启动项与卸载残留线索
+
+| 应用 | 版本 | 身份/路径 | 系统组件 | 处理方式 |
+| --- | --- | --- | --- | --- |
+| Example Editor | 1.0-fixture | ~/Applications/Example Editor.app | False | fixture candidate; not real software and never uninstalled |
+
+没有记录；请结合覆盖范围判断是不存在还是未检查。
+
+启动项或可执行文件缺失仅是残留线索，不证明可删除。软件冗余必须核实架构、插件、项目依赖、许可证和个人数据选择。
+
+| 平台读取缺口 |
+| --- |
+| Real OS inventory intentionally disabled for this example. |
+
+## 9. 下载资料与大文件复核
+
+| 文件 | 逻辑大小 | 修改时间 | 处理 |
+| --- | --- | --- | --- |
+| ~/Downloads/old-installer.zip | 17.00 B | 2026-09-14T08:44:02.779491+00:00 | manual ownership/backup/content review; not a deletion candidate |
+
+没有读取这些文件内容、计算重复文件哈希或证明安装包已不再需要。个人资料与备份默认保留。
+
+## 10. 可选隔离计划
+
+| 动作 ID | 缓存 | 路径 | 逻辑大小 | 释放空间 |
+| --- | --- | --- | --- | --- |
+| Q-b7c81bf877 | npm-content-cache | ~/.npm/\_cacache | 52.00 KiB | 否 |
+| Q-9c24086cc8 | pip-cache | ~/.cache/pip | 52.00 KiB | 否 |
+| Q-c7057cdfde | go-build-cache | ~/.cache/go-build | 52.00 KiB | 否 |
+
+计划有效期 24 小时，绑定主机与元数据快照。仅支持默认位置中结构可识别的 npm 内容缓存、pip 缓存和 Go 构建缓存；自定义路径、链接、硬链接、占位文件、扫描不全或近期变化会排除。执行前必须关闭相关工具，并以用户选中的 ID 审批。
+
+## 11. 原生清理与彻底卸载：待确认步骤
+
+| 类别 | 风险 | 执行前要求 | 参考 |
+| --- | --- | --- | --- |
+| maven | R2 | 核实 settings.xml、-Dmaven.repo.local、IDE 与项目参数；本地仓库可能含未发布的 install 产物，先备份，不整体删除。 | 20-toolchains.md#java-maven-gradle |
+| node-pnpm | R2 | 可信终端中核实 Node 管理器、npm cache/prefix 与 pnpm store path；按本地帮助选择原生命令，清理 store 前检查离线需求及正在运行的安装。 | 20-toolchains.md#node-npm-pnpm |
+| go-rust-uv | R2 | 核实 go env、rustup toolchain list、uv 路径命令；保留 Cargo 配置/凭据/安装工具，不把 Cargo Home、.venv 或 SDK 当缓存。 | 20-toolchains.md |
+| repositories | P | 对已授权且可信的仓库检查提交、推送、分支、worktree、submodule 和 LFS；未完成前不得删除仓库、.git、vendor、锁文件或虚拟环境。 | 22-repositories.md |
+| software | R3 | 先按精确应用身份使用官方卸载器，再单独确认用户数据与残留；共享运行库、驱动、服务、插件不能按名称推断可删。 | 30-software-removal.md |
+| system | R3 | 仅通过对应系统参考文档使用原生存储管理功能；不直接删除系统组件、快照、容器卷、WSL 磁盘或云同步文件。 | 10-windows.md / 11-macos.md / 12-linux.md |
+
+系统分流：Windows → `10-windows.md`；macOS → `11-macos.md`；Linux → `12-linux.md`。容器、WSL 和系统快照不计入可自动清理空间。
+
+## 12. 环境归一化、验证与回滚
+
+阅读同目录 `2026-09-14.environment.md`。该文件结合本机路径变量生成建议映射，不会修改 PATH 或持久化配置。按生态逐项验证，保留回滚副本；用户同意检测不等于同意迁移。
+
+隔离执行使用写前日志；恢复入口为 `hygiene.py restore`，若原路径已被工具重建会拒绝覆盖，需人工合并。真正永久删除后不能承诺自动回滚；备份、离线依赖和应用数据要在删除前另行确认。
+
+## 13. 证据、资料与隐私
+
+本报告事实来源为本次本地元数据、允许的配置字段和系统可读清单。官方核验入口见 `references/00-sources.md`；交付时未在线访问，不能当作已核实的最新命令支持。执行原生操作前须验证本机版本、帮助及供应商文档。
+
+Markdown/公开 JSON 把当前 home 替换为 `~`，但软件清单、目录名、其他账户路径及项目名称仍可能敏感，分享前需复核。`.plan.json` 和执行 receipt 含真实绝对路径，应只保存在本机私密目录。Windows 文件权限继承父目录 ACL；本脚本不声称设置了专用 DACL。

package/template/workflows/ops/H-computer-hygiene/examples/macos/2026-09-14.environment.md

@@ -0,0 +1,45 @@
+**模拟示例，不是已执行迁移。**
+
+# 2026-09-14 环境归一化方案
+
+**这是一份未执行的方案，不是已生效配置。** 先确认主用版本管理器与项目 pin；不得把统一目录理解成任意搬动所有 SDK。
+
+建议 DevRoot：`~/Developer/.tooling`。系统/安装器管理的内容仍留在系统规定的位置。路径可以统一规划，但不要通过联接/符号链接掩盖配置混乱。
+
+## 当前进程证据
+
+| 变量 | 当前声明 |
+| --- | --- |
+| JAVA\_HOME | ~/old-jdk |
+| GOCACHE | ~/Library/Caches/go-build |
+| CARGO\_HOME | ~/.cargo |
+
+没有被记录的变量不等于工具未安装；未执行原生查询，无法确认 CLI、项目或 IDE 的最终优先级。
+
+## 建议映射
+
+| 对象 | 建议目标 | 约束 |
+| --- | --- | --- |
+| JDK / JAVA\_HOME | 由已确认的主用版本管理器解析 | 不把 JAVA\_HOME 写死到待淘汰版本；IDE、CI、项目分别验证 |
+| Maven localRepository | ~/Developer/.tooling/data/maven/repository | 保留 settings.xml 官方锚点；备份未发布的 install 产物；不假设 MAVEN\_USER\_HOME 对所有版本生效 |
+| GRADLE\_USER\_HOME | ~/Developer/.tooling/data/gradle | 整体包含配置/缓存/凭据；先停止 daemon，备份再验证 |
+| Node 版本管理器 | 保留一个经确认的主用管理器 | nvm/fnm/volta/asdf/mise 不叠加争抢入口；原生 Windows 支持单独核实 |
+| npm cache | ~/Developer/.tooling/cache/npm | 使用 npm 官方配置入口；不盲目设置全局 prefix；日志不等于纯缓存 |
+| PNPM\_HOME / pnpm store | ~/Developer/.tooling/bin/pnpm / ~/Developer/.tooling/cache/pnpm-store | 两个不同概念；store 路径用本地版本支持的配置设置，注意项目所在卷与硬链接 |
+| GOPATH / GOBIN | ~/Developer/.tooling/data/go / ~/Developer/.tooling/bin/go | GOPATH 可能是多路径并含源码；GOBIN 中有用户安装的工具 |
+| GOCACHE / GOMODCACHE | ~/Developer/.tooling/cache/go-build / ~/Developer/.tooling/cache/go-mod | 清理影响离线构建；一般不设置 GOROOT；先检查 go env 和项目 toolchain |
+| CARGO\_HOME / RUSTUP\_HOME | ~/Developer/.tooling/data/cargo / ~/Developer/.tooling/data/rustup | 非纯缓存；保护 credentials、config、bin、toolchain override；不要整目录自动迁移 |
+| UV\_CACHE\_DIR | ~/Developer/.tooling/cache/uv | 先以当前 uv 帮助确认变量支持与现有配置 |
+| UV\_PYTHON\_INSTALL\_DIR / UV\_TOOL\_DIR | ~/Developer/.tooling/data/uv/python / ~/Developer/.tooling/data/uv/tools | 解释器、工具环境与缓存分开；虚拟环境不保证可重定位 |
+| UV\_TOOL\_BIN\_DIR | ~/Developer/.tooling/bin/uv | 确认 shell PATH 与已安装工具入口；避免和 pipx/系统 Python 重名 |
+| mise/asdf/SDKMAN 等 | ~/Developer/.tooling/data 下各自专属根 | 仅建议；按已安装管理器的真实 OS/版本文档迁移；不默认安装新管理器 |
+
+## 迁移顺序与验收
+
+先备份配置与安装清单，确认没有运行中的 IDE、daemon、构建或安装。逐个生态迁移，不同时改所有变量。缓存优先让工具在新路径重建；含本地状态的目录按官方迁移方法处理。虚拟环境与绝对路径 shim 通常应重建。
+
+先在新终端进行会话级验证，再修改单一持久化来源，最后重开终端、IDE 和构建任务验证。Windows 用户与机器 PATH 分开处理，禁止用 setx PATH 拼接覆盖；macOS 登录 shell、交互 shell、GUI 启动环境各自核实。
+
+逐一检查 Maven/JDK 构建、Node/pnpm 安装与离线依赖需求、Go 测试、Rust override 与 cargo 工具、uv 项目及 tool 入口。需要网络的验证单独确认；失败则恢复原配置和原解析入口。旧目录只有在全部验证通过、唯一数据已备份并再次获准后才进入清理计划。
+
+PATH 仅放必要的 bin/shims；不要加入缓存、库目录、整个 SDK 根或当前目录。项目级 pin、wrapper 与 lockfile 保留。详见 `references/20-toolchains.md` 和 `21-path-migration.md`。