stock-analysis-plugin 0.2.6 → 0.2.8
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 +88 -15
- package/package.json +2 -1
- package/pi/index.ts +867 -72
- package/schemas/market_review_schema.json +12 -5
- package/schemas/report_schema.json +65 -1
- package/scripts/cli-timeout.mjs +27 -0
- package/scripts/json-input.mjs +26 -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 +4 -0
- package/skills/growth-quality/SKILL.md +4 -0
- package/skills/market-review/SKILL.md +2 -0
- package/skills/stock-analysis/SKILL.md +17 -3
- package/skills/stock-analysis/references/stateless-analysis.md +66 -0
- package/skills/stock-screener/SKILL.md +5 -1
- package/skills/strategy-backtest/SKILL.md +19 -0
- package/templates/market_review/full.md.j2 +7 -0
- package/templates/stock_analysis/_evidence.md.j2 +11 -0
- package/templates/stock_analysis/brief.md.j2 +2 -0
- package/templates/stock_analysis/full.md.j2 +2 -0
- package/tools/_subproc.py +66 -11
- package/tools/backtest.py +143 -19
- package/tools/capabilities.py +12 -0
- package/tools/cli_budgets.json +27 -0
- package/tools/gather.py +4 -6
- package/tools/market_review.py +30 -9
- package/tools/screener.py +57 -15
- package/tools/signal_tracker.py +77 -6
- package/tools/stateless_analysis.py +630 -0
- package/tools/stock_data.py +90 -15
- package/tools/technical.py +186 -0
- package/tools/trend_strategy.py +365 -0
- package/tools/watchlist_context.py +18 -7
|
@@ -18,17 +18,24 @@
|
|
|
18
18
|
"type": "object",
|
|
19
19
|
"description": "市场温度(来自 market_review.review)",
|
|
20
20
|
"properties": {
|
|
21
|
-
"score": { "type": "number", "minimum": 0, "maximum": 100 },
|
|
22
|
-
"level": { "type": "string", "enum": ["constructive", "neutral", "weak"] },
|
|
23
|
-
"signal": { "type": "string", "enum": ["green", "yellow", "red"] }
|
|
21
|
+
"score": { "type": ["number", "null"], "minimum": 0, "maximum": 100 },
|
|
22
|
+
"level": { "type": "string", "enum": ["constructive", "neutral", "weak", "unknown"] },
|
|
23
|
+
"signal": { "type": "string", "enum": ["green", "yellow", "red", "unknown"] }
|
|
24
24
|
},
|
|
25
25
|
"required": ["score", "signal"]
|
|
26
26
|
},
|
|
27
27
|
"strategy_stance": {
|
|
28
|
-
"type": "string",
|
|
29
|
-
"enum": ["offensive", "balanced", "defensive"],
|
|
28
|
+
"type": ["string", "null"],
|
|
29
|
+
"enum": ["offensive", "balanced", "defensive", null],
|
|
30
30
|
"description": "建议策略姿态"
|
|
31
31
|
},
|
|
32
|
+
"data_quality": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"properties": {
|
|
35
|
+
"flags": { "type": "array", "items": { "type": "string" } },
|
|
36
|
+
"limitations": { "type": "array", "items": { "type": "string" } }
|
|
37
|
+
}
|
|
38
|
+
},
|
|
32
39
|
"regime": {
|
|
33
40
|
"type": "object",
|
|
34
41
|
"description": "市场阶段(来自 detect_market_regime)",
|
|
@@ -124,7 +124,71 @@
|
|
|
124
124
|
"action_checklist": { "type": "array", "items": { "type": "string" } }
|
|
125
125
|
}
|
|
126
126
|
},
|
|
127
|
-
"risk_warning": { "type": "array", "items": { "type": "string" } }
|
|
127
|
+
"risk_warning": { "type": "array", "items": { "type": "string" } },
|
|
128
|
+
"data_quality": {
|
|
129
|
+
"type": "object",
|
|
130
|
+
"properties": {
|
|
131
|
+
"flags": {
|
|
132
|
+
"type": "array",
|
|
133
|
+
"items": {
|
|
134
|
+
"type": "string",
|
|
135
|
+
"enum": [
|
|
136
|
+
"partial_data",
|
|
137
|
+
"stale_quote",
|
|
138
|
+
"conflicting_data",
|
|
139
|
+
"insufficient_sample"
|
|
140
|
+
]
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
"limitations": {
|
|
144
|
+
"type": "array",
|
|
145
|
+
"items": {
|
|
146
|
+
"type": "string"
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
"required": [
|
|
151
|
+
"flags",
|
|
152
|
+
"limitations"
|
|
153
|
+
]
|
|
154
|
+
},
|
|
155
|
+
"evidence": {
|
|
156
|
+
"type": "array",
|
|
157
|
+
"items": {
|
|
158
|
+
"type": "object",
|
|
159
|
+
"properties": {
|
|
160
|
+
"path": {
|
|
161
|
+
"type": "string",
|
|
162
|
+
"description": "原始工具结果路径,例如 get_quote.price;已知返回对象中未提供的末级字段只能以 value=null 表示未知,其 source/as_of 可为 null,若填写必须来自父对象;不得跨越缺失对象或数组编造路径。"
|
|
163
|
+
},
|
|
164
|
+
"label": {
|
|
165
|
+
"type": "string",
|
|
166
|
+
"description": "读者可理解的指标名"
|
|
167
|
+
},
|
|
168
|
+
"value": {},
|
|
169
|
+
"source": {
|
|
170
|
+
"description": "引用已返回字段时,沿 path 继承最近父对象的 source(该键缺失时用 snapshot_source);子对象来源覆盖祖先,显式 null 保持未知。数组项和警告字符串同样继承,不能仅因叶子没有 source 就填 null;整条路径未提供来源时才填 null。",
|
|
171
|
+
"type": [
|
|
172
|
+
"string",
|
|
173
|
+
"null"
|
|
174
|
+
]
|
|
175
|
+
},
|
|
176
|
+
"as_of": {
|
|
177
|
+
"description": "引用已返回字段时,沿 path 继承最近父对象的 data_as_of,子对象值(包括显式 null)覆盖祖先;数组项同样继承。整条路径均缺失时为 null,保留完整时间与时区。report_date 是报告期,不能代替此时间。",
|
|
178
|
+
"type": [
|
|
179
|
+
"string",
|
|
180
|
+
"null"
|
|
181
|
+
]
|
|
182
|
+
}
|
|
183
|
+
},
|
|
184
|
+
"required": [
|
|
185
|
+
"path",
|
|
186
|
+
"value",
|
|
187
|
+
"source",
|
|
188
|
+
"as_of"
|
|
189
|
+
]
|
|
190
|
+
}
|
|
191
|
+
}
|
|
128
192
|
},
|
|
129
193
|
"required": ["stock_name", "stock_code", "analysis_date", "sentiment_score",
|
|
130
194
|
"decision_type", "confidence", "core_conclusion"]
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import budgets from "../tools/cli_budgets.json" with { type: "json" };
|
|
2
|
+
import { basename } from "node:path";
|
|
3
|
+
|
|
4
|
+
// Hosts leave the CLI time to return its own structured failure.
|
|
5
|
+
export function commandTimeout(script, args) {
|
|
6
|
+
const key = `${basename(script)}:${args[0] ?? ""}`;
|
|
7
|
+
let budget = budgets[key] ?? budgets.default;
|
|
8
|
+
const option = (name, fallback) => args.includes(name) ? args[args.indexOf(name) + 1] ?? fallback : fallback;
|
|
9
|
+
const positiveInt = (value, fallback) => /^\d+$/.test(String(value)) && Number(value) > 0 ? Number(value) : fallback;
|
|
10
|
+
if (key === "screener.py:screen") {
|
|
11
|
+
budget += Math.ceil(positiveInt(option("--top", 20), 20) / budgets.l2_workers) * budgets.l2_batch;
|
|
12
|
+
} else if (key === "watchlist.py:analyze" || key === "watchlist_context.py:build") {
|
|
13
|
+
const count = String(args[1] ?? "").split(",").filter(s => s.trim()).length;
|
|
14
|
+
const workers = positiveInt(option("--workers", 3), 3);
|
|
15
|
+
budget += Math.ceil(count / workers) * budgets.watchlist_item;
|
|
16
|
+
if (key === "watchlist_context.py:build") {
|
|
17
|
+
budget += Math.ceil(count / Math.min(workers * 2, 6)) * budgets["anomaly_detect.py:detect"];
|
|
18
|
+
if (args.includes("--include-market-review")) budget += 3 * budgets["market_review.py:review"] + 30;
|
|
19
|
+
}
|
|
20
|
+
} else if (key === "market_review.py:review" && option("--market", "A") === "all") {
|
|
21
|
+
budget = 3 * budget + 30;
|
|
22
|
+
} else if (key === "technical.py:analyze" && args.includes("--periods")) {
|
|
23
|
+
const periods = String(option("--periods", "daily")).split(",").map(p => p.trim()).filter(Boolean);
|
|
24
|
+
budget *= new Set([option("--period", "daily"), ...periods]).size;
|
|
25
|
+
}
|
|
26
|
+
return budget * 1000 + 30_000;
|
|
27
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { mkdtemp, writeFile, rm } from "node:fs/promises";
|
|
2
|
+
import { tmpdir } from "node:os";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
|
|
5
|
+
// Large reports/K-lines exceed Windows argv limits. Remove transport files even on failure.
|
|
6
|
+
export async function withJsonInput(input, execute) {
|
|
7
|
+
let directory;
|
|
8
|
+
let result;
|
|
9
|
+
try {
|
|
10
|
+
directory = await mkdtemp(join(tmpdir(), "stock-analysis-"));
|
|
11
|
+
const path = join(directory, "input.json");
|
|
12
|
+
await writeFile(path, JSON.stringify(input), { encoding: "utf8", mode: 0o600 });
|
|
13
|
+
result = await execute(path);
|
|
14
|
+
} catch {
|
|
15
|
+
result = JSON.stringify({ error: "Analysis command failed; check input and interpreter/dependencies" });
|
|
16
|
+
} finally {
|
|
17
|
+
if (directory) {
|
|
18
|
+
try {
|
|
19
|
+
await rm(directory, { recursive: true, force: true });
|
|
20
|
+
} catch {
|
|
21
|
+
result = JSON.stringify({ error: "Could not remove temporary analysis input" });
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
return result;
|
|
26
|
+
}
|
|
@@ -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回测也不能代替共享资金、旧仓保留和整池风险中位数。本工具不计算历史组合收益,不把信号计划冒充组合回测。
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# 多期限趋势
|
|
2
|
+
|
|
3
|
+
通过现有get_technical_analysis请求daily、count=360,读取trend_horizons。模型用21/63/252根日K约代表1/3/12个月,不强凑七档标签,不是星球公式或肥尾预测。
|
|
4
|
+
|
|
5
|
+
## 计算与解释
|
|
6
|
+
|
|
7
|
+
每期限过去对数收益为 log(close_t)-log(close_(t-h))。每个月第一根可见、正成交量日K的收盘形成观察,其后保持到下个月首根有效日K收盘。未提供volume时只能沿输入记录观察;提供volume时零成交量记录不计回溯根数。观察K线必须已收盘,任何研究成交使用之后的开盘。
|
|
8
|
+
|
|
9
|
+
components逐一返回period与log_return,positive_count/negative_count/neutral_count统计三期限方向;至少2个为正/负则direction为up/down,全部零为flat,其他为mixed。它们是已发生路径的描述,MUST NOT 解释为独立投票概率、未来涨跌概率或自动配置比例。相关期限不能当作独立样本。
|
|
10
|
+
|
|
11
|
+
仅支持daily输入。最长需在月度观察时已有253根有效收盘;最新已有253根而当月首根尚不足时仍不可用,不能用最新日重新计算冒充月度观察。建议请求360根,报告实际history_start、as_of、decision_as_of及price_basis。数据不足、混用调整标记或坏日期必须报告unavailable_reason,不伪造中性。多周期摘要保留整个trend_horizons,周/月K返回requires_daily_bars。
|
|
12
|
+
|
|
13
|
+
当前validation_status=not_validated。旧trend_temperature为兼容的EMA/ATR研究描述;不再将它的七档视为默认趋势模型。新字段也不能覆盖原综合评分或买卖信号。
|
|
14
|
+
|
|
15
|
+
## 回测与证据边界
|
|
16
|
+
|
|
17
|
+
DSL指标monthly_momentum复用相同Python计算,period默认63。它是单期限信号。三期限研究组合从相同起点分别给初始资金三分之一,独立留存盈亏、权重漂移,并没有每月等权再平衡;并行买卖分别计费,没有跨子账户净额撮合。研究另外拟合了一个跨市场共用的初始活跃资金比例0.8704,剩余现金不动;这是2022–2025研究集风险拟合结果,MUST NOT 作为用户账户默认仓位。
|
|
18
|
+
|
|
19
|
+
新12股复核:A/HK路径回报较旧规则提高,美股回报接近、回撤较小;但港股最大回撤恶化约6.1个百分点,未通过预设5个百分点门槛。因此没有建立跨市场统一优势,MUST NOT 称为已验证策略。A股研究用了供应商AdjClose因子OHLC,不等于完整投资者总回报;产品A股输入通常仍为qfq,不能直接照搬该收益。
|
|
20
|
+
|
|
21
|
+
原核心固定止损/止盈默认值不变;省略配置不代表禁用。单份普通YAML回测不会自动复制三子策略和预热协议。
|
|
22
|
+
|
|
23
|
+
研究背景:[Hurst/Ooi/Pedersen原文](https://www.aqr.com/-/media/AQR/Documents/Insights/Journal-Article/AQR-JPM-Fall-2017.pdf)讨论1/3/12个月趋势组合。本实现的个股多头、月初观察、正成交量过滤、资金漂移和风险拟合均为本项目假设,不是论文复现或七档背书。
|
|
24
|
+
|
|
25
|
+
## 市场环境入场实验
|
|
26
|
+
|
|
27
|
+
需复现“市场只限制新开仓”的研究时,使用同一skill的 `scripts/market_trend.py`,无需新增宿主工具或个人持仓数据库。输入是两份已取得的daily OHLCV JSON数组(个股、同市场宽基),包含date/open/high/low/close/volume;调整口径须在各自序列内一致。market-symbol标识调用者提供的市场输入,不自动下载或验证标的归属。研究代理固定A510300、HK2800.HK、US SPY;自换代理属于另一项实验。
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
python3 scripts/market_trend.py stock-daily.json market-daily.json \
|
|
31
|
+
--symbol AAPL --market-symbol SPY --start 2022-01-01 --end 2025-12-31 \
|
|
32
|
+
--capital 10000000 --allocation 0.8704
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
两份输入必须含评估开始之前的预热历史:个股最长252根过去收益在观察时需253根有效收盘,市场SMA200需200根。预热只计算指标,不建立虚拟持仓或产生收益。起点前最后有效收盘,以已知月度个股方向和当日市场条件初始化空仓目标;之后只在月度观察给出新开仓许可,次日有效开盘执行。市场close>SMA200允许新的月度正动量子策略进入;弱市不强制退出已持仓,个股月度动量<0仍退出。待买订单遇到下月许可失效会取消,不能冒充已持仓豁免。
|
|
36
|
+
|
|
37
|
+
脚本默认allocation=1,0.8704只为显式复现前轮研究,不是账户建议。21/63/252初始各分三份、按分向下取整,余款留现金,利润各自保留而非每月等权重置。费用固定佣金/滑点各每边0.1%,税与现金利息0;输出明确参数、资金、评估开始/预热开始、交易、净值和指标。采用本地JSON输入,不保存个人仓位、不下单。普通 `run_backtest` 的单份YAML不会自动执行这个三子策略或抓市场预热;不要冒充二者完全相同。
|
|
38
|
+
|
|
39
|
+
当前方法尚未通过完整跨市场效果门槛,`validation_status=not_validated`。MUST NOT 将局部样本上涨或相对旧模型改善称为稳定的跨市场交易优势。
|
|
40
|
+
|
|
41
|
+
## 温度状态与切换事件
|
|
42
|
+
|
|
43
|
+
解读星球信号或设计入场协议时,MUST 区分当前状态和新发生的切换事件:“今天仍热”不等于“今天温转热”。当前月度方向策略按状态选股,不是官方事件策略。事件协议须明确可得时间、有效期限和重复事件加仓条件;无合格新事件时,卖出所得留在现金。预热不产生新事件或虚拟持仓。外部同名温度的计算公式未公开,不能将成员筛选条件或自述收益作为官方规则或验证结果。
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# 独立趋势温度
|
|
2
|
+
|
|
3
|
+
用于用户要求计算趋势温度、寒凉温热状态或复核趋势强度时。调用现有 `get_technical_analysis`,读取 `trend_temperature`;skill 的采集脚本也会在 `technical.trend_temperature` 返回同一结果。无需配置外部温度接口,不保存个人持仓。
|
|
4
|
+
|
|
5
|
+
## 来源与定位
|
|
6
|
+
|
|
7
|
+
这是本项目可重复计算的研究基线,`experimental=true`。它不是趋势动物算法,不是塔勒布肥尾指标,也不是原有 100 分综合评分或复盘市场温度。连续分数描述均线相对真实波幅的分离;七档是未经收益校准的显示假设。MUST 同时报告模型、周期、分数、数据日期及实验性质,MUST NOT 将其称为上涨概率、已验证的交易优势或星球官方信号。
|
|
8
|
+
|
|
9
|
+
`validation_status=not_validated`:真实股票检验没有建立默认入场规则的优势;降低门槛、延长慢线和通道对照也未通过修订研究门槛。默认解释 `direction` 与连续分数,MUST NOT 自行把七档或零轴转换成交易建议。仅在用户明确要求七档时展示研究标签;用户自定条件的回测是研究,不代表推荐。
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## 公式与数据
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
TR_t = max(high_t-low_t, abs(high_t-close_(t-1)), abs(low_t-close_(t-1)))
|
|
16
|
+
ATR14_t = 最近14个有效TR的简单均值
|
|
17
|
+
score_t = (EMA20(close)_t - EMA60(close)_t) / ATR14_t
|
|
18
|
+
EMA_p,t = (2/(p+1))*close_t + (1-2/(p+1))*EMA_p,t-1
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
EMA 用输入首个收盘价初始化(adjust=False),前收缺失的首根 TR 不计算;ATR 使用简单平均,不是 Wilder 平滑。默认至少 60 根 K 线才有分数,至少 61 根才可能有前一期状态。周期按根数:周线即 20/60 周及 14 周波幅,不能与日线信号混称。
|
|
22
|
+
|
|
23
|
+
`direction/previous_direction` 仅按 EMA 差的正负返回 up/down/flat,未预热或无有效分数时为 null;不是预测方向。七档的“平”包含正负分数,不能代替方向;`previous_state` 和 `transition` 仍只表示显示档位变化。多周期摘要附 `trend_score`、`trend_temperature_state`、`trend_temperature_direction`、`trend_temperature_validation_status`、`trend_temperature_as_of`、`trend_temperature_price_basis` 和 `trend_temperature_unavailable_reason`。各周期日期和价格口径分别核验,不能用顶层日线日期代替周线或月线日期;原 `resonance` 仍基于既有均线方向,不能称为七档温度共振。
|
|
24
|
+
|
|
25
|
+
价格需有限且为正,满足 low ≤ close ≤ high;日期唯一且递增。技术分析入口会先按日期排序;明确混用复权标记时温度不可用。`price_basis=unknown` 仍需核实价格口径;没有标记不代表已确认复权。保留 `history_start`,输入历史起点不同会影响 EMA 初始化和当前分数。缺失交易日和停牌不能仅靠日期排序鉴别;`previous_as_of` 是输入的前一根 K 线日期,不保证是交易所的上一交易日。
|
|
26
|
+
|
|
27
|
+
零 ATR、不足预热或无效行情输出 `score/state=null` 和 `unavailable_reason`,不伪造为平。最新 K 线可能尚未收盘,MUST 先确认数据时点再按收盘纪律判断。分数不要求正态分布,但 ATR 和 EMA 都会受极端波动及观察窗口影响;波幅放大也可能使分数降档。
|
|
28
|
+
|
|
29
|
+
## 七档显示
|
|
30
|
+
|
|
31
|
+
| score | 状态 |
|
|
32
|
+
| --- | --- |
|
|
33
|
+
| 小于 -3 | 冻 |
|
|
34
|
+
| [-3, -1.5) | 寒 |
|
|
35
|
+
| [-1.5, -0.5) | 凉 |
|
|
36
|
+
| [-0.5, 0.5] | 平 |
|
|
37
|
+
| (0.5, 1.5] | 温 |
|
|
38
|
+
| (1.5, 3] | 热 |
|
|
39
|
+
| 大于 3 | 沸 |
|
|
40
|
+
|
|
41
|
+
`previous_score/previous_state` 只取前一根,不跳过不可用记录;`transition` 仅在本根和前根均可用且状态不同时返回。它们由本次行情计算,不需要跨日保存账户。
|
|
42
|
+
|
|
43
|
+
温/热/沸表示本基线的正向分离程度,不等于星球的同名状态。沸不证明已经过热或将反转;平不表示没有波动。MUST 将描述与用户的入场、退出规则分开,不照搬星球“温转热开仓、危险全平”等标签动作,也不由本字段自动覆盖原 `buy_signal`。
|
|
44
|
+
|
|
45
|
+
## 历史检验
|
|
46
|
+
|
|
47
|
+
回测 DSL 可使用 `indicator: trend_score`;默认参数与技术分析相同。既有 `fast_period/slow_period` 调整 EMA,`period` 调整 ATR;快线必须短于慢线且均为正整数。修改参数后七档阈值不自动校准。
|
|
48
|
+
|
|
49
|
+
不提供默认温度入场示例。用户指定研究规则后,仍须说明原引擎默认 stop_loss=-0.10、take_profit=0.50,省略不代表禁用。预热/零 ATR 为 NaN 时条件不成立,不能凭首个有效分数声称发生穿越。默认次日开盘成交,保留 signal_date/date;涨跌停、跳空及其他限制沿用原引擎。
|
|
50
|
+
|
|
51
|
+
用户要求检验时按 [策略回测](../../strategy-backtest/SKILL.md)先固定规则,再做时间样本外与跨标的比较,报告反复切换、成本、回撤和交易数量。滚动验证每段重新初始化,测试窗口必须足够覆盖预热及评估期。结合已有 [肥尾收益诊断](fat-tails.md)检查大赢家贡献,不把正偏或集中度当作正收益证明。
|
|
52
|
+
|
|
53
|
+
理论参考:[Time Series Momentum](https://www.aqr.com/Insights/Research/Journal-Article/Time-Series-Momentum)提供历史收益趋势研究依据,不验证本模型的 20/60/14 参数和阈值;[Taleb κ](https://arxiv.org/html/1802.05495)衡量样本聚合稳定性,不输出趋势方向。
|
|
54
|
+
|
|
55
|
+
## 使用入口
|
|
56
|
+
|
|
57
|
+
当前趋势研究优先使用[多期限月度趋势](trend-horizons.md)的trend_horizons,daily、count=360。独立趋势温度继续保留供兼容和既有计算复现,不将七档作为默认趋势判断。多期限趋势也尚未通过全部跨市场风险门槛,不是自动入场信号。
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Stateless monthly trend experiment from stock and market OHLCV JSON arrays."""
|
|
3
|
+
|
|
4
|
+
import argparse
|
|
5
|
+
import json
|
|
6
|
+
import sys
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
|
|
9
|
+
import numpy as np
|
|
10
|
+
|
|
11
|
+
sys.path.insert(0, str(Path(__file__).resolve().parents[3] / "tools"))
|
|
12
|
+
from _subproc import json_safe, utf8_stdio # noqa: E402
|
|
13
|
+
from backtest import compute_metrics, simulate_monthly_market # noqa: E402
|
|
14
|
+
from technical import calc_trend_horizons, to_dataframe # noqa: E402
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class Parser(argparse.ArgumentParser):
|
|
18
|
+
def error(self, message):
|
|
19
|
+
raise ValueError(message)
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def read_prices(path):
|
|
23
|
+
records = json.loads(Path(path).read_text(encoding="utf-8"))
|
|
24
|
+
if not isinstance(records, list) or not records or any(not isinstance(row, dict) for row in records):
|
|
25
|
+
raise ValueError("Expected a nonempty OHLCV JSON array")
|
|
26
|
+
frame = to_dataframe(records)
|
|
27
|
+
fields = ["open", "high", "low", "close", "volume"]
|
|
28
|
+
if "date" not in frame or any(field not in frame for field in fields):
|
|
29
|
+
raise ValueError("OHLCV input requires date, open, high, low, close and volume")
|
|
30
|
+
if not np.isfinite(frame[fields]).all().all() or (frame[fields[:4]] <= 0).any().any():
|
|
31
|
+
raise ValueError("OHLCV input requires finite positive prices")
|
|
32
|
+
if (
|
|
33
|
+
(frame.low > frame.close) | (frame.close > frame.high) | (frame.low > frame.open) | (frame.open > frame.high)
|
|
34
|
+
).any():
|
|
35
|
+
raise ValueError("OHLCV input requires low <= open/close <= high")
|
|
36
|
+
return frame
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def main():
|
|
40
|
+
parser = Parser(description=__doc__)
|
|
41
|
+
parser.add_argument("prices")
|
|
42
|
+
parser.add_argument("market_prices")
|
|
43
|
+
parser.add_argument("--symbol", required=True)
|
|
44
|
+
parser.add_argument("--market-symbol", required=True)
|
|
45
|
+
parser.add_argument("--start", required=True)
|
|
46
|
+
parser.add_argument("--end")
|
|
47
|
+
parser.add_argument("--capital", type=float, default=1000000)
|
|
48
|
+
parser.add_argument("--allocation", type=float, default=1)
|
|
49
|
+
try:
|
|
50
|
+
args = parser.parse_args()
|
|
51
|
+
prices, market = read_prices(args.prices), read_prices(args.market_prices)
|
|
52
|
+
if args.end:
|
|
53
|
+
prices = prices[prices.date <= args.end].copy()
|
|
54
|
+
result = simulate_monthly_market(prices, market, args.capital, args.symbol, args.start, args.allocation)
|
|
55
|
+
result.update(symbol=args.symbol, market_symbol=args.market_symbol, trend_horizons=calc_trend_horizons(prices))
|
|
56
|
+
start = result["start"]
|
|
57
|
+
result["equity_curve"] = [row for row in result["equity_curve"] if row["date"] >= start]
|
|
58
|
+
end = result["equity_curve"][-1]["date"]
|
|
59
|
+
result["metrics"] = compute_metrics(
|
|
60
|
+
result["trades"], result["equity_curve"], args.capital, result["final_equity"], start, end
|
|
61
|
+
)
|
|
62
|
+
result["warnings"] = [
|
|
63
|
+
"Research only: market close>SMA200 gates new monthly entries, not existing exits. "
|
|
64
|
+
"Need stock 253 and market 200 valid closes before observation; verify all bars are closed. "
|
|
65
|
+
"Three initially equal sleeves drift; costs are commission/slippage 0.1% each side, tax/interest zero. "
|
|
66
|
+
"Historical splits/dividends, actual board lots, limits and liquidity need separate verification. "
|
|
67
|
+
"Passing one small historical cohort is not stable cross-market validation."
|
|
68
|
+
]
|
|
69
|
+
except Exception as exc:
|
|
70
|
+
print(json.dumps({"error": str(exc)}, ensure_ascii=False))
|
|
71
|
+
return 1
|
|
72
|
+
print(json.dumps(json_safe(result), ensure_ascii=False, allow_nan=False))
|
|
73
|
+
return 0
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
if __name__ == "__main__":
|
|
77
|
+
utf8_stdio()
|
|
78
|
+
sys.exit(main())
|
|
@@ -5,10 +5,18 @@ description: 综合股票分析:联合技术、基本面、资金、消息和
|
|
|
5
5
|
|
|
6
6
|
# 综合股票分析
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
在启用原生工具发现的 Pi 中,所需工具尚未暴露时,先用 `tool_search` 搜索确切工具名或英文关键词,再按本文流程调用;其搜索器目前不对中文分词。旧 Pi 或其他宿主按当前实际提供的工具直接执行。
|
|
9
|
+
|
|
10
|
+
在 dsh 提供 `stock_tool_search` 且所需工具尚未暴露时,先搜索中文功能关键词或确切工具名,加载后按原名调用;搜索不执行分析。没有发现入口时直接使用当前提供的工具。
|
|
11
|
+
|
|
12
|
+
美股机构研究调用 `get_us_holdings(cik, mode=auto)`:有当前或已检索历史 13F 时返回机构组合,否则按发行人 CIK 反查机构;也可显式选 `manager/issuer`,如 Berkshire `0001067983` 查组合、Apple `0000320193` 用 `issuer` 查机构。发行人映射仅使用核对 CIK 的官方 13D/G CUSIP,不做名称猜测;无映射直接报缺失。首次下载约 100 MB,后续缓存,共享 CLI 查询预算 300 秒(宿主另留退出余量)。读取 `report_date/filing_window_end/cusip_evidence`,区分持仓日期与披露窗口;修订重述替换、新增补充,缺基础版或未知修订时总量 null,并计入 `unresolved_manager_count`。`mapping_complete=false` 表示不能保证涵盖所有类别或变更,`complete_for_mapped_cusips` 只表示已映射证券在公开数据窗口的申报链完整性,不能称实时全部股东。期权/本金在 `positions` 单列,不能把跨机构持股简单合计成去重比例。机构组合查询仍返回最新已知报告期的原始 13F 与修订链接,缺少对应原始版时明确报错;`history_truncated=true` 时不能将旧记录当作已完整检索。存在修订先读原文,不能自动推断变化。
|
|
9
13
|
|
|
10
14
|
美股内部人研究调用 `get_insider_trades(symbol, days=90, top=10)`,需设置含真实联系邮箱的 `SEC_USER_AGENT`。`days` 按申报日期过滤,`top` 限制文件数;只将代码 P/S 视作买卖信号,授予、行权、赠与等保留原始代码和脚注,衍生品单列。Form 4/A 与原申报勿重复计算,检查截断和失败提示;`screen_risk` 仍仅支持 A 股。
|
|
11
15
|
|
|
16
|
+
## 无状态分析扩展
|
|
17
|
+
|
|
18
|
+
当用户要求同行比较、组合风险、仓位预算或新旧分析比较时,MUST 读取[无状态研究工具](references/stateless-analysis.md),分别使用 compare_stocks、analyze_portfolio_risk、calculate_position_size、compare_analysis_snapshots。所有用户状态均由本次输入提供。
|
|
19
|
+
|
|
12
20
|
## 意图路由表
|
|
13
21
|
|
|
14
22
|
快速问答先判断意图,按下表走最短调用链;完整综合研判走下方执行流程(gather 采集管线),不受此表限制。单工具可答的问题按各工具描述中的适用场景选择,本表不再重复。
|
|
@@ -72,18 +80,20 @@ python3 scripts/gather.py <symbol>
|
|
|
72
80
|
### 第三步:渲染研报
|
|
73
81
|
|
|
74
82
|
1. 按 [报告 schema](../../schemas/report_schema.json) 构建结构化报告。
|
|
75
|
-
2. 每个结论只使用成功返回的数据;缺失维度在 `risk_warning`
|
|
83
|
+
2. 每个结论只使用成功返回的数据;缺失维度在 `risk_warning` 中说明影响。必须填写 `evidence`,每项使用原始工具结果路径(如 `get_quote.price`)、读者可理解的 `label`、原始 `value`、实际 `source` 和数据时间 `as_of`;未知来源或时间填 null,不用采集时间替代。历史财报与顶层快照分别引用日期、币种和单位,不把不同期间的数值拼成同一结论。 来源与时间沿证据 path 继承最近父对象的 source(该键缺失时用 snapshot_source)和 data_as_of,子对象的对应值(包括显式 null)覆盖祖先;数组项及 warnings 字符串同样继承,不能仅因叶子字段没有来源就填 null。整条路径均未提供对应元数据时才填 null,不能用工具名或策略方法名代替来源;as_of 保留完整数据时间及其时区。report_date 是财报报告期,应单独引用 value,不能当成披露日期或 data_as_of。证据 path 不含调用参数,例如 get_financials.periods.0.roe;股票名称未返回时 stock_name 填“未知”,不能凭常识补名;已知返回对象中未提供的末级字段可用 value=null 表示未知,其 source/as_of 可填 null,若填写则必须来自已知父对象;不能编成空数组、字符串或数值,不能跨缺失对象或数组编造路径;错误 value 保留原始字符串,不加 error: 前缀。请求的期间或文件路径不证明实际数据覆盖期或文件内容,需与实际返回数据区分。
|
|
84
|
+
同时填写 `data_quality.flags/limitations`:关键数据缺失用 `partial_data`,明确过期行情用 `stale_quote`,同期间同口径来源冲突用 `conflicting_data`,回测/信号样本不足用 `insufficient_sample`。出现这些限制时降低置信度,不能给出 strong_buy;没有有效现价时不编造数值交易计划。数据完整时 flags 为空数组,限制仍按实际模拟条件说明。
|
|
76
85
|
3. 调用 `render_stock_report`:快速问答用 `brief`,完整研判用 `full`。
|
|
77
86
|
4. 输出渲染后的 Markdown;只在用户要求机器可读数据时附加结构化 JSON。
|
|
78
87
|
|
|
79
88
|
## 信号跟踪闭环
|
|
80
89
|
|
|
81
90
|
- 给出明确买卖建议(方向 + 入场价/目标价/止损价)时,调 `record_signal` 存档,`source` 填触发该建议的 skill 名(如 `stock-analysis`、`dragon-head`)。
|
|
82
|
-
- 后续会话用 `evaluate_signals` 结算到期信号(target_hit/stop_hit/timeout 并回写收益),用 `get_signal_summary`
|
|
91
|
+
- 后续会话用 `evaluate_signals` 结算到期信号(target_hit/stop_hit/timeout 并回写收益),用 `get_signal_summary` 复盘胜率与平均收益(可按 source/symbol/status 过滤),同时报告 `return_samples/sample_warning`,缺失收益不按零计;这些是观察性建议记录,不是扣除成本的策略回测。
|
|
83
92
|
- 信号持久化在本地 JSONL(`$STOCK_SIGNAL_STORE` 或 `~/.stock-analysis/signals.jsonl`);是否记录由宿主 Agent 决定,不阻塞报告输出。
|
|
84
93
|
|
|
85
94
|
## 注意事项
|
|
86
95
|
- `get_kline` 的 A 股股票/ETF 数据为前复权,每条记录 `adjusted="qfq"`;显式指数 `sh000xxx` / `sz399xxx` 为原始点位,`adjusted="none"`。复权数据源全部失败时说明数据缺失,不用未复权价格补算指标或信号。
|
|
96
|
+
- 行情读取 `source/fetched_at/data_as_of`,`fetched_at` 是 UTC 采集时间;`as_of_basis=trading_calendar` 是日历推断,不能声称是提供方报价时间。提供方时间未知时明确说明时效性未核实。
|
|
87
97
|
- 始终提供风险提示
|
|
88
98
|
- 不做绝对化的涨跌预测
|
|
89
99
|
- 建议用户结合自身风险偏好做决策
|
|
@@ -112,3 +122,7 @@ python3 scripts/gather.py <symbol>
|
|
|
112
122
|
get_shareholder_structure 的 northbound 优先使用沪深官方季度总量;northbound_nominee 只是十大股东推断,不能混同。get_etf_details 的 basket 是完整已发布 PCF,对价数量/现金替代规则不是基金实际持仓或NAV权重。HK 股息排行使用 get_dividends(mode=ranking, market=HK),年度口径不能称 TTM。
|
|
113
123
|
|
|
114
124
|
实际披露股票持仓可用 get_etf_details(include_full_holdings=true) 获取半年度/年度表;按 as_of 解释,数量为股、市值为人民币元。默认不取大量明细;不是实时全资产组合,不与 PCF 对价数量混同。
|
|
125
|
+
|
|
126
|
+
信号价格使用原始报价口径。复权 K 线需有记录日的可核实 adjustment_factor,才能换算入场/目标/止损及收益;缺失时 skipped_price_basis 并保持未结算,不得猜测拆股或除权比例。evaluate_signals 返回 complete/deferred/warnings;预算耗尽时已完成结果保存,未处理记录下次重试。当前仅日线 Tushare、Alpha Vantage 提供可验证换算系数,其余复权来源可能跳过结算。
|
|
127
|
+
|
|
128
|
+
自选股上下文异动检查失败时 anomaly_status=unavailable、anomaly_count=null,并提供 anomaly_error/warnings;summary.partial 不得写成无异常或完整成功。
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# 无状态研究工具
|
|
2
|
+
|
|
3
|
+
这些工具在一次调用中计算,不维护自选股、账户、规则或历史。宿主/用户显式提供本次持仓、历史快照与正文。采集继续用已有行情、财务、公告工具。MUST 从原始结果取值、保留来源和时点;MUST NOT 补造缺失值、股票池或持仓。缺少必需输入时只索取该输入。
|
|
4
|
+
|
|
5
|
+
## 同行比较:compare_stocks
|
|
6
|
+
|
|
7
|
+
1. 确定用户提供或有明确行业依据的可比股票,调用 get_financials/get_quote/get_stock_info;必要时 resolve_stock_sectors。不要用全市场估值直接代替同行。
|
|
8
|
+
2. 传 `companies`(2..30项),每项 `{symbol, period, metrics}`。`metrics` 每项 `{name, value, unit, basis, source?}`,缺失 value=null。`period` 是指标的共同报告期或估值日;同一公司不同期间的指标应分批比较。
|
|
9
|
+
3. 核实单位。A 股 roe/net_profit_margin/gross_margin 可能是百分数,而 Yahoo roe/profit_margin 是小数;只有确定源口径时才换算并记录依据。金额单位必须含币种。不同年度、TTM 与单季、合并与母公司报表分开。
|
|
10
|
+
4. 工具只有 unit/basis/period 完全一致且至少两项有效数值时返回 ascending。它表示升序,MUST NOT 称为买入排名。亏损 PE、负 PB 和行业特有口径需另行说明,不按“越低越好”解释。
|
|
11
|
+
|
|
12
|
+
## 公告财报比较:analyze_disclosure_changes
|
|
13
|
+
|
|
14
|
+
传 `previous/current`,每项 `{text, source, period, metrics}`;正文上限200000字符,metrics 形状同上(可为空),`max_changes` 默认30、上限100。
|
|
15
|
+
|
|
16
|
+
先查询原始公告;HTML 可用 extract_article,但它默认截断正文,不能将其结果自动视为全文。PDF/OCR 由宿主文档读取能力或用户提供,MUST NOT 把标题、链接或搜索摘要冒充全文。缺少正文时仍可分析已核实的财务指标,但不要调用要求正文的比较工具。
|
|
17
|
+
|
|
18
|
+
工具输出精确到传入文本行号的变化片段、来源、截断标志和指标差异。文本差异本身不等于经营变化;Agent 要阅读上下文,说明发生了什么、与原预期的关系和可能反证,并引用原文。金额单位和 basis 一致才计算 delta;前期值大于0才计算普通增长率,亏损转盈另述。报告期可不同,但必须核实是可比同长期间(年度/同比单季等),累计季度不能直接当单季。
|
|
19
|
+
|
|
20
|
+
## 组合风险:analyze_portfolio_risk
|
|
21
|
+
|
|
22
|
+
输入 `base_currency`、基准币种 `cash>=0`、`positions`(1..100项)。持仓 `{symbol, quantity, price, currency, cost?, stop_price?, sector?, as_of?}`,现货多头;重复标的先汇总。价格/数量为正,单位由调用方确认。
|
|
23
|
+
|
|
24
|
+
可选 `fx_rates:[{currency,rate}]`,rate 表示一单位非基准币种兑换多少基准币种;基准币种隐含1,禁止重复。缺汇率不能部分汇总冒充总资产。相同币种现金先换成基准币种再输入;其他币种现金可按现金类头寸单独注明,不能当股票计算相关性。
|
|
25
|
+
|
|
26
|
+
输出总权益、现金权重、单股权重、行业/币种敞口和持仓 HHI(不含现金项)。`price_pnl_base` 是按当前汇率折算的本币价格盈亏,MUST NOT 称为包含汇兑损益的账户真实收益;缺任何成本时为null。`stop_loss_risk_base` 是从现价到止损的损失情景,缺任何止损时为null,不保证成交。
|
|
27
|
+
|
|
28
|
+
可选 `histories:[{symbol,prices:[{date,close}]}]`,工具按每对标的共同日期计算收益相关性;至少4个共同价格点、存在波动才有结果。不是组合收益率或汇率调整后的相关性;少样本、跨时区非同步收盘和缺交易日都应说明,不从相关性推断因果。缺历史时明确相关性未计算。
|
|
29
|
+
|
|
30
|
+
## 仓位预算:calculate_position_size
|
|
31
|
+
|
|
32
|
+
必需 `equity,cash,entry_price,stop_price,risk_fraction,lot_size`。风险比例0..1,止损正且低于入场价,现金0..equity,交易单位正整数。所有金额同币种。
|
|
33
|
+
|
|
34
|
+
可选 `max_position_fraction=1`(0..1)、`fee_rate=0` 与 `slippage_rate=0`(每边比例0..0.1)。买入现金按 entry×(1+slippage)×(1+fee),止损回收按 stop×(1-slippage)×(1-fee);每股差额计入风险预算。现金、风险和本次最大买入资金分别向下取整到lot,取最小数量。已有同股持仓时,先扣减用户允许的新增仓位和风险额度,不能把本次额度当成最终账户仓位限制。
|
|
35
|
+
|
|
36
|
+
lot_size 来自用户或可核实交易规则,尤其港股不能统一猜100股。工具不覆盖券商最低收费、未提供税费、跳空和流动性风险。quantity=0 表示当前约束下不足一个交易单位,MUST NOT 向上凑整。
|
|
37
|
+
|
|
38
|
+
## 事件研究:analyze_event_study
|
|
39
|
+
|
|
40
|
+
通常直接传 `symbol,benchmark,start_date,end_date,event_dates`,由共享 Python 核心取数,避免模型复述整段K线。股票与基准应属于同一市场;代码模式输出实际覆盖区间和提供方复权标记,没有标记时明确未指定,不用调用方猜测覆盖。开始日期须覆盖事件前一交易日、结束日期须覆盖最长事件窗口。也可使用下面的显式价格模式,两种模式互斥。
|
|
41
|
+
|
|
42
|
+
传 `prices,benchmark_prices`(各2..20000条 `{date:"YYYY-MM-DD",close}`)、`event_dates`(1..100个唯一日期)、`price_basis`(明确股票与基准各自复权口径)。可选 `horizons`(1..20个0..250整数,默认0/1/5/10/20)。复用 get_kline,先核实数据覆盖事件前一交易日至最大窗口结束。
|
|
43
|
+
|
|
44
|
+
事件日映射到股票序列中不早于指定日期的首日;盘后事件应显式使用下一交易日。基点是该日前一个股票交易日收盘;horizon=0表示事件当日收盘。基准必须同市场,并在两个端点都有数据,缺失时不移动事件日期。收益差是股票与基准各自买入持有收益的差(百分点),不等于因果影响。
|
|
45
|
+
|
|
46
|
+
MUST 核实完整交易日、复权、币种和股息处理。工具无法从缺行判断是停牌、节假日还是数据故障。重叠事件标识意味着样本不独立;少样本均值不能作为稳定预测。
|
|
47
|
+
|
|
48
|
+
## 回测稳健性:validate_backtest
|
|
49
|
+
|
|
50
|
+
通常传 `symbols:[代码],start_date,end_date,strategies`,Python 直接复用现有 K 线获取;不要让模型抄写数千条行情。也可使用下面的显式 datasets 模式,两种模式互斥。读取每个标的 data_coverage,实际覆盖不足时缩小结论范围;提供方未标记价格口径时须说明。代码模式共享CLI预算660秒、事件研究300秒,宿主另留退出余量。
|
|
51
|
+
|
|
52
|
+
传 `datasets`(1..5项 `{symbol,price_basis,bars}`,bars 是按日期升序的 date/open/high/low/close/volume,每组最多2000条)、`strategies`(1..5项 `{name,strategy}`,完整既有DSL的JSON对象)。可选 `train_bars=126,test_bars=63`(各30..1000)、`capital=1000000`。每组至少训练+测试长度。
|
|
53
|
+
|
|
54
|
+
通过现有 get_kline 取完整数据,读取用户策略后转换为JSON;parameters 引用复用现有引擎解析。候选应事先确定,只在用户要求优化时扩展候选,MUST NOT 看测试窗口收益后反复改参数并仍称样本外。
|
|
55
|
+
|
|
56
|
+
每个标的独立滚动训练,按训练总收益选候选(并列按输入顺序),在其后的非重叠完整测试窗口评估。返回每个候选的训练结果、选中者及测试结果;全区间 sensitivity 是样本内比较。尾部不足完整测试窗口会报告unused_tail_bars。
|
|
57
|
+
|
|
58
|
+
选择使用相同初始资金下的实际 `final_equity`,不使用展示精度舍入后的收益。所有入场/退出条件先校验,未触发的条件也不能绕过检查;坏候选单独返回 error,不中断合法候选。无法定义的 `profit_loss_ratio` 为null,不能当作0;其余数值溢出或无效Unicode输入返回JSON错误。
|
|
59
|
+
|
|
60
|
+
每个窗口从现金和重新初始化的指标开始,不拼成连续组合;MUST NOT 把各窗口年化收益平均当成实际年化。只允许next_open。关注候选错误、交易数和未平仓;收益含未平仓市值,交易统计仅含已平仓。不同标的和不同参数的收益分散程度是稳健性证据,不是自动策略认证。缺少历史股票池、退市样本、公司行为和限价数据时保留原回测限制。
|
|
61
|
+
|
|
62
|
+
## 快照比较:compare_analysis_snapshots
|
|
63
|
+
|
|
64
|
+
传 `previous/current` JSON对象;嵌套字典按JSON Pointer输出变化,数组按整体比较。批量股票应先以symbol构造字典,时间戳/采集耗时等机械字段先按需求排除,避免无意义变化。
|
|
65
|
+
|
|
66
|
+
状态为added/removed/changed/unavailable/recovered。null 或包含error的对象表示不可用;removed只表示键从输入消失,MUST NOT 自动解释为退市、卖出或业务事件。缺少历史输入时仅做当前分析;持久化、调度及通知由宿主负责。
|
|
@@ -66,7 +66,9 @@ python3 tools/screener.py screen --market A --top 20
|
|
|
66
66
|
- 建议结合个股深度分析后再做决策
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
|
|
69
|
+
每个候选必须读取 `factor_coverage.available/missing/ratio/effective_weights`。ratio 是已覆盖因子的原始权重之和;L1 与 L2 的 effective_weights 均按可用因子重归一化,缺失或非有限值不按零分计,排序前先按实际可用因子计算综合分,effective_scores 保留实际参与计算的各组分数;用 sum(effective_scores[g] × effective_weights[g]) × market_sentiment.multiplier 核对 scores.final(四舍五入至一位)。scores.momentum 仍保留 L1 参考值,L2 贡献以 effective_scores.momentum 为准。相同分数但缺失因子不同的候选不能视为同等证据,报告缺失项和覆盖度,不以 `enriched=true` 代替覆盖判断。`scores.final=null` 表示没有足够因子计算,不能作为高分候选推荐。
|
|
70
|
+
|
|
71
|
+
完成标准:列出实际生效的市场、过滤条件、排序口径和候选数量,且推荐理由只使用返回数据,并说明因子覆盖。
|
|
70
72
|
|
|
71
73
|
## 策略模板
|
|
72
74
|
|
|
@@ -93,3 +95,5 @@ dividend_report_date: "2025-12-31"
|
|
|
93
95
|
### 补充数据覆盖
|
|
94
96
|
|
|
95
97
|
股息筛选支持 A/HK:A 股为报告期已实施方案股息率,HK 为 HKEX/LSEG 年度股息率。两者都不是当前价 TTM;使用结果的 yield_basis 和 report_date,缺失不当零。
|
|
98
|
+
|
|
99
|
+
选股的 top 必须为正整数;超时预算按候选数量与采集批次计算。
|