职责
管理当前 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
常见意图 → 工具调用
| 用户说法 |
调用 |
| "先别推了" / "静音" |
notification_prefs(action="disable") |
| "恢复推送" / "开回来" |
notification_prefs(action="enable") |
| "只看重要的" |
notification_prefs(action="set_min_severity", value="high") |
| "一般的也推吧" |
notification_prefs(action="set_min_severity", value="medium") |
| "只推我持仓相关的" |
notification_prefs(action="set_portfolio_only", value=true) |
| "什么都推" |
notification_prefs(action="set_portfolio_only", value=false) |
| "不要新闻 / 不要分析师评级" |
notification_prefs(action="block_kinds", value=["news_critical","analyst_grade"]) |
| "只要财报和 SEC" |
notification_prefs(action="allow_kinds", value=["earnings_released","earnings_upcoming","sec_filing"]) |
| "别再限制 kind 了" |
notification_prefs(action="clear_allow") 或 clear_block |
| "价格涨跌到 8% 提醒，之后每 4 个点再提醒" |
notification_prefs(action="update_delivery_controls", value={"price_high_pct":8,"price_realert_step_pct":4}) |
| "看看现在是什么设置 / 实际会怎么提醒" |
notification_prefs(action="get_overview")，直接转发 display_text |
| "全部恢复默认" |
notification_prefs(action="reset") |
工作流
- 对非
get / get_overview / reset 的改动,先调一次 get 看当前状态,避免误覆盖。
- 同时修改价格首次阈值和阶梯步长时，使用一次原子的
update_delivery_controls，不要拆成两次写入。
- 修改后调用
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 不能绕过显式价格阈值；价格事件始终由最终价格策略判断。- 用户没说"所有人"、"全局"时,不要尝试改别人的配置——本工具构造时已硬绑定到当前用户,也没有这个能力。
1---2name: notification-preferences3description: 管理当前用户的市场事件推送偏好,把中文自然语言映射到 notification_prefs 工具4---56## 职责78管理当前 actor(也只能是当前 actor——工具在构造时已绑定身份)对市场事件推送的个人偏好。910## 合法 kind tag1112`allow_kinds` / `block_kinds` 的值必须从以下里选,其它值会被工具直接拒绝:1314```15earnings_upcoming, earnings_released, earnings_call_transcript,16news_critical,17price_alert, weekly52_high, weekly52_low,18dividend, split,19sec_filing, analyst_grade,20macro_event, social_post21```2223## 常见意图 → 工具调用2425| 用户说法 | 调用 |26|---------|------|27| "先别推了" / "静音" | `notification_prefs(action="disable")` |28| "恢复推送" / "开回来" | `notification_prefs(action="enable")` |29| "只看重要的" | `notification_prefs(action="set_min_severity", value="high")` |30| "一般的也推吧" | `notification_prefs(action="set_min_severity", value="medium")` |31| "只推我持仓相关的" | `notification_prefs(action="set_portfolio_only", value=true)` |32| "什么都推" | `notification_prefs(action="set_portfolio_only", value=false)` |33| "不要新闻 / 不要分析师评级" | `notification_prefs(action="block_kinds", value=["news_critical","analyst_grade"])` |34| "只要财报和 SEC" | `notification_prefs(action="allow_kinds", value=["earnings_released","earnings_upcoming","sec_filing"])` |35| "别再限制 kind 了" | `notification_prefs(action="clear_allow")` 或 `clear_block` |36| "价格涨跌到 8% 提醒，之后每 4 个点再提醒" | `notification_prefs(action="update_delivery_controls", value={"price_high_pct":8,"price_realert_step_pct":4})` |37| "看看现在是什么设置 / 实际会怎么提醒" | `notification_prefs(action="get_overview")`，直接转发 `display_text` |38| "全部恢复默认" | `notification_prefs(action="reset")` |3940## 工作流41421. 对非 `get` / `get_overview` / `reset` 的改动,先调一次 `get` 看当前状态,避免误覆盖。432. 同时修改价格首次阈值和阶梯步长时，使用一次原子的 `update_delivery_controls`，不要拆成两次写入。443. 修改后调用 `get_overview`，直接转发 `display_text`；它包含系统事件引擎和全局 kind 开关、继承的候选档、普通/大仓位最终阈值、重复步长来源、实际候选示例、每日 High 上限，以及普通同标的冷却对盘中价格阶梯的例外。不要只根据原始 `prefs` 猜测最终行为。4546## 注意4748- 用户一次说"只要财报",`allow_kinds` 的数组里需要包含 `earnings_upcoming` **和** `earnings_released`——两者是不同的 kind,只填一个会漏。49- `block_kinds` 优先级高于 `allow_kinds`。如果用户之前设过白名单,之后 block 一个重叠的 kind 也会生效。50- 全局(部署方)可能在 `config.yaml` 里把某个 kind 关了——那类事件无论如何都不会推给任何人,即使用户把它放进 `allow_kinds`。这条解释给用户,不要误以为是工具问题。51- `price_high_pct*` 是首次即时提醒阈值，`price_realert_step_pct` 是首次命中后的最小前进步长。系统 poller 只产生固定候选档；用户阈值不落在候选网格上时，真实首次 band 会向上落到下一条候选档，必须以 `get_overview` 返回的示例为准。52- `immediate_kinds` 里的 `price_alert` 不能绕过显式价格阈值；价格事件始终由最终价格策略判断。53- 用户没说"所有人"、"全局"时,不要尝试改别人的配置——本工具构造时已硬绑定到当前用户,也没有这个能力。
b-m-capital-research