tickflow-assist 0.3.6 → 0.3.8

package/dist/types/mx-self-select.js

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

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.8",
   "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 Skills 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 Skills 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,19 +156,19 @@
       },
       "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."
       },
       "mxSearchApiUrl": {
         "type": "string",
         "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-        "description": "MX Search API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
+        "description": "MX Skills API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
       },
       "mxSearchApiKey": {
         "type": "string",
         "default": "",
-        "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."
+        "description": "Configure this during setup if you want mx_search, mx_data, mx_select_stock, Eastmoney self-select sync, 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",
@@ -205,8 +282,8 @@
       "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": "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.",
+      "label": "MX Skills API Key",
+      "help": "Configure this during setup if you want mx_search, mx_data, mx_select_stock, Eastmoney self-select sync, and lite financial fallback, or use TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY.",
       "sensitive": true
     },
     "jin10McpUrl": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "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",
@@ -37,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 dist/services/jin10-mcp-service.test.js dist/services/jin10-flash-monitor-service.test.js dist/services/pre-market-brief-service.test.js dist/services/monitor-service.test.js",
+    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/tools/eastmoney-watchlist.tool.test.js dist/tools/screen-stock-candidates.tool.test.js dist/services/mx-search-service.test.js dist/services/jin10-mcp-service.test.js dist/services/jin10-flash-monitor-service.test.js dist/services/pre-market-brief-service.test.js dist/services/monitor-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",
@@ -46,12 +46,12 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.11"
+      "openclawVersion": "2026.4.22"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.11"
+      "builtWithOpenClawVersion": "2026.4.22"
     },
     "install": {
       "npmSpec": "tickflow-assist",
@@ -74,9 +74,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.11",
+    "openclaw": "^2026.4.22",
     "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.8` 接入东方财富自选同步、妙想官方数据/智能选股兼容与小规模候选池联动，新增 `/ta_screenstocks` / `/ta_screenstocks_llm`，并优化盘前简报提炼和监控阶段提醒去重。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.22` 上兼容。\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_data`、`mx_select_stock`、东方财富自选同步以及非 `Expert` 财务链路的 lite 补充；东方财富自选管理接口每日额度 200 次；`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- 妙想资讯搜索、官方金融数据查询、智能选股，以及限量候选池 + TickFlow 补数据联动\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_data`、`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,30 +1,31 @@
 ---
 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"]}}}
 ---
 # 股票分析与监控
 
-这是 TickFlow Assist 插件内置的技能，用于通过插件工具完成 A 股自选股管理、日线更新、分钟K抓取、技术分析、关键价位回测、实时监控、定时日更、结果查看与告警测试。
+这是 TickFlow Assist 插件内置的技能，用于通过插件工具完成 A 股自选股管理、东方财富自选同步、日线更新、分钟K抓取、技术分析、关键价位回测、实时监控、定时日更、结果查看与告警测试。
 运行前需要提供 TickFlow / LLM 等凭证；这些值既可以来自 `plugins.entries["tickflow-assist"].config`，也可以来自文档约定的环境变量 fallback，不要求必须明文写在插件配置里。
 
 此技能随插件加载，不需要手动复制到 workspace。
 
-优先使用 TickFlow Assist 插件工具，不要改用 `exec`、shell 命令、`node -e`、`python -c`、直接文件读写或数据库脚本，也不要在没有工具结果的前提下自行推断分析结论、监控状态或数据更新结果。
+优先通过 TickFlow Assist 插件工具完成相关任务，并以工具返回结果为准。
 
 适用场景：
 - 添加或删除自选股
 - 查看自选列表
+- 查看东方财富自选股列表
+- 从东方财富同步自选股到本地关注列表
+- 将本地关注列表推送到东方财富自选
+- 从东方财富自选中删除股票
 - 刷新自选股名称
 - 拉取单只股票的 K 线数据
 - 拉取单只股票的分钟 K 线数据
 - 搜索个股 / 板块 / 宏观相关资讯、公告、研报、政策、事件解读
+- 查询官方行情、财务、资金流、股东、高管、主营业务、板块 / 指数数据
 - 按自然语言条件做智能选股
+- 基于智能选股生成小规模候选池，并补充 TickFlow 行情 / 日K等数据
 - 执行全部日更
 - 分析单只股票
 - 回测活动价位 / 回测股票
@@ -37,11 +38,18 @@ metadata:
 - “添加自选”、“加入观察”、“加股票” -> `add_stock`
 - “删除自选”、“移除股票”、“删掉这只股票” -> `remove_stock`
 - “查看自选”、“自选列表” -> `list_watchlist`
+- “查看东方财富自选”、“妙想自选列表”、“东财自选列表” -> `list_eastmoney_watchlist`
+- “从东方财富同步自选”、“导入东财自选”、“同步妙想自选到本地” -> `sync_eastmoney_watchlist`
+- “把本地自选添加到东方财富”、“推送本地自选到东财”、“同步本插件自选到东方财富” -> `push_eastmoney_watchlist`
+- “删除东方财富自选”、“从东财自选删除”、“移除妙想自选” -> `remove_eastmoney_watchlist`
 - “刷新股票名称”、“刷新名称” -> `refresh_watchlist_names`
 - “拉 K 线”、“更新 K 线”、“获取日线” -> `fetch_klines`
 - “获取分钟K”、“拉取分钟线”、“抓分时K” -> `fetch_intraday_klines`
 - “搜资讯”、“查公告”、“看研报”、“政策解读”、“事件解读” -> `mx_search`
+- “查行情”、“查财务指标”、“查主力资金”、“查股东”、“查高管”、“查公司信息”、“查板块指数数据” -> `mx_data`
 - “选股”、“筛股票”、“找满足条件的股票”、“推荐板块成分股” -> `mx_select_stock`
+- “选股并补数据”、“筛一批候选股看看”、“生成候选池”、“智能选股联动”、“找几只候选股分析” -> `screen_stock_candidates`
+- “选股并用LLM整理”、“筛候选股并总结”、“智能选股LLM” -> `screen_stock_candidates`，参数带 `summarize=true`
 - “全部更新”、“执行日更”、“更新全部股票” -> `update_all`
 - “启动定时日更”、“开始定时日更”、“开启 TickFlow 日更计划” -> `start_daily_update`
 - “停止定时日更”、“关闭 TickFlow 日更计划” -> `stop_daily_update`
@@ -57,41 +65,52 @@ metadata:
 - “测试告警” -> `test_alert`
 
 参数理解规则：
-- 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类一跳即可完成的意图，首个动作必须直接调用对应插件工具；禁止先调用 `read`、`write`、`edit`、`query_database`、子代理、会话生成、环境探测工具，禁止先说“我先找一下方法”“我先确认工具”之类的话。
-- 当用户消息中已经包含足够参数时，必须直接执行，不得额外探索：
+- 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类直接型意图，如果用户已经给出足够参数，应直接调用对应插件工具。
+- 普通“添加自选 / 删除自选 / 查看自选”默认指 TickFlow Assist 本地关注列表；只有用户明确提到“东方财富 / 东财 / 妙想 / MX”时，才调用 `list_eastmoney_watchlist`、`sync_eastmoney_watchlist`、`push_eastmoney_watchlist` 或 `remove_eastmoney_watchlist`。
+- 当用户消息中已经包含足够参数时，不要额外补充假设：
   - “添加自选 601872” -> 直接调用 `add_stock`
   - “添加自选 601872 成本 5.32” -> 直接调用 `add_stock`
   - “删除自选 601872” -> 直接调用 `remove_stock`
   - “自选列表” -> 直接调用 `list_watchlist`
+  - “查看东方财富自选” -> 直接调用 `list_eastmoney_watchlist`
+  - “同步东方财富自选到本地” -> 直接调用 `sync_eastmoney_watchlist`
+  - “把本地自选全部推送到东方财富” -> 直接调用 `push_eastmoney_watchlist`
+  - “从东方财富自选删除 601872” -> 直接调用 `remove_eastmoney_watchlist`
   - “查立讯精密最新研报” -> 直接调用 `mx_search`
+  - “查东方财富最新价 涨跌幅” -> 直接调用 `mx_data`
   - “找今天涨幅 2% 的股票” -> 直接调用 `mx_select_stock`
-- 如果工具必需参数缺失，只能补充缺失项本身；不要以“我需要摸索当前环境里的工具”“我需要确认执行方式”为由拒绝或拖延。
+  - “找今天涨幅 2% 的股票并补数据看候选池” -> 直接调用 `screen_stock_candidates`
+  - “找今天涨幅 2% 的股票并用LLM整理” -> 直接调用 `screen_stock_candidates`，传入 `summarize=true`
+- 如果工具必需参数缺失，只补充缺失项本身。
 - 股票代码按用户原始输入提取，例如 `002261`。
 - 成本价对应 `costPrice`；若用户未提供成本价，可以省略该字段。
 - `add_stock` 默认会在添加成功后自动拉取日K并计算指标。
+- `list_eastmoney_watchlist`、`sync_eastmoney_watchlist`、`push_eastmoney_watchlist`、`remove_eastmoney_watchlist` 使用东方财富妙想自选管理接口，复用 `mxSearchApiKey` / `MX_APIKEY`，每日额度为 200 次。
+- `list_eastmoney_watchlist` 和 `sync_eastmoney_watchlist` 各消耗 1 次妙想自选额度；`remove_eastmoney_watchlist` 每只股票消耗 1 次；`push_eastmoney_watchlist` 每推送 1 只本地关注股消耗 1 次。
+- `sync_eastmoney_watchlist` 默认只把东方财富自选导入本地关注列表，不拉取日K，也不刷新行业/概念；如需要行业/概念，后续调用 `refresh_watchlist_profiles`。
+- `push_eastmoney_watchlist` 只把本地已有关注股添加到东方财富自选；如果用户指定股票但本地关注列表里没有，应先用 `add_stock` 加入本地，再推送。
+- `remove_eastmoney_watchlist` 只删除东方财富自选，不删除 TickFlow Assist 本地关注；如果用户同时要求本地也删除，应再调用 `remove_stock`。
 - `analyze` 会读取本地日K和日线指标，临时补充当日分钟K、分钟指标、实时行情、最新财务数据与资讯检索结果，再走固定流水线综合分析；其中基本面部分在 `Expert` 级别下优先使用 TickFlow 完整财报，在非 `Expert` 级别下回退为 `mx_select_stock` 的 lite 指标拖底模式。
 - `view_analysis` 默认查看最近一次综合分析；如用户明确提到“技术面 / 基本面 / 资讯面 / 全部分析”，应传入 `profile=technical|financial|news|all`；如用户提到“最近 N 次”或“历史”，应同时传入 `limit=N`（或 `count=N`）。
 - `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_data`；如果问题是在问“发生了什么 / 有什么新闻 / 如何解读事件”，才使用 `mx_search`。
 - 对自然语言选股、板块成分股、条件筛选、候选池推荐等任务，优先使用 `mx_select_stock`；若问题本质是“找哪些标的符合条件”，不要误用 `mx_search`。
+- 对“选股 + 初步补充数据 / 候选池 / 对比看看”这类任务，优先使用 `screen_stock_candidates`，不要对大量候选逐只调用 `analyze`。该工具默认只补少量候选：候选默认 3 只、硬上限 8 只；分钟K仅 Pro / Expert 可用且默认关闭；TickFlow 完整财务仅 Expert 可用且默认关闭。
+- `screen_stock_candidates` 默认不调用 LLM；只有用户明确要求“LLM整理 / 总结 / 排优先级”或 Slash Command 使用 `/ta_screenstocks_llm` 时，才传 `summarize=true`。
 - 用户在“添加自选”意图中提到的“`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”“插件配置问题”“已重试但结果相同”这类解释性警告。先完整原样输出工具结果；只有用户继续追问原因时，才再解释调用链路差异。
 - 仅在工具必需参数缺失时，才简短指出缺少的字段。
 - 不要臆造股票代码、成本价、日期、阈值、分析结果或监控状态。
 
 输出规则：
-- 对 `add_stock`、`list_watchlist`、`start_monitor`、`stop_monitor`、`monitor_status`、`start_daily_update`、`stop_daily_update`、`daily_update_status`、`analyze`、`backtest_key_levels`、`view_analysis`、`fetch_klines`、`fetch_intraday_klines`、`mx_search`、`mx_select_stock` 和 `update_all`，调用工具后尽量原样输出返回文本。
+- 对 `add_stock`、`list_watchlist`、`list_eastmoney_watchlist`、`sync_eastmoney_watchlist`、`push_eastmoney_watchlist`、`remove_eastmoney_watchlist`、`start_monitor`、`stop_monitor`、`monitor_status`、`start_daily_update`、`stop_daily_update`、`daily_update_status`、`analyze`、`backtest_key_levels`、`view_analysis`、`fetch_klines`、`fetch_intraday_klines`、`mx_search`、`mx_data`、`mx_select_stock`、`screen_stock_candidates` 和 `update_all`，调用工具后尽量原样输出返回文本。
 - 对 `daily_update_status` 必须完整原样输出，尤其不要省略 `状态`、`运行方式`、`配置来源`、`调度`、`执行情况` 与 `最近摘要`。
 - 不要改写、总结、翻译、重排、美化，也不要加表格、额外标题或解释性包装。
 - 除非工具明确返回错误，否则不要在工具结果前后添加追问、评论或推断字段。

package/skills/usage-help/SKILL.md

@@ -96,8 +96,41 @@ TickFlow Assist 常用指令：
 或
 `看最近 3 条分析日志`
 
+18. 搜索资讯 / 查询数据 / 智能选股
+`查立讯精密最新研报`
+或
+`查东方财富最新价 涨跌幅`
+或
+`找今天涨幅 2% 的股票`
+或
+`找今天涨幅 2% 的股票并补数据看候选池`
+或
+`/ta_screenstocks 沪深A股中今日涨幅大于2%，市盈率小于30，市净率小于3，净利润同比增长为正，总市值小于300亿，属于半导体、人工智能或机器人相关板块的股票`
+或
+`/ta_screenstocks_llm 沪深A股中今日涨幅大于2%，市盈率小于30，市净率小于3，净利润同比增长为正，总市值小于300亿，属于半导体、人工智能或机器人相关板块的股票`
+说明：资讯、公告、研报、政策和事件解读走 `mx_search`；官方行情、财务、资金流、股东、高管等数据走 `mx_data`；原始条件选股走 `mx_select_stock`；选股后补 TickFlow 行情 / 日K做小规模候选池对比走 `screen_stock_candidates`。
+
+19. 查看东方财富自选
+`查看东方财富自选`
+说明：通过妙想自选管理接口读取东方财富通行证账户下的自选股，消耗 1 次每日额度。
+
+20. 从东方财富同步到本地
+`同步东方财富自选到本地`
+说明：把东方财富自选中本地尚未关注的股票加入 TickFlow Assist 关注列表；默认不拉日K、不刷新行业/概念。
+
+21. 把本地自选推送到东方财富
+`把本地自选全部推送到东方财富`
+或
+`把 002261 推送到东方财富自选`
+说明：每推送 1 只股票消耗 1 次妙想自选额度。
+
+22. 删除东方财富自选
+`从东方财富自选删除 002261`
+说明：只删除东方财富自选，不删除本地关注列表；如需本地也删除，再说“删除本地自选 002261”。
+
 补充说明：
 - 股票代码可直接写 `002261` 这类 6 位代码。
 - “分析”依赖本地已有日K数据；如果刚添加自选，系统现在会自动拉取。
 - 分钟K表名为 `klines_intraday`，默认保留近 10 个交易日。
+- 东方财富自选管理复用 `mxSearchApiKey` / `MX_APIKEY`，每日额度 200 次。
 - 如果你不确定怎么说，直接发“添加股票 / 拉日K / 分析 / 开始盯盘”这类自然语言也可以。