stock-analysis-plugin 0.1.14 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -19
- package/package.json +3 -2
- package/pi/index.ts +219 -44
- package/skills/bottom-volume/SKILL.md +1 -4
- package/skills/bottom-volume/scripts/gather.py +1 -1
- package/skills/box-oscillation/SKILL.md +1 -4
- package/skills/box-oscillation/scripts/gather.py +1 -1
- package/skills/bull-trend/SKILL.md +1 -4
- package/skills/bull-trend/scripts/gather.py +1 -1
- package/skills/chan-theory/SKILL.md +1 -4
- package/skills/chan-theory/scripts/gather.py +1 -1
- package/skills/dragon-head/SKILL.md +24 -28
- package/skills/dragon-head/scripts/gather.py +1 -1
- package/skills/emotion-cycle/SKILL.md +19 -33
- package/skills/emotion-cycle/scripts/gather.py +4 -3
- package/skills/event-driven/SKILL.md +42 -26
- package/skills/event-driven/scripts/gather.py +1 -1
- package/skills/expectation-repricing/SKILL.md +11 -6
- package/skills/expectation-repricing/scripts/gather.py +1 -1
- package/skills/growth-quality/SKILL.md +11 -6
- package/skills/growth-quality/scripts/gather.py +1 -1
- package/skills/hot-theme/SKILL.md +27 -23
- package/skills/hot-theme/scripts/gather.py +1 -1
- package/skills/ma-crossover/SKILL.md +1 -4
- package/skills/ma-crossover/scripts/gather.py +1 -1
- package/skills/market-review/SKILL.md +11 -8
- package/skills/market-review/scripts/gather.py +1 -1
- package/skills/one-yang-three-yin/SKILL.md +1 -4
- package/skills/one-yang-three-yin/scripts/gather.py +1 -1
- package/skills/shrink-pullback/SKILL.md +1 -4
- package/skills/shrink-pullback/scripts/gather.py +1 -1
- package/skills/stock-analysis/SKILL.md +18 -77
- package/skills/stock-analysis/references/short-term-trading.md +78 -0
- package/skills/stock-analysis/scripts/gather.py +1 -1
- package/skills/stock-screener/SKILL.md +7 -6
- package/skills/stock-screener/scripts/gather.py +1 -1
- package/skills/strategy-backtest/SKILL.md +24 -20
- package/skills/strategy-backtest/scripts/gather.py +1 -1
- package/skills/volume-breakout/SKILL.md +21 -23
- package/skills/volume-breakout/scripts/gather.py +1 -1
- package/skills/wave-theory/SKILL.md +1 -4
- package/skills/wave-theory/scripts/gather.py +1 -1
- package/skills/wisburg-research/SKILL.md +2 -2
- package/tools/alert_rules.py +5 -18
- package/tools/backtest.py +4 -4
- package/tools/capabilities.py +11 -4
- package/tools/diagnostics.py +13 -2
- package/tools/gather.py +12 -31
- package/tools/market_regime.py +4 -1
- package/tools/market_review.py +1 -1
- package/tools/name_resolver.py +4 -10
- package/tools/pattern.py +3 -24
- package/tools/report_renderer.py +1 -2
- package/tools/screener.py +2 -16
- package/tools/search_intel.py +1 -24
- package/tools/signal_tracker.py +275 -0
- package/tools/stock_data.py +704 -167
- package/tools/trading_calendar.py +92 -7
- package/tools/volume_analysis.py +3 -23
- package/tools/watchlist_context.py +1 -10
- package/scripts/sync-version.sh +0 -56
package/README.md
CHANGED
|
@@ -31,10 +31,10 @@ A 股 / 港股 / 美股 / 日股 / 韩股 / 台股综合分析、多因子选股
|
|
|
31
31
|
|
|
32
32
|
## 功能概览
|
|
33
33
|
|
|
34
|
-
- **
|
|
34
|
+
- **48 个工具** — 行情数据、技术分析、K 线形态、资金流向、财务指标、新闻舆情、风险筛查、市场状态等
|
|
35
35
|
- **20 个 Skills** — 综合分析、全市场选股、策略回测 + 17 个策略方法论(缠论、波浪、龙头、情绪周期等)
|
|
36
|
-
- **策略回测引擎** — YAML DSL
|
|
37
|
-
- **多数据源 Failover** —
|
|
36
|
+
- **策略回测引擎** — YAML DSL 定义策略,参数化条件组合,自动诊断,按需进行有限轮参数优化
|
|
37
|
+
- **多数据源 Failover** — 11 个数据源自动容灾切换(akshare / tushare / efinance / 腾讯行情 / 新浪行情 / pytdx / baostock / yfinance / finnhub / longbridge / alphavantage),A 股链路带粘性优选(最近成功的数据源下次优先尝试)
|
|
38
38
|
- **社交舆情增强** — A 股(东财股吧 + 雪球)/ 美港股(Reddit / X / Polymarket),市场自动路由
|
|
39
39
|
- **四平台适配** — 同一套工具同时支持 Pi Agent、Hermes Agent、OpenClaw 和 dsh
|
|
40
40
|
|
|
@@ -92,7 +92,7 @@ register(ctx)
|
|
|
92
92
|
openclaw plugins install clawhub:@weaxs/openclaw-stock-analysis
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
OpenClaw Gateway 启动后自动加载并注册
|
|
95
|
+
OpenClaw Gateway 启动后自动加载并注册 48 个 tool。安装时 postinstall 会自动建 `.venv` 并装好 Python 依赖(前提:本机有 `python3 >= 3.9`)。
|
|
96
96
|
|
|
97
97
|
详见 [OpenClaw 接入指南](docs/openclaw-integration.md),或 plugin 自身说明 [`openclaw/README.md`](openclaw/README.md)。
|
|
98
98
|
|
|
@@ -103,7 +103,7 @@ dsh plugin --profile <你的profile> add @weaxs/dsh-stock-analysis
|
|
|
103
103
|
dsh --profile <你的profile>
|
|
104
104
|
```
|
|
105
105
|
|
|
106
|
-
作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册
|
|
106
|
+
作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册 48 个 tool + 20 个 skill。postinstall 自动建 `.venv`(pnpm 需在 profile 的 `pnpm-workspace.yaml` 里给本包配 `allowBuilds`,否则回退系统 `python3`)。
|
|
107
107
|
|
|
108
108
|
详见 [`dsh/README.md`](dsh/README.md)。
|
|
109
109
|
|
|
@@ -126,6 +126,8 @@ pip install -r tools/requirements.txt
|
|
|
126
126
|
| pytdx | A 股 TDX 行情(免费兜底源) |
|
|
127
127
|
| longport | 港股 / 美股 Longbridge SDK |
|
|
128
128
|
|
|
129
|
+
> A 股行情另有**腾讯(qt.gtimg.cn)/ 新浪(hq.sinajs.cn)**两个免鉴权兜底源,不依赖任何 Python 包(直接 HTTP 调用),用于东财域名不可达的网络环境(境外主机、企业出网限制等)。
|
|
130
|
+
|
|
129
131
|
### 环境变量
|
|
130
132
|
|
|
131
133
|
**数据源(可选,配置后自动加入 Failover 链):**
|
|
@@ -203,9 +205,9 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
203
205
|
|-------|----------|------|
|
|
204
206
|
| 综合分析 | `/skill:stock-analysis` | 技术面 + 基本面 + 资金面 + 消息面多维研判,输出结构化研报 |
|
|
205
207
|
| 全市场选股 | `/skill:stock-screener` | L1 多因子硬筛(市场情绪调节,可选 `--l2` 量化增强)→ L2 LLM 智能排序 → 输出推荐列表 |
|
|
206
|
-
| 策略回测 | `/skill:strategy-backtest` | YAML 策略定义 → 回测 →
|
|
208
|
+
| 策略回测 | `/skill:strategy-backtest` | YAML 策略定义 → 回测 → 诊断;按需进行最多 3 轮参数优化 |
|
|
207
209
|
|
|
208
|
-
###
|
|
210
|
+
### 策略、复盘与研究(17 个)
|
|
209
211
|
|
|
210
212
|
| Skill | 调用方式 | 方法论 |
|
|
211
213
|
|-------|----------|--------|
|
|
@@ -220,7 +222,12 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
220
222
|
| 箱体震荡 | `/skill:box-oscillation` | 箱体区间识别 + 支撑压力间波段操作 |
|
|
221
223
|
| 情绪周期 | `/skill:emotion-cycle` | 市场情绪冰点 → 回暖 → 狂热 → 退潮周期判断 |
|
|
222
224
|
| 一阳穿三阴 | `/skill:one-yang-three-yin` | K 线形态识别 + 反转信号质量评级 |
|
|
223
|
-
|
|
|
225
|
+
| 事件驱动 | `/skill:event-driven` | 公告/政策/业绩事件的影响路径与失效条件 |
|
|
226
|
+
| 预期重估 | `/skill:expectation-repricing` | 市场预期与实际数据的偏差 |
|
|
227
|
+
| 成长质量 | `/skill:growth-quality` | 收入、利润、现金流与盈利能力的多期验证 |
|
|
228
|
+
| 热点题材 | `/skill:hot-theme` | 板块强度、扩散度、关联度与节奏 |
|
|
229
|
+
| 市场复盘 | `/skill:market-review` | 指数、宽度、板块、温度与次日策略 |
|
|
230
|
+
| Wisburg 投研 | `/skill:wisburg-research` | 检索机构研报、公告、电话会纪要和市场日报 |
|
|
224
231
|
|
|
225
232
|
## 工具列表
|
|
226
233
|
|
|
@@ -236,10 +243,13 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
236
243
|
| `get_stock_info` | 股票基本信息 |
|
|
237
244
|
| `get_chip_distribution` | 筹码分布 |
|
|
238
245
|
| `get_market_indices` | 主要指数行情 |
|
|
239
|
-
| `get_sector_rankings` |
|
|
246
|
+
| `get_sector_rankings` | 板块涨跌排行(行业/概念) |
|
|
240
247
|
| `get_sector_constituents` | 板块成分股查询(仅 A 股,板块名模糊匹配) |
|
|
241
248
|
| `resolve_stock_sectors` | 个股所属板块查询(A 股行业+概念 / 港股 GICS) |
|
|
242
249
|
| `get_market_stats` | 市场统计(涨跌家数、涨停等) |
|
|
250
|
+
| `get_limit_up_pool` | 涨停池/涨停板复盘(连板数、封板资金、炸板次数等,仅 A 股) |
|
|
251
|
+
| `get_dragon_tiger` | 龙虎榜(净买额/上榜原因/解读,仅 A 股) |
|
|
252
|
+
| `get_hot_stocks` | 全市场人气热搜榜(东财→雪球→百度,仅 A 股) |
|
|
243
253
|
| `get_fundamental_context` | 基本面综合上下文 |
|
|
244
254
|
|
|
245
255
|
### 分析计算
|
|
@@ -251,6 +261,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
251
261
|
| `calculate_ma` | 多周期均线计算 |
|
|
252
262
|
| `get_volume_analysis` | 量价分析 |
|
|
253
263
|
| `evaluate_signal` | 历史信号胜率回测 |
|
|
264
|
+
| `detect_anomaly` | 当日技术、量价与资金异动扫描 |
|
|
254
265
|
|
|
255
266
|
### 筛选与回测
|
|
256
267
|
|
|
@@ -260,6 +271,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
260
271
|
| `screen_risk` | 风险因子筛查 |
|
|
261
272
|
| `run_backtest` | YAML 策略回测 |
|
|
262
273
|
| `detect_market_regime` | 市场状态检测(牛/熊/震荡) |
|
|
274
|
+
| `get_market_review` | 市场日度复盘数据 |
|
|
275
|
+
| `run_watchlist_analysis` | 批量自选股分析 |
|
|
263
276
|
|
|
264
277
|
### 搜索与舆情
|
|
265
278
|
|
|
@@ -268,7 +281,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
268
281
|
| `search_stock_news` | 关键词搜索新闻 |
|
|
269
282
|
| `search_comprehensive_intel` | 综合情报搜索 |
|
|
270
283
|
| `get_social_sentiment` | 社交媒体情绪(A 股:东财股吧 + 雪球;美港股:Reddit / X / Polymarket) |
|
|
271
|
-
| `get_trending_sentiment` | 社交媒体热门趋势聚合(Reddit / X / Polymarket
|
|
284
|
+
| `get_trending_sentiment` | 社交媒体热门趋势聚合(Reddit / X / Polymarket) |
|
|
272
285
|
| `extract_article` | 网页正文提取 |
|
|
273
286
|
|
|
274
287
|
### 辅助
|
|
@@ -278,6 +291,23 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
278
291
|
| `resolve_stock_name` | 股票名称 / 拼音模糊匹配 |
|
|
279
292
|
| `check_trading_day` | 查询是否交易日 |
|
|
280
293
|
| `get_trading_days` | 获取前后 N 个交易日 |
|
|
294
|
+
| `get_trading_phase` | 查询市场当前交易时段(盘前/盘中/盘后/休市) |
|
|
295
|
+
| `diagnose_data_sources` | 诊断数据源、环境变量和市场链路 |
|
|
296
|
+
| `get_market_capabilities` | 查询各市场支持的工具边界 |
|
|
297
|
+
| `parse_stock_list` | 从自然语言、CSV 或 Markdown 解析股票列表 |
|
|
298
|
+
|
|
299
|
+
### 上下文与报告
|
|
300
|
+
|
|
301
|
+
| 工具 | 说明 |
|
|
302
|
+
|------|------|
|
|
303
|
+
| `build_watchlist_context` | 构建自选股摘要与后续工具建议 |
|
|
304
|
+
| `analyze_position_context` | 结合成本、仓位与止损止盈分析持仓 |
|
|
305
|
+
| `check_alert_rules` | 无状态检查价格、涨跌幅、异动和风险规则 |
|
|
306
|
+
| `record_signal` | 记录 AI 分析建议信号(本地 JSONL 持久化) |
|
|
307
|
+
| `evaluate_signals` | 评估到期信号(target_hit/stop_hit/timeout 结算) |
|
|
308
|
+
| `get_signal_summary` | 信号胜率汇总(按 source/symbol/status 过滤) |
|
|
309
|
+
| `render_stock_report` | 将结构化个股报告渲染为 Markdown |
|
|
310
|
+
| `render_market_report` | 将结构化市场复盘渲染为 Markdown |
|
|
281
311
|
|
|
282
312
|
## 策略回测 DSL
|
|
283
313
|
|
|
@@ -343,8 +373,9 @@ position:
|
|
|
343
373
|
|
|
344
374
|
| 代码格式 | 示例 | 市场 | 数据源 Failover 链 |
|
|
345
375
|
|----------|------|------|---------------------|
|
|
346
|
-
| 6 位纯数字 | `600519`, `000001`, `300750` | A 股 | akshare → tushare → efinance → pytdx → baostock |
|
|
347
|
-
| 6 位纯数字(51/52/56/58/15/16/18 开头) | `510300`, `159915` | A 股 ETF | akshare(基金接口)→ tushare → efinance → pytdx → baostock |
|
|
376
|
+
| 6 位纯数字 | `600519`, `000001`, `300750` | A 股 | akshare → tushare → efinance → 腾讯 → 新浪 → pytdx → baostock |
|
|
377
|
+
| 6 位纯数字(51/52/56/58/15/16/18 开头) | `510300`, `159915` | A 股 ETF | akshare(基金接口)→ tushare → efinance → 腾讯 → 新浪 → pytdx → baostock |
|
|
378
|
+
| 带交易所前缀(`sh`/`sz`/`bj` + 6 位数字) | `sh000001`(上证指数), `sz399006`(创业板指) | A 股(显式指定,含指数) | 腾讯 → 新浪(K 线另有 baostock) |
|
|
348
379
|
| `.HK` 结尾 | `00700.HK`, `09988.HK` | 港股 | yfinance → finnhub → longbridge |
|
|
349
380
|
| 英文字母 | `AAPL`, `GOOGL`, `TSLA` | 美股 | yfinance → finnhub → longbridge → alphavantage |
|
|
350
381
|
| `.T` 结尾 | `7203.T` | 日股 | yfinance |
|
|
@@ -352,6 +383,8 @@ position:
|
|
|
352
383
|
| `.TW` / `.TWO` 结尾 | `2330.TW`, `6510.TWO` | 台股 | yfinance |
|
|
353
384
|
|
|
354
385
|
> 各数据源按优先级自动尝试,前一个失败后自动切换到下一个。未配置相关 env var 的数据源会被跳过。
|
|
386
|
+
> 裸 6 位代码一律按**个股**处理(`000001` 是平安银行);指数需带交易所前缀(`sh000001` = 上证指数),显式前缀代码直接走腾讯/新浪(东财源只认裸代码)。
|
|
387
|
+
> **粘性优选**:A 股链路(K 线 / 行情 / 市场快照 / 板块成分)会记住最近一次成功的数据源(缓存在系统临时目录,24h 有效),下次调用优先从它开始;若它已失效则自动顺延并更新记录。港美股链路不做粘性——一次 yfinance 瞬时失败不应让后续全天的 quote 降质。
|
|
355
388
|
> 日/韩/台股仅 yfinance 一个数据源(免费数据延迟约 15 分钟);港股 / 美股 / 日股 / 韩股 / 台股的 ETF 与其所在市场股票走相同链路。
|
|
356
389
|
|
|
357
390
|
## 独立 CLI 使用
|
|
@@ -399,23 +432,24 @@ python tools/market_regime.py detect A
|
|
|
399
432
|
```
|
|
400
433
|
stock-analysis/
|
|
401
434
|
├── pi/ # Pi Agent Extension
|
|
402
|
-
│ └── index.ts # 注册
|
|
435
|
+
│ └── index.ts # 注册 48 个工具 + 20 个 skill
|
|
403
436
|
├── hermes/ # Hermes Agent Plugin
|
|
404
437
|
│ ├── plugin.yaml # 插件清单
|
|
405
438
|
│ ├── __init__.py # register(ctx) 入口
|
|
406
439
|
│ ├── schemas.py # 工具 JSON Schema 定义
|
|
407
|
-
│ └── tools.py #
|
|
440
|
+
│ └── tools.py # 48 个 handler → subprocess 调 CLI
|
|
408
441
|
├── openclaw/ # OpenClaw Plugin
|
|
409
442
|
│ ├── openclaw.plugin.json # manifest(contracts.tools)
|
|
410
443
|
│ ├── package.json # 含 openclaw 块(pluginApi/SDK 版本)
|
|
411
|
-
│ └── index.ts # definePluginEntry + registerTool ×
|
|
444
|
+
│ └── index.ts # definePluginEntry + registerTool ×48
|
|
412
445
|
├── dsh/ # DeepSeek Harness (dsh) Plugin
|
|
413
446
|
│ ├── cordis.patch.yml # bundle patch(insert 插件入口)
|
|
414
447
|
│ ├── package.json # 含 dsh.bundle 块(bundle manifest)
|
|
415
|
-
│ └── index.ts # cordis apply(ctx) + defineTool ×
|
|
448
|
+
│ └── index.ts # cordis apply(ctx) + defineTool ×48
|
|
416
449
|
│
|
|
417
|
-
├── tools/ # 共享 Python CLI 工具(
|
|
418
|
-
│ ├── stock_data.py # 行情 / 资金流 / 新闻 / 财务
|
|
450
|
+
├── tools/ # 共享 Python CLI 工具(23 个脚本)
|
|
451
|
+
│ ├── stock_data.py # 行情 / 资金流 / 新闻 / 财务 / 短线情绪
|
|
452
|
+
│ ├── signal_tracker.py # AI 买卖建议回测闭环(本地 JSONL 存储)
|
|
419
453
|
│ ├── technical.py # 技术指标分析
|
|
420
454
|
│ ├── pattern.py # K 线形态识别
|
|
421
455
|
│ ├── screener.py # 全市场多因子筛选(含市场情绪调节,--l2 量化增强)
|
|
@@ -481,7 +515,7 @@ pip install -r tools/requirements.txt
|
|
|
481
515
|
|
|
482
516
|
### Q: A 股数据获取失败?
|
|
483
517
|
|
|
484
|
-
系统会自动按 akshare → tushare → efinance → pytdx → baostock
|
|
518
|
+
系统会自动按 akshare → tushare → efinance → 腾讯 → 新浪 → pytdx → baostock 顺序尝试(A 股链路含粘性优选:最近成功的源 24h 内优先)。腾讯 / 新浪源不依赖东财域名,在境外或受限网络下通常仍可用。如果所有源都失败,检查:网络问题、akshare 版本过低(`pip install --upgrade akshare`)、或非交易时间。配置 `TUSHARE_TOKEN` 可增加一个可靠数据源。
|
|
485
519
|
|
|
486
520
|
### Q: 港股 / 美股数据有延迟?
|
|
487
521
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "stock-analysis-plugin",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Pi Agent extension for stock analysis, screening, and strategy backtesting across A/HK/US markets",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./pi/index.ts",
|
|
@@ -39,7 +39,8 @@
|
|
|
39
39
|
"schemas/",
|
|
40
40
|
"templates/",
|
|
41
41
|
"strategies/",
|
|
42
|
-
"scripts/"
|
|
42
|
+
"scripts/",
|
|
43
|
+
"!scripts/sync-version.sh"
|
|
43
44
|
],
|
|
44
45
|
"scripts": {
|
|
45
46
|
"postinstall": "node scripts/setup-python.mjs",
|