Notification Preferences

职责

管理当前 actor(也只能是当前 actor——工具在构造时已绑定身份)对市场事件推送的个人偏好。

合法 kind tag

allow_kinds / block_kinds 的值必须从以下里选,其它值会被工具直接拒绝:

earnings_upcoming, earnings_released, earnings_call_transcript,
news_critical,
price_alert, weekly52_high, weekly52_low,
dividend, split,
sec_filing, analyst_grade,
macro_event, social_post

常见意图 → 工具调用

工作流

1. 对非 get / get_overview / reset 的改动,先调一次 get 看当前状态,避免误覆盖。
2. 同时修改价格首次阈值和阶梯步长时，使用一次原子的 update_delivery_controls，不要拆成两次写入。
3. 修改后调用 get_overview，直接转发 display_text；它包含系统事件引擎和全局 kind 开关、继承的候选档、普通/大仓位最终阈值、重复步长来源、实际候选示例、每日 High 上限，以及普通同标的冷却对盘中价格阶梯的例外。不要只根据原始 prefs 猜测最终行为。

注意

• 用户一次说"只要财报",allow_kinds 的数组里需要包含 earnings_upcoming 和 earnings_released——两者是不同的 kind,只填一个会漏。
• block_kinds 优先级高于 allow_kinds。如果用户之前设过白名单,之后 block 一个重叠的 kind 也会生效。
• 全局(部署方)可能在 config.yaml 里把某个 kind 关了——那类事件无论如何都不会推给任何人,即使用户把它放进 allow_kinds。这条解释给用户,不要误以为是工具问题。
• price_high_pct* 是首次即时提醒阈值，price_realert_step_pct 是首次命中后的最小前进步长。系统 poller 只产生固定候选档；用户阈值不落在候选网格上时，真实首次 band 会向上落到下一条候选档，必须以 get_overview 返回的示例为准。
• immediate_kinds 里的 price_alert 不能绕过显式价格阈值；价格事件始终由最终价格策略判断。
• 用户没说"所有人"、"全局"时,不要尝试改别人的配置——本工具构造时已硬绑定到当前用户,也没有这个能力。