AI为什么被关掉了?磁盘空间对比工具 WhoShitsonMyC 的架构铁律与构建期模块化设计完整复盘

原创2026-11-03 16:22:331,894 阅读

AI为什么被关掉了?磁盘空间对比工具 WhoShitsonMyC 的架构铁律与构建期模块化设计完整复盘

WhoShitsonMyC 是一款 Windows 下的磁盘空间变化对比轻量小工具:先对目录扫描一份快照,过几天空间又莫名变少时再扫一次,两份快照一对比,谁在偷偷吃空间一目了然。v1.1.0 时它曾接入过一套完整的 AI 模块,但如今产品默认把 AI 整个关掉了。一个功能已经写完、测试齐备、打包参数都在的模块,为什么会被"下线"?这背后是一套值得每个小工具作者参考的模块化设计决策,本文做一次完整复盘。

先认识一下 WhoShitsonMyC

它的核心链路只有四步:新建扫描 → 得到快照 → 再扫一次 → 点对比。红色表示增长、绿色表示缩小,左侧是历史快照列表,右侧是对比树。

WhoShitsonMyC 磁盘空间变化对比工具中文界面,对比树显示 AppData 等目录容量增长明细

项目结构上刻意分成三层:core/ 是无 UI 的纯核心(扫描、快照、对比、压缩、删除黑名单),app.py 是 pywebview 桥接层,modules/ 则是构建期可选模块的存放处——AI 就住在这里。

AI 为什么被关掉了?

答案写在 README.md 里,坦率又真实:

目前 AI 的定位与功能并不清晰或可控,暂时不考虑将 AI 引入此工具。

作者原话是:「我们非常体会您的洁癖心理,不希望什么工具都无脑接入 AI,我们完全理解您的需求只是一个朴实无华的小工具。」AI 不是被"删"了,而是被产品策略下线——代码全部保留,只是启动与默认打包不再加载。具体关掉了什么,一张表说清:

位置 关闭后的行为
modules/__init__.py → discover() ENABLE_AI = False,不 import、不注册 AI 模块
app.py → _init_modules() 仍走模块发现,默认得到空表,日志打印 modules loaded: (none)
build.py python build.py 产出主线包自动排除 AI;--with-ai 仅留作维护/实验
requirements.txt httpx 依赖默认注释,不带 AI 就不必安装

关键设计点在于:"关闭"不是注释掉一堆代码,而是四个层面的开关同时落位。

三条架构铁律:先立规矩,再写代码

复盘要从设计之初讲起。assets/docs/ai-integration-plan.md 在动第一行代码前,先写下了三条"任何实现不得违背"的铁律,这是整个模块后来能被干净关掉的前提。

铁律一:AI 是共享服务,不是功能

provider 请求层不带任何业务语义,所有 AI 能力都是它的"消费者"。整层因此可以在构建期被完整排除——排除一个服务层,比拆除散落在各处的功能碎片干净得多。

铁律二:可选能力做成构建期模块,不做运行时插件

单 exe 形态下不加载外部代码。模块存不存在,在打包那一刻就决定了:build.py 用开关产出"带/不带模块"两种发行版。这避免了运行时插件带来的版本地狱与供应链风险。

铁律三:AI 永远无法触达删除执行路径

对一款会"动你硬盘"的工具来说,这条最要命。AI 的输出只能是文本建议或"提议加入待删除列表"(propose_pending_delete 这个唯一工具,见 modules/ai/tools.py),真正执行前必须经过独立于 AI 的规则校验 + 人工确认。模型说了不算,人说了才算。

隐私上同样划了硬边界:仅 BYOK(用户自填 provider 与 key),API Key 不落日志、不出现在 get_config 返回值里,首次使用还要弹窗取得用户同意。

构建期模块化是怎么落地的?四层防线

铁律是"为什么",这一节看"怎么做"。AI 模块的注册链路是一条清晰的流水线,任何一层断掉,AI 都无从出现。

第一层:发现开关 —— modules/init.py

modules/init.py 里的 discover() 是整个体系的总闸:ENABLE_AI = False 时直接返回空注册表;即便未来打开,import 失败(被打包排除、缺依赖)也只静默降级并写一条 WARN 日志,绝不拖垮主程序。

第二层:注册与白名单分发 —— app.py

app.py 启动时调 _init_modules() 把 discover() 的结果实例化,模块只拿到一个注入的 ctx(事件推送、数据目录、i18n、对比树子项读取),依赖方向严格单向:modules/* → core,核心对模块零 import。前端调用走统一的 module_invoke,且只放行模块实例上 PUBLIC_METHODS 白名单声明的方法——未知模块、未知方法一律返回 error,不给桥接层动态加方法,规避 pywebview 方法枚举时机不可控的坑。

第三层:前端门控 —— web/js/modules.js

web/js/modules.js 启动时调 list_modules() 拿到可用模块表,再对所有 data-module="ai" 元素加 module-off 类。后端没有 AI 模块时,设置页 AI 分节、右键"问 AI"、AI 侧栏全部保持隐藏,界面与没有 AI 的功能完全一致——前端文件不裁剪,全靠门控。

第四层:打包排除 —— build.py

build.py 中的 _AI_EXCLUDES 清单把 modules.ai 各子模块连同 httpx、anyio 等整个 HTTP 依赖栈一起排除;主线包连 AI 专用的前端 vendor 库(web/js/ai-vendor 的 marked / DOMPurify)都不打包。而 --with-ai 参数仍保留在脚本里,产物命名为 wsmc-ai-v*.exe,供日后实验包使用。

WhoShitsonMyC 磁盘空间对比工具英文界面,无 AI 模块时设置页与右键菜单均无 AI 入口

关掉但不删除:代码都留在哪

这是本文最想传递的第二个观点:默认关闭 ≠ 删除资产。AI 的全部代码原样保留,随时可按 assets/docs/ai-reenable.md 的五步重新接入:

  1. 把 modules/init.py 中 ENABLE_AI 改为 True
  2. 在 requirements.txt 取消 httpx 注释并安装
  3. 运行 python app.py,确认日志出现 modules loaded: ai
  4. (可选)python build.py --with-ai 打实验包
  5. python -m pytest tests/ -q 跑测试,AI 单测在 tests/test_ai_*.py 与 tests/test_modules.py

保留下来的资产清单:

文档也留了"不要做的事"清单:不要删代码、不要在开关未开时假设 list_modules 有 ai、不要把 --with-ai 当默认发布路径。

给小工具作者的 3 点启示 🧭

  1. 能力要能整体摘除,就先按"服务层"设计。 散落的 if 判断关不干净,独立的一层才能被 _AI_EXCLUDES 一行清单带走。
  2. 缺失即降级,是健壮性的来源。 import 失败 = 模块不存在 = 主程序照跑,用户无感。这条让"关掉 AI"零成本。
  3. 危险操作的边界要在架构层焊死。 AI 只提议、规则校验兜底、人工确认执行——对磁盘工具而言,这比任何提示词工程都重要。

延伸阅读

登录后查看全文
WhoShitsonMyC