tickflow-assist 0.3.4 → 0.3.5

package/README.md

@@ -2,9 +2,21 @@
 
 基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.3.4` 新增 `09:20` 盘前资讯简报，修复 Jin10 历史补页重复推送与状态页最新快讯显示错误，并降低 Telegram 图文告警被误判失败后重复补发的风险。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
+最近更新：`v0.3.5` 对齐 OpenClaw `2026.4.11` metadata 与社区安装提示，修复源码升级时本地链接扫描 `node_modules` 失败的问题，并支持通过环境变量回退 TickFlow / LLM / MX / Jin10 配置。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
 
-当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.5` 上兼容。
+当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.11` 上兼容。
+
+## 安装前准备
+
+在执行社区安装前，建议先确认你已经准备好以下配置：
+
+- 核心必需：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`
+- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`
+- 可选增强：`mxSearchApiKey`、`jin10ApiToken`
+
+其中，`configure-openclaw` 会把上述配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries["tickflow-assist"].config`，插件启用后会在本地 `databasePath` 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。
+如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 `openclaw.json / local.config.json` > 环境变量 > 默认值。
+常用环境变量：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`、`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`、`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`、`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`、`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`、`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`。
 
 ## 安装
 
@@ -19,8 +31,8 @@ openclaw config validate
 openclaw gateway restart
 ```
 
-安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。
-`configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令。
+安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel` 等正式配置。
+`configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令，也不会重新执行插件安装；如果你已经设置了环境变量，密钥项可留空，输入 `-` 可主动清空已有配置并切回环境变量。
 如果检测到 `plugins.installs["tickflow-assist"]` 来自 `clawhub`，向导还会把被旧版本钉死的 `spec` 归一化为 `clawhub:tickflow-assist`，避免后续升级继续锁在旧版本。
 
 如果你希望先审阅配置，再只打印最少的后续步骤，可使用：
@@ -84,6 +96,18 @@ plugins.entries["tickflow-assist"].config
 - 能力补充：`mxSearchApiKey`、`jin10ApiToken`
 
 其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。
+如果你使用环境变量，运行时支持以下回退：
+
+- `tickflowApiUrl`：`TICKFLOW_ASSIST_TICKFLOW_API_URL` / `TICKFLOW_API_URL`
+- `tickflowApiKey`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`
+- `tickflowApiKeyLevel`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL` / `TICKFLOW_API_KEY_LEVEL`
+- `llmBaseUrl`：`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`
+- `llmApiKey`：`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`
+- `llmModel`：`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`
+- `mxSearchApiUrl`：`TICKFLOW_ASSIST_MX_SEARCH_API_URL` / `MX_SEARCH_API_URL`
+- `mxSearchApiKey`：`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`
+- `jin10McpUrl`：`TICKFLOW_ASSIST_JIN10_MCP_URL` / `JIN10_MCP_URL`
+- `jin10ApiToken`：`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`
 
 ## 功能
 
@@ -107,4 +131,4 @@ plugins.entries["tickflow-assist"].config
 
 ## 仓库
 
-- GitHub: <https://github.com/robinspt/tickflow-assist>
+- GitHub: [robinspt/tickflow-assist](https://github.com/robinspt/tickflow-assist)

package/dist/config/env.d.ts

@@ -0,0 +1,17 @@
+export declare const CONFIG_ENV_FALLBACKS: {
+    readonly tickflowApiUrl: readonly ["TICKFLOW_ASSIST_TICKFLOW_API_URL", "TICKFLOW_API_URL"];
+    readonly tickflowApiKey: readonly ["TICKFLOW_ASSIST_TICKFLOW_API_KEY", "TICKFLOW_API_KEY"];
+    readonly tickflowApiKeyLevel: readonly ["TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL", "TICKFLOW_API_KEY_LEVEL"];
+    readonly mxSearchApiUrl: readonly ["TICKFLOW_ASSIST_MX_SEARCH_API_URL", "MX_SEARCH_API_URL"];
+    readonly mxSearchApiKey: readonly ["TICKFLOW_ASSIST_MX_SEARCH_API_KEY", "MX_SEARCH_API_KEY", "MX_APIKEY"];
+    readonly jin10McpUrl: readonly ["TICKFLOW_ASSIST_JIN10_MCP_URL", "JIN10_MCP_URL"];
+    readonly jin10ApiToken: readonly ["TICKFLOW_ASSIST_JIN10_API_TOKEN", "JIN10_API_TOKEN"];
+    readonly llmBaseUrl: readonly ["TICKFLOW_ASSIST_LLM_BASE_URL", "LLM_BASE_URL"];
+    readonly llmApiKey: readonly ["TICKFLOW_ASSIST_LLM_API_KEY", "LLM_API_KEY"];
+    readonly llmModel: readonly ["TICKFLOW_ASSIST_LLM_MODEL", "LLM_MODEL"];
+};
+export type EnvBackedConfigKey = keyof typeof CONFIG_ENV_FALLBACKS;
+export declare function getEnvFallbackValue(names: readonly string[], env?: NodeJS.ProcessEnv): string;
+export declare function getConfigEnvFallback(key: EnvBackedConfigKey, env?: NodeJS.ProcessEnv): string;
+export declare function hasConfigEnvFallback(key: EnvBackedConfigKey, env?: NodeJS.ProcessEnv): boolean;
+export declare function formatConfigEnvFallback(key: EnvBackedConfigKey): string;

package/dist/config/env.js

@@ -0,0 +1,30 @@
+export const CONFIG_ENV_FALLBACKS = {
+    tickflowApiUrl: ["TICKFLOW_ASSIST_TICKFLOW_API_URL", "TICKFLOW_API_URL"],
+    tickflowApiKey: ["TICKFLOW_ASSIST_TICKFLOW_API_KEY", "TICKFLOW_API_KEY"],
+    tickflowApiKeyLevel: ["TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL", "TICKFLOW_API_KEY_LEVEL"],
+    mxSearchApiUrl: ["TICKFLOW_ASSIST_MX_SEARCH_API_URL", "MX_SEARCH_API_URL"],
+    mxSearchApiKey: ["TICKFLOW_ASSIST_MX_SEARCH_API_KEY", "MX_SEARCH_API_KEY", "MX_APIKEY"],
+    jin10McpUrl: ["TICKFLOW_ASSIST_JIN10_MCP_URL", "JIN10_MCP_URL"],
+    jin10ApiToken: ["TICKFLOW_ASSIST_JIN10_API_TOKEN", "JIN10_API_TOKEN"],
+    llmBaseUrl: ["TICKFLOW_ASSIST_LLM_BASE_URL", "LLM_BASE_URL"],
+    llmApiKey: ["TICKFLOW_ASSIST_LLM_API_KEY", "LLM_API_KEY"],
+    llmModel: ["TICKFLOW_ASSIST_LLM_MODEL", "LLM_MODEL"],
+};
+export function getEnvFallbackValue(names, env = process.env) {
+    for (const name of names) {
+        const value = env[name];
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+    }
+    return "";
+}
+export function getConfigEnvFallback(key, env = process.env) {
+    return getEnvFallbackValue(CONFIG_ENV_FALLBACKS[key], env);
+}
+export function hasConfigEnvFallback(key, env = process.env) {
+    return Boolean(getConfigEnvFallback(key, env));
+}
+export function formatConfigEnvFallback(key) {
+    return CONFIG_ENV_FALLBACKS[key].join(" / ");
+}

package/dist/config/normalize.js

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { getConfigEnvFallback } from "./env.js";
 import { normalizeTickflowApiKeyLevel } from "./tickflow-access.js";
 import { DEFAULT_PLUGIN_CONFIG } from "./schema.js";
 function normalizeString(value, fallback = "") {
@@ -10,6 +11,10 @@ function normalizeString(value, fallback = "") {
     }
     return String(value).trim();
 }
+function normalizeStringWithFallback(value, fallback = "") {
+    const normalized = normalizeString(value);
+    return normalized || fallback;
+}
 function normalizeInteger(value, fallback) {
     const parsed = Number(value ?? fallback);
     return Number.isFinite(parsed) ? Math.max(1, Math.trunc(parsed)) : fallback;
@@ -40,22 +45,30 @@ function normalizeBoolean(value, fallback) {
 }
 export function normalizePluginConfig(input) {
     const raw = (input ?? {});
-    const envMxSearchApiUrl = normalizeString(process.env.MX_SEARCH_API_URL);
-    const envMxSearchApiKey = normalizeString(process.env.MX_APIKEY);
+    const envTickflowApiUrl = getConfigEnvFallback("tickflowApiUrl");
+    const envTickflowApiKey = getConfigEnvFallback("tickflowApiKey");
+    const envTickflowApiKeyLevel = getConfigEnvFallback("tickflowApiKeyLevel");
+    const envMxSearchApiUrl = getConfigEnvFallback("mxSearchApiUrl");
+    const envMxSearchApiKey = getConfigEnvFallback("mxSearchApiKey");
+    const envJin10McpUrl = getConfigEnvFallback("jin10McpUrl");
+    const envJin10ApiToken = getConfigEnvFallback("jin10ApiToken");
+    const envLlmBaseUrl = getConfigEnvFallback("llmBaseUrl");
+    const envLlmApiKey = getConfigEnvFallback("llmApiKey");
+    const envLlmModel = getConfigEnvFallback("llmModel");
     return {
-        tickflowApiUrl: normalizeString(raw.tickflowApiUrl, DEFAULT_PLUGIN_CONFIG.tickflowApiUrl),
-        tickflowApiKey: normalizeString(raw.tickflowApiKey),
-        tickflowApiKeyLevel: normalizeTickflowApiKeyLevel(raw.tickflowApiKeyLevel, DEFAULT_PLUGIN_CONFIG.tickflowApiKeyLevel),
-        mxSearchApiUrl: normalizeString(raw.mxSearchApiUrl, envMxSearchApiUrl || DEFAULT_PLUGIN_CONFIG.mxSearchApiUrl),
-        mxSearchApiKey: normalizeString(raw.mxSearchApiKey, envMxSearchApiKey || DEFAULT_PLUGIN_CONFIG.mxSearchApiKey),
-        jin10McpUrl: normalizeString(raw.jin10McpUrl, DEFAULT_PLUGIN_CONFIG.jin10McpUrl),
-        jin10ApiToken: normalizeString(raw.jin10ApiToken),
+        tickflowApiUrl: normalizeStringWithFallback(raw.tickflowApiUrl, envTickflowApiUrl || DEFAULT_PLUGIN_CONFIG.tickflowApiUrl),
+        tickflowApiKey: normalizeStringWithFallback(raw.tickflowApiKey, envTickflowApiKey),
+        tickflowApiKeyLevel: normalizeTickflowApiKeyLevel(normalizeStringWithFallback(raw.tickflowApiKeyLevel, envTickflowApiKeyLevel), DEFAULT_PLUGIN_CONFIG.tickflowApiKeyLevel),
+        mxSearchApiUrl: normalizeStringWithFallback(raw.mxSearchApiUrl, envMxSearchApiUrl || DEFAULT_PLUGIN_CONFIG.mxSearchApiUrl),
+        mxSearchApiKey: normalizeStringWithFallback(raw.mxSearchApiKey, envMxSearchApiKey || DEFAULT_PLUGIN_CONFIG.mxSearchApiKey),
+        jin10McpUrl: normalizeStringWithFallback(raw.jin10McpUrl, envJin10McpUrl || DEFAULT_PLUGIN_CONFIG.jin10McpUrl),
+        jin10ApiToken: normalizeStringWithFallback(raw.jin10ApiToken, envJin10ApiToken),
         jin10FlashPollInterval: normalizeInteger(raw.jin10FlashPollInterval, DEFAULT_PLUGIN_CONFIG.jin10FlashPollInterval),
         jin10FlashRetentionDays: normalizeInteger(raw.jin10FlashRetentionDays, DEFAULT_PLUGIN_CONFIG.jin10FlashRetentionDays),
         jin10FlashNightAlert: normalizeBoolean(raw.jin10FlashNightAlert, DEFAULT_PLUGIN_CONFIG.jin10FlashNightAlert),
-        llmBaseUrl: normalizeString(raw.llmBaseUrl, DEFAULT_PLUGIN_CONFIG.llmBaseUrl),
-        llmApiKey: normalizeString(raw.llmApiKey),
-        llmModel: normalizeString(raw.llmModel, DEFAULT_PLUGIN_CONFIG.llmModel),
+        llmBaseUrl: normalizeStringWithFallback(raw.llmBaseUrl, envLlmBaseUrl || DEFAULT_PLUGIN_CONFIG.llmBaseUrl),
+        llmApiKey: normalizeStringWithFallback(raw.llmApiKey, envLlmApiKey),
+        llmModel: normalizeStringWithFallback(raw.llmModel, envLlmModel || DEFAULT_PLUGIN_CONFIG.llmModel),
         databasePath: normalizeString(raw.databasePath, DEFAULT_PLUGIN_CONFIG.databasePath),
         calendarFile: normalizeString(raw.calendarFile, DEFAULT_PLUGIN_CONFIG.calendarFile),
         requestInterval: normalizeInteger(raw.requestInterval, DEFAULT_PLUGIN_CONFIG.requestInterval),

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

@@ -6,6 +6,7 @@ import path from "node:path";
 import process from "node:process";
 import { createInterface } from "node:readline/promises";
 import JSON5 from "json5";
+import { formatConfigEnvFallback, hasConfigEnvFallback, } from "../config/env.js";
 const PLUGIN_ID = "tickflow-assist";
 const DEFAULT_CONFIG_PATH = path.join(os.homedir(), ".openclaw", "openclaw.json");
 const DEFAULTS = {
@@ -59,6 +60,14 @@ Options:
   --alert-account <name>
   --alert-target <target>
   -h, --help                  Show this help
+
+Environment fallback:
+  tickflowApiKey      ${formatConfigEnvFallback("tickflowApiKey")}
+  llmApiKey           ${formatConfigEnvFallback("llmApiKey")}
+  llmBaseUrl          ${formatConfigEnvFallback("llmBaseUrl")}
+  llmModel            ${formatConfigEnvFallback("llmModel")}
+  mxSearchApiKey      ${formatConfigEnvFallback("mxSearchApiKey")}
+  jin10ApiToken       ${formatConfigEnvFallback("jin10ApiToken")}
 `);
 }
 function parseArgs(argv) {
@@ -390,7 +399,7 @@ async function promptAlertChannel(rl, configPath, defaultChannel) {
         choices.push({ value: "__manual__", label: "手动输入其他通道" });
         selectedChannel = await promptSelect(rl, "检测到 openclaw.json 中已有配置，请选择推送通道", choices, defaultChannel);
         if (selectedChannel === "__manual__") {
-            selectedChannel = await promptString(rl, "Alert Channel", defaultChannel, true);
+            selectedChannel = await promptString(rl, "Alert Channel", defaultChannel, { required: true });
         }
     }
     else {
@@ -467,15 +476,29 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
         console.log(`OpenClaw 配置文件: ${configPath}`);
         console.log(`插件目录: ${pluginDir}`);
         console.log("");
-        seed.tickflowApiKey = await promptString(rl, "TickFlow API Key", seed.tickflowApiKey, true);
+        console.log("为避免后续运行时反复补配置，下面这些字段建议一次性填完整。");
+        console.log("");
+        seed.tickflowApiKey = await promptString(rl, buildEnvAwarePromptLabel("TickFlow API Key", "tickflowApiKey", seed.tickflowApiKey), seed.tickflowApiKey, {
+            required: !hasConfigEnvFallback("tickflowApiKey"),
+            maskDefault: true,
+            allowClear: true,
+        });
         seed.tickflowApiKeyLevel = normalizeApiKeyLevel(await promptSelect(rl, "TickFlow 订阅等级", [
             { value: "Free", label: "Free" },
             { value: "Start", label: "Start" },
             { value: "Pro", label: "Pro" },
             { value: "Expert", label: "Expert" },
         ], seed.tickflowApiKeyLevel));
-        seed.mxSearchApiKey = await promptString(rl, "MX Search API Key (可留空)", seed.mxSearchApiKey, false);
-        seed.jin10ApiToken = await promptString(rl, "Jin10 API Token (可留空)", seed.jin10ApiToken, false);
+        seed.mxSearchApiKey = await promptString(rl, buildEnvAwarePromptLabel("MX Search API Key（建议填写）", "mxSearchApiKey", seed.mxSearchApiKey), seed.mxSearchApiKey, {
+            required: false,
+            maskDefault: true,
+            allowClear: true,
+        });
+        seed.jin10ApiToken = await promptString(rl, buildEnvAwarePromptLabel("Jin10 API Token（建议填写）", "jin10ApiToken", seed.jin10ApiToken), seed.jin10ApiToken, {
+            required: false,
+            maskDefault: true,
+            allowClear: true,
+        });
         seed.jin10FlashPollInterval = await promptInteger(rl, "Jin10 快讯轮询间隔（秒）", seed.jin10FlashPollInterval, 10);
         seed.jin10FlashRetentionDays = await promptInteger(rl, "Jin10 快讯保留天数", seed.jin10FlashRetentionDays, 1);
         const nightAlertChoice = await promptSelect(rl, "Jin10 夜间静默", [
@@ -483,21 +506,31 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
             { value: "false", label: "开启夜间静默（22:00~06:00 不告警）" },
         ], seed.jin10FlashNightAlert ? "true" : "false");
         seed.jin10FlashNightAlert = nightAlertChoice === "true";
-        seed.llmBaseUrl = await promptString(rl, "LLM Base URL", seed.llmBaseUrl, true);
-        seed.llmApiKey = await promptString(rl, "LLM API Key", seed.llmApiKey, true);
-        seed.llmModel = await promptString(rl, "LLM Model", seed.llmModel, true);
+        seed.llmBaseUrl = await promptString(rl, buildEnvAwarePromptLabel("LLM Base URL", "llmBaseUrl", seed.llmBaseUrl), seed.llmBaseUrl, {
+            required: true,
+            allowClear: hasConfigEnvFallback("llmBaseUrl"),
+        });
+        seed.llmApiKey = await promptString(rl, buildEnvAwarePromptLabel("LLM API Key", "llmApiKey", seed.llmApiKey), seed.llmApiKey, {
+            required: !hasConfigEnvFallback("llmApiKey"),
+            maskDefault: true,
+            allowClear: true,
+        });
+        seed.llmModel = await promptString(rl, buildEnvAwarePromptLabel("LLM Model", "llmModel", seed.llmModel), seed.llmModel, {
+            required: true,
+            allowClear: hasConfigEnvFallback("llmModel"),
+        });
         console.log("");
         const alertResult = await promptAlertChannel(rl, configPath, seed.alertChannel);
         seed.alertChannel = alertResult.channel;
         seed.alertAccount = alertResult.account;
         let targetLabel = "Alert Target";
         if (seed.alertAccount) {
-            targetLabel = `已选通道 [${seed.alertChannel}] 及账号 [${seed.alertAccount}]，请输入 Alert Target`;
+            targetLabel = `已选通道 [${seed.alertChannel}] 及账号 [${seed.alertAccount}]，请输入 Alert Target（建议填写）`;
         }
         else {
-            targetLabel = `已选通道 [${seed.alertChannel}]，请输入 Alert Target`;
+            targetLabel = `已选通道 [${seed.alertChannel}]，请输入 Alert Target（建议填写）`;
         }
-        seed.alertTarget = await promptString(rl, targetLabel, seed.alertTarget, false);
+        seed.alertTarget = await promptString(rl, targetLabel, seed.alertTarget, { required: false });
         seed.requestInterval = await promptInteger(rl, "Request Interval (seconds)", seed.requestInterval, 5);
         seed.dailyUpdateNotify = await promptBoolean(rl, "Daily Update Notify", seed.dailyUpdateNotify);
     }
@@ -507,12 +540,17 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
     assertRequired(seed);
     return seed;
 }
-async function promptString(rl, label, defaultValue, required) {
+async function promptString(rl, label, defaultValue, options) {
     while (true) {
-        const suffix = defaultValue ? ` [${defaultValue}]` : "";
+        const suffix = defaultValue
+            ? options.maskDefault ? " [已存在]" : ` [${defaultValue}]`
+            : "";
         const answer = (await rl.question(`${label}${suffix}: `)).trim();
+        if (options.allowClear && answer === "-") {
+            return "";
+        }
         const value = answer || defaultValue;
-        if (!required || value) {
+        if (!options.required || value) {
             return value;
         }
         console.error(`${label} 不能为空`);
@@ -544,11 +582,11 @@ async function promptBoolean(rl, label, defaultValue) {
     }
 }
 function assertRequired(config) {
-    if (!config.tickflowApiKey) {
-        throw new Error("tickflowApiKey is required");
+    if (!config.tickflowApiKey && !hasConfigEnvFallback("tickflowApiKey")) {
+        throw new Error(`tickflowApiKey is required (or set ${formatConfigEnvFallback("tickflowApiKey")})`);
     }
-    if (!config.llmApiKey) {
-        throw new Error("llmApiKey is required");
+    if (!config.llmApiKey && !hasConfigEnvFallback("llmApiKey")) {
+        throw new Error(`llmApiKey is required (or set ${formatConfigEnvFallback("llmApiKey")})`);
     }
 }
 function normalizeCommunityInstallSpec(root) {
@@ -806,6 +844,7 @@ async function configureOpenClaw(options) {
     if (normalizedInstallSpec) {
         console.log(`Community install spec normalized: clawhub:${PLUGIN_ID}`);
     }
+    printActiveEnvFallbacks(config);
     printNextSteps(options, config);
 }
 async function main() {
@@ -823,3 +862,30 @@ async function main() {
     }
 }
 void main();
+function buildEnvAwarePromptLabel(label, key, currentValue) {
+    if (!hasConfigEnvFallback(key)) {
+        return label;
+    }
+    const fallback = formatConfigEnvFallback(key);
+    if (currentValue) {
+        return `${label}（留空保留当前值；输入 - 清空并改用环境变量 ${fallback}）`;
+    }
+    return `${label}（留空则使用环境变量 ${fallback}）`;
+}
+function printActiveEnvFallbacks(config) {
+    const activeFallbacks = [
+        { key: "tickflowApiKey", label: "TickFlow API Key", value: config.tickflowApiKey },
+        { key: "mxSearchApiKey", label: "MX Search API Key", value: config.mxSearchApiKey },
+        { key: "jin10ApiToken", label: "Jin10 API Token", value: config.jin10ApiToken },
+        { key: "llmBaseUrl", label: "LLM Base URL", value: config.llmBaseUrl },
+        { key: "llmApiKey", label: "LLM API Key", value: config.llmApiKey },
+        { key: "llmModel", label: "LLM Model", value: config.llmModel },
+    ].filter(({ key, value }) => !value && hasConfigEnvFallback(key));
+    if (activeFallbacks.length === 0) {
+        return;
+    }
+    console.log("Active env fallback:");
+    for (const entry of activeFallbacks) {
+        console.log(`  ${entry.label}: ${formatConfigEnvFallback(entry.key)}`);
+    }
+}

package/dist/services/analysis-service.js

@@ -1,3 +1,4 @@
+import { formatConfigEnvFallback } from "../config/env.js";
 export class AnalysisService {
     llmBaseUrl;
     llmApiKey;
@@ -14,13 +15,13 @@ export class AnalysisService {
     }
     getConfigurationError() {
         if (!this.llmBaseUrl.trim()) {
-            return "LLM 未配置接口地址，请设置 llmBaseUrl";
+            return `LLM 未配置接口地址，请设置 llmBaseUrl 或环境变量 ${formatConfigEnvFallback("llmBaseUrl")}`;
         }
         if (!this.llmApiKey.trim()) {
-            return "LLM 未配置 API Key，请设置 llmApiKey";
+            return `LLM 未配置 API Key，请设置 llmApiKey 或环境变量 ${formatConfigEnvFallback("llmApiKey")}`;
         }
         if (!this.llmModel.trim()) {
-            return "LLM 未配置模型，请设置 llmModel";
+            return `LLM 未配置模型，请设置 llmModel 或环境变量 ${formatConfigEnvFallback("llmModel")}`;
         }
         return null;
     }

package/dist/services/jin10-mcp-service.js

@@ -1,3 +1,4 @@
+import { formatConfigEnvFallback } from "../config/env.js";
 export class Jin10McpService {
     serverUrl;
     apiToken;
@@ -14,10 +15,10 @@ export class Jin10McpService {
     }
     getConfigurationError() {
         if (!this.serverUrl.trim()) {
-            return "Jin10 MCP 未配置接口地址，请设置 jin10McpUrl";
+            return `Jin10 MCP 未配置接口地址，请设置 jin10McpUrl 或环境变量 ${formatConfigEnvFallback("jin10McpUrl")}`;
         }
         if (!this.apiToken.trim()) {
-            return "Jin10 MCP 未配置 API Token，请设置 jin10ApiToken";
+            return `Jin10 MCP 未配置 API Token，请设置 jin10ApiToken 或环境变量 ${formatConfigEnvFallback("jin10ApiToken")}`;
         }
         return null;
     }

package/dist/services/mx-search-service.js

@@ -1,3 +1,4 @@
+import { formatConfigEnvFallback } from "../config/env.js";
 export class MxSearchServiceError extends Error {
     constructor(message) {
         super(message);
@@ -16,10 +17,10 @@ export class MxApiService {
     }
     getConfigurationError() {
         if (!this.apiBaseUrl.trim()) {
-            return "mx_search 未配置接口地址，请设置 mxSearchApiUrl 或环境变量 MX_SEARCH_API_URL";
+            return `mx_search 未配置接口地址，请设置 mxSearchApiUrl 或环境变量 ${formatConfigEnvFallback("mxSearchApiUrl")}`;
         }
         if (!this.apiKey.trim()) {
-            return "mx_search 未配置 API Key，请设置插件配置 mxSearchApiKey 或环境变量 MX_APIKEY";
+            return `mx_search 未配置 API Key，请设置插件配置 mxSearchApiKey 或环境变量 ${formatConfigEnvFallback("mxSearchApiKey")}`;
         }
         return null;
     }

package/openclaw.plugin.json

@@ -1,11 +1,39 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
   ],
+  "activation": {
+    "onCapabilities": ["tool", "hook"]
+  },
+  "setup": {
+    "requiresRuntime": true
+  },
+  "configContracts": {
+    "secretInputs": {
+      "paths": [
+        {
+          "path": "tickflowApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "llmApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "mxSearchApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "jin10ApiToken",
+          "expected": "string"
+        }
+      ]
+    }
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -13,38 +41,38 @@
       "tickflowApiUrl": {
         "type": "string",
         "default": "https://api.tickflow.org",
-        "description": "TickFlow API base URL."
+        "description": "TickFlow API base URL. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_URL or TICKFLOW_API_URL."
       },
       "tickflowApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "TickFlow API key used for market and financial data. Required before using the plugin."
+        "description": "TickFlow API key used for market and financial data. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_KEY or TICKFLOW_API_KEY."
       },
       "tickflowApiKeyLevel": {
         "type": "string",
         "enum": ["Free", "Start", "Pro", "Expert"],
         "default": "Free",
-        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching."
+        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching. Can also come from TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL or TICKFLOW_API_KEY_LEVEL."
       },
       "mxSearchApiUrl": {
         "type": "string",
         "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-        "description": "MX Search API base URL."
+        "description": "MX Search API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
       },
       "mxSearchApiKey": {
         "type": "string",
         "default": "",
-        "description": "Optional. Enables mx_search, mx_select_stock, and non-Expert financial fallback."
+        "description": "Configure this during setup if you want mx_search, mx_select_stock, and non-Expert financial fallback. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_KEY, MX_SEARCH_API_KEY, or MX_APIKEY."
       },
       "jin10McpUrl": {
         "type": "string",
         "default": "https://mcp.jin10.com/mcp",
-        "description": "Jin10 MCP server URL used for realtime flash monitoring."
+        "description": "Jin10 MCP server URL used for realtime flash monitoring. Leave empty to use TICKFLOW_ASSIST_JIN10_MCP_URL or JIN10_MCP_URL."
       },
       "jin10ApiToken": {
         "type": "string",
         "default": "",
-        "description": "Optional. Enables 24/7 Jin10 realtime flash monitoring when configured."
+        "description": "Configure this during setup to keep the managed Jin10 realtime flash monitor fully available. Leave empty to use TICKFLOW_ASSIST_JIN10_API_TOKEN or JIN10_API_TOKEN."
       },
       "jin10FlashPollInterval": {
         "type": "integer",
@@ -66,17 +94,17 @@
       "llmBaseUrl": {
         "type": "string",
         "default": "https://api.openai.com/v1",
-        "description": "OpenAI-compatible LLM API base URL."
+        "description": "OpenAI-compatible LLM API base URL. Leave empty to use TICKFLOW_ASSIST_LLM_BASE_URL or LLM_BASE_URL."
       },
       "llmApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "API key for the analysis model endpoint configured in llmBaseUrl. Required before using analysis features."
+        "description": "API key for the analysis model endpoint configured in llmBaseUrl. Leave empty to use TICKFLOW_ASSIST_LLM_API_KEY or LLM_API_KEY."
       },
       "llmModel": {
         "type": "string",
         "default": "gpt-4o",
-        "description": "Model name used for analysis."
+        "description": "Model name used for analysis. Leave empty to use TICKFLOW_ASSIST_LLM_MODEL or LLM_MODEL."
       },
       "databasePath": {
         "type": "string",
@@ -101,7 +129,7 @@
       },
       "alertChannel": {
         "type": "string",
-        "description": "Alert delivery channel, e.g. telegram, qqbot, wecom",
+        "description": "Configure this during setup for alert delivery, e.g. telegram, qqbot, wecom.",
         "default": "telegram"
       },
       "openclawCliBin": {
@@ -114,7 +142,7 @@
       },
       "alertTarget": {
         "type": "string",
-        "description": "Optional. Channel target for test_alert, monitoring alerts, and scheduled notifications.",
+        "description": "Configure this during setup for test_alert, monitoring alerts, and scheduled notifications.",
         "default": ""
       },
       "pythonBin": {
@@ -140,26 +168,26 @@
   "uiHints": {
     "tickflowApiKey": {
       "label": "TickFlow API Key",
-      "help": "Required before using TickFlow market and financial data.",
+      "help": "Used for TickFlow market and financial data. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_KEY or TICKFLOW_API_KEY.",
       "sensitive": true
     },
     "tickflowApiKeyLevel": {
       "label": "TickFlow API Key Level",
-      "help": "Set this to your actual TickFlow subscription level."
+      "help": "Set this to your actual TickFlow subscription level, or provide it via TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL / TICKFLOW_API_KEY_LEVEL."
     },
     "mxSearchApiKey": {
       "label": "MX Search API Key",
-      "help": "Optional. Enables mx_search, mx_select_stock, and lite financial fallback.",
+      "help": "Configure this during setup if you want mx_search, mx_select_stock, and lite financial fallback, or use TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY.",
       "sensitive": true
     },
     "jin10McpUrl": {
       "label": "Jin10 MCP URL",
-      "help": "Optional. MCP endpoint used by the 24/7 Jin10 flash monitor.",
+      "help": "Configure this together with the Jin10 token for the managed flash monitor, or use TICKFLOW_ASSIST_JIN10_MCP_URL / JIN10_MCP_URL.",
       "advanced": true
     },
     "jin10ApiToken": {
       "label": "Jin10 API Token",
-      "help": "Optional. Enables Jin10 realtime flash monitoring.",
+      "help": "Configure this during setup to keep the managed Jin10 flash monitor fully available, or use TICKFLOW_ASSIST_JIN10_API_TOKEN / JIN10_API_TOKEN.",
       "sensitive": true
     },
     "jin10FlashPollInterval": {
@@ -179,24 +207,24 @@
     },
     "llmBaseUrl": {
       "label": "LLM Base URL",
-      "help": "OpenAI-compatible analysis endpoint."
+      "help": "OpenAI-compatible analysis endpoint. Leave empty to use TICKFLOW_ASSIST_LLM_BASE_URL or LLM_BASE_URL."
     },
     "llmApiKey": {
       "label": "LLM API Key",
-      "help": "Required before using analysis model requests.",
+      "help": "Used for analysis model requests. Leave empty to use TICKFLOW_ASSIST_LLM_API_KEY or LLM_API_KEY.",
       "sensitive": true
     },
     "llmModel": {
       "label": "LLM Model",
-      "help": "Model name used for stock analysis."
+      "help": "Model name used for stock analysis. Leave empty to use TICKFLOW_ASSIST_LLM_MODEL or LLM_MODEL."
     },
     "alertChannel": {
       "label": "Alert Channel",
-      "help": "Default delivery channel for alert messages."
+      "help": "Configure this during setup before enabling alert delivery."
     },
     "alertTarget": {
       "label": "Alert Target",
-      "help": "Optional. Configure this if you want test_alert, monitoring alerts, or scheduled notifications."
+      "help": "Configure this during setup for test_alert, monitoring alerts, and scheduled notifications."
     },
     "databasePath": {
       "label": "Database Path",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "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",
@@ -46,12 +46,12 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.5"
+      "openclawVersion": "2026.4.11"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.5"
+      "builtWithOpenClawVersion": "2026.4.11"
     },
     "extensions": [
       "dist/plugin.js"
@@ -69,9 +69,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.5",
+    "openclaw": "^2026.4.11",
     "typescript": "^5.8.2"
   },
-  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.3.4` 新增 `09:20` 盘前资讯简报，修复 Jin10 历史补页重复推送与状态页最新快讯显示错误，并降低 Telegram 图文告警被误判失败后重复补发的风险。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.5` 上兼容。\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`、`jin10ApiToken`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 金十数据 24 小时快讯监控与自选关联提醒\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 依赖与可选能力\n\n- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: <https://github.com/robinspt/tickflow-assist>\n",
+  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.3.5` 对齐 OpenClaw `2026.4.11` metadata 与社区安装提示，修复源码升级时本地链接扫描 `node_modules` 失败的问题，并支持通过环境变量回退 TickFlow / LLM / MX / Jin10 配置。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.11` 上兼容。\n\n## 安装前准备\n\n在执行社区安装前，建议先确认你已经准备好以下配置：\n\n- 核心必需：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 可选增强：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`configure-openclaw` 会把上述配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`，插件启用后会在本地 `databasePath` 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。\n如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 `openclaw.json / local.config.json` > 环境变量 > 默认值。\n常用环境变量：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`、`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`、`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`、`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`、`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`、`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`。\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`、`llmBaseUrl`、`llmModel` 等正式配置。\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`、`jin10ApiToken`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n如果你使用环境变量，运行时支持以下回退：\n\n- `tickflowApiUrl`：`TICKFLOW_ASSIST_TICKFLOW_API_URL` / `TICKFLOW_API_URL`\n- `tickflowApiKey`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`\n- `tickflowApiKeyLevel`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL` / `TICKFLOW_API_KEY_LEVEL`\n- `llmBaseUrl`：`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`\n- `llmApiKey`：`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`\n- `llmModel`：`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`\n- `mxSearchApiUrl`：`TICKFLOW_ASSIST_MX_SEARCH_API_URL` / `MX_SEARCH_API_URL`\n- `mxSearchApiKey`：`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`\n- `jin10McpUrl`：`TICKFLOW_ASSIST_JIN10_MCP_URL` / `JIN10_MCP_URL`\n- `jin10ApiToken`：`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 金十数据 24 小时快讯监控与自选关联提醒\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 依赖与可选能力\n\n- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: [robinspt/tickflow-assist](https://github.com/robinspt/tickflow-assist)\n",
   "readmeFilename": "README.md"
 }