openclaw-glance-plugin 0.1.22 → 0.1.28

package/README.md

@@ -10,6 +10,8 @@
 
 本项目当前以 OpenClaw 插件模式运行（`index.js` + `openclaw.plugin.json`），保持长连接并接收 `watch.triggered`，并对同一 `baseWsUrl + token` 启用严格单活锁，防止重复实例。
 
+**网络边界**：插件进程**只通过 WebSocket 连接 `openclaw-bridge`**（盯盘、行情 `ticker.query`、基金估值 `fund.estimates`、直连通知等），**不直连 MySQL** 或其它后端；库表/日终类数据若需暴露，应由 bridge 代理 **financial-data-gateway** 后再接工具（当前未内置 `finance_*` 工具）。
+
 ## OpenClaw 调用时机（插件模式）
 
 - 用户新建盯盘：调用 `submitWatchDemand` 或 `createWatch`
@@ -21,7 +23,7 @@
 ## 功能
 
 - 与 `openclaw-bridge` 建立 WebSocket 长连接
-- 支持请求：`watch.create` / `watch.activate` / `watch.pause` / `watch.delete` / `ticker.query` / `notify.send` / `ping`
+- 支持请求：`watch.create` / `watch.activate` / `watch.pause` / `watch.delete` / `ticker.query` / `fund.estimates` / `finance.table`（网关白名单只读表：A 股/港股/指数/基金基础检索、快讯、交易日历）/ `notify.send` / `ping`
 - 支持渠道：`openclaw` / `email` / `call` / `sms` / `dingtalk`
   - 建议在 `channel_configs.openclaw` 中携带路由字段（如 `channel`、`session_key`、`account_id`、`conversation_id`），便于触发后回推到正确会话
 - 订阅推送：`watch.triggered`
@@ -30,6 +32,7 @@
 - 严格单活（同 token 只允许一个活跃进程）
 - 断线请求排队（可配置），重连后自动冲刷
 - 提供业务适配层 `OpenClawPluginAdapter`
+- Agent 友好：行情 `market` 支持中文别名（A股→a 等）；检索/新闻统一 `keyword`/`q`；交易日历支持 `startDate`/`endDate`；缺参时抛出明确英文错误便于模型自纠
 
 ## 安装
 
@@ -37,9 +40,10 @@
 npm install
 ```
 
-## 测试
+## 测试与静态检查
 
 ```bash
+npm run lint
 npm test
 ```
 
@@ -126,7 +130,7 @@ await adapter.submitWatchDemand({
 
 ## 插件工具（OpenClaw 调用）
 
-- `watch_query_ticker`
+- `watch_query_ticker`：参数 `market`（`a` / `hk` / `crypto`）、`symbol`、可选 `segment`，与 financial-data-gateway `GET /v1/market/quote` 一致
 - `watch_create`
 - `watch_list`
 - `watch_pause`

package/openclaw.plugin.json

@@ -14,7 +14,6 @@
       "lockDir": {
         "type": "string"
       }
-    },
-    "required": ["token"]
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-glance-plugin",
-  "version": "0.1.22",
+  "version": "0.1.28",
   "description": "OpenClaw plugin client for ticker-monitor openclaw-bridge",
   "type": "module",
   "main": "index.js",
@@ -23,6 +23,7 @@
   "scripts": {
     "start": "node examples/basic.js",
     "start:adapter": "node examples/adapter.js",
+    "lint": "node --check src/agentQueryNormalize.js src/OpenClawBridgeClient.js src/OpenClawPluginAdapter.js src/index.js src/openclawRouting.js src/config/runtime-config.js src/plugin/index.js src/runtime/BridgeRuntime.js src/runtime/lock/ProcessLock.js src/runtime/dispatchers/PluginDispatcher.js",
     "test": "node --test tests/**/*.test.js"
   },
   "engines": {

package/skills/glance-watch/SKILL.md

@@ -1,39 +1,74 @@
 ---
 name: glance-watch
-description: 智能盯盘插件，用于监控A股、港股、比特币等金融市场行情并在条件触发时发送提醒。当用户要求盯盘、监控价格、设置提醒、需要通过邮件/电话/短信/钉钉发起通知时自动触发，例如"帮我盯着比特币"、监控某只股票、涨跌幅提醒、短信通知我等。
+description: 用于监控A股、港股、比特币等金融市场行情并在条件触发时发送提醒。当用户要求盯盘、监控价格、设置提醒、需要通过邮件/电话/短信/钉钉发起通知、查询A股港股指数加密与基金行情、名称查代码、交易日历、快讯时使用，例如"帮我盯着比特币"、监控某只股票、涨跌幅提醒、短信通知我、这个月交易日有哪些、有哪些新闻等。
 ---
 
 # Glance Watch 智能盯盘（主入口）
 
-## 目标
-
-用最小上下文完成三类任务：
-- 查行情：`watch.query_ticker`
-- 建/管策略：`watch.create` / `watch.list` / `watch.pause` / `watch.activate` / `watch.remove`
-- 立即通知：`notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
+## 能力优先级（必须遵循）
+
+P0（最高）策略能力：
+- 面向 **A股个股、港股个股、A股/港股指数、比特币** 创建/查询/暂停/恢复/删除盯盘策略。
+- 仅用：`watch_create` / `watch_list` / `watch_pause` / `watch_activate` / `watch_remove`。
+- **禁止**：对基金创建盯盘策略（包括场外基金 `xxxxxx.OF`）。
+
+P1 行情能力（为策略创建提供上下文）：
+- 个股/指数/比特币实时行情：`watch_query_ticker`
+- 基金当日估值：`watch_query_fund_estimates`
+
+P2 标的解析能力（创建策略前补齐参数）：
+- 先查本地 CSV（`skills/glance-watch/data/*.csv`）做名称/代码映射。
+- 本地不确定再用网关基础信息检索：
+  `watch_search_a_stock_basic` / `watch_search_hk_stock_basic` / `watch_search_index_basic` / `watch_search_fund_basic`
+
+P3 辅助能力：
+- 交易日历：`watch_trade_calendar`
+- 财经快讯：`watch_fin_news`
+- 立即发送通知：`notify_sms` / `notify_call` / `notify_email` / `notify_dingtalk`
+
+## 工具清单（工具名必须完全一致）
+
+- 工具名统一使用下划线形式（如 `watch_query_ticker`），不要写成点号形式（如 `watch.query_ticker`）。
+
+- `watch_query_ticker`
+- `watch_query_fund_estimates`
+- `watch_search_a_stock_basic`
+- `watch_search_hk_stock_basic`
+- `watch_search_index_basic`
+- `watch_search_fund_basic`
+- `watch_fin_news`
+- `watch_trade_calendar`
+- `watch_create`
+- `watch_list`
+- `watch_pause`
+- `watch_activate`
+- `watch_remove`
+- `notify_sms`
+- `notify_call`
+- `notify_email`
+- `notify_dingtalk`
 
 ## 调用契约（硬约束）
 
-### 统一动作名
+### Agent 选型（先选工具再填参）
 
-- `watch.query_ticker`
-- `watch.create`
-- `watch.list`
-- `watch.pause`
-- `watch.activate`
-- `watch.remove`
-- `notify.sms`
-- `notify.call`
-- `notify.email`
-- `notify.dingtalk`
+| 用户说法 | 第一步工具 | 下一步 |
+|----------|------------|--------|
+| 现价/涨跌/几块钱（**已有代码**） | `watch_query_ticker` | `market`+`symbol`；`market` 可用 **A股/港股/加密** 等中文别名 |
+| 现价但**只有公司或指数名** | 查询`skills/glance-watch/data/*.csv`或 `watch_search_*_basic` | 从 `data[]` 取 `ts_code` 再 `watch_query_ticker` |
+| 基金**今天估值** | `watch_query_fund_estimates` | `fund_codes`；勿用 `watch_query_ticker` |
+| 基金**档案/是不是这只基** | `watch_search_fund_basic` | `ts_code` 或 `keyword` |
+| 要创建基金盯盘策略 | 不调用 `watch_create` | 明确告知“当前仅支持A股港股的股票/指数或比特币盯盘；基金仅支持估值查询” |
+| **新闻/快讯** | `watch_fin_news` | 必须有关键词 `keyword` 或 `q` |
+| **开不开盘/休市/交易日** | `watch_trade_calendar` | `exchange`（如 SSE/SZSE）+ `start_date`+`end_date`（单日则相同） |
 
-### 调用顺序
+### 调用顺序（与上表一致）
 
-1. 用户问“现在多少钱/查行情” -> 先 `watch.query_ticker`
-2. 用户要“盯盘/提醒” -> 补齐参数后 `watch.create`
-3. 用户要“看我的策略” -> `watch.list`
-4. 用户要“暂停/恢复/删除” -> `watch.pause` / `watch.activate` / `watch.remove`
-5. 用户要“马上发通知” -> 对应 `notify.*`
+1. **盯盘策略任务**优先：`watch_create/watch_list/watch_pause/watch_activate/watch_remove`
+2. 创建策略若缺代码或市场：先本地 CSV，再 `watch_search_*_basic`
+3. 代码已明确再查实时价：`watch_query_ticker`
+4. 基金只做估值/基础信息：`watch_query_fund_estimates` 或 `watch_search_fund_basic`
+5. 再处理辅助任务：`watch_trade_calendar` / `watch_fin_news` / `notify_*`
 
 ### 创建策略最小必填
 
@@ -44,56 +79,89 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - `operator_parameters.variables`
 
 缺任一项先追问，不猜测阈值。
+若 `product_type` 为基金（或代码为 `xxxxxx.OF`），拒绝创建并改为提供基金估值查询方案。
+
+### 渠道选择规则（`watch_create`）
+
+- `channels` 至少包含 1 个渠道。
+- 若用户明确表达“仅/只用某几个渠道”，严格按用户指定，不强制补 `openclaw`。
+- 若用户表达“用某个渠道（如 call）”但未明确“仅限”，默认在用户指定渠道基础上补 `openclaw`。
+- 未经用户要求，不额外附加除 `openclaw` 外的其他渠道。
+
+#### “仅限渠道”判定词（小模型必用）
+
+- 判定为“仅限”的典型说法：
+  - `只用X` / `仅用X` / `只能用X` / `不要其他渠道`
+  - `除了X都不要` / `就X就行` / `别发到openclaw`
+- 判定为“非仅限”的典型说法：
+  - `用X` / `加上X` / `再加X` / `X也发一下`
+  - `帮我走X渠道`（未出现“只/仅/不要其他”）
+- 歧义处理：
+  - 若用户表达不清，先追问一句：`是否仅使用这些渠道，不包含 openclaw？`
+  - 未得到“仅限”确认前，按“非仅限”处理（可补 `openclaw`）。
 
 ### 绝对禁止项
 
 - `operator_type` 不是 `rule`
 - 把 `condition` 放到顶层（必须在 `operator_parameters.condition`）
 - 把 `channel_configs.*` 传成 JSON 字符串（必须是对象）
-- 用户未要求的渠道被默认附加
-- 通过 `watch.list` 传 `user_id/use_id` 越权查询
+- 用户明确“仅/只用某几个渠道”时，仍强行附加其他渠道
+- 通过 `watch_list` 传 `user_id/use_id` 越权查询
+- 用 `watch_query_ticker` 查**场外基金估值**（应使用 `watch_query_fund_estimates`）
+- 对基金调用 `watch_create`
+
+### 联系人 CSV（强约束，适用于 `watch_create` 与 `notify_*`）
+
+- 联系人真源：`~/.openclaw/workspace/memory/watch-notify-contacts.csv`
+- 只要请求涉及 `call/sms/email/dingtalk`，调用前必须先查 CSV。
+- 取值优先级固定：
+  1. 本轮用户明确提供
+  2. CSV 历史值补全
+  3. 仍缺必填字段 -> 追问
+- 当本轮用户提供了新联系方式，且 `watch_create` 或 `notify_*` 调用成功，必须回写 CSV。
+- 禁止依赖其他联系人文件（如 json）代替该 CSV。
 
 ## 渐进式披露（按需读取）
 
 仅在命中场景时读取对应文档，不要一次性加载全部 references。
 
-- `watch.create/list/pause/activate/remove` 细节与成功判定：`references/watch-contract.md`
-- 标的检索、行情查询流程：`references/query-and-symbol.md`
-- 渠道参数、OpenClaw 路由、联系人记忆、`notify.*` 模板：`references/channels.md`
+- 盯盘策略（创建/管理）：`references/watch-contract.md`
+- 直连通知（短信/电话/邮件/钉钉）：`references/channels.md`
+- 实时行情（股/指/加密）与基金估值：`references/quote-realtime.md`
+- 标的检索 + 是否交易日：`references/symbol-search-and-calendar.md`
+- 快讯：`references/news-briefing.md`
 - 示例 payload：`references/examples.md`
-- 重试、错误码、离线补发：`references/troubleshooting.md`
-- 市场与代码速查：`references/markets.md`
+- 重试与排错：`references/troubleshooting.md`
 
 ## 决策表（强约束）
 
-先判定用户主意图，再只读取最小文档集合：
-
 | 用户主意图 | 必读文档（最小集合） |
 |---|---|
-| 查行情/当前价格/报价 | `references/query-and-symbol.md` |
-| 创建盯盘策略（代码和市场已明确） | `references/watch-contract.md` |
-| 创建盯盘策略（名称或市场不明确） | `references/watch-contract.md` + `references/query-and-symbol.md` |
-| 创建盯盘 + 指定通知渠道 | `references/watch-contract.md` + `references/channels.md` |
-| 管理策略（list/pause/activate/remove） | `references/watch-contract.md` |
-| 立即发通知（notify.*） | `references/channels.md` |
-| 失败排查/补发说明 | `references/troubleshooting.md` |
-| 市场或代码速查 | `references/markets.md` |
+| 创建/管理盯盘策略 | `references/watch-contract.md` |
+| 查行情（股/指/加密）/ 基金估值 | `references/quote-realtime.md` |
+| 名称→代码 / 交易日判断 | `references/symbol-search-and-calendar.md` |
+| 快讯 | `references/news-briefing.md` |
+| 立即发通知 | `references/channels.md` |
+| 失败排查 | `references/troubleshooting.md` |
 
 执行规则：
-1. 一次请求默认只读 1-2 个 references 文件。
+1. 一次请求默认只读 1–2 个 references 文件。
 2. 仅当当前文档无法回答时，再追加读取下一个文档。
-3. 读取顺序遵循上表，不按“完整性”一次加载所有文档。
+3. 读取顺序遵循上表，不按「完整性」一次加载所有文档。
 
 ## 小模型执行模板（7B）
 
 1. 先按固定字段骨架生成 payload，不自创字段名。
 2. 只替换值：`product_code/product_type/operator_parameters/channels/channel_configs`。
-3. 调用前逐条自检“绝对禁止项”。
-4. 若报 `400` 且提示“未注册的算子类型”，把 `operator_type` 纠正为 `rule` 后重试。
+3. 调用前逐条自检「绝对禁止项」。
+4. 若报 `400` 且提示「未注册的算子类型」，把 `operator_type` 纠正为 `rule` 后重试。
 
 ## 快速分流
 
-- 用户说“帮我盯 BTC 跌 2% 提醒” -> 读取 `references/watch-contract.md` + `references/channels.md`
-- 用户说“腾讯现在多少钱” -> 读取 `references/query-and-symbol.md`
-- 用户说“发短信给我” -> 读取 `references/channels.md`
-- 用户说“为什么没发出来” -> 读取 `references/troubleshooting.md`
+- 用户说「帮我盯 BTC 跌 2% 提醒」 -> `references/watch-contract.md` + `references/channels.md`
+- 用户说「腾讯现在多少钱」 -> `references/quote-realtime.md`（如缺代码再读 `references/symbol-search-and-calendar.md`）
+- 用户说「这只基金今天估值多少」 -> `references/quote-realtime.md`（`watch_query_fund_estimates`）
+- 用户说「今天 A 股开不开盘」 -> `references/symbol-search-and-calendar.md`（`watch_trade_calendar`，SSE/SZSE）
+- 用户说「发短信给我」 -> `references/channels.md`
+- 用户说「有什么央行快讯」 -> `references/news-briefing.md`
+- 用户说「为什么没发出来」 -> `references/troubleshooting.md`

package/skills/glance-watch/references/channels.md

@@ -1,27 +1,58 @@
-# 渠道与通知参数
+# 直连通知（notify_*）
 
-## 渠道策略
+## 适用工具
 
-- `openclaw` 渠道默认必带（用于回当前会话）。
-- `email/call/sms/dingtalk` 仅在用户明确要求时添加。
+- `notify_sms`
+- `notify_call`
+- `notify_email`
+- `notify_dingtalk`
 
-## OpenClaw 会话路由
+## 统一规则
 
-当 `channels` 包含 `openclaw` 时，`channel_configs.openclaw` 必须可定位当前会话。
+- 仅在用户明确要求时调用直连通知。
+- 不手动传 `request_id`。
+- 返回 `success === true` 视为成功。
+- 失败时直接反馈 `code/error/hint`，不静默重试。
+- 联系人记忆规则同时适用于：
+  - `notify_*`
+  - `watch_create`（当渠道含 `call/sms/email/dingtalk`）
 
-常用字段：
-- `channel` 或 `source_channel`
-- `account_id`
-- `session_key`
-- `conversation_id` 或 `chat_id`
+## 参数要求
 
-约束：
-- 拿不到路由信息时，不得传空对象 `openclaw: {}` 假装已配置。
-- 宿主传入 `context` 时，插件运行时只负责合并 openclaw 路由字段。
+### `notify_sms`
+- `receiver`（或 `phone`）
+- `template_id`
+- `content`
 
-## 联系人记忆（Agent/OpenClaw 侧 CSV）
+### `notify_call`
+- `phone`
+- `customer_name`
+- `condition`
 
-真源：`~/.openclaw/workspace/memory/watch-notify-contacts.csv`
+### `notify_email`
+- `to_address`
+- `template_id`
+- `title`
+- `content`
+
+### `notify_dingtalk`
+- `cas_id`
+- `template_id`
+- `msg_type`（`text` 或 `markdown`）
+- `content`
+
+## 联系人记忆（强约束）
+
+联系人 CSV：`~/.openclaw/workspace/memory/watch-notify-contacts.csv`
+
+执行要求：
+1. 触发条件：`notify_*` 或 `watch_create` 使用 `call/sms/email/dingtalk` 时，调用前必须查 CSV。
+2. 文件初始化：CSV 不存在时，先创建文件并写入标准表头后再查询。
+3. 表头修复：CSV 存在但无表头时，先补表头再继续。
+4. 权限异常：若无权限读/写该 CSV，先向用户申请权限后再执行，不静默降级。
+5. 取值优先级：本轮用户明确提供 > CSV 历史值 > 追问。
+6. 回写条件：调用成功且联系方式有更新时，必须回写 CSV。
+7. 文件唯一性：只认该 CSV，不读取其他联系人文件。
 
 建议表头：
 
@@ -29,62 +60,26 @@
 channel,sender_id,sender_name,phone,email,dingtalk_cas_id,customer_name,updated_at,notes
 ```
 
-执行要求：
-1. 凡是 `watch.create` 或 `notify.*` 涉及 `call/sms/email/dingtalk`，调用前必须先查询该 CSV。
-2. 取值优先级固定为：
-   - 本轮用户明确提供
-   - CSV 历史默认值
-   - 仍缺必填字段 -> 追问
-3. 若用户在本轮提供了新的联系方式，且本次 `watch.create` / `notify.*` 成功，必须回写 CSV。
-4. 联系人记忆只认该 CSV；不依赖、不读取、不提及 `watch-notify-contacts.json`。
-5. 若 CSV 不存在，先创建带表头的文件，再写入首条联系人记录。
-
 查询示例：
 
 ```bash
-rg -n '^dingtalk,jinguo\.xie,' ~/.openclaw/workspace/memory/watch-notify-contacts.csv
+rg -n '^sms,jinguo\.xie,' ~/.openclaw/workspace/memory/watch-notify-contacts.csv
 ```
 
-写回要求：
-- 已有同一 `(channel, sender_id)` 记录时，更新该行，不重复追加。
-- 不存在时，按表头字段顺序追加新行。
-- `updated_at` 使用当前会话时区时间的 ISO-8601 字符串。
-
-## `watch.create` 渠道必填
-
-- 选 `email` -> `channel_configs.email.to_address/template_id/title/content`
-- 选 `call` -> `channel_configs.call.phone/customer_name/condition`
-- 选 `sms` -> `channel_configs.sms.receiver(或phone)/template_id/content`
-- 选 `dingtalk` -> `channel_configs.dingtalk.cas_id/template_id/msg_type/content`
+回写要求：
+- 已有同一 `(channel, sender_id)`：更新该行，不重复追加
+- 不存在：按表头顺序追加
+- `updated_at`：写 ISO-8601 时间
 
-## `notify.*` 参数
+## 常见禁止项
 
-- `notify.sms`: `receiver(或phone)`、`template_id`、`content`
-- `notify.call`: `phone`、`customer_name`、`condition`
-- `notify.email`: `to_address`、`template_id`、`title`、`content`
-- `notify.dingtalk`: `cas_id`、`template_id`、`msg_type`、`content`
-
-固定模板：
-
-```javascript
-// notify.sms
-{ receiver: '13800138000', template_id: 90010, content: '测试消息1' }
-
-// notify.call
-{ phone: '13800138000', customer_name: 'Demo', condition: '比特币跌幅超过2%' }
-
-// notify.email
-{ to_address: 'demo@example.com', template_id: 4, title: '监控提醒', content: '测试消息1' }
-
-// notify.dingtalk
-{ cas_id: 'user.dingtalk', template_id: 3, msg_type: 'text', content: '测试消息1' }
-```
-
-禁止项：
-- 手机号含空格、`+86-`、中划线等非纯数字
+- 手机号含空格、中划线、`+86-` 等非纯数字
 - `template_id` 传字符串
-- `msg_type` 非 `text/markdown`
-- 手动传 `request_id`
+- `msg_type` 不是 `text/markdown`
+
+## `watch_create` 渠道必填映射
 
-成功判定：
-- `success = true`
+- 选 `email`：`channel_configs.email.to_address/template_id/title/content`
+- 选 `call`：`channel_configs.call.phone/customer_name/condition`
+- 选 `sms`：`channel_configs.sms.receiver(或phone)/template_id/content`
+- 选 `dingtalk`：`channel_configs.dingtalk.cas_id/template_id/msg_type/content`

package/skills/glance-watch/references/examples.md

@@ -1,43 +1,163 @@
-# 典型示例
+# 示例模板（按任务类型）
 
-## 比特币监控
+## 1) 盯盘策略（watch_*)
+
+### 1.1 创建比特币盯盘（跌破阈值）
 
 ```javascript
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold and change_percent >= cp_threshold',
-  variables: { threshold: 73000, cp_threshold: 0.01, product_name: 'Bitcoin' }
-}
+await watch_create({
+  product_code: 'BTCUSDT',
+  product_type: 'crypto',
+  operator_type: 'rule',
+  operator_parameters: {
+    condition: 'price <= threshold and change_percent <= cp_threshold',
+    variables: { threshold: 68000, cp_threshold: -0.02, product_name: '比特币' }
+  },
+  channels: ['openclaw'],
+  channel_configs: {
+    openclaw: {
+      channel: 'dingtalk',
+      account_id: 'default',
+      session_key: 'agent:main:dingtalk:group:cid_demo',
+      conversation_id: 'cid_demo'
+    }
+  }
+})
 ```
 
-说明：`crypto` 不支持 `turnover_rate`。
+### 1.2 创建A股盯盘 + 短信通知（含联系人 CSV 补值）
+
+```javascript
+// Step 0: 先查联系人 CSV（若本轮未给手机号）
+// ~/.openclaw/workspace/memory/watch-notify-contacts.csv
 
-## A 股监控
+await watch_create({
+  product_code: '600000.SH',
+  product_type: 'stock',
+  operator_type: 'rule',
+  operator_parameters: {
+    condition: 'price >= threshold and turnover_rate >= tr_threshold',
+    variables: { threshold: 12.5, tr_threshold: 0.01, product_name: '浦发银行' }
+  },
+  channels: ['openclaw', 'sms'],
+  channel_configs: {
+    openclaw: {
+      channel: 'dingtalk',
+      account_id: 'default',
+      session_key: 'agent:main:dingtalk:group:cid_demo',
+      conversation_id: 'cid_demo'
+    },
+    sms: {
+      receiver: '13800138000',
+      template_id: 90010,
+      content: '浦发银行触发盯盘条件，当前价 ${price}'
+    }
+  }
+})
+
+// Step 1: 若本轮用了新联系方式且创建成功，回写联系人 CSV
+```
+
+### 1.3 管理策略
 
 ```javascript
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold and turnover_rate >= tr_threshold',
-  variables: { threshold: 12.5, tr_threshold: 0.01, product_name: '平安银行' }
-}
+await watch_list({ status: 'active' })
+await watch_pause({ strategy_id: 's_123' })
+await watch_activate({ strategy_id: 's_123' })
+await watch_remove({ strategy_id: 's_123' })
 ```
 
-## 港股监控
+## 2) 直连通知（notify_*)
+
+### 2.1 发送短信（含联系人 CSV 补值）
 
 ```javascript
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold',
-  variables: { threshold: 420, product_name: '腾讯控股' }
-}
+// Step 0: 先查联系人 CSV，补 receiver/template_id
+await notify_sms({
+  receiver: '13800138000',
+  template_id: 90010,
+  content: '测试短信：比特币跌幅超过2%'
+})
+
+// Step 1: 若本轮有新联系方式且发送成功，回写 CSV
 ```
 
-## 查询行情
+### 2.2 发送电话/邮件/钉钉
 
 ```javascript
-await runtime.queryTickerData({
-  stockCode: '00700',
-  market: 'HK',
-  productType: 'hk_stock'
+await notify_call({
+  phone: '13800138000',
+  customer_name: '张三',
+  condition: '比特币跌幅超过2%'
 })
+
+await notify_email({
+  to_address: 'demo@example.com',
+  template_id: 4,
+  title: '盯盘提醒',
+  content: 'BTCUSDT 触发阈值'
+})
+
+await notify_dingtalk({
+  cas_id: 'user.dingtalk',
+  template_id: 3,
+  msg_type: 'text',
+  content: '盯盘触发：BTCUSDT'
+})
+```
+
+## 3) 实时行情查询
+
+### 3.1 股票/指数/加密实时行情
+
+```javascript
+await watch_query_ticker({ market: 'a', symbol: '600000.SH', segment: 'stock' })
+await watch_query_ticker({ market: 'hk', symbol: '00700', segment: 'stock' })
+await watch_query_ticker({ market: 'crypto', symbol: 'BTCUSDT' })
 ```
+
+### 3.2 基金当日估值（基金不支持创建盯盘）
+
+```javascript
+await watch_query_fund_estimates({ fund_codes: '000006.OF' })
+await watch_query_fund_estimates({ fund_codes: ['000006.OF', '110011.OF'] })
+```
+
+## 4) 标的检索与是否交易日查询
+
+### 4.1 名称 -> 代码
+
+```javascript
+await watch_search_a_stock_basic({ keyword: '平安银行', limit: 5 })
+await watch_search_hk_stock_basic({ q: '腾讯', limit: 5 })
+await watch_search_index_basic({ keyword: '沪深300', limit: 5 })
+await watch_search_fund_basic({ keyword: '西部利得量化成长', limit: 5 })
+```
+
+### 4.2 是否交易日
+
+```javascript
+await watch_trade_calendar({
+  exchange: 'SSE',
+  start_date: '2026-04-10',
+  end_date: '2026-04-10'
+})
+```
+
+## 5) 快讯
+
+```javascript
+await watch_fin_news({ keyword: '央行', limit: 10 })
+await watch_fin_news({
+  q: '比特币',
+  pub_time_start: '2026-04-10 00:00:00',
+  pub_time_end: '2026-04-10 23:59:59',
+  limit: 20
+})
+```
+
+## 常见边界提示
+
+- 基金（`xxxxxx.OF`）不能用 `watch_create`，只能用 `watch_query_fund_estimates` / `watch_search_fund_basic`。
+- 使用 `call/sms/email/dingtalk` 时，`watch_create` 与 `notify_*` 都要先查联系人 CSV。
+- `operator_type` 固定 `rule`，不要用其他值。

package/skills/glance-watch/references/news-briefing.md

@@ -0,0 +1,41 @@
+# 快讯查询
+
+## 工具
+
+- `watch_fin_news`
+
+## 何时使用
+
+- 用户询问“有什么快讯/新闻/资讯”
+- 用户给了主题词（如：央行、降息、AI、特斯拉）
+
+## 参数
+
+必填：
+- `keyword` 或 `q`（二选一）
+
+可选：
+- `limit`
+- `pub_time_start`
+- `pub_time_end`
+
+## 成功判定
+
+- `success === true`
+- `finance.table.result` 的 `data[]` 含快讯行
+
+## 示例
+
+```javascript
+await watch_fin_news({ keyword: '央行', limit: 10 })
+await watch_fin_news({
+  q: '比特币',
+  pub_time_start: '2026-04-10 00:00:00',
+  pub_time_end: '2026-04-10 23:59:59'
+})
+```
+
+## 失败处理
+
+- 没有关键词时先追问，不要空查
+- 返回失败时，直接反馈 `error` 与 `http_status`