tickflow-assist 0.2.16 → 0.2.17

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.17` 补充 Linux / macOS 的字体安装命令，`configure-openclaw` 会自动把被旧版本钉死的 ClawHub install spec 归一化为 `clawhub:tickflow-assist`，并将空自选时的 `ta_startmonitor` 失败改为可见提示。
 
 当前主线按 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
+```
 
 社区安装后的升级方式：
 

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/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/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.16",
+  "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 提供实时监控、收盘后复盘、多维综合分析、关键价位跟踪与告警能力。",
   "license": "MIT",
   "type": "module",