openclaw-glance-plugin 0.1.18 → 0.1.21

package/openclaw.plugin.json

@@ -13,10 +13,6 @@
       },
       "lockDir": {
         "type": "string"
-      },
-      "contactsStorePath": {
-        "type": "string",
-        "description": "Path to watch-notify-contacts.json (sender defaults for sms/dingtalk/email/call)"
       }
     },
     "required": ["token"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-glance-plugin",
-  "version": "0.1.18",
+  "version": "0.1.21",
   "description": "OpenClaw plugin client for ticker-monitor openclaw-bridge",
   "type": "module",
   "main": "index.js",

package/skills/glance-watch/SKILL.md

@@ -3,31 +3,19 @@ name: glance-watch
 description: 智能盯盘插件，用于监控A股、港股、比特币等金融市场行情并在条件触发时发送提醒。当用户要求盯盘、监控价格、设置提醒、需要通过邮件/电话/短信/钉钉发起通知时自动触发，例如"帮我盯着比特币"、监控某只股票、涨跌幅提醒、短信通知我等。
 ---
 
-# Glance Watch 智能盯盘
+# Glance Watch 智能盯盘（主入口）
 
-## 快速开始
+## 目标
 
-1. **前置条件**（已完成）：
-   - 插件/包已安装并可用（由宿主环境预先完成）
-   - 宿主已启动插件运行时（长连接由插件后台维护）
+用最小上下文完成三类任务：
+- 查行情：`watch.query_ticker`
+- 建/管策略：`watch.create` / `watch.list` / `watch.pause` / `watch.activate` / `watch.remove`
+- 立即通知：`notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
 
-2. **用户请求盯盘时**，解析用户需求提取：
-   - `product_code`: 产品代码
-   - `product_type`: 市场类型 (stock/index/hk_stock/crypto)
-   - `operator_type`: 固定为 `rule`
-   - `operator_parameters.condition`: 条件表达式
-   - `operator_parameters.variables`: 变量值
-
-3. **通过已安装运行时提交盯盘请求**（长连接由宿主运行时维护）
-4. **用户要求“查行情/看当前价格/报价”时**，优先调用 `queryTickerData` 获取实时数据，再决定是否创建盯盘策略。
-5. **用户要求“发短信/打电话/发邮件/发钉钉”时**，调用对应 `notify.*` 动作直接发送。
-
-## 调用契约（必须遵循）
+## 调用契约（硬约束）
 
 ### 统一动作名
 
-宿主需将已安装插件/包接口映射为以下动作名（建议保持一致）：
-
 - `watch.query_ticker`
 - `watch.create`
 - `watch.list`
@@ -41,483 +29,71 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 
 ### 调用顺序
 
-1. 用户是“查行情”意图：先调用 `watch.query_ticker`
-2. 用户是“盯盘创建”意图：先补齐参数后调用 `watch.create`
-3. 用户是“暂停/恢复/删除”意图：分别调用 `watch.pause` / `watch.activate` / `watch.remove`
-4. 用户是“查看策略/查看我的策略/看 active 或 paused 或 completed 策略”意图：调用 `watch.list`
-5. 用户是“立即发短信/打电话/发邮件/发钉钉”意图：调用 `notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
-
-禁止跳步：创建盯盘前若缺关键字段必须先追问。
-
-### 动作参数与成功判定
-
-#### `watch.query_ticker`
+1. 用户问“现在多少钱/查行情” -> 先 `watch.query_ticker`
+2. 用户要“盯盘/提醒” -> 补齐参数后 `watch.create`
+3. 用户要“看我的策略” -> `watch.list`
+4. 用户要“暂停/恢复/删除” -> `watch.pause` / `watch.activate` / `watch.remove`
+5. 用户要“马上发通知” -> 对应 `notify.*`
 
-参数：
-- `stockCode`（或 `productCode`）
-- `productType`
-- `market`（`crypto` 可传空字符串）
+### 创建策略最小必填
 
-成功判定：
-- 返回 `code = "000000"` 或 `success = true`
-
-失败处理：
-- 返回失败原因
-- 引导用户确认代码/市场后重试
-
-#### `watch.create`
-
-参数（最少）：
 - `product_code`
-- `product_type`
-- `operator_type`
-- `operator_parameters`
-
-建议附加：
-- `channels`（默认至少包含 `openclaw`）
-- 对应渠道配置（`channel_configs.email/call/sms/dingtalk`）
-
-**OpenClaw 会话路由（含 `openclaw` 渠道时必须带上）**  
-触发后要把提醒发回**当前群聊/私聊**，须把路由写入 `channel_configs.openclaw`（或由宿主 `context` 注入，由插件运行时合并）。字段与 openclaw-bridge 一致（snake_case；部分宿主可用 camelCase，由插件归一）：
-
-| 字段 | 含义 |
-|------|------|
-| `channel` / `source_channel` | 来源渠道（钉钉/飞书等与宿主约定） |
-| `account_id` | 多账号场景下的账号标识 |
-| `session_key` | 推荐：可区分群/私聊、多会话的会话键 |
-| `conversation_id` / `chat_id` | 宿主侧发送目标会话 ID |
-
-可从**当前 OpenClaw 上下文**映射到上述字段；**禁止**在拿不到会话信息时留空 `openclaw: {}` 仍假装已配置。宿主通过工具调用传入的 `context`（如 `channelId`、`sessionKey`、`conversationId`）时，插件运行时会合并进 `channel_configs.openclaw`。  
-触发后解析 `watch.triggered` 的 **`payload.channel_configs.openclaw`**（及并列路由字段）再回复到对应会话。
-
-固定模板（必须按此结构构造，字段名不要改）：
-
-```javascript
-{
-  product_code: 'BTCUSDT',
-  product_type: 'crypto',
-  operator_type: 'rule', // 必须是 rule，不可改成条件表达式
-  operator_parameters: {
-    condition: 'change_percent <= cp_threshold',
-    variables: {
-      cp_threshold: -0.02,
-      product_name: '比特币'
-    }
-  },
-  channels: ['openclaw', 'dingtalk', 'sms'],
-  // 注意：必须是对象，不要传 JSON 字符串
-  channel_configs: {
-    openclaw: {
-      channel: 'dingtalk',
-      account_id: 'default',
-      session_key: 'agent:main:dingtalk:group:<conversation_id>',
-      conversation_id: '<conversation_id>'
-    },
-    dingtalk: {
-      cas_id: 'jinguo.xie',
-      template_id: 3,
-      msg_type: 'text',
-      content: '比特币跌幅超2%！当前价格 ${price}，跌幅 ${change_percent}%。建议卖出！'
-    },
-    sms: {
-      receiver: '18616726853',
-      template_id: 90010,
-      content: '比特币跌幅超2%！当前价格 ${price}，建议卖出！'
-    }
-  }
-}
-```
-
-禁止项（任何一条命中都必须先修正再调用）：
-- `operator_type` 不是 `rule`（例如写成 `change_percent <=`）
-- 把 `condition` 放在顶层，而不是 `operator_parameters.condition`
-- 把 `channel_configs` 下的渠道配置传成 JSON 字符串
-- 用户未要求某渠道，却默认附加该渠道配置
-
-渠道参数要求（必须）：
-- 只要 `channels` 包含 `email`，必须提供 `channel_configs.email.to_address/template_id/title/content`
-- 只要 `channels` 包含 `call`，必须提供 `channel_configs.call.phone/customer_name/condition`
-- 只要 `channels` 包含 `sms`，必须提供 `channel_configs.sms.receiver(或phone)/template_id/content`
-- 只要 `channels` 包含 `dingtalk`，必须提供 `channel_configs.dingtalk.cas_id/template_id/msg_type/content`
-
-成功判定：
-- 返回 `success = true`
-
-失败处理：
-- 明确返回失败原因，不要静默重试
-- 提示用户补充或修正参数
-- 若是超时/网络波动导致的重试，必须使用同一组创建参数再次调用 `watch.create`（不要改字段和值），避免重复创建策略
-- `request_id` 由插件运行时自动生成并在同 payload 重试时自动复用；大模型无需手动设置 `request_id`
-
-小模型（7B）执行策略（强约束）：
-1. 先用固定模板生成 payload 骨架，不要自由发挥字段名
-2. 仅替换值：`product_code/product_type/operator_parameters/channels/channel_configs`
-3. 发送前逐条自检“禁止项”
-4. 若失败返回 `400` 且提示“未注册的算子类型”，立即把 `operator_type` 纠正为 `rule` 并重试
-
-#### `watch.pause` / `watch.activate` / `watch.remove`
-
-参数：
-- `strategyId`（或 `strategy_id`）
-
-成功判定：
-- 返回 `success = true`
-
-失败处理：
-- 返回失败原因并提示用户确认策略 ID
-
-#### `watch.list`
-
-参数（可选）：
-- `status`：策略状态过滤。可传 `active` / `paused` / `completed` / `failed` / `expired`；不传表示查询该用户全部策略
-- `product_code`（或 `productCode`）：按标的代码过滤
-
-成功判定：
-- 返回 `success = true`
-- `data.total` 为命中策略数，`data.strategies` 为策略列表
-
-失败处理：
-- 返回失败原因，不要静默重试
-- 若筛选条件为空结果，明确告知“当前条件下没有策略”
-
-安全约束（必须）：
-- `watch.list` 只能查询当前连接用户自己的策略
-- 不要尝试通过参数传 `user_id` / `use_id` 越权查询
-
-#### `notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
-
-参数：
-- `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-`、中划线等）
-- 把 `template_id` 写成字符串（应传数字）
-- `msg_type` 传非 `text/markdown`
-- 传入 `request_id`（通知请求由插件运行时自动生成并复用）
-
-成功判定：
-- 返回 `success = true`
-
-失败处理：
-- 明确返回失败原因，不要静默重试
-- 若是超时/网络波动导致的重试，必须使用同一组通知参数再次调用（不要改字段和值）
-- `request_id` 由插件运行时自动生成并在同 payload 重试时自动复用；大模型无需手动设置 `request_id`
-- 若返回缺字段错误（如 `MISSING_REQUIRED_FIELD`），只补缺失字段，其他字段保持不变再重试
-
-回执说明：
-- 直连通知发送完成后，客户端会收到 `notify.sent` 事件（`overall_status/success_count/failed_count/deliveries`）
-
-离线补发识别（`watch.triggered`）：
-- 若事件包含 `delivery_mode = "offline_replay"` 或 `replayed = true`，表示这是用户离线期间触发后补发的消息
-- `trigger_time` 表示原始触发时间，`replayed_at` 表示补发时间
-- 向用户描述时应明确区分：例如“这条是离线期间触发，现已补发到当前会话”
-
-## 调用判定规则
-
-只有在用户明确表达以下意图时调用插件：
-- “帮我盯盘/监控/提醒”
-- “涨到/跌到某个价格提醒我”
-- “达到某个涨跌幅提醒我”
-
-调用前必须确认：
-- `product_code`（标的代码）
 - `product_type`（`stock/index/hk_stock/crypto`）
-- `operator_parameters.condition`（规则表达式）
-- `operator_parameters.variables`（阈值变量）
-
-缺任一项时先追问，不要猜测阈值。
-
-### 调用前最终检查（小尺寸模型 必做）
-
-在实际调用工具前，逐条检查：
-1. `watch.create` 是否使用 `snake_case`：`product_code/product_type/operator_type/operator_parameters/channel_configs`
-2. `operator_type` 是否固定为 `rule`
-3. `operator_parameters.condition` 与 `operator_parameters.variables` 是否都存在
-4. `channels` 是否与 `channel_configs` 一一对应（选了哪个渠道就必须有哪个配置）
-5. 所有配置是否为对象而非 JSON 字符串
-6. `request_id` 默认不手动传；由插件自动生成并在同 payload 重试时复用。仅当宿主框架明确要求外部指定时才传，并且重试必须保持不变
-
-### 买卖意图与条件方向
-
-用户设置价格提醒时，往往不会说"大于等于"或"小于等于"，而是说"到了XX提醒我"。此时需要判断用户的**买卖意图**来决定条件方向：
-
-| 用户意图 | 条件方向 | 说明 |
-|---------|---------|------|
-| 想买入（逢低买入） | `price <= threshold` | 价格**跌到**目标价时提醒，抄底机会 |
-| 想卖出（止盈/止损） | `price >= threshold` | 价格**涨到**目标价时提醒，落袋为安 |
-
-**判断流程：**
-
-1. 如果用户明确说了方向（如"涨到XX"、"跌到XX"），直接使用对应条件
-2. 如果用户只说"到了XX提醒我"，**必须追问一句**：
-   - "你是想在价格涨到XX时卖出，还是跌到XX时买入？"
-   - 或者更简洁地问："这个是准备买还是卖？买的话我帮你盯跌到XX，卖的话盯涨到XX"
-3. 根据用户回答设置条件：
-   - 买入 → `price <= threshold`
-   - 卖出 → `price >= threshold`
-
-**常见表达映射：**
-- "涨到/涨过/突破/冲到" → `price >= threshold`（卖出方向）
-- "跌到/跌破/回调到/回到" → `price <= threshold`（买入方向）
-- "到了/到达/价格到" → **方向不明确，需追问买还是卖**
-
-## 标的检索规则（必须遵循）
-
-当不能直接确定 `product_code`/`product_type` 时，必须先在本地标的数据中检索，再和用户确认。
-
-数据文件（CSV，字段为 `类型,代码,名称,完整代码,市场`）：
-- `data/stock_a.csv`：A股个股列表（`productType=stock`）
-- `data/stock_hk.csv`：港股个股列表（`productType=hk_stock`）
-- `data/index_a.csv`：A股指数列表（`productType=index`）
-- `data/index_hk.csv`：港股指数列表（支持指数代码和中文名称查询）
-
-### 场景1：用户只说股票简称/名称
-- 使用模糊搜索在上述 CSV 中查找名称。
-- 若命中多条，必须把候选项（代码 + 名称 + 市场）发给用户确认，不要自行猜测。
-- 用户确认后再创建策略。
-
-### 场景2：不知道某个标的代码或所属市场
-- 使用 `rg`（或 `grep`）在四个 CSV 中搜索标的名称或代码。
-- 根据命中结果判断市场并映射 `productType`：
-  - A股个股 -> `stock`
-  - 港股个股 -> `hk_stock`
-  - A股指数 -> `index`
-  - 港股指数 -> `index`（`market=HK`）
-- 若搜索结果不唯一或冲突，先向用户确认后再继续。
-
-### 推荐检索命令
-
-```bash
-# 按名称模糊查找（推荐）
-rg -n "平安银行|腾讯|沪深300|BTC" data/stock_a.csv data/stock_hk.csv data/index_a.csv
-rg -n "恒生科技指数|恒生指数|HSTECH|HSI" data/index_hk.csv
-
-# 按代码查找
-rg -n "000001|00700|399001" data/stock_a.csv data/stock_hk.csv data/index_a.csv
-rg -n "HSTECH|HSI|VHSI" data/index_hk.csv
-
-# grep 兜底（无 rg 时）
-grep -nE "平安银行|腾讯|沪深300|000001|00700|恒生科技指数|HSTECH" data/stock_a.csv data/stock_hk.csv data/index_a.csv data/index_hk.csv
-```
-
-## 行情查询（queryTickerData）
-
-当用户问“现在多少钱”“最新价格”“查一下某标的行情”等问题时，执行以下流程：
-
-1. 先根据用户输入确定标的代码与市场：
-- 如果是简称/名称，先在 `data/*.csv` 里模糊搜索并向用户确认候选。
-- 如果是明确代码，按代码在 `data/*.csv` 查对应 `市场`。
-- 港股指数可直接用代码（如 `HSTECH`）或中文名称（如 `恒生科技指数`）查询；命中 `index_hk.csv` 时优先使用 `market=HK`。
-
-2. 调用已安装插件/包暴露的查询接口（例如 `queryTickerData`）：
-
-```javascript
-await runtime.queryTickerData({
-  stockCode: '00700',   // 或 productCode
-  market: 'HK',         // SH/SZ/HK，crypto 可传 ''
-  productType: 'hk_stock'
-})
-```
-
-3. 根据返回结果给用户反馈：
-- `code = "000000"`：返回行情数据（如最新价格、涨跌幅等）。
-- 非 `000000`：返回失败原因，并建议用户确认代码/市场后重试。
-
-## 渠道参数填写
-
-`openclaw` 渠道必传，`email` / `call` / `sms` / `dingtalk` 可选。如用户没明确说明使用邮件(email)、电话/外呼(call)、短信(sms)、钉钉(dingtalk)通知提醒，则只需要传入`openclaw`渠道。
-
-### 插件侧联系人记忆与自动补全（openclaw-plugin-node）
-
-宿主在调用 `watch_create`、`notify_*` 等工具时，应把**当前发送者上下文**传入 `context`（与 `openclaw` 路由合并所用上下文一致）。与 OpenClaw `buildSenderContext` 对齐时，推荐优先使用嵌套对象 **`context.senderContext`**（或顶层同名字段），例如：
-
-- `senderContext.channel`（或 `channel` / `channelId`）：来源渠道（钉钉建议为 `dingtalk`）
-- `senderContext.senderId`（或顶层 `senderId` / `sender_id`）：发送者唯一标识；钉钉下通常与 `cas_id` 一致
-- 仍兼容：`senderDingtalkId`、`event.metadata.senderDingtalkId` 等历史字段
-- `senderContext.senderName` / `senderName` / `displayName`：展示名（可用于外呼 `customer_name` 兜底）
-
-插件内等价解析函数为 `extractSenderContext`；`buildSenderContext` 为其别名（单参 `buildSenderContext(context)` 即可）。
-
-插件会在发 `watch.create` / `notify.send` 前：
-
-1. 按 `channel:sender_id` 读写独立 JSON（默认路径：`~/.openclaw/workspace/memory/watch-notify-contacts.json`，可通过插件配置 `contactsStorePath` 或环境变量 `OPENCLAW_CONTACTS_STORE_PATH` 覆盖）。
-2. 对 **sms / dingtalk / email / call** 缺省字段用该发送者已保存的默认值补全。
-3. **钉钉**：若当前会话渠道为 `dingtalk` 且未提供 `cas_id`，则用当前发送者 ID 作为默认 `cas_id` 并写入记忆。
-4. **外呼**：`customer_name` 优先用户本轮输入 → 记忆 → 发送者展示名。
-
-若补全后仍缺必填项（如从未提供过手机号），bridge 仍会报错，此时应追问用户；用户一旦提供有效值，插件会更新记忆，后续同发送者无需重复填写。
-
-向用户确认时**避免完整回显手机号**，可用尾号提示。
-
-用户选择了某个通知渠道时，**最终**发往 bridge 的 payload 仍须满足各渠道必填项（插件会先按上文规则补全；补全后仍缺的，由 Agent 追问用户补齐）：
-
-- 选择 `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`
-
-### email 参数（channel_configs.email）
-- `to_address`：收件人邮箱（必填，缺失不可创建/不可发送）
-- `template_id`：邮件模板 ID（必填，默认为4，不需要修改）
-- `title`: 收到邮件的标题（必填）
-- `content`: 消息内容（必填）
-示例：
-```javascript
-channel_configs: {
-  email: {
-    to_address: 'demo@example.com',
-    template_id: 4,
-    title: '监控提醒',
-    content: '测试消息1'
-  }
-}
-```
-用户收到的是一封title为"监控提醒",内容为"测试消息1"的一封邮件
-
-### call 参数（channel_configs.call）
-- `phone`：手机号（必填，缺失不可创建/不可发送）
-- `customer_name`：客户名称（必填）
-- `condition`：外呼内容（必填）
-
-示例：
-```javascript
-channel_configs: {
-  call: {
-    phone: '13800138000',
-    customer_name: 'Demo',
-    condition: '比特币价格突破阈值'
-  }
-}
-```
-用户收到的是一通打给手机号码为13800138000的电话，电话内容为'比特币价格突破阈值'
-
-
-### sms 参数（channel_configs.sms）
-- `receiver`：手机号（必填，必须是纯数字；缺失不可创建/不可发送）
-- `template_id`：短信模板 ID（必填，默认 90010，不需要修改）
-- `content`：短信变量内容（必填）
-
-示例：
-```javascript
-channel_configs: {
-  sms: {
-    receiver: '13800138000',
-    template_id: 90010,
-    content: '测试消息1'
-  }
-}
-```
-用户收到的是一封发送给手机号码为13800138000的短信，短信内容为'测试消息1'
-
-
-### 钉钉 参数（channel_configs.dingtalk）
-- `cas_id`：钉钉用户ID（必填，缺失不可创建/不可发送）
-- `template_id`：钉钉模板 ID（必填，默认 3，不需要修改）
-- `msg_type`: 消息类型（必填）：`text`/`markdown`
-- `content`：消息内容（必填）
-
-示例：
-```javascript
-channel_configs: {
-  dingtalk: {
-    cas_id: 'user.dingtalk',
-    template_id: 3,
-    msg_type: 'text',
-    content: '测试消息1'
-  }
-}
-```
-用户收到的是一条发送给钉钉号为user.dingtalk的单聊消息，消息内容为'测试消息1'
-
+- `operator_type`（固定 `rule`）
+- `operator_parameters.condition`
+- `operator_parameters.variables`
 
-## 支持的市场
+缺任一项先追问，不猜测阈值。
 
-| 市场 | productType | 示例 | 说明 |
-|------|-------------|------|------|
-| A股个股 | stock | 000001 | 每3秒行情 |
-| A股指数 | index | 000300 | 每3秒行情 |
-| 港股指数 | index | HSTECH / 恒生科技指数 | 查询时 `market=HK` |
-| 港股 | hk_stock | 00700 | 延迟15分钟 |
-| 加密货币 | crypto | BTCUSDT | 每10秒行情 |
+### 绝对禁止项
 
-意图映射建议：
-- 用户提到“指数/沪深300/上证” -> `index`
-- 用户提到“港股” -> `hk_stock`
-- 用户提到“比特币/BTC” -> `crypto`
-- 其余股票默认先按 `stock` 处理并在必要时追问确认
+- `operator_type` 不是 `rule`
+- 把 `condition` 放到顶层（必须在 `operator_parameters.condition`）
+- 把 `channel_configs.*` 传成 JSON 字符串（必须是对象）
+- 用户未要求的渠道被默认附加
+- 通过 `watch.list` 传 `user_id/use_id` 越权查询
 
-详细产品代码见 [references/markets.md](references/markets.md)
+## 渐进式披露（按需读取）
 
-## 使用示例
+仅在命中场景时读取对应文档，不要一次性加载全部 references。
 
-### 比特币监控
-```javascript
-// 条件: 价格 >= 73000 且涨幅 >= 1%（放在 operator_parameters 内）
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold and change_percent >= cp_threshold',
-  variables: { threshold: 73000, cp_threshold: 0.01, product_name: 'Bitcoin' }
-}
-// 注意: crypto 不支持 turnover_rate
-```
+- `watch.create/list/pause/activate/remove` 细节与成功判定：`references/watch-contract.md`
+- 标的检索、行情查询流程：`references/query-and-symbol.md`
+- 渠道参数、OpenClaw 路由、联系人记忆、`notify.*` 模板：`references/channels.md`
+- 示例 payload：`references/examples.md`
+- 重试、错误码、离线补发：`references/troubleshooting.md`
+- 市场与代码速查：`references/markets.md`
 
-### A股监控
-```javascript
-// 条件: 价格 >= 12.5 且换手率 >= 1%（放在 operator_parameters 内）
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold and turnover_rate >= tr_threshold',
-  variables: { threshold: 12.5, tr_threshold: 0.01, product_name: '平安银行' }
-}
-```
+## 决策表（强约束）
 
-### 港股监控
-```javascript
-// 条件: 价格 >= 420（放在 operator_parameters 内）
-operator_type: 'rule'
-operator_parameters: {
-  condition: 'price >= threshold',
-  variables: { threshold: 420, product_name: '腾讯控股' }
-}
-```
+先判定用户主意图，再只读取最小文档集合：
 
-## 触发后操作
+| 用户主意图 | 必读文档（最小集合） |
+|---|---|
+| 查行情/当前价格/报价 | `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` |
 
-当监控触发时:
-1. 解析 `market_data` 获取价格、涨跌幅等信息
-2. 发送提醒到用户当前对话的渠道（群聊/私聊）
-3. `openclaw` 渠道必传，`email/call/sms/dingtalk` 可按需附加
-4. 根据触发消息构建友好的提醒文案
+执行规则：
+1. 一次请求默认只读 1-2 个 references 文件。
+2. 仅当当前文档无法回答时，再追加读取下一个文档。
+3. 读取顺序遵循上表，不按“完整性”一次加载所有文档。
 
-如果创建失败（`watch.create.result.success=false`）：
-- 明确返回失败原因给用户
-- 引导用户补充或修正参数后再次创建
+## 小模型执行模板（7B）
 
-如果直连通知失败（`notify.send.result.success=false`）：
-- 优先读取并返回 `code/error/hint`，不要只说“通知失败”
-- 若 `code=MISSING_REQUIRED_FIELD`，直接告诉用户缺失字段并让其补齐
-- 若 `code=UNSUPPORTED_MESSAGE_TYPE`，提示“bridge 版本不支持 notify.send，需要升级并重启”
-- 若 `code=UPSTREAM_UNAVAILABLE`，提示“notification 服务不可用或超时，请稍后重试”
+1. 先按固定字段骨架生成 payload，不自创字段名。
+2. 只替换值：`product_code/product_type/operator_parameters/channels/channel_configs`。
+3. 调用前逐条自检“绝对禁止项”。
+4. 若报 `400` 且提示“未注册的算子类型”，把 `operator_type` 纠正为 `rule` 后重试。
 
-## 相关资源
+## 快速分流
 
-- 市场参考: [references/markets.md](references/markets.md)
+- 用户说“帮我盯 BTC 跌 2% 提醒” -> 读取 `references/watch-contract.md` + `references/channels.md`
+- 用户说“腾讯现在多少钱” -> 读取 `references/query-and-symbol.md`
+- 用户说“发短信给我” -> 读取 `references/channels.md`
+- 用户说“为什么没发出来” -> 读取 `references/troubleshooting.md`

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

@@ -0,0 +1,80 @@
+# 渠道与通知参数
+
+## 渠道策略
+
+- `openclaw` 渠道默认必带（用于回当前会话）。
+- `email/call/sms/dingtalk` 仅在用户明确要求时添加。
+
+## OpenClaw 会话路由
+
+当 `channels` 包含 `openclaw` 时，`channel_configs.openclaw` 必须可定位当前会话。
+
+常用字段：
+- `channel` 或 `source_channel`
+- `account_id`
+- `session_key`
+- `conversation_id` 或 `chat_id`
+
+约束：
+- 拿不到路由信息时，不得传空对象 `openclaw: {}` 假装已配置。
+- 宿主传入 `context` 时，插件运行时只负责合并 openclaw 路由字段。
+
+## 联系人记忆（Agent/OpenClaw 侧 CSV）
+
+真源：`~/.openclaw/workspace/memory/watch-notify-contacts.csv`
+
+建议表头：
+
+```text
+channel,sender_id,sender_name,phone,email,dingtalk_cas_id,customer_name,updated_at,notes
+```
+
+取值优先级：
+1. 本轮用户明确提供
+2. CSV 历史默认值
+3. 仍缺必填字段 -> 追问
+
+查询示例：
+
+```bash
+rg -n '^dingtalk,jinguo\.xie,' ~/.openclaw/workspace/memory/watch-notify-contacts.csv
+```
+
+## `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`
+
+## `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-`、中划线等非纯数字
+- `template_id` 传字符串
+- `msg_type` 非 `text/markdown`
+- 手动传 `request_id`
+
+成功判定：
+- `success = true`