openclaw-stock-analysis 0.2.2 → 0.2.6

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 (60) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +2 -2
  3. package/dist/index.js +228 -30
  4. package/index.ts +246 -33
  5. package/openclaw.plugin.json +13 -1
  6. package/package.json +1 -1
  7. package/schemas/report_schema.json +3 -3
  8. package/scripts/ci-resolve-llm-host.mjs +29 -0
  9. package/scripts/setup-python.mjs +11 -13
  10. package/skills/bull-trend/SKILL.md +34 -10
  11. package/skills/bull-trend/references/fat-tails.md +91 -0
  12. package/skills/bull-trend/scripts/tail_analysis.py +132 -0
  13. package/skills/event-driven/SKILL.md +8 -0
  14. package/skills/growth-quality/SKILL.md +8 -0
  15. package/skills/hot-theme/SKILL.md +3 -2
  16. package/skills/stock-analysis/SKILL.md +31 -3
  17. package/skills/stock-screener/SKILL.md +21 -1
  18. package/skills/strategy-backtest/SKILL.md +15 -5
  19. package/skills/wisburg-research/SKILL.md +2 -0
  20. package/strategies/examples/bottom_volume.yaml +5 -0
  21. package/strategies/examples/box_oscillation.yaml +5 -0
  22. package/strategies/examples/bull_trend.yaml +11 -3
  23. package/strategies/examples/dragon_head.yaml +4 -2
  24. package/strategies/examples/emotion_cycle.yaml +5 -0
  25. package/strategies/examples/ma_crossover.yaml +10 -3
  26. package/strategies/examples/rsi_oversold.yaml +5 -0
  27. package/strategies/examples/shrink_pullback.yaml +7 -1
  28. package/strategies/examples/volume_breakout.yaml +7 -1
  29. package/templates/stock_analysis/brief.md.j2 +4 -1
  30. package/templates/stock_analysis/full.md.j2 +6 -3
  31. package/tools/_cache.py +61 -0
  32. package/tools/_subproc.py +49 -0
  33. package/tools/alert_rules.py +51 -13
  34. package/tools/anomaly_detect.py +24 -35
  35. package/tools/backtest.py +202 -104
  36. package/tools/capabilities.py +16 -5
  37. package/tools/diagnostics.py +12 -6
  38. package/tools/gather.py +33 -19
  39. package/tools/import_parser.py +2 -5
  40. package/tools/lixinger.py +100 -0
  41. package/tools/market_regime.py +34 -38
  42. package/tools/market_review.py +57 -9
  43. package/tools/name_resolver.py +2 -5
  44. package/tools/pattern.py +2 -5
  45. package/tools/position_context.py +22 -7
  46. package/tools/report_renderer.py +12 -6
  47. package/tools/requirements.txt +2 -1
  48. package/tools/risk_screening.py +73 -39
  49. package/tools/screener.py +90 -20
  50. package/tools/search_intel.py +5 -13
  51. package/tools/sec_edgar.py +346 -0
  52. package/tools/sec_holders.py +263 -0
  53. package/tools/signal_tracker.py +144 -25
  54. package/tools/stock_data.py +600 -186
  55. package/tools/technical.py +152 -42
  56. package/tools/trading_calendar.py +78 -18
  57. package/tools/value_data.py +1527 -0
  58. package/tools/volume_analysis.py +2 -5
  59. package/tools/watchlist.py +26 -6
  60. package/tools/watchlist_context.py +9 -8
package/index.ts CHANGED
@@ -11,8 +11,19 @@ type Executor = (bin: string, argv: string[]) => Promise<string>;
11
11
 
12
12
  const defaultExecutor: Executor = async (bin, argv) => {
13
13
  const exec = promisify(cp.execFile);
14
- const { stdout } = await exec(bin, argv, { maxBuffer: 32 * 1024 * 1024 });
15
- return stdout;
14
+ try {
15
+ const { stdout } = await exec(bin, argv, { maxBuffer: 32 * 1024 * 1024 });
16
+ return stdout;
17
+ } catch (error) {
18
+ const stdout = (error as { stdout?: string }).stdout;
19
+ try {
20
+ const data = JSON.parse(stdout ?? "");
21
+ if (data && typeof data.error === "string") return stdout!;
22
+ } catch {
23
+ // A failed subprocess without JSON must not expose stderr or command arguments.
24
+ }
25
+ return JSON.stringify({ error: "Python command failed; check interpreter/dependencies" });
26
+ }
16
27
  };
17
28
 
18
29
  let executor: Executor = defaultExecutor;
@@ -25,25 +36,10 @@ const here = dirname(fileURLToPath(import.meta.url));
25
36
  const toolsDir = existsSync(join(here, "tools"))
26
37
  ? join(here, "tools")
27
38
  : join(here, "..", "tools");
28
- const repoRoot = dirname(toolsDir);
39
+ const fallbackRoot = dirname(toolsDir);
29
40
  const isWin = process.platform === "win32";
30
41
  // Windows venvs ship Scripts/python.exe (there is no python3); POSIX venvs ship bin/python3.
31
42
  const venvBin = join(".venv", isWin ? "Scripts" : "bin", isWin ? "python.exe" : "python3");
32
- const venvPython = join(repoRoot, venvBin);
33
- // Staged-payload layout (openclaw/tools present in a dev checkout): the venv
34
- // still lives at the repo root one level up.
35
- const parentVenvPython = join(repoRoot, "..", venvBin);
36
-
37
- function pythonBin(): string {
38
- if (existsSync(venvPython)) return venvPython;
39
- if (existsSync(parentVenvPython)) return parentVenvPython;
40
- // On Windows "python3" is usually the Microsoft Store stub — prefer "python".
41
- return isWin ? "python" : "python3";
42
- }
43
-
44
- async function runPy(script: string, args: string[]): Promise<string> {
45
- return executor(pythonBin(), [join(toolsDir, script), ...args]);
46
- }
47
43
 
48
44
  function asText(text: string) {
49
45
  return { content: [{ type: "text" as const, text }] };
@@ -55,12 +51,154 @@ export default definePluginEntry({
55
51
  description:
56
52
  "Stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
57
53
  register(api) {
54
+ // OpenClaw executes a captured copy of the JS bundle; the venv stays in the installed plugin root.
55
+ const repoRoot = api.rootDir || fallbackRoot;
56
+ const runtimeToolsDir = existsSync(join(repoRoot, "tools")) ? join(repoRoot, "tools") : toolsDir;
57
+ const pythonBin = () => {
58
+ const venvPython = join(repoRoot, venvBin);
59
+ if (existsSync(venvPython)) return venvPython;
60
+ // In a staged dev checkout, the venv still lives at the repo root.
61
+ const parentVenvPython = join(repoRoot, "..", venvBin);
62
+ if (existsSync(parentVenvPython)) return parentVenvPython;
63
+ // On Windows "python3" is usually the Microsoft Store stub — prefer "python".
64
+ return isWin ? "python" : "python3";
65
+ };
66
+ const runPy = (script: string, args: string[]) =>
67
+ executor(pythonBin(), [join(runtimeToolsDir, script), ...args]);
58
68
  // --- Data Tools ---
59
69
 
70
+ api.registerTool({
71
+ name: "get_announcements",
72
+ description: "查询A股巨潮公告标题、日期、类型和原文PDF链接;按日期范围/类别筛选,默认近90天,top=1..500。第一版不提取正文,truncated提示截断。",
73
+ parameters: Type.Object({
74
+ symbol: Type.String({ description: "A股代码" }),
75
+ category: Type.Optional(Type.Union([Type.Literal("all"), Type.Literal("forecast"), Type.Literal("express"), Type.Literal("annual"), Type.Literal("interim"), Type.Literal("quarterly"), Type.Literal("reduction"), Type.Literal("issuance"), Type.Literal("inquiry"), Type.Literal("dividend")], { description: "公告类别,默认all" })),
76
+ start_date: Type.Optional(Type.String({ description: "开始日期YYYY-MM-DD,默认结束日期前90天" })),
77
+ end_date: Type.Optional(Type.String({ description: "结束日期YYYY-MM-DD,默认今天" })),
78
+ top: Type.Optional(Type.Number({ description: "最多条数1..500,默认50" })),
79
+ }),
80
+ async execute(_id, p) {
81
+ const out = await runPy("value_data.py", ["announcements", p.symbol, "--category", p.category ?? "all", "--start-date", p.start_date ?? "", "--end-date", p.end_date ?? "", "--top", String(p.top ?? 50)]);
82
+ return asText(out);
83
+ },
84
+ });
85
+
86
+ api.registerTool({
87
+ name: "get_us_holdings",
88
+ description: "查询SEC 13F:mode=auto默认有13F申报时查机构,否则按发行人CIK反查持仓机构;manager/issuer可显式指定。发行人通过官方13D/G精确映射CUSIP,扫描最新已发布13F窗口,处理重述/补充修订,返回实际报告期、截止日及映射覆盖。首次约100MB下载,后续缓存;无映射明确报错,不做名称猜测。需SEC_USER_AGENT含真实联系邮箱,不是实时或全部证券持仓。",
89
+ parameters: Type.Object({
90
+ cik: Type.String({ description: "机构或发行人CIK,1..10位数字,如0001067983/0000320193" }),
91
+ mode: Type.Optional(Type.Union([Type.Literal("auto"), Type.Literal("manager"), Type.Literal("issuer")], { description: "默认auto;manager查机构组合,issuer反查发行人持仓机构" })),
92
+ }),
93
+ async execute(_id, p) {
94
+ const out = await runPy("sec_edgar.py", ["holdings", p.cik, ...(p.mode ? ["--mode", p.mode] : [])]);
95
+ return asText(out);
96
+ },
97
+ });
98
+
99
+ api.registerTool({
100
+ name: "get_insider_trades",
101
+ description: "查询美股发行人近期Form 4/4-A内部人交易(SEC官方XML),保留人员职务、交易代码、买卖方向、数量、价格、脚注和衍生品标志。需SEC_USER_AGENT含真实联系邮箱;days按申报日期筛选,top限制文件数,修订勿重复计数。",
102
+ parameters: Type.Object({
103
+ symbol: Type.String({ description: "美股ticker或发行人CIK" }),
104
+ days: Type.Optional(Type.Number({ description: "申报日期窗口1..365天,默认90" })),
105
+ top: Type.Optional(Type.Number({ description: "最多解析Form 4文件数1..20,默认10" })),
106
+ }),
107
+ async execute(_id, p) {
108
+ const out = await runPy("sec_edgar.py", ["insider_trades", p.symbol, "--days", String(p.days ?? 90), "--top", String(p.top ?? 10)]);
109
+ return asText(out);
110
+ },
111
+ });
112
+
113
+ api.registerTool({
114
+ name: "get_valuation_history",
115
+ description: "查询A/HK股票历史PE-TTM/PB、当前正值分位和10/25/50/75/90分位Band,返回实际采样区间;亏损估值分位为null。years=1..10,按天缓存。HK配置LIXINGER_TOKEN时优先理杏仁非金融公司日历史,失败降级百度,不混接来源。",
116
+ parameters: Type.Object({
117
+ symbol: Type.String({ description: "A股代码或港股.HK代码" }),
118
+ years: Type.Optional(Type.Number({ description: "历史窗口年数1..10,默认5" })),
119
+ }),
120
+ async execute(_id, p) {
121
+ const out = await runPy("value_data.py", ["valuation_history", p.symbol, "--years", String(p.years ?? 5)]);
122
+ return asText(out);
123
+ },
124
+ });
125
+
126
+ api.registerTool({
127
+ name: "get_index_valuation",
128
+ description: "查询中国指数估值历史分位与Band;乐咕乐股PE/PB优先,中证官方历史补充滚动PE并保留近期PE1口径。缺PB时可用LIXINGER_TOKEN补充理杏仁mcw历史,来源与算法分别标明,不混接同一指标。",
129
+ parameters: Type.Object({
130
+ symbol: Type.String({ description: "指数代码或名称,如000300、沪深300、000985" }),
131
+ years: Type.Optional(Type.Number({ description: "历史窗口年数1..10,默认5" })),
132
+ }),
133
+ async execute(_id, p) {
134
+ const out = await runPy("value_data.py", ["index_valuation", p.symbol, "--years", String(p.years ?? 5)]);
135
+ return asText(out);
136
+ },
137
+ });
138
+
139
+ api.registerTool({
140
+ name: "get_earnings_calendar",
141
+ description: "查询财报日历:A股report_date必填季度期末,返回预约/修订/实际披露与业绩预告;HK需symbol,优先HKEX已公告业绩审批董事会排期(不是实际披露日),缺失时返回供应商日期。HK可按已知财政期末过滤,未知期次另列。",
142
+ parameters: Type.Object({
143
+ report_date: Type.Optional(Type.String({ description: "A股必填季度期末YYYY-MM-DD;HK可选已公告财政期末,未知期次另列" })),
144
+ symbol: Type.Optional(Type.String({ description: "A股代码可选(省略查全市场);HK必须提供港股.HK代码" })),
145
+ top: Type.Optional(Type.Number({ description: "每类最多返回条数1..500,默认50" })),
146
+ }),
147
+ async execute(_id, p) {
148
+ const out = await runPy("value_data.py", ["earnings_calendar", "--report-date", p.report_date ?? "", "--symbol", p.symbol ?? "", "--top", String(p.top ?? 50)]);
149
+ return asText(out);
150
+ },
151
+ });
152
+
153
+ api.registerTool({
154
+ name: "get_shareholder_structure",
155
+ description: "查询A股股东户数、十大流通股东变化及沪深交易所季度北向合计持股;官方总量优先,十大HKSCC名义持股仅兜底且标明口径。HK返回港交所南向记录。缺失不当零,期末不等于已公布。",
156
+ parameters: Type.Object({
157
+ symbol: Type.String({ description: "A股代码或港股.HK代码" }),
158
+ report_date: Type.Optional(Type.String({ description: "A股报告期YYYY-MM-DD;省略时北向使用最新已公布季度,十大股东使用最新财报期;HK忽略" })),
159
+ }),
160
+ async execute(_id, p) {
161
+ const out = await runPy("value_data.py", ["shareholder_structure", p.symbol, "--report-date", p.report_date ?? ""]);
162
+ return asText(out);
163
+ },
164
+ });
165
+
166
+ api.registerTool({
167
+ name: "get_etf_details",
168
+ description: "查询A股ETF净值折溢价、规模、披露持仓及沪深完整PCF申赎篮子;篮子不是实际持仓。include_full_holdings=true另取最近可得半年度/年度披露股票表,含数量/市值/报告期,非实时全资产组合;benchmark用于跟踪误差。",
169
+ parameters: Type.Object({
170
+ include_full_holdings: Type.Optional(Type.Boolean({ description: "请求半年度/年度披露股票表,默认false" })),
171
+ symbol: Type.String({ description: "A股ETF代码,如510300" }),
172
+ benchmark: Type.Optional(Type.String({ description: "可选基准代码,如sh000300;不猜测基准" })),
173
+ days: Type.Optional(Type.Number({ description: "净值窗口交易日数10..252,默认60" })),
174
+ }),
175
+ async execute(_id, p) {
176
+ const out = await runPy("value_data.py", ["etf_details", p.symbol, "--benchmark", p.benchmark ?? "", "--days", String(p.days ?? 60), ...(p.include_full_holdings ? ["--include-full-holdings"] : [])]);
177
+ return asText(out);
178
+ },
179
+ });
180
+
181
+ api.registerTool({
182
+ name: "get_dividends",
183
+ description: "查询A/HK分红历史、除息日历、已实施TTM股息与连续年数。mode=ranking省略symbol,market=A查报告期排行,market=HK查HKEX/LSEG年度股息率排行(report_date须年末);排行均非当前TTM收益率。缺失不按零。",
184
+ parameters: Type.Object({
185
+ market: Type.Optional(Type.Union([Type.Literal("A"), Type.Literal("HK")], { description: "仅ranking选择市场,默认A" })),
186
+ symbol: Type.Optional(Type.String({ description: "history/calendar必填A股或港股.HK代码;ranking省略" })),
187
+ mode: Type.Optional(Type.Union([Type.Literal("history"), Type.Literal("calendar"), Type.Literal("ranking")], { description: "history默认;calendar未来已公布除息事件;ranking按market查询A/HK排行" })),
188
+ report_date: Type.Optional(Type.String({ description: "ranking报告期YYYY-MM-DD,默认上一年年末;HK仅年度年末日期" })),
189
+ years: Type.Optional(Type.Number({ description: "历史窗口年数1..20,默认10" })),
190
+ top: Type.Optional(Type.Number({ description: "排名条数1..500,默认20" })),
191
+ }),
192
+ async execute(_id, p) {
193
+ const out = await runPy("value_data.py", ["dividends", "--market", p.market ?? "A", "--symbol", p.symbol ?? "", "--mode", p.mode ?? "history", "--report-date", p.report_date ?? "", "--years", String(p.years ?? 10), "--top", String(p.top ?? 20)]);
194
+ return asText(out);
195
+ },
196
+ });
197
+
60
198
  api.registerTool({
61
199
  name: "get_kline",
62
200
  description:
63
- "获取股票K线数据(OHLCV)。支持A股(如600519)、港股(如00700.HK)、美股(如AAPL)、日股(如7203.T)、韩股(如005930.KS)、台股(如2330.TW)及A股ETF。需要原始历史价格自行计算或画图时用;只问指标用 get_technical_analysis,只问现价用 get_quote",
201
+ "获取股票K线数据(OHLCV)。支持A股(如600519)、港股(如00700.HK)、美股(如AAPL)、日股(如7203.T)、韩股(如005930.KS)、台股(如2330.TW)及A股ETF。A股股票/ETF返回前复权价格,每条记录 adjusted=qfq;sh000xxx/sz399xxx 指数返回原始点位,adjusted=none。需要历史价格自行计算或画图时用;只问指标用 get_technical_analysis,只问现价用 get_quote",
64
202
  parameters: Type.Object({
65
203
  symbol: Type.String({
66
204
  description: "股票代码,如 600519(A股)、00700.HK(港股)、AAPL(美股)、7203.T(日股)、005930.KS(韩股)、2330.TW(台股)",
@@ -88,7 +226,7 @@ export default definePluginEntry({
88
226
 
89
227
  api.registerTool({
90
228
  name: "get_quote",
91
- description: "获取股票实时行情报价(现价、涨跌幅、量比等)。支持A股、港股、美股、日股、韩股、台股;非交易时段返回最近交易日收盘价并以 as_of/stale 标注",
229
+ description: "获取股票实时行情报价(现价、涨跌幅、量比等)。支持A股、港股、美股、日股、韩股、台股;非交易时段返回最近交易日收盘价并以 as_of/stale 标注;ETF 的 premium_discount_rate 为正=溢价、负=折价",
92
230
  parameters: Type.Object({
93
231
  symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
94
232
  }),
@@ -148,12 +286,19 @@ export default definePluginEntry({
148
286
 
149
287
  api.registerTool({
150
288
  name: "get_financials",
151
- description: "获取股票财务摘要。A股返回最新报告期 ROE/毛利率/净利率/负债率/流动比率;其他市场返回 PE/PB/市值/营收/净利润等。A股估值、成长和分红用 get_fundamental_context",
289
+ description: "获取股票财务摘要及历史趋势,按天缓存。A股annual=true与periods=10取十年年报;港股可配置LIXINGER_TOKEN取非金融公司财务序列,保留币种/披露日/实际财年,历史比率单位percent。有效Yahoo顶层快照按整组保留,currency为财报币种、market_cap_currency为市值币种、snapshot_source标明来源;缺失值及report_date不混入历史数值/日期。缺token或无权限降级原有来源并标注不足,不补造缺失。估值历史用get_valuation_history,披露排期用get_earnings_calendar",
152
290
  parameters: Type.Object({
153
291
  symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
292
+ annual: Type.Optional(Type.Boolean({description: "只取年度报告,默认false"})),
293
+ periods: Type.Optional(
294
+ Type.Number({ description: "返回最近N个报告期1..40,默认1;annual=true时periods=10请求10年年报" })
295
+ ),
154
296
  }),
155
297
  async execute(_id, params) {
156
- const out = await runPy("stock_data.py", ["financials", params.symbol]);
298
+ const args = ["financials", params.symbol];
299
+ if (params.periods !== undefined && params.periods !== 1) args.push("--periods", String(params.periods));
300
+ if (params.annual) args.push("--annual");
301
+ const out = await runPy("stock_data.py", args);
157
302
  return asText(out);
158
303
  },
159
304
  });
@@ -163,7 +308,7 @@ export default definePluginEntry({
163
308
  api.registerTool({
164
309
  name: "get_technical_analysis",
165
310
  description:
166
- "获取股票技术面分析(MA/MACD/RSI/BOLL/KDJ/成交量等指标 + 100分综合评分 + 6级买卖信号 + 趋势/偏离度/支撑压力位)。个股技术面综合判断与买卖时机分析的首选;只要均线数值或自定义周期用 calculate_ma,专问量价用 get_volume_analysis,扫当日异动用 detect_anomaly",
311
+ "获取股票技术面分析(MA/MACD/RSI/BOLL/KDJ/成交量等指标 + 100分综合评分 + 6级买卖信号 + 趋势/偏离度/支撑压力位;多周期共振时 resonance.direction ∈ aligned_bullish/aligned_bearish/divergent)。个股技术面综合判断与买卖时机分析的首选;只要均线数值或自定义周期用 calculate_ma,专问量价用 get_volume_analysis,扫当日异动用 detect_anomaly",
167
312
  parameters: Type.Object({
168
313
  symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
169
314
  period: Type.Optional(
@@ -175,16 +320,23 @@ export default definePluginEntry({
175
320
  count: Type.Optional(
176
321
  Type.Number({ description: "用于计算指标的K线条数,默认 120" })
177
322
  ),
323
+ periods: Type.Optional(
324
+ Type.String({
325
+ description: '多周期共振分析,逗号分隔的周期列表,如 "daily,weekly";不传则只分析 period 指定的单周期',
326
+ })
327
+ ),
178
328
  }),
179
329
  async execute(_id, params) {
180
- const out = await runPy("technical.py", [
330
+ const args = [
181
331
  "analyze",
182
332
  params.symbol,
183
333
  "--period",
184
334
  params.period ?? "daily",
185
335
  "--count",
186
336
  String(params.count ?? 120),
187
- ]);
337
+ ];
338
+ if (params.periods) args.push("--periods", params.periods);
339
+ const out = await runPy("technical.py", args);
188
340
  return asText(out);
189
341
  },
190
342
  });
@@ -280,7 +432,7 @@ export default definePluginEntry({
280
432
  api.registerTool({
281
433
  name: "get_sector_constituents",
282
434
  description:
283
- "查询A股板块成分股(正向映射:板块→股票列表)。板块名支持模糊匹配(如「创新药」自动解析到精确板块名),东财行业/概念 + 新浪多源 failover,结果缓存24小时。仅支持A股;反向查个股所属板块用 resolve_stock_sectors",
435
+ "查询A股板块成分股(正向映射:板块→股票列表)。板块名支持模糊匹配(如「创新药」自动解析到精确板块名),东财行业/概念 + 新浪多源 failover,结果按用户目录缓存7天。仅支持A股;反向查个股所属板块用 resolve_stock_sectors",
284
436
  parameters: Type.Object({
285
437
  sector: Type.String({ description: "板块名称(可模糊,如 创新药、半导体)" }),
286
438
  board_type: Type.Optional(
@@ -417,6 +569,48 @@ export default definePluginEntry({
417
569
  },
418
570
  });
419
571
 
572
+ api.registerTool({
573
+ name: "get_margin_trading",
574
+ description:
575
+ "获取A股个股融资融券明细(融资余额/融资买入额/融券余量等,上交所/深交所官方数据按交易所分流),返回最近N个交易日序列(最新在前)。金额单位为元,short_*_shares 单位为股。include_ratio=true追加同日融资买入/成交额百分比(margin_buy_ratio_pct),缺少同日元口径成交额则为null。仅两融标的有数据,非两融标的返回错误",
576
+ parameters: Type.Object({
577
+ symbol: Type.String({ description: "A股股票代码,如 600519" }),
578
+ include_ratio: Type.Optional(Type.Boolean({description: "追加同日融资买入占比,默认false"})),
579
+ days: Type.Optional(
580
+ Type.Number({ description: "返回最近N个交易日,默认 10" })
581
+ ),
582
+ }),
583
+ async execute(_id, params) {
584
+ const out = await runPy("stock_data.py", [
585
+ "margin_trading",
586
+ params.symbol,
587
+ "--days",
588
+ String(params.days ?? 10),
589
+ ...(params.include_ratio ? ["--include-ratio"] : []),
590
+ ]);
591
+ return asText(out);
592
+ },
593
+ });
594
+
595
+ api.registerTool({
596
+ name: "get_northbound_flow",
597
+ description:
598
+ "获取北向资金市场级净买入序列(最新在前,单位亿元)。数据口径:东方财富沪深港通历史数据;2024-08-16 起交易所停止披露日度净买额,仅 2024-08 之前历史数据可查(近期小 days 窗口会返回停披错误,加大 days 可取历史)",
599
+ parameters: Type.Object({
600
+ days: Type.Optional(
601
+ Type.Number({ description: "返回最近N个交易日,默认 10" })
602
+ ),
603
+ }),
604
+ async execute(_id, params) {
605
+ const out = await runPy("stock_data.py", [
606
+ "northbound_flow",
607
+ "--days",
608
+ String(params.days ?? 10),
609
+ ]);
610
+ return asText(out);
611
+ },
612
+ });
613
+
420
614
  api.registerTool({
421
615
  name: "get_fundamental_context",
422
616
  description:
@@ -438,7 +632,7 @@ export default definePluginEntry({
438
632
  api.registerTool({
439
633
  name: "screen_stocks",
440
634
  description:
441
- "全市场股票筛选(AlphaSift L1 多因子硬筛 + 市场情绪调节)。按PE/PB/市值/换手率/涨跌幅/量比等因子过滤和评分,可用 l2 开启质量/成长/动量/波动率/资金流增强",
635
+ "全市场股票筛选(AlphaSift L1 多因子硬筛 + 市场情绪调节)。按PE/PB/市值/换手率/涨跌幅/量比等因子过滤和评分,可用 l2 开启质量/成长/动量/波动率/资金流增强。显式筛选条件缺少数据时报error,filters_applied只列实际执行的条件",
442
636
  parameters: Type.Object({
443
637
  market: Type.Optional(
444
638
  Type.Union(
@@ -474,7 +668,7 @@ export default definePluginEntry({
474
668
  api.registerTool({
475
669
  name: "run_backtest",
476
670
  description:
477
- "策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal",
671
+ "策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal。period为实际数据期间,requested_period保留请求期间,warnings提示覆盖差异;年化按实际期间计算",
478
672
  parameters: Type.Object({
479
673
  strategy: Type.String({ description: "策略YAML文件路径" }),
480
674
  symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
@@ -783,7 +977,7 @@ export default definePluginEntry({
783
977
  api.registerTool({
784
978
  name: "screen_risk",
785
979
  description:
786
- "A股风险专项筛查 — 检查估值、技术预警、解禁、减持、业绩预警、监管和行业政策,返回风险评级和 veto_buy。新闻搜索命中是待核实线索,不是已证实风险",
980
+ "A股风险专项筛查 — 检查估值、技术预警、解禁、减持、业绩预警、监管和行业政策,返回风险评级和 veto_buy。新闻搜索命中是待核实线索,不是已证实风险。data_complete和warnings标明覆盖;数据不足时risk_level=unknown,risk_score或veto_buy可为null,不能视为低风险",
787
981
  parameters: Type.Object({
788
982
  symbol: Type.String({ description: "A股股票代码,如 600519" }),
789
983
  name: Type.Optional(
@@ -972,13 +1166,32 @@ export default definePluginEntry({
972
1166
  api.registerTool({
973
1167
  name: "render_market_report",
974
1168
  description:
975
- "大盘复盘报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 schemas/market_review_schema.json 为准。仅渲染,不保存不推送",
1169
+ "大盘复盘报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 schemas/market_review_schema.json 为准。save=true 时把报告对象追加归档到本地 JSONL(默认不保存不推送),纵向对比用 get_review_history",
976
1170
  parameters: Type.Object({
977
1171
  report: Type.Object({}, { additionalProperties: true, description: "结构化市场复盘" }),
1172
+ save: Type.Optional(Type.Boolean({ description: "是否归档到本地复盘 JSONL 存储,默认 false" })),
978
1173
  }),
979
1174
  async execute(_id, params) {
980
1175
  const b64 = Buffer.from(JSON.stringify(params.report), "utf-8").toString("base64");
981
- const out = await runPy("report_renderer.py", ["market", "--input-b64", b64]);
1176
+ const out = await runPy("report_renderer.py", [
1177
+ "market",
1178
+ "--input-b64",
1179
+ b64,
1180
+ ...(params.save ? ["--save"] : []),
1181
+ ]);
1182
+ return asText(out);
1183
+ },
1184
+ });
1185
+
1186
+ api.registerTool({
1187
+ name: "get_review_history",
1188
+ description:
1189
+ "复盘归档历史 — 读取本地 JSONL 归档的最近 N 条市场复盘(最新在前),用于纵向对比(温度/姿态/主线变化)。归档由 render_market_report 的 save=true 写入,空存档返回空列表",
1190
+ parameters: Type.Object({
1191
+ limit: Type.Optional(Type.Number({ description: "返回条数,默认 10" })),
1192
+ }),
1193
+ async execute(_id, params) {
1194
+ const out = await runPy("market_review.py", ["history", "--limit", String(params.limit ?? 10)]);
982
1195
  return asText(out);
983
1196
  },
984
1197
  });
@@ -1043,7 +1256,7 @@ export default definePluginEntry({
1043
1256
  api.registerTool({
1044
1257
  name: "check_alert_rules",
1045
1258
  description:
1046
- "无状态告警规则检查 — 传入规则数组,返回当前是否触发。规则类型:price_below/price_above/change_pct_above/change_pct_below/volume_ratio_above/anomaly/risk_veto/risk_level_at_least。不做调度不存历史",
1259
+ "无状态告警规则检查 — 传入规则数组,返回当前是否触发。规则类型:price_below/price_above/change_pct_above/change_pct_below/volume_ratio_above/anomaly/risk_veto/risk_level_at_least。不做调度不存历史。依赖数据不可用时evaluated条目含error,meta.warnings提示缺失,triggered=false不代表检查成功",
1047
1260
  parameters: Type.Object({
1048
1261
  symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
1049
1262
  rules: Type.Array(
@@ -1105,7 +1318,7 @@ export default definePluginEntry({
1105
1318
  api.registerTool({
1106
1319
  name: "evaluate_signals",
1107
1320
  description:
1108
- "评估到期信号:拉取记录日之后的日K,判定 target_hit/stop_hit/timeout 并计算收益,回写存储。记录建议用 record_signal,胜率复盘用 get_signal_summary",
1321
+ "评估到期信号:拉取记录日之后的日K,判定 target_hit/stop_hit/timeout 并计算收益,回写存储。记录建议用 record_signal,胜率复盘用 get_signal_summary。历史K线未覆盖记录日时skipped_no_data并保持未结算,不能用较新行情代替",
1109
1322
  parameters: Type.Object({
1110
1323
  symbol: Type.Optional(
1111
1324
  Type.String({ description: "股票代码(可选,只评估该股的信号)" })
@@ -21,6 +21,8 @@
21
21
  "get_limit_up_pool",
22
22
  "get_dragon_tiger",
23
23
  "get_hot_stocks",
24
+ "get_margin_trading",
25
+ "get_northbound_flow",
24
26
  "get_fundamental_context",
25
27
  "screen_stocks",
26
28
  "run_backtest",
@@ -51,7 +53,17 @@
51
53
  "record_signal",
52
54
  "evaluate_signals",
53
55
  "get_signal_summary",
54
- "parse_stock_list"
56
+ "get_review_history",
57
+ "parse_stock_list",
58
+ "get_valuation_history",
59
+ "get_index_valuation",
60
+ "get_earnings_calendar",
61
+ "get_shareholder_structure",
62
+ "get_etf_details",
63
+ "get_dividends",
64
+ "get_announcements",
65
+ "get_us_holdings",
66
+ "get_insider_trades"
55
67
  ]
56
68
  },
57
69
  "activation": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openclaw-stock-analysis",
3
- "version": "0.2.2",
3
+ "version": "0.2.6",
4
4
  "description": "OpenClaw plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
5
5
  "type": "module",
6
6
  "main": "./index.ts",
@@ -48,9 +48,9 @@
48
48
  "type": "object",
49
49
  "description": "风险筛查结果(来自 screen_risk)",
50
50
  "properties": {
51
- "risk_level": { "type": "string", "enum": ["low", "medium", "high"] },
52
- "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 },
53
- "veto_buy": { "type": "boolean" },
51
+ "risk_level": { "type": "string", "enum": ["low", "medium", "high", "unknown"] },
52
+ "risk_score": { "type": ["integer", "null"], "minimum": 0, "maximum": 100 },
53
+ "veto_buy": { "type": ["boolean", "null"] },
54
54
  "flags": {
55
55
  "type": "array",
56
56
  "items": {
@@ -0,0 +1,29 @@
1
+ // Some model gateways resolve through Chinese DNS but not the runner's resolver.
2
+ // Keep the original hostname for HTTPS; only supply its missing A record.
3
+ import { execFileSync } from "node:child_process";
4
+ import { lookup } from "node:dns/promises";
5
+ import { isIP } from "node:net";
6
+
7
+ if (process.env.OPENAI_BASE_URL) {
8
+ const host = new URL(process.env.OPENAI_BASE_URL).hostname;
9
+ let resolved = false;
10
+ try {
11
+ await lookup(host, { family: 4 });
12
+ resolved = true;
13
+ } catch { /* ask a second resolver below */ }
14
+
15
+ if (!resolved) {
16
+ // Ask for the China-facing record; the runner's overseas view gets only a CNAME.
17
+ const url = `https://dns.alidns.com/resolve?name=${encodeURIComponent(host)}&type=A&edns_client_subnet=223.5.5.0%2F24`;
18
+ const response = await fetch(url, { signal: AbortSignal.timeout(10_000) });
19
+ if (!response.ok) throw new Error(`AliDNS lookup failed: HTTP ${response.status}`);
20
+ const answer = (await response.json()).Answer?.find((record) => record.type === 1);
21
+ if (isIP(answer?.data) !== 4) throw new Error(`No IPv4 address found for ${host}`);
22
+ execFileSync("sudo", ["tee", "-a", "/etc/hosts"], {
23
+ input: `${answer.data} ${host}\n`,
24
+ stdio: ["pipe", "ignore", "pipe"],
25
+ });
26
+ await fetch(`https://${host}/`, { signal: AbortSignal.timeout(10_000) });
27
+ console.log(`Resolved ${host} through AliDNS; HTTPS is reachable`);
28
+ }
29
+ }
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { execSync } from "node:child_process";
2
+ import { execFileSync } from "node:child_process";
3
3
  import { existsSync } from "node:fs";
4
4
  import { join } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
@@ -14,16 +14,16 @@ const venvDir = join(pkgDir, ".venv");
14
14
  const venvPython = venvPythonPath(pkgDir);
15
15
  const requirements = join(pkgDir, "tools", "requirements.txt");
16
16
 
17
- function run(cmd) {
18
- execSync(cmd, { stdio: "pipe", timeout: 300_000 });
17
+ function run(bin, args) {
18
+ execFileSync(bin, args, { stdio: "inherit", timeout: 1_800_000 });
19
19
  }
20
20
 
21
21
  function findPython() {
22
22
  for (const name of ["python3", "python"]) {
23
23
  try {
24
- const ver = execSync(`${name} --version`, { stdio: "pipe" }).toString().trim();
24
+ const ver = execFileSync(name, ["--version"], { stdio: "pipe" }).toString().trim();
25
25
  const match = ver.match(/(\d+)\.(\d+)/);
26
- if (match && (parseInt(match[1]) > 3 || (parseInt(match[1]) === 3 && parseInt(match[2]) >= 9))) {
26
+ if (match && (parseInt(match[1]) > 3 || (parseInt(match[1]) === 3 && parseInt(match[2]) >= 10))) {
27
27
  return name;
28
28
  }
29
29
  } catch {}
@@ -35,23 +35,21 @@ try {
35
35
  const python = findPython();
36
36
  if (!python) {
37
37
  console.warn(
38
- "\n[pi-stock-analysis] python3 >= 3.9 not found.\n" +
39
- "Install Python 3.9+ and re-run: npm rebuild pi-stock-analysis\n"
38
+ "\n[stock-analysis-plugin] python3 >= 3.10 not found.\n" +
39
+ "Install Python 3.10+, then re-run: npm install\n"
40
40
  );
41
- process.exit(0);
41
+ process.exit(1);
42
42
  }
43
43
 
44
44
  if (!existsSync(venvDir)) {
45
- run(`${python} -m venv "${venvDir}"`);
45
+ run(python, ["-m", "venv", venvDir]);
46
46
  }
47
47
 
48
- if (existsSync(requirements)) {
49
- run(`"${venvPython}" -m pip install -q -r "${requirements}"`);
50
- }
48
+ run(venvPython, ["-m", "pip", "install", "-q", "-r", requirements]);
51
49
  } catch (err) {
52
50
  console.warn(
53
51
  `\n[pi-stock-analysis] Python setup failed: ${err.message}\n` +
54
52
  "You can manually create the venv and install tools/requirements.txt with your platform's python.\n"
55
53
  );
56
- process.exit(0);
54
+ process.exit(1);
57
55
  }
@@ -1,24 +1,30 @@
1
1
  ---
2
2
  name: bull-trend
3
- description: 趋势追踪分析:识别中长期趋势、所处阶段和离场条件。用于多头排列、上升通道或持有趋势股。
3
+ description: 趋势交易:识别中长期趋势,制定入场、持仓和退出规则。用于趋势股持有、规则化趋势策略或肥尾收益分析。
4
4
  ---
5
5
 
6
6
  # 趋势追踪分析
7
7
 
8
8
  ## 核心理念
9
9
 
10
- 趋势追踪的核心是"顺势而为"——在确认趋势形成后入场,在趋势转弱时离场。不预测顶底,只跟随趋势。
10
+ 趋势追踪用可执行的规则参与趋势,通过控制试错损失、保留盈利空间捕获少数大行情。肥尾描述收益分布,趋势描述价格路径;肥尾指标不是趋势启动或延续信号。
11
+
12
+ 用户询问塔勒布、肥尾计算、极端行情或策略是否依赖少数大盈利时,先读取 [肥尾度量与趋势收益诊断](references/fat-tails.md)。概念问题直接解释方法;需要具体统计结果时,按参考中的数据口径准备输入并调用 `scripts/tail_analysis.py`。普通趋势判断无需加载这份参考。
13
+
14
+ 仅解释肥尾概念时,到此完成;下述流程用于具体标的的趋势分析。
11
15
 
12
16
  ## 执行流程
13
17
 
14
18
  ### 1. 采集数据
15
19
 
16
- 运行数据采集脚本获取 120 根日K线及技术指标:
20
+ 运行数据采集脚本获取 120 根日K线及技术指标(相对本 skill 目录执行):
17
21
 
18
22
  ```bash
19
23
  python3 scripts/gather.py <symbol>
20
24
  ```
21
25
 
26
+ 确认数据日期、周期和复权口径;120 根日K线用于近期趋势判断。肥尾分支按参考文件另取历史收益,报告实际取得的区间和样本量。
27
+
22
28
  ### 2. 趋势确认
23
29
 
24
30
  **多头趋势确认条件**:
@@ -32,26 +38,44 @@ python3 scripts/gather.py <symbol>
32
38
  - MACD 在零轴之下运行
33
39
  - 价格沿下降通道运行
34
40
 
41
+ 报告哪些条件已满足、哪些尚未满足,并给出对应数值或价格位置。空头趋势对仅能做多的股票账户意味着退出或观望;做空建议须有对应市场和账户能力。
42
+
35
43
  ### 3. 趋势阶段判断
36
44
 
37
45
  | 阶段 | 特征 | 操作 |
38
46
  |------|------|------|
39
- | 启动期 | 均线粘合后向上发散,放量突破 | 建仓 |
40
- | 加速期 | 价格加速上涨,远离均线 | 持有,注意高位风险 |
41
- | 成熟期 | 涨幅放缓,量能递减 | 逐步减仓 |
42
- | 衰退期 | 跌破 MA20 或趋势线 | 清仓 |
47
+ | 启动期 | 均线粘合后向上发散,放量突破 | 检查入场触发和初始风险 |
48
+ | 加速期 | 价格加速上涨,远离均线 | 按持仓规则跟踪,更新保护位 |
49
+ | 成熟期 | 涨幅放缓,量能递减 | 检查退出条件,阶段标签本身不触发减仓 |
50
+ | 衰退期 | 跌破预先选定的均线或趋势支撑 | 按退出规则执行 |
43
51
 
44
52
  ### 4. 关键指标
45
53
 
46
54
  - **ADX 替代**:用 MA 斜率和排列程度衡量趋势强度
47
55
  - **趋势线**:连接近期低点作为上升趋势线
48
- - **回调幅度**:健康回调通常不超过前一波涨幅的 38.2%-50%
56
+ - **回调幅度**:描述相对前一波涨幅的回撤及是否破坏支撑;斐波那契比例只作为观察位置,不能单独证明回调健康。
57
+
58
+ ### 5. 形成交易规则
59
+
60
+ 先读取 [短线交易决策框架](../stock-analysis/references/short-term-trading.md)的风险单位和市场成交约束,再形成同一套入场、持仓和退出规则:
61
+
62
+ - **入场**:指定周期、触发条件、判断时点和成交假设。例如收盘突破此前 20 根K线最高价,阈值排除当前K线;历史检验使用信号产生后可成交的价格。
63
+ - **初始风险**:给出初始止损、单笔风险预算和仓位。按预算 / 入场到止损的每股损失估算数量,并受资金、交易单位和组合风险限制;跳空和无法成交可能使实际亏损超过预算。
64
+ - **持仓**:趋势条件持续满足时保留盈利空间。保护位随有利走势更新,做多止损只上移;涨幅大或收益处于高分位本身不构成退出条件。
65
+ - **退出**:明确采用均线失效、通道破位或移动止损中的哪一种、如何触发。固定止盈属于可选策略约束,要说明它可能截断大盈利;参数是待检验假设,不归为塔勒布公式。
66
+
67
+ 规则完成标准:每项都有可核验的触发条件,说明下一次观察时点,以及触发后动作。用户已有规则时按其规则评价,调整另列为建议。
68
+
69
+ ### 6. 按需检验
70
+
71
+ 用户要求历史验证时使用 [策略回测](../strategy-backtest/SKILL.md)。先核对现有 DSL 能否表达规则,无法表达的条件标为未验证;不以近似规则冒充原策略。趋势收益的利润集中度诊断按肥尾参考文件执行。
49
72
 
50
73
  ## 输出要求
51
74
 
52
75
  分析完成后输出:
53
76
  1. 当前趋势方向和阶段
54
- 2. 趋势强度评分(1-10)
77
+ 2. 趋势证据和未满足条件
55
78
  3. 关键趋势支撑/压力位
56
79
  4. 入场/持有/离场建议
57
- 5. 止损位建议
80
+ 5. 初始风险、保护位和退出触发条件
81
+ 6. 数据或成交限制;肥尾分支附计算口径和不确定性