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.
Files changed (36) hide show
  1. package/README.md +88 -15
  2. package/package.json +2 -1
  3. package/pi/index.ts +867 -72
  4. package/schemas/market_review_schema.json +12 -5
  5. package/schemas/report_schema.json +65 -1
  6. package/scripts/cli-timeout.mjs +27 -0
  7. package/scripts/json-input.mjs +26 -0
  8. package/skills/bull-trend/SKILL.md +11 -1
  9. package/skills/bull-trend/references/monthly-trend-strategy.md +47 -0
  10. package/skills/bull-trend/references/trend-horizons.md +43 -0
  11. package/skills/bull-trend/references/trend-temperature.md +57 -0
  12. package/skills/bull-trend/scripts/market_trend.py +78 -0
  13. package/skills/event-driven/SKILL.md +4 -0
  14. package/skills/growth-quality/SKILL.md +4 -0
  15. package/skills/market-review/SKILL.md +2 -0
  16. package/skills/stock-analysis/SKILL.md +17 -3
  17. package/skills/stock-analysis/references/stateless-analysis.md +66 -0
  18. package/skills/stock-screener/SKILL.md +5 -1
  19. package/skills/strategy-backtest/SKILL.md +19 -0
  20. package/templates/market_review/full.md.j2 +7 -0
  21. package/templates/stock_analysis/_evidence.md.j2 +11 -0
  22. package/templates/stock_analysis/brief.md.j2 +2 -0
  23. package/templates/stock_analysis/full.md.j2 +2 -0
  24. package/tools/_subproc.py +66 -11
  25. package/tools/backtest.py +143 -19
  26. package/tools/capabilities.py +12 -0
  27. package/tools/cli_budgets.json +27 -0
  28. package/tools/gather.py +4 -6
  29. package/tools/market_review.py +30 -9
  30. package/tools/screener.py +57 -15
  31. package/tools/signal_tracker.py +77 -6
  32. package/tools/stateless_analysis.py +630 -0
  33. package/tools/stock_data.py +90 -15
  34. package/tools/technical.py +186 -0
  35. package/tools/trend_strategy.py +365 -0
  36. package/tools/watchlist_context.py +18 -7
package/README.md CHANGED
@@ -32,7 +32,7 @@ A 股 / 港股 / 美股 / 日股 / 韩股 / 台股综合分析、多因子选股
32
32
 
33
33
  ## 功能概览
34
34
 
35
- - **60 个工具** — 行情数据、技术分析、K 线形态、资金流向、估值历史、财报日历、股东/ETF/股息、新闻舆情、风险筛查、市场状态等
35
+ - **68 个工具** — 行情数据、技术分析、K 线形态、资金流向、估值历史、财报日历、股东/ETF/股息、新闻舆情、风险筛查、市场状态等
36
36
  - **20 个 Skills** — 综合分析、全市场选股、策略回测 + 17 个策略方法论(缠论、波浪、龙头、情绪周期等)
37
37
  - **策略回测引擎** — YAML DSL 定义策略,参数化条件组合,自动诊断,按需进行有限轮参数优化
38
38
  - **多数据源 Failover** — 11 个数据源自动容灾切换(akshare / tushare / efinance / 腾讯行情 / 新浪行情 / pytdx / baostock / yfinance / finnhub / longbridge / alphavantage),A 股链路带粘性优选(最近成功的数据源下次优先尝试)
@@ -70,6 +70,8 @@ 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.2.0)提供原生 `tool_search` 时,插件自动启用按需工具发现,68 项能力保留注册,仅命中工具加载完整定义。缺少原生发现接口的旧版 Pi 或 SDK 宿主保持全量暴露。检索使用英文关键词或工具名,例如 `get_quote`、`get_financials`。
74
+
73
75
  ### Hermes Agent Plugin
74
76
 
75
77
  ```bash
@@ -93,7 +95,7 @@ register(ctx)
93
95
  openclaw plugins install clawhub:@weaxs/openclaw-stock-analysis
94
96
  ```
95
97
 
96
- OpenClaw Gateway 启动后自动加载并注册 60 个 tool。安装时 postinstall 会自动建 `.venv` 并装好 Python 依赖(前提:本机有 `python3 >= 3.10`)。
98
+ OpenClaw Gateway 启动后自动加载并注册 68 个 tool。安装时 postinstall 会自动建 `.venv` 并装好 Python 依赖(前提:本机有 `python3 >= 3.10`)。
97
99
 
98
100
  详见 [OpenClaw 接入指南](docs/openclaw-integration.md),或 plugin 自身说明 [`openclaw/README.md`](openclaw/README.md)。
99
101
 
@@ -104,7 +106,9 @@ dsh plugin --profile <你的profile> add @weaxs/dsh-stock-analysis
104
106
  dsh --profile <你的profile>
105
107
  ```
106
108
 
107
- 作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册 60 个 tool + 20 个 skill。postinstall 自动建 `.venv`(pnpm 需在 profile 的 `pnpm-workspace.yaml` 里给本包配 `allowBuilds`,否则回退系统 `python3`)。
109
+ 作为 dsh bundle 安装:`dsh plugin add` 会把 `cordis.patch.yml` 叠加进 profile 组合,注册 68 个 tool + 20 个 skill。postinstall 自动建 `.venv`(pnpm 需在 profile 的 `pnpm-workspace.yaml` 里给本包配 `allowBuilds`,否则回退系统 `python3`)。
110
+
111
+ 新版 dsh 的原生函数调用模式默认通过 `stock_tool_search` 按 Agent 搜索、加载所需工具,支持中文关键词或工具名;旧接口、搜索入口不可用时保留全量暴露。可设置 `toolDiscovery: false` 关闭,配置与 PTC 模式边界见下方接入文档。
108
112
 
109
113
  详见 [`dsh/README.md`](dsh/README.md)。
110
114
 
@@ -270,20 +274,29 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
270
274
 
271
275
  | 工具 | 说明 |
272
276
  |------|------|
273
- | `get_technical_analysis` | 全面技术指标分析(MA/MACD/RSI/BOLL/KDJ;多周期共振时 resonance.direction ∈ aligned_bullish/aligned_bearish/divergent) |
277
+ | `analyze_trend_strategy` | 月度右侧趋势策略:单市场股票池筛选、真实旧仓保持/退出与逆波动新仓预算;直接传股票代码、自动取行情,无持仓存储,仍为not_validated |
278
+ | `get_technical_analysis` | 全面技术指标分析(MA/MACD/RSI/BOLL/KDJ;附实验性 trend_horizons 多期限月度趋势及独立趋势温度 trend_temperature;多周期共振时 resonance.direction ∈ aligned_bullish/aligned_bearish/divergent) |
274
279
  | `analyze_pattern` | K 线形态识别 |
275
280
  | `calculate_ma` | 多周期均线计算 |
276
281
  | `get_volume_analysis` | 量价分析 |
277
282
  | `evaluate_signal` | 历史信号胜率回测 |
278
283
  | `detect_anomaly` | 当日技术、量价与资金异动扫描 |
279
284
 
285
+ `trend_temperature` 是独立趋势温度指标:`(EMA20-EMA60)/ATR14`,ATR 使用包含跳空的真实波幅简单均值。附分数、EMA差方向 `direction`、七档研究标签、前一期信息、数据日期和价格口径;`validation_status=not_validated`,真实股票试验未支持默认温度交易映射。方向按零轴计算,“平”标签不代表零方向;默认需 60 根预热,零 ATR 或坏行情返回不可用。±0.5/±1.5/±3 的分档尚未校准,不是趋势动物公式、肥尾指标、上涨概率或自动买卖信号,也不修改原综合评分。无需个人持仓存储;[公式、边界及回测说明](skills/bull-trend/references/trend-temperature.md)。
286
+
287
+ 月度右侧趋势策略,通过 `analyze_trend_strategy(symbols, ...)` 调用:月初200日线上行入场、真实旧仓优先、63日波动预算;[输入格式与完整规则](skills/bull-trend/references/monthly-trend-strategy.md)。扩展及历史样本尚未通过完整效果门槛;直接提供股票代码即可自动取日K,输出信号与预算计划;实际成交/股数和共享资金回测另行核实,不自动保存持仓或下单。
288
+
289
+ 趋势研究另返回 `trend_horizons`(daily、建议count=360):21/63/252根日K过去对数收益,在月初首根有效日K收盘观察并保持;显示期限组成、方向及观察日期,不强凑七档。与回测 `monthly_momentum` 共用计算,仍为 `not_validated`;[方法、预热与验证局限](skills/bull-trend/references/trend-horizons.md)。
290
+
291
+ 市场只约束新开仓的三期限实验可运行 [market_trend.py](skills/bull-trend/scripts/market_trend.py),输入带预热的个股/同市场宽基daily OHLCV JSON,复用同一Python核心。月度入场、次日开盘、已有持仓按个股趋势退出;不会自动保存持仓或下单。[使用与当前验证边界](skills/bull-trend/references/trend-horizons.md#市场环境入场实验)。
292
+
280
293
  ### 筛选与回测
281
294
 
282
295
  | 工具 | 说明 |
283
296
  |------|------|
284
- | `screen_stocks` | 全市场多因子筛选(市场情绪调节,可选 L2 量化增强) |
297
+ | `screen_stocks` | 全市场多因子筛选(可选 L2;factor_coverage 展示缺失因子、覆盖度、实际权重及 L2 effective_scores) |
285
298
  | `screen_risk` | 风险因子筛查 |
286
- | `run_backtest` | YAML 策略回测 |
299
+ | `run_backtest` | YAML 策略回测,默认收盘信号于次日开盘成交,execution 返回模型与限制 |
287
300
  | `detect_market_regime` | 市场状态检测(牛/熊/震荡) |
288
301
  | `get_market_review` | 市场日度复盘数据 |
289
302
  | `get_review_history` | 复盘归档历史(最近 N 条,最新在前,用于纵向对比) |
@@ -320,8 +333,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
320
333
  | `check_alert_rules` | 无状态检查价格、涨跌幅、异动和风险规则 |
321
334
  | `record_signal` | 记录 AI 分析建议信号(本地 JSONL 持久化) |
322
335
  | `evaluate_signals` | 评估到期信号(target_hit/stop_hit/timeout 结算) |
323
- | `get_signal_summary` | 信号胜率汇总(按 source/symbol/status 过滤) |
324
- | `render_stock_report` | 将结构化个股报告渲染为 Markdown |
336
+ | `get_signal_summary` | 信号胜率及分来源平均收益、有效收益样本数与小样本提示(按 source/symbol/status 过滤) |
337
+ | `render_stock_report` | 将结构化个股报告渲染为 Markdown,展示 evidence 与 data_quality 限制 |
325
338
  | `render_market_report` | 将结构化市场复盘渲染为 Markdown(save=true 时归档到本地 JSONL) |
326
339
 
327
340
  批量自选股分析和摘要的 `success` 表示至少获取了有效行情价格、K 线收盘价或技术评分;全部关键数据失败时计入 `failed`,部分结果仍保留。采集脚本复用返回的 K 线计算技术指标,并按股票所属市场查询大盘状态;日/韩/台市场状态暂不可用,非 A 股板块榜单也暂不可用,均会明确返回错误。
@@ -332,6 +345,43 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
332
345
 
333
346
  选股的 `filters_applied` 只列实际执行的条件,显式条件缺少数据时报错。回测的 `period` 是实际数据期间,`requested_period` 保留请求期间,`warnings` 提示覆盖差异;买入预算包含佣金,年化收益和回撤按实际数据及初始资金计算。
334
347
 
348
+ ### 无状态研究与风险计算
349
+
350
+ | 工具 | 说明 |
351
+ |------|------|
352
+ | `compare_stocks` | 比较显式输入的同行指标;检查单位、期间和口径,仅对可比数值排序 |
353
+ | `analyze_disclosure_changes` | 比较新旧公告正文与财务指标,返回来源、变更行号和增长率限制 |
354
+ | `analyze_portfolio_risk` | 一次性持仓的集中度、行业/币种敞口、价格盈亏、止损情景与可选相关性 |
355
+ | `calculate_position_size` | 按现金、风险预算、费用、滑点和交易单位计算本次可买数量 |
356
+ | `analyze_event_study` | 事件前一交易日收盘至各窗口的股票/基准收益差,标明缺失和重叠样本 |
357
+ | `validate_backtest` | 复用现有引擎,滚动训练选候选、样本外验证,比较参数及多个标的 |
358
+ | `compare_analysis_snapshots` | 比较调用方传入的快照,区分新增、删除、变化、数据失效和恢复 |
359
+
360
+ 这些工具不保存自选股、账户或分析历史,也不提供调度/通知。现有数据工具采集行情和财务,宿主传入本次持仓、正文或快照;[完整输入约定与解读工作流](skills/stock-analysis/references/stateless-analysis.md)供四个宿主共用。
361
+
362
+ 大输入经权限受限的临时 JSON 文件传给 Python,调用结束后清理,避免 Windows 命令行长度限制;CLI 也支持 stdin 和 `--input` 文件。公告正文由宿主读取:PDF/OCR 不包含在本次扩展中,只有标题或链接不能声称已读全文。
363
+
364
+ 例如仓位预算(所有金额同币种,lot_size 由用户或交易规则确认):
365
+
366
+ ```json
367
+ {
368
+ "equity": 100000, "cash": 20000,
369
+ "entry_price": 100, "stop_price": 95,
370
+ "risk_fraction": 0.01, "lot_size": 100,
371
+ "fee_rate": 0.001, "slippage_rate": 0.001
372
+ }
373
+ ```
374
+
375
+ 将上述 JSON 保存为 `input.json` 后运行:
376
+
377
+ ```bash
378
+ python tools/stateless_analysis.py position_size --input input.json
379
+ ```
380
+
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 模式仍支持离线计算,两种模式互斥。
382
+
383
+ 跨币种组合必须提供显式汇率;价格盈亏不含历史汇兑损益。稳健性工具仅支持 next_open、每窗口重新从现金开始,样本内敏感性不等于样本外表现。
384
+
335
385
  ## 策略回测 DSL
336
386
 
337
387
  策略以 YAML 格式定义,支持参数化和条件组合:
@@ -374,10 +424,13 @@ position:
374
424
  max_positions: 1
375
425
  ```
376
426
 
427
+ 行情 JSON 保留原有数组/字典形状,添加 `source`、UTC `fetched_at` 和 `data_as_of`。采集时间不是报价时间,提供方未给时间时为 null;仅提供交易日时保留 YYYY-MM-DD,不补造具体时刻;K 线 data_as_of 是该条的日期标签,周/月线标签不是实际末次成交时间;`as_of_basis=trading_calendar` 表示交易日历推断。A 股复权口径延续 qfq/none;其他市场按来源标为 total_return/qfq/unknown,不把 unknown 当已验证复权。
428
+
377
429
  其他可用键:
378
430
 
379
431
  - `exit.trailing_stop`:移动止损,价格自持仓期间最高收盘价回撤达到该比例即卖出(如 `0.08` = 峰值回撤 8% 触发);与 `stop_loss` 同时设置时先判固定止损。
380
432
  - `benchmark`(顶层):基准对比标的代码(如 `"sh000300"` 沪深300;指数代码必须带 sh/sz 交易所前缀,裸 6 位数字会被当作个股),设置后回测结果附带 `benchmark` 块(基准买入持有收益与 `excess_return` 超额收益)。
433
+ - `simulation.execution`:默认 `next_open`,前日收盘信号、次日开盘加滑点成交;显式 `same_close` 复现旧收盘成交假设。交易同时返回 signal_date/date。零成交量阻止成交;一字板限制只在输入提供同口径历史 limit_up/limit_down 时执行。`execution` 列出阻止成交次数、未成交订单及限制;止损是收盘信号,未模拟盘口排队、部分成交、结算和市场冲击。
381
434
  - `simulation`(顶层):交易成本。`slippage`(滑点,买卖双边,默认 0.001)、`commission`(佣金,买卖双边,默认 0.0015)、`stamp_tax`(印花税,仅卖出收取,默认 0;A股为 0.0005,各市场税率不同且会调整,按当下实际费率填写)。费率均须在 [0, 1) 区间,越界报错。回测结果附带 `costs` 块(实际生效费率与实付费用合计 `commission_paid`/`stamp_tax_paid`)。
382
435
 
383
436
  ### 可用指标
@@ -390,6 +443,8 @@ position:
390
443
  | `volume_ratio` | 量比 | 是(默认 5) |
391
444
  | `price_change` | 涨跌幅(%) | 否 |
392
445
  | `bollinger_position` | 布林带位置(0=下轨, 1=上轨) | 是(默认 20) |
446
+ | `trend_score` | 独立实验趋势强度,默认 (EMA20−EMA60)/ATR14;fast_period/slow_period 控制 EMA | period 为 ATR 根数(默认 14) |
447
+ | `monthly_momentum` | 月初首根有效日K收盘观察过去 period 根对数收益,保持到下一观察;零成交量不计根数 | 是(默认63,要求正整数) |
393
448
  | `close` / `volume` | 收盘价 / 成交量 | 否 |
394
449
 
395
450
  ### 可用运算符
@@ -501,27 +556,27 @@ GitHub Actions 的 `e2e-host` 使用 Pi、Hermes、OpenClaw、dsh 的真实运
501
556
  | `OPENAI_API_KEY` | Secret | 对应的 API key |
502
557
  | `OPENAI_MODEL` | Variable 或 Secret | 支持 tool calling 的模型 ID |
503
558
 
504
- `e2e-llm` 也使用这三项配置;同仓库 PR 和主分支推送会运行,fork PR 不读取 API key。`e2e-host` 缺少任一项时会失败。URL 和 model 同时存在于 Variable 与 Secret 时,优先使用 Secret。
559
+ `e2e-llm` 也使用这三项配置,Hermes(含报告质量评测)、Pi、OpenClaw 和 dsh 通过四个 matrix 作业并行运行,互不因失败而取消;同仓库 PR 和主分支推送会运行,fork PR 不读取 API key。`e2e-host` 缺少任一项时会失败。URL 和 model 同时存在于 Variable 与 Secret 时,优先使用 Secret。
505
560
 
506
561
  ## 项目结构
507
562
 
508
563
  ```
509
564
  stock-analysis/
510
565
  ├── pi/ # Pi Agent Extension
511
- │ └── index.ts # 注册 60 个工具 + 20 个 skill
566
+ │ └── index.ts # 注册 68 个工具 + 20 个 skill
512
567
  ├── hermes/ # Hermes Agent Plugin
513
568
  │ ├── plugin.yaml # 插件清单
514
569
  │ ├── __init__.py # register(ctx) 入口
515
570
  │ ├── schemas.py # 工具 JSON Schema 定义
516
- │ └── tools.py # 60 个 handler → subprocess 调 CLI
571
+ │ └── tools.py # 68 个 handler → subprocess 调 CLI
517
572
  ├── openclaw/ # OpenClaw Plugin
518
573
  │ ├── openclaw.plugin.json # manifest(contracts.tools)
519
574
  │ ├── package.json # 含 openclaw 块(pluginApi/SDK 版本)
520
- │ └── index.ts # definePluginEntry + registerTool ×60
575
+ │ └── index.ts # definePluginEntry + registerTool ×68
521
576
  ├── dsh/ # DeepSeek Harness (dsh) Plugin
522
577
  │ ├── cordis.patch.yml # bundle patch(insert 插件入口)
523
578
  │ ├── package.json # 含 dsh.bundle 块(bundle manifest)
524
- │ └── index.ts # cordis apply(ctx) + defineTool ×60
579
+ │ └── index.ts # cordis apply(ctx) + defineTool ×68
525
580
  │
526
581
  ├── tools/ # 共享 Python CLI 工具
527
582
  │ ├── stock_data.py # 行情 / 资金流 / 新闻 / 财务 / 短线情绪
@@ -655,6 +710,24 @@ python3 tools/sec_edgar.py holdings 0001067983 --mode manager
655
710
 
656
711
  首次下载当前 SEC 包约 100 MB;ZIP 按周缓存,CUSIP 反查结果按天缓存,流式扫描不解压整个持仓表、不增加数据库依赖。返回 `report_date`(持仓日期)、`filing_window_end`(公开申报窗口截止)、`cusip_evidence`(原文映射依据),不把文件披露窗口当作持仓日期。`mapping_complete=false` 表示最近十份结构化 13D/G 可能未覆盖所有证券类别或 CUSIP 变更;缺映射直接报错,不做名称模糊匹配。`complete_for_mapped_cusips` 仅在该报告期没有未解决申报链时为 true,不代表实时全部股东。期权与本金持仓在 `positions` 保留,`shares` 合计只计无 PUT/CALL 的 SH 股票。不能将跨机构合计当作已去重的全市场持股。
657
712
 
658
- 来源格式与实測依据见 [#51 数据研究](docs/research/issue-51-reverse-holdings.md)。
713
+ 13F CLI 预算为 300 秒,宿主另留 30 秒接收输出;其他命令按共享预算表执行。机构查询优先寻找最新已知报告期的原始 13F:较新修订对应的原始版未找到时明确报错,历史分片仍未完全检索时返回 `history_truncated` 与警告。发行人 CUSIP 查询会跳过不可访问/无效 XML,继续核对后续原文;没有任何可验证映射时才报缺失。
714
+
715
+ ## 分析可靠性验证
716
+
717
+ 命令预算集中于 `tools/cli_budgets.json`:通用采集默认 120 秒、市场快照 240 秒、选股 top 须为正整数,预算按候选数及 6 个 worker 的批次计算(默认 20 个候选为 1830 秒)、13F 300 秒;技术分析、市场状态、回测和风险筛查按实际嵌套调用另留预算;四个宿主额外留 30 秒接收 CLI 输出。综合采集保留安全 JSON 错误及 error_code(timeout/empty_output/invalid_json/process_failed/tool_error),不会把失败当成有效空数据。
718
+
719
+ 最终报告的固定证据案例覆盖完整、缺失、过期、同口径冲突及样本不足:
720
+
721
+ ```bash
722
+ .venv/bin/python -m pytest tests/test_analysis_quality.py -q
723
+ # 需要 OPENAI_BASE_URL / OPENAI_API_KEY / OPENAI_MODEL;只调用模型,数据源使用固定夹具
724
+ .venv/bin/python -m pytest tests/e2e/test_analysis_quality.py -m integration_llm -v
725
+ ```
726
+
727
+ 真实模型评测同时要求结构化证据检查与独立上下文的结论审稿通过:审稿检查正文事实、限制说明是否诚实,以及是否过度外推。未运行审稿、结果缺失或模糊都不能算通过;报告自行声明通过不被采信。另有人工核对的正确报告及两类反例用于验证审稿器(正确引用但正文捏造现价、3笔交易却保证长期胜率)。空回答也失败。离线渲染和规则检查不代表真实模型通过,也不证明策略未来有效。信号建议可沿用 source 标识策略版本,按来源复盘胜率、平均收益和样本量;未扣成本、未匹配基准的观察记录不能当作策略回测。
728
+
729
+ 信号结算仅在价格口径可核实时进行:原始价格可直接比较;复权日线需记录日 adjustment_factor(复权价/原始价),当前日线 Tushare、Alpha Vantage 可提供。缺失系数或口径未知时返回 skipped_price_basis,保持未结算,不猜测除权比例。换算后的 exit_price 是记录时价格单位的等价值,实际市场价可不同,evaluation_price_basis 保留依据。evaluate_signals 的 CLI 预算为 300 秒,内部提前结束采集并保存已完成结果,complete/deferred/warnings 指示需要重试的记录;预算耗尽后调整未结算记录的处理顺序,下轮优先处理尚未尝试的记录,避免慢请求长期阻塞后续信号。
730
+
731
+ 市场复盘数据不足时温度/姿态为 null,信号 unknown,data_quality.limitations 说明限制。自选股异动采集失败时 anomaly_status=unavailable、anomaly_count=null,保留警告并计入 summary.partial,不能当成无异常。
659
732
 
660
- Hermes 的 `get_us_holdings` 子进程预算为 300 秒,允许首次下载批量包;其他 CLI 仍为 120 秒。机构查询优先寻找最新已知报告期的原始 13F:较新修订对应的原始版未找到时明确报错,历史分片仍未完全检索时返回 `history_truncated` 与警告。发行人 CUSIP 查询会跳过不可访问/无效 XML,继续核对后续原文;没有任何可验证映射时才报缺失。
733
+ L1 与 L2 综合分均在排序前按可用因子重新归一化;缺失或非有限因子不作零分处理,因子组内部也仅平均有效输入。factor_coverage.ratio 保留原始权重覆盖率,effective_weights 是实际归一化后的权重,高分仍需结合覆盖率判断。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stock-analysis-plugin",
3
- "version": "0.2.6",
3
+ "version": "0.2.8",
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",
@@ -34,6 +34,7 @@
34
34
  "files": [
35
35
  "pi/",
36
36
  "tools/**/*.py",
37
+ "tools/cli_budgets.json",
37
38
  "tools/requirements.txt",
38
39
  "skills/",
39
40
  "schemas/",