stock-analysis-plugin 0.2.8 → 0.2.10
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 +34 -26
- package/package.json +15 -8
- package/pi/index.ts +446 -13
- package/scripts/profile-offline.py +127 -0
- package/scripts/profile-workflows.py +87 -0
- package/scripts/setup-python.mjs +11 -4
- package/scripts/venv-python.mjs +7 -0
- package/skills/event-driven/SKILL.md +2 -0
- package/skills/growth-quality/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 +15 -4
- package/skills/stock-analysis/references/host-workflows.md +45 -0
- package/skills/stock-analysis/references/stateless-analysis.md +16 -2
- package/skills/stock-screener/SKILL.md +6 -0
- package/skills/strategy-backtest/SKILL.md +10 -3
- package/tools/_cache.py +93 -21
- package/tools/_subproc.py +43 -8
- package/tools/anomaly_detect.py +11 -6
- package/tools/backtest.py +225 -70
- package/tools/capabilities.py +3 -0
- package/tools/cli_budgets.json +2 -1
- package/tools/gather.py +63 -8
- package/tools/market_regime.py +26 -15
- package/tools/market_review.py +2 -2
- package/tools/position_context.py +5 -2
- package/tools/report_renderer.py +4 -0
- package/tools/requirements.txt +2 -2
- package/tools/risk_screening.py +40 -15
- package/tools/screener.py +44 -18
- package/tools/search_intel.py +94 -32
- package/tools/sec_holders.py +27 -25
- package/tools/sector_rotation.py +466 -0
- package/tools/signal_tracker.py +100 -49
- package/tools/stateless_analysis.py +600 -33
- package/tools/stock_data.py +111 -26
- package/tools/technical.py +42 -40
- package/tools/trading_calendar.py +26 -21
- package/tools/value_data.py +6 -2
- package/tools/watchlist.py +24 -15
- package/tools/watchlist_context.py +63 -49
package/README.md
CHANGED
|
@@ -32,8 +32,8 @@ A 股 / 港股 / 美股 / 日股 / 韩股 / 台股综合分析、多因子选股
|
|
|
32
32
|
|
|
33
33
|
## 功能概览
|
|
34
34
|
|
|
35
|
-
- **
|
|
36
|
-
- **
|
|
35
|
+
- **71 个工具** — 行情数据、技术分析、K 线形态、资金流向、估值历史、财报日历、股东/ETF/股息、新闻舆情、风险筛查、市场状态等
|
|
36
|
+
- **21 个 Skills** — 综合分析、全市场选股、策略回测 + 18 个策略、复盘与研究方法论(缠论、波浪、龙头、情绪周期等)
|
|
37
37
|
- **策略回测引擎** — YAML DSL 定义策略,参数化条件组合,自动诊断,按需进行有限轮参数优化
|
|
38
38
|
- **多数据源 Failover** — 11 个数据源自动容灾切换(akshare / tushare / efinance / 腾讯行情 / 新浪行情 / pytdx / baostock / yfinance / finnhub / longbridge / alphavantage),A 股链路带粘性优选(最近成功的数据源下次优先尝试)
|
|
39
39
|
- **社交舆情增强** — A 股(东财股吧 + 雪球)/ 美港股(Reddit / X / Polymarket),市场自动路由
|
|
@@ -70,7 +70,7 @@ npm install @weaxs/stock-analysis-plugin
|
|
|
70
70
|
|
|
71
71
|
Pi 启动后自动加载,输入 `/skills` 确认。详见 [Pi Agent 接入指南](docs/pi-integration.md)([English](docs/pi-integration.en.md))。
|
|
72
72
|
|
|
73
|
-
新版 Pi(已核验 1.
|
|
73
|
+
新版 Pi(已核验 1.4.0)提供原生 `tool_search` 时,插件自动启用按需工具发现,71 项能力保留注册,仅命中工具加载完整定义。缺少原生发现接口的旧版 Pi 或 SDK 宿主保持全量暴露。检索使用英文关键词或工具名,例如 `get_quote`、`get_financials`。
|
|
74
74
|
|
|
75
75
|
### Hermes Agent Plugin
|
|
76
76
|
|
|
@@ -95,7 +95,7 @@ register(ctx)
|
|
|
95
95
|
openclaw plugins install clawhub:@weaxs/openclaw-stock-analysis
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
OpenClaw Gateway 启动后自动加载并注册
|
|
98
|
+
OpenClaw Gateway 启动后自动加载并注册 71 个 tool。安装时 postinstall 会自动建 `.venv` 并装好 Python 依赖(前提:本机有 `python3 >= 3.10`)。
|
|
99
99
|
|
|
100
100
|
详见 [OpenClaw 接入指南](docs/openclaw-integration.md),或 plugin 自身说明 [`openclaw/README.md`](openclaw/README.md)。
|
|
101
101
|
|
|
@@ -106,7 +106,7 @@ dsh plugin --profile <你的profile> add @weaxs/dsh-stock-analysis
|
|
|
106
106
|
dsh --profile <你的profile>
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册
|
|
109
|
+
作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册 71 个 tool + 21 个 skill。postinstall 自动建 `.venv`(pnpm 需在 profile 的 `pnpm-workspace.yaml` 里给本包配 `allowBuilds`,否则回退系统 `python3`)。
|
|
110
110
|
|
|
111
111
|
新版 dsh 的原生函数调用模式默认通过 `stock_tool_search` 按 Agent 搜索、加载所需工具,支持中文关键词或工具名;旧接口、搜索入口不可用时保留全量暴露。可设置 `toolDiscovery: false` 关闭,配置与 PTC 模式边界见下方接入文档。
|
|
112
112
|
|
|
@@ -214,7 +214,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
214
214
|
| 全市场选股 | `/skill:stock-screener` | L1 多因子硬筛(市场情绪调节,可选 `--l2` 量化增强)→ L2 LLM 智能排序 → 输出推荐列表 |
|
|
215
215
|
| 策略回测 | `/skill:strategy-backtest` | YAML 策略定义 → 回测 → 诊断;按需进行最多 3 轮参数优化 |
|
|
216
216
|
|
|
217
|
-
### 策略、复盘与研究(
|
|
217
|
+
### 策略、复盘与研究(18 个)
|
|
218
218
|
|
|
219
219
|
| Skill | 调用方式 | 方法论 |
|
|
220
220
|
|-------|----------|--------|
|
|
@@ -232,6 +232,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
232
232
|
| 事件驱动 | `/skill:event-driven` | 公告/政策/业绩事件的影响路径与失效条件 |
|
|
233
233
|
| 预期重估 | `/skill:expectation-repricing` | 市场预期与实际数据的偏差 |
|
|
234
234
|
| 成长质量 | `/skill:growth-quality` | 收入、利润、现金流与盈利能力的多期验证 |
|
|
235
|
+
| 行业 ETF 轮动研究 | `/skill:sector-rotation` | 确定性集中度/配权计算、跨市场分组的配权分项回测;完整深度模型尚未实现 |
|
|
235
236
|
| 热点题材 | `/skill:hot-theme` | 板块强度、扩散度、关联度与节奏 |
|
|
236
237
|
| 市场复盘 | `/skill:market-review` | 指数、宽度、板块、温度与次日策略 |
|
|
237
238
|
| Wisburg 投研 | `/skill:wisburg-research` | 检索机构研报、公告、电话会纪要和市场日报 |
|
|
@@ -252,7 +253,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
252
253
|
| `get_etf_details` | A 股 ETF 净值折溢价、规模变动、披露持仓、可选基准成分与跟踪误差 |
|
|
253
254
|
| `get_dividends` | A/HK 历史分红/除息日历/已实现 TTM 股息与连续年数;A/HK 报告期/年度排行 |
|
|
254
255
|
| `get_kline` | K 线数据(OHLCV),支持日/周/月线;A 股股票/ETF 前复权,每条记录 `adjusted=qfq`,指数 `adjusted=none` |
|
|
255
|
-
| `get_quote` | 实时行情快照(非交易时段返回最近交易日收盘价并以 as_of/stale
|
|
256
|
+
| `get_quote` | 实时行情快照(非交易时段返回最近交易日收盘价并以 as_of/stale 标注;`pe_basis` 区分 dynamic/trailing/unknown;ETF 的 premium_discount_rate 为正=溢价、负=折价) |
|
|
256
257
|
| `get_capital_flow` | 资金流向(仅 A 股) |
|
|
257
258
|
| `get_news` | 个股相关新闻 |
|
|
258
259
|
| `get_financials` | 财务指标 |
|
|
@@ -274,6 +275,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
274
275
|
|
|
275
276
|
| 工具 | 说明 |
|
|
276
277
|
|------|------|
|
|
278
|
+
| `calculate_rotation_metrics` | 真实MC-dropout分布集中度与历史原始配权计算;不生成预测或买入信号 |
|
|
279
|
+
| `backtest_rotation_allocation` | 股票/ETF代码自动取数,按市场与报价币种独立比较等权和历史配权;分项回测,非完整论文模型 |
|
|
277
280
|
| `analyze_trend_strategy` | 月度右侧趋势策略:单市场股票池筛选、真实旧仓保持/退出与逆波动新仓预算;直接传股票代码、自动取行情,无持仓存储,仍为not_validated |
|
|
278
281
|
| `get_technical_analysis` | 全面技术指标分析(MA/MACD/RSI/BOLL/KDJ;附实验性 trend_horizons 多期限月度趋势及独立趋势温度 trend_temperature;多周期共振时 resonance.direction ∈ aligned_bullish/aligned_bearish/divergent) |
|
|
279
282
|
| `analyze_pattern` | K 线形态识别 |
|
|
@@ -297,7 +300,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
297
300
|
| `screen_stocks` | 全市场多因子筛选(可选 L2;factor_coverage 展示缺失因子、覆盖度、实际权重及 L2 effective_scores) |
|
|
298
301
|
| `screen_risk` | 风险因子筛查 |
|
|
299
302
|
| `run_backtest` | YAML 策略回测,默认收盘信号于次日开盘成交,execution 返回模型与限制 |
|
|
300
|
-
| `detect_market_regime` |
|
|
303
|
+
| `detect_market_regime` | 市场状态检测(牛/熊/震荡;返回实际 as_of 和坏行警告,历史不足 60 根时 above_ma60=null) |
|
|
301
304
|
| `get_market_review` | 市场日度复盘数据 |
|
|
302
305
|
| `get_review_history` | 复盘归档历史(最近 N 条,最新在前,用于纵向对比) |
|
|
303
306
|
| `run_watchlist_analysis` | 批量自选股分析 |
|
|
@@ -339,6 +342,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
339
342
|
|
|
340
343
|
批量自选股分析和摘要的 `success` 表示至少获取了有效行情价格、K 线收盘价或技术评分;全部关键数据失败时计入 `failed`,部分结果仍保留。采集脚本复用返回的 K 线计算技术指标,并按股票所属市场查询大盘状态;日/韩/台市场状态暂不可用,非 A 股板块榜单也暂不可用,均会明确返回错误。
|
|
341
344
|
|
|
345
|
+
同一次自选股分析会共享报价、日 K 线和按市场获取的大盘状态(包含可选市场复盘);风险与异动分析复用本次快照,资金流汇总和明细仍分开采集。采集任务使用共享的 6 线程 CLI 池,每支股票完成后即可接续异动分析,最终顺序保持调用方顺序。报价不跨调用保存。独立仓位/风控/筛选采集步骤并行执行。 两融历史明细按交易所/日期复用完整表,当日表和空表不缓存;CN 交易日历完整快照缓存一天。搜索按原优先级降级,单次查询的切换预算为 45 秒,综合搜索共用 90 秒预算;各请求使用剩余预算内的超时,严格总时限仍由宿主控制。同次综合搜索会跳过已确认不可用的引擎,下次独立调用重试。
|
|
346
|
+
|
|
342
347
|
信号记录支持同一存储文件的多进程读写;评估期间新增的信号会保留。价格必须为正的有限数值,持有期限为正整数,日期格式为 YYYY-MM-DD。存储文件含损坏 JSON 行或无效信号时,记录、评估和汇总返回错误,原文件保持原样。
|
|
343
348
|
|
|
344
349
|
信号评估仅在历史 K 线覆盖记录日时结算,缺少历史窗口则返回 `skipped_no_data` 并保持未结算。风险筛查返回 `data_complete` 和 `warnings`;数据不足时评级可为 `unknown`,`risk_score`、`veto_buy` 可为 null。告警的 `evaluated` 条目含 `error` 时表示无法检查,不能将未触发理解为已通过检查。
|
|
@@ -351,7 +356,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
351
356
|
|------|------|
|
|
352
357
|
| `compare_stocks` | 比较显式输入的同行指标;检查单位、期间和口径,仅对可比数值排序 |
|
|
353
358
|
| `analyze_disclosure_changes` | 比较新旧公告正文与财务指标,返回来源、变更行号和增长率限制 |
|
|
354
|
-
| `analyze_portfolio_risk` |
|
|
359
|
+
| `analyze_portfolio_risk` | 一次性持仓的集中度、行业/币种敞口、价格盈亏、止损情景、可选相关性与市场/行业/个股/汇率压力测试 |
|
|
360
|
+
| `plan_portfolio_rebalance` | 按目标权重、整手、费用和现金约束生成先卖后买的调仓计划,返回未满足数量与调后敞口 |
|
|
355
361
|
| `calculate_position_size` | 按现金、风险预算、费用、滑点和交易单位计算本次可买数量 |
|
|
356
362
|
| `analyze_event_study` | 事件前一交易日收盘至各窗口的股票/基准收益差,标明缺失和重叠样本 |
|
|
357
363
|
| `validate_backtest` | 复用现有引擎,滚动训练选候选、样本外验证,比较参数及多个标的 |
|
|
@@ -378,9 +384,9 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
|
|
|
378
384
|
python tools/stateless_analysis.py position_size --input input.json
|
|
379
385
|
```
|
|
380
386
|
|
|
381
|
-
对应宿主工具是 `calculate_position_size`。其余 CLI 子命令依次为 `peers/disclosure/portfolio/event_study/robustness/snapshot`。事件研究可直接传 `symbol/benchmark/start_date/end_date/event_dates`;回测验证可传 `symbols/start_date/end_date/strategies`,由 Python 复用行情接口,避免模型重新抄写历史 K 线。显式价格/datasets 模式仍支持离线计算,两种模式互斥。
|
|
387
|
+
对应宿主工具是 `calculate_position_size`。其余 CLI 子命令依次为 `peers/disclosure/portfolio/rebalance/event_study/robustness/snapshot`。事件研究可直接传 `symbol/benchmark/start_date/end_date/event_dates`;回测验证可传 `symbols/start_date/end_date/strategies`,由 Python 复用行情接口,避免模型重新抄写历史 K 线。显式价格/datasets 模式仍支持离线计算,两种模式互斥。
|
|
382
388
|
|
|
383
|
-
|
|
389
|
+
跨币种组合必须提供显式汇率;价格盈亏不含历史汇兑损益。组合压力测试是用户指定市场/行业/个股/汇率冲击的确定性 what-if,个股冲击覆盖行业、行业覆盖市场,汇率独立乘算,不是预测或最大亏损保证。调仓工具按目标权重和整手生成计划,先卖后买;现金不足时同比例缩减买单并以 `cash_limited/unfilled` 标记,计划数量不代表成交。稳健性工具仅支持 next_open、每窗口重新从现金开始,样本内敏感性不等于样本外表现。
|
|
384
390
|
|
|
385
391
|
## 策略回测 DSL
|
|
386
392
|
|
|
@@ -428,19 +434,19 @@ position:
|
|
|
428
434
|
|
|
429
435
|
其他可用键:
|
|
430
436
|
|
|
431
|
-
- `exit.trailing_stop`:移动止损,价格自持仓期间最高收盘价回撤达到该比例即卖出(如 `0.08` = 峰值回撤 8% 触发);与 `stop_loss`
|
|
432
|
-
- `benchmark`(顶层):基准对比标的代码(如 `"sh000300"` 沪深300;指数代码必须带 sh/sz 交易所前缀,裸 6 位数字会被当作个股),设置后回测结果附带 `benchmark` 块(基准买入持有收益与 `excess_return`
|
|
433
|
-
- `simulation.execution`:默认 `next_open`,前日收盘信号、次日开盘加滑点成交;显式 `same_close` 复现旧收盘成交假设。交易同时返回 signal_date/date
|
|
437
|
+
- `exit.trailing_stop`:移动止损,价格自持仓期间最高收盘价回撤达到该比例即卖出(如 `0.08` = 峰值回撤 8% 触发);与 `stop_loss` 同时设置时先判固定止损。`stop_loss` 必须为负数、`take_profit` 必须为正数、`trailing_stop` 须在 (0, 1) 内;`position.max_positions` 当前仅支持 1,其他配置明确报错。
|
|
438
|
+
- `benchmark`(顶层):基准对比标的代码(如 `"sh000300"` 沪深300;指数代码必须带 sh/sz 交易所前缀,裸 6 位数字会被当作个股),设置后回测结果附带 `benchmark` 块(基准买入持有收益与 `excess_return` 超额收益)。基准与策略采用同一首日执行口径(next_open 用 open、same_close 用 close),无预热时以策略首条权益日期为起点;实际覆盖不符或首末价格非法时返回 error,不输出超额。
|
|
439
|
+
- `simulation.execution`:默认 `next_open`,前日收盘信号、次日开盘加滑点成交;显式 `same_close` 复现旧收盘成交假设。交易同时返回 signal_date/date。延迟的入场信号在新收盘失效时撤单,风险退出 pending 保留至成交。`start` 前可得历史仅用于指标预热,取数长度随策略最大 lookback 增加,交易与权益仍按请求区间统计;`warnings` 出现 `Entry indicator is unavailable` 时必须披露指标不可用及数据质量,不能声称完成预热。零成交量阻止成交;一字板限制只在输入提供同口径历史 limit_up/limit_down 时执行。`execution` 列出阻止成交次数、未成交订单及限制;止损是收盘信号,未模拟盘口排队、部分成交、结算和市场冲击。回测仅接受单一 `qfq`/`total_return`/`none` 复权口径,unknown 或混合口径明确报错。
|
|
434
440
|
- `simulation`(顶层):交易成本。`slippage`(滑点,买卖双边,默认 0.001)、`commission`(佣金,买卖双边,默认 0.0015)、`stamp_tax`(印花税,仅卖出收取,默认 0;A股为 0.0005,各市场税率不同且会调整,按当下实际费率填写)。费率均须在 [0, 1) 区间,越界报错。回测结果附带 `costs` 块(实际生效费率与实付费用合计 `commission_paid`/`stamp_tax_paid`)。
|
|
435
441
|
|
|
436
442
|
### 可用指标
|
|
437
443
|
|
|
438
444
|
| 指标 | 说明 | 需要 period |
|
|
439
445
|
|------|------|-------------|
|
|
440
|
-
| `rsi` | RSI
|
|
446
|
+
| `rsi` | RSI 相对强弱指数;预热不足不可用,全涨窗口为 100,全平为 50 | 是(默认 14) |
|
|
441
447
|
| `ma` / `ema` | 简单 / 指数移动平均 | 是(默认 20) |
|
|
442
448
|
| `macd_dif` / `macd_dea` / `macd` | MACD 三线 | 否 |
|
|
443
|
-
| `volume_ratio` |
|
|
449
|
+
| `volume_ratio` | 当根成交量 / 前 N 根平均成交量(不含当根) | 是(默认 5) |
|
|
444
450
|
| `price_change` | 涨跌幅(%) | 否 |
|
|
445
451
|
| `bollinger_position` | 布林带位置(0=下轨, 1=上轨) | 是(默认 20) |
|
|
446
452
|
| `trend_score` | 独立实验趋势强度,默认 (EMA20−EMA60)/ATR14;fast_period/slow_period 控制 EMA | period 为 ATR 根数(默认 14) |
|
|
@@ -494,7 +500,7 @@ python tools/value_data.py dividends --mode ranking --market HK --report-date 20
|
|
|
494
500
|
python tools/value_data.py earnings_calendar --symbol 0700.HK
|
|
495
501
|
```
|
|
496
502
|
|
|
497
|
-
财报、基本信息及估值/股东/ETF/分红等慢变数据缓存到 `~/.stock-analysis/cache
|
|
503
|
+
财报、基本信息及估值/股东/ETF/分红等慢变数据缓存到 `~/.stock-analysis/cache`(可通过 `STOCK_CACHE_DIR` 指定可写目录,适用于沙箱/只读用户目录),TTL 一天;板块成分/映射一周。行情报价不缓存。缓存写入失败时直接返回已获取数据;缓存文件原子替换,过期/损坏重拉,错误和显式部分失败不缓存;不以过期数据伪装最新数据。原有临时目录的粘性路由和反向成分缓存保留。 同键缓存缺失与 SEC ZIP 下载通过跨进程文件锁协调,等待最多 5 秒;普通缓存锁不可用或超时后仍可直接抓取,持久写入/ZIP 下载则返回错误,避免无界等待。有效缓存命中不要求目录可写。
|
|
498
504
|
|
|
499
505
|
估值使用可得数据的正值样本分位(`<=当前值`),返回 10/25/50/75/90 分位 Band 与实际起止日期;亏损 PE 分位为 null。当前 AKShare 已无 issue 中提到的 `stock_a_indicator_lg`,个股采用百度 PE-TTM/PB 历史,指数采用乐咕乐股;中证全指等通过中证官方历史接口取得多年滚动 PE,近期总股本 PE1 仍单独保留;PB 缺失时可配置 `LIXINGER_TOKEN` 补充理杏仁总市值加权(mcw)历史,返回每个指标的来源与口径,不拼接不同方法的同一指标。未配置或无权限时 PB 保持未知。A 股 `annual=true, periods=10` 请求十年年报;HK 按源实际可得年数返回,不补造缺失比率。
|
|
500
506
|
|
|
@@ -563,20 +569,20 @@ GitHub Actions 的 `e2e-host` 使用 Pi、Hermes、OpenClaw、dsh 的真实运
|
|
|
563
569
|
```
|
|
564
570
|
stock-analysis/
|
|
565
571
|
├── pi/ # Pi Agent Extension
|
|
566
|
-
│ └── index.ts # 注册
|
|
572
|
+
│ └── index.ts # 注册 71 个工具 + 21 个 skill
|
|
567
573
|
├── hermes/ # Hermes Agent Plugin
|
|
568
574
|
│ ├── plugin.yaml # 插件清单
|
|
569
575
|
│ ├── __init__.py # register(ctx) 入口
|
|
570
576
|
│ ├── schemas.py # 工具 JSON Schema 定义
|
|
571
|
-
│ └── tools.py #
|
|
577
|
+
│ └── tools.py # 71 个 handler → subprocess 调 CLI
|
|
572
578
|
├── openclaw/ # OpenClaw Plugin
|
|
573
579
|
│ ├── openclaw.plugin.json # manifest(contracts.tools)
|
|
574
580
|
│ ├── package.json # 含 openclaw 块(pluginApi/SDK 版本)
|
|
575
|
-
│ └── index.ts # definePluginEntry + registerTool ×
|
|
581
|
+
│ └── index.ts # definePluginEntry + registerTool ×71
|
|
576
582
|
├── dsh/ # DeepSeek Harness (dsh) Plugin
|
|
577
583
|
│ ├── cordis.patch.yml # bundle patch(insert 插件入口)
|
|
578
584
|
│ ├── package.json # 含 dsh.bundle 块(bundle manifest)
|
|
579
|
-
│ └── index.ts # cordis apply(ctx) + defineTool ×
|
|
585
|
+
│ └── index.ts # cordis apply(ctx) + defineTool ×71
|
|
580
586
|
│
|
|
581
587
|
├── tools/ # 共享 Python CLI 工具
|
|
582
588
|
│ ├── stock_data.py # 行情 / 资金流 / 新闻 / 财务 / 短线情绪
|
|
@@ -595,11 +601,11 @@ stock-analysis/
|
|
|
595
601
|
│ ├── trading_calendar.py # 交易日历
|
|
596
602
|
│ └── requirements.txt
|
|
597
603
|
│
|
|
598
|
-
├── skills/ # 共享 SKILL.md(
|
|
604
|
+
├── skills/ # 共享 SKILL.md(21 个)
|
|
599
605
|
│ ├── stock-analysis/ # 综合分析 workflow
|
|
600
606
|
│ ├── stock-screener/ # 选股 workflow
|
|
601
607
|
│ ├── strategy-backtest/ # 回测 + 进化 workflow
|
|
602
|
-
│ └── ... #
|
|
608
|
+
│ └── ... # 18 个策略方法论
|
|
603
609
|
│
|
|
604
610
|
├── strategies/examples/ # 回测策略 YAML 示例
|
|
605
611
|
├── schemas/ # JSON Schema(研报结构等)
|
|
@@ -692,7 +698,7 @@ python3 tools/sec_edgar.py insider_trades AAPL --days 90 --top 10
|
|
|
692
698
|
|
|
693
699
|
公告类别为 `all/forecast/express/annual/interim/quarterly/reduction/issuance/inquiry/dividend`。默认最近 90 天,最多 500 条;通过巨潮官方股票目录取得 orgId,沪深京统一使用官方 `szse` 查询栏目。业绩快报和问询使用标题关键词查询。第一版返回 PDF 原文链接,不引入 PDF 解析依赖;`total/truncated` 表示供应商匹配数量及截断,查询无结果与请求失败分开。
|
|
694
700
|
|
|
695
|
-
港股使用既有 `LIXINGER_TOKEN`,需具备港股接口权限。新增来源覆盖理杏仁非金融公司财务和每日估值,最多十年;金融公司或无权限时回退现有 Yahoo/东财财务和百度估值,返回实际期数和不足提示。财务按 `annual_report` 识别年报,保留财年末、披露日和币种,金额为报告币种,历史比率为百分数;顶层 `roe/profit_margin` 延续 Yahoo 小数比例。理杏仁财报用于增强历史,同时按整组保留可用的 Yahoo 顶层快照,`currency` 是 Yahoo 的财报币种,`market_cap_currency` 是市值币种,`snapshot_source` 标明来源,缺失值不混入其他报告期或币种的历史数字;历史币种和报告日期在 `periods` 每行保留,Yahoo 未提供明确报告日期时顶层 `report_date=null`。快照失败时 `snapshot_available=false`,财报与历史仍返回。会计口径不强行转换为 A 股,估值分位沿用正值样本算法,不拼接不同来源。
|
|
701
|
+
港股使用既有 `LIXINGER_TOKEN`,需具备港股接口权限。新增来源覆盖理杏仁非金融公司财务和每日估值,最多十年;金融公司或无权限时回退现有 Yahoo/东财财务和百度估值,返回实际期数和不足提示。财务按 `annual_report` 识别年报,保留财年末、披露日和币种,金额为报告币种,历史比率为百分数;顶层 `roe/profit_margin` 延续 Yahoo 小数比例。理杏仁财报用于增强历史,同时按整组保留可用的 Yahoo 顶层快照,`currency` 是 Yahoo 的财报币种,`market_cap_currency` 是市值币种,`snapshot_source` 标明来源,缺失值不混入其他报告期或币种的历史数字;历史币种和报告日期在 `periods` 每行保留,Yahoo 未提供明确报告日期时顶层 `report_date=null`。快照失败时 `snapshot_available=false`,财报与历史仍返回。会计口径不强行转换为 A 股,估值分位沿用正值样本算法,不拼接不同来源。Yahoo 顶层快照的 `snapshot_units` 明确:`pe=trailing`,`roe/profit_margin/dividend_yield=ratio`(小数),`debt_to_equity=percent`(百分数);不得把 D/E 百分数当作小数倍数。
|
|
696
702
|
|
|
697
703
|
SEC 配置 `SEC_USER_AGENT`,包含应用名称与真实联系邮箱,仅通过环境变量提供。单进程最多每秒 2 次请求(多个并行进程需控制账户/IP 总量不超过 SEC 的每秒 10 次),并缓存 ticker/CIK、申报元数据和 XML 解析结果。13F 返回机构最近季度的原始申报,不是实时完整组合;通常在季度后 45 天内披露(节假日顺延),实际数据年龄以季度末为准,2023-01-03 起金额单位为美元,更早申报为千美元。修订文件另列原文链接,避免错误合并补充与重述;发行人 CIK 反查现已通过 `mode=issuer` 支持:从结构化 Schedule 13D/G 校验发行人 CIK、提取 CUSIP,再扫描官方最新已发布 13F 批量窗口。`auto` 默认有当前或已检索历史 13F 时查机构,否则查发行人;Berkshire 等兼具两种身份时显式选择 `issuer`。修订按 `RESTATEMENT` 替换与 `NEW HOLDINGS` 补充重建;无法判断的修订或缺少基础版时总量为 null,并给出 `unresolved_manager_count`。
|
|
698
704
|
|
|
@@ -726,8 +732,10 @@ python3 tools/sec_edgar.py holdings 0001067983 --mode manager
|
|
|
726
732
|
|
|
727
733
|
真实模型评测同时要求结构化证据检查与独立上下文的结论审稿通过:审稿检查正文事实、限制说明是否诚实,以及是否过度外推。未运行审稿、结果缺失或模糊都不能算通过;报告自行声明通过不被采信。另有人工核对的正确报告及两类反例用于验证审稿器(正确引用但正文捏造现价、3笔交易却保证长期胜率)。空回答也失败。离线渲染和规则检查不代表真实模型通过,也不证明策略未来有效。信号建议可沿用 source 标识策略版本,按来源复盘胜率、平均收益和样本量;未扣成本、未匹配基准的观察记录不能当作策略回测。
|
|
728
734
|
|
|
729
|
-
|
|
735
|
+
信号结算仅在价格口径可核实时进行:原始价格可直接比较;自动记录的默认 `record_date` 与 `price_date` 均按标的市场时区确定(显式 `date` 不变),并保存原始 `price_as_of`;`price_date` 晚于 `record_date` 时拒绝记录与结算;多头 target 必须高于 entry、stop 必须低于 entry,空头相反,否则拒绝记录。开盘先触 stop 按 open 结算,先触 target 按 target 保守结算,日内顺序未知的双触发仍 stop 优先;无止损的旧 HLC 记录可继续用 high/low/close 判定目标和到期,但若提供 open 也必须是正有限数值,有止损但缺 open 则拒绝结算。重复日期返回 skipped_no_data,复权乘除使用 Decimal。复权日线需该报价日的 adjustment_factor(复权价/原始价),当前日线 Tushare、Alpha Vantage 可提供。缺失系数或口径未知时返回 skipped_price_basis,保持未结算,不猜测除权比例;记录日无 K 线时仅在前后因子一致(或已有明确报价日)时使用最近锚点,旧信号缺少报价时点且记录日因子变化时也保持未结算。换算后的 exit_price 是记录时价格单位的等价值,实际市场价可不同,evaluation_price_basis 保留依据。evaluate_signals 的 CLI 预算为 300 秒,内部提前结束采集并保存已完成结果,complete/deferred/warnings 指示需要重试的记录;预算耗尽后调整未结算记录的处理顺序,下轮优先处理尚未尝试的记录,避免慢请求长期阻塞后续信号。
|
|
730
736
|
|
|
731
737
|
市场复盘数据不足时温度/姿态为 null,信号 unknown,data_quality.limitations 说明限制。自选股异动采集失败时 anomaly_status=unavailable、anomaly_count=null,保留警告并计入 summary.partial,不能当成无异常。
|
|
732
738
|
|
|
733
|
-
L1 与 L2 综合分均在排序前按可用因子重新归一化;缺失或非有限因子不作零分处理,因子组内部也仅平均有效输入。factor_coverage.ratio 保留原始权重覆盖率,effective_weights
|
|
739
|
+
L1 与 L2 综合分均在排序前按可用因子重新归一化;缺失或非有限因子不作零分处理,因子组内部也仅平均有效输入。factor_coverage.ratio 保留原始权重覆盖率,effective_weights 是实际归一化后的权重,高分仍需结合覆盖率判断。估值比较需同时读取 `pe_basis`;有限非正 PE/PB 的价值子分为 0,不能因数值更低而获得最高价值分。
|
|
740
|
+
|
|
741
|
+
L2 的 `vol20` 只使用恰好 20 个有效日收益,`factor_coverage.vol20_samples` 记录实际样本数,非正/非有限收盘价先剔除,空输入为 0;质量因子按 `report_date` 分组归一,避免年度累计与单季累计直接比较。资金流 5/10/20 日窗口不足返回 null,不按 0 或完整窗口处理。HK 快照统一带 `.HK`,US 快照移除东财交易所后缀并把类别股点号转为 Yahoo 连字符。主板 ST/*ST 按 5% 识别涨跌停,其他板块比例不变。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "stock-analysis-plugin",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.10",
|
|
4
4
|
"description": "Pi Agent extension for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./pi/index.ts",
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
"./skills/stock-analysis/SKILL.md",
|
|
13
13
|
"./skills/stock-screener/SKILL.md",
|
|
14
14
|
"./skills/strategy-backtest/SKILL.md",
|
|
15
|
+
"./skills/sector-rotation/SKILL.md",
|
|
15
16
|
"./skills/bull-trend/SKILL.md",
|
|
16
17
|
"./skills/shrink-pullback/SKILL.md",
|
|
17
18
|
"./skills/ma-crossover/SKILL.md",
|
|
@@ -37,6 +38,7 @@
|
|
|
37
38
|
"tools/cli_budgets.json",
|
|
38
39
|
"tools/requirements.txt",
|
|
39
40
|
"skills/",
|
|
41
|
+
"!skills/**/__pycache__/**",
|
|
40
42
|
"schemas/",
|
|
41
43
|
"templates/",
|
|
42
44
|
"strategies/",
|
|
@@ -46,7 +48,7 @@
|
|
|
46
48
|
"scripts": {
|
|
47
49
|
"postinstall": "node scripts/setup-python.mjs",
|
|
48
50
|
"build:openclaw": "esbuild openclaw/index.ts --bundle --format=esm --platform=node --external:openclaw/* --outfile=openclaw/dist/index.js",
|
|
49
|
-
"build:dsh": "esbuild dsh/index.ts --bundle --format=esm --platform=node --external:@deepseek-ai/* --
|
|
51
|
+
"build:dsh": "esbuild dsh/index.ts dsh/research-role.ts --bundle --format=esm --platform=node --external:@deepseek-ai/* --outdir=dsh/dist"
|
|
50
52
|
},
|
|
51
53
|
"keywords": [
|
|
52
54
|
"pi-agent",
|
|
@@ -76,15 +78,20 @@
|
|
|
76
78
|
},
|
|
77
79
|
"license": "MIT",
|
|
78
80
|
"devDependencies": {
|
|
79
|
-
"@deepseek-ai/cordis": "4.0.
|
|
80
|
-
"@deepseek-ai/dsh-
|
|
81
|
-
"@deepseek-ai/dsh-
|
|
82
|
-
"@
|
|
83
|
-
"
|
|
81
|
+
"@deepseek-ai/cordis": "4.0.5",
|
|
82
|
+
"@deepseek-ai/dsh-llm": "0.2.1-rc.5",
|
|
83
|
+
"@deepseek-ai/dsh-skill": "0.2.1-rc.5",
|
|
84
|
+
"@deepseek-ai/dsh-system-prompt": "0.2.1-rc.5",
|
|
85
|
+
"@deepseek-ai/dsh-tools": "0.2.1-rc.5",
|
|
86
|
+
"@types/node": "^24.19.2",
|
|
87
|
+
"esbuild": "^0.28.2",
|
|
84
88
|
"jiti": "^2.7.0",
|
|
85
|
-
"openai": "^
|
|
89
|
+
"openai": "^7.45.1",
|
|
86
90
|
"tsx": "^4.22.1",
|
|
87
91
|
"typebox": "^1.3.10",
|
|
88
92
|
"typescript": "^5.5.0"
|
|
93
|
+
},
|
|
94
|
+
"overrides": {
|
|
95
|
+
"zod": "4.6.7"
|
|
89
96
|
}
|
|
90
97
|
}
|