tickflow-assist 0.2.17 → 0.2.18

package/README.md

@@ -2,7 +2,7 @@
 
 基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.2.17` 补充 Linux / macOS 的字体安装命令，`configure-openclaw` 会自动把被旧版本钉死的 ClawHub install spec 归一化为 `clawhub:tickflow-assist`，并将空自选时的 `ta_startmonitor` 失败改为可见提示。
+最近更新：`v0.2.18` 调整 PNG 告警卡的日内时间轴与午间衔接逻辑，修复测试图与 demo 图的时间展示不一致；同时修正社区版配置字段说明，并补强 npm 打包脚本对包页 README 元数据的处理。
 
 当前主线按 OpenClaw `v2026.3.31+` 对齐。
 
@@ -76,13 +76,14 @@ openclaw gateway restart
 plugins.entries["tickflow-assist"].config
 ```
 
-常用字段：
+建议按完整功能显式填写以下字段，不要只填 API Key：
 
-- 必填：`tickflowApiKey`、`llmApiKey`
-- 常用：`llmBaseUrl`、`llmModel`、`databasePath`、`calendarFile`
-- 可选：`mxSearchApiKey`、`alertTarget`、`alertAccount`
+- 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`
+- 本地数据：`databasePath`、`calendarFile`
+- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`
+- 能力补充：`mxSearchApiKey`
 
-`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget` 仅在 `test_alert`、实时监控告警和定时通知场景需要。
+其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警和定时通知前一并配好，避免配置不完整导致功能缺失。
 
 ## 功能
 

package/dist/services/alert-image-service.js

@@ -1,10 +1,19 @@
 import sharp from "sharp";
 const WIDTH = 960;
 const HEIGHT = 640;
+const MARKET_OPEN_MINUTES = 9 * 60 + 30;
+const MORNING_CLOSE_MINUTES = 11 * 60 + 30;
+const AFTERNOON_OPEN_MINUTES = 13 * 60;
+const MARKET_CLOSE_MINUTES = 15 * 60;
+const MARKET_SESSION_MINUTES = (MORNING_CLOSE_MINUTES - MARKET_OPEN_MINUTES) + (MARKET_CLOSE_MINUTES - AFTERNOON_OPEN_MINUTES);
 export function renderAlertCardSvg(input) {
     if (input.points.length < 2) {
         throw new Error("alert image requires at least 2 points");
     }
+    const chartPoints = normalizeChartPoints(input.points);
+    if (chartPoints.length < 2) {
+        throw new Error("alert image requires at least 2 chart points");
+    }
     const theme = resolveTheme(input.tone);
     const direction = resolveMarketDirection(input);
     const directionTheme = resolveDirectionTheme(direction);
@@ -38,7 +47,7 @@ export function renderAlertCardSvg(input) {
     const priceValues = [
         input.currentPrice,
         input.triggerPrice,
-        ...input.points.map((point) => point.price),
+        ...chartPoints.map((point) => point.price),
         input.levels.stopLoss ?? null,
         input.levels.support ?? null,
         input.levels.resistance ?? null,
@@ -51,19 +60,18 @@ export function renderAlertCardSvg(input) {
     const scaledMin = minValue - padding;
     const scaledMax = maxValue + padding;
     const valueRange = Math.max(0.01, scaledMax - scaledMin);
-    const scaleX = (index) => {
-        if (input.points.length === 1) {
-            return chart.left;
-        }
-        return chart.left + (index / (input.points.length - 1)) * chart.width;
-    };
+    const scaleX = (timeLabel) => scaleTradingTime(timeLabel, chart.left, chart.width);
     const scaleY = (value) => (chart.top + ((scaledMax - value) / valueRange) * chart.height);
-    const linePath = input.points
-        .map((point, index) => `${index === 0 ? "M" : "L"} ${scaleX(index).toFixed(2)} ${scaleY(point.price).toFixed(2)}`)
+    const firstPoint = chartPoints[0];
+    const lastPoint = chartPoints[chartPoints.length - 1];
+    const firstX = scaleX(firstPoint.time);
+    const currentX = scaleX(lastPoint.time);
+    const currentY = scaleY(lastPoint.price);
+    const sessionJoinX = scaleX("11:30");
+    const linePath = chartPoints
+        .map((point, index) => `${index === 0 ? "M" : "L"} ${scaleX(point.time).toFixed(2)} ${scaleY(point.price).toFixed(2)}`)
         .join(" ");
-    const areaPath = `${linePath} L ${(chart.left + chart.width).toFixed(2)} ${(chart.top + chart.height).toFixed(2)} L ${chart.left.toFixed(2)} ${(chart.top + chart.height).toFixed(2)} Z`;
-    const currentX = scaleX(input.points.length - 1);
-    const currentY = scaleY(input.points[input.points.length - 1]?.price ?? input.currentPrice);
+    const areaPath = `${linePath} L ${currentX.toFixed(2)} ${(chart.top + chart.height).toFixed(2)} L ${firstX.toFixed(2)} ${(chart.top + chart.height).toFixed(2)} Z`;
     const horizontalGrid = Array.from({ length: 5 }, (_, index) => {
         const y = chart.top + (index / 4) * chart.height;
         const value = scaledMax - (index / 4) * valueRange;
@@ -72,7 +80,7 @@ export function renderAlertCardSvg(input) {
             value,
         };
     });
-    const timeMarkers = buildTimeMarkers(input.points, scaleX);
+    const timeMarkers = buildTimeMarkers(chartPoints, scaleX);
     const levelEntries = buildLevelEntries(input);
     const levelPanelEntries = [...levelEntries].sort((left, right) => right.value - left.value);
     const levelLines = buildLevelLines(levelEntries, scaleY);
@@ -123,6 +131,7 @@ export function renderAlertCardSvg(input) {
   <text x="718" y="${180 + index * 18}" fill="#A8BED7" font-size="14" font-family="'Noto Sans CJK SC','Microsoft YaHei','PingFang SC',sans-serif">${escapeXml(line)}</text>`).join("")}
 
   <rect x="${chart.left}" y="${chart.top}" width="${chart.width}" height="${chart.height}" rx="18" fill="${directionTheme.chartPanelFill}" stroke="${theme.panelBorder}" stroke-opacity="0.9"/>
+  <line x1="${sessionJoinX.toFixed(2)}" y1="${chart.top + 10}" x2="${sessionJoinX.toFixed(2)}" y2="${chart.top + chart.height - 10}" stroke="#3B4F68" stroke-opacity="0.8" stroke-dasharray="3 8"/>
   ${horizontalGrid.map((line) => `
   <line x1="${chart.left}" y1="${line.y.toFixed(2)}" x2="${chart.left + chart.width}" y2="${line.y.toFixed(2)}" stroke="#213247" stroke-dasharray="4 8"/>
   <text x="${chart.left + 12}" y="${(line.y - 8).toFixed(2)}" fill="#6E88A5" font-size="12" font-family="'JetBrains Mono','SFMono-Regular','Consolas',monospace">${line.value.toFixed(2)}</text>`).join("")}
@@ -323,26 +332,18 @@ function buildLevelEntry(label, value, stroke, fill, text, width, dasharray) {
         label,
     };
 }
-function buildTimeMarkers(points, scaleX) {
-    const preferred = ["09:30", "10:30", "11:30", "13:00", "14:00", "15:00"];
-    const markers = [];
-    for (const label of preferred) {
-        const exactIndex = points.findIndex((point) => point.time.startsWith(label));
-        if (exactIndex >= 0) {
-            markers.push({
-                x: scaleX(exactIndex),
-                label,
-            });
-        }
-    }
-    if (markers.length >= 3) {
-        return filterNearbyMarkers(markers, 56);
-    }
-    return filterNearbyMarkers([
-        { x: scaleX(0), label: points[0]?.time.slice(0, 5) ?? "" },
-        { x: scaleX(Math.floor((points.length - 1) / 2)), label: points[Math.floor((points.length - 1) / 2)]?.time.slice(0, 5) ?? "" },
-        { x: scaleX(points.length - 1), label: points[points.length - 1]?.time.slice(0, 5) ?? "" },
-    ], 56);
+function buildTimeMarkers(_points, scaleX) {
+    const preferred = [
+        { timeLabel: "09:30", label: "09:30" },
+        { timeLabel: "10:30", label: "10:30" },
+        { timeLabel: "11:30", label: "11:30/13:00" },
+        { timeLabel: "14:00", label: "14:00" },
+        { timeLabel: "15:00", label: "15:00" },
+    ];
+    return filterNearbyMarkers(preferred.map((marker) => ({
+        x: scaleX(marker.timeLabel),
+        label: marker.label,
+    })), 56);
 }
 function buildRailMarkers(input, left, width, top, minValue, maxValue) {
     const range = Math.max(0.01, maxValue - minValue);
@@ -433,3 +434,55 @@ function filterNearbyMarkers(markers, minGap) {
     }
     return filtered;
 }
+function scaleTradingTime(timeLabel, left, width) {
+    const minutes = parseClockMinutes(timeLabel);
+    if (minutes == null) {
+        return left;
+    }
+    const clamped = clamp(minutes, MARKET_OPEN_MINUTES, MARKET_CLOSE_MINUTES);
+    return left + (toTradingSessionMinutes(clamped) / MARKET_SESSION_MINUTES) * width;
+}
+function normalizeChartPoints(points) {
+    const normalized = [];
+    for (const point of points) {
+        const previous = normalized[normalized.length - 1];
+        if (previous && isSessionJoinPair(previous.time, point.time)) {
+            normalized.push({
+                time: point.time,
+                price: previous.price,
+            });
+            continue;
+        }
+        normalized.push(point);
+    }
+    return normalized;
+}
+function parseClockMinutes(value) {
+    const match = value.trim().match(/^(\d{1,2}):(\d{2})/);
+    if (!match) {
+        return null;
+    }
+    const hour = Number(match[1]);
+    const minute = Number(match[2]);
+    if (!Number.isInteger(hour) || !Number.isInteger(minute) || minute < 0 || minute > 59) {
+        return null;
+    }
+    return hour * 60 + minute;
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function toTradingSessionMinutes(minutes) {
+    if (minutes <= MORNING_CLOSE_MINUTES) {
+        return minutes - MARKET_OPEN_MINUTES;
+    }
+    if (minutes < AFTERNOON_OPEN_MINUTES) {
+        return MORNING_CLOSE_MINUTES - MARKET_OPEN_MINUTES;
+    }
+    return ((MORNING_CLOSE_MINUTES - MARKET_OPEN_MINUTES)
+        + (minutes - AFTERNOON_OPEN_MINUTES));
+}
+function isSessionJoinPair(previousTime, nextTime) {
+    return parseClockMinutes(previousTime) === MORNING_CLOSE_MINUTES
+        && parseClockMinutes(nextTime) === AFTERNOON_OPEN_MINUTES;
+}

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

@@ -81,6 +81,7 @@ export function testAlertTool(alertService, alertMediaService, configSource = "o
     };
 }
 function buildTestAlertImage(now) {
+    const previewTime = `${now.slice(0, 10)} 14:12`;
     const triggerPrice = 12.18;
     const currentPrice = 12.36;
     return {
@@ -88,7 +89,7 @@ function buildTestAlertImage(now) {
         alertLabel: "测试告警",
         name: "平安银行",
         symbol: "000001.SZ",
-        timestampLabel: `测试告警 | ${now.slice(0, 16)}`,
+        timestampLabel: `测试告警 | ${previewTime}`,
         currentPrice,
         triggerPrice,
         changePct: 2.15,
@@ -102,8 +103,9 @@ function buildTestAlertImage(now) {
             { time: "10:30", price: 12.12 },
             { time: "11:30", price: 12.15 },
             { time: "13:00", price: 12.19 },
+            { time: "13:30", price: 12.23 },
             { time: "14:00", price: 12.27 },
-            { time: "15:00", price: currentPrice },
+            { time: "14:12", price: currentPrice },
         ],
         levels: {
             stopLoss: 11.86,

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.17",
-  "description": "OpenClaw smart stock plugin for A-share investing and watchlist workflows, powered by TickFlow API for realtime monitoring, post-close review, multi-dimensional analysis, key level tracking, and alerts. 面向 A 股投资与盯盘场景的 OpenClaw 智能股票插件，基于 TickFlow API 提供实时监控、收盘后复盘、多维综合分析、关键价位跟踪与告警能力。",
+  "version": "0.2.18",
+  "description": "面向 A 股投资与盯盘场景的 OpenClaw 智能股票插件，基于 TickFlow API 提供实时监控、收盘后复盘、多维综合分析、关键价位跟踪与告警能力。OpenClaw smart stock plugin for A-share investing and watchlist workflows, powered by TickFlow API for realtime monitoring, post-close review, multi-dimensional analysis, key level tracking, and alerts.",
   "license": "MIT",
   "type": "module",
   "main": "dist/plugin.js",
@@ -63,5 +63,7 @@
     "@types/node": "^22.13.11",
     "openclaw": "^2026.3.31",
     "typescript": "^5.8.2"
-  }
+  },
+  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.2.18` 调整 PNG 告警卡的日内时间轴与午间衔接逻辑，修复测试图与 demo 图的时间展示不一致；同时修正社区版配置字段说明，并补强 npm 打包脚本对包页 README 元数据的处理。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnpx -y tickflow-assist configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。\n`configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries[\"tickflow-assist\"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令。\n如果检测到 `plugins.installs[\"tickflow-assist\"]` 来自 `clawhub`，向导还会把被旧版本钉死的 `spec` 归一化为 `clawhub:tickflow-assist`，避免后续升级继续锁在旧版本。\n\n如果你希望先审阅配置，再只打印最少的后续步骤，可使用：\n\n```bash\nnpx -y tickflow-assist configure-openclaw --no-enable --no-restart\n```\n\n如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体，例如：\n\n```bash\n# Debian / Ubuntu\nsudo apt-get update\nsudo apt-get install -y fontconfig fonts-noto-cjk\nfc-cache -fv\n\n# RHEL / Fedora / Rocky / AlmaLinux\nsudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts\nfc-cache -fv\n\n# Arch / Manjaro\nsudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk\nfc-cache -fv\n\n# Alpine\nsudo apk add fontconfig font-noto-cjk\nfc-cache -fv\n\n# macOS (Homebrew)\nbrew install fontconfig\nbrew install --cask font-noto-sans-cjk\nfc-cache -fv\n```\n\n社区安装后的升级方式：\n\n```bash\nopenclaw plugins update tickflow-assist\nopenclaw gateway restart\n```\n\n## 配置\n\n插件正式运行读取：\n\n```text\n~/.openclaw/openclaw.json\n```\n\n配置路径：\n\n```text\nplugins.entries[\"tickflow-assist\"].config\n```\n\n建议按完整功能显式填写以下字段，不要只填 API Key：\n\n- 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 本地数据：`databasePath`、`calendarFile`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 能力补充：`mxSearchApiKey`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更与实时监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 仓库\n\n- GitHub: <https://github.com/robinspt/tickflow-assist>\n",
+  "readmeFilename": "README.md"
 }