你记得自己用过一个昵称，却想不起在哪些网站注册过；换了产品名称，又需要整理旧账号和失效的主页链接。Aliens Eye 可以按一份站点清单检查用户名，把候选页面保存成报告。剩下的工作，是打开这些页面，确认账号是否还在、是不是自己的，以及哪些平台这次没有检查成功。
结果表中的绿色命中和置信度，需要多看一眼。同名账号可能属于别人，登录页也可能返回 HTTP 200。Aliens Eye 给出的判断用于筛选页面，不是账号归属证明。用自己拥有的用户名或明确获授权的公开账号开始，结果更容易核对。
先认识这个项目，别把“AI”理解成聊天助手
Aliens Eye 的官方项目主页在 GitHub。项目通过 PyPI 发布，包名是 aliens-eye，安装后的命令是 aliens_eye，两者的连字符和下划线不同。它采用 MIT 许可，要求 Python 3.10 或更新版本，主要通过终端使用，并不是装好以后就能打开的网页管理后台。
项目介绍覆盖八百多个平台。这个数字描述的是站点目录规模，不能解释成八百多个平台每次都可访问，更不能解释成能找回一个人的全部账号。站点改版、账号改名、地区限制和请求失败都可能影响结果。
它的 AI 部分使用已经训练好的逻辑回归模型，结合页面特征与启发式规则判断。普通使用在本地运行模型推理，不需要先填 OpenAI API Key，也不需要为调用大模型购买 Token。页面请求、联网流量和 VPS 本身的费用仍由使用环境承担；如果只想偶尔整理账号，在自己的电脑运行就够了。
默认包不要求安装 scikit-learn；重新训练才需要对应扩展。浏览器渲染、头像匹配、PDF、交互式终端和 MCP 服务也分别有可选依赖，不必第一次就全部装上。使用这些功能前，要安装相应扩展。包信息与依赖说明
2.5.0 改了什么，为什么旧报告值得重新检查
截至 2026 年 10 月 1 日，PyPI 发布版本和仓库版本都是 2.5.0。官方更新记录把这次版本标为 2026 年 9 月 18 日发布。其中几个修正会影响旧报告的解读。
旧版读取响应时，可能只取得页面的一段内容，实际长度会随网络读取而变。标题、头像或个人资料标签没有进入这一段时，提取和判断就会缺少信息。新版改为读到大小上限或响应结束。因此，旧报告中的字段缺失或前后变化，不一定来自网站本身改了内容。
账号关联也修正了一个重要问题：页面只是提到正在搜索的昵称，过去可能因此把大量结果串成同一组。新版本不再用这种提及直接建立关联。已经保存的大型关联结果，应回到页面核对，不能继续把旧分组当作账号归属结论。
另外，2.4.0 和 2.5.0 分别修正了关联头像与 PDF 头像下载中的地址校验问题。使用旧版做这些操作的用户应更新；只换报告格式不会补上旧程序的修正。
比较两次扫描时，把软件版本一并记下来。升级后某一条从 Found 变成 Maybe，既可能是页面变了，也可能是检测方式变了，不能直接认定对方删了账号。
官方项目安装说明。浏览器、PDF 和其他扩展需要分别安装依赖，基础安装不会自动包含它们。
在电脑或 VPS 上用独立环境安装
下面以已有 Python 的 Linux 环境为例。使用普通用户创建目录，不把扫描器装进系统 Python，也不需要以 root 身份运行。先检查版本：
python3 --version
mkdir -p ~/services/aliens-eye
cd ~/services/aliens-eye
umask 077
python3 -m venv .venv
. .venv/bin/activate
python -m pip install 'aliens-eye==2.5.0'
aliens_eye --version
aliens_eye --help
如果 Python 低于 3.10，先准备符合要求的版本。如果创建虚拟环境报缺少 venv 组件，按所用系统的 Python 安装方式补齐组件后再继续。不要在这一步用管理员权限强行覆盖系统包。
安装命令固定为 2.5.0，后面的参数说明也以这个版本为准。以后升级应先查看新的包信息与变更记录，确认再更换版本。虚拟环境在当前 shell 激活；重新通过 SSH 登录后，需要进入目录并再次运行激活命令。也可以在脚本中写虚拟环境内命令的绝对路径。
Aliens Eye 有官方 Dockerfile，不过基础镜像构建并不等于提供网页界面或后台服务。它仍是命令行程序，报告目录、运行用户和附加依赖还要自己安排。小范围检查用 Python 虚拟环境即可；熟悉 Docker 的读者可以采用项目提供的 Dockerfile。
安装遇到问题时，先看报错来自哪里：Python 版本、包下载、依赖安装和扫描网站失败是不同阶段。包安装成功以后，目标平台仍可能无法访问，反复重装程序通常解决不了这种问题。
第一次只检查几个明确的平台
示例中的 OWN_HANDLE 是占位用户名，执行前换成自己的公开昵称。先使用 basic 级别，只检查输入的这个名字，不生成前缀和后缀变体：
aliens_eye OWN_HANDLE \
-l basic \
--site github,reddit,gitlab \
--profile quick \
--no-nsfw \
--concurrent 4 \
--timeout 15 \
--retries 1 \
--rate-limit 1 \
--format json,csv,html \
--output results
这些参数在命令行定义中可以查到。--profile quick 选择预设并避免交互式预设选择；命令里又明确指定了并发、超时和重试，它们优先于相应的预设值。这里的数值是小范围检查的示例，不是速度或准确率承诺。
--site 按站点名称匹配，支持逗号分隔，并不是一份严格的主机地址白名单。某个词可能匹配多个站点条目，复核时仍要看实际检查了哪些平台。如果要固定一份站点目录，可以进一步研究 --sites 和 --sites-dir，而不是把筛选词当成访问控制规则。
quick、full、aggressive 是请求预设；basic、intermediate、advanced 则是用户名范围。advanced 会生成更多候选名字，不表示模型必然更准确。第一次检查连自己的几个已知账号都还没核对清楚时，先不要扩大范围。
如果只有一部分平台失败，先记录错误与返回内容。遇到访问挑战或登录要求，可以在浏览器中按平台正常流程核对自己的账号；浏览器扩展能力不是用来绕过这些要求的。请求过密或网络不稳定时，继续提高并发只会让报告更难解释。
打开报告，看的是页面证据
结果通常包括 Found、Maybe、Not Found，以及请求失败等情况。它们需要分开读：
| 结果 | 当前能说明什么 | 接下来怎么处理 |
|---|---|---|
| Found | 检测器把响应判断为较像账号主页 | 打开原页面，确认账号及归属 |
| Maybe | 当前特征不足以给出明确分类 | 检查是否有登录页、挑战页或页面内容缺失 |
| Not Found | 这次响应更像没有账号的页面 | 与已知账号对照，保留漏检可能 |
| 请求失败 | 没有得到可正常分析的响应 | 留作未完成检查，不能计入不存在 |
HTTP 200 也可能对应登录页、错误模板或通用搜索结果。阅读 JSON 时，不只看 status，还要看 code、请求 URL、final_url 和 ai_analysis。CSV 方便筛选；JSON 保存的分析信息更完整。报告结构与导出实现说明了这些字段。
把报告整理成自己的账号清单时，可以在旁边增加人工复核列：确认属于自己、同名但不是自己、页面打不开、需要稍后复查。不要用颜色或置信度替代这一列。
如果结果跳到了网站登录页，即使工具显示 Found，也应先记为需要复核。如果旧昵称跳转到自己的新主页，可以保留新地址及核对时间。
导出文件通常使用用户名、扫描级别和时间戳命名。阅读旧报告的命令如下，其中路径是示例，应换成实际文件名：
aliens_eye -r results/OWN_HANDLE_basic_YYYYMMDD_HHMMSS.json
--format all 不代表所有扩展报告都生成。当前导出实现将 JSON、CSV、HTML 和 Markdown 作为常规报告，PDF 与图关系格式另行选择。需要 PDF 时还要安装它的扩展依赖；首次使用没必要为了分享一个表格把全部格式都打开。
置信度高，不等于账号归属可信
假如一个页面有昵称、头像和个人简介，检测器可能认为它很像真实主页。但页面属于谁，要靠其他信息核对。同名用户名、共享头像和通用简介都不足以单独确认身份。
2.5.0 的检测工作说明公开了一组作者评估：在未参与训练的 142 个平台上，precision 为 0.65、recall 为 0.51，F1 约为 0.57。作者同时说明，这组评估中，F1 无法与简单 HTTP 状态码基线区分出统计上的差异。这里列的是项目作者的评估结果，不能当作所有用户名、所有网络环境的准确率。
precision 关注判为命中的结果里有多少正确；recall 关注已知存在的账号有多少被找到。新版希望减少误报，也可能把一些真实账号放进 Maybe 或 Not Found。因此，不能把其中一个百分比单独写成“AI 识别准确率”。
报告中的 confidence 也不是“这个账号属于某个人的概率”。它服务于页面分类和排序。关联功能用头像、简介或链接寻找相似结果，仍需要人工判断。整理自己的账号时，优先用你能登录的账号、自己官网列出的主页和已知改名记录做对照，比仅凭相似头像可靠。
项目文档列出了模型与启发式规则的配合，并说明 Found、Maybe 需要复核。图中的指标属于作者评估，不是本文实测。
保存结果，下一次才能比较
在 VPS 上运行时，报告会保存在服务器上，不会自动回到自己的电脑。可以用 SSH 工具下载，或者在本机执行下面的示例命令：
mkdir -p ./aliens-eye-reports
scp 'your-user@your-vps:~/services/aliens-eye/results/*.json' \
./aliens-eye-reports/
用户名、VPS 地址和目录都要换成自己的。这条命令在本机执行，不是进入服务器之后再执行。HTML 可以留作阅读副本，但里面的资料和头像仍可能涉及个人信息；不要把整个结果目录挂到网站公开访问。
同时保存扫描日期、程序版本、用户名范围、站点筛选和网络条件。下一次尽量使用相同范围，再比较报告。两次分别使用 basic 与 advanced，或者一次筛选三个平台、另一次扫描全部目录，结果数量本来就不可直接比较。
项目提供差异命令，下面两个文件名仍是占位示例：
aliens_eye diff results/old.json results/new.json
一条新结果值得打开检查，一条消失结果也值得复核，但差异不是网站变化的自动证明。网络错误、页面改版和软件升级都可能改变分类。软件版本不同的两份报告，尤其要结合更新记录解释。
长扫描也可以通过 --resume 使用检查点。它保存已完成的进度，适合继续中断的同一次任务；想重新核对账号当前状态，就应做新的扫描，不能把旧检查点里的完成结果当成刚刚重新请求过的页面。
浏览器、关联和 MCP，按需要再加
先完成基础扫描，再按需要安装扩展。确实需要对支持的页面进行浏览器渲染时，再安装 browser 扩展和 Chromium：
python -m pip install 'aliens-eye[browser]==2.5.0'
python -m playwright install chromium
当前浏览器回退主要针对 Maybe 结果，仍可能遇到平台限制；机器上的可用内存、浏览器依赖和网络都会影响运行。它不会把扫描结果自动变成已确认账号。
如果要把工具接到其他程序，项目提供 aliens_eye.api；接到支持 MCP 的助手，需要 serve 扩展。给助手的任务仍应限定用户名、站点范围和报告保存位置。允许助手调用工具，不表示允许它扩大到陌生人的账号调查或公开整份资料。
watch 可以周期检查，--notify 可以把变化发到 webhook。但“长期运行”会持续产生请求和报告，先做好一次手动检查，再决定频率、保存周期和哪些变化需要通知。不要把一个尚未复核的结果直接变成自动对外消息。
完成第一次整理后，可以留下一张简短清单：自己确认过的主页、仍待复查的平台，以及对应的报告文件。下一次改昵称或更新个人网站时，先查这张清单；扫描结果只是补充线索，维护账号仍要回到平台本身。