For You 打分规则 v1

01节拍与动作

1.1 节拍

• 一个节拍 = 5 分钟。第 k 个节拍覆盖 (T[k−1], T[k]]。抓取时往前多取 10 分钟重叠，按 tid 去重，防止边界丢单。
• 每个节拍做四件事：拉增量成交与账本 → 更新行与帖子 → 重算所有存活帖子的 S → 重新分档、出 JSON。
• 人的分 P 不在节拍里算，节拍只读当天的 P。

1.2 监控集合

• 人工标注池（477 个）∪ 历史上进过任一资产前十大持仓的地址。
• 待定「进过」是累积的：每小时拉一次各资产前十大，写进一张只增不减的表 top10_seen(addr, coin, first_seen, last_seen, best_rank)。地址一旦进表就永远在监控集合里。
  A · 只增不减：掉出前十本身是信号（大额转出、换钱包），只看当前会丢掉这类事件；小币种前十抖动大，集合不会反复进出。代价是集合只涨不缩，几个月后混进清仓的死地址和偶然进榜的热钱包。

  B · 只看当前前十大：集合小而干净，每小时自动换血。代价是一个地址刚掉榜就停跟，它接下来的清仓、强平正是最该看的那一段。

  折中（建议）：表照 A 只增不减，但加一个活跃状态。近 30 天在过榜、或近 7 天有成交的地址才轮询和 AI 评分；其余留在表里不删、不轮询，一有成交重新激活。切到自家节点后轮询几乎不要钱，真正省的是 AI 评分那一笔。
• 主体类型为 做市商 / 交易所热冷钱包 / 项目方与协议 / 官方与系统 / 桥地址 的，留在集合里但 P = 0，永不成帖。

1.3 动作 = 行

沿用现有方法论的「行」：同地址、同币、同动作类型的相邻成交合并，间隔 ≤ 90 分钟（现货 120 分钟）视为同一行，仓位归零处强制断行，反手拆成「平掉原仓 + 从零开新仓」两行。动作类型：行前仓位为 0 → 建仓；行前仓位与变动同号 → 加仓（按浮盈浮亏分滚仓 / 补仓）；否则减仓（按盈亏分止盈 / 止损，归零为清仓）；被清算的是本人 → 强平；现货买卖；账本类 入金 / 出金 / 质押 / 解押 / 转入 / 转出。

1.4 跨节拍的行：原地更新，不重复发

• 帖子的身份 = (地址, dex, 币, 行的起始时间) 的哈希。跨节拍稳定，是已读去重的前提。
• 一行在第一次过门槛的节拍成帖；之后同一行来了新成交，就用累计数字更新原帖（滚仓 300 万变 350 万），不新发。B 用更新后的数字重算，衰减时钟以行内最后一笔成交时间为准。
• 行在 90 分钟无新成交或仓位归零时封行，之后不再变。

1.5 成帖门槛（可关）

建议保留一条低门槛，目的是过滤刷单噪音、控制存储，不是筛质量（质量由分档决定）：

• 名义 ≥ max(1 万美元, 0.5% 总资产) 或 |平仓盈亏| ≥ 5,000 美元 或 强平 → 成帖。
• 账本：USDC ≥ 5 万美元 或 HYPE ≥ 1,000 枚。
• 24 小时内行数 > 30 的地址：门槛抬到本地址窗口内最大一行的 35%、最大盈亏的 40%。
• THRESHOLD_ON = false 即全部成帖，低分帖自然沉到第 10 档。

02行为分 B 规则 · 0–10

四个归一化到 [0, 1] 的分量加权，再乘压制系数：

B_raw = 0.40 · size + 0.30 · type + 0.20 · result + 0.10 · context
B     = 10 · clamp(B_raw · m, 0, 1)

2.1 size 规模

• size_abs = clamp((log10(N) − 4) / 3, 0, 1)，N = 名义美元。1 万 → 0，10 万 → 0.33，100 万 → 0.67，1,000 万 → 1。
• size_rel = clamp(N / (0.3 · E), 0, 1)，E = 动作时总资产。仓位达到总资产 30% 记满分；E 未知记 0 并在后台标记；E 不足 1,000 美元（清仓后提空的账户）同样视为未知，避免 N / E 爆表。
• size = 0.7 · size_abs + 0.3 · size_rel。账本动作的 N = 转账金额。

2.2 type 动作类型

2.3 result 结果

• 清仓 / 强平 / 止盈 / 止损：result = clamp((log10|R| − 4) / 2, 0, 1)，R = 平仓盈亏减手续费。1 万 → 0，10 万 → 0.5，100 万 → 1。
• 补仓 / 滚仓：result = 0.5 · clamp((log10|U| − 4) / 2, 0, 1)，U = 动作结束时的浮盈浮亏。带着 200 万浮亏补仓是有信息的。
• 建仓、现货、账本：0。

2.4 context 市场语境

• 资产在热度榜前 5：0.6；前 12：0.3；否则 0。该资产 48 小时涨跌幅 ≥ 15%：再加 0.4。上限 1。
• 热度榜口径（2026-09-16 晚起）对齐 Hyperliquid 官方币种选择器的「热门」tab：候选 = 24h 成交 > 3,000 万美元的市场，按 24h 涨跌（标记价 ÷ 前一日价 − 1）取涨最多的 3 个 + 跌最多的 1 个为前 4（官方那 4 个），再按 |24h 涨跌| 补到 12 个。旧公式（2 × |涨跌| × 10 × min(1, 成交 / 300 万) + 1.2 × log10(1 + 成交 / 百万)）废弃：成交项让 BTC / ETH 小跌也常年霸榜。账本动作 context = 0。

2.5 压制系数 m（连乘）

• 平进平出：平仓且 |R| < 0.1% × N → × 0.5。
• 刷单地址：24 小时内行数 ≥ 30 → × 0.6。
• 相对太小：N < 1% × E 且 N < 10 万美元 → × 0.7。

03人的分 P AI · 0–10 · 每天一次

3.1 节奏

• 每天 UTC 00:30 一轮：过去 7 天有任何成交或账本动作的地址全部重评；其余地址每周评一次。
• 新进监控集合的地址：先用先验值，一小时内跑一个小批补评。
• 分数带时间戳。超过 14 天没有重评的地址退回先验值，后台标「过期」。

3.2 先验值（AI 未评时用）

公众人物/KOL 7；行为命名巨鲸 6；风投与财库 5；社区交易员 5；其他有备注 4；仅因上过前十大进池 3。有 X 账号 +1，有描述 +0.5，上限 10。排除类型 0。

3.3 喂给 AI 的「地址事实表」

3.4 AI 输出（结构化）

overall   0–10   综合分，就是 P
dims      影响力 fame / 实力 skill / 信号价值 signal / 戏剧性 drama，各 0–10
tags      ≤ 4 个短标签，如「方向性重仓」「对冲」「频繁强平」「新入场」
reason    ≤ 60 字，一句话理由
exclude   true / false，行为像做市、对冲、搬砖，不该进流

• 综合分是 AI 的整体判断，不是四个维度的公式，这是「prompt 驱动」的部分；但要求 |overall − mean(dims)| ≤ 2，超出视为不一致，整批重跑。
• 信号价值是关键维度：一个地址的动作有没有方向信息。做市、对冲、跨所搬砖的地址即使资金大也应低分或排除。
• exclude = true 直接令 P = 0，后台显示理由供人工复核。

3.5 让分数稳定的四条

1. 批内相对比较：每次请求送 25 个地址，AI 在同一批里比较着打，比逐个绝对打分稳。
2. 锚点：每批混入 3 个固定锚点地址（已定分，如某头部 KOL = 9、某典型标注巨鲸 = 6、某做市商 = 排除）。任一锚点偏差 > 1.5，整批作废重跑。
3. 平滑：已有旧分（≤ 14 天）时 P_new = 0.6 · AI + 0.4 · P_old，单日变动上限 ±2。
4. 只在输入变了才重评：事实表哈希没变的地址跳过，沿用旧分。

3.6 留痕

每条 P 记录 addr, P, dims, tags, reason, exclude, prompt_version, model, facts_hash, scored_at。评分标准那段 prompt 有版本号，改一次 prompt 就是一个新版本，后台按版本对比分数变化。

3.7 人的分变乘数

g(P) = (1 − κ) + κ · P / 5      κ = 0.5  →  g ∈ [0.5, 1.5]，P = 5 时 g = 1
P = 0 → 不成帖

κ 调大，人的权重更重（κ = 1 时 g ∈ [0, 2]）。

04时间衰减 D 按节拍 · 0–1

age  = 现在 − 行内最后一笔成交时间（小时）
D    = 1                               age ≤ 1
D    = 0.5 ^ ((age − 1) / H(B))        age > 1
H(B) = clamp(12 · 2^((B − 5) / 2), 6, 48)    小时

半衰期随行为分变。「特别大的行为可留」就是这一条，不用另立规则：

• 出场规则：age > 24 小时 且 B < 8 → 删除；age > 72 小时 → 一律删除。24 小时这一刀就是「超过 24 小时重要性骤降」。
• 时钟从行内最后一笔算：还在进行的 TWAP 每次更新都刷新时钟，行封了才开始老化。
• 首次部署回填 72 小时历史，按真实 age 算，出场规则自动裁掉不该留的。

D 每个节拍重算，所以「以每次跑为节点，新帖子进、最老的退」成立；只是「退」由 D 和出场规则决定，不是数量上限。

05合成、分档、出流

5.1 分档

• 每个节拍对所有存活帖子算 S，降序，切成 10 个等份（十分位），第 1 档最高。档的大小 = ceil(N / 10)，随存活数变，不写死 160。
• 帖子的档每个节拍都可能变：老的高分帖退场，第 2 档的会升到第 1 档。后台记录每帖的档位历史。

5.2 档内顺序

档内按行内最后一笔成交时间新在前，不按 S。分档管质量带，档内顺序管新鲜度，两件事分开。以后要加「随机」就是把这一条换掉，其余不动。

5.3 出流（每次刷新 / 每页）

候选 = 第 1 档 ∩ 该用户未读
按 5.2 排序，同一地址最多 2 条、同一资产最多 4 条
取 10 条；不够则拼接第 2 档未读，依此类推
返回的 10 条立即记为已读（已读表按帖子 id，72 小时过期）

• 未登录用户用 localStorage 存已读，同一套逻辑在前端跑。
• 帖子原地更新后不重置已读。内容不够时滑到低档，接受。

5.4 推送与刷新：什么会变、什么不会变

06后台展示

两张表，都按分数排，每个数字可以点开看来源。已按本节做成 打分后台，跑在 feed3.json 的真实帖子上。

07参数表

08算例

size_abs = (6.48 − 4)/3 = 0.83    size_rel = 300/(0.3×5000) = 0.20    size = 0.64
type = 0.80    result = (5.18 − 4)/2 = 0.59    context = 0.6
B = 10 × (0.256 + 0.240 + 0.118 + 0.060) = 6.7
g(9) = 1.4    age 0.5h → D = 1

size_abs = 0.90    size_rel = 500/(0.3×800) → 1    size = 0.93
type = 1.0    result = (6.08 − 4)/2 → 1    context = 0
B = 10 × (0.372 + 0.300 + 0.200 + 0) = 8.7
g(3) = 0.8

size_abs = 0.16    size_rel = 0.05    size = 0.13
type = 0.50    result = 0.5 × 0 = 0    context = 0.3
m: N < 1% E 且 N < 10 万 → × 0.7
B = 10 × (0.052 + 0.150 + 0 + 0.030) × 0.7 = 1.6
g(8) = 1.3

名人身份把一次中等清仓抬到第一档，但抬不动一次小补仓；无名氏的强平靠行为分自己站到前面。

08b实现状态 2026-09-15

• 第 2、3.2、3.7、4、5.1 节已实现：pipeline/scoring_v1.py（Python，gen_feed3 用它给 For You 排序）与 pipeline/admin_template.html（JS，打分后台交互重算）两份实现，后台页眉核对两边算出的 S 是否一致。
• 人的分：先验值 + 手调（pipeline/p_overrides.json，手调优先，0 = 不进流）。3.1、3.3 到 3.6 的 AI 评分暂不做。
• 节拍：每 5 分钟一拍（tick.sh：只抓每个地址上次之后的成交，全量重算，发布），每 4 小时一次全量兜底；改分数后 rescore-foryou 一分钟重算发布。
• 2.1 补充：总资产不足 1,000 美元视为未知（清仓后提空的账户）。

08c人优先模式与头像加成 2026-09-15 晚上线

用户两条要求：人比行为和时间衰减重要得多；首页尽量是有头像的帖子。落地为三处，默认开启，参数在后台可调：

合成公式换主轴：S = P × (1 + B/10) × D′。P 是主轴，行为分只在 1 到 2 倍之间放大；D′ 在 P_GRACE = 6 小时内不衰减，之后半衰期 P_HALF = 36 小时（对所有帖子一样，不随 B 变），P_EXIT = 48 小时出场。PERSON_FIRST = 0 可回到 v1 的 S = B × g(P) × D。

P 的来源分三层：手调（p_overrides.json）> AI 主观分（地址池体检/p_scores.json，v2：只看名字的认知度与故事性）> 先验值。排除类型仍是 0。

头像加成：作者是「人」（KOL / 社区交易员 / 行为命名巨鲸），有 X 头像且粉丝 ≥ AV_MIN_FOL = 5000，P 加 AV_BONUS = 2（封顶 10）。后台来源列显示「主观v2+头像」。

有头像的人成帖门槛放低（gen_feed3 CFG）：绝对下限 2 万 → 5 千美元，相对下限 12% → 3% 本地址最大行，盈亏下限 1 万 → 2 千；刷单地址的抬高从 35% 最大行改为 10%。麻吉 48 小时 80 行原来只成 8 帖，就是被 12% / 35% 两条相对门槛挡住的。

供给的上限：活 feed 918 条存活帖子里，有头像且粉丝 ≥ 5000 的作者只有 11 条帖子。排序只能把这些顶上去，变不出更多。要让首页真正「尽量有头像」，还得：把 KOL 推特流（/xfeed/ 的流③）作为帖子并进来；给更多地址标上 X（这是标注工作）。

08dbuilder 头部用户加成 2026-09-16

用户要求：builder app 的头部用户要突出，权重抬高、多出现在时间线上；时间线和各榜单上要能看出他是哪家 builder 的，放 builder 头像。

数据：flowscan builder intelligence 全量主表 746,890 个地址，取「总榜前 1000 ∪ 每家有名 builder 各自前 100（按累计 builder fee）」= 4,432 个地址 → builders_top.json（主 builder、本 builder 名次 rb、总榜名次 r、累计 / 30 日 / 7 日 fee）。builder logo 来自 flowscan 的 /logos/ 静态图，47 家 → builders_logo.json。

加成（叠在 P 上，封顶 10，后台参数可调）：本 builder 交费第 ≤ 20 名 +3；≤ 100 名 +2；总榜 ≤ 1000 名 +1。后台来源列显示「+builder」，算式里写清是哪家第几名。

候选：近 7 日有 builder fee 的头部用户（730 个）全部进全网候选，交费越多分越高，保证他们的动作被抓到。

展示：帖子卡片、地址主页、发现地址（Pro 表）、热门地址、悬浮卡、KOL 榜、推特流上，名字旁边一个圆形 builder logo + 名字的小徽章，悬停看「交费第几名」。

09与现有代码的对应

现有 gen_feed3.py 的 score = 名气 + 规模 + 动作 + 盈亏 + 相对规模 + 时效 + 热度，改动是替换不是推倒：