stock-analysis-plugin 0.2.8 → 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 +13 -10
- package/package.json +9 -5
- package/pi/index.ts +217 -4
- package/scripts/setup-python.mjs +11 -4
- package/scripts/venv-python.mjs +7 -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 +2 -0
- package/tools/capabilities.py +2 -0
- package/tools/cli_budgets.json +2 -1
- package/tools/report_renderer.py +4 -0
- package/tools/sector_rotation.py +466 -0
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Deep Sector Rotation Swing Trading:原文与可复现边界
|
|
2
|
+
|
|
3
|
+
来源:Joel R. Bock、Akhilesh Maewal,2023-01-04,*Deep Sector Rotation Swing Trading*,[SSRN 4280640](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4280640),9页版本。页码为论文印刷页码。下述记录来自完整论文,不以引用文献或二手摘要代替本论文规则。
|
|
4
|
+
|
|
5
|
+
## 已披露的规则
|
|
6
|
+
|
|
7
|
+
| 内容 | 原文依据 |
|
|
8
|
+
|---|---|
|
|
9
|
+
| 参考池 | §2.1、表1,第3页:XLK、XLV、XLY、VOX、XLF、XLI、XLP、XLU、XLB、IYR、XLE;只是论文复现样本,允许另做跨市场研究 |
|
|
10
|
+
| 输入 | §2.1,第3页:最近N周的周五收盘价格;使用成交量时输入为 `N × (2l+m)`,最终报告只使用行业基金输入,不含辅助经济数据 |
|
|
11
|
+
| 标签 | §2.1,第3页:下一周周一开盘到周五收盘上涨100bp作为正类定义;恰好等于阈值的边界未明确 |
|
|
12
|
+
| 归一化 | §2.1,第3页:非目标输入零均值、单位方差;拟合窗口及更新方式未说明 |
|
|
13
|
+
| 网络 | §2.2,第3页:四层全连接内部层,每层ReLU及dropout;全连接输出、线性激活;TensorFlow/Keras |
|
|
14
|
+
| 训练 | §2.2,第3—4页:各交易年以前两年数据训练,年内逐周增量更新;使用纳入近期盈亏的自定义损失函数 |
|
|
15
|
+
| 买卖 | §2.3,第4—5页:周五收盘后分析,下一周周一开盘买入,本周临近周五收盘全部卖出 |
|
|
16
|
+
| 买入阈值 | §2.3,第5页:逐ETF独立阈值,以近期数据的ROC成本优化并每周更新;不是预测收益率阈值 |
|
|
17
|
+
| 置信筛选 | §2.3,第5页:输出层MC dropout反复预测,以中位数一个标准差内约80%的概率质量衡量集中度;不是上涨概率达到80% |
|
|
18
|
+
| 原始配权 | §2.3,第5—6页:`w_s = 1 + wins_s/buys_s + streak_s/(wins_s+1)`;wins为盈利平仓次数,buys为买入周数,streak为连续盈利买入次数,交易周不必连续 |
|
|
19
|
+
|
|
20
|
+
表2(第5页)列出:近期单ETF周损失5%剔除;周间损失$300暂停一周;Q4组合水下5%暂停一周;Q1—Q4单ETF最大损失27.5%剔除;Q4单ETF胜率低于45%剔除。这些是历史统计过滤,**不能解释为盘中保证按这些阈值止损**。
|
|
21
|
+
|
|
22
|
+
## 严格复现仍缺什么
|
|
23
|
+
|
|
24
|
+
- N、各层宽度、dropout比例、优化器、学习率、batch、epochs、初始化种子和增量更新次数。
|
|
25
|
+
- 自定义盈亏损失函数的公式、盈亏与监督标签的结合方式。
|
|
26
|
+
- ROC成本函数、估计窗口、单一标签类别时的处理、阈值与模型更新的确切先后。§2.2与§2.3的文字不足以确定同周信号是否使用更新后模型。
|
|
27
|
+
- MC抽样次数、具体dropout位置、点预测与抽样预测的组合方式,以及80%判断的精确边界。
|
|
28
|
+
- 表2的损失统计口径、起始资金、冷启动胜率/配权、剔除后的恢复条件;$300为金额阈值,不能静默换成某个百分比或其他币种数额。
|
|
29
|
+
- 周一/周五休市、无成交、复权价格、分红、尾盘成交价的处理与冻结数据。论文结果不含交易成本(第7页),不能声称已证明净收益。
|
|
30
|
+
|
|
31
|
+
本 skill 实现下述统计计算及独立配权分项对照,不以猜测填补神经网络缺项。计算与回测工具参数见 [计算与回测接口](computation.md)。完整模型需作者源码或补充材料。跨市场时区、汇率、费用和结算是额外工程扩展,MUST 与论文复现结果分开报告。
|
|
32
|
+
|
|
33
|
+
## 计算脚本
|
|
34
|
+
|
|
35
|
+
### 预测分布集中度
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
python3 {baseDir}/scripts/rotation_metrics.py confidence predictions.json
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
输入为同一ETF、同一决策时间、同一模型的MC-dropout输出数值数组,2..100000个。不能混合不同标的、模型或日期。输出样本数、中位数、总体标准差(ddof=0)、区间内经验占比及判断。数值输出可正可负,线性输出不要求在0..1。
|
|
42
|
+
|
|
43
|
+
脚本采用包含区间边界、占比 `>=0.8` 的明确计算约定,原文未精确规定等号边界,因此标记为部分计算而非严格完整复现。总体标准差为0时占比仍可计算,但判断为null:重复输出无法证实MC dropout确实开启。此保护不冒充作者的原始实现。
|
|
44
|
+
|
|
45
|
+
集中度高的预测可以全部为负;它不验证方向正确、模型校准或盈利能力。输入来源、模型与决策时间由调用方随报告记录,脚本无法从裸数组验证这些事实。
|
|
46
|
+
|
|
47
|
+
### 历史原始配权
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
python3 {baseDir}/scripts/rotation_metrics.py allocation counts.json
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
输入为1..100条记录,例如:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
[{"symbol":"510300","buys":4,"wins":3,"streak":2},
|
|
57
|
+
{"symbol":"1306.T","buys":2,"wins":0,"streak":0}]
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
对应原始分数为2.25和1.0。symbol只是唯一标识,无市场限制;同一标的的不同代码别名必须先统一。计数为非负整数且 `streak <= wins <= buys`,只包含决策前已完成的交易;持平不算盈利。各计数的年度重置口径仍需作者材料确认。
|
|
61
|
+
|
|
62
|
+
`buys=0` 时 `raw_weight=null`,原因是原文未定义除零及冷启动处理。脚本不补默认分数,不把分数归一化为组合预算,也不根据这些分数筛选ETF。输入文件最大8 MiB,未知字段、重复JSON键、重复标识及非法数值均拒绝。
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Compatibility CLI for the shared rotation calculations in tools/."""
|
|
3
|
+
|
|
4
|
+
import sys
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
|
|
7
|
+
sys.path.insert(0, str(Path(__file__).resolve().parents[3] / "tools"))
|
|
8
|
+
from sector_rotation import main
|
|
9
|
+
|
|
10
|
+
if __name__ == "__main__":
|
|
11
|
+
sys.exit(main())
|
|
@@ -5,6 +5,8 @@ description: 综合股票分析:联合技术、基本面、资金、消息和
|
|
|
5
5
|
|
|
6
6
|
# 综合股票分析
|
|
7
7
|
|
|
8
|
+
批量研究、子任务分工、网页原文补证或报告文件交付时,必须读取[宿主研究与报告交付](references/host-workflows.md)。最终回复用 renderer 的 `final=true`;仍需保存附件、发送或继续分析时保持默认 false。
|
|
9
|
+
|
|
8
10
|
在启用原生工具发现的 Pi 中,所需工具尚未暴露时,先用 `tool_search` 搜索确切工具名或英文关键词,再按本文流程调用;其搜索器目前不对中文分词。旧 Pi 或其他宿主按当前实际提供的工具直接执行。
|
|
9
11
|
|
|
10
12
|
在 dsh 提供 `stock_tool_search` 且所需工具尚未暴露时,先搜索中文功能关键词或确切工具名,加载后按原名调用;搜索不执行分析。没有发现入口时直接使用当前提供的工具。
|
|
@@ -82,8 +84,9 @@ python3 scripts/gather.py <symbol>
|
|
|
82
84
|
1. 按 [报告 schema](../../schemas/report_schema.json) 构建结构化报告。
|
|
83
85
|
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
86
|
同时填写 `data_quality.flags/limitations`:关键数据缺失用 `partial_data`,明确过期行情用 `stale_quote`,同期间同口径来源冲突用 `conflicting_data`,回测/信号样本不足用 `insufficient_sample`。出现这些限制时降低置信度,不能给出 strong_buy;没有有效现价时不编造数值交易计划。数据完整时 flags 为空数组,限制仍按实际模拟条件说明。
|
|
85
|
-
3.
|
|
86
|
-
4.
|
|
87
|
+
3. 渲染前核对证据清单:行情已返回的 `price` 和 `data_as_of` 必须分别作为 `get_quote.price`、`get_quote.data_as_of` 的独立 evidence 项,保留原始 value;其他证据项的 `as_of` 元数据不能代替时间字段自身的 path/value 引用。报价过期时仍保留原始价格与时间作为历史证据,说明时效限制,等待新报价后再制定当前数值交易计划。
|
|
88
|
+
4. 调用 `render_stock_report`:快速问答用 `brief`,完整研判用 `full`。
|
|
89
|
+
5. 输出渲染后的 Markdown;只在用户要求机器可读数据时附加结构化 JSON。
|
|
87
90
|
|
|
88
91
|
## 信号跟踪闭环
|
|
89
92
|
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# 宿主研究与报告交付
|
|
2
|
+
|
|
3
|
+
在批量筛选、多角色研究、网页证据补充或报告文件交付时使用本文。先读取当前宿主实际提供的工具说明;没有相应能力时按原有股票工具流程完成任务。
|
|
4
|
+
|
|
5
|
+
## 批量研究与 PTC / codemode
|
|
6
|
+
|
|
7
|
+
1. 独立股票或维度可并行取数;沿用已有 gather / 批量工具,不对同一数据重复请求。
|
|
8
|
+
2. dsh 的可选研究配置启用 PTC `persistent-in-memory`。按当前宿主生成的 SDK 调用股票工具;本插件输出为 JSON 文本,需要解析后再计算。Pi codemode 同样先查看工具声明,按实际返回类型解析。
|
|
9
|
+
3. 在会话内保留本次采集结果、派生数组及函数,进行筛选、同行比较与参数敏感性分析;每项结果携带标的、币种、复权口径、覆盖期间、来源和实际数据日期。先排除 error、缺失与口径不一致的数据,再计算;未知值不补零。
|
|
10
|
+
4. 新的实时行情问题重新取数;复用的数据必须标为其原始时点的快照。内存不等于最新行情,也不作为持仓或账户存储。
|
|
11
|
+
5. dsh persistent 模式使用最终表达式或 console.log 返回结果,没有顶层 return;复用已有变量时赋值或换新变量名,避免重复 let/const 声明。超时、取消、重启或恢复会话后重新建立状态。
|
|
12
|
+
6. Pi codemode 使用它自己的脚本规则,不套用 dsh REPL 语法。工具声明中已有的 integer、上下限、枚举与默认值都必须遵守;模型缓存是否保留由宿主和所选 provider 决定。
|
|
13
|
+
|
|
14
|
+
## 分工研究
|
|
15
|
+
|
|
16
|
+
仅在问题确实涉及多个独立维度且当前宿主提供委派工具时分工。简单报价或单工具查询直接回答。
|
|
17
|
+
|
|
18
|
+
dsh 可选研究配置提供 `stock_research_subagent` 和三个 `agent_preset`:
|
|
19
|
+
|
|
20
|
+
| 预设 | 任务 | 交回父任务的内容 |
|
|
21
|
+
| --- | --- | --- |
|
|
22
|
+
| stock-fundamentals | 基本面、财务质量与估值 | 字段、报告期、币种、口径、来源与缺失 |
|
|
23
|
+
| stock-technical | 技术结构、策略回测与验证 | 数据覆盖、复权、参数、费用、结果与限制 |
|
|
24
|
+
| stock-events | 公告、事件与原文核对 | 原文 URL、事件/披露时间、事实与未验证点 |
|
|
25
|
+
|
|
26
|
+
向每个子任务明确传递股票、市场、研究时点、问题、已有证据与需要返回的字段;spawn 不自动继承父任务全部背景。子任务仅返回研究证据,父任务核对冲突、重复与市场适用性后形成结论,不能把三个子任务的意见投票变成买卖信号。
|
|
27
|
+
|
|
28
|
+
如宿主可实时查看、steer 或 stop 子任务,发现跑题时及时纠正并使用其已验证的部分结果。dsh 角色使用宿主原生工具可见性限制;这不是不可信插件的安全沙箱。
|
|
29
|
+
|
|
30
|
+
## 网页证据
|
|
31
|
+
|
|
32
|
+
dsh 开启 DeepSeek Search/Fetch 后,通过当前提供的网页搜索工具检索,再读取原文。记录 URL、发布/事件日期和适用市场;搜索摘要只作线索。行情、财务与回测数值仍以结构化股票工具的实际返回为准。
|
|
33
|
+
|
|
34
|
+
Search/Fetch 未配置、失败或权限不足时,使用现有可用检索工具;不能将失败写成“没有相关新闻”。缺少原文或时间时在结论中标明证据缺口。
|
|
35
|
+
|
|
36
|
+
## 最终报告与文件交付
|
|
37
|
+
|
|
38
|
+
1. 完成证据核对、用户要求的归档/信号记录及其他操作后,再渲染最终报告。
|
|
39
|
+
2. 两个报告工具的 `final` 默认 false。只有本轮只剩将报告回复给用户时才传 `final=true`;支持原样交付的 OpenClaw 可立即结束本轮。错误结果继续交给模型处理;旧宿主仍返回原 JSON,按 content 展示 Markdown。
|
|
40
|
+
3. 用户需要文件、邮件或 Drive 等交付时,保持 `final=false`,从成功结果取 `format=markdown` 的 `content`,用宿主现有文件工具保存为工作区中的 `.md` 文件。文件名使用明确标的/市场与报告日期,已有文件先确认可覆盖或使用新名称。不能把 Markdown 改后缀冒充 PDF。
|
|
41
|
+
4. Hermes 连接器的文件输入使用实际本地绝对路径;读取当前连接器 schema,单文件传路径,多文件按其数组格式传入,不编造上传描述对象。返回文件使用宿主给出的 path,失败文件保留其错误。
|
|
42
|
+
5. 按用户已经授权的目标及内容发送。只有连接器返回成功才报告已交付;尚无目标或权限时保留本地文件并说明待完成项。连接器不支持当前执行后端的路径时,提供本地报告,不虚构链接。
|
|
43
|
+
6. 用户指定只保存或尚需审核时,完成本地文件即可。完整分析内容与来源留在报告中,交付后的回复只给实际文件或成功回执。
|
|
44
|
+
|
|
45
|
+
宿主配置见各接入指南:dsh 研究与搜索 overlay 为可选配置;Hermes 可在研究 profile 用 `skills.auto_load: [stock-analysis:stock-analysis]` 常驻综合方法,其他策略 skill 按任务加载。
|
|
@@ -5,6 +5,8 @@ description: 策略回测:定义或读取 AlphaEvo YAML 策略,回测收益
|
|
|
5
5
|
|
|
6
6
|
# 策略回测与优化
|
|
7
7
|
|
|
8
|
+
批量研究、子任务分工或报告文件交付时,必须读取[宿主研究与报告交付](../stock-analysis/references/host-workflows.md),使用当前宿主实际提供的能力。
|
|
9
|
+
|
|
8
10
|
生成股票池月度右侧趋势计划时,先读 [月度右侧趋势策略](../bull-trend/references/monthly-trend-strategy.md),直接以股票代码调用 `analyze_trend_strategy(symbols, ...)` 自动取行情,无需用户准备文件。这是整池信号/预算分析;共享资金历史绩效仍依据冻结研究,MUST NOT 用单股YAML或信号计划冒充组合回测。报告尚未通过跨样本效果验证的边界。
|
|
9
11
|
|
|
10
12
|
开始前读取[短线交易决策框架](../stock-analysis/references/short-term-trading.md)的风险单位和回测约束。回测用于反证策略,不把样本内收益包装成预测。
|
package/tools/capabilities.py
CHANGED
|
@@ -18,6 +18,8 @@ ALL_MARKETS = ["A", "HK", "US", "JP", "KR", "TW"]
|
|
|
18
18
|
|
|
19
19
|
# tool_name -> {markets: [supported markets], reason: str for unsupported}
|
|
20
20
|
TOOL_MATRIX = {
|
|
21
|
+
"calculate_rotation_metrics": {"markets": ALL_MARKETS, "reason": None},
|
|
22
|
+
"backtest_rotation_allocation": {"markets": ALL_MARKETS, "reason": None},
|
|
21
23
|
"analyze_trend_strategy": {
|
|
22
24
|
"markets": ["A", "HK", "US"],
|
|
23
25
|
"reason": "Monthly trend strategy supports A/HK/US pools only",
|
package/tools/cli_budgets.json
CHANGED
package/tools/report_renderer.py
CHANGED
|
@@ -95,11 +95,13 @@ def main():
|
|
|
95
95
|
p.add_argument("--template", default="full", choices=["brief", "full"])
|
|
96
96
|
p.add_argument("--input", "-i", default="-", help="JSON file path or '-' for stdin")
|
|
97
97
|
p.add_argument("--input-b64", help="Base64-encoded JSON (avoids shell escaping)")
|
|
98
|
+
p.add_argument("--final", action="store_true", help="Mark a completed report for final reply delivery by the host")
|
|
98
99
|
|
|
99
100
|
p2 = sub.add_parser("market", help="Render a market review report")
|
|
100
101
|
p2.add_argument("--input", "-i", default="-", help="JSON file path or '-' for stdin")
|
|
101
102
|
p2.add_argument("--input-b64", help="Base64-encoded JSON (avoids shell escaping)")
|
|
102
103
|
p2.add_argument("--save", action="store_true", help="Append the report object to the review JSONL archive")
|
|
104
|
+
p2.add_argument("--final", action="store_true", help="Mark a completed report for final reply delivery by the host")
|
|
103
105
|
|
|
104
106
|
args = parser.parse_args()
|
|
105
107
|
if not args.command:
|
|
@@ -110,6 +112,8 @@ def main():
|
|
|
110
112
|
result = render(args.command, getattr(args, "template", "full"), report)
|
|
111
113
|
if args.command == "market" and args.save and "error" not in result:
|
|
112
114
|
result["archived"] = save_review(report)
|
|
115
|
+
if args.final and "error" not in result and "error" not in result.get("archived", {}):
|
|
116
|
+
result["final"] = True
|
|
113
117
|
json.dump(result, sys.stdout, ensure_ascii=False, indent=2, default=str)
|
|
114
118
|
print()
|
|
115
119
|
if "error" in result:
|