前言¶
做 A 股研究的智能體開發者，常見需求是「幫我看看這家公司貴不貴」。現有的 DSH 股票類插件基本停在盯盤這一層：懸浮窗看漲跌、行情條、K 線卡片。它們回答不了研究者真正要問的問題——賺錢質量怎麼樣、當前價格隱含了多少增長預期、它是高估還是低估。
下面介紹的 dsh-astock，由 WilShi 維護，屬於「聯網工具」分類。它把這些問題做成了模型可以直接調用的工具，並且內置了估值模型，而不是隻取數讓你自己在對話裏算。數據全部來自公開接口，零配置、免 API Key。
這是什麼¶
dsh-astock 是一個 DSH 插件，裝完後會註冊六個 astock_* 工具：檢索標的、取行情、取 K 線、讀財報、算估值、出研報。它的定位是研究輔助工具，不是薦股工具，不構成投資建議。
核心功能：六個工具¶
| 工具 | 作用 | 典型問法 |
|---|---|---|
astock_search |
按代碼/名稱/拼音檢索標的 | 「幫我看看寧德時代」 |
astock_quote |
實時行情 + 市值 + PE/PB + 行業概念 | 「茅臺現在多少倍 PE」 |
astock_kline |
前復權日 K 線，判斷趨勢與區間 | 「最近三個月走勢怎麼樣」 |
astock_financials |
財報摘要 + TTM 折算 | 「它最近幾個季度增長如何」 |
astock_valuation |
自動選模型做估值，給出內在價值與隱含增速 | 「現在這個價格貴不貴」 |
astock_report |
生成完整 Markdown 研究簡報 | 「給我出一份茅臺的研究簡報」 |
一次調用通常是組合的：模型會同時調 astock_quote、astock_financials 和 astock_valuation，再把結果拼成結論。
README 裏給了一段真實對話示例：
你：茅臺現在貴嗎？幫我算一下。
（模型調用 astock_quote + astock_financials + astock_valuation）
貴州茅臺（600519）現價 1452 元，模型：dcf
內在價值 1130.62 元，高估 28.4%
當前股價隱含 5 年增速 14.2%
兩階段 DCF：前 5 年按 8.0% 增長，之後永續 2.5%，折現率 10.0%；以淨利潤近似所有者收益
估值模型是怎麼選的¶
這是這個項目最在意的一點：不同生意不能用同一個模型。
| 公司類型 | 模型 | 原因 |
|---|---|---|
| 一般盈利公司 | 兩階段 DCF | 淨利潤可近似所有者收益 |
| 銀行 / 保險 / 證券 | PB-ROE（Justified PB） | 金融企業淨利被存款與撥備主導，不等於自由現金流，DCF 會算出荒謬的安全邊際 |
| 虧損公司 | 不適用 | DCF/PE 都失真，應改用 PS 或重置成本 |
PB-ROE 用的是 Gordon 增長形式：合理 PB = (ROE - g) / (r - g)。
TTM（滾動十二個月）也不是直接取最近一期。A 股財報是累計口徑，Q3 是三季度累計，所以 TTM 按 最新累計 + 上年年報 - 上年同期 折算，並在輸出裏寫明計算依據。
數據源與穩定性¶
所有數據來自公開接口，不需要任何 API Key。主源是東方財富，行情與 K 線有騰訊、新浪兜底，檢索只有東方財富 searchapi 可用。
| 能力 | 主源 | 備用 |
|---|---|---|
| 行情/估值 | 東方財富 | 騰訊 → 新浪 |
| 日 K 線 | 東方財富 | 騰訊 |
| 財報 | 東方財富 datacenter | — |
| 檢索 | 東方財富 searchapi | — |
之所以做多源降級，是因爲這些接口都沒有文檔、也不承諾 SLA。開發期間實測過東方財富的 push2 行情接口在請求變多後直接斷開連接（所有分片同時不可用），但 datacenter 與騰訊、新浪仍然正常。如果只綁定一個源，插件會在你不知情的時候靜默失效。
因此每次調用按順序嘗試，返回結果裏用 source 字段說明這次是誰答的。行業與概念標籤只有東方財富提供，當行情降級到備用源時這些字段會是空的，簡報裏會如實標註。
安裝與啓用¶
安裝命令來自 README：
# 安裝到某個 profile（未指定則用默認 profile）
dsh plugin add dsh-astock
# 確認插件層已加載
dsh --profile default --dump-config | grep dsh-astock
本地開發時可以直接鏈接源碼目錄：
git clone https://github.com/WilShi/dsh-astock.git
cd dsh-astock && pnpm install && pnpm build
dsh plugin --profile demo add ./dsh-astock
從 git 直接安裝（dsh plugin add github:WilShi/dsh-astock）需要 pnpm 允許運行 prepare 構建腳本，pkg 會提示往 pnpm-workspace.yaml 加 allowBuilds。README 建議直接發 npm，或用 pnpm pack 出的 tgz。
裝完不需要填任何 token。
配置¶
插件本身零配置。估值工具接受可選參數覆蓋默認假設：
| 參數 | 默認 | 含義 |
|---|---|---|
growthRate |
0.08 | DCF 顯式預測期增速 |
terminalGrowth |
0.025 | 永續增速 |
discountRate |
0.10 | 折現率 / 要求回報率 |
years |
5 | 顯式預測年數 |
對話裏直接說「按 12% 折現率算」，模型就會傳對應參數。
適用場景與注意¶
適合想給 DSH 智能體加上 A 股研究能力的開發者：模型可以直接調工具拿行情、財報和估值結論，不必自己接數據源。插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（該項目爲 MIT License）。它的估值結果對增速、折現率假設高度敏感，換個參數結論可能反轉；淨利潤不等於自由現金流，資本開支重的行業 DCF 結果會偏樂觀；第三方公開接口的數據可能延遲、缺失或口徑不一致。據此操作，風險自擔。
結語¶
dsh-astock 的價值在於把「取數 + 估值 + 出研報」這條鏈路做成了模型可直接調用的工具，並且用多源降級應對無 SLA 的公開數據接口。它屬於社區插件，與 DeepSeek 及幻方無官方從屬關係。
目錄頁：https://www.skillhub.cn/plugins/WilShi/dsh-astock
GitHub：https://github.com/WilShi/dsh-astock
