openclaw-glance-plugin 0.1.12 → 0.1.13

package/package.json

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

package/skills/glance-watch/SKILL.md

@@ -12,14 +12,15 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
    - 宿主已启动插件运行时（长连接由插件后台维护）
 
 2. **用户请求盯盘时**，解析用户需求提取：
-   - `productCode`: 产品代码
-   - `productType`: 市场类型 (stock/index/hk_stock/crypto)
-   - `condition`: 条件表达式
-   - `variables`: 变量值
+   - `product_code`: 产品代码
+   - `product_type`: 市场类型 (stock/index/hk_stock/crypto)
+   - `operator_type`: 固定为 `rule`
+   - `operator_parameters.condition`: 条件表达式
+   - `operator_parameters.variables`: 变量值
 
 3. **通过已安装运行时提交盯盘请求**（长连接由宿主运行时维护）
 4. **用户要求“查行情/看当前价格/报价”时**，优先调用 `queryTickerData` 获取实时数据，再决定是否创建盯盘策略。
-5. **用户要求“发短信/打电话/发邮件”时**。
+5. **用户要求“发短信/打电话/发邮件/发钉钉”时**，调用对应 `notify.*` 动作直接发送。
 
 ## 调用契约（必须遵循）
 
@@ -65,20 +66,59 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 #### `watch.create`
 
 参数（最少）：
-- `productCode`
-- `productType`
-- `condition`
-- `variables`
+- `product_code`
+- `product_type`
+- `operator_type`
+- `operator_parameters`
 
 建议附加：
 - `channels`（默认至少包含 `openclaw`）
-- 对应渠道配置（`emailConfig/callConfig/smsConfig`）
+- 对应渠道配置（`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`，必须提供 `emailConfig.to_address/template_id/title/content`
-- 只要 `channels` 包含 `call`，必须提供 `callConfig.phone/customer_name/condition`
-- 只要 `channels` 包含 `sms`，必须提供 `smsConfig.receiver(或phone)/template_id/content`
-- 只要 `channels` 包含 `dingtalk`，必须提供 `dingtalkConfig.cas_id/template_id/msg_type/content`
+- 只要 `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`
@@ -89,6 +129,12 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - 若是超时/网络波动导致的重试，必须使用同一组创建参数再次调用 `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`
 
 参数：
@@ -108,6 +154,28 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - `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`
 
@@ -115,6 +183,7 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - 明确返回失败原因，不要静默重试
 - 若是超时/网络波动导致的重试，必须使用同一组通知参数再次调用（不要改字段和值）
 - `request_id` 由插件运行时自动生成并在同 payload 重试时自动复用；大模型无需手动设置 `request_id`
+- 若返回缺字段错误（如 `MISSING_REQUIRED_FIELD`），只补缺失字段，其他字段保持不变再重试
 
 回执说明：
 - 直连通知发送完成后，客户端会收到 `notify.sent` 事件（`overall_status/success_count/failed_count/deliveries`）
@@ -127,13 +196,23 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - “达到某个涨跌幅提醒我”
 
 调用前必须确认：
-- `productCode`（标的代码）
-- `productType`（`stock/index/hk_stock/crypto`）
-- `condition`（规则表达式）
-- `variables`（阈值变量）
+- `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`（由插件自动生成与复用）
+
 ### 买卖意图与条件方向
 
 用户设置价格提醒时，往往不会说"大于等于"或"小于等于"，而是说"到了XX提醒我"。此时需要判断用户的**买卖意图**来决定条件方向：
@@ -160,7 +239,7 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 
 ## 标的检索规则（必须遵循）
 
-当不能直接确定 `productCode`/`productType` 时，必须先在本地标的数据中检索，再和用户确认。
+当不能直接确定 `product_code`/`product_type` 时，必须先在本地标的数据中检索，再和用户确认。
 
 数据文件（CSV，字段为 `类型,代码,名称,完整代码,市场`）：
 - `data/stock_a.csv`：A股个股列表（`productType=stock`）
@@ -225,23 +304,22 @@ await runtime.queryTickerData({
 `openclaw` 渠道必传，`email` / `call` / `sms` / `dingtalk` 可选。如用户没明确说明使用邮件(email)、电话/外呼(call)、短信(sms)、钉钉(dingtalk)通知提醒，则只需要传入`openclaw`渠道。
 
 但一旦用户选择了某个通知渠道，其配置参数必须完整填写：
-- 选择 `email` 必须提供 `emailConfig.to_address/template_id/title/content`
-- 选择 `call` 必须提供 `callConfig.phone/customer_name/condition`
-- 选择 `sms` 必须提供 `smsConfig.receiver(或phone)/template_id/content`
-- 选择 `dingtalk` 必须提供 `dingtalkConfig.cas_id/template_id/msg_type/content`
+- 选择 `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 参数（emailConfig）
+### email 参数（channel_configs.email）
 - `to_address`：收件人邮箱（必填，缺失不可创建/不可发送）
 - `template_id`：邮件模板 ID（必填，默认为4，不需要修改）
-- `template_params`：模板变量
 - `title`: 收到邮件的标题（必填）
 - `content`: 消息内容（必填）
 示例：
 ```javascript
-emailConfig: {
-  to_address: 'demo@example.com',
-  template_id: 4,
-  template_params: {
+channel_configs: {
+  email: {
+    to_address: 'demo@example.com',
+    template_id: 4,
     title: '监控提醒',
     content: '测试消息1'
   }
@@ -249,39 +327,43 @@ emailConfig: {
 ```
 用户收到的是一封title为"监控提醒",内容为"测试消息1"的一封邮件
 
-### call 参数（callConfig）
+### call 参数（channel_configs.call）
 - `phone`：手机号（必填，缺失不可创建/不可发送）
 - `customer_name`：客户名称（必填）
 - `condition`：外呼内容（必填）
 
 示例：
 ```javascript
-callConfig: {
-  phone: '13800138000',
-  customer_name: 'Demo',
-  condition: '比特币价格突破阈值'
+channel_configs: {
+  call: {
+    phone: '13800138000',
+    customer_name: 'Demo',
+    condition: '比特币价格突破阈值'
+  }
 }
 ```
 用户收到的是一通打给手机号码为13800138000的电话，电话内容为'比特币价格突破阈值'
 
 
-### sms 参数（smsConfig）
+### sms 参数（channel_configs.sms）
 - `receiver`：手机号（必填，必须是纯数字；缺失不可创建/不可发送）
 - `template_id`：短信模板 ID（必填，默认 90010，不需要修改）
 - `content`：短信变量内容（必填）
 
 示例：
 ```javascript
-smsConfig: {
-  receiver: '13800138000',
-  template_id: 90010,
-  content: '测试消息1'
+channel_configs: {
+  sms: {
+    receiver: '13800138000',
+    template_id: 90010,
+    content: '测试消息1'
+  }
 }
 ```
 用户收到的是一封发送给手机号码为13800138000的短信，短信内容为'测试消息1'
 
 
-### 钉钉 参数（dingtalkConfig）
+### 钉钉 参数（channel_configs.dingtalk）
 - `cas_id`：钉钉用户ID（必填，缺失不可创建/不可发送）
 - `template_id`：钉钉模板 ID（必填，默认 3，不需要修改）
 - `msg_type`: 消息类型（必填）：`text`/`markdown`
@@ -289,11 +371,13 @@ smsConfig: {
 
 示例：
 ```javascript
-dingtalkConfig: {
-  cas_id: 'user.dingtalk',
-  template_id: 3,
-  msg_type: "text",
-  content: "测试消息1"
+channel_configs: {
+  dingtalk: {
+    cas_id: 'user.dingtalk',
+    template_id: 3,
+    msg_type: 'text',
+    content: '测试消息1'
+  }
 }
 ```
 用户收到的是一条发送给钉钉号为user.dingtalk的单聊消息，消息内容为'测试消息1'
@@ -321,24 +405,33 @@ dingtalkConfig: {
 
 ### 比特币监控
 ```javascript
-// 条件: 价格 >= 73000 且涨幅 >= 1%
-condition: 'price >= threshold and change_percent >= cp_threshold'
-variables: { threshold: 73000, cp_threshold: 0.01, product_name: 'Bitcoin' }
+// 条件: 价格 >= 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
 ```
 
 ### A股监控
 ```javascript
-// 条件: 价格 >= 12.5 且换手率 >= 1%
-condition: 'price >= threshold and turnover_rate >= tr_threshold'
-variables: { threshold: 12.5, tr_threshold: 0.01, product_name: '平安银行' }
+// 条件: 价格 >= 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
-condition: 'price >= threshold'
-variables: { threshold: 420, product_name: '腾讯控股' }
+// 条件: 价格 >= 420（放在 operator_parameters 内）
+operator_type: 'rule'
+operator_parameters: {
+  condition: 'price >= threshold',
+  variables: { threshold: 420, product_name: '腾讯控股' }
+}
 ```
 
 ## 触发后操作