tickflow-assist 0.3.6 → 0.3.7

package/dist/tools/test-alert.tool.js

@@ -1,3 +1,4 @@
+import { performance } from "node:perf_hooks";
 import { formatChinaDateTime } from "../utils/china-time.js";
 export function testAlertTool(alertService, alertMediaService, configSource = "openclaw_plugin") {
     return {
@@ -5,38 +6,52 @@ export function testAlertTool(alertService, alertMediaService, configSource = "o
         description: "Send a test alert through the configured OpenClaw alert delivery path. Plugin mode includes PNG; local mode sends text only.",
         optional: true,
         async run() {
+            const totalStart = performance.now();
             const now = formatChinaDateTime();
             const message = alertService.formatSystemNotification("🧪 TickFlow 测试告警", [
                 `时间: ${now}`,
                 "说明: 这是一条手动触发的测试消息，用于验证文本与 PNG 告警卡投递链路正常。",
             ]);
             if (configSource === "local_config") {
+                const sendStart = performance.now();
                 const result = await alertService.sendWithResult({ message });
+                const sendMs = performance.now() - sendStart;
+                const totalMs = performance.now() - totalStart;
                 if (result.ok) {
                     return [
                         "✅ 测试告警文本已发送（本地命令模式）",
+                        formatTimingLine({ sendMs, totalMs }),
                         "说明: `npm run tool -- test_alert` 仅验证文本链路；请通过 `/ta_testalert` 验证 PNG 图片链路。",
                     ].join("\n");
                 }
                 const detail = result.error ?? alertService.getLastError();
-                return detail
-                    ? `❌ 测试告警发送失败\n原因: ${detail}`
-                    : "❌ 测试告警发送失败";
+                return [
+                    "❌ 测试告警发送失败",
+                    detail ? `原因: ${detail}` : null,
+                    formatTimingLine({ sendMs, totalMs }),
+                ].filter(Boolean).join("\n");
             }
             let mediaFile = null;
+            let renderMs;
             try {
+                const renderStart = performance.now();
                 mediaFile = await alertMediaService.writeAlertCard({
                     symbol: "000001.SZ",
                     ruleName: "test_alert",
                     image: buildTestAlertImage(now),
                 });
+                renderMs = performance.now() - renderStart;
             }
             catch (error) {
+                const sendStart = performance.now();
                 const textOnlyResult = await alertService.sendWithResult({ message });
+                const sendMs = performance.now() - sendStart;
+                const totalMs = performance.now() - totalStart;
                 if (textOnlyResult.ok) {
                     return [
                         "⚠️ 测试告警文本已发送，但 PNG 生成失败",
                         `原因: ${formatErrorMessage(error)}`,
+                        formatTimingLine({ sendMs, totalMs }),
                     ].join("\n");
                 }
                 const detail = textOnlyResult.error ?? alertService.getLastError() ?? "未知错误";
@@ -44,38 +59,46 @@ export function testAlertTool(alertService, alertMediaService, configSource = "o
                     "❌ 测试告警发送失败",
                     `PNG 生成失败: ${formatErrorMessage(error)}`,
                     `文本发送失败: ${detail}`,
+                    formatTimingLine({ sendMs, totalMs }),
                 ].join("\n");
             }
             try {
+                const sendStart = performance.now();
                 const result = await alertService.sendWithResult({
                     message,
                     mediaPath: mediaFile.filePath,
                     mediaLocalRoots: mediaFile.mediaLocalRoots,
                     filename: mediaFile.filename,
                 });
+                const sendMs = performance.now() - sendStart;
+                const totalMs = performance.now() - totalStart;
                 if (result.deliveryUncertain) {
-                    return result.error
-                        ? `⚠️ PNG 告警疑似已送达，但通道返回异常；为避免重复未执行拆分补发\n原因: ${result.error}`
-                        : "⚠️ PNG 告警疑似已送达，但通道返回异常；为避免重复未执行拆分补发";
+                    return [
+                        "⚠️ PNG 告警疑似已送达，但通道返回异常；为避免重复未执行拆分补发",
+                        result.error ? `原因: ${result.error}` : null,
+                        formatTimingLine({ renderMs, sendMs, totalMs }),
+                    ].filter(Boolean).join("\n");
                 }
                 if (result.ok && result.mediaDelivered) {
-                    if (result.error) {
-                        return [
-                            "⚠️ PNG 告警卡已发送，但文本补发失败",
-                            `原因: ${result.error}`,
-                        ].join("\n");
-                    }
-                    return "✅ 测试告警发送成功（文本 + PNG）";
+                    return [
+                        result.error ? "⚠️ PNG 告警卡已发送，但文本补发失败" : "✅ 测试告警发送成功（文本 + PNG）",
+                        result.error ? `原因: ${result.error}` : null,
+                        formatTimingLine({ renderMs, sendMs, totalMs }),
+                    ].filter(Boolean).join("\n");
                 }
                 if (result.ok) {
-                    return result.error
-                        ? `⚠️ 测试告警文本已发送，但 PNG 未送达，已回退为纯文本\n原因: ${result.error}`
-                        : "⚠️ 测试告警文本已发送，但 PNG 未送达，已回退为纯文本";
+                    return [
+                        "⚠️ 测试告警文本已发送，但 PNG 未送达，已回退为纯文本",
+                        result.error ? `原因: ${result.error}` : null,
+                        formatTimingLine({ renderMs, sendMs, totalMs }),
+                    ].filter(Boolean).join("\n");
                 }
                 const detail = result.error ?? alertService.getLastError();
-                return detail
-                    ? `❌ 测试告警发送失败\n原因: ${detail}`
-                    : "❌ 测试告警发送失败";
+                return [
+                    "❌ 测试告警发送失败",
+                    detail ? `原因: ${detail}` : null,
+                    formatTimingLine({ renderMs, sendMs, totalMs }),
+                ].filter(Boolean).join("\n");
             }
             finally {
                 if (mediaFile) {
@@ -127,3 +150,17 @@ function formatErrorMessage(error) {
     }
     return String(error);
 }
+function formatTimingLine(params) {
+    const parts = [
+        params.renderMs == null ? null : `PNG 生成 ${formatDuration(params.renderMs)}`,
+        `发送 ${formatDuration(params.sendMs)}`,
+        `总计 ${formatDuration(params.totalMs)}`,
+    ].filter((value) => Boolean(value));
+    return `耗时: ${parts.join(" | ")}`;
+}
+function formatDuration(valueMs) {
+    if (valueMs >= 1000) {
+        return `${(valueMs / 1000).toFixed(2)}s`;
+    }
+    return `${Math.round(valueMs)}ms`;
+}

package/dist/types/tickflow.d.ts

@@ -8,6 +8,7 @@ export interface TickFlowInstrument {
 }
 export interface TickFlowQuote {
     symbol: string;
+    name?: string | null;
     last_price: number;
     prev_close: number;
     timestamp: number;
@@ -17,6 +18,17 @@ export interface TickFlowQuote {
         change_pct?: number;
     };
 }
+export interface TickFlowUniverseSummary {
+    id: string;
+    name: string;
+    description?: string | null;
+    region: string;
+    category: string;
+    symbol_count: number;
+}
+export interface TickFlowUniverseDetail extends TickFlowUniverseSummary {
+    symbols: string[];
+}
 export interface TickFlowCompactKline {
     timestamp: number[];
     open: number[];

package/dist/utils/tickflow-quote.d.ts

@@ -0,0 +1,5 @@
+import type { TickFlowKlineRow, TickFlowQuote } from "../types/tickflow.js";
+export declare function normalizeTickFlowChangePct(value: number | null | undefined): number | null;
+export declare function deriveChangePctFromPrices(close: number | null | undefined, prevClose: number | null | undefined): number | null;
+export declare function resolveTickFlowQuoteChangePct(quote: TickFlowQuote | null | undefined): number | null;
+export declare function resolveTickFlowKlineChangePct(kline: Pick<TickFlowKlineRow, "close" | "prev_close"> | null | undefined): number | null;

package/dist/utils/tickflow-quote.js

@@ -0,0 +1,31 @@
+export function normalizeTickFlowChangePct(value) {
+    if (value == null) {
+        return null;
+    }
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return null;
+    }
+    return numericValue * 100;
+}
+export function deriveChangePctFromPrices(close, prevClose) {
+    const closeValue = Number(close);
+    const prevCloseValue = Number(prevClose);
+    if (!Number.isFinite(closeValue) || !Number.isFinite(prevCloseValue) || prevCloseValue <= 0) {
+        return null;
+    }
+    return ((closeValue - prevCloseValue) / prevCloseValue) * 100;
+}
+export function resolveTickFlowQuoteChangePct(quote) {
+    if (!quote) {
+        return null;
+    }
+    return normalizeTickFlowChangePct(quote.ext?.change_pct)
+        ?? deriveChangePctFromPrices(quote.last_price, quote.prev_close);
+}
+export function resolveTickFlowKlineChangePct(kline) {
+    if (!kline) {
+        return null;
+    }
+    return deriveChangePctFromPrices(kline.close, kline.prev_close);
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -9,6 +9,83 @@
   "activation": {
     "onCapabilities": ["tool", "hook"]
   },
+  "providerAuthEnvVars": {
+    "tickflow": [
+      "TICKFLOW_ASSIST_TICKFLOW_API_KEY",
+      "TICKFLOW_API_KEY"
+    ],
+    "llm": [
+      "TICKFLOW_ASSIST_LLM_API_KEY",
+      "LLM_API_KEY"
+    ],
+    "mx-search": [
+      "TICKFLOW_ASSIST_MX_SEARCH_API_KEY",
+      "MX_SEARCH_API_KEY",
+      "MX_APIKEY"
+    ],
+    "jin10": [
+      "TICKFLOW_ASSIST_JIN10_API_TOKEN",
+      "JIN10_API_TOKEN"
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "tickflow",
+      "method": "api-key",
+      "choiceId": "tickflow-api-key",
+      "choiceLabel": "TickFlow API key",
+      "groupId": "tickflow-assist",
+      "groupLabel": "TickFlow Assist",
+      "groupHint": "TickFlow, analysis LLM, and optional data-service credentials.",
+      "optionKey": "tickflowApiKey",
+      "cliFlag": "--tickflow-api-key",
+      "cliOption": "--tickflow-api-key <key>",
+      "cliDescription": "TickFlow API key",
+      "assistantVisibility": "manual-only"
+    },
+    {
+      "provider": "llm",
+      "method": "api-key",
+      "choiceId": "llm-api-key",
+      "choiceLabel": "LLM API key",
+      "groupId": "tickflow-assist",
+      "groupLabel": "TickFlow Assist",
+      "groupHint": "TickFlow, analysis LLM, and optional data-service credentials.",
+      "optionKey": "llmApiKey",
+      "cliFlag": "--llm-api-key",
+      "cliOption": "--llm-api-key <key>",
+      "cliDescription": "Analysis LLM API key",
+      "assistantVisibility": "manual-only"
+    },
+    {
+      "provider": "mx-search",
+      "method": "api-key",
+      "choiceId": "mx-search-api-key",
+      "choiceLabel": "MX Search API key",
+      "groupId": "tickflow-assist",
+      "groupLabel": "TickFlow Assist",
+      "groupHint": "TickFlow, analysis LLM, and optional data-service credentials.",
+      "optionKey": "mxSearchApiKey",
+      "cliFlag": "--mx-search-api-key",
+      "cliOption": "--mx-search-api-key <key>",
+      "cliDescription": "MX Search API key",
+      "assistantVisibility": "manual-only"
+    },
+    {
+      "provider": "jin10",
+      "method": "api-key",
+      "choiceId": "jin10-api-token",
+      "choiceLabel": "Jin10 API token",
+      "groupId": "tickflow-assist",
+      "groupLabel": "TickFlow Assist",
+      "groupHint": "TickFlow, analysis LLM, and optional data-service credentials.",
+      "optionKey": "jin10ApiToken",
+      "cliFlag": "--jin10-api-token",
+      "cliOption": "--jin10-api-token <token>",
+      "cliDescription": "Jin10 API token",
+      "assistantVisibility": "manual-only"
+    }
+  ],
   "setup": {
     "providers": [
       {
@@ -79,7 +156,7 @@
       },
       "tickflowApiKeyLevel": {
         "type": "string",
-        "enum": ["Free", "Start", "Pro", "Expert"],
+        "enum": ["Free", "Starter", "Pro", "Expert"],
         "default": "Free",
         "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."
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "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.11"
+      "openclawVersion": "2026.4.14"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.11"
+      "builtWithOpenClawVersion": "2026.4.14"
     },
     "install": {
       "npmSpec": "tickflow-assist",
@@ -74,9 +74,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.11",
+    "openclaw": "^2026.4.14",
     "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.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如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnode ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js 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\nnode ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js 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",
+  "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.7` 接入 TickFlow 标的池行业映射与申万三级同业上下文，优化盘前简报提炼与收盘复盘市场信息展示，并对齐 OpenClaw `v2026.4.14` 兼容与社区元数据。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.14` 上兼容。\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如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnode ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n- `configure-openclaw` 会把配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`。\n- 核心必填建议先准备：`tickflowApiKey`、`tickflowApiKeyLevel`、`llmApiKey`、`llmBaseUrl`、`llmModel`；告警场景再补 `alertChannel`、`alertTarget`、`alertAccount`。\n- 如果你不想把密钥落盘，优先把环境变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项；如需 PNG 告警卡正常显示中文，请自行安装 `fontconfig` 与 Noto CJK 字体。\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)：`Free` 可用日线与实时行情；`Starter` 起可用标的池，插件会用来做申万行业映射与申万 3 级同业表现；`Pro` 起可用分钟K；`Expert` 才走 TickFlow 财务数据，非 `Expert` 默认回退妙想 lite。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。独立的金十数据 Skill 详见 [OpenClaw Skill](https://clawhub.ai/robinspt/jin10) / [Hermes Skill](https://github.com/robinspt/hermes-skills)。\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"
 }

package/skills/stock-analysis/SKILL.md

@@ -1,12 +1,7 @@
 ---
 name: stock_analysis
 description: Analyze A-share watchlist symbols, update daily K-line data, run monitor, and report status through the TickFlow Assist plugin.
-metadata:
-  openclaw:
-    skillKey: stock_analysis
-    requires:
-      config:
-        - plugins.entries.tickflow-assist.enabled
+metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"TICKFLOW_ASSIST_TICKFLOW_API_KEY","requires":{"config":["plugins.entries.tickflow-assist.enabled"],"env":["TICKFLOW_ASSIST_TICKFLOW_API_KEY","TICKFLOW_ASSIST_LLM_API_KEY","TICKFLOW_ASSIST_LLM_BASE_URL","TICKFLOW_ASSIST_LLM_MODEL"]}}}
 ---
 # 股票分析与监控
 
@@ -15,7 +10,7 @@ metadata:
 
 此技能随插件加载，不需要手动复制到 workspace。
 
-优先使用 TickFlow Assist 插件工具，不要改用 `exec`、shell 命令、`node -e`、`python -c`、直接文件读写或数据库脚本，也不要在没有工具结果的前提下自行推断分析结论、监控状态或数据更新结果。
+优先通过 TickFlow Assist 插件工具完成相关任务，并以工具返回结果为准。
 
 适用场景：
 - 添加或删除自选股
@@ -57,15 +52,15 @@ metadata:
 - “测试告警” -> `test_alert`
 
 参数理解规则：
-- 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类一跳即可完成的意图，首个动作必须直接调用对应插件工具；禁止先调用 `read`、`write`、`edit`、`query_database`、子代理、会话生成、环境探测工具，禁止先说“我先找一下方法”“我先确认工具”之类的话。
-- 当用户消息中已经包含足够参数时，必须直接执行，不得额外探索：
+- 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类直接型意图，如果用户已经给出足够参数，应直接调用对应插件工具。
+- 当用户消息中已经包含足够参数时，不要额外补充假设：
   - “添加自选 601872” -> 直接调用 `add_stock`
   - “添加自选 601872 成本 5.32” -> 直接调用 `add_stock`
   - “删除自选 601872” -> 直接调用 `remove_stock`
   - “自选列表” -> 直接调用 `list_watchlist`
   - “查立讯精密最新研报” -> 直接调用 `mx_search`
   - “找今天涨幅 2% 的股票” -> 直接调用 `mx_select_stock`
-- 如果工具必需参数缺失，只能补充缺失项本身；不要以“我需要摸索当前环境里的工具”“我需要确认执行方式”为由拒绝或拖延。
+- 如果工具必需参数缺失，只补充缺失项本身。
 - 股票代码按用户原始输入提取，例如 `002261`。
 - 成本价对应 `costPrice`；若用户未提供成本价，可以省略该字段。
 - `add_stock` 默认会在添加成功后自动拉取日K并计算指标。
@@ -74,18 +69,13 @@ metadata:
 - `update_all` 除了更新日K和日线指标，也会同步更新当日分钟K；本地分钟K默认仅保留近 30 个交易日。
 - `update_all` 是立即执行一次日更；`start_daily_update` / `stop_daily_update` 控制的是后台定时日更进程，两者不要混淆。
 - `backtest_key_levels` 默认回测全部关注股的活动价位；如果用户提到股票代码，应传入 `symbol`；如果用户提到“最近 N 次”，应传入 `recentLimit=N`。
-- 若配置中的 `tickflowApiKeyLevel` 为 `Free` 或 `Start`，则应自动跳过分钟K获取；若分钟K接口失败，也不要让 `analyze` 或 `update_all` 因此整体失败。
+- 若配置中的 `tickflowApiKeyLevel` 为 `Free` 或 `Starter`，则应自动跳过分钟K获取；若分钟K接口失败，也不要让 `analyze` 或 `update_all` 因此整体失败。
 - 对新闻、公告、研报、政策、交易规则、具体事件、时效性影响分析等外部检索类问题，优先使用 `mx_search`，不要直接凭常识回答，也不要先读仓库文件再决定是否搜索。
 - 对自然语言选股、板块成分股、条件筛选、候选池推荐等任务，优先使用 `mx_select_stock`；若问题本质是“找哪些标的符合条件”，不要误用 `mx_search`。
 - 用户在“添加自选”意图中提到的“`N`天”对应 `add_stock.count`（或 `klineCount`），例如“添加 002261 成本 34.15 并获取 120 天日K”应调用 `add_stock`，其中 `count=120`。若用户未提供成本价但明确要求拉取 `N` 天日K，可只传 `symbol` 与 `count`。
 - 用户询问 TickFlow / 自选股 的日更状态时，必须调用 `daily_update_status`，不要把它解释成其他 crontab、系统任务或无关插件的定时更新。
-- 对 `daily_update_status`、`monitor_status`、`list_watchlist` 这类轻量状态查询，禁止使用 `sessions_spawn`、子代理、并行子任务、`query_database`、文件读取或任何“先分析再回答”的编排；必须在当前回合直接调用对应插件工具并返回结果。
-- 对 `add_stock`、`remove_stock` 同样适用上述限制：不得先读文件、读目录、读 skill、自查工具列表或推测执行方法，必须直接调用工具。
-- `daily_update_status` 不依赖数据库查询工具；如果模型想改用 `query_database`、读取状态文件、读取交易日历文件，或拆成多个子任务，应视为错误策略并立即改回直接调用 `daily_update_status`。
-- 如果模型想调用 `read` 查看仓库、配置、数据库目录、SKILL 内容或工具脚本来决定是否添加/删除自选，应视为错误策略并立即改回 `add_stock` / `remove_stock`。
-- 禁止使用 `exec`、shell、`node -e`、`python -c`、SQL/LanceDB 脚本、直接编辑数据文件或任何“自己写脚本完成工具能力”的替代路径。
-- 如果当前环境拿不到对应插件工具，应直接说明无法通过该技能执行，不要回退到 `exec` 或命令行绕过。
-- 当用户追问“这个任务怎么执行的”“刚才是怎么做的”时，如果任务是通过插件工具完成的，应只说明实际调用的工具名与关键参数；不要默认展开成 `npm run tool -- ...`、shell 命令、`cd ~/projects/...`，也不要把本地调试命令当成对话里的真实执行链路。只有用户明确要求“给我命令行等价命令”时，才允许给出 CLI 示例。
+- 如果当前会话没有暴露对应插件工具，应直接说明当前技能暂不可用。
+- 当用户追问“这个任务怎么执行的”“刚才是怎么做的”时，如果任务是通过插件工具完成的，应只说明实际调用的工具名与关键参数；只有用户明确要求命令行等价命令时，再给出 CLI 示例。
 - 对 `daily_update_status` 的返回结果，不要额外追加“当前是 local_config”“插件配置问题”“已重试但结果相同”这类解释性警告。先完整原样输出工具结果；只有用户继续追问原因时，才再解释调用链路差异。
 - 仅在工具必需参数缺失时，才简短指出缺少的字段。
 - 不要臆造股票代码、成本价、日期、阈值、分析结果或监控状态。