tickflow-assist 0.2.11 → 0.2.12

package/README.md

@@ -2,7 +2,7 @@
 
 基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.2.11` 优化复盘/告警文本样式，接入 PNG 告警卡发送与临时文件清理，并按 A 股习惯调整涨跌主色。
+最近更新：`v0.2.12` 调整社区安装清单，允许先安装插件再执行 `configure-openclaw` 写入密钥配置；同时将 `test_alert` 升级为文本 + PNG 告警卡链路测试。
 
 ## 安装
 
@@ -13,6 +13,8 @@ openclaw plugins install tickflow-assist
 npx -y tickflow-assist configure-openclaw
 ```
 
+安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。
+
 第二条命令会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并默认执行：
 
 - `openclaw plugins enable tickflow-assist`

package/dist/bootstrap.js

@@ -152,7 +152,7 @@ export function createAppContext(config, options = {}) {
             startMonitorTool(monitorService, runtime),
             stopDailyUpdateTool(dailyUpdateWorker, runtime),
             stopMonitorTool(monitorService, runtime),
-            testAlertTool(alertService),
+            testAlertTool(alertService, alertMediaService),
             updateAllTool(dailyUpdateWorker),
             viewAnalysisTool(analysisViewService),
         ],

package/dist/plugin-commands.js

@@ -208,7 +208,7 @@ export function registerPluginCommands(api, tools, app) {
         },
         {
             name: "ta_testalert",
-            description: "发送一条测试告警，不经过 AI 对话。",
+            description: "发送一条文本 + PNG 测试告警，不经过 AI 对话。",
             requireAuth: true,
             handler: async () => ({
                 text: await runToolText(testAlert),

package/dist/tools/test-alert.tool.d.ts

@@ -1,5 +1,6 @@
 import { AlertService } from "../services/alert-service.js";
-export declare function testAlertTool(alertService: AlertService): {
+import { AlertMediaService } from "../services/alert-media-service.js";
+export declare function testAlertTool(alertService: AlertService, alertMediaService: AlertMediaService): {
     name: string;
     description: string;
     optional: boolean;

package/dist/tools/test-alert.tool.js

@@ -1,21 +1,101 @@
 import { formatChinaDateTime } from "../utils/china-time.js";
-export function testAlertTool(alertService) {
+export function testAlertTool(alertService, alertMediaService) {
     return {
         name: "test_alert",
-        description: "Send a test alert through the configured OpenClaw alert delivery path.",
+        description: "Send a text plus PNG test alert through the configured OpenClaw alert delivery path.",
         optional: true,
         async run() {
-            const ok = await alertService.send(alertService.formatSystemNotification("🧪 TickFlow 测试告警", [
-                `时间: ${formatChinaDateTime()}`,
-                "说明: 这是一条手动触发的测试消息，用于验证 channel 投递链路正常。",
-            ]));
-            if (ok) {
-                return "✅ 测试告警发送成功";
+            const now = formatChinaDateTime();
+            const message = alertService.formatSystemNotification("🧪 TickFlow 测试告警", [
+                `时间: ${now}`,
+                "说明: 这是一条手动触发的测试消息，用于验证文本与 PNG 告警卡投递链路正常。",
+            ]);
+            let mediaFile = null;
+            try {
+                mediaFile = await alertMediaService.writeAlertCard({
+                    symbol: "000001.SZ",
+                    ruleName: "test_alert",
+                    image: buildTestAlertImage(now),
+                });
             }
-            const detail = alertService.getLastError();
-            return detail
-                ? `❌ 测试告警发送失败\n原因: ${detail}`
-                : "❌ 测试告警发送失败";
+            catch (error) {
+                const textOnlyResult = await alertService.sendWithResult({ message });
+                if (textOnlyResult.ok) {
+                    return [
+                        "⚠️ 测试告警文本已发送，但 PNG 生成失败",
+                        `原因: ${formatErrorMessage(error)}`,
+                    ].join("\n");
+                }
+                const detail = textOnlyResult.error ?? alertService.getLastError() ?? "未知错误";
+                return [
+                    "❌ 测试告警发送失败",
+                    `PNG 生成失败: ${formatErrorMessage(error)}`,
+                    `文本发送失败: ${detail}`,
+                ].join("\n");
+            }
+            try {
+                const result = await alertService.sendWithResult({
+                    message,
+                    mediaPath: mediaFile.filePath,
+                    mediaLocalRoots: mediaFile.mediaLocalRoots,
+                    filename: mediaFile.filename,
+                });
+                if (result.ok && result.mediaDelivered) {
+                    return "✅ 测试告警发送成功（文本 + PNG）";
+                }
+                if (result.ok) {
+                    return "⚠️ 测试告警文本已发送，但 PNG 未送达，已回退为纯文本";
+                }
+                const detail = result.error ?? alertService.getLastError();
+                return detail
+                    ? `❌ 测试告警发送失败\n原因: ${detail}`
+                    : "❌ 测试告警发送失败";
+            }
+            finally {
+                if (mediaFile) {
+                    await alertMediaService.removeFile(mediaFile.filePath).catch(() => { });
+                }
+            }
+        },
+    };
+}
+function buildTestAlertImage(now) {
+    const triggerPrice = 12.18;
+    const currentPrice = 12.36;
+    return {
+        tone: "breakthrough",
+        alertLabel: "测试告警",
+        name: "平安银行",
+        symbol: "000001.SZ",
+        timestampLabel: `测试告警 | ${now.slice(0, 16)}`,
+        currentPrice,
+        triggerPrice,
+        changePct: 2.15,
+        distancePct: ((currentPrice - triggerPrice) / triggerPrice) * 100,
+        costPrice: 11.92,
+        profitPct: ((currentPrice - 11.92) / 11.92) * 100,
+        note: "用于验证 PNG 告警卡发送、媒体上传与纯文本回退链路。",
+        points: [
+            { time: "09:30", price: 12.02 },
+            { time: "10:00", price: 12.08 },
+            { time: "10:30", price: 12.12 },
+            { time: "11:30", price: 12.15 },
+            { time: "13:00", price: 12.19 },
+            { time: "14:00", price: 12.27 },
+            { time: "15:00", price: currentPrice },
+        ],
+        levels: {
+            stopLoss: 11.86,
+            support: 12.08,
+            resistance: 12.30,
+            breakthrough: triggerPrice,
+            takeProfit: 12.68,
         },
     };
 }
+function formatErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -9,7 +9,6 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "required": ["tickflowApiKey", "llmApiKey"],
     "properties": {
       "tickflowApiUrl": {
         "type": "string",
@@ -19,7 +18,7 @@
       "tickflowApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "Required. TickFlow API key used for market and financial data."
+        "description": "TickFlow API key used for market and financial data. Required before using the plugin."
       },
       "tickflowApiKeyLevel": {
         "type": "string",
@@ -45,7 +44,7 @@
       "llmApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "Required. API key for the analysis model endpoint configured in llmBaseUrl."
+        "description": "API key for the analysis model endpoint configured in llmBaseUrl. Required before using analysis features."
       },
       "llmModel": {
         "type": "string",
@@ -114,7 +113,7 @@
   "uiHints": {
     "tickflowApiKey": {
       "label": "TickFlow API Key",
-      "help": "Required for TickFlow market and financial data.",
+      "help": "Required before using TickFlow market and financial data.",
       "sensitive": true
     },
     "tickflowApiKeyLevel": {
@@ -132,7 +131,7 @@
     },
     "llmApiKey": {
       "label": "LLM API Key",
-      "help": "Required for analysis model requests.",
+      "help": "Required before using analysis model requests.",
       "sensitive": true
     },
     "llmModel": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "OpenClaw plugin for TickFlow-based A-share analysis, monitoring, and alerting.",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
     "dev": "tsc -p tsconfig.json --watch",
     "prepack": "npm run build && node ./scripts/prepare-package-assets.mjs",
     "postpack": "node ./scripts/restore-package-assets.mjs",
-    "test": "npm run build && node --test dist/plugin-registration.test.js",
+    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
     "monitor-loop": "node dist/dev/run-monitor-loop.js",

package/skills/usage-help/SKILL.md

@@ -83,6 +83,7 @@ TickFlow Assist 常用指令：
 
 14. 测试告警
 `测试告警`
+会发送一条文本 + PNG 告警卡测试消息
 
 15. 查看数据库表
 `数据库里有哪些表`