stock-analysis-plugin 0.1.14 → 0.1.15

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.
Files changed (47) hide show
  1. package/README.md +34 -8
  2. package/package.json +1 -1
  3. package/pi/index.ts +27 -27
  4. package/skills/bottom-volume/SKILL.md +1 -4
  5. package/skills/bottom-volume/scripts/gather.py +1 -1
  6. package/skills/box-oscillation/SKILL.md +1 -4
  7. package/skills/box-oscillation/scripts/gather.py +1 -1
  8. package/skills/bull-trend/SKILL.md +1 -4
  9. package/skills/bull-trend/scripts/gather.py +1 -1
  10. package/skills/chan-theory/SKILL.md +1 -4
  11. package/skills/chan-theory/scripts/gather.py +1 -1
  12. package/skills/dragon-head/SKILL.md +22 -28
  13. package/skills/dragon-head/scripts/gather.py +1 -1
  14. package/skills/emotion-cycle/SKILL.md +17 -33
  15. package/skills/emotion-cycle/scripts/gather.py +4 -3
  16. package/skills/event-driven/SKILL.md +42 -26
  17. package/skills/event-driven/scripts/gather.py +1 -1
  18. package/skills/expectation-repricing/SKILL.md +11 -6
  19. package/skills/expectation-repricing/scripts/gather.py +1 -1
  20. package/skills/growth-quality/SKILL.md +11 -6
  21. package/skills/growth-quality/scripts/gather.py +1 -1
  22. package/skills/hot-theme/SKILL.md +25 -22
  23. package/skills/hot-theme/scripts/gather.py +1 -1
  24. package/skills/ma-crossover/SKILL.md +1 -4
  25. package/skills/ma-crossover/scripts/gather.py +1 -1
  26. package/skills/market-review/SKILL.md +11 -8
  27. package/skills/market-review/scripts/gather.py +1 -1
  28. package/skills/one-yang-three-yin/SKILL.md +1 -4
  29. package/skills/one-yang-three-yin/scripts/gather.py +1 -1
  30. package/skills/shrink-pullback/SKILL.md +1 -4
  31. package/skills/shrink-pullback/scripts/gather.py +1 -1
  32. package/skills/stock-analysis/SKILL.md +12 -79
  33. package/skills/stock-analysis/references/short-term-trading.md +78 -0
  34. package/skills/stock-analysis/scripts/gather.py +1 -1
  35. package/skills/stock-screener/SKILL.md +7 -6
  36. package/skills/stock-screener/scripts/gather.py +1 -1
  37. package/skills/strategy-backtest/SKILL.md +24 -20
  38. package/skills/strategy-backtest/scripts/gather.py +1 -1
  39. package/skills/volume-breakout/SKILL.md +21 -23
  40. package/skills/volume-breakout/scripts/gather.py +1 -1
  41. package/skills/wave-theory/SKILL.md +1 -4
  42. package/skills/wave-theory/scripts/gather.py +1 -1
  43. package/skills/wisburg-research/SKILL.md +2 -2
  44. package/tools/capabilities.py +3 -4
  45. package/tools/diagnostics.py +13 -2
  46. package/tools/market_regime.py +4 -1
  47. package/tools/stock_data.py +317 -75
package/README.md CHANGED
@@ -33,8 +33,8 @@ A 股 / 港股 / 美股 / 日股 / 韩股 / 台股综合分析、多因子选股
33
33
 
34
34
  - **41 个工具** — 行情数据、技术分析、K 线形态、资金流向、财务指标、新闻舆情、风险筛查、市场状态等
35
35
  - **20 个 Skills** — 综合分析、全市场选股、策略回测 + 17 个策略方法论(缠论、波浪、龙头、情绪周期等)
36
- - **策略回测引擎** — YAML DSL 定义策略,参数化条件组合,自动诊断 + LLM 变异优化
37
- - **多数据源 Failover** — 9 个数据源自动容灾切换(akshare / tushare / efinance / pytdx / baostock / yfinance / finnhub / longbridge / alphavantage)
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
 
@@ -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 策略定义 → 回测 → 诊断 → LLM 变异优化 → 迭代 |
208
+ | 策略回测 | `/skill:strategy-backtest` | YAML 策略定义 → 回测 → 诊断;按需进行最多 3 轮参数优化 |
207
209
 
208
- ### 策略方法论(12 个)
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
- | Wisburg 研报 | `/skill:wisburg-research` | 结构化投研报告生成 |
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
 
@@ -251,6 +258,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
251
258
  | `calculate_ma` | 多周期均线计算 |
252
259
  | `get_volume_analysis` | 量价分析 |
253
260
  | `evaluate_signal` | 历史信号胜率回测 |
261
+ | `detect_anomaly` | 当日技术、量价与资金异动扫描 |
254
262
 
255
263
  ### 筛选与回测
256
264
 
@@ -260,6 +268,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
260
268
  | `screen_risk` | 风险因子筛查 |
261
269
  | `run_backtest` | YAML 策略回测 |
262
270
  | `detect_market_regime` | 市场状态检测(牛/熊/震荡) |
271
+ | `get_market_review` | 市场日度复盘数据 |
272
+ | `run_watchlist_analysis` | 批量自选股分析 |
263
273
 
264
274
  ### 搜索与舆情
265
275
 
@@ -278,6 +288,19 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
278
288
  | `resolve_stock_name` | 股票名称 / 拼音模糊匹配 |
279
289
  | `check_trading_day` | 查询是否交易日 |
280
290
  | `get_trading_days` | 获取前后 N 个交易日 |
291
+ | `diagnose_data_sources` | 诊断数据源、环境变量和市场链路 |
292
+ | `get_market_capabilities` | 查询各市场支持的工具边界 |
293
+ | `parse_stock_list` | 从自然语言、CSV 或 Markdown 解析股票列表 |
294
+
295
+ ### 上下文与报告
296
+
297
+ | 工具 | 说明 |
298
+ |------|------|
299
+ | `build_watchlist_context` | 构建自选股摘要与后续工具建议 |
300
+ | `analyze_position_context` | 结合成本、仓位与止损止盈分析持仓 |
301
+ | `check_alert_rules` | 无状态检查价格、涨跌幅、异动和风险规则 |
302
+ | `render_stock_report` | 将结构化个股报告渲染为 Markdown |
303
+ | `render_market_report` | 将结构化市场复盘渲染为 Markdown |
281
304
 
282
305
  ## 策略回测 DSL
283
306
 
@@ -343,8 +366,9 @@ position:
343
366
 
344
367
  | 代码格式 | 示例 | 市场 | 数据源 Failover 链 |
345
368
  |----------|------|------|---------------------|
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 |
369
+ | 6 位纯数字 | `600519`, `000001`, `300750` | A 股 | akshare → tushare → efinance → 腾讯 → 新浪 → pytdx → baostock |
370
+ | 6 位纯数字(51/52/56/58/15/16/18 开头) | `510300`, `159915` | A 股 ETF | akshare(基金接口)→ tushare → efinance → 腾讯 → 新浪 → pytdx → baostock |
371
+ | 带交易所前缀(`sh`/`sz`/`bj` + 6 位数字) | `sh000001`(上证指数), `sz399006`(创业板指) | A 股(显式指定,含指数) | 腾讯 → 新浪(K 线另有 baostock) |
348
372
  | `.HK` 结尾 | `00700.HK`, `09988.HK` | 港股 | yfinance → finnhub → longbridge |
349
373
  | 英文字母 | `AAPL`, `GOOGL`, `TSLA` | 美股 | yfinance → finnhub → longbridge → alphavantage |
350
374
  | `.T` 结尾 | `7203.T` | 日股 | yfinance |
@@ -352,6 +376,8 @@ position:
352
376
  | `.TW` / `.TWO` 结尾 | `2330.TW`, `6510.TWO` | 台股 | yfinance |
353
377
 
354
378
  > 各数据源按优先级自动尝试,前一个失败后自动切换到下一个。未配置相关 env var 的数据源会被跳过。
379
+ > 裸 6 位代码一律按**个股**处理(`000001` 是平安银行);指数需带交易所前缀(`sh000001` = 上证指数),显式前缀代码直接走腾讯/新浪(东财源只认裸代码)。
380
+ > **粘性优选**:A 股链路(K 线 / 行情 / 市场快照 / 板块成分)会记住最近一次成功的数据源(缓存在系统临时目录,24h 有效),下次调用优先从它开始;若它已失效则自动顺延并更新记录。港美股链路不做粘性——一次 yfinance 瞬时失败不应让后续全天的 quote 降质。
355
381
  > 日/韩/台股仅 yfinance 一个数据源(免费数据延迟约 15 分钟);港股 / 美股 / 日股 / 韩股 / 台股的 ETF 与其所在市场股票走相同链路。
356
382
 
357
383
  ## 独立 CLI 使用
@@ -481,7 +507,7 @@ pip install -r tools/requirements.txt
481
507
 
482
508
  ### Q: A 股数据获取失败?
483
509
 
484
- 系统会自动按 akshare → tushare → efinance → pytdx → baostock 顺序尝试。如果所有源都失败,检查:网络问题、akshare 版本过低(`pip install --upgrade akshare`)、或非交易时间。配置 `TUSHARE_TOKEN` 可增加一个可靠数据源。
510
+ 系统会自动按 akshare → tushare → efinance → 腾讯 → 新浪 → pytdx → baostock 顺序尝试(A 股链路含粘性优选:最近成功的源 24h 内优先)。腾讯 / 新浪源不依赖东财域名,在境外或受限网络下通常仍可用。如果所有源都失败,检查:网络问题、akshare 版本过低(`pip install --upgrade akshare`)、或非交易时间。配置 `TUSHARE_TOKEN` 可增加一个可靠数据源。
485
511
 
486
512
  ### Q: 港股 / 美股数据有延迟?
487
513
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stock-analysis-plugin",
3
- "version": "0.1.14",
3
+ "version": "0.1.15",
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",
package/pi/index.ts CHANGED
@@ -69,7 +69,7 @@ export default (pi: ExtensionAPI) => {
69
69
  properties: {
70
70
  symbol: {
71
71
  type: "string",
72
- description: "股票代码",
72
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
73
73
  },
74
74
  },
75
75
  required: ["symbol"],
@@ -117,7 +117,7 @@ export default (pi: ExtensionAPI) => {
117
117
  properties: {
118
118
  symbol: {
119
119
  type: "string",
120
- description: "股票代码",
120
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
121
121
  },
122
122
  days: {
123
123
  type: "number",
@@ -135,13 +135,13 @@ export default (pi: ExtensionAPI) => {
135
135
  pi.registerTool({
136
136
  name: "get_financials",
137
137
  description:
138
- "获取股票关键财务指标(PE/PB/市值/营收/净利润/ROE等),适合快速估值快查。A股深度基本面(成长性/盈利能力/分红)用 get_fundamental_context",
138
+ "获取股票财务摘要。A股返回最新报告期 ROE/毛利率/净利率/负债率/流动比率;其他市场返回 PE/PB/市值/营收/净利润等。A股估值、成长和分红用 get_fundamental_context",
139
139
  parameters: {
140
140
  type: "object",
141
141
  properties: {
142
142
  symbol: {
143
143
  type: "string",
144
- description: "股票代码",
144
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
145
145
  },
146
146
  },
147
147
  required: ["symbol"],
@@ -163,7 +163,7 @@ export default (pi: ExtensionAPI) => {
163
163
  properties: {
164
164
  symbol: {
165
165
  type: "string",
166
- description: "股票代码",
166
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
167
167
  },
168
168
  period: {
169
169
  type: "string",
@@ -199,7 +199,7 @@ export default (pi: ExtensionAPI) => {
199
199
  properties: {
200
200
  symbol: {
201
201
  type: "string",
202
- description: "股票代码",
202
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
203
203
  },
204
204
  period: {
205
205
  type: "string",
@@ -340,7 +340,7 @@ export default (pi: ExtensionAPI) => {
340
340
  properties: {
341
341
  symbol: {
342
342
  type: "string",
343
- description: "股票代码",
343
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
344
344
  },
345
345
  },
346
346
  required: ["symbol"],
@@ -394,7 +394,7 @@ export default (pi: ExtensionAPI) => {
394
394
  pi.registerTool({
395
395
  name: "get_fundamental_context",
396
396
  description:
397
- "获取A股深度基本面(估值PE/PB/PS + 成长性营收/净利增速 + 盈利能力ROE/毛利率 + 分红历史)。用于评估公司质地与长期持有价值;快速查PE/PB用 get_financials",
397
+ "获取A股基本面上下文(估值 PE/PB/市值 + 营收/净利增速 + ROE/毛利率/净利率 + 分红历史)。用于评估公司质地与长期持有价值",
398
398
  parameters: {
399
399
  type: "object",
400
400
  properties: {
@@ -431,7 +431,7 @@ export default (pi: ExtensionAPI) => {
431
431
  },
432
432
  config: {
433
433
  type: "string",
434
- description: "自定义筛选配置YAML文件路径(可选)",
434
+ description: "自定义筛选配置YAML文件路径,不填用默认配置",
435
435
  },
436
436
  l2: {
437
437
  type: "boolean",
@@ -466,7 +466,7 @@ export default (pi: ExtensionAPI) => {
466
466
  },
467
467
  symbol: {
468
468
  type: "string",
469
- description: "股票代码",
469
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
470
470
  },
471
471
  start: {
472
472
  type: "string",
@@ -506,7 +506,7 @@ export default (pi: ExtensionAPI) => {
506
506
  properties: {
507
507
  symbol: {
508
508
  type: "string",
509
- description: "股票代码",
509
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
510
510
  },
511
511
  signal: {
512
512
  type: "string",
@@ -661,7 +661,7 @@ export default (pi: ExtensionAPI) => {
661
661
  properties: {
662
662
  symbol: {
663
663
  type: "string",
664
- description: "股票代码",
664
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
665
665
  },
666
666
  periods: {
667
667
  type: "string",
@@ -701,7 +701,7 @@ export default (pi: ExtensionAPI) => {
701
701
  properties: {
702
702
  symbol: {
703
703
  type: "string",
704
- description: "股票代码",
704
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
705
705
  },
706
706
  period: {
707
707
  type: "string",
@@ -733,7 +733,7 @@ export default (pi: ExtensionAPI) => {
733
733
  pi.registerTool({
734
734
  name: "search_stock_news",
735
735
  description:
736
- "多引擎股票新闻搜索(支持 Tavily/Brave/SerpAPI)。需配置对应 API Key 环境变量。get_news 快讯不够或要按主题搜索时用本工具;深度6维情报用 search_comprehensive_intel",
736
+ "多引擎股票新闻搜索(Tavily/Brave/SerpAPI/Bocha/SearXNG)。需配置至少一个搜索源的 Key 或 SearXNG URL。get_news 快讯不够或要按主题搜索时用;深度6维情报用 search_comprehensive_intel",
737
737
  parameters: {
738
738
  type: "object",
739
739
  properties: {
@@ -768,7 +768,7 @@ export default (pi: ExtensionAPI) => {
768
768
  properties: {
769
769
  symbol: {
770
770
  type: "string",
771
- description: "股票代码",
771
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
772
772
  },
773
773
  name: {
774
774
  type: "string",
@@ -796,7 +796,7 @@ export default (pi: ExtensionAPI) => {
796
796
  properties: {
797
797
  symbol: {
798
798
  type: "string",
799
- description: "股票代码(如 AAPL)",
799
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
800
800
  },
801
801
  },
802
802
  required: ["symbol"],
@@ -844,13 +844,13 @@ export default (pi: ExtensionAPI) => {
844
844
  pi.registerTool({
845
845
  name: "screen_risk",
846
846
  description:
847
- "风险专项筛查 — 7维度风险检测(估值极端/技术预警/解禁到期/内部人减持/业绩预警/监管处罚/行业政策),返回风险评级和一票否决标记。入场决策前的排雷必调本工具",
847
+ "A股风险专项筛查 — 检查估值、技术预警、解禁、减持、业绩预警、监管和行业政策,返回风险评级和 veto_buy。新闻搜索命中是待核实线索,不是已证实风险",
848
848
  parameters: {
849
849
  type: "object",
850
850
  properties: {
851
851
  symbol: {
852
852
  type: "string",
853
- description: "股票代码(如 600519)",
853
+ description: "A股股票代码,如 600519",
854
854
  },
855
855
  name: {
856
856
  type: "string",
@@ -949,7 +949,7 @@ export default (pi: ExtensionAPI) => {
949
949
  properties: {
950
950
  symbol: {
951
951
  type: "string",
952
- description: "股票代码(如 600519、AAPL、00700.HK)",
952
+ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)",
953
953
  },
954
954
  },
955
955
  required: ["symbol"],
@@ -965,7 +965,7 @@ export default (pi: ExtensionAPI) => {
965
965
  pi.registerTool({
966
966
  name: "diagnose_data_sources",
967
967
  description:
968
- "数据源诊断 — 检查当前环境可用的数据 provider(akshare/tushare/yfinance/finnhub/longbridge/alphavantage),输出每个市场的可用链路、缺失 env、warnings。工具拿不到数据或报错时调用排查",
968
+ "数据源诊断 — 检查当前环境各数据 provider 的包与凭据就绪情况(不探测网络可达性),输出每个市场的可用链路、缺失 env、warnings。工具拿不到数据或报错时调用排查",
969
969
  parameters: {
970
970
  type: "object",
971
971
  properties: {
@@ -1007,13 +1007,13 @@ export default (pi: ExtensionAPI) => {
1007
1007
  pi.registerTool({
1008
1008
  name: "render_stock_report",
1009
1009
  description:
1010
- "股票分析报告渲染 — 将结构化 JSON(符合 schemas/report_schema.json)通过 j2 模板渲染为 Markdown。template: brief|full。全部分析完成后的最后一步调用。仅渲染,不保存不推送",
1010
+ "股票分析报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 skill 提供的 report_schema 为准,不要自造字段。template: brief|full。全部分析完成后的最后一步调用。仅渲染,不保存不推送",
1011
1011
  parameters: {
1012
1012
  type: "object",
1013
1013
  properties: {
1014
1014
  report: {
1015
1015
  type: "object",
1016
- description: "结构化股票报告,字段参考 schemas/report_schema.json",
1016
+ description: "结构化股票报告 JSON",
1017
1017
  },
1018
1018
  template: {
1019
1019
  type: "string",
@@ -1039,7 +1039,7 @@ export default (pi: ExtensionAPI) => {
1039
1039
  pi.registerTool({
1040
1040
  name: "render_market_report",
1041
1041
  description:
1042
- "大盘复盘报告渲染 — 将结构化 JSON(符合 schemas/market_review_schema.json)通过 j2 模板渲染为 Markdown",
1042
+ "大盘复盘报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 schemas/market_review_schema.json 为准。仅渲染,不保存不推送",
1043
1043
  parameters: {
1044
1044
  type: "object",
1045
1045
  properties: {
@@ -1098,11 +1098,11 @@ export default (pi: ExtensionAPI) => {
1098
1098
  parameters: {
1099
1099
  type: "object",
1100
1100
  properties: {
1101
- symbol: { type: "string", description: "股票代码" },
1101
+ symbol: { type: "string", description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" },
1102
1102
  cost: { type: "number", description: "成本价" },
1103
1103
  quantity: { type: "number", description: "持仓数量" },
1104
- stop_loss: { type: "number", description: "止损价(可选)" },
1105
- take_profit: { type: "number", description: "止盈价(可选)" },
1104
+ stop_loss: { type: "number", description: "止损价" },
1105
+ take_profit: { type: "number", description: "止盈价" },
1106
1106
  },
1107
1107
  required: ["symbol", "cost", "quantity"],
1108
1108
  },
@@ -1128,7 +1128,7 @@ export default (pi: ExtensionAPI) => {
1128
1128
  parameters: {
1129
1129
  type: "object",
1130
1130
  properties: {
1131
- symbol: { type: "string", description: "股票代码" },
1131
+ symbol: { type: "string", description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" },
1132
1132
  rules: {
1133
1133
  type: "array",
1134
1134
  description: "规则列表,每项 { type, value }",
@@ -1,13 +1,10 @@
1
1
  ---
2
2
  name: bottom-volume
3
- description: 底部放量策略 — 识别底部区域的异动放量信号。当用户要求分析底部放量时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 底部放量分析:判断长期下跌后的异常放量是否构成反转信号。用于低位放量;普通阻力突破用 volume-breakout。
5
4
  ---
6
5
 
7
6
  # 底部放量分析
8
7
 
9
- 你是一位专注底部形态的交易专家。
10
-
11
8
  ## 核心理念
12
9
 
13
10
  长期下跌后的底部区域出现异常放量,可能意味着主力资金开始建仓。底部放量是趋势反转的先兆信号,但需要结合其他指标确认。
@@ -11,7 +11,7 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
15
  result = subprocess.run(
16
16
  [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "120"],
17
17
  capture_output=True,
@@ -1,13 +1,10 @@
1
1
  ---
2
2
  name: box-oscillation
3
- description: 箱体震荡策略 — 识别箱体区间并在支撑压力间做波段。当用户要求箱体分析时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 箱体震荡分析:识别横盘区间、支撑压力和突破失效条件。用于区间波段或高抛低吸问题。
5
4
  ---
6
5
 
7
6
  # 箱体震荡分析
8
7
 
9
- 你是一位专注箱体交易的专家。
10
-
11
8
  ## 核心理念
12
9
 
13
10
  当股价在一个相对固定的区间内反复震荡时,形成"箱体"。在箱体内低买高卖做波段,直到箱体被突破。
@@ -11,7 +11,7 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
15
  result = subprocess.run(
16
16
  [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "90"],
17
17
  capture_output=True,
@@ -1,13 +1,10 @@
1
1
  ---
2
2
  name: bull-trend
3
- description: 趋势追踪策略 — 识别并跟随中长期上升趋势。当用户要求趋势分析时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 趋势追踪分析:识别中长期趋势、所处阶段和离场条件。用于多头排列、上升通道或持有趋势股。
5
4
  ---
6
5
 
7
6
  # 趋势追踪分析
8
7
 
9
- 你是一位趋势交易专家。运用趋势追踪方法论分析股票。
10
-
11
8
  ## 核心理念
12
9
 
13
10
  趋势追踪的核心是"顺势而为"——在确认趋势形成后入场,在趋势转弱时离场。不预测顶底,只跟随趋势。
@@ -11,7 +11,7 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
15
  result = subprocess.run(
16
16
  [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "120"],
17
17
  capture_output=True,
@@ -1,13 +1,10 @@
1
1
  ---
2
2
  name: chan-theory
3
- description: 缠论分析 — 基于缠中说禅理论的笔、段、中枢分析。当用户要求缠论分析时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 缠论分析:按笔、段、中枢和背驰识别缠论买卖点。仅在用户明确要求缠论口径时使用。
5
4
  ---
6
5
 
7
6
  # 缠论分析
8
7
 
9
- 你是一位精通缠论的交易专家。运用缠中说禅理论体系分析股票走势。
10
-
11
8
  ## 核心理念
12
9
 
13
10
  缠论是一套完备的技术分析理论,通过对走势的几何结构分析(笔→段→中枢→趋势),实现精确的买卖点定位。
@@ -11,7 +11,7 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
15
  result = subprocess.run(
16
16
  [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "120"],
17
17
  capture_output=True,
@@ -1,16 +1,15 @@
1
1
  ---
2
2
  name: dragon-head
3
- description: 龙头战法 — 识别板块龙头股和领涨个股。当用户要求龙头股分析时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 龙头股分析:在已知板块中比较启动顺序、涨幅、回调和持续性。题材热度与参与节奏用 hot-theme。
5
4
  ---
6
5
 
7
6
  # 龙头战法分析
8
7
 
9
- 你是一位专注龙头股战法的交易专家。
10
-
11
8
  ## 核心理念
12
9
 
13
- 每一轮板块行情都有龙头股引领。龙头股具有最强的市场号召力、最大的涨幅空间。龙头战法的核心是"抓龙头、弃杂毛"——只做板块中最强的那只。
10
+ “龙头”是同一板块、同一时间窗口内可验证的相对地位,不是个股强势的同义词。没有候选池和同期数据时,不下龙头结论。
11
+
12
+ 比较前读取[短线交易决策框架](../stock-analysis/references/short-term-trading.md),使用其中的相对强弱、市场状态和风险单位规则。
14
13
 
15
14
  ## 执行流程
16
15
 
@@ -23,34 +22,27 @@ python3 scripts/gather.py <symbol>
23
22
  ```
24
23
 
25
24
  同时用 resolve_stock_sectors 确认个股所属板块,再用 get_sector_constituents 拉取同板块个股列表——后续「龙头 vs 跟风」的强弱对比都在这个板块池内进行。
25
+ 获取不到板块池或池内个股同期表现时,只评估候选股的强势特征,不给出“龙头/龙一”结论。
26
26
 
27
- ### 2. 龙头股特征识别
27
+ ### 2. 相对强弱验证
28
28
 
29
- **一字特征**(最强龙头):
30
- - 率先涨停或封单最大
31
- - 板块启动第一天就涨停
32
- - 连板天数最多
29
+ 在同一截止时间比较板块候选股:
33
30
 
34
- **量价特征**:
35
- - 涨幅领先同板块个股
36
- - 成交量换手率适中(不过分大也不过分小)
37
- - 连续上涨期间回调幅度最小
31
+ - 5 日与 20 日收益及相对板块的超额表现
32
+ - 启动时间、最大回撤和回撤后的恢复速度
33
+ - 上涨日与下跌日的成交量结构
34
+ - 板块上涨时是否领涨,板块分歧时是否保持相对强度
38
35
 
39
- **市场地位**:
40
- - 具有板块辨识度(一提到某概念就想到这只股)
41
- - 市值不宜过大(难以拉升)也不宜过小(承载力不够)
36
+ 封单大小、开板次数、竞价强弱和分时承接需要盘口或分钟数据。当前数据无法验证时明确标注缺失,不得据此评定龙头。
42
37
 
43
- ### 3. 龙头战法操作
38
+ ### 3. 判断阶段与计划
44
39
 
45
- **买入时机**:
46
- - 板块启动初期,第 1-2 个涨停板
47
- - 首次分歧日(换手充分后再度走强)
48
- - 强势股回调至 5 日线附近
40
+ - **Setup**:板块开始扩散,候选股率先取得相对强度。
41
+ - **Trigger**:个股突破或回踩再启动,板块方向同步确认。
42
+ - **Acceptance**:个股保持领先且回撤小于板块同类。
43
+ - **Failure**:板块退潮、领先优势消失或个股放量跌破关键结构。
49
44
 
50
- **卖出时机**:
51
- - 连板结束后的第一个大阴线
52
- - 板块整体退潮,跟风股全面走弱
53
- - 换手率异常放大(超过前几日均值 3 倍以上)
45
+ 交易计划必须给出触发、失效、时间止损和潜在收益/R;只确认“最强”而没有合理风险边界时不交易。
54
46
 
55
47
  ### 4. 龙头 vs 跟风
56
48
 
@@ -59,7 +51,7 @@ python3 scripts/gather.py <symbol>
59
51
  | 启动顺序 | 最先 | 滞后 |
60
52
  | 涨幅 | 最大 | 较小 |
61
53
  | 回调 | 小且快 | 大且深 |
62
- | 封板 | 坚决 | 反复开板 |
54
+ | 成交确认 | 上涨时相对放量、回撤时抛压可控 | 上涨缩量或回撤放量 |
63
55
  | 持续性 | 强 | 弱 |
64
56
 
65
57
  ## 输出要求
@@ -68,4 +60,6 @@ python3 scripts/gather.py <symbol>
68
60
  2. 所属板块和板块热度
69
61
  3. 与同板块个股的强弱对比
70
62
  4. 当前处于龙头行情的哪个阶段
71
- 5. 操作建议和风险提示
63
+ 5. 触发、失效、时间止损和风险提示
64
+
65
+ 完成标准:至少与同板块候选股比较启动时间、涨幅和回撤;否则输出“龙头地位未验证”。
@@ -11,7 +11,7 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
15
  result = subprocess.run(
16
16
  [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "30", "--with-quote"],
17
17
  capture_output=True,
@@ -1,65 +1,49 @@
1
1
  ---
2
2
  name: emotion-cycle
3
- description: 情绪周期策略 — 基于市场情绪周期的择时分析。当用户要求情绪分析时使用。
4
- allowed-tools: Bash(python3:*) Read
3
+ description: 市场情绪周期:用市场宽度、涨跌停、成交额和热度判断冰点、回暖、高潮或退潮。完整大盘复盘用 market-review。
5
4
  ---
6
5
 
7
6
  # 情绪周期分析
8
7
 
9
- 你是一位擅长市场情绪分析的交易专家。
10
-
11
- ## 核心理念
12
-
13
- 市场是情绪驱动的。情绪有周期性:从恐慌→犹豫→乐观→贪婪→恐慌,循环往复。在别人恐惧时贪婪,在别人贪婪时恐惧。
8
+ 分析前读取[短线交易决策框架](../stock-analysis/references/short-term-trading.md)。情绪阶段只用于调整策略和风险门槛,不单独构成买卖信号。
14
9
 
15
10
  ## 执行流程
16
11
 
17
12
  ### 1. 采集数据
18
13
 
19
- 运行数据采集脚本获取 60 根日K线、技术指标及实时行情:
14
+ 运行数据采集脚本获取市场宽度、板块、新闻、市场状态和温度(默认 A 股):
20
15
 
21
16
  ```bash
22
- python3 scripts/gather.py <symbol>
17
+ python3 scripts/gather.py [A|HK|US]
23
18
  ```
24
19
 
25
20
  ### 2. 情绪指标
26
21
 
27
- **量价情绪**:
28
- - 换手率:高换手率(>5%)→ 市场亢奋;低换手率(<1%)→ 市场冷淡
29
- - 量比:>2 → 资金活跃;<0.5 → 市场冷清
30
- - 涨停/跌停比例:反映多空极端情绪
31
-
32
- **技术情绪**:
33
- - RSI:>80 极度乐观/贪婪;<20 极度悲观/恐惧
34
- - 布林带位置:接近上轨 → 过热;接近下轨 → 过冷
35
- - 偏离度:股价偏离 MA20 超过 10% → 情绪极端
22
+ - 市场温度和策略姿态
23
+ - 上涨/下跌家数与涨跌停比
24
+ - 成交额及放量/缩量状态
25
+ - 板块扩散度和领涨持续性
36
26
 
37
27
  ### 3. 情绪周期阶段
38
28
 
39
29
  | 阶段 | 特征 | 操作 |
40
30
  |------|------|------|
41
- | 冰点期 | 缩量、低换手、RSI<30、市场无人关注 | 左侧建仓 |
42
- | 回暖期 | 温和放量、站上MA10、悲观情绪缓解 | 加仓 |
43
- | 狂热期 | 巨量、高换手、RSI>70、散户蜂拥入场 | 逐步减仓 |
44
- | 退潮期 | 高位放量阴线、分歧加大、龙头开板 | 清仓观望 |
45
- | 恐慌期 | 放量暴跌、跌停潮、恐慌性抛售 | 等待企稳 |
31
+ | 冰点期 | 下跌家数和跌停数扩大,温度处于低位 | 等待宽度停止恶化,不因“低”直接抄底 |
32
+ | 回暖期 | 宽度改善,涨停增加,主线开始扩散 | 仅在触发与失效清晰时试错 |
33
+ | 狂热期 | 高温、全面普涨、补涨扩散且成交额显著放大 | 提高接受确认要求,降低追高风险 |
34
+ | 退潮期 | 高位放量阴线、分歧加大、领先股转弱 | 降低敞口,已有头寸按失效条件处理 |
35
+ | 恐慌期 | 放量暴跌、跌停潮、恐慌性抛售 | 等待宽度、成交量和价格结构共同企稳 |
46
36
 
47
37
  ### 4. 逆向信号
48
38
 
49
- **底部信号**(贪婪时机):
50
- - 连续多日缩量(地量见地价)
51
- - 利空不跌
52
- - 市场极度悲观但技术指标底背离
39
+ 转折必须由至少两类独立市场数据共同确认(如宽度 + 成交额)。只有单日涨跌或数据缺失时,输出“未确认”并列出缺失证据。
53
40
 
54
- **顶部信号**(恐惧时机):
55
- - 天量天价
56
- - 利好不涨
57
- - 市场极度乐观但技术指标顶背离
41
+ 同时对照 `detect_market_regime`:趋势、横盘和高波动状态决定应优先采用延续还是反转策略。情绪周期与市场状态冲突时,不强行合并成单一分数,分别陈述证据并降低确信度。
58
42
 
59
43
  ## 输出要求
60
44
 
61
45
  1. 当前情绪周期所处阶段
62
46
  2. 关键情绪指标数值
63
47
  3. 情绪拐点信号是否出现
64
- 4. 基于情绪周期的操作建议
65
- 5. 需要警惕的风险因素
48
+ 4. 适配与回避的策略类型
49
+ 5. 风险门槛、转折确认条件和数据缺口
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env python3
2
- """Gather technical data for emotion-cycle analysis."""
2
+ """Gather market data for emotion-cycle analysis."""
3
3
 
4
4
  import subprocess
5
5
  import sys
@@ -11,9 +11,10 @@ for _s in (sys.stdout, sys.stderr):
11
11
  if hasattr(_s, "reconfigure"):
12
12
  _s.reconfigure(encoding="utf-8")
13
13
 
14
- tools = Path(__file__).resolve().parents[2] / "tools"
14
+ market = sys.argv[1] if len(sys.argv) > 1 else "A"
15
+ tools = Path(__file__).resolve().parents[3] / "tools"
15
16
  result = subprocess.run(
16
- [sys.executable, str(tools / "gather.py"), "technical", sys.argv[1], "--kline-count", "60", "--with-quote"],
17
+ [sys.executable, str(tools / "market_review.py"), "review", "--market", market],
17
18
  capture_output=True,
18
19
  text=True,
19
20
  encoding="utf-8",