tickflow-assist 0.2.12 → 0.2.13

package/README.md

@@ -2,7 +2,7 @@
 
 基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.2.12` 调整社区安装清单，允许先安装插件再执行 `configure-openclaw` 写入密钥配置；同时将 `test_alert` 升级为文本 + PNG 告警卡链路测试。
+最近更新：`v0.2.13` 在 `configure-openclaw` 与一键安装脚本中加入 Linux 中文字体自动安装，减少 VPS 上 PNG 告警卡中文乱码；并补充 GitHub README 效果预览图。
 
 ## 安装
 
@@ -14,6 +14,7 @@ npx -y tickflow-assist configure-openclaw
 ```
 
 安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。
+在 Linux 上，`configure-openclaw` 还会 best-effort 安装 PNG 告警卡所需的中文字体；如需跳过，可追加 `--no-font-setup`。
 
 第二条命令会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并默认执行：
 

package/dist/dev/tickflow-assist-cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -38,6 +39,7 @@ Options:
   --no-enable                 Do not run 'openclaw plugins enable'
   --no-restart                Do not run 'openclaw gateway restart'
   --no-python-setup           Do not run 'uv sync' for Python dependencies
+  --no-font-setup             Do not try to install Linux Chinese fonts for PNG alerts
   --openclaw-bin <path>       OpenClaw CLI binary, default: openclaw
   --tickflow-api-key <key>
   --tickflow-api-key-level <Free|Start|Pro|Expert>
@@ -61,6 +63,7 @@ function parseArgs(argv) {
         restart: true,
         enable: true,
         pythonSetup: true,
+        fontSetup: true,
         openclawBin: DEFAULTS.openclawCliBin,
         overrides: {},
     };
@@ -115,6 +118,9 @@ function parseArgs(argv) {
             case "--no-python-setup":
                 options.pythonSetup = false;
                 break;
+            case "--no-font-setup":
+                options.fontSetup = false;
+                break;
             case "--no-enable":
                 options.enable = false;
                 break;
@@ -623,6 +629,162 @@ async function setupPythonDeps(pythonWorkdir, nonInteractive) {
     }
     console.log("Python dependencies installed successfully.");
 }
+function isCommandAvailable(command) {
+    const result = spawnSync("which", [command], { stdio: "ignore" });
+    return result.status === 0;
+}
+function isRootUser() {
+    return typeof process.getuid === "function" && process.getuid() === 0;
+}
+function hasChineseFonts() {
+    const result = spawnSync("fc-list", [":lang=zh", "family"], { encoding: "utf-8" });
+    return result.status === 0 && Boolean(result.stdout.trim());
+}
+function detectLinuxDistro() {
+    try {
+        const raw = readFileSync("/etc/os-release", "utf-8");
+        const record = Object.fromEntries(raw
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .filter((line) => !line.startsWith("#") && line.includes("="))
+            .map((line) => {
+            const index = line.indexOf("=");
+            const key = line.slice(0, index);
+            const value = line.slice(index + 1).replace(/^"/, "").replace(/"$/, "");
+            return [key, value];
+        }));
+        const ids = [
+            String(record.ID ?? "").toLowerCase(),
+            ...String(record.ID_LIKE ?? "")
+                .toLowerCase()
+                .split(/\s+/)
+                .filter(Boolean),
+        ];
+        if (ids.some((value) => ["debian", "ubuntu"].includes(value))) {
+            return "debian";
+        }
+        if (ids.some((value) => ["rhel", "fedora", "centos", "rocky", "almalinux"].includes(value))) {
+            return "rhel";
+        }
+        if (ids.some((value) => ["arch", "manjaro"].includes(value))) {
+            return "arch";
+        }
+        if (ids.includes("alpine")) {
+            return "alpine";
+        }
+    }
+    catch {
+        // fall through
+    }
+    return "unknown";
+}
+function getManualFontCommands(distro) {
+    switch (distro) {
+        case "debian":
+            return ["sudo apt-get update", "sudo apt-get install -y fontconfig fonts-noto-cjk", "fc-cache -fv"];
+        case "rhel":
+            return [
+                "sudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts",
+                "fc-cache -fv",
+            ];
+        case "arch":
+            return ["sudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk", "fc-cache -fv"];
+        case "alpine":
+            return ["sudo apk add fontconfig font-noto-cjk", "fc-cache -fv"];
+        default:
+            return [
+                "请安装 fontconfig 和任意可用的中文字体包，例如 Noto Sans CJK",
+                "安装后执行: fc-cache -fv",
+            ];
+    }
+}
+function buildPrivilegedCommand(argv, nonInteractive) {
+    if (isRootUser()) {
+        return argv;
+    }
+    if (!isCommandAvailable("sudo")) {
+        return null;
+    }
+    return nonInteractive ? ["sudo", "-n", ...argv] : ["sudo", ...argv];
+}
+function runSetupCommand(argv, description) {
+    console.log(description);
+    const result = spawnSync(argv[0], argv.slice(1), { stdio: "inherit" });
+    if (result.error) {
+        console.warn(`Warning: failed to run ${description}: ${result.error.message}`);
+        return false;
+    }
+    if (result.status !== 0) {
+        console.warn(`Warning: ${description} exited with status ${result.status}`);
+        return false;
+    }
+    return true;
+}
+async function setupLinuxChineseFonts(nonInteractive) {
+    if (process.platform !== "linux") {
+        return;
+    }
+    if (!isCommandAvailable("fc-list")) {
+        console.warn("Warning: fontconfig is not installed; PNG alerts may not render Chinese text correctly.");
+    }
+    else if (hasChineseFonts()) {
+        console.log("Chinese fonts detected for PNG alert cards.");
+        return;
+    }
+    const distro = detectLinuxDistro();
+    console.log("Chinese fonts not detected. TickFlow Assist will try to install Noto CJK fonts for PNG alert cards.");
+    const attempts = [];
+    switch (distro) {
+        case "debian":
+            attempts.push(["apt-get", "update"]);
+            attempts.push(["apt-get", "install", "-y", "fontconfig", "fonts-noto-cjk"]);
+            break;
+        case "rhel":
+            attempts.push(["dnf", "install", "-y", "fontconfig", "google-noto-sans-cjk-ttc-fonts"]);
+            attempts.push(["dnf", "install", "-y", "fontconfig", "google-noto-cjk-fonts"]);
+            attempts.push(["yum", "install", "-y", "fontconfig", "google-noto-sans-cjk-ttc-fonts"]);
+            attempts.push(["yum", "install", "-y", "fontconfig", "google-noto-cjk-fonts"]);
+            break;
+        case "arch":
+            attempts.push(["pacman", "-Sy", "--noconfirm", "fontconfig", "noto-fonts-cjk"]);
+            break;
+        case "alpine":
+            attempts.push(["apk", "add", "fontconfig", "font-noto-cjk"]);
+            break;
+        default:
+            break;
+    }
+    let attemptedInstall = false;
+    for (const baseArgv of attempts) {
+        if (!isCommandAvailable(baseArgv[0])) {
+            continue;
+        }
+        const argv = buildPrivilegedCommand(baseArgv, nonInteractive);
+        if (!argv) {
+            break;
+        }
+        attemptedInstall = true;
+        if (!runSetupCommand(argv, `Running ${argv.join(" ")}`)) {
+            continue;
+        }
+        if (isCommandAvailable("fc-cache")) {
+            runSetupCommand(["fc-cache", "-fv"], "Refreshing font cache with fc-cache -fv");
+        }
+        if (isCommandAvailable("fc-list") && hasChineseFonts()) {
+            console.log("Chinese fonts installed successfully.");
+            return;
+        }
+    }
+    console.warn("Warning: automatic Chinese font setup did not complete.");
+    if (!attemptedInstall && nonInteractive) {
+        console.warn("Non-interactive mode skipped any sudo password prompt.");
+    }
+    console.warn("Manual install examples:");
+    for (const command of getManualFontCommands(distro)) {
+        console.warn(`  ${command}`);
+    }
+}
 async function configureOpenClaw(options) {
     const configPath = resolveOpenClawConfigPath(options.configPath);
     const stateDir = resolveStateDir(configPath);
@@ -636,6 +798,9 @@ async function configureOpenClaw(options) {
     if (options.pythonSetup) {
         await setupPythonDeps(config.pythonWorkdir, options.nonInteractive);
     }
+    if (options.fontSetup) {
+        await setupLinuxChineseFonts(options.nonInteractive);
+    }
     applyPluginConfig(root, config, target);
     const backupPath = await writeConfig(configPath, root);
     console.log("");

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "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.12",
+  "version": "0.2.13",
   "description": "OpenClaw plugin for TickFlow-based A-share analysis, monitoring, and alerting.",
   "license": "MIT",
   "type": "module",