@weaxs/dsh-stock-analysis 0.2.11 → 0.2.12

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 (41) hide show
  1. package/README.md +33 -81
  2. package/dist/index.js +3782 -2693
  3. package/dist/web/app.js +38 -6
  4. package/dist/web/style.css +1 -0
  5. package/package.json +1 -1
  6. package/scripts/cli-json.mjs +23 -0
  7. package/scripts/exec-process.mjs +89 -0
  8. package/scripts/setup-python.mjs +37 -4
  9. package/scripts/tool-calls.mjs +489 -0
  10. package/skills/event-driven/SKILL.md +2 -2
  11. package/skills/growth-quality/SKILL.md +1 -1
  12. package/skills/stock-analysis/SKILL.md +8 -6
  13. package/skills/stock-analysis/references/stateless-analysis.md +9 -1
  14. package/tools/_cache.py +13 -0
  15. package/tools/_subproc.py +46 -0
  16. package/tools/alert_rules.py +2 -2
  17. package/tools/backtest.py +3 -3
  18. package/tools/capabilities.py +32 -9
  19. package/tools/cli_budgets.json +2 -0
  20. package/tools/diagnostics.py +3 -4
  21. package/tools/gather.py +2 -6
  22. package/tools/import_parser.py +3 -4
  23. package/tools/lixinger.py +119 -27
  24. package/tools/market_regime.py +5 -2
  25. package/tools/market_review.py +5 -6
  26. package/tools/name_resolver.py +66 -7
  27. package/tools/report_renderer.py +3 -3
  28. package/tools/requirements.txt +5 -4
  29. package/tools/risk_screening.py +3 -2
  30. package/tools/screener.py +6 -4
  31. package/tools/search_intel.py +79 -10
  32. package/tools/sec_edgar.py +266 -0
  33. package/tools/sec_holders.py +6 -0
  34. package/tools/signal_tracker.py +5 -5
  35. package/tools/stateless_analysis.py +115 -0
  36. package/tools/stock_data.py +455 -201
  37. package/tools/tiaa_disclosures.py +4 -0
  38. package/tools/tool_schemas.json +2704 -0
  39. package/tools/trading_calendar.py +65 -30
  40. package/tools/value_data.py +366 -134
  41. package/tools/watchlist.py +43 -5
package/README.md CHANGED
@@ -1,32 +1,20 @@
1
1
  # Stock Analysis — DeepSeek Harness (dsh) Plugin
2
2
 
3
- A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 72 个工具,并自动注册 21 个工作流/策略方法论 skill。
3
+ A 股 / 港股 / 美股 / 日股 / 韩股 / 台股的行情、技术分析、选股与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 74 个工具,并自动注册 21 个工作流和策略方法论 Skill;dsh Web / Desktop 侧栏还会多出一个「股票仪表盘」。
4
4
 
5
- ## 按需工具发现
6
-
7
- dsh 0.2.2 及以上(工具注册支持按步骤的 `when` 条件)默认增加一个宿主控制入口 `stock_tool_search`;更早的 0.2.1 不提供该接口,插件会自动关闭按需发现并全量暴露工具,功能不受影响。按需发现只控制工具加载,不改变 72 个分析工具的名称、参数和输出。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
8
-
9
- 加载集合按 Agent 隔离,搜索和回退均保留宿主已有的工具权限限制。搜索入口被禁止或移除时,下一次请求保留原先已授权的完整股票工具目录。旧版缺少相关接口时保持全量暴露;PTC / both 模式沿用宿主生成的 SDK,不做发现过滤。加载集合在本次运行中保留,恢复会话或重载插件后需重新搜索。
10
-
11
- 如需关闭发现,在 profile 中本插件条目的配置中设置:
12
-
13
- ```yaml
14
- - name: "@weaxs/dsh-stock-analysis"
15
- config:
16
- toolDiscovery: false
17
- ```
18
-
19
- 这里的 `stock_tool_search` 是 dsh 适配器的目录控制工具,作用类似 Pi/Hermes/OpenClaw 的宿主发现入口,不增加共享 Python 分析能力,也不执行分析。
5
+ ![dsh 股票仪表盘:六市场自选股行情、指数带、A 股涨跌分布与行业涨跌榜(深色主题)](https://raw.githubusercontent.com/Weaxs/stock-analysis-plugin/main/docs/images/dsh-dashboard-dark.png)
20
6
 
21
7
  ## 安装
22
8
 
23
9
  ```bash
24
- dsh plugin --profile <你的profile> add @weaxs/dsh-stock-analysis
10
+ dsh plugin --profile <你的profile> add dsh-stock-analysis
25
11
  dsh --profile <你的profile>
26
12
  ```
27
13
 
28
14
  `dsh plugin add` 是 pnpm 的薄封装:安装后 dsh 会读取本包 `package.json` 里的 `dsh.bundle.patch`,把 `cordis.patch.yml` 作为一层叠加进 profile 组合。可用 `dsh --profile <你的profile> --dump-config` 验证 layer 已生效。
29
15
 
16
+ 同一份插件也以 `@weaxs/dsh-stock-analysis` 发布;装 scoped 版时,下文配置里的包名也换成 `@weaxs/dsh-stock-analysis`。
17
+
30
18
  从源码安装(本仓库根目录):
31
19
 
32
20
  ```bash
@@ -42,7 +30,7 @@ dsh plugin --profile <你的profile> add ./dsh
42
30
 
43
31
  ```yaml
44
32
  allowBuilds:
45
- "@weaxs/dsh-stock-analysis": true
33
+ "dsh-stock-analysis": true
46
34
  ```
47
35
 
48
36
  如果 venv 最终没建起来,plugin 会回退到系统 `python3`(Windows 为 `python`),此时请自行 `pip install -r tools/requirements.txt`。
@@ -53,68 +41,32 @@ allowBuilds:
53
41
 
54
42
  自选股按代码添加,支持逗号批量导入和删除,最多 30 只,覆盖六个市场。列表保存在 `$STOCK_WATCHLIST_FILE`,未配置时保存到 `$DSH_HOME/stock-analysis/watchlist.json`(`DSH_HOME` 默认为 `~/.dsh`)。文件损坏时拒绝静默覆盖。
55
43
 
44
+ ### 数据如何更新
45
+
56
46
  数据由插件后台常驻预热:Web 路由注册后即开始按固定任务表调用现有 CLI(`stock_data.py quote/market_indices/kline/sector_rankings/market_stats` 与 `trading_calendar.py phase`),最多 4 个 Python 进程按优先级排队(报价 > 指数 > 走势 > 行业/统计),结果留在内存缓存。刷新节奏随各市场交易阶段变化:交易时段有页面打开时报价与指数约 30 秒、行业 1 分钟、全 A 统计 2 分钟;无人查看时放宽到 5–10 分钟;收盘后 30–60 分钟一次。失败保留上次成功值并标注,重试间隔按 1、2、4… 分钟退避。页面只轮询内存快照 `/api/snapshot`(有后台任务时 1.5 秒,否则 15 秒,页面不可见时停止),并在浏览器本地缓存 24 小时,打开即显示上次数据;「刷新」会让所有数据立即重新获取。不调用包含财务、新闻、风险等完整采集的 `run_watchlist_analysis`。前端接口只接受固定的快照、刷新和自选股操作,不开放任意 Python 脚本或参数。
57
47
 
58
- 前端由 `dsh/client.ts`、`dsh/dashboard.ts` 和 `dsh/web/`(`app.ts` + HTML/CSS)组成,均为 TypeScript,`npm run build:dsh` 将浏览器端编译为 IIFE 输出到 `dist/`;它不增加或改变四宿主共享的 72 个模型工具。源码或 manifest 改动后重新运行 `npm run build:dsh` 并重装/重启对应 profile。
59
-
60
- ## 工具列表
61
-
62
- ### 行情数据
63
- - `get_kline` — K线 OHLCV(A/HK/US/JP/KR/TW)
64
- - `get_quote` — 股票实时报价;场外基金用 `get_fund_quote`,TIAAxxxxxx 返回投顾组合识别、`advisor_org` 与无统一净值提示;长钱/海外长钱/稳钱另有有知有行 `official_disclosures`(`partial=true`,非实时完整持仓);其他组合搜索可用时为 `search_partial`,否则 `unsupported_provider`
65
- - `get_fund_quote` — 场外公募基金净值;`nav` 为已披露日终净值(非实时价),含 `accumulated_nav` / `change_pct` / `nav_date`;`estimated_nav` 可能为 null,QDII 可能滞后 1-2 交易日
66
- - `get_capital_flow` — A股资金流(个股 / 多日 / 板块)
67
- - `get_news` — 财经新闻
68
- - `get_financials` — 关键财务指标
69
-
70
- ### 分析
71
- - `get_technical_analysis` — MA/MACD/RSI/BOLL/KDJ + 综合评分
72
- - `analyze_pattern` — 12+ 种 K 线形态识别
73
- - `calculate_ma` — 独立均线计算
74
- - `get_volume_analysis` — 量价分析
75
- - `analyze_portfolio_risk` — 组合敞口、相关性、止损与确定性压力测试
76
- - `plan_portfolio_rebalance` — 目标权重、整手和现金约束下的调仓清单
77
-
78
- ### 市场全景
79
- - `get_market_indices` — 主要指数(CN/HK/US/JP/KR/TW)
80
- - `get_sector_rankings` — A股板块涨跌幅排行
81
- - `get_sector_constituents` — A股板块成分股查询(板块名模糊匹配)
82
- - `resolve_stock_sectors` — 个股所属板块查询(A股行业+概念 / 港股 GICS)
83
- - `get_market_stats` — A股大盘统计
84
- - `get_stock_info` — 股票基本信息
85
- - `get_chip_distribution` — A股筹码分布
86
- - `get_fundamental_context` — A股深度基本面
87
- - `detect_market_regime` — 市场阶段检测
88
- - `get_market_review` — 大盘日度复盘
89
-
90
- ### 筛选与回测
91
- - `screen_stocks` — 全市场多因子筛选(AlphaSift L1)
92
- - `run_backtest` — 策略回测(AlphaEvo)
93
- - `evaluate_signal` — 信号历史准确率
94
- - `screen_risk` — 7维度风险筛查
95
- - `run_watchlist_analysis` — 自选股批量分析
96
- - `detect_anomaly` — 异动信号扫描
97
-
98
- ### 报告与上下文
99
- - `render_stock_report` / `render_market_report` — 结构化 JSON → Markdown 报告
100
- - `build_watchlist_context` — 自选股上下文包
101
- - `analyze_position_context` — 持仓上下文分析
102
- - `check_alert_rules` — 无状态告警规则检查
103
- - `parse_stock_list` — 自选股/文本导入解析
104
- - `diagnose_data_sources` — 数据源链路诊断
105
- - `get_market_capabilities` — 市场能力边界
106
-
107
- ### 工具类
108
- - `resolve_stock_name` — A股名称/拼音 → 代码
109
- - `check_trading_day` / `get_trading_days` — 交易日历
110
-
111
- ### 情报搜索(需 API Key)
112
- - `search_stock_news` — Tavily/Brave/SerpAPI 新闻搜索
113
- - `search_comprehensive_intel` — 6 维度综合情报
114
- - `get_social_sentiment` — Reddit/X/Polymarket 情绪
115
- - `get_trending_sentiment` — 社交热门趋势
116
- - `extract_article` — 文章正文提取
117
-
118
- ## 平行 Host
119
-
120
- 同一份业务逻辑也以 [Pi Agent extension](../pi/index.ts)、[Hermes plugin](../hermes/) 和 [OpenClaw plugin](../openclaw/) 形式分发;选你用的那个生态即可。
48
+ 前端由 `dsh/client.ts`、`dsh/dashboard.ts` 和 `dsh/web/`(`app.ts` + HTML/CSS)组成,均为 TypeScript,`npm run build:dsh` 将浏览器端编译为 IIFE 输出到 `dist/`;它不增加或改变四宿主共享的 74 个模型工具。源码或 manifest 改动后重新运行 `npm run build:dsh` 并重装/重启对应 profile。
49
+
50
+ ## 按需工具发现
51
+
52
+ dsh 0.2.2 及以上(工具注册支持按步骤的 `when` 条件)默认增加一个宿主控制入口 `stock_tool_search`;更早的 0.2.1 不提供该接口,插件会自动关闭按需发现并全量暴露工具,功能不受影响。按需发现只控制工具加载,不改变 74 个分析工具的名称、参数和输出。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
53
+
54
+ 加载集合按 Agent 隔离,搜索和回退均保留宿主已有的工具权限限制。搜索入口被禁止或移除时,下一次请求保留原先已授权的完整股票工具目录。旧版缺少相关接口时保持全量暴露;PTC / both 模式沿用宿主生成的 SDK,不做发现过滤。加载集合在本次运行中保留,恢复会话或重载插件后需重新搜索。
55
+
56
+ 如需关闭发现,在 profile 中本插件条目的配置中设置:
57
+
58
+ ```yaml
59
+ - name: "dsh-stock-analysis"
60
+ config:
61
+ toolDiscovery: false
62
+ ```
63
+
64
+ 这里的 `stock_tool_search` 是 dsh 适配器的目录控制工具,作用类似 Pi/Hermes/OpenClaw 的宿主发现入口,不增加共享 Python 分析能力,也不执行分析。
65
+
66
+ ## 工具与 Skills
67
+
68
+ 74 个工具覆盖行情与基金净值、技术分析与 K 线形态、资金流与板块、估值/股东/ETF/股息、公告与 SEC、多因子选股、策略回测、市场复盘、新闻舆情、持仓风险与调仓计算。完整列表见[主仓库 README · 工具列表](https://github.com/Weaxs/stock-analysis-plugin#工具列表),Skills 见 [Skills 一览](https://github.com/Weaxs/stock-analysis-plugin#skills-一览)。
69
+
70
+ ## 其他宿主
71
+
72
+ 同一套工具也以 Pi Agent extension、Hermes plugin、OpenClaw plugin 和 MCP stdio 服务器形式分发,见[主仓库 README · 快速开始](https://github.com/Weaxs/stock-analysis-plugin#快速开始)。