@weaxs/openclaw-stock-analysis 0.2.7 → 0.2.9
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 +1 -1
- package/dist/index.js +116 -20
- package/index.ts +88 -7
- package/openclaw.plugin.json +4 -1
- package/package.json +4 -3
- package/scripts/setup-python.mjs +11 -4
- package/scripts/venv-python.mjs +7 -0
- package/skills/bull-trend/SKILL.md +11 -1
- package/skills/bull-trend/references/monthly-trend-strategy.md +47 -0
- package/skills/bull-trend/references/trend-horizons.md +43 -0
- package/skills/bull-trend/references/trend-temperature.md +57 -0
- package/skills/bull-trend/scripts/market_trend.py +78 -0
- package/skills/event-driven/SKILL.md +2 -0
- package/skills/market-review/SKILL.md +1 -1
- package/skills/sector-rotation/SKILL.md +57 -0
- package/skills/sector-rotation/references/computation.md +83 -0
- package/skills/sector-rotation/references/strategy_rules.md +62 -0
- package/skills/sector-rotation/scripts/rotation_metrics.py +11 -0
- package/skills/stock-analysis/SKILL.md +5 -2
- package/skills/stock-analysis/references/host-workflows.md +45 -0
- package/skills/stock-screener/SKILL.md +2 -0
- package/skills/strategy-backtest/SKILL.md +12 -0
- package/tools/backtest.py +70 -5
- package/tools/capabilities.py +6 -0
- package/tools/cli_budgets.json +3 -1
- package/tools/report_renderer.py +4 -0
- package/tools/sector_rotation.py +466 -0
- package/tools/technical.py +186 -0
- package/tools/trend_strategy.py +365 -0
package/README.md
CHANGED
package/dist/index.js
CHANGED
|
@@ -55,7 +55,9 @@ var cli_budgets_default = {
|
|
|
55
55
|
l2_workers: 6,
|
|
56
56
|
watchlist_item: 480,
|
|
57
57
|
"stateless_analysis.py:event_study": 300,
|
|
58
|
-
"stateless_analysis.py:robustness": 660
|
|
58
|
+
"stateless_analysis.py:robustness": 660,
|
|
59
|
+
"trend_strategy.py:fetch": 660,
|
|
60
|
+
"sector_rotation.py:backtest": 300
|
|
59
61
|
};
|
|
60
62
|
|
|
61
63
|
// scripts/cli-timeout.mjs
|
|
@@ -84,11 +86,22 @@ function commandTimeout(script, args) {
|
|
|
84
86
|
return budget * 1e3 + 3e4;
|
|
85
87
|
}
|
|
86
88
|
|
|
87
|
-
//
|
|
89
|
+
// scripts/venv-python.mjs
|
|
88
90
|
import { existsSync } from "node:fs";
|
|
91
|
+
import { join as join2 } from "node:path";
|
|
92
|
+
var isWin = process.platform === "win32";
|
|
93
|
+
function pythonEnvironmentRoot(rootDir) {
|
|
94
|
+
return existsSync(join2(rootDir, "openclaw.plugin.json")) ? join2(rootDir, "node_modules", ".stock-analysis-python") : rootDir;
|
|
95
|
+
}
|
|
96
|
+
function venvPythonPath(rootDir) {
|
|
97
|
+
return join2(rootDir, ".venv", isWin ? "Scripts" : "bin", isWin ? "python.exe" : "python3");
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// openclaw/index.ts
|
|
101
|
+
import { existsSync as existsSync2 } from "node:fs";
|
|
89
102
|
import * as cp from "node:child_process";
|
|
90
103
|
import { promisify } from "node:util";
|
|
91
|
-
import { dirname, join as
|
|
104
|
+
import { dirname, join as join3 } from "node:path";
|
|
92
105
|
import { fileURLToPath } from "node:url";
|
|
93
106
|
|
|
94
107
|
// node_modules/typebox/build/system/memory/memory.mjs
|
|
@@ -4525,28 +4538,39 @@ function __setExecutor(fn) {
|
|
|
4525
4538
|
executor = fn;
|
|
4526
4539
|
}
|
|
4527
4540
|
var here = dirname(fileURLToPath(import.meta.url));
|
|
4528
|
-
var toolsDir =
|
|
4541
|
+
var toolsDir = existsSync2(join3(here, "tools")) ? join3(here, "tools") : join3(here, "..", "tools");
|
|
4529
4542
|
var fallbackRoot = dirname(toolsDir);
|
|
4530
|
-
var
|
|
4531
|
-
var venvBin =
|
|
4543
|
+
var isWin2 = process.platform === "win32";
|
|
4544
|
+
var venvBin = join3(".venv", isWin2 ? "Scripts" : "bin", isWin2 ? "python.exe" : "python3");
|
|
4532
4545
|
function asText(text) {
|
|
4533
4546
|
return { content: [{ type: "text", text }] };
|
|
4534
4547
|
}
|
|
4548
|
+
function asReport(text) {
|
|
4549
|
+
const result = asText(text);
|
|
4550
|
+
try {
|
|
4551
|
+
const report = JSON.parse(text);
|
|
4552
|
+
if (report?.final === true && !Object.hasOwn(report, "error") && report.format === "markdown" && typeof report.content === "string" && report.content.trim()) {
|
|
4553
|
+
return { ...result, details: { sourceReply: { text: report.content } } };
|
|
4554
|
+
}
|
|
4555
|
+
} catch {
|
|
4556
|
+
}
|
|
4557
|
+
return result;
|
|
4558
|
+
}
|
|
4535
4559
|
var index_default = definePluginEntry({
|
|
4536
4560
|
id: "stock-analysis",
|
|
4537
4561
|
name: "Stock Analysis",
|
|
4538
4562
|
description: "Stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
|
|
4539
4563
|
register(api) {
|
|
4540
4564
|
const repoRoot = api.rootDir || fallbackRoot;
|
|
4541
|
-
const runtimeToolsDir =
|
|
4565
|
+
const runtimeToolsDir = existsSync2(join3(repoRoot, "tools")) ? join3(repoRoot, "tools") : toolsDir;
|
|
4542
4566
|
const pythonBin = () => {
|
|
4543
|
-
const venvPython =
|
|
4544
|
-
if (
|
|
4545
|
-
const parentVenvPython =
|
|
4546
|
-
if (
|
|
4547
|
-
return
|
|
4567
|
+
const venvPython = venvPythonPath(pythonEnvironmentRoot(repoRoot));
|
|
4568
|
+
if (existsSync2(venvPython)) return venvPython;
|
|
4569
|
+
const parentVenvPython = join3(repoRoot, "..", venvBin);
|
|
4570
|
+
if (existsSync2(parentVenvPython)) return parentVenvPython;
|
|
4571
|
+
return isWin2 ? "python" : "python3";
|
|
4548
4572
|
};
|
|
4549
|
-
const runPy = (script, args) => executor(pythonBin(), [
|
|
4573
|
+
const runPy = (script, args) => executor(pythonBin(), [join3(runtimeToolsDir, script), ...args]);
|
|
4550
4574
|
api.registerTool({
|
|
4551
4575
|
name: "compare_stocks",
|
|
4552
4576
|
description: "\u65E0\u72B6\u6001\u540C\u884C\u6307\u6807\u6BD4\u8F83\uFF1A\u5148\u7528\u73B0\u6709\u8D22\u52A1/\u884C\u60C5\u5DE5\u5177\u53D6\u6570\uFF0C\u518D\u4F20companies\uFF1B\u4EC5\u76F8\u540Cunit/basis/period\u53EF\u6392\u5E8F\uFF0C\u7F3A\u5931\u4E0D\u586B\u96F6\uFF0C\u4E0D\u751F\u6210\u4E70\u5356\u7EFC\u5408\u5206\u3002",
|
|
@@ -4939,7 +4963,7 @@ var index_default = definePluginEntry({
|
|
|
4939
4963
|
});
|
|
4940
4964
|
api.registerTool({
|
|
4941
4965
|
name: "get_technical_analysis",
|
|
4942
|
-
description: "\u83B7\u53D6\u80A1\u7968\u6280\u672F\u9762\u5206\u6790\uFF08MA/MACD/RSI/BOLL/KDJ/\u6210\u4EA4\u91CF\u7B49\u6307\u6807 + 100\u5206\u7EFC\u5408\u8BC4\u5206 + 6\u7EA7\u4E70\u5356\u4FE1\u53F7 + \u8D8B\u52BF/\u504F\u79BB\u5EA6/\u652F\u6491\u538B\u529B\u4F4D\uFF1B\u591A\u5468\u671F\u5171\u632F\u65F6 resonance.direction \u2208 aligned_bullish/aligned_bearish/divergent\uFF09\u3002\u4E2A\u80A1\u6280\u672F\u9762\u7EFC\u5408\u5224\u65AD\u4E0E\u4E70\u5356\u65F6\u673A\u5206\u6790\u7684\u9996\u9009\uFF1B\u53EA\u8981\u5747\u7EBF\u6570\u503C\u6216\u81EA\u5B9A\u4E49\u5468\u671F\u7528 calculate_ma\uFF0C\u4E13\u95EE\u91CF\u4EF7\u7528 get_volume_analysis\uFF0C\u626B\u5F53\u65E5\u5F02\u52A8\u7528 detect_anomaly",
|
|
4966
|
+
description: "\u83B7\u53D6\u80A1\u7968\u6280\u672F\u9762\u5206\u6790\uFF08MA/MACD/RSI/BOLL/KDJ/\u6210\u4EA4\u91CF\u7B49\u6307\u6807 + 100\u5206\u7EFC\u5408\u8BC4\u5206 + 6\u7EA7\u4E70\u5356\u4FE1\u53F7 + \u8D8B\u52BF/\u504F\u79BB\u5EA6/\u652F\u6491\u538B\u529B\u4F4D\uFF1B\u9644 trend_temperature\uFF08\u5B9E\u9A8C\u6027EMA\u5DEE/ATR\u63CF\u8FF0\uFF1Bdirection\u4E3A\u5747\u7EBF\u65B9\u5411\uFF1Bvalidation_status=not_validated\uFF0C\u975E\u661F\u7403\u6307\u6807\uFF0C\u4E03\u6863\u4E0D\u4F5C\u5165\u573A\u4F9D\u636E\uFF1B\u53E6\u9644 trend_horizons\uFF1A21/63/252\u6839\u65E5K\u6708\u5EA6\u52A8\u91CF\uFF0C\u5EFA\u8BAEcount=360\uFF0C\u975E\u6982\u7387\u3001\u672A\u9A8C\u8BC1\uFF09\uFF1B\u591A\u5468\u671F\u5171\u632F\u65F6 resonance.direction \u2208 aligned_bullish/aligned_bearish/divergent\uFF09\u3002\u4E2A\u80A1\u6280\u672F\u9762\u7EFC\u5408\u5224\u65AD\u4E0E\u4E70\u5356\u65F6\u673A\u5206\u6790\u7684\u9996\u9009\uFF1B\u53EA\u8981\u5747\u7EBF\u6570\u503C\u6216\u81EA\u5B9A\u4E49\u5468\u671F\u7528 calculate_ma\uFF0C\u4E13\u95EE\u91CF\u4EF7\u7528 get_volume_analysis\uFF0C\u626B\u5F53\u65E5\u5F02\u52A8\u7528 detect_anomaly",
|
|
4943
4967
|
parameters: typebox_exports.Object({
|
|
4944
4968
|
symbol: typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08A\u80A1\u5982600519\uFF0C\u7F8E\u80A1\u5982AAPL\uFF0C\u6E2F\u80A1\u598200700.HK\uFF09" }),
|
|
4945
4969
|
period: typebox_exports.Optional(
|
|
@@ -5262,9 +5286,73 @@ var index_default = definePluginEntry({
|
|
|
5262
5286
|
return asText(out);
|
|
5263
5287
|
}
|
|
5264
5288
|
});
|
|
5289
|
+
api.registerTool({
|
|
5290
|
+
name: "calculate_rotation_metrics",
|
|
5291
|
+
description: "\u884C\u4E1A\u8F6E\u52A8\u6570\u503C\u590D\u6838\uFF1A\u8F93\u5165\u771F\u5B9EMC-dropout\u6837\u672C\u548C/\u6216\u5386\u53F2\u6210\u4EA4\u8BA1\u6570\uFF0C\u8BA1\u7B97\u96C6\u4E2D\u5EA6\u548C\u539F\u59CB\u914D\u6743\uFF1B\u4E0D\u8BAD\u7EC3\u6A21\u578B\u3001\u4E0D\u751F\u6210\u4E70\u5165\u4FE1\u53F7\uFF0C\u96F6\u5386\u53F2\u4E0D\u8865\u9ED8\u8BA4\u503C\u3002",
|
|
5292
|
+
parameters: typebox_exports.Object({
|
|
5293
|
+
prediction_samples: typebox_exports.Optional(typebox_exports.Array(typebox_exports.Object({
|
|
5294
|
+
symbol: typebox_exports.String({ "description": "\u552F\u4E00\u6807\u7684\u6807\u8BC6" }),
|
|
5295
|
+
samples: typebox_exports.Array(typebox_exports.Number({ "description": "\u540C\u4E00\u6A21\u578B/\u6807\u7684/\u65F6\u95F4\u7684\u6709\u9650\u7EBF\u6027\u8F93\u51FA\uFF0C\u4E0D\u662F\u4EF7\u683C\u6216\u6536\u76CA\u7387" }), { "description": "2..100000\u4E2A\u771F\u5B9EMC-dropout\u9884\u6D4B\uFF1B\u4E0D\u5F97\u7528\u968F\u673A\u6570\u6216\u52A8\u91CF\u4EE3\u66FF" })
|
|
5296
|
+
}, { "additionalProperties": false }), { "description": "1..100\u7EC4\uFF0C\u603B\u6837\u672C<=100000\uFF1B\u548Ctrade_counts\u81F3\u5C11\u63D0\u4F9B\u4E00\u9879" })),
|
|
5297
|
+
trade_counts: typebox_exports.Optional(typebox_exports.Array(typebox_exports.Object({
|
|
5298
|
+
symbol: typebox_exports.String({ "description": "\u552F\u4E00\u6807\u7684\u6807\u8BC6\uFF1B\u4EE3\u7801\u522B\u540D\u987B\u5148\u7EDF\u4E00" }),
|
|
5299
|
+
buys: typebox_exports.Number({ "description": "\u6B64\u524D\u5DF2\u5E73\u4ED3\u4E70\u5165\u5468\u6570\uFF0C\u975E\u8D1F\u6574\u6570" }),
|
|
5300
|
+
wins: typebox_exports.Number({ "description": "\u6B64\u524D\u76C8\u5229\u5E73\u4ED3\u6B21\u6570\uFF0C0..buys" }),
|
|
5301
|
+
streak: typebox_exports.Number({ "description": "\u6B64\u524D\u8FDE\u7EED\u76C8\u5229\u4EA4\u6613\u6B21\u6570\uFF0C0..wins" })
|
|
5302
|
+
}, { "additionalProperties": false }), { "description": "1..100\u6761\u5DF2\u5B8C\u6210\u5386\u53F2\u6210\u4EA4\u8BA1\u6570\uFF1B\u4E0D\u5F97\u4F7F\u7528\u51B3\u7B56\u540E\u7684\u4EA4\u6613" }))
|
|
5303
|
+
}, { "additionalProperties": false }),
|
|
5304
|
+
async execute(_id, params) {
|
|
5305
|
+
return asText(await withJsonInput(params, (path) => runPy("sector_rotation.py", ["analyze", "--input", path])));
|
|
5306
|
+
}
|
|
5307
|
+
});
|
|
5308
|
+
api.registerTool({
|
|
5309
|
+
name: "backtest_rotation_allocation",
|
|
5310
|
+
description: "\u884C\u4E1A\u8F6E\u52A8\u914D\u6743\u5206\u9879\u56DE\u6D4B\uFF1A\u4EE3\u7801\u81EA\u52A8\u53D6\u884C\u60C5\uFF0C\u6216\u4F20\u660E\u786E\u5E01\u79CD/\u590D\u6743OHLCV\uFF1B\u76F8\u540C\u6BCF\u5468\u5168\u6C60\u4E70\u5356\u4E0B\u6BD4\u8F83\u7B49\u6743\u4E0E\u5386\u53F2\u914D\u6743\u3002\u6309\u5E02\u573A\u548C\u62A5\u4EF7\u5E01\u79CD\u72EC\u7ACB\u8D44\u91D1\uFF0C\u652F\u6301A/HK/US/JP/KR/TW\uFF1B\u4E0D\u662F\u5B8C\u6574\u8BBA\u6587\u6DF1\u5EA6\u6A21\u578B\u6216\u8DE8\u5E01\u79CD\u5171\u4EAB\u8D44\u91D1\u56DE\u6D4B\u3002",
|
|
5311
|
+
parameters: typebox_exports.Object({
|
|
5312
|
+
symbols: typebox_exports.Optional(typebox_exports.Array(typebox_exports.String({ "description": "\u552F\u4E00\u80A1\u7968/ETF\u4EE3\u7801\uFF0C\u6309\u63D2\u4EF6\u4EE3\u7801\u683C\u5F0F" }), { "description": "1..20\u53EA\u81EA\u52A8\u53D6\u6570\uFF0C\u4E0Edatasets\u4E92\u65A5\uFF1B\u4EFB\u4E00\u5931\u8D25\u6574\u6C60\u505C\u6B62" })),
|
|
5313
|
+
datasets: typebox_exports.Optional(typebox_exports.Array(typebox_exports.Object({
|
|
5314
|
+
symbol: typebox_exports.String({ "description": "A\u516D\u4F4D\u4EE3\u7801/HK\u59822800.HK/US\u5982XLK/JP\u59821306.T/KR\u5982069500.KS/TW\u59820050.TW" }),
|
|
5315
|
+
currency: typebox_exports.String({ "description": "\u5DF2\u6838\u5B9E\u62A5\u4EF7\u5E01\u79CD\u4E09\u5B57\u6BCD\u4EE3\u7801\uFF0C\u4E0D\u6309\u4E0A\u5E02\u5730\u731C\u6D4B" }),
|
|
5316
|
+
price_basis: typebox_exports.Union([typebox_exports.Literal("qfq"), typebox_exports.Literal("total_return"), typebox_exports.Literal("split_adjusted")], { "description": "\u5DF2\u6838\u5B9E\u4E14\u4E00\u81F4\u7684\u590D\u6743\u53E3\u5F84" }),
|
|
5317
|
+
bars: typebox_exports.Array(typebox_exports.Object({
|
|
5318
|
+
date: typebox_exports.String({ "description": "YYYY-MM-DD" }),
|
|
5319
|
+
open: typebox_exports.Number({ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F" }),
|
|
5320
|
+
high: typebox_exports.Number({ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F" }),
|
|
5321
|
+
low: typebox_exports.Number({ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F" }),
|
|
5322
|
+
close: typebox_exports.Number({ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F" }),
|
|
5323
|
+
volume: typebox_exports.Number({ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F" }),
|
|
5324
|
+
adjusted: typebox_exports.Optional(typebox_exports.String({ "description": "\u53EF\u9009\u9010bar\u590D\u6743\u6807\u8BB0\uFF0C\u5B58\u5728\u65F6\u5FC5\u987B\u4E0Eprice_basis\u4E00\u81F4" })),
|
|
5325
|
+
source: typebox_exports.Optional(typebox_exports.String({ "description": "\u53EF\u9009\u884C\u60C5\u6765\u6E90\u6807\u8BC6\uFF0C\u7528\u4E8E\u6570\u636E\u8986\u76D6\u62A5\u544A" }))
|
|
5326
|
+
}, { "additionalProperties": false }), { "description": "\u9012\u589E\u552F\u4E00daily OHLCV\uFF0C2..20000\u884C\uFF0C\u5305\u542B\u8BC4\u4F30\u524D\u9884\u70ED\uFF1B\u603B\u91CF<=100000" })
|
|
5327
|
+
}, { "additionalProperties": false }), { "description": "1..20\u4E2A\u79BB\u7EBF\u6570\u636E\u96C6\uFF0C\u4E0Esymbols\u4E92\u65A5\uFF1B8MiB JSON\u8F93\u5165\u4E0A\u9650" })),
|
|
5328
|
+
start_date: typebox_exports.String({ "description": "\u8BC4\u4F30\u8D77\u59CBYYYY-MM-DD\uFF1B\u8DE8\u8FB9\u754C\u5468\u4E0D\u4EA4\u6613\uFF0C\u4E0D\u80FD\u7528\u8BC4\u4F30\u671F\u6536\u76CA\u521D\u59CB\u5316\u914D\u6743" }),
|
|
5329
|
+
end_date: typebox_exports.String({ "description": "\u5DF2\u6536\u76D8\u622A\u6B62YYYY-MM-DD\uFF1B\u4E0D\u5B8C\u6574\u672B\u5468\u4E0D\u6210\u4EA4" }),
|
|
5330
|
+
history_start_date: typebox_exports.Optional(typebox_exports.String({ "description": "\u4EC5\u4EE3\u7801\u6A21\u5F0F\uFF1B\u9ED8\u8BA4\u8BC4\u4F30\u524D\u4E00\u5E74\uFF0C\u5FC5\u987B\u65E9\u4E8Estart_date" })),
|
|
5331
|
+
warmup_weeks: typebox_exports.Optional(typebox_exports.Number({ "description": "\u8BC4\u4F30\u524D\u5B8C\u6574\u5386\u53F2\u4EA4\u6613\u54681..104\u6574\u6570\uFF0C\u9ED8\u8BA426\uFF1B\u4E0D\u8DB3\u505C\u6B62" })),
|
|
5332
|
+
capital: typebox_exports.Optional(typebox_exports.Number({ "description": "\u6BCF\u5E02\u573A/\u62A5\u4EF7\u5E01\u79CD\u5206\u7EC4\u72EC\u7ACB\u521D\u59CB\u8D44\u91D1\uFF0C\u9ED8\u8BA41000000\uFF0C\u4E0D\u662F\u6DF7\u5408\u6C60\u603B\u989D" })),
|
|
5333
|
+
cost_per_side: typebox_exports.Optional(typebox_exports.Number({ "description": "\u6BCF\u8FB9\u6BD4\u4F8B\u6210\u672C0..0.1\uFF0C\u9ED8\u8BA40.001\uFF1B\u4E70\u5165\u9884\u7B97\u542B\u8D39\u7528" }))
|
|
5334
|
+
}, { "additionalProperties": false }),
|
|
5335
|
+
async execute(_id, params) {
|
|
5336
|
+
return asText(await withJsonInput(params, (path) => runPy("sector_rotation.py", ["backtest", "--input", path])));
|
|
5337
|
+
}
|
|
5338
|
+
});
|
|
5339
|
+
api.registerTool({
|
|
5340
|
+
name: "analyze_trend_strategy",
|
|
5341
|
+
description: "\u6708\u5EA6\u53F3\u4FA7\u8D8B\u52BF\u7B56\u7565\uFF1A\u76F4\u63A5\u4F20\u540C\u5E02\u573AA/HK/US\u80A1\u7968\u4EE3\u7801\uFF0C\u81EA\u52A8\u83B7\u53D6\u65E5K\uFF0C\u8F93\u51FA\u6708\u5EA6\u65B0\u5165/\u6301\u6709/\u9000\u51FA\u4E0E\u9006\u6CE2\u52A8\u9884\u7B97\u3002as_of\u9ED8\u8BA4\u6700\u8FD1\u5DF2\u6536\u76D8\u4EA4\u6613\u65E5\uFF0C\u6301\u4ED3\u53EF\u9009\u4E14\u4E0D\u4FDD\u5B58\uFF0C\u4E0D\u81EA\u52A8\u4E0B\u5355\uFF1B\u8DE8\u6837\u672C\u4ECDnot_validated\u3002",
|
|
5342
|
+
parameters: typebox_exports.Object({
|
|
5343
|
+
symbols: typebox_exports.Array(typebox_exports.String(), { description: "\u540C\u4E00\u5E02\u573A\u7684\u5B8C\u6574\u80A1\u7968\u6C60\uFF0C1..100\u53EA\uFF1BA\u5982600036\uFF0CHK\u59820700.HK\uFF0CUS\u5982AAPL" }),
|
|
5344
|
+
as_of: typebox_exports.Optional(typebox_exports.String({ description: "\u53EF\u9009\u5DF2\u6536\u76D8\u622A\u6B62\u65E5\u671FYYYY-MM-DD\uFF0C\u9ED8\u8BA4\u8BE5\u5E02\u573A\u6700\u8FD1\u5DF2\u6536\u76D8\u4EA4\u6613\u65E5" })),
|
|
5345
|
+
held_symbols: typebox_exports.Optional(typebox_exports.Array(typebox_exports.String(), { description: "\u53EF\u9009\uFF0Cas_of\u65F6\u771F\u5B9E\u6301\u80A1\u4EE3\u7801\uFF0C\u5FC5\u987B\u5728\u80A1\u7968\u6C60\u4E2D\uFF1B\u7701\u7565\u4EE3\u8868\u521D\u59CB\u7A7A\u4ED3\uFF0C\u4E0D\u4FDD\u5B58\u8D26\u6237" })),
|
|
5346
|
+
pending_exit_symbols: typebox_exports.Optional(typebox_exports.Array(typebox_exports.String(), { description: "\u53EF\u9009\uFF0C\u771F\u5B9E\u6301\u80A1\u4E2D\u6B64\u524D\u5DF2\u9501\u5B9A\u4E14\u672A\u6210\u4EA4\u7684\u9000\u51FA\u4EE3\u7801" })),
|
|
5347
|
+
slots: typebox_exports.Optional(typebox_exports.Number({ description: "\u53EF\u9009\u56FA\u5B9A\u5BB9\u91CFK\uFF0C\u9ED8\u8BA4ceil(N/3)\uFF0C\u4E0D\u5F97\u5C0F\u4E8E\u771F\u5B9E\u6301\u80A1\u6570\u91CF" }))
|
|
5348
|
+
}, { additionalProperties: false }),
|
|
5349
|
+
async execute(_id, params) {
|
|
5350
|
+
return asText(await withJsonInput(params, (path) => runPy("trend_strategy.py", ["fetch", "--input", path])));
|
|
5351
|
+
}
|
|
5352
|
+
});
|
|
5265
5353
|
api.registerTool({
|
|
5266
5354
|
name: "run_backtest",
|
|
5267
|
-
description: "\u7B56\u7565\u56DE\u6D4B\uFF08AlphaEvo\uFF09\u3002\u8BFB\u53D6YAML\u7B56\u7565\u5B9A\u4E49\uFF0C\u5728\u5386\u53F2\u6570\u636E\u4E0A\u6A21\u62DF\u4EA4\u6613\uFF0C\u8F93\u51FA\u6536\u76CA\u7387/\u56DE\u64A4/\u80DC\u7387\u7B49\u6307\u6807\u3002\u53EA\u60F3\u77E5\u9053\u5355\u4E2A\u6280\u672F\u4FE1\u53F7\u7684\u5386\u53F2\u80DC\u7387\u7528\u66F4\u8F7B\u91CF\u7684 evaluate_signal\u3002period\u4E3A\u5B9E\u9645\u6570\u636E\u671F\u95F4\uFF0Crequested_period\u4FDD\u7559\u8BF7\u6C42\u671F\u95F4\uFF0Cwarnings\u63D0\u793A\u8986\u76D6\u5DEE\u5F02\uFF1B\u5E74\u5316\u6309\u5B9E\u9645\u671F\u95F4\u8BA1\u7B97\u3002\u9ED8\u8BA4\u524D\u65E5\u6536\u76D8\u4FE1\u53F7\u3001\u6B21\u65E5\u5F00\u76D8\u6210\u4EA4\uFF1BYAML simulation.execution=same_close\u53EF\u590D\u73B0\u65E7\u5047\u8BBE\u3002execution\u8FD4\u56DE\u6A21\u578B\u3001\u963B\u6B62\u6210\u4EA4\u6B21\u6570\u548C\u672A\u6A21\u62DF\u7EA6\u675F\uFF1B\u96F6\u6210\u4EA4\u91CF\u53CA\u5E26\u5386\u53F2\u9650\u4EF7\u7684\u4E00\u5B57\u677F\u4E0D\u6210\u4EA4\u3002",
|
|
5355
|
+
description: "\u7B56\u7565\u56DE\u6D4B\uFF08AlphaEvo\uFF09\u3002\u8BFB\u53D6YAML\u7B56\u7565\u5B9A\u4E49\uFF0C\u5728\u5386\u53F2\u6570\u636E\u4E0A\u6A21\u62DF\u4EA4\u6613\uFF0C\u8F93\u51FA\u6536\u76CA\u7387/\u56DE\u64A4/\u80DC\u7387\u7B49\u6307\u6807\u3002\u53EA\u60F3\u77E5\u9053\u5355\u4E2A\u6280\u672F\u4FE1\u53F7\u7684\u5386\u53F2\u80DC\u7387\u7528\u66F4\u8F7B\u91CF\u7684 evaluate_signal\u3002period\u4E3A\u5B9E\u9645\u6570\u636E\u671F\u95F4\uFF0Crequested_period\u4FDD\u7559\u8BF7\u6C42\u671F\u95F4\uFF0Cwarnings\u63D0\u793A\u8986\u76D6\u5DEE\u5F02\uFF1B\u5E74\u5316\u6309\u5B9E\u9645\u671F\u95F4\u8BA1\u7B97\u3002\u9ED8\u8BA4\u524D\u65E5\u6536\u76D8\u4FE1\u53F7\u3001\u6B21\u65E5\u5F00\u76D8\u6210\u4EA4\uFF1BYAML simulation.execution=same_close\u53EF\u590D\u73B0\u65E7\u5047\u8BBE\u3002execution\u8FD4\u56DE\u6A21\u578B\u3001\u963B\u6B62\u6210\u4EA4\u6B21\u6570\u548C\u672A\u6A21\u62DF\u7EA6\u675F\uFF1B\u96F6\u6210\u4EA4\u91CF\u53CA\u5E26\u5386\u53F2\u9650\u4EF7\u7684\u4E00\u5B57\u677F\u4E0D\u6210\u4EA4\u3002\u652F\u6301 monthly_momentum\uFF1A\u6708\u521D\u9996\u6839\u6709\u6548\u65E5K\u6536\u76D8\u89C2\u5BDF\u8FC7\u53BBperiod\u6839\u5BF9\u6570\u6536\u76CA\uFF0C\u6B21\u65E5\u5F00\u76D8\uFF1B\u957F\u5468\u671F\u9700\u9884\u70ED\u3002",
|
|
5268
5356
|
parameters: typebox_exports.Object({
|
|
5269
5357
|
strategy: typebox_exports.String({ description: "\u7B56\u7565YAML\u6587\u4EF6\u8DEF\u5F84" }),
|
|
5270
5358
|
symbol: typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08A\u80A1\u5982600519\uFF0C\u7F8E\u80A1\u5982AAPL\uFF0C\u6E2F\u80A1\u598200700.HK\uFF09" }),
|
|
@@ -5682,8 +5770,11 @@ var index_default = definePluginEntry({
|
|
|
5682
5770
|
});
|
|
5683
5771
|
api.registerTool({
|
|
5684
5772
|
name: "render_stock_report",
|
|
5685
|
-
description: "\u80A1\u7968\u5206\u6790\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 skill \u63D0\u4F9B\u7684 report_schema \u4E3A\u51C6\uFF0C\u4E0D\u8981\u81EA\u9020\u5B57\u6BB5\u3002template: brief|full\u3002\u5168\u90E8\u5206\u6790\u5B8C\u6210\u540E\u7684\u6700\u540E\u4E00\u6B65\u8C03\u7528\u3002\u4EC5\u6E32\u67D3\uFF0C\
|
|
5773
|
+
description: "\u80A1\u7968\u5206\u6790\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 skill \u63D0\u4F9B\u7684 report_schema \u4E3A\u51C6\uFF0C\u4E0D\u8981\u81EA\u9020\u5B57\u6BB5\u3002template: brief|full\u3002\u5168\u90E8\u5206\u6790\u5B8C\u6210\u540E\u7684\u6700\u540E\u4E00\u6B65\u8C03\u7528\u3002\u9ED8\u8BA4\u4EC5\u6E32\u67D3\uFF1Bfinal=true\u8868\u793A\u6700\u7EC8\u56DE\u590D\uFF0C\u652F\u6301\u76F4\u51FA\u7684\u5BBF\u4E3B\u53EF\u539F\u6837\u4EA4\u4ED8\u5E76\u7ED3\u675F\u672C\u8F6E\u3002report\u53EF\u5305\u542Bevidence\uFF08path/label/value/source/as_of\uFF09\u4E0Edata_quality\uFF08flags/limitations\uFF09\uFF0Cbrief/full\u5747\u5C55\u793A\u8BC1\u636E\u548C\u9650\u5236\u3002",
|
|
5774
|
+
canDeliverSourceReply: true,
|
|
5775
|
+
catalogMode: "direct-only",
|
|
5686
5776
|
parameters: typebox_exports.Object({
|
|
5777
|
+
final: typebox_exports.Optional(typebox_exports.Boolean({ description: "\u6700\u7EC8\u56DE\u590D\u6807\u8BB0\uFF0C\u9ED8\u8BA4false\uFF1B\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false" })),
|
|
5687
5778
|
report: typebox_exports.Object({}, { additionalProperties: true, description: "\u7ED3\u6784\u5316\u80A1\u7968\u62A5\u544A JSON" }),
|
|
5688
5779
|
template: typebox_exports.Optional(
|
|
5689
5780
|
typebox_exports.Union([typebox_exports.Literal("brief"), typebox_exports.Literal("full")], {
|
|
@@ -5698,15 +5789,19 @@ var index_default = definePluginEntry({
|
|
|
5698
5789
|
"--template",
|
|
5699
5790
|
params.template ?? "full",
|
|
5700
5791
|
"--input-b64",
|
|
5701
|
-
b64
|
|
5792
|
+
b64,
|
|
5793
|
+
...params.final ? ["--final"] : []
|
|
5702
5794
|
]);
|
|
5703
|
-
return
|
|
5795
|
+
return asReport(out);
|
|
5704
5796
|
}
|
|
5705
5797
|
});
|
|
5706
5798
|
api.registerTool({
|
|
5707
5799
|
name: "render_market_report",
|
|
5708
|
-
description: "\u5927\u76D8\u590D\u76D8\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 schemas/market_review_schema.json \u4E3A\u51C6\u3002save=true \u65F6\u628A\u62A5\u544A\u5BF9\u8C61\u8FFD\u52A0\u5F52\u6863\u5230\u672C\u5730 JSONL\uFF08\u9ED8\u8BA4\u4E0D\u4FDD\u5B58\u4E0D\u63A8\u9001\uFF09\uFF0C\u7EB5\u5411\u5BF9\u6BD4\u7528 get_review_history",
|
|
5800
|
+
description: "\u5927\u76D8\u590D\u76D8\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 schemas/market_review_schema.json \u4E3A\u51C6\u3002save=true \u65F6\u628A\u62A5\u544A\u5BF9\u8C61\u8FFD\u52A0\u5F52\u6863\u5230\u672C\u5730 JSONL\uFF08\u9ED8\u8BA4\u4E0D\u4FDD\u5B58\u4E0D\u63A8\u9001\uFF09\uFF0C\u7EB5\u5411\u5BF9\u6BD4\u7528 get_review_history\uFF1Bfinal=true\u4EC5\u7528\u4E8E\u6700\u7EC8\u56DE\u590D\uFF0C\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false",
|
|
5801
|
+
canDeliverSourceReply: true,
|
|
5802
|
+
catalogMode: "direct-only",
|
|
5709
5803
|
parameters: typebox_exports.Object({
|
|
5804
|
+
final: typebox_exports.Optional(typebox_exports.Boolean({ description: "\u6700\u7EC8\u56DE\u590D\u6807\u8BB0\uFF0C\u9ED8\u8BA4false\uFF1B\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false" })),
|
|
5710
5805
|
report: typebox_exports.Object({}, { additionalProperties: true, description: "\u7ED3\u6784\u5316\u5E02\u573A\u590D\u76D8" }),
|
|
5711
5806
|
save: typebox_exports.Optional(typebox_exports.Boolean({ description: "\u662F\u5426\u5F52\u6863\u5230\u672C\u5730\u590D\u76D8 JSONL \u5B58\u50A8\uFF0C\u9ED8\u8BA4 false" }))
|
|
5712
5807
|
}),
|
|
@@ -5716,9 +5811,10 @@ var index_default = definePluginEntry({
|
|
|
5716
5811
|
"market",
|
|
5717
5812
|
"--input-b64",
|
|
5718
5813
|
b64,
|
|
5814
|
+
...params.final ? ["--final"] : [],
|
|
5719
5815
|
...params.save ? ["--save"] : []
|
|
5720
5816
|
]);
|
|
5721
|
-
return
|
|
5817
|
+
return asReport(out);
|
|
5722
5818
|
}
|
|
5723
5819
|
});
|
|
5724
5820
|
api.registerTool({
|
package/index.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { withJsonInput } from "../scripts/json-input.mjs";
|
|
2
2
|
import { commandTimeout } from "../scripts/cli-timeout.mjs";
|
|
3
|
+
import { pythonEnvironmentRoot, venvPythonPath } from "../scripts/venv-python.mjs";
|
|
3
4
|
import { existsSync } from "node:fs";
|
|
4
5
|
import * as cp from "node:child_process";
|
|
5
6
|
import { promisify } from "node:util";
|
|
@@ -47,6 +48,20 @@ function asText(text: string) {
|
|
|
47
48
|
return { content: [{ type: "text" as const, text }] };
|
|
48
49
|
}
|
|
49
50
|
|
|
51
|
+
function asReport(text: string) {
|
|
52
|
+
const result = asText(text);
|
|
53
|
+
try {
|
|
54
|
+
const report = JSON.parse(text);
|
|
55
|
+
if (report?.final === true && !Object.hasOwn(report, "error") && report.format === "markdown"
|
|
56
|
+
&& typeof report.content === "string" && report.content.trim()) {
|
|
57
|
+
return { ...result, details: { sourceReply: { text: report.content } } };
|
|
58
|
+
}
|
|
59
|
+
} catch {
|
|
60
|
+
// Invalid output stays visible to the model and must never end the turn.
|
|
61
|
+
}
|
|
62
|
+
return result;
|
|
63
|
+
}
|
|
64
|
+
|
|
50
65
|
export default definePluginEntry({
|
|
51
66
|
id: "stock-analysis",
|
|
52
67
|
name: "Stock Analysis",
|
|
@@ -57,7 +72,7 @@ export default definePluginEntry({
|
|
|
57
72
|
const repoRoot = api.rootDir || fallbackRoot;
|
|
58
73
|
const runtimeToolsDir = existsSync(join(repoRoot, "tools")) ? join(repoRoot, "tools") : toolsDir;
|
|
59
74
|
const pythonBin = () => {
|
|
60
|
-
const venvPython =
|
|
75
|
+
const venvPython = venvPythonPath(pythonEnvironmentRoot(repoRoot));
|
|
61
76
|
if (existsSync(venvPython)) return venvPython;
|
|
62
77
|
// In a staged dev checkout, the venv still lives at the repo root.
|
|
63
78
|
const parentVenvPython = join(repoRoot, "..", venvBin);
|
|
@@ -494,7 +509,7 @@ export default definePluginEntry({
|
|
|
494
509
|
api.registerTool({
|
|
495
510
|
name: "get_technical_analysis",
|
|
496
511
|
description:
|
|
497
|
-
"获取股票技术面分析(MA/MACD/RSI/BOLL/KDJ/成交量等指标 + 100分综合评分 + 6级买卖信号 +
|
|
512
|
+
"获取股票技术面分析(MA/MACD/RSI/BOLL/KDJ/成交量等指标 + 100分综合评分 + 6级买卖信号 + 趋势/偏离度/支撑压力位;附 trend_temperature(实验性EMA差/ATR描述;direction为均线方向;validation_status=not_validated,非星球指标,七档不作入场依据;另附 trend_horizons:21/63/252根日K月度动量,建议count=360,非概率、未验证);多周期共振时 resonance.direction ∈ aligned_bullish/aligned_bearish/divergent)。个股技术面综合判断与买卖时机分析的首选;只要均线数值或自定义周期用 calculate_ma,专问量价用 get_volume_analysis,扫当日异动用 detect_anomaly",
|
|
498
513
|
parameters: Type.Object({
|
|
499
514
|
symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
|
|
500
515
|
period: Type.Optional(
|
|
@@ -851,10 +866,68 @@ export default definePluginEntry({
|
|
|
851
866
|
},
|
|
852
867
|
});
|
|
853
868
|
|
|
869
|
+
api.registerTool({
|
|
870
|
+
name: "calculate_rotation_metrics",
|
|
871
|
+
description: "行业轮动数值复核:输入真实MC-dropout样本和/或历史成交计数,计算集中度和原始配权;不训练模型、不生成买入信号,零历史不补默认值。",
|
|
872
|
+
parameters: Type.Object({prediction_samples: Type.Optional(Type.Array(Type.Object({symbol: Type.String({"description": "唯一标的标识"}),
|
|
873
|
+
samples: Type.Array(Type.Number({"description": "同一模型/标的/时间的有限线性输出,不是价格或收益率"}), {"description": "2..100000个真实MC-dropout预测;不得用随机数或动量代替"})}, {"additionalProperties": false}), {"description": "1..100组,总样本<=100000;和trade_counts至少提供一项"})),
|
|
874
|
+
trade_counts: Type.Optional(Type.Array(Type.Object({symbol: Type.String({"description": "唯一标的标识;代码别名须先统一"}),
|
|
875
|
+
buys: Type.Number({"description": "此前已平仓买入周数,非负整数"}),
|
|
876
|
+
wins: Type.Number({"description": "此前盈利平仓次数,0..buys"}),
|
|
877
|
+
streak: Type.Number({"description": "此前连续盈利交易次数,0..wins"})}, {"additionalProperties": false}), {"description": "1..100条已完成历史成交计数;不得使用决策后的交易"}))}, {"additionalProperties": false}),
|
|
878
|
+
async execute(_id, params) {
|
|
879
|
+
return asText(await withJsonInput(params, (path: string) =>
|
|
880
|
+
runPy("sector_rotation.py", ["analyze", "--input", path])));
|
|
881
|
+
},
|
|
882
|
+
});
|
|
883
|
+
|
|
884
|
+
api.registerTool({
|
|
885
|
+
name: "backtest_rotation_allocation",
|
|
886
|
+
description: "行业轮动配权分项回测:代码自动取行情,或传明确币种/复权OHLCV;相同每周全池买卖下比较等权与历史配权。按市场和报价币种独立资金,支持A/HK/US/JP/KR/TW;不是完整论文深度模型或跨币种共享资金回测。",
|
|
887
|
+
parameters: Type.Object({symbols: Type.Optional(Type.Array(Type.String({"description": "唯一股票/ETF代码,按插件代码格式"}), {"description": "1..20只自动取数,与datasets互斥;任一失败整池停止"})),
|
|
888
|
+
datasets: Type.Optional(Type.Array(Type.Object({symbol: Type.String({"description": "A六位代码/HK如2800.HK/US如XLK/JP如1306.T/KR如069500.KS/TW如0050.TW"}),
|
|
889
|
+
currency: Type.String({"description": "已核实报价币种三字母代码,不按上市地猜测"}),
|
|
890
|
+
price_basis: Type.Union([Type.Literal("qfq"), Type.Literal("total_return"), Type.Literal("split_adjusted")], {"description": "已核实且一致的复权口径"}),
|
|
891
|
+
bars: Type.Array(Type.Object({date: Type.String({"description": "YYYY-MM-DD"}),
|
|
892
|
+
open: Type.Number({"description": "有限正OHLC价格;volume非负"}),
|
|
893
|
+
high: Type.Number({"description": "有限正OHLC价格;volume非负"}),
|
|
894
|
+
low: Type.Number({"description": "有限正OHLC价格;volume非负"}),
|
|
895
|
+
close: Type.Number({"description": "有限正OHLC价格;volume非负"}),
|
|
896
|
+
volume: Type.Number({"description": "有限正OHLC价格;volume非负"}),
|
|
897
|
+
adjusted: Type.Optional(Type.String({"description": "可选逐bar复权标记,存在时必须与price_basis一致"})),
|
|
898
|
+
source: Type.Optional(Type.String({"description": "可选行情来源标识,用于数据覆盖报告"}))}, {"additionalProperties": false}), {"description": "递增唯一daily OHLCV,2..20000行,包含评估前预热;总量<=100000"})}, {"additionalProperties": false}), {"description": "1..20个离线数据集,与symbols互斥;8MiB JSON输入上限"})),
|
|
899
|
+
start_date: Type.String({"description": "评估起始YYYY-MM-DD;跨边界周不交易,不能用评估期收益初始化配权"}),
|
|
900
|
+
end_date: Type.String({"description": "已收盘截止YYYY-MM-DD;不完整末周不成交"}),
|
|
901
|
+
history_start_date: Type.Optional(Type.String({"description": "仅代码模式;默认评估前一年,必须早于start_date"})),
|
|
902
|
+
warmup_weeks: Type.Optional(Type.Number({"description": "评估前完整历史交易周1..104整数,默认26;不足停止"})),
|
|
903
|
+
capital: Type.Optional(Type.Number({"description": "每市场/报价币种分组独立初始资金,默认1000000,不是混合池总额"})),
|
|
904
|
+
cost_per_side: Type.Optional(Type.Number({"description": "每边比例成本0..0.1,默认0.001;买入预算含费用"}))}, {"additionalProperties": false}),
|
|
905
|
+
async execute(_id, params) {
|
|
906
|
+
return asText(await withJsonInput(params, (path: string) =>
|
|
907
|
+
runPy("sector_rotation.py", ["backtest", "--input", path])));
|
|
908
|
+
},
|
|
909
|
+
});
|
|
910
|
+
|
|
911
|
+
api.registerTool({
|
|
912
|
+
name: "analyze_trend_strategy",
|
|
913
|
+
description: "月度右侧趋势策略:直接传同市场A/HK/US股票代码,自动获取日K,输出月度新入/持有/退出与逆波动预算。as_of默认最近已收盘交易日,持仓可选且不保存,不自动下单;跨样本仍not_validated。",
|
|
914
|
+
parameters: Type.Object({
|
|
915
|
+
symbols: Type.Array(Type.String(), { description: "同一市场的完整股票池,1..100只;A如600036,HK如0700.HK,US如AAPL" }),
|
|
916
|
+
as_of: Type.Optional(Type.String({ description: "可选已收盘截止日期YYYY-MM-DD,默认该市场最近已收盘交易日" })),
|
|
917
|
+
held_symbols: Type.Optional(Type.Array(Type.String(), { description: "可选,as_of时真实持股代码,必须在股票池中;省略代表初始空仓,不保存账户" })),
|
|
918
|
+
pending_exit_symbols: Type.Optional(Type.Array(Type.String(), { description: "可选,真实持股中此前已锁定且未成交的退出代码" })),
|
|
919
|
+
slots: Type.Optional(Type.Number({ description: "可选固定容量K,默认ceil(N/3),不得小于真实持股数量" })),
|
|
920
|
+
}, { additionalProperties: false }),
|
|
921
|
+
async execute(_id, params) {
|
|
922
|
+
return asText(await withJsonInput(params, (path: string) =>
|
|
923
|
+
runPy("trend_strategy.py", ["fetch", "--input", path])));
|
|
924
|
+
},
|
|
925
|
+
});
|
|
926
|
+
|
|
854
927
|
api.registerTool({
|
|
855
928
|
name: "run_backtest",
|
|
856
929
|
description:
|
|
857
|
-
"策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal。period为实际数据期间,requested_period保留请求期间,warnings提示覆盖差异;年化按实际期间计算。默认前日收盘信号、次日开盘成交;YAML simulation.execution=same_close可复现旧假设。execution
|
|
930
|
+
"策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal。period为实际数据期间,requested_period保留请求期间,warnings提示覆盖差异;年化按实际期间计算。默认前日收盘信号、次日开盘成交;YAML simulation.execution=same_close可复现旧假设。execution返回模型、阻止成交次数和未模拟约束;零成交量及带历史限价的一字板不成交。支持 monthly_momentum:月初首根有效日K收盘观察过去period根对数收益,次日开盘;长周期需预热。",
|
|
858
931
|
parameters: Type.Object({
|
|
859
932
|
strategy: Type.String({ description: "策略YAML文件路径" }),
|
|
860
933
|
symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
|
|
@@ -1327,8 +1400,11 @@ export default definePluginEntry({
|
|
|
1327
1400
|
api.registerTool({
|
|
1328
1401
|
name: "render_stock_report",
|
|
1329
1402
|
description:
|
|
1330
|
-
"股票分析报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 skill 提供的 report_schema 为准,不要自造字段。template: brief|full
|
|
1403
|
+
"股票分析报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 skill 提供的 report_schema 为准,不要自造字段。template: brief|full。全部分析完成后的最后一步调用。默认仅渲染;final=true表示最终回复,支持直出的宿主可原样交付并结束本轮。report可包含evidence(path/label/value/source/as_of)与data_quality(flags/limitations),brief/full均展示证据和限制。",
|
|
1404
|
+
canDeliverSourceReply: true,
|
|
1405
|
+
catalogMode: "direct-only",
|
|
1331
1406
|
parameters: Type.Object({
|
|
1407
|
+
final: Type.Optional(Type.Boolean({ description: "最终回复标记,默认false;保存附件或继续分析时保持false" })),
|
|
1332
1408
|
report: Type.Object({}, { additionalProperties: true, description: "结构化股票报告 JSON" }),
|
|
1333
1409
|
template: Type.Optional(
|
|
1334
1410
|
Type.Union([Type.Literal("brief"), Type.Literal("full")], {
|
|
@@ -1344,16 +1420,20 @@ export default definePluginEntry({
|
|
|
1344
1420
|
params.template ?? "full",
|
|
1345
1421
|
"--input-b64",
|
|
1346
1422
|
b64,
|
|
1423
|
+
...(params.final ? ["--final"] : []),
|
|
1347
1424
|
]);
|
|
1348
|
-
return
|
|
1425
|
+
return asReport(out);
|
|
1349
1426
|
},
|
|
1350
1427
|
});
|
|
1351
1428
|
|
|
1352
1429
|
api.registerTool({
|
|
1353
1430
|
name: "render_market_report",
|
|
1354
1431
|
description:
|
|
1355
|
-
"大盘复盘报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 schemas/market_review_schema.json 为准。save=true 时把报告对象追加归档到本地 JSONL(默认不保存不推送),纵向对比用 get_review_history",
|
|
1432
|
+
"大盘复盘报告渲染 — 将结构化报告 JSON 通过 j2 模板渲染为 Markdown。report 字段以 schemas/market_review_schema.json 为准。save=true 时把报告对象追加归档到本地 JSONL(默认不保存不推送),纵向对比用 get_review_history;final=true仅用于最终回复,保存附件或继续分析时保持false",
|
|
1433
|
+
canDeliverSourceReply: true,
|
|
1434
|
+
catalogMode: "direct-only",
|
|
1356
1435
|
parameters: Type.Object({
|
|
1436
|
+
final: Type.Optional(Type.Boolean({ description: "最终回复标记,默认false;保存附件或继续分析时保持false" })),
|
|
1357
1437
|
report: Type.Object({}, { additionalProperties: true, description: "结构化市场复盘" }),
|
|
1358
1438
|
save: Type.Optional(Type.Boolean({ description: "是否归档到本地复盘 JSONL 存储,默认 false" })),
|
|
1359
1439
|
}),
|
|
@@ -1363,9 +1443,10 @@ export default definePluginEntry({
|
|
|
1363
1443
|
"market",
|
|
1364
1444
|
"--input-b64",
|
|
1365
1445
|
b64,
|
|
1446
|
+
...(params.final ? ["--final"] : []),
|
|
1366
1447
|
...(params.save ? ["--save"] : []),
|
|
1367
1448
|
]);
|
|
1368
|
-
return
|
|
1449
|
+
return asReport(out);
|
|
1369
1450
|
},
|
|
1370
1451
|
});
|
|
1371
1452
|
|
package/openclaw.plugin.json
CHANGED
|
@@ -70,7 +70,10 @@
|
|
|
70
70
|
"calculate_position_size",
|
|
71
71
|
"analyze_event_study",
|
|
72
72
|
"validate_backtest",
|
|
73
|
-
"compare_analysis_snapshots"
|
|
73
|
+
"compare_analysis_snapshots",
|
|
74
|
+
"analyze_trend_strategy",
|
|
75
|
+
"calculate_rotation_metrics",
|
|
76
|
+
"backtest_rotation_allocation"
|
|
74
77
|
]
|
|
75
78
|
},
|
|
76
79
|
"activation": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@weaxs/openclaw-stock-analysis",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.9",
|
|
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",
|
|
@@ -13,8 +13,8 @@
|
|
|
13
13
|
"minGatewayVersion": "2026.3.24-beta.2"
|
|
14
14
|
},
|
|
15
15
|
"build": {
|
|
16
|
-
"openclawVersion": "2026.
|
|
17
|
-
"pluginSdkVersion": "2026.
|
|
16
|
+
"openclawVersion": "2026.10.5",
|
|
17
|
+
"pluginSdkVersion": "2026.10.5"
|
|
18
18
|
}
|
|
19
19
|
},
|
|
20
20
|
"scripts": {
|
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
"README.md",
|
|
28
28
|
"tools/",
|
|
29
29
|
"skills/",
|
|
30
|
+
"!skills/**/__pycache__/**",
|
|
30
31
|
"schemas/",
|
|
31
32
|
"templates/",
|
|
32
33
|
"strategies/",
|
package/scripts/setup-python.mjs
CHANGED
|
@@ -1,17 +1,18 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { execFileSync } from "node:child_process";
|
|
3
|
-
import { existsSync } from "node:fs";
|
|
3
|
+
import { existsSync, mkdirSync, renameSync } from "node:fs";
|
|
4
4
|
import { join } from "node:path";
|
|
5
5
|
import { fileURLToPath } from "node:url";
|
|
6
|
-
import { venvPythonPath } from "./venv-python.mjs";
|
|
6
|
+
import { pythonEnvironmentRoot, venvPythonPath } from "./venv-python.mjs";
|
|
7
7
|
|
|
8
8
|
// fileURLToPath (not URL.pathname) — the latter yields a bogus "/C:/..." path
|
|
9
9
|
// on Windows, which would put the venv in the wrong place or fail outright.
|
|
10
10
|
const pkgDir = fileURLToPath(new URL("..", import.meta.url));
|
|
11
|
-
const
|
|
11
|
+
const envRoot = pythonEnvironmentRoot(pkgDir);
|
|
12
|
+
const venvDir = join(envRoot, ".venv");
|
|
12
13
|
// Drive pip through the venv's own python (`-m pip`) instead of a pip/pip.exe
|
|
13
14
|
// shim — resolves correctly on both POSIX (bin/python3) and Windows (Scripts/python.exe).
|
|
14
|
-
const venvPython = venvPythonPath(
|
|
15
|
+
const venvPython = venvPythonPath(envRoot);
|
|
15
16
|
const requirements = join(pkgDir, "tools", "requirements.txt");
|
|
16
17
|
|
|
17
18
|
function run(bin, args) {
|
|
@@ -41,6 +42,12 @@ try {
|
|
|
41
42
|
process.exit(1);
|
|
42
43
|
}
|
|
43
44
|
|
|
45
|
+
if (envRoot !== pkgDir && existsSync(join(pkgDir, ".venv"))) {
|
|
46
|
+
// Preserve installed dependencies; never leave an old environment in captured source.
|
|
47
|
+
if (existsSync(venvDir)) throw new Error("Both legacy and current Python environments exist; move the legacy .venv outside the plugin package");
|
|
48
|
+
mkdirSync(envRoot, { recursive: true });
|
|
49
|
+
renameSync(join(pkgDir, ".venv"), venvDir);
|
|
50
|
+
}
|
|
44
51
|
if (!existsSync(venvDir)) {
|
|
45
52
|
run(python, ["-m", "venv", venvDir]);
|
|
46
53
|
}
|
package/scripts/venv-python.mjs
CHANGED
|
@@ -6,6 +6,13 @@ import { join } from "node:path";
|
|
|
6
6
|
|
|
7
7
|
const isWin = process.platform === "win32";
|
|
8
8
|
|
|
9
|
+
// OpenClaw captures package source, including .venv symlinks; node_modules is excluded.
|
|
10
|
+
export function pythonEnvironmentRoot(rootDir) {
|
|
11
|
+
return existsSync(join(rootDir, "openclaw.plugin.json"))
|
|
12
|
+
? join(rootDir, "node_modules", ".stock-analysis-python")
|
|
13
|
+
: rootDir;
|
|
14
|
+
}
|
|
15
|
+
|
|
9
16
|
// Windows venvs ship Scripts/python.exe (there is no python3); POSIX venvs ship bin/python3.
|
|
10
17
|
export function venvPythonPath(rootDir) {
|
|
11
18
|
return join(rootDir, ".venv", isWin ? "Scripts" : "bin", isWin ? "python.exe" : "python3");
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bull-trend
|
|
3
|
-
description:
|
|
3
|
+
description: 趋势交易:识别中长期趋势,制定入场、持仓和退出规则。用于趋势温度计算、趋势股持有、规则化趋势策略或肥尾收益分析。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 趋势追踪分析
|
|
@@ -13,6 +13,10 @@ description: 趋势交易:识别中长期趋势,制定入场、持仓和退
|
|
|
13
13
|
|
|
14
14
|
仅解释肥尾概念时,到此完成;下述流程用于具体标的的趋势分析。
|
|
15
15
|
|
|
16
|
+
用户要求运行股票池月度右侧趋势策略时,MUST 先读取 [月度右侧趋势策略](references/monthly-trend-strategy.md),将股票名称解析为代码、按市场分组,直接调用 `analyze_trend_strategy(symbols, ...)` 自动取行情;仅在用户提供时传入真实持股集合,报告动作、原因与新仓预算。MUST 保留 `not_validated` 及跨样本失败边界;用户明确采用的规则可输出条件计划,实际成交和个人持仓由调用方核实。
|
|
17
|
+
|
|
18
|
+
仅要求解释多期限方向或复核旧温度时,先读取 [多期限月度趋势](references/trend-horizons.md),调用 `get_technical_analysis` 的 daily、count=360,优先解释 `trend_horizons` 的21/63/252期限组成、方向与观察日期。当前仍为 `not_validated`,MUST 说明交易有效性未被完整验证,MUST NOT 自行转换成交易建议。七档温度或旧模型复核才读取 [独立趋势温度](references/trend-temperature.md)并解释兼容字段 `trend_temperature`;仅用户明确要求七档时展示研究标签,不能把“平”当作零方向。这些都不是趋势动物、肥尾 κ、原综合评分或市场复盘温度;用户自定条件的研究回测仍可运行。
|
|
19
|
+
|
|
16
20
|
## 执行流程
|
|
17
21
|
|
|
18
22
|
### 1. 采集数据
|
|
@@ -25,6 +29,8 @@ python3 scripts/gather.py <symbol>
|
|
|
25
29
|
|
|
26
30
|
确认数据日期、周期和复权口径;120 根日K线用于近期趋势判断。肥尾分支按参考文件另取历史收益,报告实际取得的区间和样本量。
|
|
27
31
|
|
|
32
|
+
多期限分支报告 `model/validation_status/components/positive_count/negative_count/neutral_count/direction/decision_as_of/as_of/price_basis`;不足月初预热时先解释不可用,不能改用零值。通用采集脚本仍默认120根,不能据它声称已完成252根趋势判断,需另取daily、count=360。旧温度分支报告模型、EMA差方向、分数、日期及口径;七档只按明确请求补充。先确认观察K线收盘,未知价格口径需说明;不把样本不足当中性趋势。
|
|
33
|
+
|
|
28
34
|
### 2. 趋势确认
|
|
29
35
|
|
|
30
36
|
**多头趋势确认条件**:
|
|
@@ -79,3 +85,7 @@ python3 scripts/gather.py <symbol>
|
|
|
79
85
|
4. 入场/持有/离场建议
|
|
80
86
|
5. 初始风险、保护位和退出触发条件
|
|
81
87
|
6. 数据或成交限制;肥尾分支附计算口径和不确定性
|
|
88
|
+
|
|
89
|
+
### 市场环境入场实验
|
|
90
|
+
|
|
91
|
+
用户要求验证宽基右侧条件如何约束趋势入场时,读取[多期限参考中的市场环境实验](references/trend-horizons.md#市场环境入场实验),准备带足预热的个股/同市场宽基daily OHLCV JSON,再运行 `scripts/market_trend.py`。该脚本调用共享Python核心,输出真实规则的三期限研究结果。MUST 分清初始空仓与已有持仓、观察与成交、开发集与新标的复核;不得拿七档标签代替入场条件,或将通过单次历史门槛称为稳定有效。
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# 月度右侧趋势策略:上行SMA200与波动预算
|
|
2
|
+
|
|
3
|
+
开发样本曾通过效果门槛,扩展及历史样本仍未通过;`validation_status=not_validated`。采用它表示使用这套确定的规则,不表示已经验证未来收益。它不是趋势动物的私有温度公式。
|
|
4
|
+
|
|
5
|
+
## 调用
|
|
6
|
+
|
|
7
|
+
直接告诉Agent股票池即可,例如“用月度右侧趋势策略分析招商银行、工商银行和中国神华”。Agent解析代码后,调用四宿主共同的 `analyze_trend_strategy`:
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"symbols": ["600036", "601398", "601088"],
|
|
12
|
+
"held_symbols": ["600036"]
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
`symbols`为必填,其他字段均可选。插件自动获取整个股票池的日K,不要求用户准备文件或手工提供行情。混合市场由Agent按A/HK/US分组调用,各市场资金/币种独立。
|
|
17
|
+
|
|
18
|
+
|字段|要求|
|
|
19
|
+
|---|---|
|
|
20
|
+
|`symbols`|同一个市场的完整股票池,1–100只;A用六位代码,HK如`0700.HK`/`00700.HK`,US如`AAPL`;大小写与HK补零统一识别,同股不能重复|
|
|
21
|
+
|`as_of`|可选已收盘截止日期`YYYY-MM-DD`,默认交易所最近已收盘交易日;盘中排除当天未收盘K线,按实际日历处理夏令时与半日市|
|
|
22
|
+
|`held_symbols`|可选,as_of时真实持股代码,须在股票池中;省略表示初始空仓,Agent明确这个假设,挂买单不算持仓|
|
|
23
|
+
|`pending_exit_symbols`|可选,已发出但未成交的退出锁,必须在真实持仓内,价格恢复不撤销|
|
|
24
|
+
|`slots`|可选固定容量K,默认ceil(N/3),不得小于当前真实持股数量|
|
|
25
|
+
|
|
26
|
+
默认取至少360根daily;历史截止日期会增加取数长度以保留预热,接口有历史总量上限。有效价格不足221根时不填零,也不发明入场条件。所有数据沿现有行情源故障切换;任一成员取数失败,返回`incomplete_pool`和失败代码,不生成缩小股票池的计划。已取数据不合格则返回`invalid_market_data`。核对返回的`as_of/quote_as_of/price_basis`,停牌或报价未更新的成员仍显式列出。持仓只作为本次输入,不保存账户。
|
|
27
|
+
|
|
28
|
+
### 离线复核
|
|
29
|
+
|
|
30
|
+
开发者需要复现冻结研究时,CLI仍支持 `python3 tools/trend_strategy.py --input snapshot.json`。离线快照包含market/as_of/histories及可选held_symbols/pending_exit_symbols/slots,每条历史需要date/close/volume,可保留adjusted;日期递增唯一,价格为正且有限,量非负,最大32 MiB普通文件。该入口只用于已有行情的离线复核,正常插件工具使用上面的股票代码参数。
|
|
31
|
+
|
|
32
|
+
## 固定规则
|
|
33
|
+
|
|
34
|
+
1. 以股票池正成交量日期并集中的每月第一根收盘为观察点。当天不能按该收盘立即成交,最早是后续有效开盘。月中返回`waiting_for_monthly_observation`,只显示当前条件,不用今天持仓倒推月初交易。
|
|
35
|
+
2. 新入同时要求:close>SMA200,且SMA200高于21根有效价格以前的SMA200。按`log(close)-log(SMA200)`降序,代码破同分。
|
|
36
|
+
3. 真实旧仓优先占K槽。个股仍在200线上就保持原股份,排名下降或均线斜率转负不触发换仓;无有效报价时保持并占槽。已有200失效则给出`exit_next_valid_open`。已锁定退出始终返回`exit_pending`。
|
|
37
|
+
4. 每股sigma63为过去63段对数收益的样本标准差,需64根有效价格。参考中位数取观察日整个固定池有当日报价、sigma有限且>0的股票,包括尚不满足入场资格者。
|
|
38
|
+
5. 新入预算系数=`0.8704/K × min(1, median_sigma63 / stock_sigma63)`。低波动不扩大原槽,高波动折减;真实旧仓不按这个比例重新等权,不补仓。0.8704沿用已拟合的开发参数。
|
|
39
|
+
6. 没有合格新股可保持现金;空槽不必填满。选择新股不代表已经有可用现金或腾出槽位,须先确认退出真实成交。
|
|
40
|
+
|
|
41
|
+
## 输出和执行边界
|
|
42
|
+
|
|
43
|
+
报告`model/validation_status/status/as_of/observation_date/selected/reference_volatility/stocks`。每股有价格口径、报价日期、SMA200及21根前均线、distance、sigma63、资格、action、reason及new_budget_fraction。无充分旧仓历史时返回`insufficient_held_history`,不生成新的交易计划;先补齐历史。
|
|
44
|
+
|
|
45
|
+
`new_budget_fraction` 是下一执行批次开盘净值乘数,买入费用包含在预算内,**不是目标持仓权重,也不是买入股数**。真实成交还要核对可用现金、已完成卖出、实际整手、停牌/涨跌停/禁售、费用与结算;此工具没有订单簿、现金账本或成交模拟,不会自动下单。不使用复权close直接计算真实股数,不因一笔新仓没成交就当作已持有。
|
|
46
|
+
|
|
47
|
+
单股`get_technical_analysis`的`trend_temperature`与`trend_horizons`仍可辅助解释,但不是这套组合规则。普通单股YAML回测也不能代替共享资金、旧仓保留和整池风险中位数。本工具不计算历史组合收益,不把信号计划冒充组合回测。
|