作者：DeFi狙击手 · X：@bi_9527zx

本地运行的多链 Meme 候选雷达。AVE 负责热榜发现；受支持链使用批量 DexScreener 行情补齐卡片，不额外消耗 AVE CU。默认快速扫描不逐币进行 GoPlus 或 K 线深审。当前版本 v0.1.12，按免费 API 的请求限制设计。

• 修复 API 连接检测排队过久、被误报为网络失败的问题；暂时不能发起测试时立即说明原因。
• 区分请求等待、限频、额度不足、Key 无效与网络异常；有可靠重试时间时直接显示。
• 测试结果不再被页面自动刷新覆盖；取消或超时不会在后台继续保存 Key，更换失败保留原配置。
• 保留免费 API 的限频和预算保护；中英文语音、提醒置顶、多链候选和 AVE 快捷入口不变。

完整说明见 v0.1.12 更新记录。

使用与配置教程请查看 X：@bi_9527zx 的置顶内容。

这是从自用版本隔离出的开源版，只包含本地只读扫描、自动筛选与证据展示。Windows 与 macOS 共用同一套扫描逻辑。

它不包含钱包私钥、链上交易签名、swap 或下单模块。系统只提供筛选证据，不构成投资建议，也不保证候选代币安全或上涨。

• 提供 BSC、Solana、Base、以太坊和 Robinhood 五条链入口，可选择 1–3 条链共享额度轮询。界面会如实显示二次来源的代码覆盖范围，但默认快速扫描不自动逐币深审；Robinhood 仅作 AVE-only 行情观察。Arc、Stable 暂不作为可用链展示。
• AVE 热榜发现共享全局单请求队列：每轮只读取 1 页，连续两次首页后也会轮到后续页，防止热门首页长期挤占发现范围；限流恢复期优先首页探针，不连续翻页形成请求突发。单个地址的冲突条目会一起隔离，其余有效条目继续处理。
• 在对应上游数据可用时，综合查看合约权限、LP、税率/貔貅风险、持仓结构、普通钱包代理样本、聪明钱、5 分钟盘面与价格行为；未知字段不会假装通过。
• GoPlus 与 DexScreener 模块可在受支持链的深审流程中补充合约风险、市值、流动性和官网交叉验证；开源版默认关闭自动逐币深审，未取得的字段始终标为未知。
• AVE 单 Key 配置用于只读行情扫描和连接检测。候选币可打开详细行情；实际交易在 AVE 页面由用户确认。
• 提供收藏、备注、桌面提醒与筛选记录导出；已有影子表现记录保留在本机和导出资料中，首页不再展示，默认快速模式不自动新增或回补样本。
• 语音提醒可独立手动切换中文 / English，优先使用设备上对应语言的本机声音；支持音量、关闭和跨标签去重，无需语音 API Key。
• 风险过滤：排除已知低流动性、高税、DEV 集中持仓、明确零买卖与已观测暴拉平台/持续暴跌。免费模式未逐币完成合约安全审计，卡片明确标为“初筛 · 未核验”，不能保证排除全部貔貅或诈骗盘。
• 只需一把 AVE API Key，保存在当前电脑；不需 Agent 公钥或钱包。旧数据源客户端、密钥接口与安装依赖已移除，旧配置文件不再加载。

• Windows x64 一键便携版
• macOS 版
• SHA-256 校验文件

也可以在 Releases 页面查看版本说明与文件校验值。

• HTTP 服务只监听本机回环地址。
• 设置接口仅处理本机扫描配置、收藏备注与 AVE Key；无签名或下单接口。
• AVE Key 仅保存到本项目受限状态文件，不进入参数、日志、HTTP 响应或浏览器存储。
• 浏览器只获取经过字段白名单过滤的状态，不返回上游原始响应。
• 未知或无法解析的风险字段不应被视为通过。
• X 链接仅供人工查看；未完成真实性验证时不做自动背书。
• 首页展示自动筛选后的观察线索，缺失资料、过期行情仍会标明；展示不等于安全或买入建议。
• 已有筛选记录可保留 30 分钟、2 小时与 24 小时的影子表现；默认快速模式不自动新增或回补样本，也不据此宣称策略有效。

1. 下载 Windows 压缩包，右键选择 全部解压，不要直接在压缩软件里运行。
2. 进入解压后的文件夹，双击 MemeRadar-OpenSource.exe；便携包已包含运行环境，不需要另外安装 Node.js。
3. 若 Windows 显示“已保护你的电脑”，确认文件来自本仓库后点击 更多信息 → 仍要运行。
4. 保留启动后的黑色窗口；关闭该窗口会停止本地雷达。浏览器未自动打开时，访问 http://127.0.0.1:3791/。

1. 下载 macOS 压缩包并完整解压到可写文件夹。
2. 双击 安装并启动.command。若系统首次阻止打开，请右键该文件选择 打开。
3. 首次运行会检查 Node.js；缺少兼容环境时会从 nodejs.org 下载项目专用版本并校验 SHA-256，然后检查程序文件并打开浏览器。AVE 扫描只使用 Node.js 内置模块，不再安装额外的行情 CLI。

展开 设置与运行记录 → AVE API，填入自己的 AVE API Key，点击 保存 / 测试。验证成功后保存并开始只读扫描；以后重启不需重复填写。无需公钥、私钥或连接钱包。所有行情请求共用限流与本机预算；实际消耗以 AVE 账户为准。

连接检测不会排队数分钟：扫描占用请求通道、限频或预算不足时，会立即提示原因，并在有可靠时间时显示何时可重试；请届时再点击测试。此类等待不代表 Key 无效。测试超时或页面断开后不会补存 Key，更换 Key 验证失败也不会覆盖原配置。

默认本机累计预算 1,000,000 CU，每日最多 30,000 CU，每个 UTC 整点小时最多 1,250 CU。所有 AVE 请求共用全局队列和缓存；生产扫描在全局范围内每 5 分钟最多发起一条链的热榜请求，启用多链时轮询各链，不是每条链各自每 5 分钟请求一次。这是本机消费保护，不是 AVE 账户余额或套餐周期承诺；账户其他软件用量、迁移前未知历史均不在本机估算内。

遇到 HTTP 429 后，全局热榜间隔自动退到 8 分钟；如果仍然限流，必要时放慢到 15 分钟，并遵守更长的 Retry-After。稳定恢复后才会谨慎试探 5 分钟档；如果该试探再次收到 429，会立即回到 8 分钟，并在接下来 24 小时内不再试探 5 分钟档，但仍按当前安全间隔轮询。限流恢复期只用单页热榜作为探针，不开启额外分页、逐币补充、深审或历史采样。退避状态随账本保留，重启不清除；明确的额度耗尽会单独显示为配额问题。“连接诊断”只显示接口类别、HTTP 状态与原因分类，不保存原始错误正文或 Key。

只有本机每日计数在北京时间 08:00 换日，小时计数在整点刷新；累计预算不会自动清零。总预算用完须先核对账户额度，再人工调整，不会自动购买。升级保留旧账本可见的消费，重启、换 Key、跨日均不清除累计用量。

开源版默认不自动读取代币详情或池行情进行逐币补充，也不自动深审。额外收费的历史 K 线回补默认关闭，已有记录保留，热榜中已带的价格仍可用于跟踪；不使用 AVE 给其他来源或来源不明的旧基准补算收益。每日预留 3,000 CU 给热榜发现，小时或每日预算耗尽则等待对应窗口，不降低安全标准。接口统计是本次运行的本机估算，不等于账户账单。

点击 详细行情查看 打开对应代币页面。此版本不签名、不自动下单。

顶部 下载最新版 只会打开官方 GitHub 的 最新版本页面。程序不会自动下载发布包，不会覆盖当前目录，也不会自动退出、重启或安装新版本。

请在 GitHub 页面手动选择 Windows x64 或 macOS 压缩包，并使用同一版本的 SHA256SUMS-<version>.txt 核对 SHA-256。升级时先关闭新旧雷达，将新包完整解压到新的可写目录；旧目录请保留作为备份。如需迁移资料，须在新目录首次启动前执行：

node scripts/migrate-local-state.mjs --from "/旧版雷达的完整路径" --confirm-stopped

Windows 便携版在新目录使用 runtime\node.exe 替代上面的 node。该工具只复制明确列出的 AVE Key、额度账本、设置与历史，原样保留累计用量；不移动旧文件、不迁移 .env、日志或旧数据源凭据。新目录已有 state、检测到启动任务、文件异常或 Key 缺少对应账本时会拒绝迁移，不覆盖现有资料。迁移后再启动新版本。未停机的前台调试进程不一定能自动识别，因此必须先自行关闭。

• 生产环境全局每 5 分钟最多发起一条链的热榜请求；正常情况下，启用 1 / 2 / 3 条链时，每条链约 5 / 10 / 15 分钟轮到一次。页面分别显示当前链最早尝试时间与行情真实时间；预测不是成功保证，限流时会继续顺延，不把过期行情改成新行情。每轮只读取 1 页热榜（最多 100 条），按首页与后续页轮换；坏尾页下一轮先回首页，不在同一轮连续重试。这是热榜样本，不是全链新币覆盖。多开标签页不增加 AVE 请求。
• 展开“扫描设置与记录”，可选择 1–3 条链轮询，共用请求预算。点击已启用链只切换查看；点击未启用链会修改轮询配置：少于 3 条时加入，已满 3 条时替换当前查看链。修改后等待后台调度，不会立即发起额外扫描。界面标出当前链的第二数据源接入范围；“已接入”不代表每次查询都成功。
• 收藏与备注保存在本机 state/preferences.json，最多 50 个收藏、500 条备注。默认快速模式下，收藏币掉出发现范围后不会因此触发额外风险复查或历史补查，也不会重新成为通过候选；已有记录保留。关闭某条链的扫描后同样不会再为该链发起这些额外请求。
• 主界面统一展示代币卡片，语音播报后在顶部突出显示；新鲜候选排在仅供展示的旧线索之前，同分时稳定排序，减少无意义跳动。卡片分别标出入选时间与行情更新时间；过期展示记录即使断线也会清理。筛选自动进行，不再需要人工通过。设置与筛选详情默认折叠，缺失和过期证据不会视为安全。旧人工标记仅保留兼容，不增加新人工审批步骤。
• 桌面提醒需手动开启并授权，且保持页面打开；只提醒新候选、风险恶化和长时间扫描失败。相同候选事件 30 分钟去重，静音不删除页面事件。未授权时不会影响扫描。
• “导出记录”下载不含 Key 的 JSON，包含各链的审计、影子样本、收藏备注及当前浏览器人工标记。不要将含个人备注的导出文件直接公开。
• “清除并断开 API”只清除本项目 AVE Key 并停止新请求；不修改或删除旧数据源的配置文件。
• 桌面安装启动入口自带本地进程守护，异常崩溃自动恢复；等待本机服务启动最多 90 秒，短暂连接重置会重试，遇到其他程序占用端口则停止。AVE 限流或断网不会触发进程反复重启。Windows 便携启动器共用此守护，未做 Windows 真机验证。电脑关机/休眠不能扫描；本版不安装系统开机自启。系统 Node 的 npm start 是前台调试模式，不带守护。

每次实际播报开始时，顶部显示本次提醒币卡片与批次选择；当前列表中的有效提醒币置顶高亮。跨链可点击定位，过期或被排除后会取消置顶，试听不会制造提醒币。

AVE 行情初选不等于安全审计。必需行情缺失、过期或已命中明确风险排除的线索不会进入语音提醒；未获取的合约安全字段仍为未核验，不能用声音提醒当作安全背书。

页面点击“试听并开启”，浏览器允许声音后即可使用。“播报语言”可在中文与 English 之间手动切换，该选择与页面界面语言独立保存；切换后会立即试听，正式提醒也使用所选语言。中文台词为“发现新的候选代币，请查看。”，英文台词为“A new meme candidate was found. Take a look.”。仅选择设备可用的对应语言本机声音，不回退为错误语言或云端声音；不附带系统声音录音，不需语音 API Key。支持提供 Web Speech、Web Locks 与本地存储的新版 Chrome、Edge、Safari；缺少所选语言声音时，请在系统语音设置中添加后重试。页面需保持打开，电脑休眠或浏览器节能可能延迟提醒。重开页面需要再次点击允许声音。

提醒覆盖已启用的扫描链，仅对最近 10 分钟内首次通过快速筛选、行情仍有效且未命中已知风险排除的新候选播放。首次打开、重新开启和断线恢复不追播旧候选。每批合并一句，最多每分钟一次，同一链＋合约地址 7 天去重；换页、行情刷新或播报被打断都不会让同一币重复播报。关闭与音量变化同步到同源其他标签页，其他页面不能替当前页面解锁声音。台词是提醒语，不是质量评级、诈骗鉴定或收益承诺。

首次发现与首次通过行情筛选分别计时：等待补全后才首次达标的币可以正常提醒，但反复刷新、掉榜重入不会重新制造首提醒。补充行情只使用当前来源能证明的买卖笔数，不沿用旧 AVE 的买卖额或笔数冒充当前 5 分钟；没有分项美元额时保持未知，不估算伪造。

发现初选中，已知流动性不足3,000美元、DEV持仓超过1%、买卖税任一超过5%或相差超过2个百分点、明确近5分钟零成交，均不进入候选；8,000美元是更严格的深审流动性参考线，不会被冒充为初选门槛。未知值不会被包装成已确认安全。“已卖出”标签不能覆盖DEV的实际持仓数值，也不能把缺失的持仓当成零。

形态过滤复用原有约20分钟的1分钟K线，不新增逐币API请求。已收盘有效成交样本中，单分钟实体上涨至少35%、随后至少3根收盘价保持15%以内窄幅平台，或较早收盘高点后连续2根收盘价回撤至少60%，会按风险偏好排除。全部成交为零、时间断档、显著跨分钟价格断层、重复冲突或过期数据只标记待核验，不据此断言诈骗。最近5分钟的成交/回撤检查仍保留。

已确认的形态排除按链＋CA保存到本机 state/radar.json 的 riskExclusions，不因后续短暂横盘、切链、重启或候选列表到期自动取消。仅检查实际取得的窗口，无法追溯首次扫描前、窗口外或秒级走势；不保证挡住所有诈骗。无候选时不会放宽门槛补位。已有候选须重新通过新版规则才能提醒。

“候选雷达”复用后台最近一次 AVE 单页热榜结果，不另外订阅 20 秒榜单，也不会因页面开启自动更新而增加 AVE 请求。后台在全局范围内每 5 分钟最多发起一条链的热榜请求，多链轮询；限流时更新会按 8 或 15 分钟退避继续延后。界面展示实际采样时间，旧数据不会被改写成实时数据。它不是 WebSocket 推送或抢跑工具，也不是全链新币覆盖。

窗口先排除已知貔貅、刷量、高风险、创建不足5分钟和基础流动性不足的记录；未知风险仍明确为未核验。展示范围为市值1万–15万美元，可按2万–8万美元优先、5分钟成交额或最近出现排序。最近出现指首次进入当前有效候选窗口，不代表刚发币。新候选的语音资格仅保留 10 分钟；已通过筛选的线索因热榜轮换页暂时掉出时，可以“最近线索”最多展示 30 分钟，但会标为旧证据，不语音、不进入核验。当前数据出现筛选失败或硬风险时会立即移除；重新上榜也不会反复播报。首屏不伪造“新币”，榜单缺失也不填充演示数据。

免费快速模式默认关闭新增影子样本与历史 K 线回补。首页已移除表现验证和历史事件面板，旧记录仍保留在本机及导出资料中，并不代表系统正在持续统计胜率。代码中的可选验证流程支持按合约地址跟踪 5 分钟至 24 小时多个窗口，使用明确的时间与来源，不用当前价格冒充历史价格；只有显式启用并取得足够数据后，才有可分析的新样本。

深审拒绝组按合约地址哈希固定抽取约五分之一作对照，最多 200 条。两组分别展示到期数、完成数、缺失数与中位涨跌，不混成一个收益数字。缺失价格不是零收益；拒绝组抽样仅覆盖实际深审过的代币，不能代表所有新币。50 个样本只是最低观察门槛，不构成策略有效或盈利的证明。涨跌统计不含可成交性、滑点和手续费，不是模拟交易收益。

若 macOS 首次阻止打开下载的脚本，可在确认文件来源后通过“右键 → 打开”启动。首次安装需要网络；窗口中的安装错误会指出未完成的步骤。

已有 Node.js 22.23+ 或 24.5+ 的用户，在项目目录运行：

npm run setup
npm run open

npm run setup 检查 Node.js 与程序文件，npm run open 在后台启动本机服务并打开 http://127.0.0.1:3791/。AVE 扫描没有第三方 npm 运行依赖；Windows 与 Linux 仍需干净设备验证。

前台运行用 npm start；检查环境用 npm run doctor；测试用 npm test。端口占用时可通过 RADAR_PORT 指定另一端口；启动器不会覆盖其他程序或另一份项目。

开源版仅从本项目的受限状态文件读取 AVE API Key，不会读取环境变量、其他数据源的全局配置或项目 .env。连接验证和日常扫描不使用钱包、认证私钥、swap 或下单接口；任何网页响应都不会返回 Key。

运行记录在 state/、日志在 logs/、项目专用运行环境在 .runtime/，这些本机目录不应加入版本库或发布包。node_modules/ 不加入源码版本库或发布包；Windows 便携包附带 Node.js 运行环境。不要把 API Key 放进截图、代码或日志。

源代码采用 GNU Affero General Public License v3.0（AGPL-3.0-only）。可以使用、研究、修改和再发布；若修改后通过网络向他人提供服务，须按许可证向这些用户提供对应源代码。private: true 仅用于防止误发 npm。第三方数据接口仍受各自服务条款约束。开源版与专业版边界见 docs/EDITION-BOUNDARY.md。