tickflow-assist 0.2.16 → 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.16` 移除社区发布包中的 `child_process` 依赖，以兼容 OpenClaw `v2026.3.31` 的危险代码扫描；源码一键安装脚本仍保留自动依赖安装与 Gateway 配置能力。
+最近更新：`v0.2.18` 调整 PNG 告警卡的日内时间轴与午间衔接逻辑，修复测试图与 demo 图的时间展示不一致；同时修正社区版配置字段说明，并补强 npm 打包脚本对包页 README 元数据的处理。
 
 当前主线按 OpenClaw `v2026.3.31+` 对齐。
 
@@ -21,6 +21,7 @@ openclaw gateway restart
 
 安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。
 `configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令。
+如果检测到 `plugins.installs["tickflow-assist"]` 来自 `clawhub`，向导还会把被旧版本钉死的 `spec` 归一化为 `clawhub:tickflow-assist`，避免后续升级继续锁在旧版本。
 
 如果你希望先审阅配置，再只打印最少的后续步骤，可使用：
 
@@ -28,7 +29,31 @@ openclaw gateway restart
 npx -y tickflow-assist configure-openclaw --no-enable --no-restart
 ```
 
-如果你在 Linux 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体。
+如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体，例如：
+
+```bash
+# Debian / Ubuntu
+sudo apt-get update
+sudo apt-get install -y fontconfig fonts-noto-cjk
+fc-cache -fv
+
+# RHEL / Fedora / Rocky / AlmaLinux
+sudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts
+fc-cache -fv
+
+# Arch / Manjaro
+sudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk
+fc-cache -fv
+
+# Alpine
+sudo apk add fontconfig font-noto-cjk
+fc-cache -fv
+
+# macOS (Homebrew)
+brew install fontconfig
+brew install --cask font-noto-sans-cjk
+fc-cache -fv
+```
 
 社区安装后的升级方式：
 
@@ -51,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/dev/tickflow-assist-cli.js

@@ -38,7 +38,7 @@ Options:
   --no-enable                 Do not print 'openclaw plugins enable' in next steps
   --no-restart                Do not print 'openclaw gateway restart' in next steps
   --no-python-setup           Do not print Python dependency setup guidance
-  --no-font-setup             Do not print Linux Chinese font setup guidance
+  --no-font-setup             Do not print Chinese font setup guidance
   --openclaw-bin <path>       OpenClaw CLI binary name used in printed next steps
   --tickflow-api-key <key>
   --tickflow-api-key-level <Free|Start|Pro|Expert>
@@ -501,6 +501,34 @@ function assertRequired(config) {
         throw new Error("llmApiKey is required");
     }
 }
+function normalizeCommunityInstallSpec(root) {
+    const plugins = root.plugins;
+    if (typeof plugins !== "object" || plugins === null || Array.isArray(plugins)) {
+        return false;
+    }
+    const installs = plugins.installs;
+    if (typeof installs !== "object" || installs === null || Array.isArray(installs)) {
+        return false;
+    }
+    const installEntry = installs[PLUGIN_ID];
+    if (typeof installEntry !== "object" || installEntry === null || Array.isArray(installEntry)) {
+        return false;
+    }
+    const source = stringValue(installEntry.source).toLowerCase();
+    if (source !== "clawhub") {
+        return false;
+    }
+    const canonicalSpec = `clawhub:${PLUGIN_ID}`;
+    const currentSpec = stringValue(installEntry.spec);
+    if (currentSpec === canonicalSpec) {
+        return false;
+    }
+    if (!currentSpec || currentSpec.startsWith(`${canonicalSpec}@`)) {
+        installEntry.spec = canonicalSpec;
+        return true;
+    }
+    return false;
+}
 async function ensurePathNotice(targetPath, label) {
     try {
         await access(targetPath);
@@ -644,6 +672,13 @@ function getManualFontCommands(distro) {
             ];
     }
 }
+function getManualMacosFontCommands() {
+    return [
+        "brew install fontconfig",
+        "brew install --cask font-noto-sans-cjk",
+        "fc-cache -fv",
+    ];
+}
 function printNextSteps(options, config) {
     console.log("");
     console.log("接下来的命令需要你手动执行。");
@@ -654,9 +689,13 @@ function printNextSteps(options, config) {
         console.log("   uv sync");
         step += 1;
     }
-    if (options.fontSetup && process.platform === "linux") {
-        console.log(`${step}. 如需 PNG 告警卡正常显示中文，请按你的 Linux 发行版安装字体`);
-        for (const command of getManualFontCommands(detectLinuxDistro())) {
+    if (options.fontSetup && (process.platform === "linux" || process.platform === "darwin")) {
+        const commands = process.platform === "darwin"
+            ? getManualMacosFontCommands()
+            : getManualFontCommands(detectLinuxDistro());
+        const platformLabel = process.platform === "darwin" ? "macOS" : "Linux 发行版";
+        console.log(`${step}. 如需 PNG 告警卡正常显示中文，请按你的 ${platformLabel} 安装字体`);
+        for (const command of commands) {
             console.log(`   ${command}`);
         }
         step += 1;
@@ -685,6 +724,7 @@ async function configureOpenClaw(options) {
     await ensurePathNotice(config.calendarFile, "calendarFile");
     await ensurePathNotice(config.pythonWorkdir, "pythonWorkdir");
     applyPluginConfig(root, config, target);
+    const normalizedInstallSpec = normalizeCommunityInstallSpec(root);
     const backupPath = await writeConfig(configPath, root);
     console.log("");
     console.log(`Updated OpenClaw config: ${configPath}`);
@@ -693,6 +733,9 @@ async function configureOpenClaw(options) {
     }
     console.log(`Plugin dir: ${pluginDir}`);
     console.log(`Allowlist target: ${target.type === "global" ? "global tools" : `agent:${target.id}`}`);
+    if (normalizedInstallSpec) {
+        console.log(`Community install spec normalized: clawhub:${PLUGIN_ID}`);
+    }
     printNextSteps(options, config);
 }
 async function main() {

package/dist/plugin-commands.js

@@ -36,6 +36,19 @@ function parseRequiredSymbol(args, usage) {
 async function runToolText(tool, rawInput) {
     return tool.run({ rawInput });
 }
+function formatCommandError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const normalized = message.trim() || "未知错误";
+    return `⚠️ ${normalized}`;
+}
+async function runCommandText(task) {
+    try {
+        return { text: await task() };
+    }
+    catch (error) {
+        return { text: formatCommandError(error) };
+    }
+}
 async function renderWatchlistDebug(app) {
     const snapshot = await buildWatchlistDebugSnapshot(app);
     const lines = [
@@ -79,148 +92,114 @@ export function registerPluginCommands(api, tools, app) {
             description: "添加自选股，不经过 AI 对话。用法: /ta_addstock <symbol> [costPrice] [count]",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(addStock, parseAddStockArgs(args)),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(addStock, parseAddStockArgs(args))),
         },
         {
             name: "ta_rmstock",
             description: "删除自选股，不经过 AI 对话。用法: /ta_rmstock <symbol>",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(removeStock, {
-                    symbol: parseRequiredSymbol(args, "/ta_rmstock <symbol>"),
-                }),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(removeStock, {
+                symbol: parseRequiredSymbol(args, "/ta_rmstock <symbol>"),
+            })),
         },
         {
             name: "ta_analyze",
             description: "分析单只股票，不经过 AI 对话。用法: /ta_analyze <symbol>",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(analyze, {
-                    symbol: parseRequiredSymbol(args, "/ta_analyze <symbol>"),
-                }),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(analyze, {
+                symbol: parseRequiredSymbol(args, "/ta_analyze <symbol>"),
+            })),
         },
         {
             name: "ta_backtest",
             description: "回测活动价位，不经过 AI 对话。用法: /ta_backtest [symbol] [recentLimit]",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(backtestKeyLevels, args?.trim() || undefined),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(backtestKeyLevels, args?.trim() || undefined)),
         },
         {
             name: "ta_viewanalysis",
             description: "查看单只股票最近一次保存的分析结果，不经过 AI 对话。用法: /ta_viewanalysis <symbol>",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(viewAnalysis, {
-                    symbol: parseRequiredSymbol(args, "/ta_viewanalysis <symbol>"),
-                }),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(viewAnalysis, {
+                symbol: parseRequiredSymbol(args, "/ta_viewanalysis <symbol>"),
+            })),
         },
         {
             name: "ta_watchlist",
             description: "查看当前自选列表，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(listWatchlist),
-            }),
+            handler: async () => runCommandText(() => runToolText(listWatchlist)),
         },
         {
             name: "ta_refreshnames",
             description: "刷新自选股名称，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(refreshWatchlistNames),
-            }),
+            handler: async () => runCommandText(() => runToolText(refreshWatchlistNames)),
         },
         {
             name: "ta_refreshprofiles",
             description: "刷新自选股行业分类与概念板块，不经过 AI 对话。用法: /ta_refreshprofiles [symbol]",
             acceptsArgs: true,
             requireAuth: true,
-            handler: async ({ args }) => ({
-                text: await runToolText(refreshWatchlistProfiles, args?.trim() || undefined),
-            }),
+            handler: async ({ args }) => runCommandText(() => runToolText(refreshWatchlistProfiles, args?.trim() || undefined)),
         },
         {
             name: "ta_startmonitor",
             description: "启动实时监控，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(startMonitor),
-            }),
+            handler: async () => runCommandText(() => runToolText(startMonitor)),
         },
         {
             name: "ta_stopmonitor",
             description: "停止实时监控，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(stopMonitor),
-            }),
+            handler: async () => runCommandText(() => runToolText(stopMonitor)),
         },
         {
             name: "ta_monitorstatus",
             description: "查看实时监控状态，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(monitorStatus),
-            }),
+            handler: async () => runCommandText(() => runToolText(monitorStatus)),
         },
         {
             name: "ta_startdailyupdate",
             description: "启动定时日更任务，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(startDailyUpdate),
-            }),
+            handler: async () => runCommandText(() => runToolText(startDailyUpdate)),
         },
         {
             name: "ta_stopdailyupdate",
             description: "停止定时日更任务，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(stopDailyUpdate),
-            }),
+            handler: async () => runCommandText(() => runToolText(stopDailyUpdate)),
         },
         {
             name: "ta_updateall",
             description: "立即执行一次完整日更，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(updateAll),
-            }),
+            handler: async () => runCommandText(() => runToolText(updateAll)),
         },
         {
             name: "ta_dailyupdatestatus",
             description: "查看定时日更状态，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(dailyUpdateStatus),
-            }),
+            handler: async () => runCommandText(() => runToolText(dailyUpdateStatus)),
         },
         {
             name: "ta_testalert",
             description: "发送一条文本 + PNG 测试告警，不经过 AI 对话。",
             requireAuth: true,
-            handler: async () => ({
-                text: await runToolText(testAlert),
-            }),
+            handler: async () => runCommandText(() => runToolText(testAlert)),
         },
         {
             name: "ta_debug",
             description: "查看 TickFlow 插件运行时调试信息。",
             requireAuth: true,
-            handler: async () => ({
-                text: await renderWatchlistDebug(app),
-            }),
+            handler: async () => runCommandText(() => renderWatchlistDebug(app)),
         },
     ];
     for (const command of commands) {

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/start-monitor.tool.js

@@ -5,9 +5,15 @@ export function startMonitorTool(monitorService, runtime) {
         optional: true,
         async run() {
             if (runtime.pluginManagedServices) {
-                const result = await monitorService.enableManagedLoop();
+                let result;
+                try {
+                    result = await monitorService.enableManagedLoop();
+                }
+                catch (error) {
+                    return formatManagedStartError(error);
+                }
                 if (!result.started) {
-                    return await monitorService.getStatusReport();
+                    return await buildManagedAlreadyRunningSummary(monitorService);
                 }
                 return [
                     "✅ TickFlow 实时监控已启动",
@@ -20,7 +26,12 @@ export function startMonitorTool(monitorService, runtime) {
             if (currentState.running
                 && currentState.workerPid != null
                 && isPidAlive(currentState.workerPid)) {
-                return await monitorService.getStatusReport();
+                return [
+                    "✅ TickFlow 实时监控已在运行",
+                    "运行方式: manual_loop",
+                    `PID: ${currentState.workerPid}`,
+                    "说明: 本地监控循环已存在，无需重复启动。",
+                ].join("\n");
             }
             const summary = await monitorService.start();
             return [
@@ -31,6 +42,29 @@ export function startMonitorTool(monitorService, runtime) {
         },
     };
 }
+async function buildManagedAlreadyRunningSummary(monitorService) {
+    const state = await monitorService.getState();
+    return [
+        "✅ TickFlow 实时监控已在运行",
+        "运行方式: plugin_service",
+        `最近心跳: ${state.lastHeartbeatAt ?? "暂无"}`,
+        "说明: 后台服务按配置间隔轮询，交易时段自动执行监控。",
+    ].join("\n");
+}
+function formatManagedStartError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("关注列表为空")) {
+        return [
+            "⚠️ 无法启动实时监控",
+            "原因: 关注列表为空，请先添加至少一只自选股。",
+            "示例: /ta_addstock 000001 10.50",
+        ].join("\n");
+    }
+    return [
+        "⚠️ 启动实时监控失败",
+        `原因: ${message}`,
+    ].join("\n");
+}
 function isPidAlive(pid) {
     try {
         process.kill(pid, 0);

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.16",
+  "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.16",
-  "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"
 }