前言¶
DeepSeek Harness (DSH) 通過插件機制擴展智能體的能力。代理在處理金錢相關計算時容易產生幻覺，例如複利、PMT 公式、IRR 計算等。dsh-finance 插件通過確定性工具調用解決了這一問題，提供純算術的金融計算能力。
插件概覽¶
插件名稱：tyeclipse/dsh-finance
維護者：TYEclipse
核心定位：Money math toolbox for DeepSeek Harness (dsh)。提供貸款還款、複利增長、利率轉換、現金流分析、退休規劃和通脹調整等功能。該插件零運行時依賴，完全基於算術運算，不涉及網絡或文件系統訪問。
核心功能¶
插件提供了以下工具：
- loan_payment：固定利率貸款還款計算，支持可選的攤銷計劃（上限 360 行）和每月額外本金支付。
- compound_growth：本金與未來價值計算，支持每月定投，提供多種複利頻率（日、月、季、半年、年、連續）。
- rate_convert：名義年利率 (APR) 與有效年利率 (EAR) 轉換，支持連續複利計算。
- cashflow_analysis：現金流分析，計算 NPV、IRR（使用二分法）以及簡單/折現回收期。處理無符號變化或多符號變化的情況。
- retirement_plan：退休規劃，計算固定提取下的耗盡時間或可持續月供。
- savings_goal：儲蓄目標規劃，計算達成目標所需的月數或所需月供。
- inflation_adjust：通脹調整，計算購買力變化及 Fisher 真實回報率。
安裝與啓用¶
使用 DeepSeek Harness 的 Web Profile 安裝插件：
dsh plugin --profile web add github:TYEclipse/dsh-finance
安裝完成後，可以通過以下命令驗證插件層是否掛載：
dsh --profile web --dump-config | grep '=='
典型用法¶
插件支持以下典型場景的計算：
-
房貸計算：
- 輸入：
loan_payment { principal: 300000, annual_rate_percent: 4, months: 360 } - 輸出：
monthly_payment 1432.25, total_interest 215610, total_paid 515610
- 輸入：
-
複利增長：
- 輸入：
compound_growth { principal: 1000, annual_rate_percent: 5, years: 10, compounding: "monthly", contribution_per_month: 100 } - 輸出：
future_value 17175.24 (contributions 13000, interest 4175.24)
- 輸入：
-
利率轉換：
- 輸入：
rate_convert { rate_percent: 12, input_kind: "nominal", compounding: "monthly" } - 輸出：
output_rate_percent 12.682503 (effective EAR)
- 輸入：
-
IRR 與 NPV：
- 輸入：
cashflow_analysis { cash_flows: [-70000, 12000, 15000, 18000, 21000, 26000], discount_rate_percent: 8 } - 輸出：
npv 1390.96, irr_percent 8.663095, payback_periods 4.15
- 輸入：
-
退休規劃：
- 輸入：
retirement_plan { principal: 1000000, annual_rate_percent: 4, monthly_withdrawal: 4000, years: 30 } - 輸出：
months_to_exhaust 538.42, withdrawal_rate_percent 4.8, lasts_horizon true
- 輸入：
-
儲蓄目標：
- 輸入：
savings_goal { target_amount: 50000, current_savings: 10000, annual_rate_percent: 5, monthly_contribution: 500 } - 輸出：
months_to_goal 65, final_balance 50341.48
- 輸入：
-
所需月供：
- 輸入：
savings_goal { target_amount: 100000, current_savings: 20000, annual_rate_percent: 6, months: 240 } - 輸出：
required_monthly_contribution 73.15, projected_balance 100002.38
- 輸入：
-
通脹調整：
- 輸入：
inflation_adjust { amount: 1000, annual_inflation_percent: 2.5, years: 10, nominal_rate_percent: 6 } - 輸出：
future_cost 1280.08, real_value 781.20, real_rate_percent 3.414634
- 輸入：
細節與注意事項¶
- 零依賴：插件不依賴任何外部運行時，純算術運算，安全且快速。
- 精度處理：金額僅在輸出邊界處舍入到分，內部計算保持高精度。
- 特殊場景：支持零利率計算，明確報告現金流符號變化情況，支持負通脹（通縮）計算。
- IRR 計算：僅在現金流符號變化一次且存在根時返回結果，否則返回無符號變化或根不唯一提示。
- 可持續提取：使用與銀行對賬一致的舍入方法計算可持續月供。
總結¶
dsh-finance 是一個爲 DSH 插件體系設計的金融計算工具箱，解決了大模型在金錢數學上的常見幻覺問題。它通過提供確定的函數調用，幫助開發者構建更可靠的財務分析智能體。
