前言
以前总有一些想做但是没做的小工具，想法攒了一堆，真到动手的时候又开始嫌麻烦：要搭环境、要写界面、要处理各种系统差异，最后往往就放下不了了之。然后最近有时间的时候，就在家让AI来实现，我只负责出需求和核对检测，然后使用了一段时间之后，我觉得这些插件功能不错，于是想分享一下，但是这次不想手写博客了，顺便让AI根据我的风格写出了这篇博客，。
一、先说下这三款插件是做什么的
三个插件都放在同一个仓库里，用的是 uTools 的插件规范，装完之后在主输入框里敲一个词就能打开。
- 电脑配置体检：读取本机的 CPU、内存、硬盘、显卡、主板和系统信息，给出性能评分、与主流配置的对比、硬件天梯榜的排名定位，以及升级建议；
- 开发配置速查：把散落在各处的开发配置文件一次性找齐，包含 Git/SSH、npm/yarn/pnpm/nvm、Maven/Gradle、hosts，以及 Codex、Qoder、WorkBuddy、Trae、VS Code 这些 AI 工具和编辑器的配置；
- 电脑空间管家：磁盘占用分析、大文件排行、重复文件识别、视频与图片的压缩瘦身、垃圾清理、软件搬家、内存与进程查看、游戏目录分析、文件夹整理。
整体思路其实很朴素：把"我自己会用到"这件事放在第一位，界面尽量一眼看懂，涉及删除这类操作就多设一道关卡。 下面分别说一下每个插件的功能和用法。
二、为什么要做这三个插件
这三个插件都不是"想到了才做"的，每一个背后都对应一件真实的麻烦事。
1. 我的主力机想升级，但不知道先换哪个
我这台机器是 i5-8400 + 8G 单通道内存 + 机械硬盘 + GTX 1050 Ti，用了好几年了，一直想升级，但每次打开购物网站又犹豫：先换 CPU 还是先加内存？换显卡值不值？
网上的跑分软件也用过一些，要么是给整机打一个看不懂的分数，要么是硬件信息列了一堆但看不出好坏，用完之后问题还在。所以我想要的东西其实很简单：告诉我这台机器处在什么水平、最该换的是什么。
2. 每次换电脑、装新工具，配置都找不到
配置文件的麻烦在于它太散了。.gitconfig 在家目录，.npmrc 在家目录（有时候也在项目里），Maven 在 .m2 下面，hosts 在系统目录，前端还有 yarn、pnpm、nvm 各自的一份；
这两年 AI 工具多了之后更夸张，Codex、Qoder、WorkBuddy、Trae、Cursor 每家都有自己的配置目录和规则文件。
所以我想要的也很简单：有个地方能一次看全，能搜、能定位，需要改的时候能直接改。
3. C 盘又红了，但清理软件不太敢用
清理类的软件我用过一些，最不放心的就是它删东西之前不告诉你要删什么，点一下"一键清理"，几十 G 就没了，也不知道删的是什么。而我真正想清理的往往是"那个 10G 的录屏文件"这种具体的东西，不是系统猜出来的垃圾。
所以空间管家的定位从一开始就很明确：先让我看清有什么可以清，再让我一条条确认。
三、我是怎么用 AI 把插件写出来的
这部分应该是这篇博客里最有价值的部分了。三个插件我是用 WorkBuddy 这类能直接读写本地代码的AI 编程助手做的，整个过程和我以前自己写代码的路子差别挺大，我大概分成这么几步。
1. 先讲清楚"我要什么"，而不是先讲怎么写
我以前用 AI 就是丢一句"帮我写个功能"，然后来回改，改到最后它也不知道我到底想要什么。 这次我换了个方式，一开始就跟它把三件事讲清楚：
- 场景：什么时候会用到（比如"C 盘满了，我想先看看哪个目录最占空间"）；
- 界面：我打开插件第一眼要看到什么（比如"首页不要一进来就扫描，先给我几个任务入口"）；
- 标准：什么叫做好了（比如"系统盘用了 80% 以上要说出来""机械硬盘要明确告诉我是瓶颈"）。
这三件事讲清楚之后，AI 给出的东西基本就是我想要的样子，剩下的是细节调优。 我后来发现，插件页面的布局、配色、交互这些它做得比我快，我不用在这一块花时间了。
2. 让它先去查官方文档，别自己造轮子
uTools 已经内置了不少能力，比如 FFmpeg 7.1 做音视频处理、Sharp 做图像处理，这些通过插件 API 直接调用就行，不需要自己引入依赖。
所以我给它定了条规矩：写功能之前先去查 uTools 的 API 文档有没有现成的。
后来我还让它把官方文档整个抓成离线副本放进仓库，这样后面每次做新功能，它都能先查一遍再动手。空间管家里的视频压缩就是直接用 utools.runFFmpeg 做的，连压缩进度都是官方接口自带的，省了很多事。
3. 让它顺手把自测脚本和截图脚本也写了
这是我觉得最值的一步。
AI 写代码很快，但如果你只是让它一直加功能，不出一周自己就不敢改了——因为你不知道哪里坏了。 所以我让它每写一块功能，就顺手写一个能跑的验证脚本。现在仓库里是这样分层的：
- 数据层：纯 Node 脚本，验证数据表是否完整、搜索口径对不对；
- 桥接层：把 uTools 的接口打桩，验证文件读写和安全约束；
- 界面层：用无头浏览器把真实页面跑起来，模拟真实点击，再看状态有没有变。
界面这一层我觉得特别有用，因为很多问题静态看代码是看不出来的。脚本在后台跑一遍，报告里会写清楚哪一项没过，比我自己一个个点快多了。
商店截图也是同理。我让 AI 把截图也做成脚本：先用无头浏览器打开页面、切到指定的标签页、把窗口高度开大、截图，最后再把底部多余的空白裁掉。现在要更新素材，改一行配置重新跑一次就行，十几张图自动生成，不用我一张张去截。
4. 跑真实数据，口径由我来定
AI 很会算，但"什么才算好"这件事它不会替我做决定，这部分我一直是自己拍板的。
举个实际的例子：配置体检的评分，我定的口径是 100 分对应 2026 年的高端主流配置，综合分按处理器 30%、内存 20%、存储 20%、显卡 20%、系统 10% 加权。 这个权重是我按自己的使用感受定的，不是它算出来的。
再比如天梯榜，我坚持只用消费级的数据——服务器 CPU 不放进榜单，否则家用机的位置会被压得过低；拿不到公开评测数据的型号，界面上会标一个 ≈，说明这是推算值，不能当成精确成绩去引用。
空间管家那边也是一样。删除这个能力它做得很顺手，但我给它定的规则是： 只允许删除本次会话里出现过的文件、默认只能删到回收站、彻底删除默认关闭、执行前必须逐条勾选确认。这些不是技术问题，是"要不要为用户的误操作负责"的问题，这种取舍我不放心交给 AI。
5. 按版本迭代，需求我来提
三个插件都不是一次写完的，基本是"自己用几天，发现不顺手就改"。举几个我自己提的需求：
- 空间管家打开就自动扫描太吵了，改成打开不扫描，首屏先给任务入口（v1.2.0 → v1.3.0）；
- 压缩完之后产物不知道跑哪去了，改成写回源文件所在目录，并按分辨率命名，比如
1.mp4→1-720p.mp4（v1.2.0）； - 大文件页只能一个个勾太累，加了全选本页、勾选当前筛选全部，还有跨页累积（v1.3.0）；
- 配置体检做完之后少一个"横向比"的参考，加了硬件天梯榜，能看自己的机器排在第几（v1.1.0）。
提需求这个过程反而变简单了，因为不用再组织语言去描述实现，直接把感受说出来就行。
6. 一点体会
用了这段时间，我最大的感受是：AI 很强，但它没有主观。
强的地方在于，写界面、处理各种系统差异、写脚本这些我以前嫌烦的活，它做得比我快； 不强的地方在于，它不知道"这个功能做出来会不会让人误删文件"，也不知道"这个评分口径对用户是不是公平"。这些还是得人来定。
所以我现在的分工是：它写代码，我定规则和验收。它写完我不做逐行 review，但我会自己跑一遍、用真实数据看结果对不对，发现不对就说清楚哪里不对，让它改。 这样留一步参与感也挺好的，至少我知道自己的东西是怎么实现的。
四、电脑配置体检
这个插件的核心就是把系统信息采集上来之后，翻译成人能看懂的话。
打开之后第一屏就是结论，不绕弯子：
我随便拿自己的旧机器举例：综合评分 35 分，定位在"入门办公"档位，每张评分卡除了分数之外，还会给一句解释，比如存储那一项直接写着"系统跑在机械硬盘上是整机最严重的瓶颈"。
对比页是把本机放到几个档位里横向比：
从入门办公到旗舰一共五档，每一档给出参考配置和分数差距，这样一眼就能看出来"再加多少钱能到什么水平，值不值"。
天梯榜是我个人最喜欢的一块，能看出来自己的机器在市场上是什么位置：
一共有五个榜单：CPU 多核、CPU 单核、显卡、内存、硬盘，加起来两百多条数据。 本机会带着"本机"的标记直接插进榜单里，卡片上会写明"第 57 / 63 名， 超过 10% 的机型"。
五、开发配置速查
这个插件解决的是"配置文件在哪"和"顺手改一下"这两件事。
一共整理了 9 个分类 55 条配置，左边是分类树，右边是详情。顶部可以搜索，也可以用"仅存在""仅敏感"这类筛选条件把列表收窄。每条后面有个小圆点表示这台机器上有没有这个文件，敏感的条目会带一把锁。
我这两年配置里放的东西越来越多，密钥和凭据也不少，所以这个插件在安全上做了几件事：
- 像 SSH 私钥、Git 凭据、各家 AI 工具的授权信息这类文件，会被自动识别出来， 预览默认打码，要看的话得手动点一下；
- 敏感文件不提供内置编辑，只保留"用系统程序打开"的引导；
- 可编辑的配置文件，每次保存之前自动备份一份，保留最近 20 份，随时可以还原；
- 如果文件在插件读取之后被别的程序改过，保存会中止并提示，不会覆盖别人的改动。
平时比较常用的其实是"复制路径"：知道配置在哪之后，剩下的用编辑器去改更顺手。
六、电脑空间管家
这个插件是三个里面最花时间的，功能也最多，目前已经有十个页面。
首屏我没有做成扫描结果，而是做成了任务入口，因为我发现大多数时候我并不想扫全盘：
压缩、垃圾清理、软件搬家、内存与进程、游戏目录、文件夹整理都能直接开始，入口上还会带上实时的角标，比如"垃圾清理 已扫到 20.0 GB""软件搬家 可迁移 10 个"。 只有"磁盘占用分析"需要真的扫描一遍。
不扫描的时候首页是这样一个空状态，不会让人以为插件卡住了：
压缩是我用得最多的功能，可以直接挑单个文件、多个文件，也可以挑整个文件夹批量压：
方案表里会列出每个文件的分辨率、编码参数、预计压缩后的体积和节省比例， 最上面还能看到合计能省多少。几个我比较在意的点：
- 压缩结果写回源文件所在目录，并按分辨率命名，比如
1.mp4→1-720p.mp4， 图片 →封面-1920x1080.webp，不会再出现"压完了找不到文件"； - 永远输出到新文件，不会覆盖原文件，原文件保留还是清理由我自己决定；
- 这里的压缩都是视觉无损的思路，不是数学意义上的无损。 只要改分辨率或者重新编码就一定会丢信息，界面上也把这句话写在明面上了。
清理这块是我花心思最多的地方，因为删文件这事最容易出事：
删除之前一定会弹这么一张清单：每个文件的完整路径、体积、修改时间都列出来，合计能释放多少也写清楚，要勾上一句"我已逐条核对上述文件"才能点删除。 默认是删到系统回收站，想彻底删除还得单独开一个开关。被安全策略拦下来的文件也会列出来，说明为什么不能删，而不是悄悄少一项。
其他几个功能简单说一下：
- 垃圾清理：临时文件、浏览器缓存、Windows 更新残留、回收站这些，扫完给清单和体积；
- 软件搬家：把装在系统盘的程序迁到别的盘，原位置留一个链接，程序照旧从原来的路径启动， 不需要改注册表，中途失败会自动回滚，源目录始终可用；
- 内存与进程：按占内存排序看进程，可以直接结束占内存的大户。 这里要说句实话，内存是不能被"释放"的，只能通过结束进程来回收；
- 游戏目录：识别 Steam 和 Epic 的游戏库并统计占用，只做分析；
- 文件夹整理：把一个乱目录按类型或者时间归档到子文件夹里，执行前先给预览。
顺手说下性能，扫描这块我实测过：在自己用户目录下，56 万个文件、6.6 万个目录、45.2 GB， 大概 40.8 秒扫完，扫描过程中可以随时停。
七、怎么安装和使用
需要先装 uTools 和 uTools 开发者工具，两个都在官网可以下到。
- 打开 uTools 开发者工具，点"新建项目"，项目路径选择插件目录（就是包含
plugin.json的那一层）； - 点击"接入开发"；
- 回到 uTools 主输入框，输入插件对应的指令就能打开。
三个插件的常用指令如下：
| 插件 | 输入这些词可以打开 |
|---|---|
| 电脑配置体检 | 电脑信息 配置对比 天梯榜 升级建议 |
| 开发配置速查 | 配置文件 git配置 npm配置 maven配置 hosts AI配置 |
| 电脑空间管家 | 空间管家 磁盘空间 大文件 重复文件 压缩建议 垃圾清理 软件搬家 |
另外，这三个插件都注册了 AI 工具接口，也就是说可以直接在 AI 里问"我这台电脑什么水平""我的 npm 配置在哪"， 不需要手动打开插件。
