PigCanFly1001/unitytool-agent-radar

项目介绍

Agent Radar 是一个自托管的 Web 看板，用来观察 BNB Smart Chain 上的 AI Agent 钱包。它索引所有持有 Binance Agent ID（.ai 身份 NFT）的钱包，记录这些钱包的买卖、铸造和领取行为。首页按选定时间窗内独立 Agent 钱包数给项目排序，旁边是实时动态流。

项目详情页把行情、开盘进度、Agent 交易明细、按动作类型分色的活跃节奏、参与最多的钱包和提醒记录放在一起。合约审计会汇总项目方持仓与抛售、LP 归属、合约权限、持币合约、卖出模拟和第三方安全数据，给出高危/中危/低危结论，任意 BSC 代币都可以按需审计。钱包页提供盈利榜、活跃榜和单钱包盈亏画像。项目、钱包、审计都有独立分享链接，贴到 Discord、Telegram 或 X 会显示预览卡片；Agent ID 持有者会解析出 .ai 名字。

它适合想观察 BSC 链上 Agent 行为和代币风险、并且愿意自己运行节点服务的人。

快速使用

需要 Node.js 22.5 以上；项目零 npm 依赖，使用内置 SQLite。

cp config.example.json config.json   # 按需修改 RPC
node server/index.js                 # → http://127.0.0.1:8096

也可以用 Docker 部署：

cp config.example.json config.json
docker compose up -d --build

打开提示的地址，在 Live 榜单上选择时间窗，即可看到项目排名和动态流。健康检查走 GET /healthz。要对外提供 HTTPS，可在 8096 端口前放 Caddy 或 Nginx，为 Server-Sent Events 关闭代理缓冲，并设置 TRUST_PROXY=1，让限流按真实客户端 IP 生效。

配置写在 config.json 或环境变量里：监听地址（PORT/HOST）、SQLite 路径（DB_PATH）、BSC RPC 端点（BLOCK_RPCS/LOGS_RPCS）、可选的归档 RPC（HOLDER_RPCS）、用于补充图标和社交信息的 GMGN_API_KEY、品牌字段、用于预览卡片的 PUBLIC_URL，以及限流和 SSE 连接数限制。预览卡片图片需要 TrueType 字体，通过 OG_FONT/OG_FONT_BOLD 指定；Docker 镜像本身不带字体。

使用约束

• 不配 HOLDER_RPCS 归档节点（需要自己的 key）也能运行，但只回放近期历史，持币名单和 .ai 名字解析不完整。
• SSE 连接要求代理关闭缓冲；放在反向代理后面时需要通过 TRUST_PROXY=1 转发真实客户端 IP。
• 许可为源码公开而非开源：UnityTool Non-Commercial Source License 1.0 仅允许个人非商业运行、研究和修改，未经书面许可禁止商业使用及用于 AI/ML 训练；顶栏品牌信息必须保持可见。
• 项目自述为信息工具，不构成投资建议。

HotRepo 点评

该项目在 2026-11-05 进入 HotRepo 新项目榜，记录为 104 Star、36 Fork，在 14:45 至 15:45 UTC 的一小时窗口内新增 2 Star。对一个受限非商用许可下的自托管看板来说，这一短窗口内 Fork 与 Star 的比例偏高；但只有一条记录，不足以判断趋势。值得权衡的技术点是持币数据完整性：默认不配归档 RPC 也能跑，但只回放近期历史，因此想要完整钱包覆盖的人需要准备归档节点 key。

项目源码与说明