openclaw-glance-plugin 0.1.18 → 0.1.22

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

@@ -0,0 +1,90 @@
+# 渠道与通知参数
+
+## 渠道策略
+
+- `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. 凡是 `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
+```
+
+写回要求：
+- 已有同一 `(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`
+
+## `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/config/runtime-config.js

@@ -2,19 +2,6 @@ import os from 'node:os';
 import path from 'node:path';
 import process from 'node:process';
 
-export function resolveContactsStorePath({ env = process.env, pluginConfig = {} } = {}) {
-  const explicit = pick(
-    pluginConfig,
-    ['contactsStorePath', 'contacts_store_path'],
-    pick(env, ['OPENCLAW_CONTACTS_STORE_PATH'])
-  );
-  if (explicit) {
-    return String(explicit).trim();
-  }
-  const homeDir = pick(env, ['HOME', 'USERPROFILE']) || os.homedir();
-  return path.join(String(homeDir), '.openclaw', 'workspace', 'memory', 'watch-notify-contacts.json');
-}
-
 import { ProcessLock } from '../runtime/lock/ProcessLock.js';
 
 const DEFAULT_BASE_WS_URL = 'wss://glanceup-pre.100credit.cn';
@@ -78,7 +65,6 @@ export function resolveRuntimeConfig({ env = process.env, pluginConfig = {} } =
     baseWsUrl,
     token,
     lockDir,
-    lockKey,
-    contactsStorePath: resolveContactsStorePath({ env, pluginConfig })
+    lockKey
   };
 }

package/src/plugin/index.js

@@ -1,10 +1,6 @@
-import { resolveRuntimeConfig, resolveContactsStorePath } from '../config/runtime-config.js';
+import { resolveRuntimeConfig } from '../config/runtime-config.js';
 import { extractOpenclawRoutingFromRecord, deriveOpenclawRouting } from '../openclawRouting.js';
 import { BridgeRuntime } from '../runtime/BridgeRuntime.js';
-import {
-  mergeAndPersistNotifyContacts,
-  mergeAndPersistWatchContacts
-} from './watch-notify-contacts.js';
 import { PluginDispatcher } from '../runtime/dispatchers/PluginDispatcher.js';
 import { ProcessLock } from '../runtime/lock/ProcessLock.js';
 
@@ -145,7 +141,7 @@ function mergeOpenclawChannelConfig(payload = {}, context = {}) {
   return merged;
 }
 
-function buildControlApi(startupPromise, contactsStorePath) {
+function buildControlApi(startupPromise) {
   return {
     async queryTickerData(query = {}) {
       const runtime = await getReadyRuntime(startupPromise);
@@ -164,14 +160,9 @@ function buildControlApi(startupPromise, contactsStorePath) {
     async createWatch(payload = {}, context = {}) {
       const runtime = await getReadyRuntime(startupPromise);
       const normalized = mergeOpenclawChannelConfig(payload, context);
-      const filled = await mergeAndPersistWatchContacts(
-        contactsStorePath,
-        normalized,
-        context
-      );
-      return runtime.request('watch.create', filled);
+      return runtime.request('watch.create', normalized);
     },
-    async sendNotification(input = {}, context = {}) {
+    async sendNotification(input = {}) {
       const runtime = await getReadyRuntime(startupPromise);
       const ch = String(input.channel ?? '')
         .trim()
@@ -183,39 +174,28 @@ function buildControlApi(startupPromise, contactsStorePath) {
         );
       }
       const payload = { ...(input.payload || {}) };
-      const merged = await mergeAndPersistNotifyContacts(
-        contactsStorePath,
-        ch,
-        payload,
-        context
-      );
       return runtime.request('notify.send', {
-        ...merged,
+        ...payload,
         channel: ch
       });
     },
-    async sendSms(payload = {}, context = {}) {
-      return this.sendNotification({ channel: 'sms', payload }, context);
+    async sendSms(payload = {}) {
+      return this.sendNotification({ channel: 'sms', payload });
     },
-    async sendCall(payload = {}, context = {}) {
-      return this.sendNotification({ channel: 'call', payload }, context);
+    async sendCall(payload = {}) {
+      return this.sendNotification({ channel: 'call', payload });
     },
-    async sendEmail(payload = {}, context = {}) {
-      return this.sendNotification({ channel: 'email', payload }, context);
+    async sendEmail(payload = {}) {
+      return this.sendNotification({ channel: 'email', payload });
     },
-    async sendDingtalk(payload = {}, context = {}) {
-      return this.sendNotification({ channel: 'dingtalk', payload }, context);
+    async sendDingtalk(payload = {}) {
+      return this.sendNotification({ channel: 'dingtalk', payload });
     },
     async submitWatchDemand(demand = {}, context = {}) {
       const runtime = await getReadyRuntime(startupPromise);
       const payload = mapDemandToCreatePayload(demand);
       const normalized = mergeOpenclawChannelConfig(payload, context);
-      const filled = await mergeAndPersistWatchContacts(
-        contactsStorePath,
-        normalized,
-        context
-      );
-      return runtime.request('watch.create', filled);
+      return runtime.request('watch.create', normalized);
     },
     async pauseWatch(strategyId) {
       const runtime = await getReadyRuntime(startupPromise);
@@ -310,7 +290,7 @@ function registerControlTools(api, controlApi) {
       additionalProperties: true,
       properties: {}
     },
-    (args, meta = {}) => controlApi.sendSms(args || {}, meta?.context || {})
+    (args) => controlApi.sendSms(args || {})
   );
 
   tryRegisterTool(
@@ -322,7 +302,7 @@ function registerControlTools(api, controlApi) {
       additionalProperties: true,
       properties: {}
     },
-    (args, meta = {}) => controlApi.sendCall(args || {}, meta?.context || {})
+    (args) => controlApi.sendCall(args || {})
   );
 
   tryRegisterTool(
@@ -334,7 +314,7 @@ function registerControlTools(api, controlApi) {
       additionalProperties: true,
       properties: {}
     },
-    (args, meta = {}) => controlApi.sendEmail(args || {}, meta?.context || {})
+    (args) => controlApi.sendEmail(args || {})
   );
 
   tryRegisterTool(
@@ -346,7 +326,7 @@ function registerControlTools(api, controlApi) {
       additionalProperties: true,
       properties: {}
     },
-    (args, meta = {}) => controlApi.sendDingtalk(args || {}, meta?.context || {})
+    (args) => controlApi.sendDingtalk(args || {})
   );
 
   tryRegisterTool(
@@ -432,8 +412,6 @@ const plugin = {
       api?.config?.plugins?.glanceBridge?.config ||
       {};
 
-    const contactsStorePath = resolveContactsStorePath({ pluginConfig });
-
     const startupPromise = startPluginRuntime({
       runtime: api?.runtime,
       pluginConfig
@@ -442,7 +420,7 @@ const plugin = {
       api?.runtime?.logger?.error?.(`[openclaw-glance-plugin] runtime start failed: ${err.message}`);
     });
 
-    const controlApi = buildControlApi(startupPromise, contactsStorePath);
+    const controlApi = buildControlApi(startupPromise);
     api.glanceBridge = controlApi;
     registerControlTools(api, controlApi);