foolproof-operation 1.1.1__tar.gz

foolproof_operation-1.1.1/CHANGELOG.md

@@ -0,0 +1,117 @@
+# Changelog
+
+本项目所有值得注意的变更都会记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [1.1.1] - 2026-09-23
+
+### Added
+
+- **（阶段 D）发布打包配置**：新增 `pyproject.toml`（名称 `foolproof-operation`、MIT、`requires-python>=3.8`、
+  **运行时零依赖**、console script `foolproof-operation = foolproof_operation.__main__:main`）与 `MANIFEST.in`。
+  防膨胀口径参照 `G:\repos\an-engine` 的教训：**关闭 `include-package-data` 自动收录**（pyproject 模式下默认 True，
+  会把包内所有已跟踪文件打进 wheel），改用显式 `package-data` 白名单（分类清单 / 插件清单 / 内置 es.exe 及其 LICENSE）；
+  sdist 清单排除运行期产物（失败日志、重试日志、`*.bak-*`、基准 JSON）。
+  实测：wheel 238 KB / 解包 595 KB，条目仅包与 5 个白名单数据文件 + dist-info（**零日志/基准/测试/文档**）；
+  干净 venv 安装后控制台脚本与 `python -m foolproof_operation` 均 exit 0，包内资源在位。
+- **（阶段 C）GUI 两个面板**：工具栏新增「📋 任务日志」与「🐍 环境发现」入口，均为**独立窗口**（不动既有主界面布局）。
+  - 📋 任务日志：读 JSONL 流水 → 按事件名过滤（输入即筛）/ 只看失败 / 刷新 / 清空；顶部显示条数·首末时间·失败计数，失败行标 ⚠。
+  - 🐍 环境发现：按后端（auto/index/es/walk/legacy）列出候选环境（类型/路径/版本/解释器，含 ✓✗ 深验证标记），
+    显示**来源后端与各后端尝试原因**、索引状态摘要（已建/未建/被拒），可对选定卷**一键建库 / 增量同步**（后台线程）。
+  - 实现：数据逻辑在界面无关的 `foolproof_operation/panels.py`（`TaskLogModel` / `EnvPanelModel`），GUI 只做渲染与按钮接线；
+    GUI 冒烟协议同步扩展为「启动主窗口 + 真的打开两个面板 + 关闭」。
+- **环境发现（索引驱动）**：新增 `cli envs` —— 基于本机 NTFS **USN/MFT 元数据索引**发现 Python 环境，
+  覆盖目录名启发式看不见的深层 venv（如 `G:\notpython\kard_CN\venv`）。选项：`--build`（索引缺失时先建，
+  只读卷、不创建 USN journal）、`--deep`（逐个真跑解释器验证）、`--json`（导出）、`--volumes`、`--backend`。
+  实测本机 5 卷 479 万条记录建库 ≈50s，发现 **208 个环境候选**（187 venv / 20 standalone / 1 embed），
+  而原 `scan` 口径为 **4 个**；查询延迟 0.02~1.46ms。原理、实测与许可记账见 `docs/usn-indexer.md`。
+- **检索后端三级回退**：`index`（本仓索引）→ `es`（内置 Everything 命令行，MIT © voidtools）→
+  `walk`（目录遍历）依次回退，且每次检索都记录**每个后端的尝试与原因**（缺索引 / Everything 未运行 /
+  拒绝整盘遍历 / 命中条数），不静默降级。整盘遍历默认拒绝（`--allow-whole-drives` 显式许可），
+  另有 30s 墙钟预算兜底并标注「结果可能不全」。
+- **Cordis 式可逆插件内核（零第三方依赖）**：`core/` 提供 Context（服务注册表 + effect 逆序回收 +
+  `fork` 作用域 + 事务化清单装配），`foolproof.composition.json` 为插件清单，
+  `plugins/search.py`、`plugins/scanner.py` 为插件行；`core/runtime.py` 供 CLI/GUI 共用装配。
+  服务可见性与回收责任分离（服务冒泡到 realm 根、disposer 留在注册者），多实例私有服务用 `isolate`。
+- `cli scan --backend index|auto`：在保持原 glob 口径（默认 `walk`）之外，可选走插件化发现。
+- 测试：新增 `tests/`（stdlib `unittest`，214 例），覆盖内核语义、USN 解析、路径还原、索引库、
+  插件回退与溯源、清单装配；另含「批量名字查询必须命中索引」的 `EXPLAIN QUERY PLAN` 性能护栏。
+- 文档：新增 `docs/usn-indexer.md`（原理 / 实测 / 权限矩阵 / 性能基准 / 踩坑记录）
+  与实盘基准 JSON（`docs/usn-bench-*.json`、`docs/usn-store-bench-2026-09-23.json`、`docs/usn-envs-2026-09-23.json`）。
+- **插件化迁移（阶段 5）**：把四类逻辑迁入插件行 —— `plugins/categories.py`（分类清单 +
+  启动审计 fail-loud + 模糊匹配/规格拆分/pip 查询名）、`plugins/pip.py`（子进程调用 + 报错解读 +
+  健康检查 + 两种修复方式）、`plugins/reqtxt.py`（requirements.txt 解析 + 逐条安装编排）、
+  `plugins/installer.py`（安装/卸载/检查/升级编排，`inject = pip + categories`）。
+  清单扩至 **8 行**；`cli.py` 与 `requirements.py` 保留同名入口，内部委托插件。
+  **行为零变化有硬证据**：以 `git archive HEAD` 快照为基线，迁移前后 **52 项断言逐字一致**
+  （分类数与键、`target_of`/`split_spec`/`pip_query_name`/`is_local_spec`、
+  `find_category` 的 `SystemExit` 措辞、`_resolve_packages` 各分支、`cmd_list` 全量与单分类输出、
+  requirements.txt 解析、`stderr_tail`/`failure_hint` 映射）。
+  - 唯一**有意硬化**：`cli check` 在 `pip show` 超时/异常时按「未安装」处理（原实现在该路径会抛栈）。
+  - GUI 的流程编排（线程 / 日志 / 音效 / 进度）保持原样，仅叶子逻辑改为委托插件。
+- **任务日志与启动审计（阶段 6，B 类模板标配）**：`core/tasklog.py`（JSONL 操作流水，
+  默认落用户级目录、可用 `FOOLPROOF_TASKLOG` 覆盖、写失败不影响主流程）+ `cli tasks`
+  （事件计数 / 失败计数 / 最近记录 / `--json` / `--clear`）；`core/audit.py` +
+  `cli doctor`（一次核完插件清单、分类清单、索引状态、检索后端、日志可写性，只读，
+  有 error 时退出码 1）。清单扩至 **10 行**（新增 `tasklog` / `audit`）。
+  `install`/`uninstall`/`check` 在**不改变任何 stdout** 的前提下静默记录事件。
+
+### Changed
+
+- **（阶段 B）GUI 五条流程迁出界面层**：安装 / 一键更新 / 卸载 / 版本检查 / requirements.txt 安装
+  原本内联在 `gui.py`（各自拼 pip 命令 + 写日志 + 播声音），现抽到界面无关的
+  `foolproof_operation/flows.py`（只依赖 `installer`/`pip` 服务与一个 `Sink` 输出槽），
+  GUI 方法变成薄适配器；`_check_pip` / `_do_repair` 也改为调用 `PipService.health()` / `repair()`。
+  配套：`PipService.show()` 严格区分「未安装 / 查询异常」（此前合并成 `None` 会让两类日志混淆）、
+  `InstallerService.check_pairs()` 支持 GUI 的「显示名 → value」对；GUI 关窗时回收插件运行时。
+  **行为零变化**：以阶段 A 提交快照为基准，用同一探针驱动真实 GUI 流程方法（打桩 pip 低层，
+  含成功与失败分支），前后日志/音效/失败日志序列 **57 行逐字一致**；新增 `tests/test_flows.py`
+  以逐条断言锁住日志文本与音效序列。
+- **（结构层）代码收进 `foolproof_operation` 包**，为 PyPI 发布铺路：平铺的 `core/` `index/` `plugins/`
+  `cli.py` `requirements.py` 移入包目录（`gui.py`），清单与内置 es.exe 随包分发；包内导入改相对形式，
+  插件清单里的动态导入改全路径。仓库根保留 `requirements.py` / `cli.py` **兼容 shim**，
+  老命令 `python requirements.py cli …` 继续可用；新增 `python -m foolproof_operation [cli …]` 统一入口。
+  两个 PyInstaller spec 改为 `SPECPATH` 相对路径 + 包内资源 + 带包名的 `hiddenimports`。
+  **行为零变化**：与重构前快照对照，52 项可观测断言逐字一致。
+  原因：直接以平铺布局发布会在 site-packages 留下 `core/` `index/` `plugins/` 这类通用顶层名
+  （与其它包高概率冲突），且顶层绝对导入在安装后必然 ImportError。
+- README / README.en 去本地化：绝对路径改为 `<PATH>` 占位符，首屏补仓库链接与 MIT 许可声明；
+  两版逐节对齐（章节 / 要点数 / 占位符数量一致），分类与库数统一为「24 分类 / 761 个库」。
+
+### Fixed
+
+- **GBK 控制台下 `cli` 因 emoji 直接崩**（既有缺陷，打包冒烟时暴露）：分类名含 emoji，
+  在默认代码页 936 的控制台打印时抛 `UnicodeEncodeError: 'gbk' codec can't encode character '\U0001f3ae'`，
+  **源码版与冻结版都会中招**。现于 CLI 入口放宽 stdout/stderr 错误策略（`errors="replace"`）：
+  中文正常、emoji 退化为 `?`，命令不再崩；要完整显示可 `set PYTHONIOENCODING=utf-8`（README 已注明）。
+- 便携版打包 spec（`requirements.spec`）：原写死绝对路径且**漏收运行期资源与新模块** ——
+  现改用 `SPECPATH` 推导，`datas` 补 `foolproof.composition.json`、`LICENSE`、
+  `tools/everything/`（ES 后端要用），`hiddenimports` 显式列出插件清单里按字符串动态导入的模块
+  （`core.events`/`core.tasklog`/`core.audit`/`core.runtime`/`index.service`/`plugins.*`）——
+  这类遗漏只在冻结版运行时才暴露，已实测修复（重建 exe 后 `cli list`/`doctor`/`envs` 全部 exit 0）。
+
+- 自研包随源仓库改名：`alloy` → `allin-engine`。an-engine 于 2026-09-19 把包名与模块名由 `alloy` 改为 `allin_engine`（PyPI 项目名 `allin-engine`）。本清单同步：「🏠 本地 / 自研包」条目由 `"alloy"` 改为 `"allin-engine"`（值仍为 `-e G:/repos/an-engine`）；「🛠️ 工具链」里同名的公开包 `alloy` 条目移除 —— 它本就是 PyPI 上的同名不同项目（Elide 的 High-performance runtime）。
+- **value 现支持 pip 选项前缀**（`shlex.split()`）：可写 `"-e G:/repos/an-engine"` 实现 editable 安装。两个自研包已切换到 `-e` 模式（都在活跃开发中，editable 更顺手）。已实测 `pip install --dry-run -e G:/repos/an-engine` → `Would install alloy-1.0.0`。
+- `shlex` 模式按输入自适应：含引号 → `posix=True`；无引号但含反斜杠 → `posix=False`（否则 `G:\repos` 会被吃掉分隔符且**不报错**）；其余 → `posix=True`。路径建议写正斜杠最省心。
+- 接入自研包：「🏠 本地 / 自研包」收录 `alloy` → `G:/repos/an-engine`（统一游戏引擎 v1.0.0）、`bloodmusic` → `G:/repos/audio-generation`（程序化音频合成引擎 v2.0.0），值为本地仓库路径。
+- **新增本地路径型 value 支持**：`requirements_categories.json` 的值原为 PyPI 包名，现允许写本地路径。安装照常 `pip install <路径>`；而 `pip show` / `pip uninstall` 需要的是包名，故新增 `cli.pip_query_name()`，路径型 value 自动回退到显示名（GUI 与 CLI 共用）。已实测：`pip install --dry-run G:/repos/an-engine` → `Would install alloy-1.0.0`。
+- **修复 CLI 忽略 value 的缺陷**：`cli.py` 原先把分类内层 dict 的**键**当作 pip 包名，导致 `value` 形同虚设——带 extras 的条目（如 `fastapi[all]`）装成裸包，`--category` 批量安装同样受影响。现改为用 `value` 安装、用包名检查/卸载。
+- 明确「🏠 本地 / 自研包」判定标准：**联网（PyPI / GitHub / Gitee）搜不到同名同项目**才算自研，仅凭包名眼生不算，PyPI 同名不同项目也不算。原 9 个条目逐包联网核验后**无一属自研** —— `alloy` 在 PyPI 上是 Elide 的 "High-performance runtime"（作者 Sam Gammon），与本地自研的 `an-engine`/alloy 无关；其归属最终由自研仓库接入（见上条）。
+- 9 个包按实际来源归位：`alloy` · `ast_serialize`（mypyc 官方）· `offshoot`（SerpentAI 插件系统）→ 工具链；`udapi` · `udtools`（Universal Dependencies）→ 自然语言处理；`datarecorder`（g1879/DrissionPage 生态）→ 爬虫网络；`sswg`（静态网站生成器）→ Web 开发；`pyvers`（依赖多版本管理）→ 打包构建；`groovy`（gradio-app 的 SSRF 防护）→ 加密安全。
+- 「🏠 本地 / 自研包」转为**手动维护**分类：自动扫描因 `_pypi_exists()` 过滤掉 PyPI 上不存在的包，纯自研包天然无法被收录（这正是 `bloodmusic` 从未出现在清单中的原因），故需手动加入；已收录 `bloodmusic`。
+- 全量核验：自动归类的 760 个包在 PyPI 均可查询（0 个 404）；手动收录的 `bloodmusic` 为 PyPI 404，属预期。
+- ComfyUI 生态归位：`comfy-aimdo` · `comfy-angle` · `comfy-kitchen` 与 `comfyui-*` 系列同属 `comfy*` 前缀，整组归入「🤖 AI / 机器学习」（共 14 个），不再按包名拆分。
+- 分类体系整理：全盘扫描积累在「🔍 自动发现」的 601 个包全部归入 24 个功能分类。新增 9 类——GUI 桌面、音频音乐、LLM Agent、安全渗透、逆向二进制、文档文本、科学计算、打包构建、本地自研包；213 个传递依赖单独归入「📦 传递依赖」，不再混入精选分类。分类总数 15 → 25，条目 764 → 761（剔除 4 条跨分类重复项 + 手动新增 1 条自研包 `bloodmusic`）。
+- 修复 `httpx` / `aiohttp` 同时存在于「🕷️ 爬虫 / 网络」与「⚡ 异步 / 并发」的重复收录问题；该重复会导致 GUI 勾选状态互相覆盖（UI 以包名为 key）。
+- 「🔍 自动发现」分类保留为空，继续作为后续扫描的落点。
+- 新增 `classify_auto.py`（dry-run 默认 / `--write` 落盘），承载本次归类映射表，可复现、可增量复用。
+- 文档同步：README / README.en 的分类数与脚本名更正为 `requirements.py`。
+- 与 siwpan/requirements 归一同源：合入其更新版本的工具链与打包 spec（requirements.py 重试/镜像工具链；2026-08-27 深度审核 R6——两仓实为同一项目「傻瓜式操作」，requirements 仓已退役改名 requirements-legacy）。
+
+## [1.0.0] - 2026-08-27
+
+### Added
+
+- 首个发行版：便携源码 zip（剔除 .venv/构建产物/输出物，依赖见 README）。
+- 发布面：gitee [siwpan/foolproof-operation](https://gitee.com/siwpan/foolproof-operation) release `v1.0.0`（依赖库安装器 v1.0.0）。

foolproof_operation-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 siwpan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

foolproof_operation-1.1.1/MANIFEST.in

@@ -0,0 +1,31 @@
+# sdist 清单（wheel 内容由 pyproject.toml 的 package-data 白名单控制）
+#
+# 原则：源码包只装「构建与运行需要的东西 + 文档」，**不带运行期产物**
+# （失败日志.txt / 重试安装日志.txt / *.bak-* / 基准 JSON / __pycache__ / build / dist）。
+
+include LICENSE
+include README.md
+include README.en.md
+include CHANGELOG.md
+include pyproject.toml
+include requirements.txt
+include requirements.spec
+include requirements-dbg.spec
+
+recursive-include foolproof_operation *.py *.json *.md *.exe
+recursive-include docs *.md
+recursive-include tests *.py
+
+# 运行期产物与本地杂物：一律不进 sdist
+exclude 失败日志.txt
+exclude 重试安装日志.txt
+exclude 失败日志分析报告.md
+exclude mirror_retry_list.json
+exclude retry_candidates.json
+exclude retry_final_list.json
+exclude retry_install_list.json
+global-exclude *.py[cod] *.bak *.bak-* __pycache__/*
+prune build
+prune dist
+prune .venv
+prune .gitee

foolproof_operation-1.1.1/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: foolproof-operation
+Version: 1.1.1
+Summary: Python 依赖库安装器（tkinter GUI + CLI）：分类管理、批量安装/卸载/更新、pip 健康检查，以及基于 NTFS USN/MFT 索引的全盘环境发现
+Author: siwpan
+License: MIT
+Project-URL: Homepage, https://gitee.com/siwpan/foolproof-operation
+Project-URL: Repository, https://gitee.com/siwpan/foolproof-operation
+Project-URL: Changelog, https://gitee.com/siwpan/foolproof-operation/blob/master/CHANGELOG.md
+Keywords: python,pip,package-manager,tkinter,gui,environment-discovery,usn,mft,ntfs,everything
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Python 依赖库安装器
+
+> 仓库：<https://gitee.com/siwpan/foolproof-operation> ｜ 许可：MIT（见 [LICENSE](LICENSE)）
+> 注：文中 <PATH> 为路径占位符，请替换为你本机实际的目录 / 可执行文件路径。
+
+图形化 Python 依赖库管理工具：**24 个功能分类、761 个库**，另设「🔍 自动发现」桶承接待归类项。
+
+## 功能
+
+- **分类管理** — 24 大功能分类、761 个库：游戏开发 / AI 机器学习 / LLM Agent / Web 开发 / 爬虫网络 / 数据可视化 / 数据库 / 图像音视频 / 音频音乐 / 办公自动化 / GUI 桌面 / 异步并发 / 加密安全 / 安全渗透 / 逆向二进制 / 工具链 / 打包构建 / 自然语言处理 / 文档文本 / 科学计算 / 云服务 DevOps / 自动化测试 / 本地自研包 / 传递依赖
+- **自动发现分类** — 全盘扫描到的、尚未归类的包会落入「🔍 自动发现」（当前 3 条待归类），等待人工归类
+- **本地 / 自研包** — 判定标准是「联网（PyPI / GitHub / Gitee）搜不到同名同项目」，仅凭包名眼生不算，PyPI 上有同名不同项目也不算（如 `alloy` 在 PyPI 上是 Elide 的 runtime，与本地自研版无关）。已收录 `allin-engine`（<PATH>，统一游戏引擎，2026-09-19 由 alloy 改名）、`bloodmusic`（<PATH>），值均为本地仓库路径。
+- **批量安装** — 勾选库名一键安装，支持 pip install -U
+- **批量卸载** — 勾选库名一键卸载
+- **版本检查** — 一次检查所有选中库的安装状态和更新情况
+- **一键更新** — 批量更新选中库到最新版
+- **pip 健康检查** — 启动自动检测 pip 状态，支持三种修复方案
+- **全盘扫描** — 扫描系统中的所有 Python 环境及已安装包
+- **环境发现（索引驱动）** — 基于本机 NTFS 的 USN/MFT 元数据索引做环境发现，
+  可覆盖目录名启发式看不见的深层 venv；索引不可用时**显式回退** Everything / 目录遍历
+- **requirements.txt 支持** — 读取任意目录的 requirements.txt，可视化勾选安装
+- **任务日志与启动审计** — 安装/卸载/检查/建库/发现等操作写入 JSONL 流水（`cli tasks` 查看）；
+  `cli doctor` 一次核完插件清单、分类清单、索引状态、检索后端与日志可写性（只读检查）
+- **GUI 面板** — 「📋 任务日志」（按事件过滤 / 只看失败 / 清空）与「🐍 环境发现」
+  （候选环境列表 + 来源后端 + 索引状态 + 一键建库 / 增量同步，均走后台线程不卡界面）
+
+## 快速开始
+
+```bash
+# 纯标准库 + tkinter，无需额外依赖
+python requirements.py
+
+# 指定目标 Python 解释器（默认使用运行本工具的 Python）
+python requirements.py --python python
+```
+
+## 命令行接口（cmd / PowerShell 直接可用）
+
+`python requirements.py cli <子命令>`，无 `cli` 参数时仍打开图形界面：
+
+```bash
+python requirements.py cli list                     # 列出全部分类与库名
+python requirements.py cli list --category 加密      # 只列某个分类（可省略 emoji/写片段）
+python requirements.py cli install requests aiohttp  # 安装指定库
+python requirements.py cli install --category Web     # 安装整个分类
+python requirements.py cli install --file req.txt     # 按 requirements.txt 安装
+python requirements.py cli install --all --upgrade    # 全量安装并升级
+python requirements.py cli uninstall requests         # 卸载
+python requirements.py cli check --category 数据库     # 版本与更新检查
+python requirements.py cli scan                       # 扫描全盘 Python 环境（原 glob 口径）
+python requirements.py cli envs                       # 环境发现（索引驱动，覆盖深层 venv）
+python requirements.py cli envs --build               # 同上，索引缺失时先建索引（只读卷）
+python requirements.py cli envs --deep --json e.json  # 逐个真跑解释器验证 + 落 JSON
+python requirements.py cli envs --backend walk --volumes <PATH>   # 指定兜底遍历目录
+python requirements.py cli es -n 20 "*.py"            # Everything 搜索（内置 es.exe）
+python requirements.py cli doctor                     # 启动审计：清单/分类/索引/后端/日志
+python requirements.py cli tasks                      # 任务日志（JSONL 操作流水）
+```
+
+- `install/uninstall/check` 可用 `--python <exe>` 指定目标解释器；
+- `es` 需本机 Everything 主程序/服务在运行（详见 `foolproof_operation/foolproof_operation/foolproof_operation/tools/everything/README.md`，
+  ES 为 MIT © voidtools）；
+- `scan` 是历史口径（glob + 目录名启发式，会漏深层 venv）；`envs` 走
+  `foolproof.composition.json` 装配的插件，按 **index → es → walk** 依次回退，
+  并打印「是哪个后端答的」与失败原因（缺索引 / Everything 未运行 / 拒绝整盘遍历等）。
+- `envs` 的 `--volumes` 传给遍历后端时请写**具体目录**：盘符根（`G:\`）会触发整盘遍历
+  （分钟~小时级），默认被拒绝，确需整盘请显式加 `--allow-whole-drives`。
+- 分类名自带 emoji；若你的控制台是 GBK 代码页（Windows 中文默认 936），emoji 会退化成 `?`
+  （命令不会崩）；想完整显示先执行 `set PYTHONIOENCODING=utf-8`。
+
+## 配置
+
+编辑 `foolproof_operation/requirements_categories.json` 增删分类和库名。格式为 `{"显示名": "pip 安装目标"}`：
+
+- **普通包**：值写 PyPI 包名，可带 extras，如 `"fastapi": "fastapi[all]"`；
+- **自研 / 本地包**：值写本地仓库路径，如 `"bloodmusic": "<PATH>"`。安装时执行
+  `pip install <路径>`；版本检查与卸载需要包名，会自动回退用显示名（见 `cli.pip_query_name()`）。
+- **pip 选项前缀**：值经 `shlex.split()` 解析，可带选项，如 `"-e <PATH>"`
+  （editable 安装）。路径建议用正斜杠；含空格时用双引号包裹，如 `'-e "<PATH> pkg"'`。
+
+「🏠 本地 / 自研包」是**手动维护**分类：全盘扫描会跳过 PyPI 上不存在的包，纯自研包不会被自动收录。
+
+## 依赖
+
+- Python >= 3.8 + tkinter (标准库)

foolproof_operation-1.1.1/README.en.md

@@ -0,0 +1,94 @@
+# Python Dependency Installer (foolproof-operation)
+
+> Repository: <https://gitee.com/siwpan/foolproof-operation> | License: MIT (see [LICENSE](LICENSE))
+> Note: `<PATH>` is a placeholder for a directory / executable path — replace it with the real one on your machine.
+
+A tkinter GUI tool for managing **761 Python packages across 24 functional categories**, plus an
+"🔍 Auto-discovery" bucket for packages that are not filed yet.
+
+## Features
+
+- **Category management** — 24 functional categories, 761 packages: game dev / AI & ML / LLM agents / web / scraping & networking / visualization / database / image & media / audio & music / office automation / GUI & desktop / async & concurrency / crypto & security / pentesting / reverse engineering / toolchain / packaging & build / NLP / document & text / scientific computing / cloud & DevOps / automated testing / local in-house packages / transitive dependencies
+- **Auto-discovery bucket** — packages found by a full-disk scan that are not filed anywhere yet land in "🔍 Auto-discovery" (3 awaiting triage), waiting for manual sorting
+- **Local / in-house packages** — the test is "no same-name, same-project match on PyPI / GitHub / Gitee"; an unfamiliar name alone does not qualify, and a same-name-but-different project on PyPI does not qualify either (e.g. `alloy` on PyPI is Elide's runtime, unrelated to the local in-house engine). Currently listed: `allin-engine` (`<PATH>`, the unified game engine, renamed from `alloy` on 2026-09-19) and `bloodmusic` (`<PATH>`); both values are local repository paths.
+- **Batch install** — tick packages and install them in one go, supports `pip install -U`
+- **Batch uninstall** — tick packages and uninstall them in one go
+- **Version check** — check install state and available updates for every selected package at once
+- **One-click upgrade** — batch-upgrade the selected packages to their latest versions
+- **pip health check** — pip state is checked on startup, with three repair paths
+- **Full-disk scan** — scan every Python environment on the machine and the packages installed in it
+- **Index-driven environment discovery** — discovers environments from the local NTFS USN/MFT metadata
+  index, so deep virtualenvs that name-based heuristics never see are still found; when the index is
+  unavailable it **falls back explicitly** to Everything / directory walking
+- **requirements.txt support** — read a `requirements.txt` from any directory and tick packages to install
+- **Task log and startup audit** — install / uninstall / check / index-build / discovery runs are appended
+  to a JSONL history (`cli tasks`), and `cli doctor` checks the plugin manifest, category manifest, index
+  state, search backends and log writability in one read-only pass
+- **GUI panels** — "📋 Task log" (filter by event / failures only / clear) and "🐍 Environment discovery"
+  (candidate list with the answering backend, index state, one-click index build / incremental sync; all
+  work runs in background threads so the window stays responsive)
+
+## Quick start
+
+```bash
+# stdlib + tkinter only, no extra dependencies
+python requirements.py
+
+# target a different Python interpreter (defaults to the Python running this tool)
+python requirements.py --python python
+```
+
+## Command-line interface (works directly in cmd / PowerShell)
+
+`python requirements.py cli <subcommand>`; running without `cli` still opens the GUI:
+
+```bash
+python requirements.py cli list                     # list every category and package
+python requirements.py cli list --category crypto    # list one category (emoji optional / partial match)
+python requirements.py cli install requests aiohttp  # install the given packages
+python requirements.py cli install --category Web     # install a whole category
+python requirements.py cli install --file req.txt     # install from a requirements.txt
+python requirements.py cli install --all --upgrade    # install everything, upgraded
+python requirements.py cli uninstall requests         # uninstall
+python requirements.py cli check --category database  # version and update check
+python requirements.py cli scan                       # scan for Python environments (original glob path)
+python requirements.py cli envs                       # index-driven environment discovery (deep venvs)
+python requirements.py cli envs --build               # same, building the index first if missing (read-only)
+python requirements.py cli envs --deep --json e.json  # verify each interpreter for real + dump JSON
+python requirements.py cli envs --backend walk --volumes <PATH>   # specify directories for walk fallback
+python requirements.py cli es -n 20 "*.py"            # Everything search (bundled es.exe)
+python requirements.py cli doctor                     # startup audit: manifest/categories/index/backends/log
+python requirements.py cli tasks                      # task log (JSONL operation history)
+```
+
+- `install` / `uninstall` / `check` accept `--python <exe>` to pick the target interpreter;
+- `es` requires the Everything app/service to be running on this machine (see
+  `foolproof_operation/foolproof_operation/foolproof_operation/tools/everything/README.md`; ES is MIT © voidtools);
+- `scan` is the historical path (glob + directory-name heuristics, misses deep virtualenvs); `envs`
+  runs the plugins composed by `foolproof.composition.json`, falling back **index → es → walk** and
+  printing which backend answered plus why the others did not (no index / Everything not running /
+  whole-drive walk refused, …).
+- With `envs`, pass `--volumes` **directories** to the walk fallback: a drive root (`G:\`) means a
+  whole-volume walk (minutes to hours) and is refused by default — add `--allow-whole-drives` if you
+  really mean it.
+- Category names carry emoji; on a GBK code page (Windows Chinese default 936) they degrade to `?`
+  instead of crashing the command. Run `set PYTHONIOENCODING=utf-8` first to render them fully.
+
+## Configuration
+
+Edit `foolproof_operation/requirements_categories.json` to add or remove categories and packages. The format is
+`{"Display name": "pip install target"}`:
+
+- **Ordinary packages**: the value is a PyPI package name, optionally with extras, e.g. `"fastapi": "fastapi[all]"`;
+- **In-house / local packages**: the value is a local repository path, e.g. `"bloodmusic": "<PATH>"`. Install
+  runs `pip install <path>`; version checks and uninstalls need a package name, so they fall back to the
+  display name (see `cli.pip_query_name()`).
+- **pip option prefixes**: the value goes through `shlex.split()`, so options are allowed, e.g. `"-e <PATH>"`
+  (editable install). Prefer forward slashes in paths; quote paths containing spaces, e.g. `'-e "<PATH> pkg"'`.
+
+"🏠 Local / in-house packages" is a **manually maintained** category: the full-disk scan skips packages that
+do not exist on PyPI, so purely in-house packages are never auto-collected.
+
+## Dependencies
+
+- Python >= 3.8 + tkinter (stdlib)

foolproof_operation-1.1.1/README.md

@@ -0,0 +1,85 @@
+# Python 依赖库安装器
+
+> 仓库：<https://gitee.com/siwpan/foolproof-operation> ｜ 许可：MIT（见 [LICENSE](LICENSE)）
+> 注：文中 <PATH> 为路径占位符，请替换为你本机实际的目录 / 可执行文件路径。
+
+图形化 Python 依赖库管理工具：**24 个功能分类、761 个库**，另设「🔍 自动发现」桶承接待归类项。
+
+## 功能
+
+- **分类管理** — 24 大功能分类、761 个库：游戏开发 / AI 机器学习 / LLM Agent / Web 开发 / 爬虫网络 / 数据可视化 / 数据库 / 图像音视频 / 音频音乐 / 办公自动化 / GUI 桌面 / 异步并发 / 加密安全 / 安全渗透 / 逆向二进制 / 工具链 / 打包构建 / 自然语言处理 / 文档文本 / 科学计算 / 云服务 DevOps / 自动化测试 / 本地自研包 / 传递依赖
+- **自动发现分类** — 全盘扫描到的、尚未归类的包会落入「🔍 自动发现」（当前 3 条待归类），等待人工归类
+- **本地 / 自研包** — 判定标准是「联网（PyPI / GitHub / Gitee）搜不到同名同项目」，仅凭包名眼生不算，PyPI 上有同名不同项目也不算（如 `alloy` 在 PyPI 上是 Elide 的 runtime，与本地自研版无关）。已收录 `allin-engine`（<PATH>，统一游戏引擎，2026-09-19 由 alloy 改名）、`bloodmusic`（<PATH>），值均为本地仓库路径。
+- **批量安装** — 勾选库名一键安装，支持 pip install -U
+- **批量卸载** — 勾选库名一键卸载
+- **版本检查** — 一次检查所有选中库的安装状态和更新情况
+- **一键更新** — 批量更新选中库到最新版
+- **pip 健康检查** — 启动自动检测 pip 状态，支持三种修复方案
+- **全盘扫描** — 扫描系统中的所有 Python 环境及已安装包
+- **环境发现（索引驱动）** — 基于本机 NTFS 的 USN/MFT 元数据索引做环境发现，
+  可覆盖目录名启发式看不见的深层 venv；索引不可用时**显式回退** Everything / 目录遍历
+- **requirements.txt 支持** — 读取任意目录的 requirements.txt，可视化勾选安装
+- **任务日志与启动审计** — 安装/卸载/检查/建库/发现等操作写入 JSONL 流水（`cli tasks` 查看）；
+  `cli doctor` 一次核完插件清单、分类清单、索引状态、检索后端与日志可写性（只读检查）
+- **GUI 面板** — 「📋 任务日志」（按事件过滤 / 只看失败 / 清空）与「🐍 环境发现」
+  （候选环境列表 + 来源后端 + 索引状态 + 一键建库 / 增量同步，均走后台线程不卡界面）
+
+## 快速开始
+
+```bash
+# 纯标准库 + tkinter，无需额外依赖
+python requirements.py
+
+# 指定目标 Python 解释器（默认使用运行本工具的 Python）
+python requirements.py --python python
+```
+
+## 命令行接口（cmd / PowerShell 直接可用）
+
+`python requirements.py cli <子命令>`，无 `cli` 参数时仍打开图形界面：
+
+```bash
+python requirements.py cli list                     # 列出全部分类与库名
+python requirements.py cli list --category 加密      # 只列某个分类（可省略 emoji/写片段）
+python requirements.py cli install requests aiohttp  # 安装指定库
+python requirements.py cli install --category Web     # 安装整个分类
+python requirements.py cli install --file req.txt     # 按 requirements.txt 安装
+python requirements.py cli install --all --upgrade    # 全量安装并升级
+python requirements.py cli uninstall requests         # 卸载
+python requirements.py cli check --category 数据库     # 版本与更新检查
+python requirements.py cli scan                       # 扫描全盘 Python 环境（原 glob 口径）
+python requirements.py cli envs                       # 环境发现（索引驱动，覆盖深层 venv）
+python requirements.py cli envs --build               # 同上，索引缺失时先建索引（只读卷）
+python requirements.py cli envs --deep --json e.json  # 逐个真跑解释器验证 + 落 JSON
+python requirements.py cli envs --backend walk --volumes <PATH>   # 指定兜底遍历目录
+python requirements.py cli es -n 20 "*.py"            # Everything 搜索（内置 es.exe）
+python requirements.py cli doctor                     # 启动审计：清单/分类/索引/后端/日志
+python requirements.py cli tasks                      # 任务日志（JSONL 操作流水）
+```
+
+- `install/uninstall/check` 可用 `--python <exe>` 指定目标解释器；
+- `es` 需本机 Everything 主程序/服务在运行（详见 `foolproof_operation/foolproof_operation/foolproof_operation/tools/everything/README.md`，
+  ES 为 MIT © voidtools）；
+- `scan` 是历史口径（glob + 目录名启发式，会漏深层 venv）；`envs` 走
+  `foolproof.composition.json` 装配的插件，按 **index → es → walk** 依次回退，
+  并打印「是哪个后端答的」与失败原因（缺索引 / Everything 未运行 / 拒绝整盘遍历等）。
+- `envs` 的 `--volumes` 传给遍历后端时请写**具体目录**：盘符根（`G:\`）会触发整盘遍历
+  （分钟~小时级），默认被拒绝，确需整盘请显式加 `--allow-whole-drives`。
+- 分类名自带 emoji；若你的控制台是 GBK 代码页（Windows 中文默认 936），emoji 会退化成 `?`
+  （命令不会崩）；想完整显示先执行 `set PYTHONIOENCODING=utf-8`。
+
+## 配置
+
+编辑 `foolproof_operation/requirements_categories.json` 增删分类和库名。格式为 `{"显示名": "pip 安装目标"}`：
+
+- **普通包**：值写 PyPI 包名，可带 extras，如 `"fastapi": "fastapi[all]"`；
+- **自研 / 本地包**：值写本地仓库路径，如 `"bloodmusic": "<PATH>"`。安装时执行
+  `pip install <路径>`；版本检查与卸载需要包名，会自动回退用显示名（见 `cli.pip_query_name()`）。
+- **pip 选项前缀**：值经 `shlex.split()` 解析，可带选项，如 `"-e <PATH>"`
+  （editable 安装）。路径建议用正斜杠；含空格时用双引号包裹，如 `'-e "<PATH> pkg"'`。
+
+「🏠 本地 / 自研包」是**手动维护**分类：全盘扫描会跳过 PyPI 上不存在的包，纯自研包不会被自动收录。
+
+## 依赖
+
+- Python >= 3.8 + tkinter (标准库)