1. “superpowers”到底指什么先别急着下载先想清楚你要解决什么问题最近这个词频繁出现在我的搜索记录里。搜“superpowers”跳出来的结果五花八门电影里的超级英雄能力解说、游戏里的技能树还有一个热搜词特别显眼——“想要安装superpowers”。这个“安装”用法很有意思它暗示很多人把superpowers当成一个可以直接装进电脑、装进脑子然后人就变强的软件。我能理解这种期待。就像我们下载一个工具就觉得自己掌握了新技能一样“安装”从心理上带来一种确定感。但作为折腾过很多自动化项目的人我得坦白说superpowers如果指代某一个具体软件那它大概率解决不了你想要的那种“变强”。真正的超能力是把自己重复做的事情拆掉把那些机器能干的、有规则的部分交出去让流程自己跑起来。这个系统才是可以“安装”的——只不过安装的不是一个程序而是一套思维方式和几个小工具的组合。这篇文章适合谁看适合那些已经试过用各种效率工具、自动化脚本给自己减负但最后发现工具装了一堆、流程没串起来的人。也适合刚接触个人效率系统、想从零搭建但又不想一上来就搞复杂框架的新手。我会把我在实践“superpowers”过程中的理解、架构、可以直接抄的配置以及翻车记录都摊开来讲。先说明我的基本立场我讲的“superpowers”不是某一个商业产品而是把个人工作流自动化的一个落地实践。你可以把它理解成“给自己造一套超能力管线”——把输入的信息自动处理成输出把重复劳动交给脚本把决策留给人。这个思路放在谁身上都成立不挑工具不挑行业。那“安装”的真实含义是什么是把几个选型简单、维护成本低的组件拼起来让它们之间产生化学反应。我在后面会给你看具体怎么做以及哪些地方特别容易踩坑。2. 核心架构输入、处理、输出三层一个管道串起整个系统我见过太多人做自动化失败不是因为懒而是因为一上来就想要一个“大而全”的东西。比如买个 NAS、装一堆 Docker、配置半天仪表盘最后发现每天还是要手动整理文件。问题的根源在于他们把注意力放在工具数量上而不是放在“数据怎么流动”上。所以我做这套系统时给自己定了一个非常简单的心法超级能力的本质是管道不是仓库。信息从一个端口进来经过处理从另一个端口出去。你能把多少事情接上这个管道你就有多少超能力。2.1 输入层你的系统从哪里“听到”世界的信号输入层是我先考虑的部分。它决定了系统运行起来的触发方式。常用的输入信号源有下面这几类定时器触发比如每天 9 点从任务清单里读取今天的待办生成一张提醒卡。文件变化触发监控某个下载目录、指定文件夹一旦有新文件落地就触发后续动作。剪贴板触发复制一段文字后自动格式化、归档我用的最多。规则匹配触发比如收到包含特定关键词的通知自动分类。在选输入层的时候我的建议是先挑一个你每天都会做、而且做了很多次的事把它的触发条件定义清楚。一开始不要贪多一个输入源跑通了再往上一路追加。我自己的选择是从剪贴板开始的理由很简单它是最频繁、最无意识的动作。每天从网页、文档、聊天记录里复制大量文本复制完就丢很浪费。如果把复制这个动作变成一个输入信号后面能做很多事。2.2 处理层规则比代码重要模板比智商重要处理层是整个管道的核心。我的原则是能用配置文件解决的绝不用复杂代码解决能用一个函数的绝不写一个类。处理层里放什么放的是“转化规则”。它接收输入层的原始数据然后做三件事清洗去掉多余的空行、格式混乱、广告尾巴。结构化把散乱的文本提取成标题、链接、内容摘要。映射根据关键词把内容归入不同的归档路径。我当初犯过一个典型错误在处理层写了一套非常复杂的分类算法试图让系统“智能”识别所有内容结果是识别率感人维护成本爆炸。后来我换成了简单方案——只处理输入源里最常见的三种格式剩下的一律进默认归档。这一改动反而让系统稳定了很多因为 80% 的输入本来就只有少数几种形态。下面是我剪贴板处理层的核心逻辑用 Python 写不算复杂import re import time from pathlib import Path def clean_clipboard_text(raw: str) - str: # 去掉开头结尾多余空白 text raw.strip() # 合并连续换行 text re.sub(r\n{3,}, \n\n, text) # 去掉微信/网页复制留下的来源尾巴 text re.sub(r——.*分享.*, , text) return text def classify_clipboard(text: str) - str: # 按关键词决定归档路径 if any(k in text for k in [bug, error, 报错]): return debug_log if text.startswith(http://) or text.startswith(https://): return link_box if len(text) 200: return quick_note return long_read def save_note(category: str, cleaned: str): base Path.home() / superpowers / notes / category base.mkdir(parentsTrue, exist_okTrue) filename f{time.strftime(%Y%m%d_%H%M%S)}.md (base / filename).write_text(cleaned, encodingutf-8)看到没有处理层真正做的事情非常朴素清洗、分类、落盘。它不智能但它可靠。2.3 输出层让处理结果出现在它该出现的地方输出层决定了这个系统怎么回报你。我经历过一种状态自动化脚本跑得很欢但是结果藏在某个日志文件里没人看那等于没有输出。输出层要有存在感。我的输出方式分成三种通知发到手机或桌面通知让人一眼看到处理结果。归档写进日志、Markdown 文件、笔记库供后续检索。执行如果处理结果满足条件直接触发下一个动作比如发送邮件、创建待办。输出层很重要的一点是“可溯源”。我在每个输出文件开头都保留一行元数据记录它由什么输入、什么时候、经过哪条规则产生。这个习惯帮我省了很多排查问题的力气。2.4 为什么三层足够用再加层就复杂了你可能见过一些流程图把系统拆成五六层接入层、解析层、增强层、调度层、存储层、展示层。很专业但那是企业级方案的思路。个人项目用这么深的栈大部分时间是给自己找麻烦。三层结构的最大优点是每一层可以独立更换。输入层切掉剪贴板换成监听邮箱不影响处理层处理层把规则改掉不影响输出层。我的经验是个人项目里面临的环境变化很快比如公司换协作软件、你换编辑器这种结构能让你优雅地改配置而不是重写系统。表格总结一下这三层方便你对照自己的场景层级常见组件典型动作输出产物输入层剪贴板监听、定时任务、文件夹监控捕获信号原始数据处理层规则引擎、脚本函数、模板清洗/分类/提取结构化数据输出层通知服务、文件写入、API 调用落盘/提醒/触发可用结果3. 从零搭建的三个自动化场景都是可以直接抄的配置讲完架构我来给三个我已经跑了一段时间、没有删掉的实战场景。每个场景都是“输入—处理—输出”的完整链路代码和配置我会尽量贴全你拿过去就能改着用。3.1 剪贴板一键归档把复制的内容变成可检索的笔记这个场景是我整个 superpowers 系统的入口。目标很简单你复制一段文字系统在后台自动清洗格式、按规则归档几秒后手机上收到一条“已归档到 long_read/xxx.md”的通知。我用 Python 脚本监听剪贴板配合 pyperclip 库。核心逻辑如下import pyperclip import threading import time last_clip bounce_until 0 def watch_clipboard(pause1.0): global last_clip, bounce_until while True: try: current pyperclip.paste() except Exception: time.sleep(pause) continue if current ! last_clip and current.strip(): now time.time() # 防抖30秒内同一内容只处理一次 if now bounce_until: cleaned clean_clipboard_text(current) category classify_clipboard(cleaned) save_note(category, cleaned) # 触发通知脚本双端都要写见下方 notify(category) bounce_until now 30 last_clip current time.sleep(pause) if __name__ __main__: watch_clipboard()这里有三个细节值得你注意。第一防抖逻辑。剪贴板监听最常见的坑是同一个内容触发好几次特别是你在某些编辑器里复制时系统会自动改写剪贴板。我用bounce_until做一个简单的时间窗口30 秒内不处理重复内容问题就没了。第二异常处理。剪贴板在不同系统上权限策略不一样。我在try/except里选择了静默跳过而不是弹错误因为这类监听脚本应该像背景空气一样存在而不是动不动跳出来打扰人。第三通知脚本。为了让结果即时可见我在 macOS 上用osascript弹通知在 Linux 上用了notify-send#!/bin/bash # 通知脚本 notify.sh # 用法: notify.sh 内容已归档 → long_read if [[ $OSTYPE darwin* ]]; then osascript -e display notification \$1\ with title \Superpowers\ else notify-send Superpowers $1 fi整个流程跑起来之后体验真的是“身上带了一个隐形助理”。复制一段长文切回编辑器想找地方贴的时候提示就来了已经帮你存好了。很多人第一次看到这个反应是“哇”但实际原理就是一次很简单的文件写入。3.2 下载目录自动归档治愈“下载文件夹一团乱”的重度患者第二个场景处理的是下载目录。我承认我在这方面做过很久的“数字囤积症患者”下载文件夹里什么都有PDF、安装包、截图、压缩包混在一起找一个文件翻半天。于是我用文件监控加规则归档解决了这个问题。考虑到移动端和桌面端同步我选择的监控目录是~/Downloads目标是所有新文件在 10 分钟内自动按扩展名和文件名关键词移动到对应子目录。#!/bin/bash # dispatch_new_files.sh # 在 ~/Downloads 下新建文件时触发按类型分拣 WATCH_DIR$HOME/Downloads # 文档类 if [[ $1 ~ \.(pdf|docx?|xlsx?|pptx?)(\.part)?$ ]]; then mkdir -p $WATCH_DIR/文档 mv $1 $WATCH_DIR/文档/ exit 0 fi # 压缩包 if [[ $1 ~ \.(zip|rar|7z|tar\.gz)$ ]]; then mkdir -p $WATCH_DIR/压缩包 mv $1 $WATCH_DIR/压缩包/ exit 0 fi # 图片 if [[ $1 ~ \.(png|jpe?g|gif|webp)$ ]]; then mkdir -p $WATCH_DIR/图片 mv $1 $WATCH_DIR/图片/ exit 0 fi # 安装包 if [[ $1 ~ \.(dmg|pkg|exe|msi|AppImage)$ ]]; then mkdir -p $WATCH_DIR/安装包 mv $1 $WATCH_DIR/安装包/ exit 0 fi # 其他 mkdir -p $WATCH_DIR/未分类 mv $1 $WATCH_DIR/未分类/触发方式我用的是最简单的轮询每 60 秒看一眼目录里的新文件。一开始我想用inotifywait做实时触发但后来发现对于个人电脑来说轮询足够而且稳定得多。实时触发意味着你要常驻一个守护进程处理各种文件被占用、写入未完成的问题而轮询天然避开了这些坑。这个脚本是让我第一次真正感受到“数字空间是可控的”的东西。每次下载完过一会儿去下载目录文件已经自己站好队了。你不需要任何意志力去整理它系统替你干了。3.3 每日待办摘要早上打开手机就知道今天要做什么第三个场景比较轻量但收益非常直接。它是每天早上 8 点从我的任务清单文件里提取当天待办整理成一段摘要推送到手机上。任务清单我维护在一个纯文本文件里格式极简# 2025-01-15 - [ ] 完成项目上线前检查 - [ ] 写季度复盘 - [ ] 确认下周排期 # 2025-01-16 - [ ] 准备分享用的 PPT每天早上脚本读取文件、匹配当天的日期标题然后把未完成事项拼成一条信息发出去。代码如下#!/usr/bin/env python3 from pathlib import Path import datetime, subprocess task_file Path.home() / superpowers / tasks.md today datetime.date.today().isoformat() lines task_file.read_text(encodingutf-8).splitlines() today_heading f# {today} in_today False todos [] for line in lines: if line.startswith(# ): in_today (line.strip() today_heading) elif in_today and line.strip().startswith(- [ ]): todos.append(line.strip().lstrip(- [ ] ).strip()) if todos: msg 今日待办\n \n.join(f{i1}. {t} for i, t in enumerate(todos)) subprocess.run([bash, notify.sh, msg]) else: subprocess.run([bash, notify.sh, 今天没有待办享受空白])这个脚本让我形成了一种确定性每天早上都有一个外部提醒而不是靠脑子记忆。我做这个场景的初衷是大脑应该用来做判断不应该用来做存储。哪怕只是读一遍清单这个动作交给脚本也比自己翻文件更省力。4. 安装和配置时最容易翻车的四个细节我全踩了一遍说实话上面这些脚本单看都不复杂任何一个有点编程经验的人都能在半小时内写出来。但真正让这类系统“要么好用要么吃灰”的是那些不起眼的细节。我把这些年踩过的坑挑几个典型的讲一下。4.1 路径问题中文目录、空格和权限是三大杀手第一个大坑是文件的路径。很多人一开始把脚本放在中文名字的目录里或者在处理过程中移动文件到包含空格和特殊字符的路径脚本里如果直接写死路径很容易出问题。我踩过一次特别狼狈的因为所在用户目录带中文一个文件名中包含中文和空格脚本在移动文件时把路径当成了多个参数结果文件被横切成了几个碎片。从那之后我给自己的项目定了三条铁则所有路径用英文命名中间不用空格统一用下划线。脚本里所有文件路径用Path对象拼接不手写字符串。在处理用户输入路径时一律用shlex.quote()或者subprocess传参数列表不用shellTrue拼串。# 错误的写法很容易在路径带空格时爆炸 subprocess.run(fmv {src} {dest}, shellTrue) # 正确的写法 subprocess.run([mv, str(src), str(dest)])这个细节可能不会让你立刻翻车但只要你跑几个月自动化总会遇到一次。4.2 触发器的防抖同一个文件反复被处理三次第二个坑是重复处理。我在剪贴板监听那里用了简单的防抖同样的问题也出现在文件监控里。下载一个大文件时浏览器可能会先创建一个.part文件下载完成后才变成最终文件某些工具写入文件时会先写临时文件再重命名监控脚本可能会在写了一半的时候触发更常见的是云盘同步目录会产生大量事件每个文件触发好多次。如果不加防抖你的归档脚本可能会把一个文件移动两次第二次找不到文件直接报错或者更隐蔽的——部分文件被错误地处理因为你抓到的是写入过程中的不完整状态。我给文件轮询加了一个简单的缓存机制在内存里记录最近处理过的文件名和时间戳60 秒内不重复处理。对于个人使用来说这比引入复杂的文件事件队列要划算得多。import collections, time recent collections.deque(maxlen200) def should_process(path): sig (path, time.time() // 60) if sig in recent: return False recent.append(sig) return True这种按分钟粗粒度去重的方式比精确到秒的去重更符合文件归档的场景。因为你在 60 秒内根本不需要处理同一个文件两次。4.3 日志一定要单独留否则排错就像大海捞针第三个坑是我感触最深的脚本不写日志。前几个版本我偷懒觉得输出到终端就行了。后来系统跑了两周某一天突然发现某个归档目录里多了很多不该出现的文件但我完全想不起来是哪个环节出了问题。从那之后我把日志当成了系统的必要条件。日志不是给机器看的是给未来的自己看的。我保留了stdout同时把日志写到文件里按天滚动。import logging from logging.handlers import TimedRotatingFileHandler logger logging.getLogger(superpowers) handler TimedRotatingFileHandler( /home/you/superpowers/logs/app.log, whenmidnight, backupCount14, ) logger.addHandler(handler) logger.setLevel(logging.INFO) # 每次执行关键动作时记录 logger.info(move file: %s - %s, src, dst)有日志之后排错的成本降低了至少十倍。比如发现文件被移错了目录翻一下日志立刻能看到是哪条规则匹配的发现剪贴板监听没反应看看日志就知道是权限问题还是剪贴板内容为空。4.4 环境隔离别把全局环境搞得一团糟不然你换台电脑就废了第四个坑不是功能问题而是工程问题依赖管理。我最早写脚本时直接系统 Pythonpip install 装了一堆库。几个月后有些事情做不明白了去排查发现全局环境里装了很多相互冲突的包版本还乱。更糟糕的是如果换一台新电脑完全没有可复现性所有配置都要手动重来一遍。后来我把项目从结构上规范了一下superpowers/ ├── scripts/ │ ├── clipboard_watch.py │ ├── dispatch_downloads.py │ └── daily_digest.py ├── configs/ │ └── rules.yaml ├── logs/ ├── venv/ └── requirements.txt每次在新的机器上部署只需要三步python3 -m venv venv source venv/bin/activate pip install -r requirements.txt还有一点敏感配置比如从环境变量读取通知 ID、把 API token 放进.env文件永远不要写进代码里。我见过有人的脚本里直接写了自己的邮箱密码这种习惯非常基础但确实有人漏掉。我把这些坑压在前面讲是因为它们才是一个“superpowers 系统”能不能长期活下来的核心。功能代码写得快环境因素和管理因素是慢慢消磨系统生命力的。5. 判断这套“超能力”值不值得维护我自己的取舍标准搭建系统只是第一步更关键的问题是它到底值不值得继续跑下去在我自己实践的过程中有一套很简单的判断标准。不是“这个功能很酷所以我留着”而是用数据来算账。先说“省时”的算法。我会粗略估算一个自动化任务每次省掉我多少时间乘以每天/每周触发的次数得出一个每周节省时间。比如下载目录自动归档我以前的整理习惯是每周手动整理一次一次大约 20 分钟。自动归档帮我省掉这 20 分钟同时让我随时可以快速找到文件视觉压力也小了。这个收益是实打实的。再看“维护成本”。脚本出问题不是“会不会”而是“什么时候”。我用的记账方式是每次为某个脚本花超过 30 分钟排查问题就在对应脚本旁边记一笔。几个月下来我会发现哪一个脚本在持续消耗我的注意力。我自己最后保留的规矩是一个自动化脚本如果每个月能省我至少 1 小时维护它的时间低于 15 分钟就留着如果压力值超过了收益值砍掉。用这个标准我后来真的砍掉过两个项目。一个是“自动给文件打标签”的脚本。它看起来很有意思——监控所有文档、自动提取关键词、生成标签。跑了两周后我发现打出来的标签我自己从来不看因为我对自己的文件命名习惯已经很熟悉了。还有一个是“自动生成周报”的脚本。听起来很高效但我写的周报需要大量上下文判断脚本生成的版本反而要花更多时间修改。这两个项目都没有达到“每月省 1 小时”的门槛于是删了。我建议你也给自己的每个自动化脚本建一个“性价比账本”。不要因为写了它觉得浪费就硬留着也不要因为是一步步搭起来的有感情就舍不得删。工具是为你服务的不是让你反过来照顾工具的。现在我的系统里长期保留的就是剪贴板快速归档、下载目录自动分拣、每日待办摘要这三条。它们都不复杂但每一天都在给我省时间。6. 最后聊点实在的这套系统为什么能带来“超能力感”如果只说技术细节这篇文章和普通教程没有区别。我想补充一个自己的观察当这套自动化系统跑到第三周之后我感受到了一种很微妙的心理变化。以前每天打开电脑第一件事是想“今天要做什么”现在打开电脑很多小事已经有人替我做完了——下载的文件分类好了昨晚复制的文章已经躺进笔记库早上待办清单已经推送到我眼前。我不是变强了而是我不用再把注意力消耗在那些机械性的小事上。这种“注意力被解放”的感觉才是我说的“superpowers”。不过我也要提醒一句不要一开始就想搭建一个包罗万象的系统。我的亲身经历是凡是那种“我要把所有流程全自动一键搞定工作生活”的计划几乎都以失败告终。原因很简单你对业务的理解还不够深你对自己习惯的观察还不够细强行自动化只是在把混乱固化下来。正确的路径是反过来从一件让你最厌烦的小事开始用手动方式记录你处理它的步骤再把这个步骤翻译成脚本跑起来。跑顺了再找下一件事。这个系统还会随着你的使用习惯不断演化——比如我最早只有剪贴板一个场景后来才慢慢加上下载分类、每日摘要。最后分享一个小技巧我每次给脚本加新功能都会先在手动模式下跑几遍确认处理结果的格式符合预期再接入自动触发。这个习惯让我避免了很多因为规则考虑不周而造成的蝴蝶效应。如果你现在正在为“想要安装 superpowers”这件事纠结我的建议就是别找那个完美的软件了从你的剪贴板和下载文件夹开始动手搭第一条管道。真正的超能力不是某一个工具而是你逐渐建立起来的、对重复劳动的掌控感。
1. “superpowers”到底指什么先别急着下载先想清楚你要解决什么问题最近这个词频繁出现在我的搜索记录里。搜“superpowers”跳出来的结果五花八门电影里的超级英雄能力解说、游戏里的技能树还有一个热搜词特别显眼——“想要安装superpowers”。这个“安装”用法很有意思它暗示很多人把superpowers当成一个可以直接装进电脑、装进脑子然后人就变强的软件。我能理解这种期待。就像我们下载一个工具就觉得自己掌握了新技能一样“安装”从心理上带来一种确定感。但作为折腾过很多自动化项目的人我得坦白说superpowers如果指代某一个具体软件那它大概率解决不了你想要的那种“变强”。真正的超能力是把自己重复做的事情拆掉把那些机器能干的、有规则的部分交出去让流程自己跑起来。这个系统才是可以“安装”的——只不过安装的不是一个程序而是一套思维方式和几个小工具的组合。这篇文章适合谁看适合那些已经试过用各种效率工具、自动化脚本给自己减负但最后发现工具装了一堆、流程没串起来的人。也适合刚接触个人效率系统、想从零搭建但又不想一上来就搞复杂框架的新手。我会把我在实践“superpowers”过程中的理解、架构、可以直接抄的配置以及翻车记录都摊开来讲。先说明我的基本立场我讲的“superpowers”不是某一个商业产品而是把个人工作流自动化的一个落地实践。你可以把它理解成“给自己造一套超能力管线”——把输入的信息自动处理成输出把重复劳动交给脚本把决策留给人。这个思路放在谁身上都成立不挑工具不挑行业。那“安装”的真实含义是什么是把几个选型简单、维护成本低的组件拼起来让它们之间产生化学反应。我在后面会给你看具体怎么做以及哪些地方特别容易踩坑。2. 核心架构输入、处理、输出三层一个管道串起整个系统我见过太多人做自动化失败不是因为懒而是因为一上来就想要一个“大而全”的东西。比如买个 NAS、装一堆 Docker、配置半天仪表盘最后发现每天还是要手动整理文件。问题的根源在于他们把注意力放在工具数量上而不是放在“数据怎么流动”上。所以我做这套系统时给自己定了一个非常简单的心法超级能力的本质是管道不是仓库。信息从一个端口进来经过处理从另一个端口出去。你能把多少事情接上这个管道你就有多少超能力。2.1 输入层你的系统从哪里“听到”世界的信号输入层是我先考虑的部分。它决定了系统运行起来的触发方式。常用的输入信号源有下面这几类定时器触发比如每天 9 点从任务清单里读取今天的待办生成一张提醒卡。文件变化触发监控某个下载目录、指定文件夹一旦有新文件落地就触发后续动作。剪贴板触发复制一段文字后自动格式化、归档我用的最多。规则匹配触发比如收到包含特定关键词的通知自动分类。在选输入层的时候我的建议是先挑一个你每天都会做、而且做了很多次的事把它的触发条件定义清楚。一开始不要贪多一个输入源跑通了再往上一路追加。我自己的选择是从剪贴板开始的理由很简单它是最频繁、最无意识的动作。每天从网页、文档、聊天记录里复制大量文本复制完就丢很浪费。如果把复制这个动作变成一个输入信号后面能做很多事。2.2 处理层规则比代码重要模板比智商重要处理层是整个管道的核心。我的原则是能用配置文件解决的绝不用复杂代码解决能用一个函数的绝不写一个类。处理层里放什么放的是“转化规则”。它接收输入层的原始数据然后做三件事清洗去掉多余的空行、格式混乱、广告尾巴。结构化把散乱的文本提取成标题、链接、内容摘要。映射根据关键词把内容归入不同的归档路径。我当初犯过一个典型错误在处理层写了一套非常复杂的分类算法试图让系统“智能”识别所有内容结果是识别率感人维护成本爆炸。后来我换成了简单方案——只处理输入源里最常见的三种格式剩下的一律进默认归档。这一改动反而让系统稳定了很多因为 80% 的输入本来就只有少数几种形态。下面是我剪贴板处理层的核心逻辑用 Python 写不算复杂import re import time from pathlib import Path def clean_clipboard_text(raw: str) - str: # 去掉开头结尾多余空白 text raw.strip() # 合并连续换行 text re.sub(r\n{3,}, \n\n, text) # 去掉微信/网页复制留下的来源尾巴 text re.sub(r——.*分享.*, , text) return text def classify_clipboard(text: str) - str: # 按关键词决定归档路径 if any(k in text for k in [bug, error, 报错]): return debug_log if text.startswith(http://) or text.startswith(https://): return link_box if len(text) 200: return quick_note return long_read def save_note(category: str, cleaned: str): base Path.home() / superpowers / notes / category base.mkdir(parentsTrue, exist_okTrue) filename f{time.strftime(%Y%m%d_%H%M%S)}.md (base / filename).write_text(cleaned, encodingutf-8)看到没有处理层真正做的事情非常朴素清洗、分类、落盘。它不智能但它可靠。2.3 输出层让处理结果出现在它该出现的地方输出层决定了这个系统怎么回报你。我经历过一种状态自动化脚本跑得很欢但是结果藏在某个日志文件里没人看那等于没有输出。输出层要有存在感。我的输出方式分成三种通知发到手机或桌面通知让人一眼看到处理结果。归档写进日志、Markdown 文件、笔记库供后续检索。执行如果处理结果满足条件直接触发下一个动作比如发送邮件、创建待办。输出层很重要的一点是“可溯源”。我在每个输出文件开头都保留一行元数据记录它由什么输入、什么时候、经过哪条规则产生。这个习惯帮我省了很多排查问题的力气。2.4 为什么三层足够用再加层就复杂了你可能见过一些流程图把系统拆成五六层接入层、解析层、增强层、调度层、存储层、展示层。很专业但那是企业级方案的思路。个人项目用这么深的栈大部分时间是给自己找麻烦。三层结构的最大优点是每一层可以独立更换。输入层切掉剪贴板换成监听邮箱不影响处理层处理层把规则改掉不影响输出层。我的经验是个人项目里面临的环境变化很快比如公司换协作软件、你换编辑器这种结构能让你优雅地改配置而不是重写系统。表格总结一下这三层方便你对照自己的场景层级常见组件典型动作输出产物输入层剪贴板监听、定时任务、文件夹监控捕获信号原始数据处理层规则引擎、脚本函数、模板清洗/分类/提取结构化数据输出层通知服务、文件写入、API 调用落盘/提醒/触发可用结果3. 从零搭建的三个自动化场景都是可以直接抄的配置讲完架构我来给三个我已经跑了一段时间、没有删掉的实战场景。每个场景都是“输入—处理—输出”的完整链路代码和配置我会尽量贴全你拿过去就能改着用。3.1 剪贴板一键归档把复制的内容变成可检索的笔记这个场景是我整个 superpowers 系统的入口。目标很简单你复制一段文字系统在后台自动清洗格式、按规则归档几秒后手机上收到一条“已归档到 long_read/xxx.md”的通知。我用 Python 脚本监听剪贴板配合 pyperclip 库。核心逻辑如下import pyperclip import threading import time last_clip bounce_until 0 def watch_clipboard(pause1.0): global last_clip, bounce_until while True: try: current pyperclip.paste() except Exception: time.sleep(pause) continue if current ! last_clip and current.strip(): now time.time() # 防抖30秒内同一内容只处理一次 if now bounce_until: cleaned clean_clipboard_text(current) category classify_clipboard(cleaned) save_note(category, cleaned) # 触发通知脚本双端都要写见下方 notify(category) bounce_until now 30 last_clip current time.sleep(pause) if __name__ __main__: watch_clipboard()这里有三个细节值得你注意。第一防抖逻辑。剪贴板监听最常见的坑是同一个内容触发好几次特别是你在某些编辑器里复制时系统会自动改写剪贴板。我用bounce_until做一个简单的时间窗口30 秒内不处理重复内容问题就没了。第二异常处理。剪贴板在不同系统上权限策略不一样。我在try/except里选择了静默跳过而不是弹错误因为这类监听脚本应该像背景空气一样存在而不是动不动跳出来打扰人。第三通知脚本。为了让结果即时可见我在 macOS 上用osascript弹通知在 Linux 上用了notify-send#!/bin/bash # 通知脚本 notify.sh # 用法: notify.sh 内容已归档 → long_read if [[ $OSTYPE darwin* ]]; then osascript -e display notification \$1\ with title \Superpowers\ else notify-send Superpowers $1 fi整个流程跑起来之后体验真的是“身上带了一个隐形助理”。复制一段长文切回编辑器想找地方贴的时候提示就来了已经帮你存好了。很多人第一次看到这个反应是“哇”但实际原理就是一次很简单的文件写入。3.2 下载目录自动归档治愈“下载文件夹一团乱”的重度患者第二个场景处理的是下载目录。我承认我在这方面做过很久的“数字囤积症患者”下载文件夹里什么都有PDF、安装包、截图、压缩包混在一起找一个文件翻半天。于是我用文件监控加规则归档解决了这个问题。考虑到移动端和桌面端同步我选择的监控目录是~/Downloads目标是所有新文件在 10 分钟内自动按扩展名和文件名关键词移动到对应子目录。#!/bin/bash # dispatch_new_files.sh # 在 ~/Downloads 下新建文件时触发按类型分拣 WATCH_DIR$HOME/Downloads # 文档类 if [[ $1 ~ \.(pdf|docx?|xlsx?|pptx?)(\.part)?$ ]]; then mkdir -p $WATCH_DIR/文档 mv $1 $WATCH_DIR/文档/ exit 0 fi # 压缩包 if [[ $1 ~ \.(zip|rar|7z|tar\.gz)$ ]]; then mkdir -p $WATCH_DIR/压缩包 mv $1 $WATCH_DIR/压缩包/ exit 0 fi # 图片 if [[ $1 ~ \.(png|jpe?g|gif|webp)$ ]]; then mkdir -p $WATCH_DIR/图片 mv $1 $WATCH_DIR/图片/ exit 0 fi # 安装包 if [[ $1 ~ \.(dmg|pkg|exe|msi|AppImage)$ ]]; then mkdir -p $WATCH_DIR/安装包 mv $1 $WATCH_DIR/安装包/ exit 0 fi # 其他 mkdir -p $WATCH_DIR/未分类 mv $1 $WATCH_DIR/未分类/触发方式我用的是最简单的轮询每 60 秒看一眼目录里的新文件。一开始我想用inotifywait做实时触发但后来发现对于个人电脑来说轮询足够而且稳定得多。实时触发意味着你要常驻一个守护进程处理各种文件被占用、写入未完成的问题而轮询天然避开了这些坑。这个脚本是让我第一次真正感受到“数字空间是可控的”的东西。每次下载完过一会儿去下载目录文件已经自己站好队了。你不需要任何意志力去整理它系统替你干了。3.3 每日待办摘要早上打开手机就知道今天要做什么第三个场景比较轻量但收益非常直接。它是每天早上 8 点从我的任务清单文件里提取当天待办整理成一段摘要推送到手机上。任务清单我维护在一个纯文本文件里格式极简# 2025-01-15 - [ ] 完成项目上线前检查 - [ ] 写季度复盘 - [ ] 确认下周排期 # 2025-01-16 - [ ] 准备分享用的 PPT每天早上脚本读取文件、匹配当天的日期标题然后把未完成事项拼成一条信息发出去。代码如下#!/usr/bin/env python3 from pathlib import Path import datetime, subprocess task_file Path.home() / superpowers / tasks.md today datetime.date.today().isoformat() lines task_file.read_text(encodingutf-8).splitlines() today_heading f# {today} in_today False todos [] for line in lines: if line.startswith(# ): in_today (line.strip() today_heading) elif in_today and line.strip().startswith(- [ ]): todos.append(line.strip().lstrip(- [ ] ).strip()) if todos: msg 今日待办\n \n.join(f{i1}. {t} for i, t in enumerate(todos)) subprocess.run([bash, notify.sh, msg]) else: subprocess.run([bash, notify.sh, 今天没有待办享受空白])这个脚本让我形成了一种确定性每天早上都有一个外部提醒而不是靠脑子记忆。我做这个场景的初衷是大脑应该用来做判断不应该用来做存储。哪怕只是读一遍清单这个动作交给脚本也比自己翻文件更省力。4. 安装和配置时最容易翻车的四个细节我全踩了一遍说实话上面这些脚本单看都不复杂任何一个有点编程经验的人都能在半小时内写出来。但真正让这类系统“要么好用要么吃灰”的是那些不起眼的细节。我把这些年踩过的坑挑几个典型的讲一下。4.1 路径问题中文目录、空格和权限是三大杀手第一个大坑是文件的路径。很多人一开始把脚本放在中文名字的目录里或者在处理过程中移动文件到包含空格和特殊字符的路径脚本里如果直接写死路径很容易出问题。我踩过一次特别狼狈的因为所在用户目录带中文一个文件名中包含中文和空格脚本在移动文件时把路径当成了多个参数结果文件被横切成了几个碎片。从那之后我给自己的项目定了三条铁则所有路径用英文命名中间不用空格统一用下划线。脚本里所有文件路径用Path对象拼接不手写字符串。在处理用户输入路径时一律用shlex.quote()或者subprocess传参数列表不用shellTrue拼串。# 错误的写法很容易在路径带空格时爆炸 subprocess.run(fmv {src} {dest}, shellTrue) # 正确的写法 subprocess.run([mv, str(src), str(dest)])这个细节可能不会让你立刻翻车但只要你跑几个月自动化总会遇到一次。4.2 触发器的防抖同一个文件反复被处理三次第二个坑是重复处理。我在剪贴板监听那里用了简单的防抖同样的问题也出现在文件监控里。下载一个大文件时浏览器可能会先创建一个.part文件下载完成后才变成最终文件某些工具写入文件时会先写临时文件再重命名监控脚本可能会在写了一半的时候触发更常见的是云盘同步目录会产生大量事件每个文件触发好多次。如果不加防抖你的归档脚本可能会把一个文件移动两次第二次找不到文件直接报错或者更隐蔽的——部分文件被错误地处理因为你抓到的是写入过程中的不完整状态。我给文件轮询加了一个简单的缓存机制在内存里记录最近处理过的文件名和时间戳60 秒内不重复处理。对于个人使用来说这比引入复杂的文件事件队列要划算得多。import collections, time recent collections.deque(maxlen200) def should_process(path): sig (path, time.time() // 60) if sig in recent: return False recent.append(sig) return True这种按分钟粗粒度去重的方式比精确到秒的去重更符合文件归档的场景。因为你在 60 秒内根本不需要处理同一个文件两次。4.3 日志一定要单独留否则排错就像大海捞针第三个坑是我感触最深的脚本不写日志。前几个版本我偷懒觉得输出到终端就行了。后来系统跑了两周某一天突然发现某个归档目录里多了很多不该出现的文件但我完全想不起来是哪个环节出了问题。从那之后我把日志当成了系统的必要条件。日志不是给机器看的是给未来的自己看的。我保留了stdout同时把日志写到文件里按天滚动。import logging from logging.handlers import TimedRotatingFileHandler logger logging.getLogger(superpowers) handler TimedRotatingFileHandler( /home/you/superpowers/logs/app.log, whenmidnight, backupCount14, ) logger.addHandler(handler) logger.setLevel(logging.INFO) # 每次执行关键动作时记录 logger.info(move file: %s - %s, src, dst)有日志之后排错的成本降低了至少十倍。比如发现文件被移错了目录翻一下日志立刻能看到是哪条规则匹配的发现剪贴板监听没反应看看日志就知道是权限问题还是剪贴板内容为空。4.4 环境隔离别把全局环境搞得一团糟不然你换台电脑就废了第四个坑不是功能问题而是工程问题依赖管理。我最早写脚本时直接系统 Pythonpip install 装了一堆库。几个月后有些事情做不明白了去排查发现全局环境里装了很多相互冲突的包版本还乱。更糟糕的是如果换一台新电脑完全没有可复现性所有配置都要手动重来一遍。后来我把项目从结构上规范了一下superpowers/ ├── scripts/ │ ├── clipboard_watch.py │ ├── dispatch_downloads.py │ └── daily_digest.py ├── configs/ │ └── rules.yaml ├── logs/ ├── venv/ └── requirements.txt每次在新的机器上部署只需要三步python3 -m venv venv source venv/bin/activate pip install -r requirements.txt还有一点敏感配置比如从环境变量读取通知 ID、把 API token 放进.env文件永远不要写进代码里。我见过有人的脚本里直接写了自己的邮箱密码这种习惯非常基础但确实有人漏掉。我把这些坑压在前面讲是因为它们才是一个“superpowers 系统”能不能长期活下来的核心。功能代码写得快环境因素和管理因素是慢慢消磨系统生命力的。5. 判断这套“超能力”值不值得维护我自己的取舍标准搭建系统只是第一步更关键的问题是它到底值不值得继续跑下去在我自己实践的过程中有一套很简单的判断标准。不是“这个功能很酷所以我留着”而是用数据来算账。先说“省时”的算法。我会粗略估算一个自动化任务每次省掉我多少时间乘以每天/每周触发的次数得出一个每周节省时间。比如下载目录自动归档我以前的整理习惯是每周手动整理一次一次大约 20 分钟。自动归档帮我省掉这 20 分钟同时让我随时可以快速找到文件视觉压力也小了。这个收益是实打实的。再看“维护成本”。脚本出问题不是“会不会”而是“什么时候”。我用的记账方式是每次为某个脚本花超过 30 分钟排查问题就在对应脚本旁边记一笔。几个月下来我会发现哪一个脚本在持续消耗我的注意力。我自己最后保留的规矩是一个自动化脚本如果每个月能省我至少 1 小时维护它的时间低于 15 分钟就留着如果压力值超过了收益值砍掉。用这个标准我后来真的砍掉过两个项目。一个是“自动给文件打标签”的脚本。它看起来很有意思——监控所有文档、自动提取关键词、生成标签。跑了两周后我发现打出来的标签我自己从来不看因为我对自己的文件命名习惯已经很熟悉了。还有一个是“自动生成周报”的脚本。听起来很高效但我写的周报需要大量上下文判断脚本生成的版本反而要花更多时间修改。这两个项目都没有达到“每月省 1 小时”的门槛于是删了。我建议你也给自己的每个自动化脚本建一个“性价比账本”。不要因为写了它觉得浪费就硬留着也不要因为是一步步搭起来的有感情就舍不得删。工具是为你服务的不是让你反过来照顾工具的。现在我的系统里长期保留的就是剪贴板快速归档、下载目录自动分拣、每日待办摘要这三条。它们都不复杂但每一天都在给我省时间。6. 最后聊点实在的这套系统为什么能带来“超能力感”如果只说技术细节这篇文章和普通教程没有区别。我想补充一个自己的观察当这套自动化系统跑到第三周之后我感受到了一种很微妙的心理变化。以前每天打开电脑第一件事是想“今天要做什么”现在打开电脑很多小事已经有人替我做完了——下载的文件分类好了昨晚复制的文章已经躺进笔记库早上待办清单已经推送到我眼前。我不是变强了而是我不用再把注意力消耗在那些机械性的小事上。这种“注意力被解放”的感觉才是我说的“superpowers”。不过我也要提醒一句不要一开始就想搭建一个包罗万象的系统。我的亲身经历是凡是那种“我要把所有流程全自动一键搞定工作生活”的计划几乎都以失败告终。原因很简单你对业务的理解还不够深你对自己习惯的观察还不够细强行自动化只是在把混乱固化下来。正确的路径是反过来从一件让你最厌烦的小事开始用手动方式记录你处理它的步骤再把这个步骤翻译成脚本跑起来。跑顺了再找下一件事。这个系统还会随着你的使用习惯不断演化——比如我最早只有剪贴板一个场景后来才慢慢加上下载分类、每日摘要。最后分享一个小技巧我每次给脚本加新功能都会先在手动模式下跑几遍确认处理结果的格式符合预期再接入自动触发。这个习惯让我避免了很多因为规则考虑不周而造成的蝴蝶效应。如果你现在正在为“想要安装 superpowers”这件事纠结我的建议就是别找那个完美的软件了从你的剪贴板和下载文件夹开始动手搭第一条管道。真正的超能力不是某一个工具而是你逐渐建立起来的、对重复劳动的掌控感。
