tickflow-assist 0.2.19 → 0.3.2

package/dist/tools/flash-monitor-status.tool.js

@@ -0,0 +1,9 @@
+export function flashMonitorStatusTool(flashMonitorService) {
+    return {
+        name: "flash_monitor_status",
+        description: "Show Jin10 flash monitor state, recent poll summary, and storage counters.",
+        async run() {
+            return flashMonitorService.getStatusReport();
+        },
+    };
+}

package/dist/types/flash-monitor.d.ts

@@ -0,0 +1,17 @@
+export interface FlashMonitorState {
+    initialized: boolean;
+    lastSeenKey: string | null;
+    lastSeenPublishedAt: string | null;
+    lastSeenUrl: string | null;
+    backfillCursor: string | null;
+    runtimeHost: "plugin_service" | "fallback_process" | null;
+    runtimeObservedAt: string | null;
+    lastHeartbeatAt: string | null;
+    lastPollAt: string | null;
+    lastPollStored: number;
+    lastPollCandidates: number;
+    lastPollAlerts: number;
+    lastPrunedAt: string | null;
+    lastLoopError: string | null;
+    lastLoopErrorAt: string | null;
+}

package/dist/types/flash-monitor.js

@@ -0,0 +1 @@
+export {};

package/dist/types/jin10.d.ts

@@ -0,0 +1,30 @@
+export interface Jin10FlashItem {
+    content: string;
+    time: string;
+    url: string;
+    raw: Record<string, unknown>;
+}
+export interface Jin10FlashPage {
+    hasMore: boolean;
+    items: Jin10FlashItem[];
+    nextCursor: string | null;
+}
+export interface Jin10FlashRecord {
+    flash_key: string;
+    published_at: string;
+    published_ts: number;
+    content: string;
+    url: string;
+    ingested_at: string;
+    raw: Record<string, unknown>;
+}
+export interface Jin10FlashDeliveryEntry {
+    flash_key: string;
+    published_at: string;
+    symbols: string[];
+    headline: string;
+    reason: string;
+    importance: "high" | "medium" | "low";
+    message: string;
+    delivered_at: string;
+}

package/dist/types/jin10.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/china-time.d.ts

@@ -1,3 +1,4 @@
 export declare function chinaNow(): Date;
 export declare function formatChinaDateTime(date?: Date): string;
 export declare function chinaToday(date?: Date): string;
+export declare function chinaHour(date?: Date): number;

package/dist/utils/china-time.js

@@ -16,3 +16,8 @@ export function formatChinaDateTime(date = chinaNow()) {
 export function chinaToday(date = chinaNow()) {
     return formatChinaDateTime(date).slice(0, 10);
 }
+export function chinaHour(date = chinaNow()) {
+    const utcMs = date.getTime() + date.getTimezoneOffset() * 60_000;
+    const chinaDate = new Date(utcMs + CHINA_OFFSET_HOURS * 60 * 60 * 1000);
+    return chinaDate.getUTCHours();
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.19",
+  "version": "0.3.2",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -36,6 +36,33 @@
         "default": "",
         "description": "Optional. Enables mx_search, mx_select_stock, and non-Expert financial fallback."
       },
+      "jin10McpUrl": {
+        "type": "string",
+        "default": "https://mcp.jin10.com/mcp",
+        "description": "Jin10 MCP server URL used for realtime flash monitoring."
+      },
+      "jin10ApiToken": {
+        "type": "string",
+        "default": "",
+        "description": "Optional. Enables 24/7 Jin10 realtime flash monitoring when configured."
+      },
+      "jin10FlashPollInterval": {
+        "type": "integer",
+        "minimum": 10,
+        "default": 300,
+        "description": "Jin10 flash polling interval in seconds."
+      },
+      "jin10FlashRetentionDays": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 7,
+        "description": "How many days of raw Jin10 flash data to retain locally."
+      },
+      "jin10FlashNightAlert": {
+        "type": "boolean",
+        "default": false,
+        "description": "When true, flash alerts fire 24/7. When false, suppress alerts between 22:00 and 06:00 Beijing time."
+      },
       "llmBaseUrl": {
         "type": "string",
         "default": "https://api.openai.com/v1",
@@ -125,6 +152,31 @@
       "help": "Optional. Enables mx_search, mx_select_stock, and lite financial fallback.",
       "sensitive": true
     },
+    "jin10McpUrl": {
+      "label": "Jin10 MCP URL",
+      "help": "Optional. MCP endpoint used by the 24/7 Jin10 flash monitor.",
+      "advanced": true
+    },
+    "jin10ApiToken": {
+      "label": "Jin10 API Token",
+      "help": "Optional. Enables Jin10 realtime flash monitoring.",
+      "sensitive": true
+    },
+    "jin10FlashPollInterval": {
+      "label": "Jin10 Poll Interval",
+      "help": "Polling interval in seconds for Jin10 flash monitoring.",
+      "advanced": true
+    },
+    "jin10FlashRetentionDays": {
+      "label": "Jin10 Retention Days",
+      "help": "How many days of Jin10 raw flash data to keep locally.",
+      "advanced": true
+    },
+    "jin10FlashNightAlert": {
+      "label": "Jin10 Night Alert",
+      "help": "Set to false to suppress flash alerts between 22:00-06:00 Beijing time.",
+      "advanced": true
+    },
     "llmBaseUrl": {
       "label": "LLM Base URL",
       "help": "OpenAI-compatible analysis endpoint."

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.19",
+  "version": "0.3.2",
   "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",
   "main": "dist/plugin.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robinspt/tickflow-assist.git"
+  },
+  "homepage": "https://github.com/robinspt/tickflow-assist",
+  "bugs": {
+    "url": "https://github.com/robinspt/tickflow-assist/issues"
+  },
   "bin": {
     "tickflow-assist": "dist/dev/tickflow-assist-cli.js"
   },
@@ -29,7 +37,7 @@
     "dev": "tsc -p tsconfig.json --watch",
     "prepack": "npm run build && node ./scripts/prepare-package-assets.mjs",
     "postpack": "node ./scripts/restore-package-assets.mjs",
-    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js",
+    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/services/jin10-mcp-service.test.js",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
     "monitor-loop": "node dist/dev/run-monitor-loop.js",
@@ -38,12 +46,12 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.1"
+      "openclawVersion": "2026.4.5"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.1"
+      "builtWithOpenClawVersion": "2026.4.5"
     },
     "extensions": [
       "dist/plugin.js"
@@ -61,9 +69,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.1",
+    "openclaw": "^2026.4.5",
     "typescript": "^5.8.2"
   },
-  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.2.19` 调整社区版 OpenClaw 兼容声明，改为按范围声明 `pluginApi` 最低兼容版本并对齐 `builtWithOpenClawVersion` 到 `2026.4.1`，修复 `openclaw plugins update tickflow-assist` 在 `v2026.4.1` 上被精确版本校验拦截的问题。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.1` 上兼容。\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`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更与实时监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\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.2` 为金十快讯新增夜间静默配置并将默认值改为“开启静默”，同时把个股关联快讯与市场概览快讯接入收盘复盘上下文。完整发布记录见 <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",
   "readmeFilename": "README.md"
 }