@weaxs/dsh-stock-analysis 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 CHANGED
@@ -1,10 +1,10 @@
1
1
  # Stock Analysis — DeepSeek Harness (dsh) Plugin
2
2
 
3
- A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 68 个工具,并自动注册 20 个工作流/策略方法论 skill。
3
+ A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。作为 dsh bundle 安装到 profile 后,对话中可调用 70 个工具,并自动注册 21 个工作流/策略方法论 skill。
4
4
 
5
5
  ## 按需工具发现
6
6
 
7
- 支持作用域工具接口和请求组装钩子的新版 dsh 默认增加一个宿主控制入口 `stock_tool_search`,原有 68 个分析工具的名称、参数和输出不变。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
7
+ 支持作用域工具接口和请求组装钩子的新版 dsh 默认增加一个宿主控制入口 `stock_tool_search`,原有 70 个分析工具的名称、参数和输出不变。原生函数调用模式下,首次请求只暴露这个发现入口;其他插件的工具照常保留。搜索支持中文描述、英文关键词或确切工具名,例如 `财务`、`get_quote`、`run_backtest`;命中工具在下一次模型请求提供完整 schema,再按原名调用。默认最多加载 5 项,`limit` 可设 1 到 20;无匹配返回空列表。
8
8
 
9
9
  加载集合按 Agent 隔离,搜索和回退均保留宿主已有的工具权限限制。搜索入口被禁止或移除时,下一次请求保留原先已授权的完整股票工具目录。旧版缺少相关接口时保持全量暴露;PTC / both 模式沿用宿主生成的 SDK,不做发现过滤。加载集合在本次运行中保留,恢复会话或重载插件后需重新搜索。
10
10
 
@@ -0,0 +1,8 @@
1
+ # Separate opt-in: needs DeepSeek Web API credentials. No change to stock data providers.
2
+ - id: web
3
+ config:
4
+ searchProvider: deepseek-search-api
5
+ fetchProvider: deepseek-fetch-api
6
+ - id: web-deepseek-api
7
+ config:
8
+ apiKeyEnv: DEEPSEEK_API_KEY
package/dist/index.js CHANGED
@@ -50,7 +50,8 @@ var cli_budgets_default = {
50
50
  watchlist_item: 480,
51
51
  "stateless_analysis.py:event_study": 300,
52
52
  "stateless_analysis.py:robustness": 660,
53
- "trend_strategy.py:fetch": 660
53
+ "trend_strategy.py:fetch": 660,
54
+ "sector_rotation.py:backtest": 300
54
55
  };
55
56
 
56
57
  // scripts/cli-timeout.mjs
@@ -818,6 +819,193 @@ function apply(ctx, config = {}) {
818
819
  }
819
820
  })
820
821
  );
822
+ ctx.tools.register(defineTool2({
823
+ name: "calculate_rotation_metrics",
824
+ description: "\u884C\u4E1A\u8F6E\u52A8\u6570\u503C\u590D\u6838\uFF1A\u8F93\u5165\u771F\u5B9EMC-dropout\u6837\u672C\u548C/\u6216\u5386\u53F2\u6210\u4EA4\u8BA1\u6570\uFF0C\u8BA1\u7B97\u96C6\u4E2D\u5EA6\u548C\u539F\u59CB\u914D\u6743\uFF1B\u4E0D\u8BAD\u7EC3\u6A21\u578B\u3001\u4E0D\u751F\u6210\u4E70\u5165\u4FE1\u53F7\uFF0C\u96F6\u5386\u53F2\u4E0D\u8865\u9ED8\u8BA4\u503C\u3002",
825
+ parameters: {
826
+ "prediction_samples": {
827
+ "type": "array",
828
+ "description": "1..100\u7EC4\uFF0C\u603B\u6837\u672C<=100000\uFF1B\u548Ctrade_counts\u81F3\u5C11\u63D0\u4F9B\u4E00\u9879",
829
+ "items": {
830
+ "type": "object",
831
+ "additionalProperties": false,
832
+ "properties": {
833
+ "symbol": {
834
+ "type": "string",
835
+ "description": "\u552F\u4E00\u6807\u7684\u6807\u8BC6",
836
+ "required": true
837
+ },
838
+ "samples": {
839
+ "type": "array",
840
+ "description": "2..100000\u4E2A\u771F\u5B9EMC-dropout\u9884\u6D4B\uFF1B\u4E0D\u5F97\u7528\u968F\u673A\u6570\u6216\u52A8\u91CF\u4EE3\u66FF",
841
+ "items": {
842
+ "type": "number",
843
+ "description": "\u540C\u4E00\u6A21\u578B/\u6807\u7684/\u65F6\u95F4\u7684\u6709\u9650\u7EBF\u6027\u8F93\u51FA\uFF0C\u4E0D\u662F\u4EF7\u683C\u6216\u6536\u76CA\u7387"
844
+ },
845
+ "required": true
846
+ }
847
+ }
848
+ }
849
+ },
850
+ "trade_counts": {
851
+ "type": "array",
852
+ "description": "1..100\u6761\u5DF2\u5B8C\u6210\u5386\u53F2\u6210\u4EA4\u8BA1\u6570\uFF1B\u4E0D\u5F97\u4F7F\u7528\u51B3\u7B56\u540E\u7684\u4EA4\u6613",
853
+ "items": {
854
+ "type": "object",
855
+ "additionalProperties": false,
856
+ "properties": {
857
+ "symbol": {
858
+ "type": "string",
859
+ "description": "\u552F\u4E00\u6807\u7684\u6807\u8BC6\uFF1B\u4EE3\u7801\u522B\u540D\u987B\u5148\u7EDF\u4E00",
860
+ "required": true
861
+ },
862
+ "buys": {
863
+ "type": "number",
864
+ "description": "\u6B64\u524D\u5DF2\u5E73\u4ED3\u4E70\u5165\u5468\u6570\uFF0C\u975E\u8D1F\u6574\u6570",
865
+ "required": true
866
+ },
867
+ "wins": {
868
+ "type": "number",
869
+ "description": "\u6B64\u524D\u76C8\u5229\u5E73\u4ED3\u6B21\u6570\uFF0C0..buys",
870
+ "required": true
871
+ },
872
+ "streak": {
873
+ "type": "number",
874
+ "description": "\u6B64\u524D\u8FDE\u7EED\u76C8\u5229\u4EA4\u6613\u6B21\u6570\uFF0C0..wins",
875
+ "required": true
876
+ }
877
+ }
878
+ }
879
+ }
880
+ },
881
+ output: { schema: { type: "string" }, render: (_args, value) => [{ type: "text", text: value }] },
882
+ async execute(params) {
883
+ return withJsonInput(params, (path) => runPy("sector_rotation.py", ["analyze", "--input", path]));
884
+ }
885
+ }));
886
+ ctx.tools.register(defineTool2({
887
+ name: "backtest_rotation_allocation",
888
+ description: "\u884C\u4E1A\u8F6E\u52A8\u914D\u6743\u5206\u9879\u56DE\u6D4B\uFF1A\u4EE3\u7801\u81EA\u52A8\u53D6\u884C\u60C5\uFF0C\u6216\u4F20\u660E\u786E\u5E01\u79CD/\u590D\u6743OHLCV\uFF1B\u76F8\u540C\u6BCF\u5468\u5168\u6C60\u4E70\u5356\u4E0B\u6BD4\u8F83\u7B49\u6743\u4E0E\u5386\u53F2\u914D\u6743\u3002\u6309\u5E02\u573A\u548C\u62A5\u4EF7\u5E01\u79CD\u72EC\u7ACB\u8D44\u91D1\uFF0C\u652F\u6301A/HK/US/JP/KR/TW\uFF1B\u4E0D\u662F\u5B8C\u6574\u8BBA\u6587\u6DF1\u5EA6\u6A21\u578B\u6216\u8DE8\u5E01\u79CD\u5171\u4EAB\u8D44\u91D1\u56DE\u6D4B\u3002",
889
+ parameters: {
890
+ "symbols": {
891
+ "type": "array",
892
+ "description": "1..20\u53EA\u81EA\u52A8\u53D6\u6570\uFF0C\u4E0Edatasets\u4E92\u65A5\uFF1B\u4EFB\u4E00\u5931\u8D25\u6574\u6C60\u505C\u6B62",
893
+ "items": {
894
+ "type": "string",
895
+ "description": "\u552F\u4E00\u80A1\u7968/ETF\u4EE3\u7801\uFF0C\u6309\u63D2\u4EF6\u4EE3\u7801\u683C\u5F0F"
896
+ }
897
+ },
898
+ "datasets": {
899
+ "type": "array",
900
+ "description": "1..20\u4E2A\u79BB\u7EBF\u6570\u636E\u96C6\uFF0C\u4E0Esymbols\u4E92\u65A5\uFF1B8MiB JSON\u8F93\u5165\u4E0A\u9650",
901
+ "items": {
902
+ "type": "object",
903
+ "additionalProperties": false,
904
+ "properties": {
905
+ "symbol": {
906
+ "type": "string",
907
+ "description": "A\u516D\u4F4D\u4EE3\u7801/HK\u59822800.HK/US\u5982XLK/JP\u59821306.T/KR\u5982069500.KS/TW\u59820050.TW",
908
+ "required": true
909
+ },
910
+ "currency": {
911
+ "type": "string",
912
+ "description": "\u5DF2\u6838\u5B9E\u62A5\u4EF7\u5E01\u79CD\u4E09\u5B57\u6BCD\u4EE3\u7801\uFF0C\u4E0D\u6309\u4E0A\u5E02\u5730\u731C\u6D4B",
913
+ "required": true
914
+ },
915
+ "price_basis": {
916
+ "type": "string",
917
+ "enum": [
918
+ "qfq",
919
+ "total_return",
920
+ "split_adjusted"
921
+ ],
922
+ "description": "\u5DF2\u6838\u5B9E\u4E14\u4E00\u81F4\u7684\u590D\u6743\u53E3\u5F84",
923
+ "required": true
924
+ },
925
+ "bars": {
926
+ "type": "array",
927
+ "description": "\u9012\u589E\u552F\u4E00daily OHLCV\uFF0C2..20000\u884C\uFF0C\u5305\u542B\u8BC4\u4F30\u524D\u9884\u70ED\uFF1B\u603B\u91CF<=100000",
928
+ "items": {
929
+ "type": "object",
930
+ "additionalProperties": false,
931
+ "properties": {
932
+ "date": {
933
+ "type": "string",
934
+ "description": "YYYY-MM-DD",
935
+ "required": true
936
+ },
937
+ "open": {
938
+ "type": "number",
939
+ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F",
940
+ "required": true
941
+ },
942
+ "high": {
943
+ "type": "number",
944
+ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F",
945
+ "required": true
946
+ },
947
+ "low": {
948
+ "type": "number",
949
+ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F",
950
+ "required": true
951
+ },
952
+ "close": {
953
+ "type": "number",
954
+ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F",
955
+ "required": true
956
+ },
957
+ "volume": {
958
+ "type": "number",
959
+ "description": "\u6709\u9650\u6B63OHLC\u4EF7\u683C\uFF1Bvolume\u975E\u8D1F",
960
+ "required": true
961
+ },
962
+ "adjusted": {
963
+ "type": "string",
964
+ "description": "\u53EF\u9009\u9010bar\u590D\u6743\u6807\u8BB0\uFF0C\u5B58\u5728\u65F6\u5FC5\u987B\u4E0Eprice_basis\u4E00\u81F4"
965
+ },
966
+ "source": {
967
+ "type": "string",
968
+ "description": "\u53EF\u9009\u884C\u60C5\u6765\u6E90\u6807\u8BC6\uFF0C\u7528\u4E8E\u6570\u636E\u8986\u76D6\u62A5\u544A"
969
+ }
970
+ }
971
+ },
972
+ "required": true
973
+ }
974
+ }
975
+ }
976
+ },
977
+ "start_date": {
978
+ "type": "string",
979
+ "description": "\u8BC4\u4F30\u8D77\u59CBYYYY-MM-DD\uFF1B\u8DE8\u8FB9\u754C\u5468\u4E0D\u4EA4\u6613\uFF0C\u4E0D\u80FD\u7528\u8BC4\u4F30\u671F\u6536\u76CA\u521D\u59CB\u5316\u914D\u6743",
980
+ "required": true
981
+ },
982
+ "end_date": {
983
+ "type": "string",
984
+ "description": "\u5DF2\u6536\u76D8\u622A\u6B62YYYY-MM-DD\uFF1B\u4E0D\u5B8C\u6574\u672B\u5468\u4E0D\u6210\u4EA4",
985
+ "required": true
986
+ },
987
+ "history_start_date": {
988
+ "type": "string",
989
+ "description": "\u4EC5\u4EE3\u7801\u6A21\u5F0F\uFF1B\u9ED8\u8BA4\u8BC4\u4F30\u524D\u4E00\u5E74\uFF0C\u5FC5\u987B\u65E9\u4E8Estart_date"
990
+ },
991
+ "warmup_weeks": {
992
+ "type": "number",
993
+ "description": "\u8BC4\u4F30\u524D\u5B8C\u6574\u5386\u53F2\u4EA4\u6613\u54681..104\u6574\u6570\uFF0C\u9ED8\u8BA426\uFF1B\u4E0D\u8DB3\u505C\u6B62"
994
+ },
995
+ "capital": {
996
+ "type": "number",
997
+ "description": "\u6BCF\u5E02\u573A/\u62A5\u4EF7\u5E01\u79CD\u5206\u7EC4\u72EC\u7ACB\u521D\u59CB\u8D44\u91D1\uFF0C\u9ED8\u8BA41000000\uFF0C\u4E0D\u662F\u6DF7\u5408\u6C60\u603B\u989D"
998
+ },
999
+ "cost_per_side": {
1000
+ "type": "number",
1001
+ "description": "\u6BCF\u8FB9\u6BD4\u4F8B\u6210\u672C0..0.1\uFF0C\u9ED8\u8BA40.001\uFF1B\u4E70\u5165\u9884\u7B97\u542B\u8D39\u7528"
1002
+ }
1003
+ },
1004
+ output: { schema: { type: "string" }, render: (_args, value) => [{ type: "text", text: value }] },
1005
+ async execute(params) {
1006
+ return withJsonInput(params, (path) => runPy("sector_rotation.py", ["backtest", "--input", path]));
1007
+ }
1008
+ }));
821
1009
  ctx.tools.register(defineTool2({
822
1010
  name: "analyze_trend_strategy",
823
1011
  description: "\u6708\u5EA6\u53F3\u4FA7\u8D8B\u52BF\u7B56\u7565\uFF1A\u76F4\u63A5\u4F20\u540C\u5E02\u573AA/HK/US\u80A1\u7968\u4EE3\u7801\uFF0C\u81EA\u52A8\u83B7\u53D6\u65E5K\uFF0C\u8F93\u51FA\u6708\u5EA6\u65B0\u5165/\u6301\u6709/\u9000\u51FA\u4E0E\u9006\u6CE2\u52A8\u9884\u7B97\u3002as_of\u9ED8\u8BA4\u6700\u8FD1\u5DF2\u6536\u76D8\u4EA4\u6613\u65E5\uFF0C\u6301\u4ED3\u53EF\u9009\u4E14\u4E0D\u4FDD\u5B58\uFF0C\u4E0D\u81EA\u52A8\u4E0B\u5355\uFF1B\u8DE8\u6837\u672C\u4ECDnot_validated\u3002",
@@ -1229,8 +1417,9 @@ function apply(ctx, config = {}) {
1229
1417
  ctx.tools.register(
1230
1418
  pyTool({
1231
1419
  name: "render_stock_report",
1232
- description: "\u80A1\u7968\u5206\u6790\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 skill \u63D0\u4F9B\u7684 report_schema \u4E3A\u51C6\uFF0C\u4E0D\u8981\u81EA\u9020\u5B57\u6BB5\u3002template: brief|full\u3002\u5168\u90E8\u5206\u6790\u5B8C\u6210\u540E\u7684\u6700\u540E\u4E00\u6B65\u8C03\u7528\u3002\u4EC5\u6E32\u67D3\uFF0C\u4E0D\u4FDD\u5B58\u4E0D\u63A8\u9001\u3002report\u53EF\u5305\u542Bevidence\uFF08path/label/value/source/as_of\uFF09\u4E0Edata_quality\uFF08flags/limitations\uFF09\uFF0Cbrief/full\u5747\u5C55\u793A\u8BC1\u636E\u548C\u9650\u5236\u3002",
1420
+ description: "\u80A1\u7968\u5206\u6790\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 skill \u63D0\u4F9B\u7684 report_schema \u4E3A\u51C6\uFF0C\u4E0D\u8981\u81EA\u9020\u5B57\u6BB5\u3002template: brief|full\u3002\u5168\u90E8\u5206\u6790\u5B8C\u6210\u540E\u7684\u6700\u540E\u4E00\u6B65\u8C03\u7528\u3002\u9ED8\u8BA4\u4EC5\u6E32\u67D3\uFF1Bfinal=true\u8868\u793A\u6700\u7EC8\u56DE\u590D\uFF0C\u652F\u6301\u76F4\u51FA\u7684\u5BBF\u4E3B\u53EF\u539F\u6837\u4EA4\u4ED8\u5E76\u7ED3\u675F\u672C\u8F6E\u3002report\u53EF\u5305\u542Bevidence\uFF08path/label/value/source/as_of\uFF09\u4E0Edata_quality\uFF08flags/limitations\uFF09\uFF0Cbrief/full\u5747\u5C55\u793A\u8BC1\u636E\u548C\u9650\u5236\u3002",
1233
1421
  parameters: {
1422
+ final: { type: "boolean", description: "\u6700\u7EC8\u56DE\u590D\u6807\u8BB0\uFF0C\u9ED8\u8BA4false\uFF1B\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false" },
1234
1423
  report: {
1235
1424
  type: "object",
1236
1425
  additionalProperties: true,
@@ -1246,15 +1435,16 @@ function apply(ctx, config = {}) {
1246
1435
  script: "report_renderer.py",
1247
1436
  argv: (p) => {
1248
1437
  const b64 = Buffer.from(JSON.stringify(p.report), "utf-8").toString("base64");
1249
- return ["stock", "--template", p.template ?? "full", "--input-b64", b64];
1438
+ return ["stock", "--template", p.template ?? "full", "--input-b64", b64, ...p.final ? ["--final"] : []];
1250
1439
  }
1251
1440
  })
1252
1441
  );
1253
1442
  ctx.tools.register(
1254
1443
  pyTool({
1255
1444
  name: "render_market_report",
1256
- description: "\u5927\u76D8\u590D\u76D8\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 schemas/market_review_schema.json \u4E3A\u51C6\u3002save=true \u65F6\u628A\u62A5\u544A\u5BF9\u8C61\u8FFD\u52A0\u5F52\u6863\u5230\u672C\u5730 JSONL\uFF08\u9ED8\u8BA4\u4E0D\u4FDD\u5B58\u4E0D\u63A8\u9001\uFF09\uFF0C\u7EB5\u5411\u5BF9\u6BD4\u7528 get_review_history",
1445
+ description: "\u5927\u76D8\u590D\u76D8\u62A5\u544A\u6E32\u67D3 \u2014 \u5C06\u7ED3\u6784\u5316\u62A5\u544A JSON \u901A\u8FC7 j2 \u6A21\u677F\u6E32\u67D3\u4E3A Markdown\u3002report \u5B57\u6BB5\u4EE5 schemas/market_review_schema.json \u4E3A\u51C6\u3002save=true \u65F6\u628A\u62A5\u544A\u5BF9\u8C61\u8FFD\u52A0\u5F52\u6863\u5230\u672C\u5730 JSONL\uFF08\u9ED8\u8BA4\u4E0D\u4FDD\u5B58\u4E0D\u63A8\u9001\uFF09\uFF0C\u7EB5\u5411\u5BF9\u6BD4\u7528 get_review_history\uFF1Bfinal=true\u4EC5\u7528\u4E8E\u6700\u7EC8\u56DE\u590D\uFF0C\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false",
1257
1446
  parameters: {
1447
+ final: { type: "boolean", description: "\u6700\u7EC8\u56DE\u590D\u6807\u8BB0\uFF0C\u9ED8\u8BA4false\uFF1B\u4FDD\u5B58\u9644\u4EF6\u6216\u7EE7\u7EED\u5206\u6790\u65F6\u4FDD\u6301false" },
1258
1448
  report: {
1259
1449
  type: "object",
1260
1450
  additionalProperties: true,
@@ -1270,6 +1460,7 @@ function apply(ctx, config = {}) {
1270
1460
  argv: (p) => {
1271
1461
  const b64 = Buffer.from(JSON.stringify(p.report), "utf-8").toString("base64");
1272
1462
  const args = ["market", "--input-b64", b64];
1463
+ if (p.final) args.push("--final");
1273
1464
  if (p.save) args.push("--save");
1274
1465
  return args;
1275
1466
  }
@@ -0,0 +1,54 @@
1
+ // dsh/research-role.ts
2
+ var name = "stock-research-role";
3
+ var inject = ["tools"];
4
+ var common = ["get_market_capabilities", "resolve_stock_name", "get_stock_info", "check_trading_day", "get_trading_phase"];
5
+ var roles = {
6
+ fundamentals: [
7
+ ...common,
8
+ "get_quote",
9
+ "get_financials",
10
+ "get_fundamental_context",
11
+ "get_valuation_history",
12
+ "get_index_valuation",
13
+ "get_shareholder_structure",
14
+ "get_us_holdings",
15
+ "get_insider_trades",
16
+ "get_dividends",
17
+ "compare_stocks"
18
+ ],
19
+ technical: [
20
+ ...common,
21
+ "get_quote",
22
+ "get_kline",
23
+ "get_technical_analysis",
24
+ "analyze_pattern",
25
+ "get_volume_analysis",
26
+ "detect_market_regime",
27
+ "run_backtest",
28
+ "validate_backtest",
29
+ "analyze_trend_strategy",
30
+ "backtest_rotation_allocation"
31
+ ],
32
+ events: [
33
+ ...common,
34
+ "get_news",
35
+ "get_announcements",
36
+ "get_earnings_calendar",
37
+ "get_dividends",
38
+ "search_stock_news",
39
+ "search_comprehensive_intel",
40
+ "extract_article",
41
+ "analyze_disclosure_changes",
42
+ "analyze_event_study"
43
+ ]
44
+ };
45
+ function apply(ctx, config) {
46
+ if (!config || !Object.hasOwn(roles, config.role)) throw new TypeError("Unknown stock research role");
47
+ const allowed = /* @__PURE__ */ new Set([...roles[config.role], "web_search", "web_fetch", "skill"]);
48
+ ctx.tools.restrict({ allow: [...allowed] });
49
+ }
50
+ export {
51
+ apply,
52
+ inject,
53
+ name
54
+ };
package/package.json CHANGED
@@ -1,12 +1,15 @@
1
1
  {
2
2
  "name": "@weaxs/dsh-stock-analysis",
3
- "version": "0.2.8",
3
+ "version": "0.2.9",
4
4
  "description": "DeepSeek Harness (dsh) plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
7
7
  "exports": {
8
8
  ".": "./dist/index.js",
9
- "./cordis.patch.yml": "./cordis.patch.yml"
9
+ "./cordis.patch.yml": "./cordis.patch.yml",
10
+ "./research-role": "./dist/research-role.js",
11
+ "./research.patch.yml": "./research.patch.yml",
12
+ "./deepseek-search.patch.yml": "./deepseek-search.patch.yml"
10
13
  },
11
14
  "dsh": {
12
15
  "bundle": {
@@ -18,10 +21,13 @@
18
21
  },
19
22
  "files": [
20
23
  "dist/",
24
+ "research.patch.yml",
25
+ "deepseek-search.patch.yml",
21
26
  "cordis.patch.yml",
22
27
  "README.md",
23
28
  "tools/",
24
29
  "skills/",
30
+ "!skills/**/__pycache__/**",
25
31
  "schemas/",
26
32
  "templates/",
27
33
  "strategies/",
@@ -45,7 +51,7 @@
45
51
  "license": "MIT",
46
52
  "peerDependencies": {
47
53
  "@deepseek-ai/cordis": "^4.0.1",
48
- "@deepseek-ai/dsh-skill": "^0.0.1-rc.1 || ^0.1.7-rc.1 || ^0.2.0-rc.2",
49
- "@deepseek-ai/dsh-tools": "^0.0.1-rc.1 || ^0.1.7-rc.1 || ^0.2.0-rc.2"
54
+ "@deepseek-ai/dsh-skill": "^0.0.1-rc.1 || ^0.1.7-rc.1 || ^0.2.0-rc.2 || ^0.2.1-rc.2",
55
+ "@deepseek-ai/dsh-tools": "^0.0.1-rc.1 || ^0.1.7-rc.1 || ^0.2.0-rc.2 || ^0.2.1-rc.2"
50
56
  }
51
57
  }
@@ -0,0 +1,90 @@
1
+ # Optional overlay for dsh 0.2.1-rc.2 base/headless profiles. Install stock-analysis first.
2
+ - id: tools
3
+ config:
4
+ mode: ptc
5
+ - id: ptc-runtime
6
+ config:
7
+ executionMode: persistent-in-memory
8
+ - insert:
9
+ - id: stock-agent-presets
10
+ name: '@deepseek-ai/dsh-agent-preset-registry'
11
+ config:
12
+ default: stock-research
13
+ - id: preset-stock-research
14
+ name: '@deepseek-ai/dsh-agent-preset'
15
+ config:
16
+ id: stock-research
17
+ name: 股票综合研究
18
+ plugins: []
19
+ - id: preset-stock-fundamentals
20
+ name: '@deepseek-ai/dsh-agent-preset'
21
+ config:
22
+ id: stock-fundamentals
23
+ name: 股票基本面研究
24
+ plugins:
25
+ - id: persona
26
+ name: '@deepseek-ai/dsh-persona'
27
+ config:
28
+ prefix: >-
29
+ 研究基本面、估值与财务质量。先读取 stock-analysis skill,按当前任务指定股票与期间取数。
30
+ 向父任务返回原始工具字段路径、数值、来源、数据日期、币种、口径和缺失限制,区分事实与推断。
31
+ 不生成最终报告、不记录持仓、不外发信息;发现技术或事件问题交回父任务。
32
+ - id: stock-role
33
+ name: '@weaxs/dsh-stock-analysis/research-role'
34
+ config:
35
+ role: fundamentals
36
+ - id: tool-web
37
+ name: '@deepseek-ai/dsh-tool-web'
38
+ - id: tool-skill
39
+ name: '@deepseek-ai/dsh-tool-skill'
40
+ - id: preset-stock-technical
41
+ name: '@deepseek-ai/dsh-agent-preset'
42
+ config:
43
+ id: stock-technical
44
+ name: 股票技术与回测研究
45
+ plugins:
46
+ - id: persona
47
+ name: '@deepseek-ai/dsh-persona'
48
+ config:
49
+ prefix: >-
50
+ 研究技术结构与策略历史表现。先读取 strategy-backtest 或当前任务指定策略 skill。
51
+ 检查实际数据覆盖、复权、币种、费用、样本外与未来函数,缺失数据不补造。
52
+ 向父任务返回原始字段、来源、数据日期、参数、结果与限制;不将回测结果写成收益承诺。
53
+ 不生成最终报告、不记录持仓、不外发信息。
54
+ - id: stock-role
55
+ name: '@weaxs/dsh-stock-analysis/research-role'
56
+ config:
57
+ role: technical
58
+ - id: tool-web
59
+ name: '@deepseek-ai/dsh-tool-web'
60
+ - id: tool-skill
61
+ name: '@deepseek-ai/dsh-tool-skill'
62
+ - id: preset-stock-events
63
+ name: '@deepseek-ai/dsh-agent-preset'
64
+ config:
65
+ id: stock-events
66
+ name: 股票公告与事件研究
67
+ plugins:
68
+ - id: persona
69
+ name: '@deepseek-ai/dsh-persona'
70
+ config:
71
+ prefix: >-
72
+ 研究公告、新闻与事件。先读取 event-driven skill,检索原文并核对事件时间与披露时间。
73
+ 向父任务返回事实、引用 URL、原文日期、工具证据路径、互相矛盾的证据与未验证点。
74
+ 搜索摘要不是已核实正文,不能替代结构化行情;不生成最终报告、不记录持仓、不外发信息。
75
+ - id: stock-role
76
+ name: '@weaxs/dsh-stock-analysis/research-role'
77
+ config:
78
+ role: events
79
+ - id: tool-web
80
+ name: '@deepseek-ai/dsh-tool-web'
81
+ - id: tool-skill
82
+ name: '@deepseek-ai/dsh-tool-skill'
83
+ # headless creates its parent without mounting an Agent Preset.
84
+ - id: stock-research-subagent
85
+ name: '@deepseek-ai/dsh-tool-subagent'
86
+ config:
87
+ provider: spawn
88
+ toolName: stock_research_subagent
89
+ agentPreset: stock-fundamentals
90
+ allowedAgentPresets: [stock-fundamentals, stock-technical, stock-events]
@@ -1,17 +1,18 @@
1
1
  #!/usr/bin/env node
2
2
  import { execFileSync } from "node:child_process";
3
- import { existsSync } from "node:fs";
3
+ import { existsSync, mkdirSync, renameSync } from "node:fs";
4
4
  import { join } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
6
- import { venvPythonPath } from "./venv-python.mjs";
6
+ import { pythonEnvironmentRoot, venvPythonPath } from "./venv-python.mjs";
7
7
 
8
8
  // fileURLToPath (not URL.pathname) — the latter yields a bogus "/C:/..." path
9
9
  // on Windows, which would put the venv in the wrong place or fail outright.
10
10
  const pkgDir = fileURLToPath(new URL("..", import.meta.url));
11
- const venvDir = join(pkgDir, ".venv");
11
+ const envRoot = pythonEnvironmentRoot(pkgDir);
12
+ const venvDir = join(envRoot, ".venv");
12
13
  // Drive pip through the venv's own python (`-m pip`) instead of a pip/pip.exe
13
14
  // shim — resolves correctly on both POSIX (bin/python3) and Windows (Scripts/python.exe).
14
- const venvPython = venvPythonPath(pkgDir);
15
+ const venvPython = venvPythonPath(envRoot);
15
16
  const requirements = join(pkgDir, "tools", "requirements.txt");
16
17
 
17
18
  function run(bin, args) {
@@ -41,6 +42,12 @@ try {
41
42
  process.exit(1);
42
43
  }
43
44
 
45
+ if (envRoot !== pkgDir && existsSync(join(pkgDir, ".venv"))) {
46
+ // Preserve installed dependencies; never leave an old environment in captured source.
47
+ if (existsSync(venvDir)) throw new Error("Both legacy and current Python environments exist; move the legacy .venv outside the plugin package");
48
+ mkdirSync(envRoot, { recursive: true });
49
+ renameSync(join(pkgDir, ".venv"), venvDir);
50
+ }
44
51
  if (!existsSync(venvDir)) {
45
52
  run(python, ["-m", "venv", venvDir]);
46
53
  }
@@ -6,6 +6,13 @@ import { join } from "node:path";
6
6
 
7
7
  const isWin = process.platform === "win32";
8
8
 
9
+ // OpenClaw captures package source, including .venv symlinks; node_modules is excluded.
10
+ export function pythonEnvironmentRoot(rootDir) {
11
+ return existsSync(join(rootDir, "openclaw.plugin.json"))
12
+ ? join(rootDir, "node_modules", ".stock-analysis-python")
13
+ : rootDir;
14
+ }
15
+
9
16
  // Windows venvs ship Scripts/python.exe (there is no python3); POSIX venvs ship bin/python3.
10
17
  export function venvPythonPath(rootDir) {
11
18
  return join(rootDir, ".venv", isWin ? "Scripts" : "bin", isWin ? "python.exe" : "python3");
@@ -5,6 +5,8 @@ description: 事件驱动分析:评估公告、业绩、政策、订单或资
5
5
 
6
6
  # 事件驱动分析
7
7
 
8
+ 批量研究、子任务分工或报告文件交付时,必须读取[宿主研究与报告交付](../stock-analysis/references/host-workflows.md),使用当前宿主实际提供的能力。
9
+
8
10
  ## 无状态分析扩展
9
11
 
10
12
  历史事件窗口验证或公告原文变化分析时,MUST 读取[无状态研究工具](../stock-analysis/references/stateless-analysis.md),使用 analyze_event_study/analyze_disclosure_changes。事件日期、盘前盘后、价格窗口和正文覆盖必须核实。
@@ -63,7 +63,7 @@ gather 工具返回以下字段:
63
63
 
64
64
  ## 输出
65
65
 
66
- 按 [市场复盘 schema](../../schemas/market_review_schema.json) 构建报告对象,再调用 `render_market_report`。缺失的市场数据保持为空并在 `risks` 中说明,不用定性文字补齐。
66
+ 按 [市场复盘 schema](../../schemas/market_review_schema.json) 构建报告对象,再调用 `render_market_report`。缺失的市场数据保持为空并在 `risks` 中说明,不用定性文字补齐。报告文件/连接器交付或分工研究时,必须读取[宿主研究与报告交付](../stock-analysis/references/host-workflows.md);本轮仅剩回复时才传 `final=true`,否则保持默认 false。
67
67
 
68
68
  ## 多市场支持
69
69
 
@@ -0,0 +1,57 @@
1
+ ---
2
+ name: sector-rotation
3
+ description: 行业ETF轮动研究:核对SSRN 4280640论文规则,复核预测分布集中度与历史配权,评估轮动对现有策略的增益。提供确定性计算与配权分项回测,不生成深度模型预测或实盘买卖计划。
4
+ ---
5
+
6
+ # 行业 ETF 轮动研究
7
+
8
+ 用于研究一组行业 ETF 的周度轮动,以及它是否值得补充现有趋势、题材或组合策略。市场由用户指定,允许跨市场;论文的美国样本不构成插件市场限制。
9
+
10
+ 实现状态:**共享Python数值计算与配权分项回测已实现,论文完整训练与信号模型未实现**。MUST 将“原文已披露规则”“尚未披露的实现细节”“插件的跨市场扩展”分别说明。MUST NOT 声称已经严格复现论文或重现其收益。
11
+
12
+ ## 1. 明确要改善什么
13
+
14
+ - 行业配置:比较不同 ETF 的取舍、空仓和资金分配。这是与现有能力最直接的补充。
15
+ - 热点题材:`hot-theme` 判断板块强度与催化,不能用本论文证明其预测能力得到改善。
16
+ - 个股趋势:`bull-trend` 的月度持有与本论文的周内清仓时钟不同。MUST NOT 自动把轮动筛选叠加为个股买入过滤器。
17
+ - 单股回测:`strategy-backtest` 的单标的 YAML 不能代表跨 ETF 共享资金组合。
18
+
19
+ 仅问是否有用时,结合上述区别回答;无独立对照证据时,结论为“有能力补充价值,收益增益未证实”。
20
+
21
+ ## 2. 核对论文与数据
22
+
23
+ 研究具体规则、复现、模型预测或交易时,MUST 先读取 [论文规则、缺项与输入格式](references/strategy_rules.md)。严格复现所需的损失函数或参数缺失时,列出缺项,停止生成模型信号;MUST NOT 自选参数并冠以原策略名称。
24
+
25
+ 用户提供代码即可通过现有 `get_kline` 获取整个池的 daily OHLCV,按研究区间加预热历史;行业归属、ETF身份、币种或复权未知时明确标记。没有代码时才需要确定标的池。MUST 保留整池成员、来源、实际区间及缺失项,不能静默删掉失败成员改变横截面。
26
+
27
+ 跨市场时,分别记录交易所、时区、币种、当地交易日和周末决策截止时间;只使用截止时已发布的数据。共同资金研究还需要历史汇率、换汇成本及结算约束,数据缺失时停止组合收益计算。MUST NOT 将不同币种净值相加、把后收盘市场的数据用于早开盘市场的历史订单,或把本地周线按日期直接拼接后宣称无前视。
28
+
29
+ ## 3. 复核已披露计算
30
+
31
+ 已有模型生成的 MC-dropout 样本或历史成交计数时,调用 `calculate_rotation_metrics(prediction_samples?, trade_counts?)`。Agent负责提供有来源的输入和解释结果,MUST 使用工具计算,不临场手算或重写算子。交易计数可直接复用分项回测返回的 `trade_counts`;缺原模型预测时,MUST NOT 用动量、随机数或语言模型猜测代替。
32
+
33
+ - `confidence`:复核预测值在“中位数 ± 总体标准差”内的经验占比。
34
+ - `allocation`:复核 `1 + wins/buys + streak/(wins+1)` 原始配权分数。
35
+
36
+ 输入格式、样本来源与零历史边界见参考。所有算子以共享 `tools/sector_rotation.py` 为唯一实现,四宿主转发同一JSON。skill里的 `scripts/rotation_metrics.py` 仅保留旧调用兼容入口;没有另一套公式。没有模型训练、账户存储或下单功能。
37
+
38
+ MUST 同时报 `paper_reproduction=partial_calculations_only`。集中度不是盈利概率;原始配权分数不是目标权重、股数或已确认可用资金。两项计算都不能独立决定买入。
39
+
40
+ ## 4. 运行配权分项回测
41
+
42
+ MUST 先读取 [计算与回测接口](references/computation.md),再调用 `backtest_rotation_allocation`。用户给代码时使用 `symbols` 自动获取行情与报价币种;已有核实的行情才传 `datasets`。两种模式互斥,不能要求正常用户手工准备行情文件。
43
+
44
+ 该工具在相同全池周内买卖下比较等权与历史配权,自动计数、费用扣除、净值和回撤;MUST NOT 让Agent自行计算回测收益。按交易所与报价币种分组,每组独立初始资金;报告每组实际区间、跳过周、费用、两组表现及差值。混合代码池不等于跨币种共享资金组合。任一取数失败、复权/价格检查失败或评估期完整交易周缺bar/零成交量则停止,不缩小股票池,不按事后数据完整性选择交易周。预热不足不能用评估期收益补齐初始化。
45
+
46
+ 该分项入口不需要缺失的神经网络,也不能替代它。MUST 同时报 `paper_reproduction=allocation_ablation_only`,并把历史分数归一化和预热约定与原文已披露公式分开。
47
+
48
+ ## 5. 评估相对现有策略的增益
49
+
50
+ 取得完整可执行模型后,按预先固定的区间、标的池、初始资金、成交时点和成本比较:
51
+
52
+ 1. 基准持有、行业 ETF 等权、简单动量轮动、论文模型;现有月度策略仅在标的池和资金口径可比时加入。
53
+ 2. 保持年度训练与周度更新的时间边界,归一化和阈值选择均只看当时已知数据;额外报告论文发表后的独立区间。
54
+ 3. 分别比较净收益、最大回撤、换手、交易次数和资金占用;逐项关闭置信筛选、亏损过滤或动态配权,检验各部件实际贡献。
55
+ 4. 如需改善某个现有策略,另做“原策略 vs 加入该部件”的同条件对照,不能凭独立策略收益推定组合效果。
56
+
57
+ 完成时报告:已实现内容、缺项、对照条件和增益结论。没有完整模型或合格组合回测时,MUST 报“尚未验证”,不能用论文表3、单股回测相加或技术测试通过代替实际增益证据。