tickflow-assist 0.3.7 → 0.3.9

package/openclaw.plugin.json

@@ -1,31 +1,150 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
   ],
   "activation": {
+    "onStartup": true,
+    "onCommands": [
+      "ta_addstock",
+      "ta_rmstock",
+      "ta_analyze",
+      "ta_backtest",
+      "ta_viewanalysis",
+      "ta_watchlist",
+      "ta_refreshnames",
+      "ta_refreshprofiles",
+      "ta_startmonitor",
+      "ta_stopmonitor",
+      "ta_monitorstatus",
+      "ta_flashstatus",
+      "ta_startdailyupdate",
+      "ta_stopdailyupdate",
+      "ta_updateall",
+      "ta_dailyupdatestatus",
+      "ta_testalert",
+      "ta_screenstocks",
+      "ta_screenstocks_llm",
+      "ta_debug"
+    ],
     "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"
+  "commandAliases": [
+    {
+      "name": "ta_addstock",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_rmstock",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_analyze",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_backtest",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_viewanalysis",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_watchlist",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_refreshnames",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_refreshprofiles",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_startmonitor",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_stopmonitor",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_monitorstatus",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_flashstatus",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_startdailyupdate",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_stopdailyupdate",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_updateall",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_dailyupdatestatus",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_testalert",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_screenstocks",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_screenstocks_llm",
+      "kind": "runtime-slash"
+    },
+    {
+      "name": "ta_debug",
+      "kind": "runtime-slash"
+    }
+  ],
+  "contracts": {
+    "tools": [
+      "add_stock",
+      "analyze",
+      "backtest_key_levels",
+      "daily_update_status",
+      "fetch_intraday_klines",
+      "fetch_financials",
+      "flash_monitor_status",
+      "fetch_klines",
+      "list_watchlist",
+      "list_eastmoney_watchlist",
+      "monitor_status",
+      "mx_data",
+      "mx_search",
+      "mx_select_stock",
+      "push_eastmoney_watchlist",
+      "query_database",
+      "refresh_watchlist_names",
+      "refresh_watchlist_profiles",
+      "remove_eastmoney_watchlist",
+      "remove_stock",
+      "screen_stock_candidates",
+      "start_daily_update",
+      "start_monitor",
+      "sync_eastmoney_watchlist",
+      "stop_daily_update",
+      "stop_monitor",
+      "test_alert",
+      "update_all",
+      "view_analysis"
     ]
   },
   "providerAuthChoices": [
@@ -61,14 +180,14 @@
       "provider": "mx-search",
       "method": "api-key",
       "choiceId": "mx-search-api-key",
-      "choiceLabel": "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 Search API key",
+      "cliDescription": "MX Skills API key",
       "assistantVisibility": "manual-only"
     },
     {
@@ -163,12 +282,12 @@
       "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",
@@ -282,8 +401,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.7",
+  "version": "0.3.9",
   "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,17 +46,17 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.14"
+      "openclawVersion": "2026.5.2"
     },
     "compat": {
-      "pluginApi": ">=2026.3.31",
-      "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.14"
+      "pluginApi": ">=2026.5.2",
+      "minGatewayVersion": "2026.5.2",
+      "builtWithOpenClawVersion": "2026.5.2"
     },
     "install": {
       "npmSpec": "tickflow-assist",
       "defaultChoice": "npm",
-      "minHostVersion": ">=2026.3.31"
+      "minHostVersion": ">=2026.5.2"
     },
     "extensions": [
       "dist/plugin.js"
@@ -74,9 +74,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.14",
+    "openclaw": "^2026.5.2",
     "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.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",
+  "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.9` 对齐 OpenClaw `v2026.5.2+`，恢复新版 Telegram 原生命令菜单中的 `/ta_` 命令可见性，并增强 PNG 媒体投递失败后的文本回退与一键安装依赖处理。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.5.2+` 对齐，并使用 `contracts.tools` 与 `setup.providers[].envVars` 等新版插件清单字段。\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 告警卡图片投递，请确认宿主 OpenClaw 的全局 npm 环境可解析 `sharp`，如需中文正常显示再安装 `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- `sharp`：插件本地依赖用于生成 PNG；OpenClaw `message send --media` 还需要宿主 OpenClaw 全局 npm 环境可解析 `sharp`，否则图片投递会回退为纯文本。\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

@@ -5,7 +5,7 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 ---
 # 股票分析与监控
 
-这是 TickFlow Assist 插件内置的技能，用于通过插件工具完成 A 股自选股管理、日线更新、分钟K抓取、技术分析、关键价位回测、实时监控、定时日更、结果查看与告警测试。
+这是 TickFlow Assist 插件内置的技能，用于通过插件工具完成 A 股自选股管理、东方财富自选同步、日线更新、分钟K抓取、技术分析、关键价位回测、实时监控、定时日更、结果查看与告警测试。
 运行前需要提供 TickFlow / LLM 等凭证；这些值既可以来自 `plugins.entries["tickflow-assist"].config`，也可以来自文档约定的环境变量 fallback，不要求必须明文写在插件配置里。
 
 此技能随插件加载，不需要手动复制到 workspace。
@@ -15,11 +15,17 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 适用场景：
 - 添加或删除自选股
 - 查看自选列表
+- 查看东方财富自选股列表
+- 从东方财富同步自选股到本地关注列表
+- 将本地关注列表推送到东方财富自选
+- 从东方财富自选中删除股票
 - 刷新自选股名称
 - 拉取单只股票的 K 线数据
 - 拉取单只股票的分钟 K 线数据
 - 搜索个股 / 板块 / 宏观相关资讯、公告、研报、政策、事件解读
+- 查询官方行情、财务、资金流、股东、高管、主营业务、板块 / 指数数据
 - 按自然语言条件做智能选股
+- 基于智能选股生成小规模候选池，并补充 TickFlow 行情 / 日K等数据
 - 执行全部日更
 - 分析单只股票
 - 回测活动价位 / 回测股票
@@ -32,11 +38,18 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 - “添加自选”、“加入观察”、“加股票” -> `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`
@@ -53,17 +66,30 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 
 参数理解规则：
 - 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类直接型意图，如果用户已经给出足够参数，应直接调用对应插件工具。
+- 普通“添加自选 / 删除自选 / 查看自选”默认指 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 个交易日。
@@ -71,7 +97,10 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 - `backtest_key_levels` 默认回测全部关注股的活动价位；如果用户提到股票代码，应传入 `symbol`；如果用户提到“最近 N 次”，应传入 `recentLimit=N`。
 - 若配置中的 `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、系统任务或无关插件的定时更新。
 - 如果当前会话没有暴露对应插件工具，应直接说明当前技能暂不可用。
@@ -81,7 +110,7 @@ metadata: {"openclaw":{"skillKey":"stock_analysis","always":true,"primaryEnv":"T
 - 不要臆造股票代码、成本价、日期、阈值、分析结果或监控状态。
 
 输出规则：
-- 对 `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 / 分析 / 开始盯盘”这类自然语言也可以。