openclaw-glance-plugin 0.1.16 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-glance-plugin",
-  "version": "0.1.16",
+  "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,442 +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`
-
-禁止跳步：创建盯盘前若缺关键字段必须先追问。
-
-### 动作参数与成功判定
+1. 用户问“现在多少钱/查行情” -> 先 `watch.query_ticker`
+2. 用户要“盯盘/提醒” -> 补齐参数后 `watch.create`
+3. 用户要“看我的策略” -> `watch.list`
+4. 用户要“暂停/恢复/删除” -> `watch.pause` / `watch.activate` / `watch.remove`
+5. 用户要“马上发通知” -> 对应 `notify.*`
 
-#### `watch.query_ticker`
+### 创建策略最小必填
 
-参数：
-- `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`）
-
-固定模板（必须按此结构构造，字段名不要改）：
-
-```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: {},
-    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`渠道。
-
-但一旦用户选择了某个通知渠道，其配置参数必须完整填写：
-- 选择 `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`

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

@@ -0,0 +1,43 @@
+# 典型示例
+
+## 比特币监控
+
+```javascript
+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`。
+
+## A 股监控
+
+```javascript
+operator_type: 'rule'
+operator_parameters: {
+  condition: 'price >= threshold and turnover_rate >= tr_threshold',
+  variables: { threshold: 12.5, tr_threshold: 0.01, product_name: '平安银行' }
+}
+```
+
+## 港股监控
+
+```javascript
+operator_type: 'rule'
+operator_parameters: {
+  condition: 'price >= threshold',
+  variables: { threshold: 420, product_name: '腾讯控股' }
+}
+```
+
+## 查询行情
+
+```javascript
+await runtime.queryTickerData({
+  stockCode: '00700',
+  market: 'HK',
+  productType: 'hk_stock'
+})
+```

package/skills/glance-watch/references/query-and-symbol.md

@@ -0,0 +1,69 @@
+# 标的检索与行情查询
+
+## 标的检索规则（必须遵循）
+
+当不能直接确定 `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` -> 港股指数（`productType=index`，查询常配 `market=HK`）
+
+## 场景 1：用户只说名称
+
+- 在 CSV 里按名称模糊搜索。
+- 命中多条时，必须给出候选（代码 + 名称 + 市场）让用户确认。
+- 不可自行猜测后直接创建策略。
+
+## 场景 2：用户不知道代码或市场
+
+- 用 `rg` 在 4 个 CSV 搜索名称或代码。
+- 映射规则：
+- 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
+
+# 无 rg 时兜底
+grep -nE "平安银行|腾讯|沪深300|000001|00700|恒生科技指数|HSTECH" \
+  data/stock_a.csv data/stock_hk.csv data/index_a.csv data/index_hk.csv
+```
+
+## 行情查询流程（`watch.query_ticker`）
+
+说明：
+- 对外统一动作名是 `watch.query_ticker`。
+- 文档中的 `runtime.queryTickerData(...)` 仅用于说明宿主运行时内部调用形态。
+
+1. 先确定标的代码、市场、`productType`。
+2. 调用查询动作。
+3. 成功后反馈价格/涨跌幅，失败则返回错误并让用户确认代码或市场。
+
+示例：
+
+```javascript
+await runtime.queryTickerData({
+  stockCode: '00700',
+  market: 'HK',
+  productType: 'hk_stock'
+})
+```
+
+成功判定：
+- `code = "000000"` 或 `success = true`
+
+失败处理：
+- 直接返回失败原因，不静默重试

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

@@ -0,0 +1,40 @@
+# 重试与排障
+
+## 统一重试原则
+
+- 超时或网络波动时可重试。
+- 重试必须使用同一组 payload（字段和值不变）。
+- `request_id` 由插件运行时自动生成并在同 payload 上复用。
+
+## 创建策略失败（`watch.create`）
+
+处理规则：
+- 明确返回失败原因，不静默重试。
+- 若报“未注册的算子类型”，将 `operator_type` 修正为 `rule` 后重试。
+
+## 通知失败（`notify.*`）
+
+处理规则：
+- 优先返回 `code/error/hint`。
+- `MISSING_REQUIRED_FIELD`：仅补缺失字段后重试。
+- `UNSUPPORTED_MESSAGE_TYPE`：提示 bridge 版本不支持，需升级并重启。
+- `UPSTREAM_UNAVAILABLE`：提示上游不可用或超时，稍后重试。
+
+## 离线补发识别（`watch.triggered`）
+
+满足任一条件视为离线补发：
+- `delivery_mode = "offline_replay"`
+- `replayed = true`
+
+时间语义：
+- `trigger_time`：原始触发时间
+- `replayed_at`：补发时间
+
+用户文案需明确“离线期间触发，当前为补发”。
+
+## 触发后动作
+
+1. 解析 `market_data` 提取价格、涨跌幅。
+2. 通过 `openclaw` 回当前群/私聊。
+3. 附加渠道按用户要求发送。
+4. 生成简洁提醒文案。

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

@@ -0,0 +1,132 @@
+# Watch 动作契约
+
+## `watch.query_ticker`
+
+参数：
+- `stockCode`（或 `productCode`）
+- `productType`
+- `market`（`crypto` 可传空字符串）
+
+成功判定：
+- `code = "000000"` 或 `success = true`
+
+失败处理：
+- 返回失败原因
+- 引导用户确认代码/市场后重试
+
+## `watch.create`
+
+最小参数：
+- `product_code`
+- `product_type`
+- `operator_type`（固定 `rule`）
+- `operator_parameters`（包含 `condition`、`variables`）
+
+建议参数：
+- `channels`（默认至少 `openclaw`）
+- `channel_configs.*`
+
+固定结构（字段名不可改）：
+
+```javascript
+{
+  product_code: 'BTCUSDT',
+  product_type: 'crypto',
+  operator_type: 'rule',
+  operator_parameters: {
+    condition: 'change_percent <= cp_threshold',
+    variables: {
+      cp_threshold: -0.02,
+      product_name: '比特币'
+    }
+  },
+  channels: ['openclaw', 'dingtalk', 'sms'],
+  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: '13800138000',
+      template_id: 90010,
+      content: '比特币跌幅超2%！当前价格 ${price}，建议卖出！'
+    }
+  }
+}
+```
+
+禁止项：
+- `operator_type` 非 `rule`
+- 顶层 `condition`
+- `channel_configs` 渠道配置是字符串
+- 用户未要求渠道却默认附加
+
+成功判定：
+- `success = true`
+
+失败处理：
+- 明确返回失败原因，不静默重试
+- 超时/网络波动重试时，使用同一 payload（字段和值不变）
+- `request_id` 由插件运行时自动生成并复用，大模型不手动传
+
+## `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` 为策略列表
+
+失败处理：
+- 返回失败原因，不静默重试
+- 空结果明确告知“当前条件下没有策略”
+
+安全约束：
+- 仅可查询当前连接用户自己的策略
+- 不通过 `user_id/use_id` 越权查询
+
+## 调用前最终检查
+
+1. `watch.create` 使用 snake_case：`product_code/product_type/operator_type/operator_parameters/channel_configs`
+2. `operator_type` 固定 `rule`
+3. `operator_parameters.condition` 与 `variables` 同时存在
+4. `channels` 与 `channel_configs` 一一对应
+5. 渠道配置是对象，不是 JSON 字符串
+6. 默认不手动传 `request_id`
+
+## 买卖意图与条件方向
+
+| 用户意图 | 条件方向 |
+|---------|---------|
+| 买入（逢低） | `price <= threshold` |
+| 卖出（止盈/止损） | `price >= threshold` |
+
+判断规则：
+1. 用户明确说“涨到/跌到”时，按方向直接生成条件。
+2. 用户只说“到了 XX 提醒我”时，必须追问“买还是卖”。
+3. 常见映射：
+- `涨到/涨过/突破/冲到` -> `price >= threshold`
+- `跌到/跌破/回调到/回到` -> `price <= threshold`
+- `到了/到达/价格到` -> 方向不明确，需追问

package/src/OpenClawPluginAdapter.js

@@ -1,4 +1,5 @@
 import { OpenClawBridgeClient } from './OpenClawBridgeClient.js';
+import { extractOpenclawRoutingFromRecord } from './openclawRouting.js';
 
 /**
  * 全局单例 Adapter 实例
@@ -83,7 +84,6 @@ export class OpenClawPluginAdapter {
     const channelConfigs = { ...(demand.channelConfigs || {}) };
 
     if (demand.openclawConfig) {
-      channelConfigs.openclaw = demand.openclawConfig;
       if (!channels.includes('openclaw')) channels.push('openclaw');
     }
     if (demand.emailConfig) {
@@ -103,7 +103,20 @@ export class OpenClawPluginAdapter {
       if (!channels.includes('dingtalk')) channels.push('dingtalk');
     }
     if (!channels.includes('openclaw')) channels.unshift('openclaw');
-    if (!channelConfigs.openclaw) channelConfigs.openclaw = {};
+
+    const existingOpenclaw =
+      channelConfigs.openclaw && typeof channelConfigs.openclaw === 'object'
+        ? { ...channelConfigs.openclaw }
+        : {};
+    const explicitOpenclaw =
+      demand.openclawConfig && typeof demand.openclawConfig === 'object'
+        ? { ...demand.openclawConfig }
+        : {};
+    channelConfigs.openclaw = {
+      ...extractOpenclawRoutingFromRecord(demand),
+      ...existingOpenclaw,
+      ...explicitOpenclaw
+    };
 
     const payload = {
       product_code: demand.productCode,

package/src/openclawRouting.js

@@ -0,0 +1,174 @@
+/**
+ * openclaw-bridge 约定的会话路由字段（snake_case），用于落库与触发回推。
+ * @see ticker-monitor services/openclaw_bridge/main.py _extract_openclaw_routing
+ */
+
+export function pickFirstString(...values) {
+  for (const value of values) {
+    if (typeof value === 'string' && value.trim()) {
+      return value.trim();
+    }
+  }
+  return undefined;
+}
+
+/**
+ * 用于 senderId、路由 ID 等：非空字符串 trim，有限数字 / bigint 转字符串。
+ * （纯 pickFirstString 会忽略数字类型，导致记忆主键丢失。）
+ */
+export function pickFirstTrimmedScalar(...values) {
+  for (const value of values) {
+    if (value == null) continue;
+    if (typeof value === 'string') {
+      const t = value.trim();
+      if (t) return t;
+      continue;
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+      return String(value);
+    }
+    if (typeof value === 'bigint') {
+      return String(value);
+    }
+  }
+  return undefined;
+}
+
+/**
+ * 用于发送者主键：忽略数字 / bigint 0（常见占位），避免生成 `unknown:0` 等无效记忆键。
+ */
+export function pickFirstSenderIdentifier(...values) {
+  for (const value of values) {
+    if (value == null) continue;
+    if (typeof value === 'string') {
+      const t = value.trim();
+      if (t) return t;
+      continue;
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+      if (value === 0) continue;
+      return String(value);
+    }
+    if (typeof value === 'bigint') {
+      if (value === 0n) continue;
+      return String(value);
+    }
+  }
+  return undefined;
+}
+
+/**
+ * 从任意平面对象提取路由（支持 camelCase / snake_case），返回 bridge 使用的 snake_case。
+ * @param {Record<string, unknown>} source
+ * @returns {Record<string, string>}
+ */
+export function extractOpenclawRoutingFromRecord(source = {}) {
+  if (!source || typeof source !== 'object') {
+    return {};
+  }
+  const channel = pickFirstString(
+    source.channel,
+    source.source_channel,
+    source.sourceChannel
+  );
+  const account_id = pickFirstString(source.account_id, source.accountId);
+  const session_key = pickFirstString(source.session_key, source.sessionKey);
+  const conversation_id = pickFirstString(
+    source.conversation_id,
+    source.conversationId,
+    source.chat_id,
+    source.chatId
+  );
+  const out = {};
+  if (channel) out.channel = channel;
+  if (account_id) out.account_id = account_id;
+  if (session_key) out.session_key = session_key;
+  if (conversation_id) out.conversation_id = conversation_id;
+  return out;
+}
+
+/**
+ * 合并 params 与宿主 context / event.metadata 上的路由字段（与插件 index 行为一致）。
+ * @param {{ params?: Record<string, unknown>, context?: Record<string, unknown> }} args
+ * @returns {Record<string, string>}
+ */
+export function mergeContextMetadata(context = {}) {
+  const flat =
+    context.metadata && typeof context.metadata === 'object' && !Array.isArray(context.metadata)
+      ? context.metadata
+      : {};
+  const eventMeta =
+    context.event?.metadata &&
+    typeof context.event.metadata === 'object' &&
+    !Array.isArray(context.event.metadata)
+      ? context.event.metadata
+      : {};
+  return { ...flat, ...eventMeta };
+}
+
+export function unwrapSenderContextObject(context = {}) {
+  const sc = context?.senderContext;
+  if (sc && typeof sc === 'object' && !Array.isArray(sc)) {
+    return sc;
+  }
+  return {};
+}
+
+export function deriveOpenclawRouting({ params = {}, context = {} } = {}) {
+  const metadata = mergeContextMetadata(context);
+  const sc = unwrapSenderContextObject(context);
+  const routing = extractOpenclawRoutingFromRecord(params || {});
+
+  if (!routing.channel) {
+    const channel = pickFirstString(
+      sc.channel,
+      sc.sourceChannel,
+      sc.source_channel,
+      params?.source_channel,
+      metadata?.channel,
+      metadata?.channelId,
+      context?.channel,
+      context?.channelId
+    );
+    if (channel) routing.channel = channel;
+  }
+  if (!routing.account_id) {
+    const account_id = pickFirstString(
+      params?.account_id,
+      sc.accountId,
+      sc.account_id,
+      context?.accountId,
+      metadata?.accountId
+    );
+    if (account_id) routing.account_id = account_id;
+  }
+  if (!routing.session_key) {
+    const session_key = pickFirstString(
+      params?.session_key,
+      params?.sessionKey,
+      sc.sessionKey,
+      sc.session_key,
+      context?.sessionKey,
+      metadata?.sessionKey
+    );
+    if (session_key) routing.session_key = session_key;
+  }
+  if (!routing.conversation_id) {
+    const conversation_id = pickFirstString(
+      params?.conversation_id,
+      params?.conversationId,
+      params?.chat_id,
+      params?.chatId,
+      sc.conversationId,
+      sc.conversation_id,
+      sc.chatId,
+      sc.chat_id,
+      context?.conversationId,
+      metadata?.conversationId,
+      metadata?.chatId,
+      metadata?.groupId
+    );
+    if (conversation_id) routing.conversation_id = conversation_id;
+  }
+  return routing;
+}

package/src/plugin/index.js

@@ -1,4 +1,5 @@
 import { resolveRuntimeConfig } from '../config/runtime-config.js';
+import { extractOpenclawRoutingFromRecord, deriveOpenclawRouting } from '../openclawRouting.js';
 import { BridgeRuntime } from '../runtime/BridgeRuntime.js';
 import { PluginDispatcher } from '../runtime/dispatchers/PluginDispatcher.js';
 import { ProcessLock } from '../runtime/lock/ProcessLock.js';
@@ -56,52 +57,6 @@ async function getReadyRuntime(startupPromise) {
   return activeRuntime;
 }
 
-function pickFirstString(...values) {
-  for (const value of values) {
-    if (typeof value === 'string' && value.trim()) {
-      return value.trim();
-    }
-  }
-  return undefined;
-}
-
-function deriveOpenclawRouting({ params = {}, context = {} } = {}) {
-  const metadata = context?.event?.metadata || {};
-
-  const channel = pickFirstString(
-    params?.channel,
-    params?.source_channel,
-    metadata?.channel,
-    metadata?.channelId,
-    context?.channel,
-    context?.channelId
-  );
-  const accountId = pickFirstString(params?.account_id, context?.accountId, metadata?.accountId);
-  const sessionKey = pickFirstString(
-    params?.session_key,
-    params?.sessionKey,
-    context?.sessionKey,
-    metadata?.sessionKey
-  );
-  const conversationId = pickFirstString(
-    params?.conversation_id,
-    params?.conversationId,
-    params?.chat_id,
-    params?.chatId,
-    context?.conversationId,
-    metadata?.conversationId,
-    metadata?.chatId,
-    metadata?.groupId
-  );
-
-  const routing = {};
-  if (channel) routing.channel = channel;
-  if (accountId) routing.account_id = accountId;
-  if (sessionKey) routing.session_key = sessionKey;
-  if (conversationId) routing.conversation_id = conversationId;
-  return routing;
-}
-
 function mapDemandToCreatePayload(demand = {}) {
   const channels = Array.isArray(demand.channels)
     ? demand.channels
@@ -111,7 +66,6 @@ function mapDemandToCreatePayload(demand = {}) {
   const channelConfigs = { ...(demand.channelConfigs || {}) };
 
   if (demand.openclawConfig) {
-    channelConfigs.openclaw = demand.openclawConfig;
     if (!channels.includes('openclaw')) channels.push('openclaw');
   }
   if (demand.emailConfig) {
@@ -131,7 +85,20 @@ function mapDemandToCreatePayload(demand = {}) {
     if (!channels.includes('dingtalk')) channels.push('dingtalk');
   }
   if (!channels.includes('openclaw')) channels.unshift('openclaw');
-  if (!channelConfigs.openclaw) channelConfigs.openclaw = {};
+
+  const existingOpenclaw =
+    channelConfigs.openclaw && typeof channelConfigs.openclaw === 'object'
+      ? { ...channelConfigs.openclaw }
+      : {};
+  const explicitOpenclaw =
+    demand.openclawConfig && typeof demand.openclawConfig === 'object'
+      ? { ...demand.openclawConfig }
+      : {};
+  channelConfigs.openclaw = {
+    ...extractOpenclawRoutingFromRecord(demand),
+    ...existingOpenclaw,
+    ...explicitOpenclaw
+  };
 
   return {
     product_code: demand.productCode || demand.product_code,
@@ -197,11 +164,19 @@ function buildControlApi(startupPromise) {
     },
     async sendNotification(input = {}) {
       const runtime = await getReadyRuntime(startupPromise);
-      const channel = input.channel;
+      const ch = String(input.channel ?? '')
+        .trim()
+        .toLowerCase();
+      const allowed = new Set(['sms', 'email', 'call', 'dingtalk']);
+      if (!ch || !allowed.has(ch)) {
+        throw new Error(
+          'notify.send requires input.channel to be one of: sms, email, call, dingtalk'
+        );
+      }
       const payload = { ...(input.payload || {}) };
       return runtime.request('notify.send', {
         ...payload,
-        channel
+        channel: ch
       });
     },
     async sendSms(payload = {}) {
@@ -219,7 +194,8 @@ function buildControlApi(startupPromise) {
     async submitWatchDemand(demand = {}, context = {}) {
       const runtime = await getReadyRuntime(startupPromise);
       const payload = mapDemandToCreatePayload(demand);
-      return runtime.request('watch.create', mergeOpenclawChannelConfig(payload, context));
+      const normalized = mergeOpenclawChannelConfig(payload, context);
+      return runtime.request('watch.create', normalized);
     },
     async pauseWatch(strategyId) {
       const runtime = await getReadyRuntime(startupPromise);