@weaxs/openclaw-stock-analysis 0.2.5 → 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.
- package/dist/index.js +61 -10
- package/index.ts +65 -10
- package/openclaw.plugin.json +4 -1
- package/package.json +1 -1
- package/schemas/report_schema.json +3 -3
- package/scripts/setup-python.mjs +6 -6
- package/skills/bull-trend/SKILL.md +34 -10
- package/skills/bull-trend/references/fat-tails.md +91 -0
- package/skills/bull-trend/scripts/tail_analysis.py +132 -0
- package/skills/event-driven/SKILL.md +2 -0
- package/skills/growth-quality/SKILL.md +2 -0
- package/skills/stock-analysis/SKILL.md +9 -3
- package/skills/stock-screener/SKILL.md +2 -0
- package/skills/strategy-backtest/SKILL.md +4 -0
- package/skills/wisburg-research/SKILL.md +2 -0
- package/templates/stock_analysis/brief.md.j2 +4 -1
- package/templates/stock_analysis/full.md.j2 +6 -3
- package/tools/alert_rules.py +32 -4
- package/tools/backtest.py +22 -4
- package/tools/capabilities.py +3 -0
- package/tools/gather.py +20 -10
- package/tools/lixinger.py +100 -0
- package/tools/market_regime.py +7 -3
- package/tools/market_review.py +7 -6
- package/tools/position_context.py +20 -2
- package/tools/report_renderer.py +2 -0
- package/tools/risk_screening.py +45 -17
- package/tools/screener.py +17 -9
- package/tools/sec_edgar.py +346 -0
- package/tools/sec_holders.py +263 -0
- package/tools/signal_tracker.py +142 -19
- package/tools/stock_data.py +80 -17
- package/tools/technical.py +16 -2
- package/tools/value_data.py +159 -0
- package/tools/watchlist.py +24 -1
- package/tools/watchlist_context.py +7 -3
package/dist/index.js
CHANGED
|
@@ -4427,8 +4427,18 @@ __export(typebox_exports, {
|
|
|
4427
4427
|
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
|
|
4428
4428
|
var defaultExecutor = async (bin, argv) => {
|
|
4429
4429
|
const exec = promisify(cp.execFile);
|
|
4430
|
-
|
|
4431
|
-
|
|
4430
|
+
try {
|
|
4431
|
+
const { stdout } = await exec(bin, argv, { maxBuffer: 32 * 1024 * 1024 });
|
|
4432
|
+
return stdout;
|
|
4433
|
+
} catch (error) {
|
|
4434
|
+
const stdout = error.stdout;
|
|
4435
|
+
try {
|
|
4436
|
+
const data = JSON.parse(stdout ?? "");
|
|
4437
|
+
if (data && typeof data.error === "string") return stdout;
|
|
4438
|
+
} catch {
|
|
4439
|
+
}
|
|
4440
|
+
return JSON.stringify({ error: "Python command failed; check interpreter/dependencies" });
|
|
4441
|
+
}
|
|
4432
4442
|
};
|
|
4433
4443
|
var executor = defaultExecutor;
|
|
4434
4444
|
function __setExecutor(fn) {
|
|
@@ -4448,6 +4458,7 @@ var index_default = definePluginEntry({
|
|
|
4448
4458
|
description: "Stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
|
|
4449
4459
|
register(api) {
|
|
4450
4460
|
const repoRoot = api.rootDir || fallbackRoot;
|
|
4461
|
+
const runtimeToolsDir = existsSync(join(repoRoot, "tools")) ? join(repoRoot, "tools") : toolsDir;
|
|
4451
4462
|
const pythonBin = () => {
|
|
4452
4463
|
const venvPython = join(repoRoot, venvBin);
|
|
4453
4464
|
if (existsSync(venvPython)) return venvPython;
|
|
@@ -4455,10 +4466,50 @@ var index_default = definePluginEntry({
|
|
|
4455
4466
|
if (existsSync(parentVenvPython)) return parentVenvPython;
|
|
4456
4467
|
return isWin ? "python" : "python3";
|
|
4457
4468
|
};
|
|
4458
|
-
const runPy = (script, args) => executor(pythonBin(), [join(
|
|
4469
|
+
const runPy = (script, args) => executor(pythonBin(), [join(runtimeToolsDir, script), ...args]);
|
|
4470
|
+
api.registerTool({
|
|
4471
|
+
name: "get_announcements",
|
|
4472
|
+
description: "\u67E5\u8BE2A\u80A1\u5DE8\u6F6E\u516C\u544A\u6807\u9898\u3001\u65E5\u671F\u3001\u7C7B\u578B\u548C\u539F\u6587PDF\u94FE\u63A5\uFF1B\u6309\u65E5\u671F\u8303\u56F4/\u7C7B\u522B\u7B5B\u9009\uFF0C\u9ED8\u8BA4\u8FD190\u5929\uFF0Ctop=1..500\u3002\u7B2C\u4E00\u7248\u4E0D\u63D0\u53D6\u6B63\u6587\uFF0Ctruncated\u63D0\u793A\u622A\u65AD\u3002",
|
|
4473
|
+
parameters: typebox_exports.Object({
|
|
4474
|
+
symbol: typebox_exports.String({ description: "A\u80A1\u4EE3\u7801" }),
|
|
4475
|
+
category: typebox_exports.Optional(typebox_exports.Union([typebox_exports.Literal("all"), typebox_exports.Literal("forecast"), typebox_exports.Literal("express"), typebox_exports.Literal("annual"), typebox_exports.Literal("interim"), typebox_exports.Literal("quarterly"), typebox_exports.Literal("reduction"), typebox_exports.Literal("issuance"), typebox_exports.Literal("inquiry"), typebox_exports.Literal("dividend")], { description: "\u516C\u544A\u7C7B\u522B\uFF0C\u9ED8\u8BA4all" })),
|
|
4476
|
+
start_date: typebox_exports.Optional(typebox_exports.String({ description: "\u5F00\u59CB\u65E5\u671FYYYY-MM-DD\uFF0C\u9ED8\u8BA4\u7ED3\u675F\u65E5\u671F\u524D90\u5929" })),
|
|
4477
|
+
end_date: typebox_exports.Optional(typebox_exports.String({ description: "\u7ED3\u675F\u65E5\u671FYYYY-MM-DD\uFF0C\u9ED8\u8BA4\u4ECA\u5929" })),
|
|
4478
|
+
top: typebox_exports.Optional(typebox_exports.Number({ description: "\u6700\u591A\u6761\u65701..500\uFF0C\u9ED8\u8BA450" }))
|
|
4479
|
+
}),
|
|
4480
|
+
async execute(_id, p) {
|
|
4481
|
+
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)]);
|
|
4482
|
+
return asText(out);
|
|
4483
|
+
}
|
|
4484
|
+
});
|
|
4485
|
+
api.registerTool({
|
|
4486
|
+
name: "get_us_holdings",
|
|
4487
|
+
description: "\u67E5\u8BE2SEC 13F\uFF1Amode=auto\u9ED8\u8BA4\u670913F\u7533\u62A5\u65F6\u67E5\u673A\u6784\uFF0C\u5426\u5219\u6309\u53D1\u884C\u4EBACIK\u53CD\u67E5\u6301\u4ED3\u673A\u6784\uFF1Bmanager/issuer\u53EF\u663E\u5F0F\u6307\u5B9A\u3002\u53D1\u884C\u4EBA\u901A\u8FC7\u5B98\u65B913D/G\u7CBE\u786E\u6620\u5C04CUSIP\uFF0C\u626B\u63CF\u6700\u65B0\u5DF2\u53D1\u5E0313F\u7A97\u53E3\uFF0C\u5904\u7406\u91CD\u8FF0/\u8865\u5145\u4FEE\u8BA2\uFF0C\u8FD4\u56DE\u5B9E\u9645\u62A5\u544A\u671F\u3001\u622A\u6B62\u65E5\u53CA\u6620\u5C04\u8986\u76D6\u3002\u9996\u6B21\u7EA6100MB\u4E0B\u8F7D\uFF0C\u540E\u7EED\u7F13\u5B58\uFF1B\u65E0\u6620\u5C04\u660E\u786E\u62A5\u9519\uFF0C\u4E0D\u505A\u540D\u79F0\u731C\u6D4B\u3002\u9700SEC_USER_AGENT\u542B\u771F\u5B9E\u8054\u7CFB\u90AE\u7BB1\uFF0C\u4E0D\u662F\u5B9E\u65F6\u6216\u5168\u90E8\u8BC1\u5238\u6301\u4ED3\u3002",
|
|
4488
|
+
parameters: typebox_exports.Object({
|
|
4489
|
+
cik: typebox_exports.String({ description: "\u673A\u6784\u6216\u53D1\u884C\u4EBACIK\uFF0C1..10\u4F4D\u6570\u5B57\uFF0C\u59820001067983/0000320193" }),
|
|
4490
|
+
mode: typebox_exports.Optional(typebox_exports.Union([typebox_exports.Literal("auto"), typebox_exports.Literal("manager"), typebox_exports.Literal("issuer")], { description: "\u9ED8\u8BA4auto\uFF1Bmanager\u67E5\u673A\u6784\u7EC4\u5408\uFF0Cissuer\u53CD\u67E5\u53D1\u884C\u4EBA\u6301\u4ED3\u673A\u6784" }))
|
|
4491
|
+
}),
|
|
4492
|
+
async execute(_id, p) {
|
|
4493
|
+
const out = await runPy("sec_edgar.py", ["holdings", p.cik, ...p.mode ? ["--mode", p.mode] : []]);
|
|
4494
|
+
return asText(out);
|
|
4495
|
+
}
|
|
4496
|
+
});
|
|
4497
|
+
api.registerTool({
|
|
4498
|
+
name: "get_insider_trades",
|
|
4499
|
+
description: "\u67E5\u8BE2\u7F8E\u80A1\u53D1\u884C\u4EBA\u8FD1\u671FForm 4/4-A\u5185\u90E8\u4EBA\u4EA4\u6613\uFF08SEC\u5B98\u65B9XML\uFF09\uFF0C\u4FDD\u7559\u4EBA\u5458\u804C\u52A1\u3001\u4EA4\u6613\u4EE3\u7801\u3001\u4E70\u5356\u65B9\u5411\u3001\u6570\u91CF\u3001\u4EF7\u683C\u3001\u811A\u6CE8\u548C\u884D\u751F\u54C1\u6807\u5FD7\u3002\u9700SEC_USER_AGENT\u542B\u771F\u5B9E\u8054\u7CFB\u90AE\u7BB1\uFF1Bdays\u6309\u7533\u62A5\u65E5\u671F\u7B5B\u9009\uFF0Ctop\u9650\u5236\u6587\u4EF6\u6570\uFF0C\u4FEE\u8BA2\u52FF\u91CD\u590D\u8BA1\u6570\u3002",
|
|
4500
|
+
parameters: typebox_exports.Object({
|
|
4501
|
+
symbol: typebox_exports.String({ description: "\u7F8E\u80A1ticker\u6216\u53D1\u884C\u4EBACIK" }),
|
|
4502
|
+
days: typebox_exports.Optional(typebox_exports.Number({ description: "\u7533\u62A5\u65E5\u671F\u7A97\u53E31..365\u5929\uFF0C\u9ED8\u8BA490" })),
|
|
4503
|
+
top: typebox_exports.Optional(typebox_exports.Number({ description: "\u6700\u591A\u89E3\u6790Form 4\u6587\u4EF6\u65701..20\uFF0C\u9ED8\u8BA410" }))
|
|
4504
|
+
}),
|
|
4505
|
+
async execute(_id, p) {
|
|
4506
|
+
const out = await runPy("sec_edgar.py", ["insider_trades", p.symbol, "--days", String(p.days ?? 90), "--top", String(p.top ?? 10)]);
|
|
4507
|
+
return asText(out);
|
|
4508
|
+
}
|
|
4509
|
+
});
|
|
4459
4510
|
api.registerTool({
|
|
4460
4511
|
name: "get_valuation_history",
|
|
4461
|
-
description: "\u67E5\u8BE2A/HK\u80A1\u7968\u5386\
|
|
4512
|
+
description: "\u67E5\u8BE2A/HK\u80A1\u7968\u5386\u53F2PE-TTM/PB\u3001\u5F53\u524D\u6B63\u503C\u5206\u4F4D\u548C10/25/50/75/90\u5206\u4F4DBand\uFF0C\u8FD4\u56DE\u5B9E\u9645\u91C7\u6837\u533A\u95F4\uFF1B\u4E8F\u635F\u4F30\u503C\u5206\u4F4D\u4E3Anull\u3002years=1..10\uFF0C\u6309\u5929\u7F13\u5B58\u3002HK\u914D\u7F6ELIXINGER_TOKEN\u65F6\u4F18\u5148\u7406\u674F\u4EC1\u975E\u91D1\u878D\u516C\u53F8\u65E5\u5386\u53F2\uFF0C\u5931\u8D25\u964D\u7EA7\u767E\u5EA6\uFF0C\u4E0D\u6DF7\u63A5\u6765\u6E90\u3002",
|
|
4462
4513
|
parameters: typebox_exports.Object({
|
|
4463
4514
|
symbol: typebox_exports.String({ description: "A\u80A1\u4EE3\u7801\u6216\u6E2F\u80A1.HK\u4EE3\u7801" }),
|
|
4464
4515
|
years: typebox_exports.Optional(typebox_exports.Number({ description: "\u5386\u53F2\u7A97\u53E3\u5E74\u65701..10\uFF0C\u9ED8\u8BA45" }))
|
|
@@ -4620,7 +4671,7 @@ var index_default = definePluginEntry({
|
|
|
4620
4671
|
});
|
|
4621
4672
|
api.registerTool({
|
|
4622
4673
|
name: "get_financials",
|
|
4623
|
-
description: "\u83B7\u53D6\u80A1\u7968\u8D22\u52A1\u6458\u8981\u53CA\u5386\u53F2\u8D8B\u52BF\uFF0C\u6309\u5929\u7F13\u5B58\u3002A\
|
|
4674
|
+
description: "\u83B7\u53D6\u80A1\u7968\u8D22\u52A1\u6458\u8981\u53CA\u5386\u53F2\u8D8B\u52BF\uFF0C\u6309\u5929\u7F13\u5B58\u3002A\u80A1annual=true\u4E0Eperiods=10\u53D6\u5341\u5E74\u5E74\u62A5\uFF1B\u6E2F\u80A1\u53EF\u914D\u7F6ELIXINGER_TOKEN\u53D6\u975E\u91D1\u878D\u516C\u53F8\u8D22\u52A1\u5E8F\u5217\uFF0C\u4FDD\u7559\u5E01\u79CD/\u62AB\u9732\u65E5/\u5B9E\u9645\u8D22\u5E74\uFF0C\u5386\u53F2\u6BD4\u7387\u5355\u4F4Dpercent\u3002\u6709\u6548Yahoo\u9876\u5C42\u5FEB\u7167\u6309\u6574\u7EC4\u4FDD\u7559\uFF0Ccurrency\u4E3A\u8D22\u62A5\u5E01\u79CD\u3001market_cap_currency\u4E3A\u5E02\u503C\u5E01\u79CD\u3001snapshot_source\u6807\u660E\u6765\u6E90\uFF1B\u7F3A\u5931\u503C\u53CAreport_date\u4E0D\u6DF7\u5165\u5386\u53F2\u6570\u503C/\u65E5\u671F\u3002\u7F3Atoken\u6216\u65E0\u6743\u9650\u964D\u7EA7\u539F\u6709\u6765\u6E90\u5E76\u6807\u6CE8\u4E0D\u8DB3\uFF0C\u4E0D\u8865\u9020\u7F3A\u5931\u3002\u4F30\u503C\u5386\u53F2\u7528get_valuation_history\uFF0C\u62AB\u9732\u6392\u671F\u7528get_earnings_calendar",
|
|
4624
4675
|
parameters: typebox_exports.Object({
|
|
4625
4676
|
symbol: typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08A\u80A1\u5982600519\uFF0C\u7F8E\u80A1\u5982AAPL\uFF0C\u6E2F\u80A1\u598200700.HK\uFF09" }),
|
|
4626
4677
|
annual: typebox_exports.Optional(typebox_exports.Boolean({ description: "\u53EA\u53D6\u5E74\u5EA6\u62A5\u544A\uFF0C\u9ED8\u8BA4false" })),
|
|
@@ -4929,7 +4980,7 @@ var index_default = definePluginEntry({
|
|
|
4929
4980
|
});
|
|
4930
4981
|
api.registerTool({
|
|
4931
4982
|
name: "screen_stocks",
|
|
4932
|
-
description: "\u5168\u5E02\u573A\u80A1\u7968\u7B5B\u9009\uFF08AlphaSift L1 \u591A\u56E0\u5B50\u786C\u7B5B + \u5E02\u573A\u60C5\u7EEA\u8C03\u8282\uFF09\u3002\u6309PE/PB/\u5E02\u503C/\u6362\u624B\u7387/\u6DA8\u8DCC\u5E45/\u91CF\u6BD4\u7B49\u56E0\u5B50\u8FC7\u6EE4\u548C\u8BC4\u5206\uFF0C\u53EF\u7528 l2 \u5F00\u542F\u8D28\u91CF/\u6210\u957F/\u52A8\u91CF/\u6CE2\u52A8\u7387/\u8D44\u91D1\u6D41\u589E\u5F3A",
|
|
4983
|
+
description: "\u5168\u5E02\u573A\u80A1\u7968\u7B5B\u9009\uFF08AlphaSift L1 \u591A\u56E0\u5B50\u786C\u7B5B + \u5E02\u573A\u60C5\u7EEA\u8C03\u8282\uFF09\u3002\u6309PE/PB/\u5E02\u503C/\u6362\u624B\u7387/\u6DA8\u8DCC\u5E45/\u91CF\u6BD4\u7B49\u56E0\u5B50\u8FC7\u6EE4\u548C\u8BC4\u5206\uFF0C\u53EF\u7528 l2 \u5F00\u542F\u8D28\u91CF/\u6210\u957F/\u52A8\u91CF/\u6CE2\u52A8\u7387/\u8D44\u91D1\u6D41\u589E\u5F3A\u3002\u663E\u5F0F\u7B5B\u9009\u6761\u4EF6\u7F3A\u5C11\u6570\u636E\u65F6\u62A5error\uFF0Cfilters_applied\u53EA\u5217\u5B9E\u9645\u6267\u884C\u7684\u6761\u4EF6",
|
|
4933
4984
|
parameters: typebox_exports.Object({
|
|
4934
4985
|
market: typebox_exports.Optional(
|
|
4935
4986
|
typebox_exports.Union(
|
|
@@ -4963,7 +5014,7 @@ var index_default = definePluginEntry({
|
|
|
4963
5014
|
});
|
|
4964
5015
|
api.registerTool({
|
|
4965
5016
|
name: "run_backtest",
|
|
4966
|
-
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",
|
|
5017
|
+
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",
|
|
4967
5018
|
parameters: typebox_exports.Object({
|
|
4968
5019
|
strategy: typebox_exports.String({ description: "\u7B56\u7565YAML\u6587\u4EF6\u8DEF\u5F84" }),
|
|
4969
5020
|
symbol: typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08A\u80A1\u5982600519\uFF0C\u7F8E\u80A1\u5982AAPL\uFF0C\u6E2F\u80A1\u598200700.HK\uFF09" }),
|
|
@@ -5237,7 +5288,7 @@ var index_default = definePluginEntry({
|
|
|
5237
5288
|
});
|
|
5238
5289
|
api.registerTool({
|
|
5239
5290
|
name: "screen_risk",
|
|
5240
|
-
description: "A\u80A1\u98CE\u9669\u4E13\u9879\u7B5B\u67E5 \u2014 \u68C0\u67E5\u4F30\u503C\u3001\u6280\u672F\u9884\u8B66\u3001\u89E3\u7981\u3001\u51CF\u6301\u3001\u4E1A\u7EE9\u9884\u8B66\u3001\u76D1\u7BA1\u548C\u884C\u4E1A\u653F\u7B56\uFF0C\u8FD4\u56DE\u98CE\u9669\u8BC4\u7EA7\u548C veto_buy\u3002\u65B0\u95FB\u641C\u7D22\u547D\u4E2D\u662F\u5F85\u6838\u5B9E\u7EBF\u7D22\uFF0C\u4E0D\u662F\u5DF2\u8BC1\u5B9E\u98CE\u9669",
|
|
5291
|
+
description: "A\u80A1\u98CE\u9669\u4E13\u9879\u7B5B\u67E5 \u2014 \u68C0\u67E5\u4F30\u503C\u3001\u6280\u672F\u9884\u8B66\u3001\u89E3\u7981\u3001\u51CF\u6301\u3001\u4E1A\u7EE9\u9884\u8B66\u3001\u76D1\u7BA1\u548C\u884C\u4E1A\u653F\u7B56\uFF0C\u8FD4\u56DE\u98CE\u9669\u8BC4\u7EA7\u548C veto_buy\u3002\u65B0\u95FB\u641C\u7D22\u547D\u4E2D\u662F\u5F85\u6838\u5B9E\u7EBF\u7D22\uFF0C\u4E0D\u662F\u5DF2\u8BC1\u5B9E\u98CE\u9669\u3002data_complete\u548Cwarnings\u6807\u660E\u8986\u76D6\uFF1B\u6570\u636E\u4E0D\u8DB3\u65F6risk_level=unknown\uFF0Crisk_score\u6216veto_buy\u53EF\u4E3Anull\uFF0C\u4E0D\u80FD\u89C6\u4E3A\u4F4E\u98CE\u9669",
|
|
5241
5292
|
parameters: typebox_exports.Object({
|
|
5242
5293
|
symbol: typebox_exports.String({ description: "A\u80A1\u80A1\u7968\u4EE3\u7801\uFF0C\u5982 600519" }),
|
|
5243
5294
|
name: typebox_exports.Optional(
|
|
@@ -5484,7 +5535,7 @@ var index_default = definePluginEntry({
|
|
|
5484
5535
|
});
|
|
5485
5536
|
api.registerTool({
|
|
5486
5537
|
name: "check_alert_rules",
|
|
5487
|
-
description: "\u65E0\u72B6\u6001\u544A\u8B66\u89C4\u5219\u68C0\u67E5 \u2014 \u4F20\u5165\u89C4\u5219\u6570\u7EC4\uFF0C\u8FD4\u56DE\u5F53\u524D\u662F\u5426\u89E6\u53D1\u3002\u89C4\u5219\u7C7B\u578B\uFF1Aprice_below/price_above/change_pct_above/change_pct_below/volume_ratio_above/anomaly/risk_veto/risk_level_at_least\u3002\u4E0D\u505A\u8C03\u5EA6\u4E0D\u5B58\u5386\u53F2",
|
|
5538
|
+
description: "\u65E0\u72B6\u6001\u544A\u8B66\u89C4\u5219\u68C0\u67E5 \u2014 \u4F20\u5165\u89C4\u5219\u6570\u7EC4\uFF0C\u8FD4\u56DE\u5F53\u524D\u662F\u5426\u89E6\u53D1\u3002\u89C4\u5219\u7C7B\u578B\uFF1Aprice_below/price_above/change_pct_above/change_pct_below/volume_ratio_above/anomaly/risk_veto/risk_level_at_least\u3002\u4E0D\u505A\u8C03\u5EA6\u4E0D\u5B58\u5386\u53F2\u3002\u4F9D\u8D56\u6570\u636E\u4E0D\u53EF\u7528\u65F6evaluated\u6761\u76EE\u542Berror\uFF0Cmeta.warnings\u63D0\u793A\u7F3A\u5931\uFF0Ctriggered=false\u4E0D\u4EE3\u8868\u68C0\u67E5\u6210\u529F",
|
|
5488
5539
|
parameters: typebox_exports.Object({
|
|
5489
5540
|
symbol: typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08A\u80A1\u5982600519\uFF0C\u7F8E\u80A1\u5982AAPL\uFF0C\u6E2F\u80A1\u598200700.HK\uFF09" }),
|
|
5490
5541
|
rules: typebox_exports.Array(
|
|
@@ -5542,7 +5593,7 @@ var index_default = definePluginEntry({
|
|
|
5542
5593
|
});
|
|
5543
5594
|
api.registerTool({
|
|
5544
5595
|
name: "evaluate_signals",
|
|
5545
|
-
description: "\u8BC4\u4F30\u5230\u671F\u4FE1\u53F7\uFF1A\u62C9\u53D6\u8BB0\u5F55\u65E5\u4E4B\u540E\u7684\u65E5K\uFF0C\u5224\u5B9A target_hit/stop_hit/timeout \u5E76\u8BA1\u7B97\u6536\u76CA\uFF0C\u56DE\u5199\u5B58\u50A8\u3002\u8BB0\u5F55\u5EFA\u8BAE\u7528 record_signal\uFF0C\u80DC\u7387\u590D\u76D8\u7528 get_signal_summary",
|
|
5596
|
+
description: "\u8BC4\u4F30\u5230\u671F\u4FE1\u53F7\uFF1A\u62C9\u53D6\u8BB0\u5F55\u65E5\u4E4B\u540E\u7684\u65E5K\uFF0C\u5224\u5B9A target_hit/stop_hit/timeout \u5E76\u8BA1\u7B97\u6536\u76CA\uFF0C\u56DE\u5199\u5B58\u50A8\u3002\u8BB0\u5F55\u5EFA\u8BAE\u7528 record_signal\uFF0C\u80DC\u7387\u590D\u76D8\u7528 get_signal_summary\u3002\u5386\u53F2K\u7EBF\u672A\u8986\u76D6\u8BB0\u5F55\u65E5\u65F6skipped_no_data\u5E76\u4FDD\u6301\u672A\u7ED3\u7B97\uFF0C\u4E0D\u80FD\u7528\u8F83\u65B0\u884C\u60C5\u4EE3\u66FF",
|
|
5546
5597
|
parameters: typebox_exports.Object({
|
|
5547
5598
|
symbol: typebox_exports.Optional(
|
|
5548
5599
|
typebox_exports.String({ description: "\u80A1\u7968\u4EE3\u7801\uFF08\u53EF\u9009\uFF0C\u53EA\u8BC4\u4F30\u8BE5\u80A1\u7684\u4FE1\u53F7\uFF09" })
|
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
|
-
|
|
15
|
-
|
|
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;
|
|
@@ -42,6 +53,7 @@ export default definePluginEntry({
|
|
|
42
53
|
register(api) {
|
|
43
54
|
// OpenClaw executes a captured copy of the JS bundle; the venv stays in the installed plugin root.
|
|
44
55
|
const repoRoot = api.rootDir || fallbackRoot;
|
|
56
|
+
const runtimeToolsDir = existsSync(join(repoRoot, "tools")) ? join(repoRoot, "tools") : toolsDir;
|
|
45
57
|
const pythonBin = () => {
|
|
46
58
|
const venvPython = join(repoRoot, venvBin);
|
|
47
59
|
if (existsSync(venvPython)) return venvPython;
|
|
@@ -52,12 +64,55 @@ export default definePluginEntry({
|
|
|
52
64
|
return isWin ? "python" : "python3";
|
|
53
65
|
};
|
|
54
66
|
const runPy = (script: string, args: string[]) =>
|
|
55
|
-
executor(pythonBin(), [join(
|
|
67
|
+
executor(pythonBin(), [join(runtimeToolsDir, script), ...args]);
|
|
56
68
|
// --- Data Tools ---
|
|
57
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
|
+
|
|
58
113
|
api.registerTool({
|
|
59
114
|
name: "get_valuation_history",
|
|
60
|
-
description: "查询A/HK股票历史
|
|
115
|
+
description: "查询A/HK股票历史PE-TTM/PB、当前正值分位和10/25/50/75/90分位Band,返回实际采样区间;亏损估值分位为null。years=1..10,按天缓存。HK配置LIXINGER_TOKEN时优先理杏仁非金融公司日历史,失败降级百度,不混接来源。",
|
|
61
116
|
parameters: Type.Object({
|
|
62
117
|
symbol: Type.String({ description: "A股代码或港股.HK代码" }),
|
|
63
118
|
years: Type.Optional(Type.Number({ description: "历史窗口年数1..10,默认5" })),
|
|
@@ -231,7 +286,7 @@ export default definePluginEntry({
|
|
|
231
286
|
|
|
232
287
|
api.registerTool({
|
|
233
288
|
name: "get_financials",
|
|
234
|
-
description: "获取股票财务摘要及历史趋势,按天缓存。A
|
|
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",
|
|
235
290
|
parameters: Type.Object({
|
|
236
291
|
symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
|
|
237
292
|
annual: Type.Optional(Type.Boolean({description: "只取年度报告,默认false"})),
|
|
@@ -577,7 +632,7 @@ export default definePluginEntry({
|
|
|
577
632
|
api.registerTool({
|
|
578
633
|
name: "screen_stocks",
|
|
579
634
|
description:
|
|
580
|
-
"全市场股票筛选(AlphaSift L1 多因子硬筛 + 市场情绪调节)。按PE/PB/市值/换手率/涨跌幅/量比等因子过滤和评分,可用 l2
|
|
635
|
+
"全市场股票筛选(AlphaSift L1 多因子硬筛 + 市场情绪调节)。按PE/PB/市值/换手率/涨跌幅/量比等因子过滤和评分,可用 l2 开启质量/成长/动量/波动率/资金流增强。显式筛选条件缺少数据时报error,filters_applied只列实际执行的条件",
|
|
581
636
|
parameters: Type.Object({
|
|
582
637
|
market: Type.Optional(
|
|
583
638
|
Type.Union(
|
|
@@ -613,7 +668,7 @@ export default definePluginEntry({
|
|
|
613
668
|
api.registerTool({
|
|
614
669
|
name: "run_backtest",
|
|
615
670
|
description:
|
|
616
|
-
"策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal",
|
|
671
|
+
"策略回测(AlphaEvo)。读取YAML策略定义,在历史数据上模拟交易,输出收益率/回撤/胜率等指标。只想知道单个技术信号的历史胜率用更轻量的 evaluate_signal。period为实际数据期间,requested_period保留请求期间,warnings提示覆盖差异;年化按实际期间计算",
|
|
617
672
|
parameters: Type.Object({
|
|
618
673
|
strategy: Type.String({ description: "策略YAML文件路径" }),
|
|
619
674
|
symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
|
|
@@ -922,7 +977,7 @@ export default definePluginEntry({
|
|
|
922
977
|
api.registerTool({
|
|
923
978
|
name: "screen_risk",
|
|
924
979
|
description:
|
|
925
|
-
"A股风险专项筛查 — 检查估值、技术预警、解禁、减持、业绩预警、监管和行业政策,返回风险评级和 veto_buy
|
|
980
|
+
"A股风险专项筛查 — 检查估值、技术预警、解禁、减持、业绩预警、监管和行业政策,返回风险评级和 veto_buy。新闻搜索命中是待核实线索,不是已证实风险。data_complete和warnings标明覆盖;数据不足时risk_level=unknown,risk_score或veto_buy可为null,不能视为低风险",
|
|
926
981
|
parameters: Type.Object({
|
|
927
982
|
symbol: Type.String({ description: "A股股票代码,如 600519" }),
|
|
928
983
|
name: Type.Optional(
|
|
@@ -1201,7 +1256,7 @@ export default definePluginEntry({
|
|
|
1201
1256
|
api.registerTool({
|
|
1202
1257
|
name: "check_alert_rules",
|
|
1203
1258
|
description:
|
|
1204
|
-
"无状态告警规则检查 — 传入规则数组,返回当前是否触发。规则类型: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不代表检查成功",
|
|
1205
1260
|
parameters: Type.Object({
|
|
1206
1261
|
symbol: Type.String({ description: "股票代码(A股如600519,美股如AAPL,港股如00700.HK)" }),
|
|
1207
1262
|
rules: Type.Array(
|
|
@@ -1263,7 +1318,7 @@ export default definePluginEntry({
|
|
|
1263
1318
|
api.registerTool({
|
|
1264
1319
|
name: "evaluate_signals",
|
|
1265
1320
|
description:
|
|
1266
|
-
"评估到期信号:拉取记录日之后的日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并保持未结算,不能用较新行情代替",
|
|
1267
1322
|
parameters: Type.Object({
|
|
1268
1323
|
symbol: Type.Optional(
|
|
1269
1324
|
Type.String({ description: "股票代码(可选,只评估该股的信号)" })
|
package/openclaw.plugin.json
CHANGED
package/package.json
CHANGED
|
@@ -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": {
|
package/scripts/setup-python.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import {
|
|
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,14 +14,14 @@ 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(
|
|
18
|
-
|
|
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 =
|
|
24
|
+
const ver = execFileSync(name, ["--version"], { stdio: "pipe" }).toString().trim();
|
|
25
25
|
const match = ver.match(/(\d+)\.(\d+)/);
|
|
26
26
|
if (match && (parseInt(match[1]) > 3 || (parseInt(match[1]) === 3 && parseInt(match[2]) >= 10))) {
|
|
27
27
|
return name;
|
|
@@ -42,10 +42,10 @@ try {
|
|
|
42
42
|
}
|
|
43
43
|
|
|
44
44
|
if (!existsSync(venvDir)) {
|
|
45
|
-
run(
|
|
45
|
+
run(python, ["-m", "venv", venvDir]);
|
|
46
46
|
}
|
|
47
47
|
|
|
48
|
-
run(
|
|
48
|
+
run(venvPython, ["-m", "pip", "install", "-q", "-r", requirements]);
|
|
49
49
|
} catch (err) {
|
|
50
50
|
console.warn(
|
|
51
51
|
`\n[pi-stock-analysis] Python setup failed: ${err.message}\n` +
|
|
@@ -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
|
-
| 衰退期 |
|
|
47
|
+
| 启动期 | 均线粘合后向上发散,放量突破 | 检查入场触发和初始风险 |
|
|
48
|
+
| 加速期 | 价格加速上涨,远离均线 | 按持仓规则跟踪,更新保护位 |
|
|
49
|
+
| 成熟期 | 涨幅放缓,量能递减 | 检查退出条件,阶段标签本身不触发减仓 |
|
|
50
|
+
| 衰退期 | 跌破预先选定的均线或趋势支撑 | 按退出规则执行 |
|
|
43
51
|
|
|
44
52
|
### 4. 关键指标
|
|
45
53
|
|
|
46
54
|
- **ADX 替代**:用 MA 斜率和排列程度衡量趋势强度
|
|
47
55
|
- **趋势线**:连接近期低点作为上升趋势线
|
|
48
|
-
-
|
|
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.
|
|
77
|
+
2. 趋势证据和未满足条件
|
|
55
78
|
3. 关键趋势支撑/压力位
|
|
56
79
|
4. 入场/持有/离场建议
|
|
57
|
-
5.
|
|
80
|
+
5. 初始风险、保护位和退出触发条件
|
|
81
|
+
6. 数据或成交限制;肥尾分支附计算口径和不确定性
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# 肥尾度量与趋势收益诊断
|
|
2
|
+
|
|
3
|
+
本参考供趋势 skill 和趋势策略回测按需读取。数值由本 skill 的 [计算脚本](../scripts/tail_analysis.py) 执行,无需独立工具注册。保留输入、运行参数和输出;没有执行环境或数据时只解释方法,数值标为未计算。
|
|
4
|
+
|
|
5
|
+
## 调用脚本
|
|
6
|
+
|
|
7
|
+
从插件根目录使用安装了现有 numpy 依赖的 Python 运行(POSIX 通常为 `.venv/bin/python3`,Windows 为 `.venv/Scripts/python.exe`):
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
python skills/bull-trend/scripts/tail_analysis.py returns historical-returns.json --n 2 10 30 --draws 20000 --seed 42
|
|
11
|
+
python skills/bull-trend/scripts/tail_analysis.py returns historical-returns.json --current 0.05
|
|
12
|
+
python skills/bull-trend/scripts/tail_analysis.py trades backtest-result.json
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
`returns` 输入是同周期历史对数收益的 JSON 数组,如 `[0.01, -0.02, 0.005]`,以小数表示;`--current` 的当前收益另传,必须从历史输入中排除。脚本不转换价格、不抓行情、不识别日期,因此先按下文校验并记录数据口径。`trades` 输入是含完整 `trades` 数组的回测 JSON。脚本 stdout 输出 JSON,失败返回 `error` 并以非零状态退出。
|
|
16
|
+
|
|
17
|
+
κ 默认 n0 = 1,以固定种子做 iid 经验重抽样,输出每个 n 的 κ 和平均绝对偏差;换种子重复运行检查 Monte Carlo 波动,换历史窗口检查数据敏感性。输出没有总体置信区间。`sample_count` 是历史收益数量,`draws` 是模拟轮数,两者不能混称样本量。`current_event.percentile` 为 0..1,`upper_exceedances` / `lower_exceedances` 是历史严格超过 / 低于当前收益的次数。
|
|
18
|
+
|
|
19
|
+
## 先确定分析对象
|
|
20
|
+
|
|
21
|
+
| 用户问题 | 分析对象 | 可交付结论 |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| 收益分布有多肥尾 | 固定周期的历史收益 | 样本尾部特征、κ 的条件性估计 |
|
|
24
|
+
| 当前涨跌是否极端 | 当前收益与此前同周期收益 | 历史分位或阈值超越,不能推导后续方向 |
|
|
25
|
+
| 趋势系统是否靠大赢家 | 策略平仓盈亏 | 盈利集中度及移除大赢家后的敏感性 |
|
|
26
|
+
|
|
27
|
+
市场收益的厚尾、策略收益的正偏和趋势延续是不同性质。塔勒布的度量回答统计稳定性问题;下文的分位和盈利贡献是本项目的诊断方法,不称为塔勒布交易信号。
|
|
28
|
+
|
|
29
|
+
## 数据口径
|
|
30
|
+
|
|
31
|
+
使用 `get_kline` 或现有 `stock_data.py kline`,核对实际返回的日期范围、周期、数量和复权标记。股票历史价格保持一致复权口径,指数保持原始点位;先处理乱序、重复日期和无效价格,说明停牌或缺失导致的时间间隔,保留真实极端收益。
|
|
32
|
+
|
|
33
|
+
默认分析对数收益 `r_t = log(P_t / P_{t-1})`,仅使用正价格。日、周收益分别计算;周收益从周末价格或同一周日对数收益之和取得,避免把重叠多日收益当作独立样本。策略盈利贡献使用货币盈亏,不混用价格收益。
|
|
34
|
+
|
|
35
|
+
申请多年的同口径历史,报告实际样本量;120 根日K线只能给出短窗口描述。不存在通用的“够用样本数”;长历史也可能混合不同制度或波动阶段,按分段结果检查稳定性。
|
|
36
|
+
|
|
37
|
+
## 当前事件的历史分位
|
|
38
|
+
|
|
39
|
+
以当前事件之前的同周期收益 `r_1,...,r_N` 为参考,对当前收益 `r_*` 计算经验分位:
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
F_hat(r_*) = count(r_i <= r_*) / N
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
报告单侧方向、参考区间、N 和超越次数。例如当前上涨高于历史样本的 99% 分位,仅说明它相对该样本少见。样本之外的事件频率不可由零超越次数认定为零;回测每个时点只使用此前数据计算阈值。
|
|
46
|
+
|
|
47
|
+
## 塔勒布的 κ:有限样本聚合速度
|
|
48
|
+
|
|
49
|
+
来源:[Taleb, How Much Data Do You Need? A Pre-asymptotic Metric for Fat-tailedness](https://arxiv.org/html/1802.05495),Definition 1、Equation (1) 和 III-B。
|
|
50
|
+
|
|
51
|
+
设 `X_i` 独立同分布且具有有限绝对一阶矩:
|
|
52
|
+
|
|
53
|
+
```text
|
|
54
|
+
S_n = sum(X_i, i=1..n)
|
|
55
|
+
M(n) = E[abs(S_n - E[S_n])]
|
|
56
|
+
kappa(n0, n) = 2 - log(n/n0) / log(M(n)/M(n0)), n > n0 >= 1
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
`M(n)` 是 n 项之和相对其均值的平均绝对偏差,不是中位数绝对偏差,也不是 n 项均值的偏差。高斯分布满足 `M(n)/M(n0) = sqrt(n/n0)`,因此 κ = 0。在论文适用的分布中,较高 κ 表示增加样本带来的均值稳定性改善较慢;κ 与 n0、n 有关。
|
|
60
|
+
|
|
61
|
+
脚本计算的是**基于历史经验分布的条件性估计**:用历史均值中心化后计算 `M_hat(1)`,有放回独立抽样 n 项相加,以绝对和值的模拟均值估计 `M_hat(n)`,代入 n0 = 1 的公式。
|
|
62
|
+
|
|
63
|
+
零离散度或零对数分母时,脚本返回 `kappa: null` 和 `unavailable_reason`。估计超出预期范围时报告原值并检查假设和数值稳定性,不强行裁剪到 [0,1]。
|
|
64
|
+
|
|
65
|
+
股价收益可能具有自相关、波动聚集和制度变化,独立抽样会抹去时间结构。按真实连续时间聚合或使用块抽样时,应将结果标为包含时间依赖的描述性统计,与原论文的 iid κ 区分。仅重抽历史不能创造尚未出现的极端事件,也不能证明总体尾部已被充分观测。
|
|
66
|
+
|
|
67
|
+
κ 不能区分获利方向,不能预测趋势启动。论文中 κ > 0.15 是对正态近似可靠性的启发式提醒,不是入场、止盈或“已到肥尾”的通用阈值。
|
|
68
|
+
|
|
69
|
+
## 趋势策略的盈利集中度
|
|
70
|
+
|
|
71
|
+
来源:[CFM, Making fat right tails fatter with trend following… most of the time](https://www.cfm.com/making-fat-right-tails-fatter-with-trend-following-most-of-the-time/)。趋势追踪的凸性和正偏依赖策略与时间尺度;单次跳空或快速反转未必能被系统捕获。
|
|
72
|
+
|
|
73
|
+
使用 `run_backtest` 返回的 `trades`,仅取 `type == "sell"` 的平仓记录,以 `pnl` 的货币金额计算;`pnl_pct` 是小数比例,不能当百分数或与货币盈亏相加。先确认返回结果是否完整、是否存在未平仓头寸以及费用覆盖口径。
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
G = sum(max(pnl_i, 0))
|
|
77
|
+
L = sum(min(pnl_i, 0))
|
|
78
|
+
T = G + L
|
|
79
|
+
C_k = 最大 k 笔正盈利之和 / G
|
|
80
|
+
T_without_k = T - 最大 k 笔正盈利之和
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
默认报告最大 1 笔和最大 3 笔,正盈利笔数不足时使用实际数量并注明。G = 0 时集中度不可计算;同时报告交易笔数、G、L、最差单笔及回测已有的最大回撤。使用 G 作分母,避免总净利润接近零时比率失真。
|
|
84
|
+
|
|
85
|
+
`T_without_k` 是已实现盈亏的删除敏感性分析,保留其余交易金额不变;它不是删除交易后重新模拟的资金曲线或收益率。未平仓盈亏另列,不能把 T 当作账户总收益。少数赢家贡献高符合某些趋势系统的结构,但不能单凭这一点证明策略有效或失效;结合成本、回撤、不同区间和样本外表现评价。
|
|
86
|
+
|
|
87
|
+
现有回测有固定止盈默认值;省略 `take_profit` 不会关闭止盈。验证保留右尾的退出规则前,检查实际引擎和 DSL 的支持情况,将无法表达的规则明确列为未验证。
|
|
88
|
+
|
|
89
|
+
## 完成标准
|
|
90
|
+
|
|
91
|
+
报告指出分析对象、数据来源及区间、周期、复权口径、样本量、公式与估计方法、实际数值或未计算原因。κ 结果还需注明 n0、n、抽样假设和敏感性;盈利集中度需注明平仓与未平仓口径。交易建议依据趋势和风险规则,统计结果仅提供其能支持的证据。
|