tickflow-assist 0.3.4 → 0.3.6

package/README.md

@@ -2,9 +2,22 @@
 
 基于 [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`。
+如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项。
 
 ## 安装
 
@@ -12,21 +25,21 @@
 
 ```bash
 openclaw plugins install tickflow-assist
-npx -y tickflow-assist configure-openclaw
+node ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw
 cd ~/.openclaw/extensions/tickflow-assist/python && uv sync
 openclaw plugins enable tickflow-assist
 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`，避免后续升级继续锁在旧版本。
 
 如果你希望先审阅配置，再只打印最少的后续步骤，可使用：
 
 ```bash
-npx -y tickflow-assist configure-openclaw --no-enable --no-restart
+node ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw --no-enable --no-restart
 ```
 
 如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体，例如：
@@ -84,6 +97,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 +132,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/bootstrap.js

@@ -75,6 +75,7 @@ import { resolvePreferredOpenClawTmpDir } from "./runtime/openclaw-temp-dir.js";
 import { RealtimeMonitorWorker } from "./background/realtime-monitor.worker.js";
 import { DailyUpdateWorker } from "./background/daily-update.worker.js";
 import { Jin10FlashWorker } from "./background/jin10-flash.worker.js";
+import { createAlertDiagnosticLogger } from "./utils/alert-diagnostic-log.js";
 export function createAppContext(config, options = {}) {
     const runtime = {
         configSource: options.configSource ?? "local_config",
@@ -109,6 +110,7 @@ export function createAppContext(config, options = {}) {
     const analysisService = new AnalysisService(config.llmBaseUrl, config.llmApiKey, config.llmModel, analysisLogRepository);
     const watchlistProfileService = new WatchlistProfileService(mxApiService, analysisService);
     const tradingCalendarService = new TradingCalendarService(config.calendarFile);
+    const alertDiagnosticLogger = createAlertDiagnosticLogger(config.databasePath);
     const alertService = new AlertService({
         openclawCliBin: config.openclawCliBin,
         channel: config.alertChannel,
@@ -120,6 +122,7 @@ export function createAppContext(config, options = {}) {
                 runtime: runtime.pluginRuntime,
             }
             : undefined,
+        diagnosticLogger: alertDiagnosticLogger,
     });
     const alertMediaService = new AlertMediaService(config.databasePath, undefined, undefined, resolveAlertMediaTempRootDir());
     const indicatorService = new IndicatorService(config.pythonBin, config.pythonArgs, config.pythonWorkdir, runCommandWithTimeout);
@@ -137,7 +140,7 @@ export function createAppContext(config, options = {}) {
     const postCloseReviewTask = new PostCloseReviewTask();
     const compositeStockAnalysisTask = new CompositeStockAnalysisTask(keyLevelsRepository, analysisLogRepository);
     const compositeAnalysisOrchestrator = new CompositeAnalysisOrchestrator(analysisService, marketAnalysisProvider, financialAnalysisProvider, newsAnalysisProvider, klineTechnicalSignalTask, financialFundamentalTask, financialFundamentalLiteTask, newsCatalystTask, compositeStockAnalysisTask, technicalAnalysisRepository, financialAnalysisRepository, newsAnalysisRepository, compositeAnalysisRepository);
-    const monitorService = new MonitorService(config.databasePath, config.requestInterval, config.alertChannel, watchlistService, quoteService, tradingCalendarService, keyLevelsRepository, alertLogRepository, klinesRepository, intradayKlinesRepository, klineService, alertService, alertMediaService);
+    const monitorService = new MonitorService(config.databasePath, config.requestInterval, config.alertChannel, watchlistService, quoteService, tradingCalendarService, keyLevelsRepository, alertLogRepository, klinesRepository, intradayKlinesRepository, klineService, alertService, alertMediaService, alertDiagnosticLogger);
     const jin10FlashMonitorService = new Jin10FlashMonitorService(config.databasePath, config.jin10FlashPollInterval, config.jin10FlashRetentionDays, config.jin10FlashNightAlert, watchlistService, jin10McpService, analysisService, alertService, jin10FlashRepository, jin10FlashDeliveryRepository);
     const updateService = new UpdateService(klineService, config.tickflowApiKeyLevel, indicatorService, klinesRepository, indicatorsRepository, intradayKlinesRepository, watchlistService, tradingCalendarService);
     const postCloseReviewService = new PostCloseReviewService(watchlistService, compositeAnalysisOrchestrator, analysisService, postCloseReviewTask, keyLevelsRepository, keyLevelsHistoryRepository, klinesRepository, intradayKlinesRepository, jin10FlashDeliveryRepository, jin10FlashRepository);

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/alert-service.d.ts

@@ -1,5 +1,6 @@
 import type { OpenClawPluginConfig, OpenClawPluginRuntime } from "../runtime/plugin-api.js";
 import type { KeyLevels } from "../types/domain.js";
+import { AlertDiagnosticLogger } from "../utils/alert-diagnostic-log.js";
 interface AlertRuntimeContext {
     config: OpenClawPluginConfig;
     runtime: OpenClawPluginRuntime;
@@ -10,6 +11,7 @@ interface AlertServiceOptions {
     account: string;
     target: string;
     runtime?: AlertRuntimeContext;
+    diagnosticLogger?: AlertDiagnosticLogger;
 }
 export interface AlertSendInput {
     message: string;
@@ -22,6 +24,7 @@ export interface AlertSendResult {
     mediaAttempted: boolean;
     mediaDelivered: boolean;
     error: string | null;
+    deliveryUncertain?: boolean;
 }
 export declare class AlertService {
     private readonly options;
@@ -62,6 +65,11 @@ export declare class AlertService {
     private trySendViaRuntime;
     private invokeRuntimeChannelSend;
     private trySendViaCommand;
+    private prepareCommandPayload;
+    private getCommandRunOptions;
     private buildCliArgs;
+    private logCompletion;
+    private logTransportFailure;
+    private logDiagnostic;
 }
 export {};