tickflow-assist 0.2.5 → 0.2.6

package/README.md

@@ -1,64 +1,29 @@
-# 📈 TickFlow Assist
+# TickFlow Assist
 
-基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow API](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
+基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 TickFlow 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-当前主线架构：
+## 安装
 
-- OpenClaw 插件是主入口
-- JS/TS 负责主业务流程
-- Python 仅保留技术指标计算
-
-兼容性要求：
-
-- TickFlow Assist `0.2.0` 起面向 OpenClaw `v2026.3.22+` 的新版 plugin SDK
-- 建议 Node `>=22.16.0`，这是 OpenClaw `v2026.3.22` 上游声明的运行时要求
-
-## 🧭 项目简介
-
-TickFlow Assist 面向一条完整的“自选管理 -> 数据抓取 -> 综合分析 -> 后台监控 -> 结果留痕”链路，适合在 OpenClaw 中做 A 股日常盯盘、收盘后复盘和分析结果沉淀。
-
-## ✨ 核心特性
-
-- 数据抓取：支持日 K、分钟 K、实时行情与财务数据接入，收盘后可批量更新。
-- 多维分析：技术面、财务面、资讯面按固定流水线执行，输出综合结论与关键价位。
-- 监控告警：围绕止损、突破、支撑、压力、止盈、涨跌幅和成交量异动进行交易时段轮询。
-- 复盘留痕：收盘后自动生成活动关键价位快照，并提供 `1/3/5` 日回测统计（测试）。
-- 本地数据库：使用 LanceDB 保存自选、K 线、指标、分析结果、关键价位和告警日志。
-
-## 📚 文档导航
-
-- 安装指南：[docs/installation.md](docs/installation.md)
-- 使用指南：[docs/usage.md](docs/usage.md)
-- 插件清单：[openclaw.plugin.json](openclaw.plugin.json)
-- 内置技能：
-  - [skills/stock-analysis/SKILL.md](skills/stock-analysis/SKILL.md)
-  - [skills/usage-help/SKILL.md](skills/usage-help/SKILL.md)
-  - [skills/database-query/SKILL.md](skills/database-query/SKILL.md)
-
-## 🛠 安装与配置
-
-### 社区安装（推荐）
-
-如果你不需改动源码，可直接通过 OpenClaw 插件市场或 npm 安装：
+社区安装：
 
 ```bash
 openclaw plugins install tickflow-assist
 npx -y tickflow-assist configure-openclaw
 ```
 
-### 一键安装脚本
+第二条命令会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`，并默认执行：
 
-如果你已经安装了 `git`、`node`、`npm`、`uv`、`openclaw` 与 `jq`，并且想要从源码运行，可以直接运行安装向导：
+- `openclaw plugins enable tickflow-assist`
+- `openclaw config validate`
+- `openclaw gateway restart`
+
+如果你希望先审阅配置再手动启用或重启，可使用：
 
 ```bash
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/robinspt/tickflow-assist/main/setup-tickflow.sh)"
+npx -y tickflow-assist configure-openclaw --no-enable --no-restart
 ```
 
-向导会自动完成源码更新、依赖安装、配置写入、插件安装与 Gateway 重启。完整流程见 [docs/installation.md](docs/installation.md)。
-
-如果你已经装过旧版本，优先直接执行“升级”。具体升级与重装边界见 [docs/installation.md](docs/installation.md)。
-
-### 手动源码安装
+源码安装：
 
 ```bash
 git clone https://github.com/robinspt/tickflow-assist.git
@@ -74,75 +39,41 @@ openclaw plugins enable tickflow-assist
 openclaw gateway restart
 ```
 
+## 配置
 
-
-## 🚀 使用方式
-
-常见入口有三种：
-
-- OpenClaw 对话：直接说“添加 002261”“分析 002261”“开始监控”。
-- Slash Command：使用 `/ta_addstock`、`/ta_analyze`、`/ta_monitorstatus` 等免 AI 直达命令。
-- 本地 CLI：通过 `npm run tool -- ...`、`npm run monitor-loop`、`npm run daily-update-loop` 做调试或直连运行。
-
-常用示例：
+插件正式运行读取：
 
 ```text
-添加 002261
-分析 002261
-/ta_addstock 002261 34.15
-/ta_monitorstatus
-npm run tool -- analyze '{"symbol":"002261"}'
+~/.openclaw/openclaw.json
 ```
 
-更完整的指令分类、CLI 示例与运行规则见 [docs/usage.md](docs/usage.md)。
-
-## 🧩 架构与目录
-
-后台任务统一由 `tickflow-assist.managed-loop` 托管，在同一个 service 内并行运行日更与实时监控。
+配置路径：
 
 ```text
-tickflow-assist/
-├── docs/                         # 安装与使用文档
-├── src/                          # 主业务代码
-├── src/tools/                    # OpenClaw tools
-├── src/services/                 # 行情、分析、监控、告警、更新服务
-├── src/background/               # 日更与实时监控后台逻辑
-├── src/prompts/analysis/         # 分析 prompt
-├── skills/                       # 插件内置 skills
-├── python/                       # Python 指标计算子模块
-├── openclaw.plugin.json          # 插件清单
-└── README.md                     # 项目概览
+plugins.entries["tickflow-assist"].config
 ```
 
-## 🔌 依赖与可选能力
-
-- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。
-- OpenClaw：负责插件运行、工具注册、对话入口与消息投递。
-- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search` 与 `mx_select_stock`，也用于非 Expert 财务链路的 lite 补充。
-
-## ⚠️ 风险提示
+常用字段：
 
-本项目仅用于策略研究、流程验证与教学交流，不构成任何形式的投资建议、收益承诺或具体交易指引。
+- 必填：`tickflowApiKey`、`llmApiKey`
+- 常用：`llmBaseUrl`、`llmModel`、`databasePath`、`calendarFile`
+- 可选：`mxSearchApiKey`、`alertTarget`、`alertAccount`
 
-- 市场环境、流动性、执行价格与个人交易纪律都会影响实际结果，历史表现不代表未来收益。
-- AI 模型、自动化分析与回测结果都可能存在偏差、遗漏或失效，不应作为单一决策依据。
-- 使用前请结合自身资金情况、风险承受能力与独立判断审慎评估，并自行承担相应风险。
+`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget` 仅在 `test_alert`、实时监控告警和定时通知场景需要。
 
-## 📝 更新日志
+## 功能
 
-- `2026-03-17`：统一后台托管循环
-- `2026-03-19`：新增财务与妙想链路
-- `2026-03-20`：补充收盘分析与回测
-- `2026-03-21`：优化A股语境与复盘记忆
-- `2026-03-23`：发布 `v0.2.0`，迁移到 OpenClaw `v2026.3.22+` 的新版 plugin SDK，并将复盘改至 20:00 独立调度
-- `2026-03-27`：发布 `v0.2.5`，优化分析 prompt 并增强结构化 JSON 解析容错。
+- 自选股管理、日 K / 分钟 K 抓取与指标计算
+- 技术面、财务面、资讯面的综合分析
+- 实时监控、定时日更、收盘后复盘
+- 本地 LanceDB 数据留痕与分析结果查看
 
-## 🙏 鸣谢
+## 运行说明
 
-- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 提供行情数据服务与 API 支持
-- [OpenClaw](https://openclaw.ai) 提供插件运行、对话通道与工具编排能力
-- [CortexReach/memory-lancedb-pro](https://github.com/CortexReach/memory-lancedb-pro) 给你的 OpenClaw Agent 提供持久化、智能化的长期记忆
+- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。
+- 后台服务会按配置执行定时日更与实时监控。
+- Python 子模块仅用于技术指标计算，不承担主业务流程。
 
-## 📄 License
+## 仓库
 
-MIT
+- GitHub: <https://github.com/robinspt/tickflow-assist>

package/dist/config/normalize.js

@@ -80,9 +80,6 @@ export function validatePluginConfig(config) {
     if (!config.llmApiKey) {
         errors.push("llmApiKey is required");
     }
-    if (!config.alertTarget) {
-        errors.push("alertTarget is required");
-    }
     if (!config.tickflowApiUrl.startsWith("http://") && !config.tickflowApiUrl.startsWith("https://")) {
         errors.push("tickflowApiUrl must be an absolute http(s) URL");
     }

package/dist/dev/tickflow-assist-cli.js

@@ -442,7 +442,7 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
         else {
             targetLabel = `已选通道 [${seed.alertChannel}]，请输入 Alert Target`;
         }
-        seed.alertTarget = await promptString(rl, targetLabel, seed.alertTarget, true);
+        seed.alertTarget = await promptString(rl, targetLabel, seed.alertTarget, false);
         seed.requestInterval = await promptInteger(rl, "Request Interval (seconds)", seed.requestInterval, 5);
         seed.dailyUpdateNotify = await promptBoolean(rl, "Daily Update Notify", seed.dailyUpdateNotify);
     }
@@ -495,9 +495,6 @@ function assertRequired(config) {
     if (!config.llmApiKey) {
         throw new Error("llmApiKey is required");
     }
-    if (!config.alertTarget) {
-        throw new Error("alertTarget is required");
-    }
 }
 async function ensurePathNotice(targetPath, label) {
     try {
@@ -598,50 +595,10 @@ async function setupPythonDeps(pythonWorkdir, nonInteractive) {
     try {
         const which = spawnSync("which", ["uv"], { encoding: "utf-8" });
         if (which.status !== 0) {
-            console.log("\n  ⚠️ 找不到 uv (Python 包管理工具)。");
-            let shouldInstall = false;
-            if (!nonInteractive) {
-                const rl = createInterface({ input: process.stdin, output: process.stdout });
-                const answer = (await rl.question("  是否自动下载并安装 uv？(y/n) [y]: ")).trim().toLowerCase();
-                rl.close();
-                if (!answer || ["y", "yes", "1", "true"].includes(answer)) {
-                    shouldInstall = true;
-                }
-            }
-            if (shouldInstall) {
-                console.log("  正在安装 uv...");
-                const installResult = spawnSync("sh", ["-c", "curl -LsSf https://astral.sh/uv/install.sh | sh"], { stdio: "inherit" });
-                if (installResult.status !== 0) {
-                    console.warn("  uv 安装失败，跳过 Python 依赖安装。");
-                    return;
-                }
-                let foundUv = false;
-                let installedLoc = "";
-                for (const loc of [path.join(os.homedir(), ".local", "bin", "uv"), path.join(os.homedir(), ".cargo", "bin", "uv")]) {
-                    try {
-                        await access(loc);
-                        uvBin = loc;
-                        installedLoc = loc;
-                        foundUv = true;
-                        break;
-                    }
-                    catch {
-                        // ignore
-                    }
-                }
-                if (!foundUv) {
-                    uvBin = "uv";
-                }
-                else {
-                    console.log(`\n  ✅ uv 已自动安装到 ${installedLoc}`);
-                    console.log("  ⚠️ 温馨提示：为了在终端能直接使用 uv 命令，您可能需要执行 `source $HOME/.local/bin/env` \n  或自行将其所在目录添加入系统的 PATH 环境变量中。\n");
-                }
-            }
-            else {
-                console.warn("\n  ⚠️ 跳过 Python 依赖安装。请手动安装 uv (https://docs.astral.sh/uv/) 并执行 'uv sync'，路径：");
-                console.warn(`  ${pythonWorkdir}`);
-                return;
-            }
+            console.warn("\n  ⚠️ 找不到 uv (Python 包管理工具)，已跳过 Python 依赖安装。");
+            console.warn("  请先手动安装 uv，再在以下目录执行 `uv sync`：");
+            console.warn(`  ${pythonWorkdir}`);
+            return;
         }
         else {
             uvBin = which.stdout.trim() || "uv";

package/dist/plugin-registration.test.d.ts

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

package/dist/plugin-registration.test.js

@@ -0,0 +1,93 @@
+import assert from "node:assert/strict";
+import path from "node:path";
+import test from "node:test";
+import pluginEntry from "./plugin.js";
+function createMockApi() {
+    const registeredTools = [];
+    const registeredServices = [];
+    const registeredCommands = [];
+    const hookEvents = [];
+    const logger = {
+        info() { },
+        warn() { },
+        error() { },
+        debug() { },
+    };
+    const api = {
+        config: {},
+        pluginConfig: {
+            tickflowApiKey: "test-tickflow-key",
+            llmApiKey: "test-llm-key",
+            alertTarget: "TEST_TARGET",
+            databasePath: "./tmp/plugin-registration-test-db",
+            calendarFile: "./day_future.txt",
+            pythonWorkdir: "./python",
+        },
+        registrationMode: "full",
+        resolvePath(input) {
+            return path.resolve(process.cwd(), input);
+        },
+        runtime: undefined,
+        logger,
+        registerTool(tool, opts) {
+            registeredTools.push({ tool, opts });
+        },
+        registerService(service) {
+            registeredServices.push(service);
+        },
+        registerCommand(command) {
+            registeredCommands.push(command);
+        },
+        on(event) {
+            hookEvents.push(event);
+        },
+    };
+    return {
+        api,
+        registeredTools,
+        registeredServices,
+        registeredCommands,
+        hookEvents,
+    };
+}
+function mapToolOptionality(registeredTools) {
+    return new Map(registeredTools.map(({ tool, opts }) => [tool.name, opts?.optional === true]));
+}
+test("plugin registration marks state-changing tools as optional", () => {
+    const { api, registeredTools, registeredServices, registeredCommands, hookEvents, } = createMockApi();
+    pluginEntry.register(api);
+    const optionality = mapToolOptionality(registeredTools);
+    for (const toolName of [
+        "add_stock",
+        "remove_stock",
+        "refresh_watchlist_names",
+        "refresh_watchlist_profiles",
+        "start_monitor",
+        "stop_monitor",
+        "start_daily_update",
+        "stop_daily_update",
+        "update_all",
+        "test_alert",
+    ]) {
+        assert.equal(optionality.get(toolName), true, `${toolName} should be optional`);
+    }
+    for (const toolName of [
+        "analyze",
+        "backtest_key_levels",
+        "daily_update_status",
+        "fetch_financials",
+        "fetch_intraday_klines",
+        "fetch_klines",
+        "list_watchlist",
+        "monitor_status",
+        "mx_search",
+        "mx_select_stock",
+        "query_database",
+        "view_analysis",
+    ]) {
+        assert.equal(optionality.get(toolName), false, `${toolName} should remain required`);
+    }
+    assert.ok(registeredServices.some((service) => service.id === "tickflow-assist.managed-loop"), "managed loop service should be registered in full mode");
+    assert.ok(registeredCommands.some((command) => command.name === "ta_addstock"), "slash commands should still be registered");
+    assert.ok(hookEvents.includes("before_prompt_build"), "stock-agent prompt hook should remain registered");
+});

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -9,54 +9,69 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
+    "required": ["tickflowApiKey", "llmApiKey"],
     "properties": {
       "tickflowApiUrl": {
         "type": "string",
-        "default": "https://api.tickflow.org"
+        "default": "https://api.tickflow.org",
+        "description": "TickFlow API base URL."
       },
       "tickflowApiKey": {
-        "type": "string"
+        "type": "string",
+        "minLength": 1,
+        "description": "Required. TickFlow API key used for market and financial data."
       },
       "tickflowApiKeyLevel": {
         "type": "string",
         "enum": ["Free", "Start", "Pro", "Expert"],
-        "default": "Free"
+        "default": "Free",
+        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching."
       },
       "mxSearchApiUrl": {
         "type": "string",
-        "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw"
+        "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
+        "description": "MX Search API base URL."
       },
       "mxSearchApiKey": {
         "type": "string",
-        "default": ""
+        "default": "",
+        "description": "Optional. Enables mx_search, mx_select_stock, and non-Expert financial fallback."
       },
       "llmBaseUrl": {
         "type": "string",
-        "default": "https://api.openai.com/v1"
+        "default": "https://api.openai.com/v1",
+        "description": "OpenAI-compatible LLM API base URL."
       },
       "llmApiKey": {
-        "type": "string"
+        "type": "string",
+        "minLength": 1,
+        "description": "Required. API key for the analysis model endpoint configured in llmBaseUrl."
       },
       "llmModel": {
         "type": "string",
-        "default": "gpt-4o"
+        "default": "gpt-4o",
+        "description": "Model name used for analysis."
       },
       "databasePath": {
         "type": "string",
-        "default": "./data/lancedb"
+        "default": "./data/lancedb",
+        "description": "Local LanceDB data directory."
       },
       "calendarFile": {
         "type": "string",
-        "default": "./day_future.txt"
+        "default": "./day_future.txt",
+        "description": "Trading calendar file path."
       },
       "requestInterval": {
         "type": "integer",
         "minimum": 5,
-        "default": 30
+        "default": 30,
+        "description": "Realtime monitoring polling interval in seconds."
       },
       "dailyUpdateNotify": {
         "type": "boolean",
-        "default": true
+        "default": true,
+        "description": "Whether scheduled daily update and post-close review send notifications."
       },
       "alertChannel": {
         "type": "string",
@@ -73,44 +88,74 @@
       },
       "alertTarget": {
         "type": "string",
-        "description": "Channel target, e.g. Telegram chat ID, qqbot:c2c:OPENID, or WeCom userId/chatId",
+        "description": "Optional. Channel target for test_alert, monitoring alerts, and scheduled notifications.",
         "default": ""
       },
       "pythonBin": {
         "type": "string",
-        "default": "uv"
+        "default": "uv",
+        "description": "Python launcher used for indicator calculation."
       },
       "pythonArgs": {
         "type": "array",
         "items": {
           "type": "string"
         },
-        "default": ["run", "python"]
+        "default": ["run", "python"],
+        "description": "Arguments passed to pythonBin before indicator_runner.py."
       },
       "pythonWorkdir": {
         "type": "string",
-        "default": "./python"
+        "default": "./python",
+        "description": "Working directory for the Python indicator bridge."
       }
     }
   },
   "uiHints": {
     "tickflowApiKey": {
       "label": "TickFlow API Key",
+      "help": "Required for TickFlow market and financial data.",
       "sensitive": true
     },
     "tickflowApiKeyLevel": {
-      "label": "TickFlow API Key Level"
+      "label": "TickFlow API Key Level",
+      "help": "Set this to your actual TickFlow subscription level."
     },
     "mxSearchApiKey": {
       "label": "MX Search API Key",
+      "help": "Optional. Enables mx_search, mx_select_stock, and lite financial fallback.",
       "sensitive": true
     },
+    "llmBaseUrl": {
+      "label": "LLM Base URL",
+      "help": "OpenAI-compatible analysis endpoint."
+    },
     "llmApiKey": {
       "label": "LLM API Key",
+      "help": "Required for analysis model requests.",
       "sensitive": true
     },
+    "llmModel": {
+      "label": "LLM Model",
+      "help": "Model name used for stock analysis."
+    },
+    "alertChannel": {
+      "label": "Alert Channel",
+      "help": "Default delivery channel for alert messages."
+    },
     "alertTarget": {
-      "label": "Alert Target"
+      "label": "Alert Target",
+      "help": "Optional. Configure this if you want test_alert, monitoring alerts, or scheduled notifications."
+    },
+    "databasePath": {
+      "label": "Database Path",
+      "help": "Local LanceDB storage directory.",
+      "advanced": true
+    },
+    "calendarFile": {
+      "label": "Calendar File",
+      "help": "Trading calendar file path.",
+      "advanced": true
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "OpenClaw plugin for TickFlow-based A-share analysis, monitoring, and alerting.",
   "license": "MIT",
   "type": "module",
@@ -10,7 +10,6 @@
   },
   "files": [
     "dist",
-    "docs",
     "skills",
     "python",
     "day_future.txt",
@@ -25,9 +24,11 @@
     "lancedb"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node ./scripts/clean-dist.mjs && tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
     "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",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
@@ -36,6 +37,11 @@
     "validate:mx-search": "npm run build && node dist/dev/validate-mx-search.js"
   },
   "openclaw": {
+    "compat": {
+      "pluginApi": "1.2.0",
+      "minGatewayVersion": "2026.3.22",
+      "builtWithOpenClawVersion": "2026.3.22"
+    },
     "extensions": [
       "dist/plugin.js"
     ]

package/skills/database-query/SKILL.md

@@ -5,7 +5,8 @@ metadata:
   openclaw:
     skillKey: database_query
     requires:
-      config: true
+      config:
+        - plugins.entries.tickflow-assist.enabled
 ---
 # LanceDB 数据查询
 

package/skills/stock-analysis/SKILL.md

@@ -5,7 +5,10 @@ metadata:
   openclaw:
     skillKey: stock_analysis
     requires:
-      config: true
+      config:
+        - plugins.entries.tickflow-assist.enabled
+        - plugins.entries.tickflow-assist.config.tickflowApiKey
+        - plugins.entries.tickflow-assist.config.llmApiKey
 ---
 # 股票分析与监控
 

package/dist/runtime/monitor-process.d.ts

@@ -1,3 +0,0 @@
-import type { PluginConfig } from "../config/schema.js";
-export declare function spawnMonitorLoop(config: PluginConfig, configSource: "openclaw_plugin" | "local_config"): number | null;
-export declare function isPidAlive(pid: number): boolean;

package/dist/runtime/monitor-process.js

@@ -1,24 +0,0 @@
-import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { buildProcessConfigEnv } from "./process-config.js";
-const PROJECT_ROOT = fileURLToPath(new URL("../../", import.meta.url));
-const MONITOR_LOOP_SCRIPT = fileURLToPath(new URL("../dev/run-monitor-loop.js", import.meta.url));
-export function spawnMonitorLoop(config, configSource) {
-    const child = spawn(process.execPath, [MONITOR_LOOP_SCRIPT], {
-        cwd: PROJECT_ROOT,
-        detached: true,
-        stdio: "ignore",
-        env: buildProcessConfigEnv(config, configSource),
-    });
-    child.unref();
-    return child.pid ?? null;
-}
-export function isPidAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/docs/installation.md

@@ -1,393 +0,0 @@
-# TickFlow Assist 安装指南
-
-本文档聚焦于安装、配置与消息通道接入。功能与日常使用请参阅 [使用说明](usage.md)，项目概览请先看 [README](../README.md)。
-
-## 1. 前置条件
-
-开始前请确认目标机器已经具备：
-
-- `git`
-- `node` 与 `npm`
-- `uv`
-- `openclaw`
-- OpenClaw 版本建议 `v2026.3.22` 或更高
-- Node 版本建议 `>=22.16.0`（这是 OpenClaw `v2026.3.22` 上游声明的运行时要求）
-- 可用的 `TickFlow API Key`：[获取地址](https://tickflow.org/auth/register?ref=BUJ54JEDGE)
-- 可用的 OpenAI 兼容 `LLM API Key`
-- 可选的东方财富妙想 Skills `API Key`：[获取地址](https://marketing.dfcfs.com/views/finskillshub/)
-
-如果目标机器还没安装 `uv`，先执行：
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-## 2. 一键安装（推荐）
-
-安装、升级、卸载都优先建议使用项目自带向导：
-
-```bash
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/robinspt/tickflow-assist/main/setup-tickflow.sh)"
-```
-
-向导会自动完成以下工作：
-
-- 拉取或更新源码
-- 安装 Node 与 Python 依赖
-- 生成或复用 `local.config.json`
-- 写入 `~/.openclaw/openclaw.json` 中的插件配置
-- 安装并启用 `tickflow-assist`
-- 重启 OpenClaw Gateway
-
-如果你只是日常升级，重新运行同一条命令并在菜单里选择“升级”即可。更具体的升级与重装说明见下文 [7.2 升级](#72-升级) 与 [7.3 禁用重装与清理](#73-禁用重装与清理)。
-
-## 3. 社区安装（推荐）
-
-如果你不需改动源码，可直接通过 OpenClaw 插件市场或 npm 安装：
-
-```bash
-openclaw plugins install tickflow-assist
-npx -y tickflow-assist configure-openclaw
-```
-
-第二条命令会自动：
-
-- 安装 Python 依赖（`uv sync`）
-- 写入 `plugins.entries["tickflow-assist"].config`
-- 给顶层 `tools.allow` 或推断出的目标 Agent 补 `tickflow-assist` allowlist
-- 执行 `openclaw plugins enable tickflow-assist`
-- 执行 `openclaw config validate`
-- 执行 `openclaw gateway restart`
-
-如果你已经手动启用插件，或暂时不想重启 Gateway，可追加 `--no-enable` 或 `--no-restart`。如果 Python 已经装好或不需要自动安装，可追加 `--no-python-setup`。
-
-## 4. 源码安装
-
-### 4.1 拉取源码
-
-推荐把项目放在普通开发目录，不要放到 `~/.openclaw/workspace/...` 下面。
-
-```bash
-cd ~
-git clone https://github.com/robinspt/tickflow-assist.git
-cd tickflow-assist
-```
-
-### 4.2 安装依赖并构建
-
-```bash
-npm install
-cd python
-uv sync
-cd ..
-npm run check
-npm run build
-```
-
-### 4.3 安装并启用插件（源码安装）
-
-```bash
-openclaw plugins install -l /path/to/tickflow-assist
-openclaw plugins enable tickflow-assist
-```
-
-## 5. 插件配置
-
-正式插件运行读取：
-
-```text
-~/.openclaw/openclaw.json
-```
-
-配置路径：
-
-```text
-plugins.entries["tickflow-assist"].config
-```
-
-最小示例：
-
-```json5
-{
-  "plugins": {
-    "enabled": true,
-    "entries": {
-      "tickflow-assist": {
-        "enabled": true,
-        "config": {
-          "tickflowApiKey": "your-tickflow-key",
-          "mxSearchApiUrl": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-          "mxSearchApiKey": "mkt_xxx",
-          "llmBaseUrl": "https://api.openai.com/v1",
-          "llmApiKey": "sk-xxx",
-          "llmModel": "gpt-4o",
-          "databasePath": "/path/to/tickflow-assist/data/lancedb",
-          "calendarFile": "/path/to/tickflow-assist/day_future.txt",
-          "alertChannel": "telegram",
-          "alertTarget": "YOUR_TARGET",
-          "pythonBin": "uv",
-          "pythonArgs": ["run", "python"],
-          "pythonWorkdir": "/path/to/tickflow-assist/python"
-        }
-      }
-    }
-  }
-}
-```
-
-如果你还需要使用 `npm run tool -- ...`、`npm run monitor-loop` 或 `npm run daily-update-loop`，则项目根目录还需要有一个 `local.config.json`，并且字段必须写在 `plugin` 下：
-
-```json
-{
-  "plugin": {
-    "tickflowApiKey": "your-tickflow-key",
-    "mxSearchApiUrl": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-    "mxSearchApiKey": "mkt_xxx",
-    "llmBaseUrl": "https://api.openai.com/v1",
-    "llmApiKey": "sk-xxx",
-    "llmModel": "gpt-4o",
-    "databasePath": "./data/lancedb",
-    "calendarFile": "./day_future.txt",
-    "alertChannel": "telegram",
-    "alertTarget": "YOUR_TARGET"
-  }
-}
-```
-
-### 配置字段速查
-
-| 字段 | 必填 | 说明 |
-|---|---|---|
-| `tickflowApiUrl` | 否 | TickFlow API 地址，默认 `https://api.tickflow.org` |
-| `tickflowApiKey` | 是 | TickFlow API Key |
-| `tickflowApiKeyLevel` | 否 | `Free` / `Start` / `Pro` / `Expert`；`Pro` 与 `Expert` 会尝试分钟 K |
-| `mxSearchApiUrl` | 否 | 妙想 Skills 接口地址 |
-| `mxSearchApiKey` | 否 | 启用 `mx_search` / `mx_select_stock`，也用于非 Expert 财务链路的 lite 回退 |
-| `llmBaseUrl` | 否 | OpenAI 兼容接口地址 |
-| `llmApiKey` | 是 | 大模型 API Key；使用本地模型时也不能留空，可填占位值 |
-| `llmModel` | 是 | 分析使用的模型名 |
-| `databasePath` | 是 | LanceDB 数据目录，建议正式环境用绝对路径 |
-| `calendarFile` | 是 | 交易日历文件路径，建议正式环境用绝对路径 |
-| `requestInterval` | 否 | 实时监控轮询间隔，默认 `30` 秒 |
-| `dailyUpdateNotify` | 否 | 是否发送定时日更与定时复盘通知，默认 `true` |
-| `alertChannel` | 是 | 告警通道，如 `telegram`、`qqbot`（QQ机器人）、`wecom`（企业微信）、`weixin`（微信） |
-| `openclawCliBin` | 否 | `openclaw` 可执行文件路径，默认 `openclaw` |
-| `alertAccount` | 否 | 多账号通道使用；QQBot / WeCom 常见为 `default` |
-| `alertTarget` | 是 | 告警投递目标，写法随通道而不同 |
-| `pythonBin` | 否 | Python 子模块启动命令，默认 `uv` |
-| `pythonArgs` | 否 | Python 子模块命令参数，默认 ["run", "python"] |
-| `pythonWorkdir` | 是 | Python 子模块工作目录 |
-
-<details>
-<summary>进阶说明：正式配置、本地调试配置与 Agent Tools</summary>
-
-正式插件链路与本地 CLI 链路是两套独立配置：
-
-- OpenClaw 对话读取 `~/.openclaw/openclaw.json`
-- `npm run tool -- ...` 与本地 loop 读取 `local.config.json.plugin`
-- 它们不会自动同步；如果两边都要用，建议至少保持 `tickflowApiKey`、`llmBaseUrl`、`llmApiKey`、`llmModel`、`databasePath`、`calendarFile`、`alertChannel`、`alertAccount`、`alertTarget` 一致
-
-如果你给股票 Agent 显式配置 `tools`，推荐保留 `profile: "full"`，不要额外禁用 `exec`、`read`、`write` 等运行时能力。
-
-从 `0.2.0` 起，以下 TickFlow Assist agent tools 按 OpenClaw 官方建议以 optional 注册：
-
-- `add_stock`
-- `remove_stock`
-- `refresh_watchlist_names`
-- `refresh_watchlist_profiles`
-- `start_monitor`
-- `stop_monitor`
-- `start_daily_update`
-- `stop_daily_update`
-- `update_all`
-- `test_alert`
-
-如果你给 Agent 配了 `tools.allow`，请把插件 id `tickflow-assist` 或上面的具体工具名加入允许列表；否则这些 optional tools 不会自动出现在对话可调用工具集中。插件 Slash Command 不受这个 allowlist 影响。
-
-多 Agent 场景示例：
-
-```json5
-{
-  "agents": {
-    "list": [
-      {
-        "id": "stock",
-        "tools": {
-          "profile": "full",
-          "allow": ["tickflow-assist"],
-          "deny": []
-        }
-      }
-    ]
-  }
-}
-```
-
-单 Agent 默认模式示例：
-
-```json5
-{
-  "tools": {
-    "profile": "full",
-    "allow": ["tickflow-assist"],
-    "deny": []
-  }
-}
-```
-
-修改配置后建议执行：
-
-```bash
-openclaw config validate
-openclaw gateway restart
-```
-
-</details>
-
-## 6. 消息通道配置（可选）
-
-TickFlow Assist 当前通过 `openclaw message send` 投递告警，因此前提是目标通道本身已经能在 OpenClaw 中正常工作。
-
-统一接入步骤：
-
-1. 在 OpenClaw 里安装并配置目标通道。
-2. 在插件配置里填写 `alertChannel`、`alertAccount`、`alertTarget`。
-3. 重启 Gateway。
-4. 执行一次 `test_alert` 验证链路。
-
-识别 `alertTarget` 的通用方法：
-
-- 如果目标通道支持 `/whoami`，优先在目标会话里给机器人发送 `/whoami`。
-- 直接读取返回的 `User id`、`chatId` 或其它会话标识。
-- 再按对应通道的 target 格式写入 `alertTarget`。
-- 如果该通道没有 `/whoami`，再查看官方项目说明或插件日志。
-
-通道差异速查：
-
-| 通道 | 官方项目 / 接入方式 | `alertAccount` | `alertTarget` 示例 | 说明 |
-|---|---|---|---|---|
-| `telegram` | `openclaw channels add --channel telegram` | 通常留空 | `-1001234567890` | 直接使用群组 / 会话 ID |
-| `discord` | `openclaw channels add --channel discord` | 通常留空 | `user:1234567890` | 优先在目标会话发送 `/whoami`，读取 `User id`，拼装成 `user:User id` |
-| `qqbot`（QQ机器人） | [@tencent-connect/openclaw-qqbot](https://www.npmjs.com/package/@tencent-connect/openclaw-qqbot) | 推荐 `default` | `qqbot:c2c:YOUR_OPENID` | 优先在目标会话发送 `/whoami`，读取 `User id` |
-| `wecom`（企业微信） | [@wecom/wecom-openclaw-plugin](https://www.npmjs.com/package/@wecom/wecom-openclaw-plugin) | 常见为 `default` | `YOUR_USER_ID_OR_CHAT_ID` | 优先在目标会话发送 `/whoami`，再区分单聊 `userId` / 群聊 `chatId` |
-| `weixin`（微信） | [@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin) | 视插件配置 | `YOUR_TARGET` | 预留通道，当前 TickFlow Assist 尚未做专门适配，建议先用 `test_alert` 验证 |
-
-配置示例：
-
-```json5
-{
-  "alertChannel": "qqbot",
-  "alertAccount": "default",
-  "alertTarget": "qqbot:c2c:YOUR_OPENID"
-}
-```
-
-如果你同时使用 `npm run tool -- test_alert` 做本地调试，记得把同样的通道字段也写进 `local.config.json.plugin`。
-
-<details>
-<summary>QQBot 补充</summary>
-
-官方项目：[@tencent-connect/openclaw-qqbot](https://www.npmjs.com/package/@tencent-connect/openclaw-qqbot)
-
-- 先按官方项目完成安装与通道接入，再回到 TickFlow Assist 填写 `alertChannel: "qqbot"`、`alertAccount: "default"`、`alertTarget: "qqbot:c2c:YOUR_OPENID"`。
-- 私聊场景常用 target 格式为 `qqbot:c2c:YOUR_OPENID`。
-- target 获取方式沿用上面的通用 `/whoami` 说明；如果当前版本没有该命令，再查看官方说明或插件日志。
-
-</details>
-
-<details>
-<summary>WeCom 补充</summary>
-
-官方项目：[@wecom/wecom-openclaw-plugin](https://www.npmjs.com/package/@wecom/wecom-openclaw-plugin)
-
-- 先按官方项目完成安装与通道接入，再回到 TickFlow Assist 填写 `alertChannel: "wecom"`、`alertAccount` 和 `alertTarget`。
-- `alertTarget` 单聊填写 `userId`；群聊填写 `chatId`。
-- target 获取方式沿用上面的通用 `/whoami` 说明；如果当前版本没有该命令，再查看官方说明。
-
-</details>
-
-<details>
-<summary>Weixin 补充</summary>
-
-官方项目：[@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)
-
-- 当前 TickFlow Assist 还没有针对 `weixin` 做专门适配。
-- 当前实测中，`@tencent-weixin/openclaw-weixin` 通过 `openclaw message send` 主动发送时仍可能要求额外的 `contextToken`；因此即使已拿到 `alertTarget`，`test_alert`、监控告警、日更通知也仍可能失败。
-- 如果出现 `sendWeixinOutbound: contextToken is required`，说明当前版本暂时不适合作为 TickFlow Assist 的后台主动告警通道，建议先仅将微信作为 OpenClaw 对话入口使用，待官方插件后续更新后再启用主动告警推送。
-- 建议先执行一次 `test_alert`，确认当前插件版本与目标链路是否兼容。
-
-</details>
-
-## 7. 运维与日常管理
-
-### 7.1 重启与验收
-
-完成安装或修改配置后，建议按下面顺序做一次验收：
-
-```bash
-openclaw plugins info tickflow-assist
-openclaw plugins doctor
-openclaw config validate
-openclaw gateway restart
-openclaw channels status --probe
-```
-
-然后验证告警链路：
-
-```bash
-npm run tool -- test_alert
-```
-
-或者直接在 OpenClaw 对话里发送“测试告警”。
-
-### 7.2 升级
-
-推荐继续使用安装向导，在菜单里选择“升级”。
-
-从 `v0.1.0` 升到 `v0.2.0` 时，默认也走这条直接升级路径即可；不需要先卸载。
-
-如果你更喜欢手动更新：
-
-```bash
-cd /path/to/tickflow-assist
-git pull
-npm install
-cd python
-uv sync
-cd ..
-npm run check
-npm run build
-openclaw plugins install -l /path/to/tickflow-assist
-openclaw plugins enable tickflow-assist
-openclaw gateway restart
-```
-
-### 7.3 禁用、重装与清理
-
-禁用插件：
-
-```bash
-openclaw plugins disable tickflow-assist
-openclaw gateway restart
-```
-
-如果不再需要插件配置，再从 `~/.openclaw/openclaw.json` 删除：
-
-```text
-plugins.entries["tickflow-assist"]
-```
-
-重新安装通常只在这两类场景需要：
-
-- 你要更换插件源码目录
-- OpenClaw 里残留了旧的同名安装来源，直接升级后仍指向错误路径
-
-确实需要重装时再执行：
-
-```bash
-openclaw plugins install -l /path/to/tickflow-assist
-openclaw plugins enable tickflow-assist
-openclaw gateway restart
-```
-
-如果你是为了“从零开始测试”，可按需手动删除 `/path/to/tickflow-assist/data/lancedb`。这只会清空本地数据库，不会删除源码。

package/docs/usage.md

@@ -1,244 +0,0 @@
-# TickFlow Assist 使用指南
-
-本文档聚焦于日常使用、调试入口与关键运行规则。安装与配置请参阅 [安装指南](installation.md)。项目概览请先看 [README](../README.md)。
-
-## 1. 使用入口
-
-| 入口 | 适合场景 | 说明 |
-|---|---|---|
-| OpenClaw 对话 | 日常使用 | 直接用自然语言操作自选、分析、监控和数据库查询 |
-| `/ta_` Slash Command | 零歧义操作 | 插件直接处理，不经过 AI 推理 |
-| `npm run tool -- ...` / loop | 本地调试、VPS 直连 | 读取 `local.config.json.plugin`，适合排障和脚本化调用 |
-
-## 2. 对话常用指令
-
-下面的说法是推荐示例，不要求逐字一致；表达清楚股票代码和动作即可。
-
-### 自选管理
-
-| 指令示例 | 功能 |
-|---|---|
-| `添加 002261` | 添加股票到关注列表，成本价可后续补充 |
-| `添加 002261 成本 34.15` | 添加股票并记录成本价 |
-| `查看关注列表` | 查看当前自选、名称与成本价 |
-| `删除 002261` | 从关注列表移除股票 |
-| `刷新自选股名称` | 批量刷新关注股票名称 |
-
-### 数据获取与检索
-
-| 指令示例 | 功能 |
-|---|---|
-| `更新 002261 数据` | 抓取最新日 K 并重算日线指标 |
-| `获取 002261 1m 分钟K` | 抓取分钟 K 并写入数据库 |
-| `搜索立讯精密最新研报` | 搜索资讯、公告、研报或事件解读 |
-| `找今日涨幅 2% 的股票` | 用自然语言条件执行智能选股 |
-
-### 分析与复盘
-
-| 指令示例 | 功能 |
-|---|---|
-| `分析 002261` | 执行综合分析，汇总技术面、财务面和资讯面 |
-| `查看 002261 上次分析` | 回看最近一次综合分析 |
-| `查看 002261 最近 3 次综合分析` | 回看最近几次综合分析 |
-| `查看 002261 技术面分析` | 回看最近一次技术面结果 |
-| `查看 002261 基本面分析` | 回看最近一次财务面结果 |
-| `查看 002261 资讯面分析` | 回看最近一次资讯面结果 |
-| `回测 002261 最近 5 次关键位快照` | 回测关键价位快照的命中情况 |
-
-如需查看更多历史，也可以直接说“查看 002261 最近 3 次技术面分析”“查看 002261 最近 3 次资讯面分析”。
-
-### 后台维护与排障
-
-| 指令示例 | 功能 |
-|---|---|
-| `开始监控` | 启动实时监控 |
-| `监控状态` | 查看监控状态、最新行情与关键价位覆盖情况 |
-| `启动定时日更` | 启动项目自管的定时日更进程 |
-| `TickFlow日更状态` | 查看日更进程状态与最近执行结果 |
-| `停止定时日更` | 停止日更进程 |
-| `停止监控` | 停止实时监控 |
-| `测试告警` | 验证 OpenClaw channel 投递链路 |
-| `使用帮助` | 查看插件常用指令 |
-| `数据库里有哪些表` | 查看 LanceDB 当前数据表 |
-| `看技术指标表结构` | 查看数据库表字段结构 |
-| `查 002261 最近 5 条技术指标` | 查询数据库中的最近记录 |
-
-## 3. Slash Commands
-
-插件当前注册了 17 个 `/ta_` 直达命令，适合“添加自选”“查状态”“发测试告警”这类不需要模型解释的操作。
-
-### 自选管理
-
-| 命令 | 说明 |
-|---|---|
-| `/ta_addstock <symbol> [costPrice] [count]` | 添加自选，并抓取默认 90 天日 K |
-| `/ta_rmstock <symbol>` | 删除自选 |
-| `/ta_watchlist` | 查看自选列表 |
-| `/ta_refreshnames` | 刷新股票名称 |
-| `/ta_refreshprofiles [symbol]` | 刷新行业分类与概念板块 |
-
-### 分析与复盘
-
-| 命令 | 说明 |
-|---|---|
-| `/ta_analyze <symbol>` | 直接执行综合分析 |
-| `/ta_viewanalysis <symbol>` | 查看最近一次综合分析 |
-| `/ta_backtest [symbol] [recentLimit]` | 回测活动关键价位快照，可按股票与最近次数过滤 |
-
-### 后台维护与调试
-
-| 命令 | 说明 |
-|---|---|
-| `/ta_startmonitor` | 启动实时监控 |
-| `/ta_stopmonitor` | 停止实时监控 |
-| `/ta_monitorstatus` | 查看监控状态 |
-| `/ta_startdailyupdate` | 启动定时日更 |
-| `/ta_stopdailyupdate` | 停止定时日更 |
-| `/ta_updateall` | 立即执行一次完整日更 |
-| `/ta_dailyupdatestatus` | 查看定时日更状态 |
-| `/ta_testalert` | 发送一条测试告警 |
-| `/ta_debug` | 查看插件进程当前看到的配置来源、数据库路径与 watchlist 快照 |
-
-常用示例：
-
-```text
-/ta_addstock 601872
-/ta_addstock 002261 34.15
-/ta_watchlist
-/ta_analyze 002261
-/ta_viewanalysis 002261
-/ta_backtest 002261 5
-/ta_startmonitor
-/ta_monitorstatus
-/ta_dailyupdatestatus
-/ta_testalert
-```
-
-使用提示：
-
-- `/ta_addstock` 的第二个参数是 `costPrice`，第三个参数才是日 K 数量；如果只写两个参数，第二个数字会被当作成本价。
-- `/ta_viewanalysis` 只看最近一次综合分析；如果你要看技术面、资讯面或最近 N 次历史，优先用自然语言或 CLI 的 `view_analysis`。
-- `/ta_backtest` 不带参数时会输出整体回测概览，带 `symbol` 和 `recentLimit` 时会更聚焦。
-- `/ta_debug` 适合排查“OpenClaw 对话能看到的状态”和“CLI 看到的状态”不一致的问题。
-
-## 4. CLI 与本地直连调试
-
-`npm run tool -- ...`、`npm run monitor-loop` 与 `npm run daily-update-loop` 读取的是项目根目录 `local.config.json` 的 `plugin` 字段，不会回退到 `~/.openclaw/openclaw.json`。
-
-推荐配置结构：
-
-```json
-{
-  "plugin": {
-    "tickflowApiUrl": "https://api.tickflow.org",
-    "tickflowApiKey": "sk-xxx",
-    "mxSearchApiUrl": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-    "mxSearchApiKey": "mkt_xxx",
-    "llmBaseUrl": "https://api.openai.com/v1",
-    "llmApiKey": "sk-xxx",
-    "llmModel": "gpt-4o",
-    "databasePath": "./data/lancedb",
-    "calendarFile": "./day_future.txt",
-    "requestInterval": 30,
-    "alertChannel": "telegram",
-    "openclawCliBin": "openclaw",
-    "alertAccount": "",
-    "alertTarget": "YOUR_TARGET",
-    "pythonBin": "uv",
-    "pythonArgs": ["run", "python"],
-    "pythonWorkdir": "./python"
-  }
-}
-```
-
-### 常用命令
-
-基础验证：
-
-```bash
-npm run tool -- test_alert
-npm run tool -- add_stock '{"symbol":"002261","costPrice":34.154}'
-npm run tool -- fetch_klines '{"symbol":"002261","count":90}'
-npm run tool -- fetch_intraday_klines '{"symbol":"002261","period":"1m","count":240}'
-npm run tool -- analyze '{"symbol":"002261"}'
-```
-
-分析回看与检索：
-
-```bash
-npm run tool -- view_analysis '{"symbol":"002261"}'
-npm run tool -- view_analysis '{"symbol":"002261","limit":3}'
-npm run tool -- view_analysis '{"symbol":"002261","profile":"technical","limit":3}'
-npm run tool -- backtest_key_levels '{"symbol":"002261","recentLimit":5}'
-npm run tool -- mx_search '{"query":"立讯精密最新研报","limit":5}'
-npm run tool -- mx_select_stock '{"keyword":"今日涨幅2%的股票","pageNo":1,"pageSize":20}'
-```
-
-后台与循环：
-
-```bash
-npm run tool -- start_monitor
-npm run tool -- monitor_status
-npm run tool -- stop_monitor
-npm run tool -- start_daily_update
-npm run tool -- daily_update_status
-npm run tool -- stop_daily_update
-npm run tool -- update_all
-npm run monitor-loop
-npm run daily-update-loop
-```
-
-## 5. 运行规则与关键机制
-
-### 监控告警阈值
-
-| 告警类型 | 触发条件 | 说明 |
-|---|---|---|
-| 止损告警 | `价格 <= 止损位` | 触及止损位 |
-| 止损预警 | `价格 <= 止损位 × 1.005` | 接近止损位 |
-| 突破告警 | `价格 >= 突破位` | 突破关键压力位 |
-| 支撑告警 | `价格 <= 支撑位 × 1.005` | 接近支撑位 |
-| 压力告警 | `价格 >= 压力位 × 0.995` | 接近压力位 |
-| 止盈告警 | `价格 >= 止盈位` | 达到止盈位 |
-| 涨跌幅异动 | `绝对涨跌幅 >= 5%` | 基于昨收计算 |
-| 成交量异动 | `当前量 >= 5 日均量 × 3` | 放量异动 |
-
-### 数据来源与降级逻辑
-
-| 场景 | 当前行为 |
-|---|---|
-| `analyze` | 读取本地日 K、日线指标，并临时补充分钟 K、分钟指标、实时行情和历史复盘摘要 |
-| 财务面（Expert） | 优先使用 TickFlow 完整财务快照 |
-| 财务面（非 Expert / TickFlow 完整财务失败） | 回退到 `mx_select_stock` 的 lite 指标链路 |
-| 财务面仍不可用 | 财务子任务返回降级结果，但综合分析继续执行 |
-| 资讯面不可用 | 资讯子任务返回降级结果，但综合分析继续执行 |
-| 分钟 K 保留策略 | `analyze` / `update_all` 会保留近 30 个交易日；单独执行 `fetch_intraday_klines` 会保留近 10 个交易日 |
-
-### 后台运行规则
-
-| 项目 | 说明 |
-|---|---|
-| 实时监控时段 | `09:30-11:30`、`13:00-15:00` |
-| 阶段通知 | 上午开盘、上午收盘、下午开盘、当日收盘各发送一次 |
-| `update_all` | 面向收盘后手动补跑流程，会先执行日更，再立即执行一次复盘 |
-| 定时日更轮询 | 按 15 分钟对齐轮询，交易日 `15:25` 后最多执行一次 |
-| 定时收盘复盘轮询 | 按 15 分钟对齐轮询，交易日 `20:00` 后最多执行一次 |
-| `monitor_status` | 显示运行方式、最近心跳、最新行情与关键位覆盖情况 |
-| `daily_update_status` | 显示运行方式、配置来源、最近心跳，以及日更/复盘两类最近执行结果 |
-
-## 6. 主要数据表
-
-| 表名 | 用途 |
-|---|---|
-| `watchlist` | 自选列表、成本价、行业分类、概念板块 |
-| `klines_daily` | 日 K 数据 |
-| `klines_intraday` | 分钟 K 数据 |
-| `indicators` | 技术指标 |
-| `key_levels` / `key_levels_history` | 当前关键价位与历史快照 |
-| `technical_analysis` / `financial_analysis` / `news_analysis` / `composite_analysis` | 多维分析结果 |
-| `analysis_log` / `alert_log` | 分析日志与告警留痕 |
-
-## 7. 高优先级注意事项
-
-- 正式插件读取 `~/.openclaw/openclaw.json`；CLI 与本地 loop 读取 `local.config.json.plugin`，两者不会自动同步。
-- 未配置 `mxSearchApiKey` 时，`mx_search` / `mx_select_stock` 不可用，非 Expert 财务链路的 lite 回退也会失效。