前言¶
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 插件目录中查找。
