@weaxs/dsh-stock-analysis 0.2.9 → 0.2.11

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 (39) hide show
  1. package/README.md +16 -3
  2. package/dist/client.js +88 -0
  3. package/dist/index.js +860 -126
  4. package/dist/web/app.js +871 -0
  5. package/dist/web/index.html +87 -0
  6. package/dist/web/style.css +292 -0
  7. package/package.json +13 -3
  8. package/scripts/profile-offline.py +127 -0
  9. package/scripts/profile-workflows.py +87 -0
  10. package/skills/growth-quality/SKILL.md +2 -0
  11. package/skills/stock-analysis/SKILL.md +14 -3
  12. package/skills/stock-analysis/references/stateless-analysis.md +16 -2
  13. package/skills/stock-screener/SKILL.md +4 -0
  14. package/skills/strategy-backtest/SKILL.md +8 -3
  15. package/tools/_cache.py +93 -21
  16. package/tools/_subproc.py +43 -8
  17. package/tools/alert_rules.py +63 -14
  18. package/tools/anomaly_detect.py +11 -6
  19. package/tools/backtest.py +225 -70
  20. package/tools/capabilities.py +1 -0
  21. package/tools/gather.py +63 -8
  22. package/tools/market_regime.py +26 -15
  23. package/tools/market_review.py +2 -2
  24. package/tools/name_resolver.py +16 -14
  25. package/tools/position_context.py +5 -2
  26. package/tools/requirements.txt +4 -4
  27. package/tools/risk_screening.py +40 -15
  28. package/tools/screener.py +44 -18
  29. package/tools/search_intel.py +95 -33
  30. package/tools/sec_holders.py +27 -25
  31. package/tools/signal_tracker.py +106 -54
  32. package/tools/stateless_analysis.py +600 -33
  33. package/tools/stock_data.py +366 -50
  34. package/tools/technical.py +42 -40
  35. package/tools/tiaa_disclosures.py +263 -0
  36. package/tools/trading_calendar.py +26 -21
  37. package/tools/value_data.py +6 -2
  38. package/tools/watchlist.py +24 -15
  39. package/tools/watchlist_context.py +63 -49
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # Stock Analysis — DeepSeek Harness (dsh) Plugin
2
2
 
3
- A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 70 个工具,并自动注册 21 个工作流/策略方法论 skill。
3
+ A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 72 个工具,并自动注册 21 个工作流/策略方法论 skill。
4
4
 
5
5
  ## 按需工具发现
6
6
 
7
- 支持作用域工具接口和请求组装钩子的新版 dsh 默认增加一个宿主控制入口 `stock_tool_search`,原有 70 个分析工具的名称、参数和输出不变。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
7
+ dsh 0.2.2 及以上(工具注册支持按步骤的 `when` 条件)默认增加一个宿主控制入口 `stock_tool_search`;更早的 0.2.1 不提供该接口,插件会自动关闭按需发现并全量暴露工具,功能不受影响。按需发现只控制工具加载,不改变 72 个分析工具的名称、参数和输出。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
8
8
 
9
9
  加载集合按 Agent 隔离,搜索和回退均保留宿主已有的工具权限限制。搜索入口被禁止或移除时,下一次请求保留原先已授权的完整股票工具目录。旧版缺少相关接口时保持全量暴露;PTC / both 模式沿用宿主生成的 SDK,不做发现过滤。加载集合在本次运行中保留,恢复会话或重载插件后需重新搜索。
10
10
 
@@ -47,11 +47,22 @@ allowBuilds:
47
47
 
48
48
  如果 venv 最终没建起来,plugin 会回退到系统 `python3`(Windows 为 `python`),此时请自行 `pip install -r tools/requirements.txt`。
49
49
 
50
+ ## 股票仪表盘(Web / Desktop)
51
+
52
+ 支持 dsh 前端的宿主会在侧栏显示「股票仪表盘」。首屏是自选股行情表:最新价、涨跌幅、涨跌额、今日区间(振幅与昨收位置)、成交额和 30 日走势(悬停可看每日收盘与较首日涨跌),可按列排序、按市场筛选;上方是六市场指数带和 A 股涨跌分布,下方可切换 A / HK / US / JP / KR / TW 查看各市场指数与交易阶段,A 股另有涨跌统计和行业领涨/领跌榜。其他市场没有用少数指数推算全市场宽度。
53
+
54
+ 自选股按代码添加,支持逗号批量导入和删除,最多 30 只,覆盖六个市场。列表保存在 `$STOCK_WATCHLIST_FILE`,未配置时保存到 `$DSH_HOME/stock-analysis/watchlist.json`(`DSH_HOME` 默认为 `~/.dsh`)。文件损坏时拒绝静默覆盖。
55
+
56
+ 数据由插件后台常驻预热: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
+
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
+
50
60
  ## 工具列表
51
61
 
52
62
  ### 行情数据
53
63
  - `get_kline` — K线 OHLCV(A/HK/US/JP/KR/TW)
54
- - `get_quote` — 实时报价
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 交易日
55
66
  - `get_capital_flow` — A股资金流(个股 / 多日 / 板块)
56
67
  - `get_news` — 财经新闻
57
68
  - `get_financials` — 关键财务指标
@@ -61,6 +72,8 @@ allowBuilds:
61
72
  - `analyze_pattern` — 12+ 种 K 线形态识别
62
73
  - `calculate_ma` — 独立均线计算
63
74
  - `get_volume_analysis` — 量价分析
75
+ - `analyze_portfolio_risk` — 组合敞口、相关性、止损与确定性压力测试
76
+ - `plan_portfolio_rebalance` — 目标权重、整手和现金约束下的调仓清单
64
77
 
65
78
  ### 市场全景
66
79
  - `get_market_indices` — 主要指数(CN/HK/US/JP/KR/TW)
package/dist/client.js ADDED
@@ -0,0 +1,88 @@
1
+ "use strict";
2
+ (() => {
3
+ // dsh/client.ts
4
+ window.__ModuleLoader__.load({
5
+ id: "@weaxs/dsh-stock-analysis",
6
+ factory(require2) {
7
+ const React = require2("react");
8
+ const h = React.createElement;
9
+ const PANEL = "stock-analysis";
10
+ const SRC = "/stock-analysis/";
11
+ function StockIcon(props) {
12
+ const size = props?.size ?? 18;
13
+ return h(
14
+ "svg",
15
+ {
16
+ width: size,
17
+ height: size,
18
+ viewBox: "0 0 24 24",
19
+ fill: "none",
20
+ stroke: "currentColor",
21
+ strokeWidth: 1.6,
22
+ strokeLinecap: "round",
23
+ strokeLinejoin: "round",
24
+ "aria-hidden": true
25
+ },
26
+ h("path", { d: "M4 19V9M4 7V5M4 21v-2M10 16V4M10 2V1M10 19v-3M16 18V8M16 6V4M16 21v-3M22 15V5M22 3V2M22 19v-4" }),
27
+ h("path", { d: "M2 9h4v10H2zM8 4h4v12H8zM14 8h4v10h-4zM20 5h4v10h-4z" })
28
+ );
29
+ }
30
+ function apply(ctx) {
31
+ const frames = /* @__PURE__ */ new Set();
32
+ let scheme = null;
33
+ const tokenMap = {
34
+ bg: "--dsw-alias-bg-base",
35
+ surface: "--dsw-alias-bg-layer-1",
36
+ surfaceSubtle: "--dsw-alias-bg-layer-2",
37
+ text: "--dsw-alias-label-primary",
38
+ muted: "--dsw-alias-label-secondary",
39
+ border: "--dsw-alias-border-l2",
40
+ accent: "--dsw-alias-button-primary-fill",
41
+ onAccent: "--dsw-alias-label-primary-foreground"
42
+ };
43
+ const palette = () => {
44
+ const style = getComputedStyle(document.body);
45
+ return Object.fromEntries(
46
+ Object.entries(tokenMap).map(([key, token]) => [key, style.getPropertyValue(token).trim()]).filter(([, value]) => value)
47
+ );
48
+ };
49
+ const post = (frame) => {
50
+ if (scheme && frame.contentWindow) {
51
+ frame.contentWindow.postMessage({ type: "stock-analysis:theme", scheme, palette: palette() }, location.origin);
52
+ }
53
+ };
54
+ ctx.inject(["theme"], (c) => {
55
+ const push = (snapshot) => {
56
+ scheme = snapshot.active.colorScheme;
57
+ frames.forEach(post);
58
+ };
59
+ push(c.theme.getTheme());
60
+ c.on("theme/change", push);
61
+ });
62
+ function DashboardPanel() {
63
+ const ref = React.useRef(null);
64
+ const [src] = React.useState(() => scheme ? `${SRC}?theme=${scheme}` : SRC);
65
+ React.useEffect(() => {
66
+ const frame = ref.current;
67
+ if (frame) frames.add(frame);
68
+ return () => {
69
+ if (frame) frames.delete(frame);
70
+ };
71
+ }, []);
72
+ return h("iframe", {
73
+ ref,
74
+ src,
75
+ title: "\u80A1\u7968\u4EEA\u8868\u76D8",
76
+ allow: "fullscreen",
77
+ referrerPolicy: "no-referrer",
78
+ onLoad: (event) => post(event.currentTarget),
79
+ style: { width: "100%", height: "100%", border: 0, display: "block", background: "Canvas" }
80
+ });
81
+ }
82
+ ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({ name: "sidebar.panellist", id: PANEL, order: 7, label: "\u80A1\u7968\u4EEA\u8868\u76D8" }, StockIcon));
83
+ ctx.slots.inject("main", () => ctx.slots.register({ name: "main", key: PANEL }, DashboardPanel));
84
+ }
85
+ return { isPlugin: true, inject: ["slots"], apply };
86
+ }
87
+ });
88
+ })();