# Notification Preferences

> 管理当前用户的市场事件推送偏好,把中文自然语言映射到 notification_prefs 工具

- Skill: `b-m-capital-research/notification-preferences` (Agent Skill)
- Install (CLI): `npx skillmds@latest add b-m-capital-research/notification-preferences`
- Raw SKILL.md: https://api.skillmd.com/api/skills/b-m-capital-research/notification-preferences/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: b-m-capital-research (https://skillmd.com/u/b-m-capital-research)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/b-m-capital-research/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
```

## 常见意图 → 工具调用

| 用户说法 | 调用 |
|---------|------|
| "先别推了" / "静音" | `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")` |

## 工作流

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` 不能绕过显式价格阈值；价格事件始终由最终价格策略判断。
- 用户没说"所有人"、"全局"时,不要尝试改别人的配置——本工具构造时已硬绑定到当前用户,也没有这个能力。