@openfinclaw/findoo-datahub-plugin 2026.3.2 → 2026.3.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.
Files changed (67) hide show
  1. package/DESIGN.md +492 -151
  2. package/_vendor/claude-skills-finance/SKILL.md +192 -0
  3. package/_vendor/claude-skills-finance/assets/dcf_analysis_template.md +184 -0
  4. package/_vendor/claude-skills-finance/assets/expected_output.json +161 -0
  5. package/_vendor/claude-skills-finance/assets/forecast_report_template.md +177 -0
  6. package/_vendor/claude-skills-finance/assets/sample_financial_data.json +219 -0
  7. package/_vendor/claude-skills-finance/assets/variance_report_template.md +122 -0
  8. package/_vendor/claude-skills-finance/references/financial-ratios-guide.md +396 -0
  9. package/_vendor/claude-skills-finance/references/forecasting-best-practices.md +294 -0
  10. package/_vendor/claude-skills-finance/references/valuation-methodology.md +255 -0
  11. package/_vendor/claude-skills-finance/scripts/budget_variance_analyzer.py +406 -0
  12. package/_vendor/claude-skills-finance/scripts/dcf_valuation.py +449 -0
  13. package/_vendor/claude-skills-finance/scripts/forecast_builder.py +494 -0
  14. package/_vendor/claude-skills-finance/scripts/ratio_calculator.py +432 -0
  15. package/index.ts +332 -14
  16. package/openclaw.plugin.json +2 -2
  17. package/package.json +1 -1
  18. package/references/cn-market-specifics.md +165 -0
  19. package/references/crypto-analysis.md +635 -0
  20. package/references/financial-ratios-cn.md +452 -0
  21. package/references/hk-market-specifics.md +166 -0
  22. package/references/macro-cycle-cn.md +409 -0
  23. package/references/valuation-cn.md +427 -0
  24. package/skills/README.md +294 -0
  25. package/skills/a-concept-cycle/skill.md +200 -0
  26. package/skills/a-convertible-arb/skill.md +294 -0
  27. package/skills/a-dividend-king/skill.md +187 -0
  28. package/skills/a-earnings-season/skill.md +221 -0
  29. package/skills/a-index-timer/skill.md +192 -0
  30. package/skills/a-ipo-new/skill.md +297 -0
  31. package/skills/a-northbound-decoder/skill.md +185 -0
  32. package/skills/a-quant-board/skill.md +286 -0
  33. package/skills/a-share/skill.md +347 -0
  34. package/skills/a-share-radar/skill.md +185 -0
  35. package/skills/cross-asset/skill.md +202 -0
  36. package/skills/crypto/skill.md +269 -0
  37. package/skills/crypto-altseason/skill.md +208 -0
  38. package/skills/crypto-btc-cycle/skill.md +231 -0
  39. package/skills/crypto-defi-yield/skill.md +181 -0
  40. package/skills/crypto-funding-arb/skill.md +158 -0
  41. package/skills/crypto-stablecoin-flow/skill.md +149 -0
  42. package/skills/data-query/skill.md +124 -30
  43. package/skills/derivatives/skill.md +188 -35
  44. package/skills/etf-fund/skill.md +216 -0
  45. package/skills/factor-screen/skill.md +186 -0
  46. package/skills/hk-china-internet/skill.md +190 -0
  47. package/skills/hk-dividend-harvest/skill.md +192 -0
  48. package/skills/hk-hsi-pulse/skill.md +154 -0
  49. package/skills/hk-southbound-alpha/skill.md +163 -0
  50. package/skills/hk-stock/skill.md +295 -0
  51. package/skills/macro/skill.md +244 -53
  52. package/skills/risk-monitor/skill.md +171 -0
  53. package/skills/us-dividend/skill.md +162 -0
  54. package/skills/us-earnings/skill.md +149 -0
  55. package/skills/us-equity/skill.md +235 -0
  56. package/skills/us-etf/skill.md +261 -0
  57. package/skills/us-sector-rotation/skill.md +223 -0
  58. package/src/config.ts +4 -5
  59. package/src/datahub-client.test.ts +4 -7
  60. package/src/datahub-client.ts +6 -1
  61. package/src/register-tools.ts +720 -0
  62. package/src/tool-helpers.ts +89 -0
  63. package/test/e2e/l3-gateway-bootstrap.live.test.ts +339 -0
  64. package/test/e2e/l4-skill-tool-chain.live.test.ts +465 -0
  65. package/skills/crypto-defi/skill.md +0 -69
  66. package/skills/equity/skill.md +0 -64
  67. package/skills/market-radar/skill.md +0 -47
@@ -0,0 +1,427 @@
1
+ # 中国市场估值方法论
2
+
3
+ 适用于 A 股 (CAS)、港股 (IFRS)、AH 双重上市公司的系统性估值框架。
4
+ 所有数据通过 `fin_stock` / `fin_macro` / `fin_index` 工具获取。
5
+
6
+ ## Table of Contents
7
+
8
+ - [1. DCF 估值 — A 股适配](#1-dcf-估值--a-股适配)
9
+ - [1.1 WACC 参数选取](#11-wacc-参数选取)
10
+ - [1.2 自由现金流预测](#12-自由现金流预测)
11
+ - [1.3 终值 (Terminal Value)](#13-终值-terminal-value)
12
+ - [2. DCF 估值 — 港股适配](#2-dcf-估值--港股适配)
13
+ - [2.1 港股特有折价因子](#21-港股特有折价因子)
14
+ - [2.2 港股 WACC 构建](#22-港股-wacc-构建)
15
+ - [3. DDM 模型 — 高股息标的](#3-ddm-模型--高股息标的)
16
+ - [3.1 适用标的](#31-适用标的)
17
+ - [3.2 两阶段 DDM](#32-两阶段-ddm)
18
+ - [3.3 股息率安全边际](#33-股息率安全边际)
19
+ - [4. 相对估值法](#4-相对估值法)
20
+ - [4.1 PE/PB Bands 分析](#41-pepb-bands-分析)
21
+ - [4.2 AH 溢价分析](#42-ah-溢价分析)
22
+ - [4.3 行业可比估值](#43-行业可比估值)
23
+ - [5. A 股特有估值因素](#5-a-股特有估值因素)
24
+ - [5.1 壳价值 (Shell Value)](#51-壳价值-shell-value)
25
+ - [5.2 重组溢价 (Restructuring Premium)](#52-重组溢价-restructuring-premium)
26
+ - [5.3 政府补贴影响](#53-政府补贴影响)
27
+ - [6. 预警信号与风险因子](#6-预警信号与风险因子)
28
+ - [7. 估值方法选择决策树](#7-估值方法选择决策树)
29
+ - [8. 敏感性分析模板](#8-敏感性分析模板)
30
+
31
+ ---
32
+
33
+ ## 1. DCF 估值 — A 股适配
34
+
35
+ ### 1.1 WACC 参数选取
36
+
37
+ #### 无风险利率 (Risk-Free Rate)
38
+
39
+ **A 股:** 使用 10 年期国债收益率
40
+
41
+ ```
42
+ fin_macro(endpoint="treasury_cn")
43
+ → 返回字段: yield_10y (当前约 2.3% - 2.8%)
44
+ ```
45
+
46
+ **港股:** 可使用美国 10Y Treasury 或港债
47
+
48
+ ```
49
+ fin_macro(endpoint="treasury_us")
50
+ → 返回字段: yield_10y (当前约 4.0% - 4.5%)
51
+ ```
52
+
53
+ **选取逻辑:**
54
+
55
+ | 标的 | 无风险利率 | 依据 |
56
+ | --------------- | -------------------- | -------------------- |
57
+ | A 股 | 10Y 国债 | 人民币资产定价基准 |
58
+ | H 股 (中资) | 10Y 国债 + 100-150bp | 加离岸流动性溢价 |
59
+ | H 股 (外资视角) | 10Y UST | 美元机会成本 |
60
+ | AH 双重上市 | 分别估值后加权 | 考虑两地资金成本差异 |
61
+
62
+ #### 股权风险溢价 (ERP)
63
+
64
+ **A 股 ERP: 6% - 8%**
65
+
66
+ - 高于美股 (4.5% - 6%) 的原因: 散户主导、政策不确定性、信息不对称
67
+ - 估算方法: 倒推法 → ERP = 1/PE(沪深300) - Rf + 预期增长率
68
+ - 当市场极度恐慌 (如 2018Q4, 2022Q4) ERP 可达 9% - 10%
69
+
70
+ **DataHub 验证当前 ERP:**
71
+
72
+ ```
73
+ # 获取沪深300当前PE
74
+ fin_index(symbol="000300.SH", endpoint="daily_basic")
75
+ → pe_ttm → ERP ≈ 1/PE - Rf + g
76
+
77
+ # 获取无风险利率
78
+ fin_macro(endpoint="treasury_cn")
79
+ ```
80
+
81
+ #### Beta 估算
82
+
83
+ **基准指数选择:**
84
+
85
+ | 标的类型 | 基准指数 | DataHub 调用 |
86
+ | ---------- | -------------------- | ------------------------------------------------------------ |
87
+ | A 股大盘 | 沪深 300 (000300.SH) | `fin_index(symbol="000300.SH", endpoint="price/historical")` |
88
+ | A 股中小盘 | 中证 500 (000905.SH) | `fin_index(symbol="000905.SH", endpoint="price/historical")` |
89
+ | A 股创业板 | 创业板指 (399006.SZ) | `fin_index(symbol="399006.SZ", endpoint="price/historical")` |
90
+ | 港股 | 恒生指数 (HSI) | `fin_index(symbol="HSI", endpoint="price/historical")` |
91
+
92
+ **Beta 估算要点:**
93
+
94
+ - 使用 2-3 年周收益率回归 (A 股波动大,5 年数据可能包含多轮牛熊)
95
+ - 行业中位数 Beta 更稳定,推荐用同行 Beta 再杠杆调整
96
+ - A 股 Beta 普遍 > 1 (散户驱动的高波动)
97
+
98
+ **去杠杆/再杠杆公式:**
99
+
100
+ ```
101
+ Beta_unlevered = Beta_levered / (1 + (1-T) x D/E)
102
+ Beta_relevered = Beta_unlevered x (1 + (1-T) x Target_D/E)
103
+ ```
104
+
105
+ ### 1.2 自由现金流预测
106
+
107
+ **A 股 FCF 计算注意:**
108
+
109
+ ```
110
+ UFCF = 营业利润 (扣除投资收益和公允价值变动)
111
+ x (1 - 有效税率)
112
+ + 折旧摊销
113
+ - 资本支出
114
+ - 营运资本变动
115
+ ```
116
+
117
+ **CAS 特殊调整项:**
118
+
119
+ - 减去: 政府补贴中的经常性部分 (通常在其他收益)
120
+ - 减去: 关联交易中的非市场化定价收入
121
+ - 加回: 研发费用中资本化比例过高的部分 (按行业惯例调整)
122
+
123
+ **DataHub 数据获取:**
124
+
125
+ ```
126
+ # 利润表
127
+ fin_stock(symbol="600519.SH", endpoint="fundamental/income")
128
+ → revenue, operating_income, net_income, deducted_net_income
129
+
130
+ # 现金流量表
131
+ fin_stock(symbol="600519.SH", endpoint="fundamental/cash")
132
+ → operating_cashflow, capex, depreciation
133
+
134
+ # 资产负债表 (计算营运资本变动)
135
+ fin_stock(symbol="600519.SH", endpoint="fundamental/balance")
136
+ → current_assets, current_liabilities, inventory, receivables
137
+ ```
138
+
139
+ ### 1.3 终值 (Terminal Value)
140
+
141
+ **永续增长法参数:**
142
+
143
+ | 参数 | A 股范围 | 说明 |
144
+ | ------------ | -------------------- | ----------------------- |
145
+ | 永续增长率 g | 2.5% - 4.0% | 对标中国潜在 GDP 增速 |
146
+ | 退出倍数 | 行业中位数 EV/EBITDA | 取 5 年均值避免周期偏差 |
147
+
148
+ **注意:** g 不应超过名义 GDP 增速 (实际 GDP + 通胀 ≈ 5% - 7%)
149
+
150
+ **交叉验证:**
151
+
152
+ ```
153
+ TV_perpetuity = FCF_n x (1 + g) / (WACC - g)
154
+ TV_multiple = EBITDA_n x Exit_Multiple
155
+ → 两者差异 > 20% 需重审假设
156
+ ```
157
+
158
+ ---
159
+
160
+ ## 2. DCF 估值 — 港股适配
161
+
162
+ ### 2.1 港股特有折价因子
163
+
164
+ | 折价因子 | 典型幅度 | 触发条件 |
165
+ | ------------ | -------- | ------------------------- |
166
+ | 流动性折价 | 5% - 15% | 日均成交额 < 1000 万港元 |
167
+ | VIE 结构折价 | 5% - 10% | TMT 行业常见 |
168
+ | 政策风险溢价 | 5% - 15% | 敏感行业 (教培/游戏/地产) |
169
+ | 汇率风险 | 2% - 5% | 收入人民币计、股价港元计 |
170
+
171
+ ### 2.2 港股 WACC 构建
172
+
173
+ ```
174
+ Rf = 10Y UST (≈ 4.3%) 或 10Y 国债 + 离岸溢价 (≈ 3.5%)
175
+ ERP = 7% - 9% (港股风险溢价高于 A 股)
176
+ Beta = 恒生指数回归 (港股 Beta 通常低于 A 股同标的)
177
+ WACC = 通常落在 10% - 14% (高于 A 股的 8% - 12%)
178
+ ```
179
+
180
+ ---
181
+
182
+ ## 3. DDM 模型 — 高股息标的
183
+
184
+ ### 3.1 适用标的
185
+
186
+ A 股/港股高分红稳定公司:
187
+
188
+ - 银行 (四大行、招行)
189
+ - 公用事业 (长江电力、华能国际)
190
+ - 高速公路 (宁沪高速)
191
+ - 港股红筹 (中海油、中移动)
192
+
193
+ ### 3.2 两阶段 DDM
194
+
195
+ ```
196
+ P = Sum[D_t / (1+Re)^t] + D_n x (1+g) / [(Re - g) x (1+Re)^n]
197
+ ```
198
+
199
+ **参数选取:**
200
+
201
+ | 参数 | A 股银行 | 港股公用事业 |
202
+ | --------------------- | --------- | ------------ |
203
+ | 第一阶段增速 | 3% - 5% | 2% - 4% |
204
+ | 永续增长率 g | 2% - 3% | 1.5% - 2.5% |
205
+ | Re (Cost of Equity) | 8% - 10% | 9% - 12% |
206
+ | 分红率 (Payout Ratio) | 30% - 35% | 60% - 80% |
207
+
208
+ **DataHub 获取股息数据:**
209
+
210
+ ```
211
+ fin_stock(symbol="601288.SH", endpoint="fundamental/dividends")
212
+ → 返回字段: dividend_per_share, payout_ratio, ex_date
213
+ ```
214
+
215
+ ### 3.3 股息率安全边际
216
+
217
+ | 股息率 (TTM) | 信号 |
218
+ | ------------ | ------------------------------------- |
219
+ | > 8% | 过高 — 可能是股价暴跌导致,核查基本面 |
220
+ | 5% - 8% | 高收益 — 确认分红可持续 |
221
+ | 3% - 5% | 合理 — 大行/公用事业常见 |
222
+ | < 3% | 低收益 — DDM 不如 DCF 适用 |
223
+
224
+ ---
225
+
226
+ ## 4. 相对估值法
227
+
228
+ ### 4.1 PE/PB Bands 分析
229
+
230
+ **方法:**
231
+
232
+ 1. 获取 5 年历史 PE/PB 序列
233
+ 2. 计算百分位分布 (10th / 25th / 50th / 75th / 90th)
234
+ 3. 标注当前位置
235
+
236
+ **DataHub 实现:**
237
+
238
+ ```
239
+ # 获取历史估值数据
240
+ fin_stock(symbol="600519.SH", endpoint="fundamental/metrics",
241
+ start_date="2020-01-01", end_date="2025-12-31")
242
+ → pe_ttm, pb 序列 → 计算分位数
243
+ ```
244
+
245
+ **PE Band 决策矩阵:**
246
+
247
+ | 当前 PE 分位 | 行业景气 | 信号 |
248
+ | ------------ | --------- | ------------------------ |
249
+ | < 20th | 上行/稳定 | 强买入 |
250
+ | < 20th | 下行 | 可能是价值陷阱,深入分析 |
251
+ | 20th - 50th | 上行 | 合理偏低估 |
252
+ | 50th - 80th | 稳定 | 合理估值 |
253
+ | > 80th | 任何 | 高估警告,控制仓位 |
254
+
255
+ ### 4.2 AH 溢价分析
256
+
257
+ **AH 溢价指数 (AHXH) 历史区间:**
258
+
259
+ | 溢价水平 | 历史频率 | 策略含义 |
260
+ | --------- | -------- | ---------------------- |
261
+ | < 110 | 约 10% | H 股相对价值高 |
262
+ | 110 - 130 | 约 40% | 正常区间 |
263
+ | 130 - 150 | 约 35% | A 股偏贵 |
264
+ | > 150 | 约 15% | 极端溢价,关注南向资金 |
265
+
266
+ **DataHub 调用:**
267
+
268
+ ```
269
+ # A 股价格
270
+ fin_stock(symbol="601318.SH", endpoint="price/historical")
271
+ # H 股价格
272
+ fin_stock(symbol="02318.HK", endpoint="price/historical")
273
+ # 汇率
274
+ fin_macro(endpoint="index_global", symbol="USDCNH")
275
+
276
+ → AH_Premium = (A_Price / H_Price x Exchange_Rate - 1) x 100%
277
+ ```
278
+
279
+ ### 4.3 行业可比估值
280
+
281
+ **A 股行业估值中枢 (近 5 年中位数):**
282
+
283
+ | 行业 | PE (TTM) | PB | EV/EBITDA | 首选指标 |
284
+ | ------ | -------- | ---- | --------- | ----------- |
285
+ | 白酒 | 32x | 10x | 25x | PE |
286
+ | 银行 | 5.5x | 0.6x | N/A | PB |
287
+ | 新能源 | 35x | 4x | 20x | PEG |
288
+ | 半导体 | 50x | 6x | 30x | PS (亏损期) |
289
+ | 医药 | 30x | 4x | 22x | PE |
290
+ | 地产 | 7x | 0.8x | 8x | PB/NAV |
291
+ | 家电 | 15x | 3x | 10x | PE |
292
+ | 军工 | 45x | 5x | 30x | PE (主题) |
293
+
294
+ ---
295
+
296
+ ## 5. A 股特有估值因素
297
+
298
+ ### 5.1 壳价值 (Shell Value)
299
+
300
+ **背景:** 注册制改革前,A 股上市资格稀缺,小市值公司有重组预期
301
+
302
+ **现状 (注册制后):**
303
+
304
+ - 壳价值大幅缩水: 从 30-50 亿降至 5-15 亿
305
+ - 仍然存在于: ST 股、市值 < 30 亿的公司
306
+ - 估值调整: 对小市值公司,隐含壳价值应从 EV 中扣除
307
+
308
+ ### 5.2 重组溢价 (Restructuring Premium)
309
+
310
+ **触发信号:**
311
+
312
+ - 控股股东变更 (尤其是国资 → 民资 或反向)
313
+ - 停牌公告涉及 "重大资产重组"
314
+ - 大股东增持 + 高管变动同时发生
315
+
316
+ ### 5.3 政府补贴影响
317
+
318
+ **DataHub 获取:**
319
+
320
+ ```
321
+ fin_stock(symbol="002594.SZ", endpoint="fundamental/income")
322
+ → 对比 net_income vs deducted_net_income
323
+ → 差额 = 非经常性损益 (含补贴)
324
+ ```
325
+
326
+ **估值调整方法:**
327
+
328
+ - 经常性补贴 (如新能源补贴): 按政策到期时间折现
329
+ - 一次性补贴 (如搬迁补偿): 直接从 EV 中扣除
330
+ - 补贴占净利润 > 30% → 大幅降低盈利质量权重
331
+
332
+ ---
333
+
334
+ ## 6. 预警信号与风险因子
335
+
336
+ ### 6.1 商誉减值 (Goodwill Impairment)
337
+
338
+ **检测流程:**
339
+
340
+ ```
341
+ fin_stock(symbol="XXX.SH", endpoint="fundamental/balance")
342
+ → goodwill 字段
343
+ → 商誉/净资产 > 30% → 高风险
344
+ → 收购标的业绩承诺期即将到期 → 减值概率大增
345
+ ```
346
+
347
+ **A 股商誉减值高发期:** 每年 1-4 月 (年报审计季)
348
+
349
+ ### 6.2 关联交易 (Related Party Transactions)
350
+
351
+ **红旗信号:**
352
+
353
+ | 信号 | 风险等级 |
354
+ | ------------------------- | -------- |
355
+ | 关联销售占营收 > 30% | 高 |
356
+ | 关联采购价格显著偏离市场 | 高 |
357
+ | 向关联方提供大额借款/担保 | 高 |
358
+ | 关联交易规模逐年增长 | 中 |
359
+
360
+ ### 6.3 审计意见 (Audit Opinion)
361
+
362
+ **A 股审计意见等级:**
363
+
364
+ | 意见类型 | 影响 |
365
+ | ------------ | -------------------- |
366
+ | 标准无保留 | 正常 |
367
+ | 带强调事项段 | 关注事项但不影响公允 |
368
+ | 保留意见 | 估值折价 10% - 20% |
369
+ | 无法表示意见 | 立即规避 |
370
+ | 否定意见 | 退市风险,不纳入估值 |
371
+
372
+ ---
373
+
374
+ ## 7. 估值方法选择决策树
375
+
376
+ ```
377
+ 目标公司
378
+ ├── 盈利稳定?
379
+ │ ├── Yes
380
+ │ │ ├── 高股息 (>3%)? → DDM + PE Bands
381
+ │ │ ├── 周期性行业? → 正常化 DCF + PB
382
+ │ │ └── 成长型? → DCF + PEG
383
+ │ └── No
384
+ │ ├── 有收入? → PS + EV/Revenue + 可比公司
385
+ │ ├── 重资产? → NAV + PB
386
+ │ └── Pre-revenue? → 不适用传统估值,VC 方法
387
+ ├── 金融机构?
388
+ │ ├── 银行 → DDM + PB + 拨备覆盖率调整
389
+ │ ├── 保险 → 内含价值 (EV) + NBV 倍数
390
+ │ └── 券商 → PB + ROE 调整
391
+ ├── AH 双重上市?
392
+ │ → 分别 DCF + AH 溢价分析 + 互联互通资金流
393
+ └── 地产?
394
+ → NAV 法 (土储重估) + PB + 三道红线检测
395
+ ```
396
+
397
+ ---
398
+
399
+ ## 8. 敏感性分析模板
400
+
401
+ **标准敏感性表 1: WACC vs 永续增长率 g**
402
+
403
+ ```
404
+ g=2.0% g=2.5% g=3.0% g=3.5% g=4.0%
405
+ WACC= 8% | 高 | 高 | 极高 | - | - |
406
+ WACC= 9% | 合理 | 高 | 高 | 极高 | - |
407
+ WACC=10% | 低 | 合理 | 合理 | 高 | 极高 |
408
+ WACC=11% | 低 | 低 | 合理 | 合理 | 高 |
409
+ WACC=12% | 极低 | 低 | 低 | 合理 | 合理 |
410
+ ```
411
+
412
+ **标准敏感性表 2: 营收增速 vs 营业利润率**
413
+
414
+ - 生成方法: 对 base case 的增速和利润率各取 +/- 2 个档次
415
+ - 呈现: 5x5 矩阵,标注 base case 位置
416
+ - 差异超过 +/- 30% 的格子标红
417
+
418
+ **DataHub 获取历史基准:**
419
+
420
+ ```
421
+ # 收入增速趋势
422
+ fin_stock(symbol="600519.SH", endpoint="fundamental/income",
423
+ start_date="2020-01-01", limit=20)
424
+
425
+ # 行业对标
426
+ fin_index(symbol="000300.SH", endpoint="daily_basic")
427
+ ```