tickflow-assist 0.2.0

package/docs/installation.md

@@ -0,0 +1,391 @@
+# 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
+
+如果你只是日常升级，重新运行同一条命令并在菜单里选择“升级”即可。更具体的升级与重装说明见下文 [6.2 升级](#62-升级) 与 [6.3 禁用重装与清理](#63-禁用重装与清理)。
+
+## 3. 手动安装
+
+### 3.1 拉取源码
+
+推荐把项目放在普通开发目录，不要放到 `~/.openclaw/workspace/...` 下面。
+
+```bash
+cd ~
+git clone https://github.com/robinspt/tickflow-assist.git
+cd tickflow-assist
+```
+
+### 3.2 安装依赖并构建
+
+```bash
+npm install
+cd python
+uv sync
+cd ..
+npm run check
+npm run build
+```
+
+### 3.3 安装并启用插件（源码安装）
+
+```bash
+openclaw plugins install -l /path/to/tickflow-assist
+openclaw plugins enable tickflow-assist
+```
+
+### 3.4 社区安装（npm / 社区插件）
+
+发布到 npm 后，社区安装不需要源码目录，也不需要 `setup-tickflow.sh`：
+
+```bash
+openclaw plugins install tickflow-assist
+npx -y tickflow-assist configure-openclaw
+```
+
+第二条命令会自动：
+
+- 写入 `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`。
+
+## 4. 插件配置
+
+正式插件运行读取：
+
+```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>
+
+## 5. 消息通道配置（可选）
+
+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 |
+| `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>
+
+## 6. 运维与日常管理
+
+### 6.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 对话里发送“测试告警”。
+
+### 6.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
+```
+
+### 6.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

@@ -0,0 +1,244 @@
+# 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 回退也会失效。