前言¶
DeepSeek Harness（DSH）的插件機制允許把特定能力註冊給智能體。金融類任務裏，數字格式、收益率、估值比率、現值終值和風險指標如果全部依賴模型即時計算，容易出現口徑和算術偏差。dsh-plugin-finance-data 把這部分計算收斂到一個工具裏：模型負責解釋和引用，插件負責給出確定性的計算結果。
這是什麼¶
dsh-plugin-finance-data 是一個面向 DSH 智能體的 finance data toolkit。它註冊名爲 finance_data 的工具，覆蓋數字/貨幣/百分比格式、收益計算、財務比率、時間價值、風險指標、數據質量檢查、定投/複利計劃和組合再平衡。
該插件由 GitHub 用戶 863683348 維護，許可證爲 MIT。已覈實說明稱其沒有文件系統訪問，行爲確定且無副作用。
核心功能¶
finance_data 提供以下 action：
| action | 用途 |
|---|---|
format |
數字、貨幣、百分比格式，支持千分位和中文 萬/億 單位 |
return |
Simple、log、annualized（CAGR-style）returns |
ratio |
PE、PB、ROE、ROA、gross/net margin、debt-to-equity |
value |
Present value、future value、implied rate |
risk |
從 return series 計算 mean、volatility、max drawdown、historical VaR(95)、Sharpe |
checklist |
數據質量清單：source、as-of date、units、definitions |
plan |
DCA / compound-interest projection：future value schedule、inflation-adjusted real value |
portfolio |
portfolio weights、drift vs targets、rebalance buy/sell orders |
這些能力適合在 DSH 對話中作爲金融計算的固定接口使用，而不是讓模型臨時拼公式。
安裝與啓用¶
先爲指定 profile 添加插件：
dsh plugin --profile <profile> add dsh-plugin-finance-data
然後重啓 DSH。重啓後，finance_data 工具會註冊到 host-wide 範圍。
配置項均爲 optional，寫在 composition row 的 config 中：
personaSection: true
sectionOrder: 6
默認情況下，personaSection 爲 true，sectionOrder 爲 6。
典型用法¶
安裝並重啓後，可以在 DSH 智能體裏按任務選擇 finance_data 的 action。下面是一些可直接轉述給智能體的示例：
1、輸出金額或百分比時，讓它使用 format，並說明需要千分位或中文 萬/億 單位。
2、計算區間收益時，讓它使用 return，選擇 simple、log 或 annualized（CAGR-style）口徑。
3、分析估值和盈利時，讓它使用 ratio，給出 PE、PB、ROE、ROA、gross/net margin、debt-to-equity 中需要的字段。
4、做貼現或複利判斷時，讓它使用 value，輸出 present value、future value 或 implied rate。
5、檢查風險時，讓它使用 risk，基於 return series 輸出 mean、volatility、max drawdown、historical VaR(95)、Sharpe。
6、做數據覈驗時，讓它使用 checklist，檢查 source、as-of date、units、definitions。
7、規劃 DCA 或複利路徑時，讓它使用 plan，查看 future value schedule 和 inflation-adjusted real value。
8、維護組合時，讓它使用 portfolio，查看 weights、drift vs targets，並生成 rebalance buy/sell orders。
這些示例只描述能力入口，不假設固定參數名；具體輸入應與你提供的數據和口徑一致。
依賴與注意¶
已覈實資料列出以下 peer dependencies：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-fs ^0.1.0-rc.6
@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6
@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/schemastery ^3.18.1
DSH 生態強調“一切皆插件”，但具體插件仍應單獨審查。這裏的插件來自社區倉庫，不代表 DeepSeek 或幻方官方應用商店。安裝前建議查看 GitHub 源碼、MIT 許可證和依賴要求；啓用後，它會在當前 dsh 進程中運行，並繼承宿主進程具備的權限和能力。
相關鏈接¶
dsh-plugin-finance-data 的價值在於把金融計算中容易出錯的部分交給確定性工具：格式、收益、比率、時間價值、風險指標、DCA/複利計劃和組合再平衡都有對應 action。模型仍然負責解釋結果和給出建議，插件負責把算術步驟跑對。
- GitHub 倉庫：https://github.com/863683348/dsh-plugin-finance-data
- 社區目錄：目錄頁 URL 未在已覈實資料中確認，可按包名
dsh-plugin-finance-data在 DSH 插件目錄中查找。
