nhovongoc0-max/meme-radar

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

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

增强稳定性。

• 动态中心雷达、伸缩触手与游动节点；真实候选具名并持续连线，无名装饰不触发提醒。
• 每次打开默认选择 BSC；顶部选择哪条链，后台就只扫描哪条链。旧多链轮询配置会迁移为 BSC，备注与额度记录保留。
• 首屏及切链立即读取已有候选缓存，不必等待下一次页面轮询，不增加 AVE 请求。
• 修复活跃代币因缺少可选历史资料被整批隐藏的问题；观察线索仍标为未核验，已知风险继续拦截。
• 卡片直达 AVE；新出现的初筛/最近线索支持中英文语音提醒、置顶高亮，同链同合约去重，不代表通过安全核验。
• 请求串行与失败退避，行情补全轮换，保留免费 API 的限频和预算保护。
• 请求超时取消响应读取，卡住后由守护恢复；启动核对版本，防止误开旧进程。动画效果保持不变。

更新记录见 v2.1.2。

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

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

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

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

安全推荐限制： AVE 收录状态和关联持仓风险尚无可靠证据适配器，安全推荐及桌面新币推荐通知仍关闭。“观察线索语音”独立运行：初筛/最近线索可提醒、置顶，但仍标明未核验，不代表推荐或安全通过。

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

AVE 行情初选不等于安全审计。未通过行情初筛或已命中明确风险排除的币不会进入语音提醒；先前通过初筛且尚在展示期限内的“最近线索”可以提醒，但原行情时间和旧证据标签不变。未获取的合约安全字段仍为未核验，不能用声音提醒当作安全背书。

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

观察提醒覆盖已启用的扫描链，仅对首次通过初筛后 30 分钟内、仍在当前行情或最近线索展示范围且未命中已知风险排除的新线索播放。首次打开、重新开启和断线恢复不追播旧线索。每批合并一句，最多每分钟一次，同一链＋合约地址 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分钟成交额或最近出现排序。最近出现指首次进入当前有效候选窗口，不代表刚发币。已通过行情初筛的线索因热榜轮换页暂时掉出时，可以“最近线索”最多展示 30 分钟，但会标为旧证据、不进入核验。初次入选后 30 分钟内的新线索可进行观察语音提醒，提醒不刷新行情时间、不代表安全推荐；开启前已存在的线索不补播，跨标签、切链和重新上榜不反复播报。当前数据出现筛选失败或硬风险时会立即移除。首屏不伪造“新币”，榜单缺失也不填充演示数据。

V2.1 将可选历史证据与当前行情初筛分开：6 小时以上的活跃币，缺少同池历史资料不再被当成已知风险直接隐藏，仍以未核验观察线索展示；有明确深度回撤等风险证据时仍按规则过滤。缺失资料不等于安全通过，也不会因此恢复严格模式的推荐提醒。

免费快速模式默认关闭新增影子样本与历史 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。